windows unisphere server software install

Here is Your Customized Document

Your Configuration is:Updating Unisphere server software

Model - VNX5300Connection Type - Fibre Channel Switch or Boot from SANServer Operating System - Windows Server 2008Path Management Software - PowerPathDocument ID -1321637205432

Reporting Problems

To send comments or report errors regarding this document,please email: [email protected] Issues not related to this document, contact your service provider.Refer to Document ID:1321637205432Content Creation Date Fri Nov 18 12:27:20 EST 2011

This guide describes how to update or install Unisphere™ server software for EMC® VNX™platforms.

If you are an EMC partner, refer to the EMC Services Partner website to download the Unisphereserver software mentioned in this guide. The partner site is available from the Navigatordrop-down menu on the Powerlink®website.

Unless indicated otherwise, the tasks described in this document apply to aWindows server anda Windows virtual machine.

Important:

This document uses the term system to refer to your VNX storage system.

Some of the procedures in this document apply only to the server, only to the virtual machine, or to boththe server and the virtualmachine. Read each section carefully to determinewhere to perform the procedure.

Your operating system or configuration may not support all the Unisphere™ server software mentioned inthis guide. Refer to the E-Lab™ InteroperabilityNavigator for information on supported configurations. TheE-Lab Navigator is available on the EMC Online Support website. After logging into the website, locate theapplicable support by product page, find tools, and select E-Lab Interoperability Navigator.

Topics include:

Before you start........................................................................................................................................................4Finding current information..................................................................................................................................5About EMC Unisphere server software...............................................................................................................6Installing the Unisphere Initialization Utility.....................................................................................................9Running the Unisphere Initialization Utility....................................................................................................11Installing the Unisphere Server Utility and Unisphere Host Agent..............................................................13Running the Unisphere Host Agent or Unisphere Server Utility..................................................................19Installing Navisphere Secure CLI.......................................................................................................................23Running Navisphere Secure CLI.........................................................................................................................25

Updating or Installing EMC Unisphere ServerSoftware on Windows Server 2008 or

Windows Virtual Machines

http://powerlink.emc.com

https://support.emc.com/Products/

Installing the Admhost Utility.............................................................................................................................26Running the Admhost Utility..............................................................................................................................27Installing the Admsnap Utility............................................................................................................................30Running the Admsnap Utility.............................................................................................................................32Silent installations and removals using the InstallAnywhere package.........................................................33Removing Unisphere server software................................................................................................................37

Before you start

◆ Read the release notes for your system type, which are available on the EMC OnlineSupport website.

◆ Refer to the E-Lab™ Interoperability Navigator on the EMC Online Support website forinformation on supported operating system versions, including supported virtualmachines.

4 Updating Unisphere Server Software

Before you start




Finding current information

The most up-to-date information about the Unisphere™ server software is posted on theEMC Online Support website.

EMC recommends that you download the latest information before you install any serversoftware.

After you log in, locate the applicable support by product page and find the following:

◆ 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 themost currentmanagement and security content, refer to the EMCUnisphere onlinehelp.

◆ EMC VNX Command Line Interface Reference for Block (P/N 300-011-815)

Finding current information 5

Finding current information


About EMC Unisphere server software

This section describes all the available Unisphere™ server software.

Your operating system or configuration may not support all the software mentioned. Referto the E-Lab™ Interoperability Navigator on the EMC Online Support website® forinformation on supported configurations.

◆ Unisphere Initialization Utility◆ Navisphere Secure Command Line Interface (CLI)◆ Unisphere Host Agent (replaces the Navisphere Host Agent)◆ Unisphere Server Utility (replaces the Navisphere Server Utility)◆ Admhost Utility◆ Admsnap Utility

About the Unisphere Initialization Utility

For Fibre Channel systems, use the Unisphere™ Initialization Utility to discover systemsand set network parameters (IP address, subnet mask, and default gateway). In addition,for iSCSI systems with iSCSI data ports attached to Windows servers, use the utility to setnetwork parameters for these ports.

You can install the initialization utility on a server or other host such as a Unispheremanagement station. The only requirement is that the host be connected to the same networksubnet as the system management ports.

