Here is Your Customized Document Your Configuration is: Action to Perform - Update server software Storage-System Model - CX4-480 Update Type - Update Unisphere server software Connection Type - Fibre Channel Switch or Boot from SAN Server Operating System - Windows Server 2003 Management Tool - EMC Navisphere Manager
Reporting Problems To send comments or report errors regarding this document, please email:
[email protected]. For issues not related to this document, contact your service provider. Refer to Document ID: 1432698
Content Creation Date 2011/1/5
Content Creation Date 2011/1/5
Content Creation Date 2011/1/5
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
This guide describes how to update or install Unisphere™ server software, formerly referred to as the EMC CLARiiON® or EMC Navisphere® server software. If you are an EMC partner, refer to the EMC Services Partner website to download the Unisphere server software mentioned in this guide. The partner site is available from the Navigator drop-down menu on the Powerlink® website. Unless indicated otherwise, the tasks described in this document apply to a Windows server and a Windows virtual machine. IMPORTANT Some of the procedures in this document apply only to the server, only to the virtual machine, or to both the server and the virtual machine. Read each section carefully to determine where to perform the procedure. Your operating system or configuration may not support all the Unisphere™ server software mentioned in this guide. Refer to the E-Lab™ Interoperability Navigator on the Powerlink website for information on supported configurations.
Topics include:
Before you start ............................................................................. Finding current information ........................................................... About EMC Unisphere server software ........................................... Installing the Unisphere Initialization Utility ................................... Running the Unisphere Initialization Utility ................................... Installing the Unisphere Server Utility and Unisphere Host Agent .................................................................................................... Running the Unisphere Host Agent or Unisphere Server Utility .......................................................................................... Installing Navisphere CLI .............................................................
3 4 5 9 11 13 21 26 1
2
Installing the Admhost Utility ....................................................... Installing the Admsnap Utility ...................................................... Silent installations and removals using the InstallAnywhere package........................................................................................ Removing the Unisphere server software from a Windows server or a Windows virtual machine ...........................................................
28 30 32 36
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
Before you start ❑ Read the release notes for your storage-system type, which are available in the Technical Documentation and Advisories section on the Powerlink® website. ❑ Refer to the E-Lab™ Interoperability Navigator on the Powerlink® website for information on supported operating system versions, including supported virtual machines.
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
3
Finding current information The most up-to-date information about the Unisphere™ server software is posted on the EMC Powerlink® website. We recommend that you download the latest information before you install any server software. To access EMC Powerlink, use the following link: http://Powerlink.EMC.com After you log in, select Support > Technical Documentation and Advisories and find the following:
4
EMC Unisphere Host Agent, Navisphere CLI and Utilities Release Notes
EMC SnapView Command Line Interfaces Reference (P/N 069001181)
EMC SAN Copy Command Line Interfaces Reference (P/N 069001189)
For the most current management and security content, refer to the EMC Navisphere Manager help.
For Navisphere CLI commands, refer to the latest revision of the EMC Navisphere Command Line Interface (CLI) Reference (P/N 300–003–628)
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
About EMC Unisphere server software This section describes all the available Unisphere™ server software, formerly referred to as the CLARiiON® or Navisphere® server software. Your operating system or configuration may not support all the software mentioned. Refer to the E-Lab™ Interoperability Navigator on the Powerlink® website for information on supported configurations.
Unisphere Initialization Utility (replaces the Navisphere Storage System Initialization Utility)
Navisphere Command Line Interface (CLI)
Unisphere Host Agent (replaces the Navisphere Host Agent)
Unisphere Server Utility (replaces the Navisphere Server Utility)
Admhost Utility
Admsnap Utility
VSS Provider
About the Unisphere Initialization Utility For Fibre Channel storage systems, use the Unisphere™ Initialization Utility to discover storage systems and set network parameters (IP address, subnet mask, and default gateway). In addition, for iSCSI storage systems with iSCSI data ports attached to Windows servers, use the utility to set network parameters for these ports. You can install the initialization utility on a server or other host such as a Unisphere management station (formerly referred to as the Navisphere off-array management station). The only requirement is that the host be connected to the same network subnet as the storage-system management ports.
About the Navisphere CLI The CLI complements or is an alternative to Navisphere Manager. It provides a command line interface for storage-system management, including storage provisioning, status and configuration information retrieval, and control. You can use the CLI to automate management Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
5
functions through shell scripts and batch files. For more information, refer to the EMC Navisphere Command Line Interface (CLI) Reference .
About the Unisphere Host Agent The host agent registers the server’s host bus adapter (HBA) with the attached storage system when the host agent service starts. This action sends the initiator records for each HBAs to the storage system. Initiator records are used to control access to storage-system data. The agent can then retrieve information from the storage system automatically at startup or when requested by Navisphere Manager or the CLI. The host agent can also:
Send operating system drive mapping information to the attached CLARiiON® storage systems.
Monitor storage-system events and notify personnel by e-mail, page, or modem when any designated event occurs.
Retrieve LUN world wide name (WWN) and capacity information from Symmetrix® storage systems.
About the Unisphere Server Utility The server utility allows you to perform the following functions:
6
Update server information to the storage system — Lets you send the server name and IP address to the storage system and, if needed later on, allows you to update or view this data. For Windows servers running Server Utility version 6.20 or later, if the Registration Service feature remains enabled after the installation of the server utility, the utility automatically registers the server’s HBAs with the storage system and updates server information whenever the configuration changes (for example, when you mount new volumes or create new partitions).
Verify server high availability (HA) — Lets you determine if the server is configured for high availability (HA) by verifying that the server has at least one connection path to each storage-system SP, and that PowerPath® or some other failover software, such as VMware native failover, DMP, PV Links, or HP native failover for 11iV3 is running. The utility does not detect any other native
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
failover software, such as Sun StorEdge Traffic Manager or Linux native multipath (MPIO).
Use the snapshot feature (Navisphere Express only) — On storage systems with Navisphere Express, you can start and stop a snapshot on the source server (server assigned to the source virtual disk or source LUN), or you can allow or remove access to the snapshot by the secondary server (server assigned to the snapshot).
About the Admhost Utility The Admhost Utility is an executable program that you can run interactively or with a script. It runs only on Windows operating systems, and works with replication software applications (for example, SAN Copy™, SnapView™ and MirrorView™/A devices), and non-replication software devices. Use admhost commands to:
Scan for new storage devices
Assign drive letters to the devices
Make storage devices inaccessible to the server operating system
Flush cached data to disk
List drive letters and worldwide names for all server devices
About the Admsnap Utility The Admsnap Utility is an executable program that you can run interactively or with a script to manage SnapView clones and snapshots. The Admsnap Utility resides on the servers connected to the storage system with the SnapView driver installed. Unless indicated otherwise, all references to a Windows server refer to Windows Server 2008, Window Server 2003 or Windows 2000 servers only.
Use admsnap commands to:
Scan for new storage devices
Assign drive letters to the devices
Make storage devices inaccessible to the server operating system
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
7
Flush cached data to disk
List drive letters and worldwide names for all server devices
List current snapshot devices
Map and unmap a snapshot to a SnapView session
Start and stop a SnapView session
If you upgraded your storage system to Navisphere Manager and want to manage snapshots, you must use the SnapView software and the Admsnap Utility. For more information on SnapView and admsnap, refer to the Navisphere Manager help and the EMC SnapView Command Line Interfaces Reference.
About the VSS Provider The EMC VSS Provider requires that you install the CLARAPI application, which is available as part of the EMC Solutions Enabler kit. You can download both the EMC VSS Provider and the EMC Solutions Enabler kit from the Powerlink website. For more information, refer to the EMC Admsnap Release Notes, the EMC VSS Provider Release Notes, and the EMC Solutions Enabler Release Notes.
8
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
Installing the Unisphere Initialization Utility The Unisphere Initialization Utility replaces the Navisphere Initialization Utility.
Installation prerequisites To initialize a storage system using the initialization utility, the server must meet the following requirements:
Run a supported version of the operating system.
Be connected to the same subnet as the 10/100 management ports of the storage system that you want to initialize. This server may also have Fibre Channel connections to the storage system.
If you have an earlier version of the initialization utility installed, you must uninstall it before installing an updated version.
Installing the Unisphere Initialization Utility on a Windows host or a Windows virtual machine We recommend that you download and install the most recent version of the Unisphere Initialization Utility software from the software downloads page on the Powerlink website. 1. Log in as the administrator (or someone who has administrative privileges) to the Windows hostor a Windows virtual machine that is on the same subnet as the storage system. 2. Download the software: a. From the Powerlink website, select Support > Software Downloads and Licensing > Downloads T-Z > Unisphere Server Software. b. Select the initialization utility, and then select the option to save the zip file to your host. c. Double-click the following executable file to start the installation wizard: UnisphereInitTool-Win-32-x86-language-version-build.exe Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
9
where: language is either en_US, when only the English version is available, or loc, when the localized versions are available (including English). version and build are the version number and the build number of the software. 3. Follow the instructions on the installation screens to install the initialization utility. A user interface (UI) and a text-based version and a command line version of the utility are installed. 4. When the installation is complete, click Done to exit the wizard. 5. If your hostor a virtual machine is behind a firewall, open the TCP/IP port 2162 (outgoing) and port 2163 (incoming). These ports are used by the initialization utility. If these ports are not opened, the initialization utility will not function properly.
10
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
Running the Unisphere Initialization Utility You can start the initialization utility from the server on which it is installed. The initialization utility has three methods for executing commands — a user interface (UI) version, a command line interface that can be scripted, or a text-based utility that cannot be scripted. Before continuing, make sure that the storage system is powered up completely. For storage-system initialization, connect the server from which you are running the utility and the storage system to the same network subnet. Once you have assigned an IP address to the storage system, the server and storage system can be on different subnets.
Starting the initialization utility UI on a Windows server or a Windows virtual machine To start the initialization utility, select Start > Programs > EMC > Unisphere > Unisphere Storage System Initialization.
Using the UI version of the initialization utility on a Windows host or a Windows virtual machine After you start the utility, it automatically scans the subnet for supported storage systems. When this storage-system discovery operation is complete, the utility lists, by hardware serial number, all uninitialized and initialized storage systems it found. The hardware serial number is on a hanging tag at the rear of the storage system. If the discovery operation did not find the storage system you are installing, verify that the storage system’s management ports are properly cabled to the LAN on which the host resides. The management ports and the host must both reside on the same physical subnet. Proceed through the wizard screens, providing information where required. For more information about completing the wizard, click Help in the wizard’s menu bar. If you entered an SP IP address for the first time or changed an SP IP address, the utility reboots the storage system, and the SP fault light on the back of each SP starts blinking. The reboot takes several minutes Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
11
to complete. When it has completed, the SP fault light (LED) on each SP stops blinking and remains off.
Starting the text-based or command line initialization utility on a Windows server or a Windows virtual machine To start the text-based version, at a command prompt enter cd C:\Program Files\EMC\InitTool or cd C:\Program Files (x86)\EMC\InitTool; then enter ToolCLI.exe. To start the command line version, at a command prompt enter cd C:\Program Files\EMC\InitTool or cd C:\Program Files (x86)\EMC\InitTool; then enter ./inittoolcli and any of the command line switches listed for the initialization utility in the Navisphere Command Line Interface (CLI) Reference Guide (P/N 300-003-628).
12
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
Installing the Unisphere Server Utility and Unisphere Host Agent This section describes how to install the Unisphere Host Agent and the Unisphere Server Utility. The Unisphere Host Agent and Unisphere Server Utility replace the Navisphere Host Agent and the Navisphere Server Utility respectively. You must install the host agent or server utility on the server. You cannot install it on a virtual machine. Before you begin Refer to the sections below to determine which application to install for host registration and the requirements for installing each of these applications.
To run Unisphere server software, your server must meet the requirements outlined in Requirements for Unisphere server software, page 13.
To determine whether to install the Unisphere Host Agent or Unisphere Server Utility to register your HBAs with the storage system, refer to Determining whether to install the Unisphere Host Agent , page 14.
Installing the Unisphere Host Agent or Unisphere Server Utility Depending on which software application you are installing, refer to the appropriate section below.
Unisphere Host Agent – see Installing the Unisphere Host Agent, page 15.
Unisphere Server Utility – see Installing the Unisphere Server Utility , page 19.
Requirements for Unisphere server software To run Unisphere server software, your server must meet the following requirements:
Run a supported version of the Windows operating system.
For Fibre Channel connections, have the EMC CLARiiON supported HBA hardware and driver installed.
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
13
Be connected to at least one SP (two SPs for high availability) in each storage system either directly or through a switch or hub. Each SP must have an IP connection.
For the host agent and CLI only - Be on a TCP/IP network connected to at least one SP (two SPs for high availability) in the storage system. The TCP/IP network connection allows the server to send LUN mapping information to the storage system and it allows Navisphere Manager or Navisphere CLI to communicate with the storage system over the network.
Have a configured TCP/IP network connection to any remote hosts that you will use to manage the server’s storage systems, including: z
any server whose browser you will use to access Navisphere Manager,
z
a supported Windows server running Unisphere Server software (replaces the Navisphere Management Server software),
z
any AIX, HP-UX, Linux, VMware ESX Server, NetWare, Solaris, or Windows server running Navisphere CLI.
If you want to use Navisphere CLI on the server to manage storage systems on a remote server, the server must be on a TCP/IP network connected to both the remote server and each SP in the remote server’s storage system. The remote server can be running AIX, HP-UX, Linux, Solaris, or the Windows operating system. For information about the specific revisions of the server operating system and the storage-system FLARE and Access Logix™ software that are required for your version of the host agent, see the release notes for the host agent on the EMC Powerlink website.
Determining whether to install the Unisphere Host Agent Depending on your application needs, you can install the host agent to:
14
Monitor storage-system events and notify personnel by e-mail, page, or modem when any designated event occurs.
Retrieve LUN world wide name (WWN) and capacity information from Symmetrix® storage systems.
Register the server’s HBAs with the storage system. Alternatively, you can use the Unisphere Server Utility to register the server’s
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
HBAs with the storage system. Table 1 describes the host registration differences between the host agent and the server utility. Table 1
Host registration differences between the host agent and the server utility
Function
Unisphere Host Agent
Unisphere Server Utility
Pushes LUN mapping and OS information to the storage system.
Yes – LUN mapping information is displayed in the Manager UI next to the LUN icon or with the CLI using the lunmapinfo command.
CX4 series, CX3 series, and CX series storage systems No – LUN mapping information is not sent to the storage system. Only the server’s name, ID, and IP address are sent to the storage system. Note: The text Manually Registered appears next to the hostname icon in the Manager UI indicating that the host agent was not used to register this server.
Runs automatically to send information to the storage system.
Yes – No user interaction is required.
CX4 series, CX3 series, and CX series storage systems Yes – You can control whether server information is automatically sent to the storage system by enabling or disabling the registration service feature. This feature is automatically enabled during the installation of the server utility, but you can stop the service at any time through the services option in the Microsoft user interface. Note that only the server’s name, ID, and IP address are sent to the storage system; LUN mapping information is not sent.
Requires network connectivity to the storage system.
Yes – Network connectivity allows LUN mapping information to be available to the storage system.
CX4 series, CX3 series, and CX series storage systems No – LUN mapping information is not sent to the storage system. Note that if you are using the server utility to upload a high-availability report to the storage system, you must have network connectivity.
Installing the Unisphere Host Agent This section describes how to install the Unisphere Host Agent. To modify an existing host agent configuration refer to the next section. Installing the Unisphere Host Agent on a Windows server We recommend that you download and install the most recent version of the Unisphere Host Agent software from the software downloads page on the Powerlink website. 1. Log in as the administrator or a user who has administrative privileges. 2. If your server is behind a firewall, open TCP/IP port 6389. This port is used by the host agent. If this port is not opened, the host agent will not function properly. Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
15
3. If you are running a version prior to 6.26 of the host agent, you must remove it before continuing with the installation. 4. Download the software: a. From the Powerlink website, select Support > Software Downloads and Licensing > Downloads T-Z > Unisphere Server Software. b. Select the Unisphere Host Agent, and then select the option to save the software to your server. c. Double-click the executable file listed below to start the installation wizard. UnisphereHostAgent-Win-32-x86-en_US-version-build.exe where version and build are the version number and the build number of the software. 5. Follow the instructions on the installation screens to install the Unisphere Host Agent. The Unisphere Host Agent software is installed on the Windows server. If you selected the default destination folder, the software is installed in the C:\Program Files\EMC\HostAgent (32–bit) or C:\Program Files (x86)\EMC\HostAgent (64–bit). Once the Unisphere Host Agent installation is complete, the Initialize Privileged User List dialog box is displayed. 6. In the Initialize Privileged User List dialog box, perform one of the following:
16
If the Config File field contains a file entry, then a host agent configuration file already exists on the server from a previous agent installation. Select Use Existing File to use this configuration file or select Browse to use a different file. The host agent configuration file contains a list of login names for this server. Only users whose usernames are listed in the Privileged User List can send CLI commands to the storage system.
If the Config File field does not contain a file entry, then a host agent configuration file does not exist on the server. Select
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
Create/Overwrite File and browse to the agent.config file. You will then need to add users to the Privileged User List (login names for this server). Only users whose usernames are listed in the Privileged User List can send CLI commands to the storage system.
There must be at least one entry in the Privileged User List or an error message will appear.
To add a user to the list
Click Add to open the Add Privileged User dialog box.
In the Add Privileged User dialog box, under User Name, enter the person’s account username, for example, Administrator.
Under System Name, enter the name of the host running Navisphere Manager (for example, Host4) and click OK.
To remove a privileged user from the list Select the privileged username, and click Remove. 7. Click OK to save the new privileged user list and/or the new configuration file. The program saves the host agent configuration file with the new privileged user entries and starts the host agent. 8. Click Finish. A command line window opens indicating that the host agent service is starting. 9. If the system prompts you to reboot the server, click Yes. 10. If you updated the host agent and were using event monitor, restore the event monitor configuration from a previously copied Navimon.cfg file: a. Stop the agent:
At the Windows server, log in as the administrator or the equivalent.
Open the Services pane.
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
17
z
From the desktop, right-click My Computer and select Manage > Services and Applications > Services. or
z
Select Start > Administrative Tools > Computer Management > Services and Applications > Services.
The Services pane opens.
In the Services pane, right-click Unisphere Host Agent and select Stop.
If asked to confirm your request to stop the agent service, click Yes, and close the Services pane or dialog box.
b. Move or copy the saved Navimon.cfg to the real Navimon.cfg file. c. Start the agent:
At the Windows server, log in as the administrator or the equivalent.
Open the Services pane. z
From the desktop, right-click My Computer and select Manage > Services and Applications > Services. or
z
Select Start > Administrative Tools > Computer Management > Services and Applications > Services.
The Services pane opens.
In the Services pane, right-click Unisphere Host Agent and select Start.
If you want the host agent to start automatically at system startup: z
Right-click Unisphere Host Agent and select Properties. The Unisphere Host Agent Properties dialog box opens.
z
Select the General tab.
z
In Startup Type, select Automatic. The host agent will now start automatically at system startup.
18
Close Computer Management.
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
It may take a few minutes for the host agent to start if either applications are using the storage system or the SP event log is large and the host agent configuration file is not set up. 11. Click Done to exit the installation wizard. 12. Verify that Unisphere Host Agent is installed using the Add/Remove Programs dialog box.
Installing the Unisphere Server Utility This section describes how to install the Unisphere Server Utility. Installing the Unisphere Server Utility on a Windows server We recommend that you download and install the most recent version of the Unisphere Server Utility software from the software downloads page on the Powerlink website. 1. Log in as the administrator or someone who has administrative privileges. 2. Download the software: a. From the Powerlink website, select Support > Software Downloads and Licensing > Downloads T-Z > Unisphere Server Software. b. Select the Unisphere Server Utility, and then select the option to save the software to your server. c. Double-click the executable file listed below to start the installation wizard. UnisphereServerUtil-Win-32-x86-language-version-build.exe where: language is either en_US, when only the English version is available, or loc, when the localized versions are available (including English). version and build are the version number and the build number of the software. 3. Follow the instructions on the installation screens and accept all the defaults. Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
19
If you do not have the host agent installed, do not disable the registration service feature (it is enabled by default). The registration service feature automatically registers the server’s HBAs with the storage system after the installation and updates server information to the storage system whenever the server configuration changes (for example, when you mount new volumes or create new partitions).
4. When the installation is complete, click Done to exit the wizard.
20
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
Running the Unisphere Host Agent or Unisphere Server Utility This section describes how to configure and/or run the host agent and run the server utility and how to.
Running the Unisphere Host Agent This section describes how to start and stop the host agent and how to test the host agent connections. Starting and stopping the Unisphere Host Agent This section describes how to start and stop the host agent service. This section also describes how to configure the storage system connected to the server. When a storage system experiences heavy input/output traffic (that is, applications are using the storage system), information may not be reported to the host agent in a timely manner, resulting in the host agent taking several minutes to execute a storage-system management task. This behavior is most evident when one host agent is managing multiple storage systems. Also, if the SP event log is large and the host agent configuration file is set up to read all events, it may take a few minutes for the host agent to start.
Starting the host agent on a Windows server 1. Log in as the administrator or the equivalent. 2. Open the Services pane.
From the desktop, right-click My Computer and select Manage > Services and Applications > Services. or
Select Start > Administrative Tools > Computer Management > Services and Applications > Services.
The Services pane opens. 3. In the Services pane, right-click Unisphere Agent and select Start. 4. If you want the host agent to start automatically at system startup: a. Right-click Unisphere Agent and select Properties. Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
21
The Unisphere Agent Properties dialog box opens. b. Select the General tab. c. In Startup Type, select Automatic. 5. Close the Services pane. The host agent will now start automatically at system startup. It may take a few minutes for the host agent to start when:
Applications are using the storage system, or
The SP event log is large and the host agent configuration file is not set up.
Stopping the host agent on a Windows server 1. At the Windows server or Windows virtual machine, log in as the administrator or the equivalent. 2. Open the Services pane.
From the desktop, right-click My Computer and select Manage > Services and Applications > Services. or
Select Start > Administrative Tools > Computer Management > Services and Applications > Services.
The Services pane opens. 3. In the Services pane, right-click Unisphere Agent and select Stop. 4. If asked to confirm your request to stop the agent service, click Yes, and close the Services pane. Testing the host agent connections Before continuing, you should test the host agent connections as follows: 1. Start the host agent as described in Starting and stopping the Unisphere Host Agent, page 21. 2. Look for any errors on the console and in the operating system log to make sure the agent started and no device errors occurred. 3. Verify that the host agent on the server can see the storage system as follows:
22
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
a. Enter the following CLI command: naviseccli |navicli [-d device]| -h hostname port -list -hba You cannot specify both the –d switch and –h switch.
where: [-d device] is the device name for the storage system (only supported with legacy systems). -h hostname is the IP address of the SP. For each HBA in the server, a listing similar to the following will be displayed. For storage systems in a SAN (shared storage) environment, the listing includes HBAs in all connected hosts. Information about each HBA: HBA UID: 10:00:00:60:B0:3E:46:AC:10:00:00:60:B0:3E:46:AC Server Name: siux134 Server IP Address: 128.221.208.134 HBA Model Description: HBA Vendor Description: HBA Device Driver Name: Information about each port of this HBA: SP Name: spa HBA Devicename: sp0 Trusted: NO Logged In: YES Source ID: 1 Defined: YES Initiator Type: 0 Storage Group Name: Storage Group 134
b. In the listing, verify the path for each HBA installed in the host to the SP. Host agent status and error logging While the system is running, the operating system tracks information about host agent events and host agent errors, and places this information in log files on the server. The host agent error log tracks information about the host agent’s startup, the host agent shutdown, and errors that might occur, such as Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
23
the host agent’s inability to access a device in the configuration file. If problems occur, log files are a good place to start your troubleshooting.
Running the Unisphere Server Utility This section describes how to start and use the server utility. Starting the Unisphere Server Utility on a Windows server 1. Run the Unisphere Server Utility by selecting Start > Programs > EMC > Unisphere > Unisphere Server Utility or Start > All Programs > EMC > Unisphere > Unisphere Server Utility. 2. Select your language, if the software prompts you for it. A text-based version of the utility is installed automatically when you install the utility. To start the text-based version, at a command prompt enter cd C:\Program Files\EMC\Unisphere Server Utility or cd C:\Program Files (x86)\EMC\Unisphere Server Utility, then enter ServerUtilCLI.exe.
Using the Unisphere Server Utility The Unisphere Server Utility allows you to perform the following functions:
Update server information on the storage system
Generate a high-availablity report
For information on using the Unisphere Server Utility, including how to perform manual checks after generating a high-availability report, click Help from the utility’s Help menu or if you are running the text-based version of the utility, select Start > Programs> EMC > Unisphere > Unisphere Server Utility Help or Start > All Programs > EMC > Unisphere > Unisphere Server Utility Help. To generate a high-availability report using the command line, continue to the next section. Generating a high-availability report The Generate high availability report option determines if the server is configured for high availability by determining if the server has at least one connection path to each storage-system SP, and whether PowerPath or some other failover software, such as VMware native, is running. 24
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
To generate a high-availability report using the command line, open a command window and enter one of the following commands: cd C:\Program Files\EMC\Unisphere Server Utility or cd C:\Program Files (x86)\EMC\Unisphere Server Utility Then enter serverutilcli hav. For more information on the command line version, including available switches, refer to the Navisphere Command Line Interface (CLI) Reference (P/N 300-003-628). After the verification, the utility generates a summary report and saves it to the server.
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
25
Installing Navisphere CLI This section describes how to install Navisphere CLI. You can install Navisphere CLI on either the server or virtual machine.
Installing Navisphere CLI on a Windows server or a Windows virtual machine We recommend that you download and install the most recent version of the Navisphere CLI software from the software downloads page on the Powerlink website. 1. Log in as the administrator or someone who has administrative privileges. 2. If an earlier version of the CLI is already installed, you must remove it before continuing with the installation. The installation program does not let you overwrite an existing version. 3. If your server is behind a firewall, open the TCP/IP ports listed in Table 2. These ports are used by Navisphere CLI. If these ports are not opened, the software will not function properly. Table 2
TCP/IP ports Software
TCP/IP ports
Classic CLI
6390, 6391, 6392
Secure CLI
443, 2163
4. Download the software: a. From the Powerlink website, select Support > Software Downloads and Licensing > Downloads J-O > Navisphere Server Software. b. Select the Navisphere CLI, and then select the option to save the software to your server. c. Double-click the executable file listed below to start the installation wizard. NaviCLI-Win-32-x86-language-version-build.exe where:
26
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
language is either en_US, when only the English version is available, or loc, when the localized versions are available (including English). version and build are the version number and the build number of the software. 5. Follow the instructions on the installation screens to install the Navisphere CLI. 6. When the installation is complete, click Done to exit the wizard. You have installed the Navisphere CLI software. If you selected the default destination folder, the software is installed in C:\Program Files\EMC\Navisphere CLI (32–bit) or C:\Program Files (x86)\EMC\Navisphere CLI (64–bit). 7. Verify that Navisphere CLI is installed using the Add/Remove Programs dialog box.
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
27
Installing the Admhost Utility If you want to access LUNs that participate in SAN Copy sessions, install the Admhost Utility. The Admhost Utility is supported on Microsoft Windows platforms only. For the supported Windows versions, see the Admhost Release Notes.
Installing the Admhost Utility on a Windows server We recommend that you download and install the most recent version of the Admhost Utility software from the software downloads page on the Powerlink website. IMPORTANT Currently, you cannot install admhost on your virtual machine if your virtual machine is connected to Fibre Channel or FCoE storage; you must install it on the Hyper-V server. For any updates, refer to the Admhost Release Notes. 1. Log in as the administrator or as someone who has administrator privileges. 2. If admhost is already installed, remove it. 3. Download the software: a. From the Powerlink website, select Support > Software Downloads and Licensing > Downloads S> SANCopy. b. Select the Admhost Utility, and then select the option to save the software to your server. c. In the folder where you saved the software, double-click the executable file to start the installation wizard. 4. Follow the instructions on the installation screens to install the Admhost Utility. 5. When the installation is complete, click Finish to exit the wizard. You have installed the admhost software. If you selected the default destination folder, admhost is installed in the C:\Program 28
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
Files\EMC\Unisphere Admhost (32–bit) or C:\Program Files (x86)\EMC\Unisphere Admhost (64–bit).
Running the Admhost Utility Refer to the EMC SAN Copy Command Line Interface Reference for information on running admhost commands.
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
29
Installing the Admsnap Utility To access snapshots of LUNs in the storage system, install the Admsnap Utility. You can install admsnap on the server or on the virtual machine. IMPORTANT Currently, you cannot install admsnap on your virtual machine if your virtual machine is connected to Fibre Channel storage; you must install it on the Hyper-V server. For any updates, refer to the Admsnap Release Notes.
Installation prerequisites Before you can install and use the Admsnap Utility, you must install SnapView on a supported CLARiiON storage system. For a list of supported storage systems, refer to the release notes for SnapView and admsnap.
Installing the Admsnap Utility on a Windows server We recommend that you download and install the most recent version of the Admsnap Utility software from the software downloads page on the Powerlink website. 1. Log in as the administrator or as someone who has administrative privileges. 2. If admsnap is already installed, remove it. The installation program will not let you install admsnap over an existing revision. 3. Download the software: a. From the Powerlink website, select Support > Software Downloads and Licensing > Downloads S > SnapView. b. Select the Admsnap Utility version you want to download and select the option to save the software to your server. c. Double-click the following executable file to start the installation wizard:
30
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
Windows Server 2003 – admsnap-Win2K3-32– en_US-version-build.exe 4. Follow the instructions on the installation screens to install the Admsnap Utility. 5. When the installation is complete, click Finish to exit the wizard. If you selected the default destination folder, admsnap is installed in C:\Program Files\EMC\Unisphere Admsnap (32–bit) or C:\Program Files (x86)\EMC\Unisphere Admsnap (64–bit).
Running the Admsnap Utility Refer to the EMC SnapView Command Line Interface Reference for information on running admsnap commands.
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
31
Silent installations and removals using the InstallAnywhere package A silent installation and removal uses a command line interface to install or remove applications on all attached Windows servers. To perform the installation or removal, you need to create a response file on one of the attached servers. A response file stores the setup configuration, which allows you to install or remove the applications on all remaining attached Windows servers by using one command that requires no user input. The following Unisphere products support silent installations and removals:
Initialization utility
Host agent
Server utility
Navisphere CLI
Preparing for a silent installation Before you begin the silent installation process, you must determine if you are performing an upgrade, a new installation, which is also referred to as a fresh installation, or both.
32
New installation — You can install the software in the default location or can specify an alternate location in the software_name.properties file.
Upgrade — You can install the software only in the location of the previously installed software. If you specify an alternate location in the software_name.properties file the installer process will override the alternate location you specified and install the software in the same location as the previously installed software.
New installation and upgrade — If you are performing a new installation and an upgrade in the same environment, you will need to perform the steps described in the remaining sections twice, the first time for the new installation and the second for the upgrade. In the case of an upgrade, if you removed the software prior to installing the newer version, this is considered a new installation, so the silent installation process will install the software in the default location or can specify an alternate location in the software_name.properties file. If you did not remove the software
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
prior to installing a newer version, you can install the software only in the location of the previously installed software. If you specify an alternate location in the software_name.properties file the installer process will override the alternate location you specified and install the software in the same location as the previously installed software.
Only a system administrator can perform a silent installation and removal.
Creating the response file This section describes how to create a response file. The response file will store the setup configuration so that you can install the initialization utility, host agent, Navisphere CLI, or server utility on all attached Windows servers using one command. Since no input is required, this type of installation is referred to as a silent installation. We recommend that you download and install the most recent version of the Unisphere server software from the software downloads page on the Powerlink website. 1. Download the software: a. From the Powerlink website, select Support > Software Downloads and Licensing > Downloads T-Z > Unisphere Server Software. b. Select the Unisphere server software you want to install. c. Select the option to save the software to your server and save it to a folder on your local hard drive. d. Navigate to the software you saved on your server and double-click the executable file to start the installation wizard. 2. Open a command prompt window and navigate to the folder where you put the executable installation package. For example, if you copied the installation package to a folder called ResponseFile on your C: drive, you would enter cd ResponseFile in the command window. 3. Depending which executable installation package you downloaded, enter one of the following commands:
HostAgent.exe –r
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
33
NaviSECCli.exe –r
ServerUtil.exe –r
InitTool.exe –r
4. Follow the instructions in the installation wizard. When the installation is complete, the installer creates a file in the current working directory called installer.properties. This file contains your responses during the installation process. 5. Navigate to the installer.properties file and rename the file to software_name.properties, where software_name is the name of the software you installed. For example, HostAgent.properties. Continue to the next section to perform a silent installation. 6. If you are performing a new installation, also referred to as a fresh installation, rename the file to software_nameNew.properties, where software_name is the name of the software you installed. For example, HostAgentNew.properties. If you are performing an upgrade or a new installation and an upgrade in the same environment, repeat steps 3 through 5, then rename the installer.properties file to software_nameUpgrade.properties, where software_name is the name of the software you installed. For example, HostAgentUpgrade.properties. 7. If the text user USERNAME@SYSTEMNAME appears at the end of the agent.config file, edit the response file to add USER_ID and SYSTEM_ID or run installer -r again to create a correct response file. 8. Move the properties file or files to a working directory or shared directory.
Running the silent installation Follow the procedure below to perform a silent installation. The InstallAnywhere installation package can use UNC paths or drive paths.
1. On another attached Windows server (not the same server on which you created the response file), open a command prompt window. 2. Depending on where you put the properties file that was created in the previous section, run one of the following commands: 34
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
If the properties file is in the current working directory: software_name.exe -i silent -f software_name.properties For example, HostAgent.exe -i silent -f HostAgent.properties, or if you are performing a new (fresh) installation and an upgrade in the same environment, HostAgent.exe -i silent –f HostAgentNew.properties or HostAgent.exe -i silent –f HostAgentUpgrade.properties.
If the properties file is on a shared drive: software_name.exe -i silent –f \\UNC_PATH\ software_name.properties For example, HostAgent.exe -i silent –f \\UNC_PATH\ HostAgent.properties
If the properties file is given without a path, the installation package will look in the current working directory only.
3. The installation process will start in silent mode. 4. Repeat steps 2 and 3 on all remaining attached Windows servers.
Preparing for a silent removal Follow the procedure below to perform a silent removal. 1. On the Windows server in which you performed the silent installation, open a command prompt window. 2. Navigate to the directory in which you installed the software, and enter the following command: drive:\install_directory\software_name\uninstall.exe -i silent 3. Repeat steps 1 and 2 on any other attached Windows servers where you want to remove the software.
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
35
Removing the Unisphere server software from a Windows server or a Windows virtual machine Before removing the Unisphere Host Agent — To avoid losing site-specific information, copy the host agent configuration file (agent.config) and the event monitor configuration file (Navimon.cfg) to a safe location or rename it before removing any Unisphere server software.
1. Log in as the administrator or the equivalent. 2. If you are removing the host agent, stop the host agent service as follows: a. Open the Services pane.
From the desktop, right-click My Computer and select Manage > Services and Applications > Services. or
Select Start > Administrative Tools > Computer Management > Services and Applications > Services.
The Services pane opens. b. Stop the host agent:
In the Services pane, right-click Unisphere Agent or Navisphere Agent and select Stop.
If asked to confirm your request to stop the agent service, click Yes.
c. Close the Services pane. 3. Open the Control Panel by selecting Start > Settings > Control Panel or Start > Control Panel. 4. On the Control Panel pane, double-click Add/Remove Programs or Program and Features. 5. Select the Unisphere or Navisphere software you want to remove and click Change/Remove or Uninstall/Change. 6. Click Yes, if asked, to remove the entire host agent directory, which includes the agent.config and Navimon.cfg files. These files contain all site-specific agent configurations from the server. Click No to cancel the removal of this directory. 36
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
7. If your server is behind a firewall and you removed the initialization utility, host agent, or CLI, and you are not installing another version of the software, close the TCP/IP ports you opened during the installation of the host agent or CLI. IMPORTANT Before closing any ports, verify that no other software program is using them.
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
37
Copyright© 2004–2010 EMC Corporation. All Rights Reserved. EMC believes the information in this publication is accurate as of its publication date. The information is subject to change without notice. THE INFORMATION IN THIS PUBLICATION IS PROVIDED "AS IS." EMC CORPORATION MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Use, copying, and distribution of any EMC software described in this publication requires an applicable software license. For the most up-to-date regulatory document for your product line, go to the Technical Documentation and Advisories section on EMC Powerlink. For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com All other trademarks mentioned herein are the property of their respective owners. 38
Updating or Installing EMC Unisphere Server Software on Windows Server 2003 or Windows Virtual Machines