About the Navisphere Secure CLI

The CLI complements or is an alternative toUnisphere. It provides a command line interfacefor systemmanagement, including storage provisioning, status and configuration informationretrieval, and control. You can use the CLI to automatemanagement functions through shellscripts and batch files. For more information, refer to the EMC VNX Command Line InterfaceReference for Block (P/N 300-011-815).

About the Unisphere Host Agent

The host agent registers the server’s host bus adapter (HBA)with the attached systemwhenthe host agent service starts. This action sends the initiator records for each HBAs to thesystem. Initiator records are used to control access to system data.

The agent can then retrieve information from the system automatically at startup or whenrequested by Unisphere or the CLI.




The host agent can also:

◆ Send operating system drive mapping information to the attached VNX.◆ Monitor 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:

◆ Update server information to the systemLets you send the server name and IP address to the system and, if neededlater on, allows you to update or view this data. If theRegistration Servicefeature remains enabled after the installation of the server utility, theutility automatically registers the server’s HBAs with the system andupdates server information whenever the configuration changes (forexample, 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 systemSP, and that PowerPath® or some other failover software, such as VMwarenative failover, DMP, PV Links, or HP native failover for 11iV3 is running.The utility does not detect any other native failover software, such as SunStorEdge Traffic Manager or Linux native multipath (MPIO).

◆ Use the snapshot feature (Navisphere Express only)On systems with Navisphere Express, you can start and stop a snapshoton the source server (server assigned to the source virtual disk or sourceLUN), or you can allow or remove access to the snapshot by the secondaryserver (server assigned to the snapshot).

About the Admhost Utility

TheAdmhost Utility is an executable program that you can run interactively orwith a script.

It runs only onWindows operating systems, andworkswith replication software applications(for example, SAN Copy™, SnapView™ and MirrorView™/A devices), and non-replicationsoftware devices.

Use admhost commands to:

◆ Scan for new storage devices

About the Unisphere Server Utility 7


◆ 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

TheAdmsnapUtility is an executable program that you can run interactively orwith a scriptto manage SnapView clones and snapshots.

The Admsnap Utility resides on the servers connected to the system with the SnapViewdriver installed.

Note: 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◆ 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



Installing the Unisphere Initialization Utility

Installation prerequisites

To initialize a system using the initialization utility, the server must meet the followingrequirements:

◆ Run a supported version of the operating system.◆ Be connected to the same subnet as the 10 / 100 management ports of the system that

youwant to initialize. This servermay also have Fibre Channel connections to the system.

If you have an earlier version of the initialization utility installed, you must uninstall itbefore installing an updated version.

Installing the Unisphere Initialization Utility on a Windows host or a Windowsvirtual machine

We recommend that you download and install the most recent version of the UnisphereInitialization Utility software from the applicable support by product page on the EMCOnline Support website.

1. Log in as the administrator (or someone who has administrative privileges) to theWindows host or a Windows virtual machine that is on the same subnet as the system.

2. Download the software:

a. From the EMCOnline Support website search for the link to download the software.

b. Select the initialization utility, and then select the option to save the zip file to yourhost.

c. Double-click the following executable file to start the installation wizard:UnisphereInitTool-Win-32-x86-language-version-build.exe

where:

language is either en_US, when only the English version is available, or loc, whenthe 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 utilityare installed.

Installing the Unisphere Initialization Utility 9


http://support.emc.com



4. When the installation is complete, click Done to exit the wizard.

5. If your host 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, theinitialization utility will not function properly.



Running the Unisphere Initialization Utility

You can start the initialization utility from the server onwhich it is installed. The initializationutility has threemethods for executing commands—auser interface (UI) version, a commandline interface that can be scripted, or a text-based utility that cannot be scripted. Beforecontinuing, make sure that the system is powered up completely.

Note: For system initialization, connect the server from which you are running the utility and thesystem to the same network subnet. Once you have assigned an IP address to the system, the serverand system can be on different subnets.

Starting the initialization utility UI on a Windows server or a Windows virtualmachine

To start the initialization utility, select Start ➤ All Programs ➤ EMC ➤ Unisphere ➤ UnisphereStorage System Initialization.

Using the UI version of the initialization utility on a Windows host or aWindows virtual machine

After you start the utility, it automatically scans the subnet for supported systems. Whenthis system discovery operation is complete, the utility lists, by hardware product ID/serialnumber, all uninitialized and initialized systems it found. The hardware product ID/serialnumber is on a hanging tag at the rear of the system.

If the discovery operation did not find the system you are installing, verify that the system’smanagement ports are properly cabled to the LAN on which the host resides. Themanagement ports and the host must both reside on the same physical subnet.

Proceed through the wizard screens, providing information where required. For moreinformation 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 utilityreboots the system, and the SP fault light on the back of each SP starts blinking. The reboottakes several minutes to complete. When it has completed, the SP fault light (LED) on eachSP stops blinking and remains off.

Starting the text-based or command line initialization utility on a Windowsserver or a Windows virtual machine

◆ To start the text-based version, at a command prompt enter cd C:\ProgramFiles\EMC\InitTool or cd C:\Program Files (x86)\EMC\InitTool; then enterInitToolCLI.exe.

Running the Unisphere Initialization Utility 11


◆ To start the command line version, at a command prompt enter cd C:\ProgramFiles\EMC\InitTool or cd C:\Program Files (x86)\EMC\InitTool; then enterInitToolCLI.exe and any of the command line switches listed for the initializationutility in the EMC VNX Command Line Interface Reference for Block (P/N 300-011-815).



Installing the Unisphere Server Utility and Unisphere Host Agent

This section describes how to install the Unisphere Host Agent and the Unisphere ServerUtility.

You must install the host agent or server utility on the server. You cannot install it on avirtual machine.

Before you begin

Refer to the sections below to determinewhich application to install for host registrationand the requirements for installing each of these applications.

◆ To run Unisphere server software, your server must meet the requirements outlinedin Requirements for Unisphere server software on page 13.

◆ To determinewhether to install theUnisphereHost Agent or Unisphere Server Utilityto register your HBAs with the system, refer to Determining whether to install theUnisphere Host Agent on page 14.

Installing the Unisphere Host Agent or Unisphere Server Utility

Depending on which software application you are installing, refer to the appropriatesection below.

◆ Unisphere Host Agent – see Installing the Unisphere Host Agent on page 15.

◆ Unisphere Server Utility – see Installing the Unisphere Server Utility on page18.

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 EMCVNX supportedHBAhardware and driver

installed.◆ Be connected to at least one SP (two SPs for high availability) in each 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 system.

The TCP/IP network connection allows the server to send LUNmapping information tothe system and it allows Unisphere or Navisphere CLI to communicate with the systemover the network.

Installing the Unisphere Server Utility and Unisphere Host Agent 13


◆ Have a configured TCP/IP network connection to any remote hosts that you will use tomanage the systems, including:

• any server whose browser you will use to access Unisphere,• a supported Windows server running Unisphere Server software (replaces the

Navisphere Management Server software),• 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 systems on a remote server, theserver must be on a TCP/IP network connected to both the remote server and each SP in thesystem. The remote server can be running AIX, HP-UX, Linux, Solaris, or the Windowsoperating system.

Note: For information about the specific revisions of the server operating system and the systemFLAREand Access Logix™ software that are required for your version of the host agent, see the release notesfor the host agent on the EMC Online Support website.

Determining whether to install the Unisphere Host Agent

Depending on your application needs, you can install the host agent to:

◆ Monitor system events and notify personnel by e-mail, page, or modem when anydesignated event occurs.

◆ Retrieve LUN world wide name (WWN) and capacity information from Symmetrix®systems.

◆ Register the server’s HBAs with the system.

Alternatively, you can use the Unisphere Server Utility to register the server’s HBAswith the system. Table 1 on page 14 describes the host registration differences betweenthe host agent and the server utility.

Table 1. Host registration differences between the host agent and the server utility

Unisphere Server UtilityUnisphere Host AgentFunction

No – LUN mapping information is not sent to thesystem. Only the server’s name, ID, and IP addressare sent to the system.

Yes – LUN mapping information isdisplayed in the Unisphere UI next tothe LUN icon or with the CLI usingthe lunmapinfo command.

Pushes LUN mapping and OSinformation to the system.

Note: The text Manually Registeredappears next to the hostname icon in the UnisphereUI indicating that the host agent was not used toregister this server.




Table 1. Host registration differences between the host agent and the server utility (continued)

Unisphere Server UtilityUnisphere Host AgentFunction

Yes – You can control whether server informationis automatically sent to the system by enabling or

Yes – No user interaction is required.Runs automatically to send in-formation to the system.

disabling the registration service feature. This fea-ture is automatically enabled during the installationof the server utility, but you can stop the service atany time through the services option in the Mi-crosoft user interface. Note that only the server’sname, ID, and IP address are sent to the system;LUN mapping information is not sent.

No – LUN mapping information is not sent to thesystem. Note that if you are using the server utility

Yes – Network connectivity allowsLUN mapping information to beavailable to the system.

Requires network connectivityto the system.

to upload a high-availability report to the 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 UnisphereHost Agent software from the EMC Online Support 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 notfunction properly.

3. If you are running a version prior to 6.26 of the host agent, you must remove it beforecontinuing with the installation.


a. From the EMC Online Support website, select the VNX Support by Product page andlocate the Software Downloads.

b. Select the Unisphere Host Agent, and then select the option to save the software toyour server.

c. Double-click the executable file listed below to start the installation wizard.

Installing the Unisphere Host Agent 15




UnisphereHostAgent-Win-32-x86-en_US-version-build.exe

where version and build are the version number and the build number of thesoftware.

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 selectedthe default destination folder, the software is installed in the C:\ProgramFiles\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 Listdialog box is displayed.

6. In the Initialize Privileged User List dialog box, perform one of the following:

7. To add a user to the list:

a. Click Add to open the Add Privileged User dialog box.

b. In the Add Privileged User dialog box, under User Name, enter the person’s accountusername, for example, Administrator.

c. Under System Name, enter the name of the host running Unisphere (for example,Host4) and click OK.

8. To remove a privileged user from the list:

a. Select the privileged username, and click Remove.

9. 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 entriesand starts the host agent.

10. Click Finish.

A command line window opens indicating that the host agent service is starting.

11. If the system prompts you to reboot the server, click Yes.

12. If you updated the host agent and were using event monitor, restore the event monitorconfiguration from a previously copied Navimon.cfg file:

a. Stop the agent:

a. At the Windows server, log in as the administrator or the equivalent.

b. Open the Services pane.



◆ From the desktop, right-click My Computer and select Manage ➤ Services andApplications ➤ Services.

or

◆ Select Start ➤ Administrative Tools ➤ Computer Management ➤ Services andApplications ➤ Services.

The Services pane opens.

c. In the Services pane, right-click Unisphere Host Agent and select Stop.

d. If asked to confirm your request to stop the agent service, click Yes, and close theServices pane or dialog box.

b. Move or copy the saved Navimon.cfg to the real Navimon.cfg file.

c. Start the agent:

a. At the Windows server, log in as the administrator or the equivalent.

b. Open the Services pane.


or



c. In the Services pane, right-click Unisphere Host Agent and select Start.

d. If you want the host agent to start automatically at system startup:

i. Right-click Unisphere Host Agent and select Properties.

The Unisphere Host Agent Properties dialog box opens.

ii. Select the General tab.

iii. In Startup Type, select Automatic.

The host agent will now start automatically at system startup.

e. Close Computer Management.

It may take a fewminutes for the host agent to start if either applications are usingthe system or the SP event log is large and the host agent configuration file is notset up.

Installing the Unisphere Server Utility and Unisphere Host Agent 17


13. Click Done to exit the installation wizard.

14. Verify that Unisphere Host Agent is installed using the Add/Remove Programs dialogbox.

Installing the Unisphere Server Utility

This section describes how to install the Unisphere Server Utility on your server.

Installing the Unisphere Server Utility on a Windows server

We recommend that you download and install the most recent version of the UnisphereServer Utility software from the applicable support by product page on the EMC OnlineSupport website.

1. Log in as the administrator or someone who has administrative privileges.



b. Select the Unisphere Server Utility, and then select the option to save the software toyour server.


UnisphereServerUtil-Win-32-x86-language-version-build.exe

where



3. Follow the instructions on the installation screens and accept all the defaults.

Note: If you do not have the host agent installed, do not disable the registration service feature (itis enabled by default). The registration service feature automatically registers the server’s HBAswith the system after the installation and updates server information to the system whenever theserver configuration changes (for example,when youmount newvolumes or create newpartitions).

4. If you are installing the server utility on a server that is using theMicrosoft iSCSI initiatorto connect to the system, select Yes when prompted.







Running the Unisphere Host Agent or Unisphere Server Utility

This section describes how to configure and run the host agent and how to run the serverutility.

Running the Unisphere Host Agent

This section describes how to start and stop the host agent and how to test the host agentconnections.

Starting and stopping the Unisphere Host Agent

This section describes how to start and stop the host agent service. This section also describeshow to configure the system connected to the server.

Note: When a system experiences heavy input/output traffic (that is, applications are using the system),information may not be reported to the host agent in a timely manner, resulting in the host agenttaking several minutes to execute a systemmanagement task. This behavior is most evident when onehost agent is managing multiple systems. Also, if the SP event log is large and the host agentconfiguration 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.

a. From the desktop, right-click My Computer and select Manage ➤ Services andApplications ➤ Services.

or

b. Select Start ➤ Administrative Tools ➤ Computer Management ➤ Services andApplications ➤ Services.


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.

The Unisphere Agent Properties dialog box opens.

b. Select the General tab.

c. In Startup Type, select Automatic.

Running the Unisphere Host Agent or Unisphere Server Utility 19


5. Close the Services pane.

The host agent nows start automatically at system startup.

It may take a few minutes for the host agent to start when:

◆ Applications are using the 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 , log in as the administrator or the equivalent.

2. Open the Services pane.


or



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 Servicespane.

Testing the host agent connections

Before continuing, you should test the host agent connections as follows:

1. Start the host agent as described in .

2. Look for any errors on the console and in the operating system log tomake sure the agentstarted and no device errors occurred.

3. Verify that the host agent on the server can see the system as follows:

a. Enter the following CLI command: naviseccli |navicli [-d device]| -h hostname port -list -hba

Note: You cannot specify both the –d switch and –h switch.

where

[-d device] is the device name for the 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. Forsystems in a SAN (shared storage) environment, the listing includes HBAs in allconnected hosts.

Information about each HBA:HBA UID: 10:00:00:60:B0:3E:46:AC:10:00:00:60:B0:3E:46:ACServer Name: siux134Server IP Address: 128.221.208.134HBA Model Description:HBA Vendor Description:HBA Device Driver Name:Information about each port of this HBA:SP Name: spaHBA Devicename: sp0Trusted: NOLogged In: YESSource ID: 1Defined: YESInitiator Type: 0Storage 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 agentevents 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 agentshutdown, and errors that might occur, such as the host agent’s inability to access a devicein the configuration file. If problems occur, log files are a good place to start yourtroubleshooting.

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 ServerUtility.

2. Select your language, if the software prompts you for it.

Running the Unisphere Host Agent 21


Note: A text-based version of the utility is installed automatically when you install the utility. Tostart the text-based version, at a command prompt enter cd C:\Program Files\EMC\UnisphereServer Utility or cd C:\Program Files (x86)\EMC\Unisphere Server Utility, then enterServerUtilCLI.exe.

Using the Unisphere Server Utility

The Unisphere Server Utility allows you to perform the following functions:

◆ Update server information on the system◆ Generate a high-availablity report

For information on using the Unisphere Server Utility, including how to perform manualchecks after generating a high-availability report, click Help from the utility’s Help menu orif 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 forhigh availability by determining if the server has at least one connection path to eachsystem SP, and whether PowerPath or some other failover software, such as is running.The utility will not detect any other native failover software, such as native multipath(MPIO).

To generate a high-availability report using the command line, open a commandwindowand 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, referto the EMC VNX Command Line Interface Reference for Block (P/N 300-011-815)

After the verification, the utility generates a summary report and saves it to the server.



Installing Navisphere Secure CLI

This section describes how to install Navisphere Secure CLI.

You can install Navisphere CLI on either the server or virtual machine.

Installing Navisphere Secure CLI on a Windows server or a Windows virtualmachine

We recommend that you download and install the most recent version of the NavisphereSecureCLI software from the applicable support by product page on the EMCOnline Supportwebsite.

1. Log in as the administrator or someone who has administrative privileges.

2. If an earlier version of the CLI is already installed, youmust remove it before continuingwith 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 on page 23.

These ports are used by Navisphere CLI. If these ports are not opened, the software willnot function properly.

Table 2. TCP/IP ports

TCP/IP portsSoftware

443, 2163Secure CLI



b. Select the Navisphere Secure CLI, and then select the option to save the software toyour server.


NaviCLI-Win-32-x86-language-version-build..exe

where:


Installing Navisphere Secure CLI 23





5. Follow the instructions on the installation screens to install the Navisphere Secure CLI.


If you selected the default destination folder, the software is installed in C:\ProgramFiles\EMC\Navisphere CLI(32–bit) or C:\Program Files(x86)\EMC\Navisphere CLI (64–bit).

You have installed the Navisphere CLI software.

7. Verify that Navisphere Secure CLI is installed using the Add/Remove Programs dialogbox.



Running Navisphere Secure CLI

Refer to the EMC VNX Command Line Interface Reference for Block (P/N 300-011-815) forinformation on running Navisphere Secure CLI.

Running Navisphere Secure CLI 25

Running Navisphere Secure CLI

Installing the Admhost Utility

If you want to access LUNs that participate in SAN Copy sessions, install the AdmhostUtility.

Note: The Admhost Utility is supported on Microsoft Windows platforms only. For the supportedWindows 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 AdmhostUtility software from the applicable support by product page on the EMC Online Supportwebsite.

Important:

Currently, you cannot install admhost on your virtual machine if your virtual machine is connectedto Fibre Channel or FCoE storage; you must install it on the Hyper-V server. For any updates, referto 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.



b. Select the Admhost Utility, and then select the option to save the software to yourserver.

c. In the folder where you saved the software, double-click the executable file to startthe 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:\ProgramFiles\EMC\Unisphere Admhost (32–bit) or C:\Program Files(x86)\EMC\Unisphere Admhost (64–bit).


Installing the Admhost Utility




Running the Admhost Utility

Table 3 on page 27 lists the admhost commands and describes their function in SAN Copysessions.

Table 3. Admhost functions and descriptions

Syntax and examplesDescriptionFunction

admhost lun_activate [-llun_wwn -d driveletter][-h]

The admhost lun_activate commandscans the bus for new devices and assigns adrive letter to all Symmetrix and VNX devicesthat do not already have one.

admhost lun_acti-vate

where:

Use the -l and -d switches to scan the busfor new devices and assign a drive letter to a

-l lun_wwn specifies the WWN of theLUN to which you want to assign a driveletter (requires the -d switch).device that has a specific world wide name

(WWN). This command does not assign driveletters to any other devices. -d driveletter specifies the drive

letter you want to assign to the specifiedLUN (requires the -l switch).

If admhost_activate is used and no newdevices are found, and drive letters are alreadyassigned to the VNX and Symmetrix logical units,admhost reports an error message.

-h displays the help message.

If the admhost lun_activatecommand activates more than one device,the drive letter is assigned to the first de-vice in the list.

admhost lun_deactivate -oobjectName [-t object

type][-h]

The admhost lun_deactivate com-mand attempts to take devices offline and makethem inaccessible to the operating system. Thecommand deletes the drive letter and dismountsthe device.

admhost lun_deac-tivate

where:Use the admhost lun_activate com-mand to bring the volume back online.

-o objectName specifies the drive letterof the device you want to deactivate. If youspecify the device name, admhost findsthe device, deletes its drive letter, dis-mounts it, and then takes the device of-fline.

-t object_type is an optional switchthat specifies the object type (device ordriveletter) of the device you want to de-activate.

-h displays the help message.

admhost lun_flush [-h] -oobject_name [-t object_type

device|driveletter]

The admhost lun_flush commandflushes all write cache data, for the specifieddevice (object_name) to disk.

admhost lun_flush

Running the Admhost Utility 27


Table 3. Admhost functions and descriptions (continued)


where:

-h displays a help message.

-oobject_name specifies the name ordrive letter of the device you want to flush.

-t object_type is an optional switchthat specifies the object type (device ordriveletter) of the device you want to flush.

If you specify the device name, admhostidentifies the corresponding device anddrive letter.

admhost lun_list [-h] [-llun_wwn] [-d object_name][-a output_style]

The admhost lun_list command liststhe drive letters and WWNs for all server devices.

admhost lun_list

where:

-h displays a help message.

-l lun_wwn specifies the WWN of thedevice you want to list.

-d object_name specifies the driveletter or name of the device you want tolist.

-a output_style specifies an alterna-tive output style for the list output. Thedefault style lists the drive letter and WWNfor the logical unit. The -a switch lets youspecify physicaldrive as the outputstyle.

admhost helpThis admhost help command displays thesyntax for each admhost command and theversion number of the Admhost Utility.

admhost help

Output for admhost help command isshown below:



Table 3. Admhost functions and descriptions (continued)


Revision number:V1.1.0.0.0 - 0Valid operationsinclude: lun_flush,lun_activate,lun_deactivate,lun_list, and help.Valid typesinclude: device anddriveletter.

For more information on using the admhost commands mentioned above, refer to the EMCSAN Copy Command Line Interface Reference Guide.

Running the Admhost Utility 29


Installing the Admsnap Utility

To access snapshots of LUNs in the system, install the Admsnap Utility.

You can install admsnap on the server or on the virtual machine.

Installation prerequisites

Before you can install and use the Admsnap Utility, you must install SnapView on asupported system.

For a list of supported 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 AdmsnapUtility software from the applicable support by product page on the EMC Online Supportwebsite.

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.



b. Select the Admsnap Utility version you want to download and select the option tosave the zip file to your server.

c. Double-click the following executable file to start the installation wizard:

Windows Server 2008 -

admsnap-Win2K8-32-en_US-version-build.exe

where version and build are the version number and the build number of thesoftware.

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:\ProgramFiles\EMC\Unisphere Admsnap (32-bit) or C:\Program Files(x86)\EMC\Unisphere Admsnap (64-bit).

Installing the Admsnap Utility 31


Running the Admsnap Utility

Refer to the EMC SnapView Command Line Interface Reference for information on runningadmsnap commands.


Running the Admsnap Utility

Silent installations and removals using the InstallAnywhere package

A silent installation and removal uses a command line interface to install or removeapplications on all attached Windows servers.

To perform the installation or removal, you need to create a response file on one of theattached servers. A response file stores the setup configuration, which allows you to installor remove the applications on all remaining attached Windows servers by using onecommand that requires no user input.

The following Unisphere products support silent installations and removals:

◆ Initialization utility◆ Host agent◆ Server utility◆ Navisphere CLI◆ Admsnap for Windows Server 2008◆ Admhost for Windows Server 2008

Preparing for a silent installation

Before you begin the silent installation process, you must determine if you are performingan upgrade, a new installation, which is also referred to as a fresh installation, or both.

◆ New installationYou can install the software in the default location or can specify analternate location in the software_name.properties file.

◆ Upgrade

You can install the software only in the location of the previously installedsoftware. If you specify an alternate location in thesoftware_name.properties file the installer process will overridethe alternate location you specified and install the software in the samelocation as the previously installed software.

◆ New installation and upgrade

If you are performing a new installation and an upgrade in the sameenvironment, you will need to perform the steps described in theremaining sections twice, the first time for the new installation and thesecond for the upgrade. In the case of an upgrade, if you removed thesoftware prior to installing the newer version, this is considered a newinstallation, so the silent installation process will install the software inthe default location or can specify an alternate location in the

Silent installations and removals using the InstallAnywhere package 33


software_name.properties file. If you did not remove the softwareprior to installing a newer version, you can install the software only inthe location of the previously installed software. If you specify an alternatelocation in the software_name.properties file the installer processwill override the alternate location you specified and install the softwarein the same location as the previously installed software.

Note: 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 setupconfiguration 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 isrequired, this type of installation is referred to as a silent installation.

We recommend that you download and install the most recent version of the Unisphereserver software from the applicable support by product page on the EMC Online Supportwebsite.



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 yourlocal hard drive.

d. Navigate to the software you saved on your server and double-click the executablefile to start the installation wizard.

2. Open a command prompt window and navigate to the folder where you put theexecutable installation package.For example, if you copied the installation package to a folder called ResponseFile onyour C: drive, you would enter cd ResponseFile in the command window.

3. Depending which executable installation package you downloaded, enter one of thefollowing commands:◆ HostAgent.exe –r

◆ 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 workingdirectory called installer.properties. This file contains your responses during theinstallation 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, renamethe file to software_nameNew.properties, where software_name is the name of thesoftware you installed.For example, HostAgentNew.properties.

◆ If you are performing an upgrade or a new installation and an upgrade in the sameenvironment, repeat steps 3 through 5, then rename the installer.propertiesfile to software_nameUpgrade.properties, where software_name is the name ofthe software you installed.

For example, HostAgentUpgrade.properties.

7. If the text user USERNAME@SYSTEMNAME appears at the end of the agent.configfile, edit the response file to add USER_ID and SYSTEM_ID or run installer -r againto 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.

Note: The InstallAnywhere installation package can use UNC paths or drive paths.

1. On another attachedWindows server (not the same server on which you created theresponse file), open a command prompt window.

2. Depending onwhere you put the properties file that was created in the previous section,run one of the following commands:◆ If the properties file is in the currentworking directory:

software_name.exe -i silent -f software_name.properties

Running the silent installation 35


For example,

HostAgent.exe -i silent -f HostAgent.propertiesor if you are performing a new (fresh) installation and an upgrade in the sameenvironment,

HostAgent.exe -i silent –f HostAgentNew.propertiesor

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

Note: If the properties file is given without a path, the installation package will look in the currentworking directory only.

3. The installation process will start in silent mode.

4. Repeat 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 theWindows server in which you performed the silent installation, open a commandprompt window.

2. Navigate to the directory in which you installed the software, and enter the followingcommand:

drive:\install_directory\software_name\uninstall.exe -i silent

3. Repeat 1 and 2 on any other attached Windows servers where you want to remove thesoftware.



Removing Unisphere server software

This section describes how to remove Unisphere server software.

Important: Before removing the Unisphere Host Agent — To avoid losing site-specific information,copy the Host Agent configuration file (agent.config) to a safe location before removing anyUnisphere server software.

Removing the Unisphere server software from a Windows server or aWindows virtual machine

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 and choose from the following:




b. Stop the host agent:

◆ In the Services pane, right-click Unisphere Agent or Navisphere Agent and selectStop.

◆ 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 ➤ ControlPanel.

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 clickChange/Remove or Uninstall/Change.

6. Choose from the following:◆ Click Yes, if asked, to remove the entire host agent directory, which includes the

agent.config and Navimon.cfg files.

Removing Unisphere server software 37


These files contain all site-specific agent configurations from the server.

◆ Click No to cancel the removal of this directory.

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 portsyou opened during the installation of the host agent or CLI.

Important: Before closing these ports, verify that no other software program is using them.



Copyright © 2004 - 2011 EMC Corporation. All rights reserved.

Published 2004

EMC believes the information in this publication is accurate as of its publication date. Theinformation is subject to change without notice.

THE INFORMATION IN THIS PUBLICATION IS PROVIDED "AS IS." EMC CORPORATIONMAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KINDWITH RESPECT TOTHE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIEDWARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Use, copying, and distribution of any EMC software described in this publication requires anapplicable software license.

For the most up-to-date regulatory document for your product line, go to the TechnicalDocumentation and Advisories section on EMC Powerlink.

For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks onEMC.com.

All other trademarks used herein are the property of their respective owners.

Corporate Headquarters: Hopkinton, MA 01748-9103

Updating Unisphere Server Software 39

windows unisphere server software install

Documents

program files emc inittool

emc unisphere server utility

designated event occurs

sp fault light

fibre channel connections

lab interoperability navigator

host registration differences

host agent connections