Setting Up a Unisphere Management Station for the VNX Series

P/N 300-011-796 Revision A01 January 5, 2010

This document describes the different types of Unisphere management stations and tells how to install and configure software on each type. It also tells how to start Unisphere on a station running the Unisphere client. Topics in this document include: Unisphere management station overview........................................ Types of Unisphere management stations........................................ Software for each type of Unisphere management station................. Installing the required software ...................................................... Configuring a Unisphere Management Station ................................ Initialize security for an Unisphere management station .................. Starting Unisphere on the Unisphere management station................ 2 3 5 6 18 19 20

Unisphere management station overview

A Unisphere management station is a Microsoft Windows Server 2008, Windows Server 2003, Windows Vista, or Windows XP host that is connected to the system management ports through a network and is running some or all of the following VNX software:
Table 1

Unisphere Client for Windows Unisphere Server for Windows Unisphere Host Agent for Windows EMC Secure Remote Support (ESRS) IP Client for VNX software Unisphere Service Manager (USM)

Operating system support for Unisphere management software Operating system Windows 2008, Windows server 2003 Windows XP Windows Vista Supported software All listed software Unisphere UIs, Unisphere Server and USM Unisphere UIs and Unisphere Server

Depending on the type of Unisphere management station, you may or may not be able to access the Unisphere UI from it. A Unisphere management station can be updated with new VNX software without requiring a host reboot. A system cannot be updated with new operating environment software, which includes the Unisphere client and Unisphere Server, without a system reboot.

Setting Up a Unisphere Management Station for the VNX Series

Types of Unisphere management stations

The types of Unisphere management stations are: Remote user station Secure entry point station Standalone performance station Event monitoring station EMC Secure Remote Support (ESRS) IP client

Remote user station or secure entry point station

A remote user station or a secure entry point station is an off-array management station (a local host) that is connected to storage-system management ports through a network and is running only the Unisphere UIs. For a remote user, this configuration eliminates the overhead of accessing the UI from a storage system. For additional security, you can limit management access to the system to only those authorized users who have installed the client on their Windows host by disabling the ability to launch the UIs from the system.

Standalone performance station

A standalone performance station is an Unisphere management station used mostly by a service provider to analyze system performance with Unisphere Analyzer and/or manage system quality of service with Unisphere Quality of Service Manager (QoS).

Event monitor station or ESRS IP client

In a centralized event monitoring environment, an Unisphere management station can be a monitor station for Event Monitor or ESRS, sending alerts or automatically notifying your service provider when certain events occur. By offloading this work from one or more systems to a monitor station, you can improve the performance of these systems. For a centralized event monitoring station, you must configure at least one event monitoring template. For a ESRS IP client, you must install the ESRS template.
Setting Up a Unisphere Management Station for the VNX Series
3

We strongly recommend that you do not connect an Unisphere management station that is running event monitor or ESRS IP client to the systems data ports.

Setting Up a Unisphere Management Station for the VNX Series

Software for each type of Unisphere management station

Table 2 lists the software you must install on each type of Unisphere management station.
Table 2 Unisphere management station software Software to install Unisphere type Unisphere Client Yes Yes Yes No No Unisphere Server No No Yes No No Host Agent ESRS IP Client No No No No Yes Unisphere Service Manager No No Optional No No

Remote user station Secure entry point station Standalone performance station Monitor station ESRS IP client

No No No Yes Yes

Setting Up a Unisphere Management Station for the VNX Series

Installing the required software

This section describes how to install the required software on the Windows host that will be an Unisphere management station. This Windows host must be on the same network as the system management ports.

Installing the Unisphere Server

Download and install the Unisphere Server from the EMC Online Support website to your Unisphere Management station. 1. From the EMC Online Support website, locate the Support section. 2. Select the management server version you want to download and select the option to save the software to your management station. a. In the directory where you saved the download, double-click the executable. b. Follow the installation wizard instructions.

3. Install the Unisphere Server:

Installing the Unisphere Client

Download and install the Unisphere Client from the EMC Online Support website to your Unisphere management station. 1. From the EMC Online Support website, locate the Support section and the link to Software Downloads. 2. Select the Unisphere Client version you want to download and select the option to save the software to your off-array management station. 3. Install the Unisphere Client: a. In the directory where you saved the download, double-click the executable. b. Follow the installation wizard instructions.

Install the Unisphere Host Agent

If the Unisphere management station that you are setting up is a full-function management station or a ESRS IP client, you do not need
6

Setting Up a Unisphere Management Station for the VNX Series

to install the host agent because it is installed automatically as part of the ESRS installation. You need to install this software only on an Unisphere management station that you are setting up as an event monitoring station. 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. 3. Download the software: a. From the EMC Online Support website, locate the Support section and the link to Software Downloads. b. Select the option to save the Unisphere Host Agent software to your server. c. Double-click one of the executable files 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. 4. 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 (32bit) or C:\Program Files (x86)\EMC\HostAgent (64bit). Once the Unisphere Host Agent installation is complete, the Initialize Privileged User List dialog box is displayed. 5. In the Initialize Privileged User List dialog box, select 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 logged in as listed in the Privileged User List can send CLI commands to the storage system. perform one of the following:
Setting Up a Unisphere Management Station for the VNX Series
7

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 logged in as 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, a host agent configuration file does not exist on the server. Select 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 logged in as 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 persons account username, for example, Administrator. Under System Name, enter the name of the host running Unisphere (for example, Host4) and click OK.

To remove a privileged user from the list Select the privileged username, and click Remove. 6. 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. 7. Click Finish. A command line window opens indicating that the host agent service is starting. 8. If you are prompted to reboot the server, click Yes.
8

Setting Up a Unisphere Management Station for the VNX Series

Windows servers with NIC initiators If you do not reboot before you run the Microsoft iSCSI Software Initiator, the NIC initiators cannot log in to the storage system. 9. 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.
z

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

Setting Up a Unisphere Management Station for the VNX Series

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 z

Select the General tab. In Startup Type, select Automatic. The host agent will now start automatically at system startup.

Close Computer Management. 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.

10. Click Done to exit the installation wizard. 11. If you have a multihomed host (multiple NIC cards installed on the host), create an agentID.txt file to ensure that the agent finds the correct NIC card.
A multihomed host machine has multiple IP addresses connected to networks; it is physically connected to multiple data links that can be on the same or different networks. When you install Unisphere Host Agent on a multihomed host, the host agent, by default, binds to the first NIC in the host. If your host is multihomed, for the host agent to successfully register with the desired system, you need to configure the host agent to bind to a specific NIC. You do this by setting up an agentID.txt file.

a. Using a text editor that does not add special formatting, create a file named agentID.txt (case sensitive). Save this file by doing one of the following: Set the EV_AGENTID_DIRECTORY environmental variable to the location you want to save the agentID.txt file. The Unisphere Host Agent will then look for the agentID.txt file in the location you specified. If you do not specify a location in the EV_AGENTID_DIRECTORY environmental variable, Unisphere Host Agent will look for the agentID.txt file in the location specified

10

Setting Up a Unisphere Management Station for the VNX Series

by the registry entry HKEY_LOCAL_MACHINE\SOFTWARE\EMC\Agent\1.0\ConfigPath. This location is usually C:\Program Files\emc\HostAgent. If EV_AGENTID_DIRECTORY or HKEY_LOCAL_MACHINE\SOFTWARE\EMC\Agent\1.0\ConfigPath does not exist, create the agentID.txt file in the C:\ directory.

b. Add the following two separate lines to the agentID.txt file, with no special formatting: First line: Fullyqualified hostname of the host Second line: IP address of the NIC port that you want
host agent to use

For example, if your host is named host28 on the domain mydomain.com and your host contains two NICs, HBA1/NIC1 with IP address 192.111.222.2 and HBA2/NIC2 with IP address 192.111.222.3, and you want the host agent to use NIC 2, you would configure agentID.txt as follows:
host28.mydomain.com 192.111.222.3

The agentID.txt file should contain only these two lines, without any formatting. The first line should contain the hostname and the second line should contain the IP address of the NIC port as described above. Both lines should end with a carriage return. As a result, the cursor will be on a third line but this line should not contain any text.

c. Save the agentID.txt file. d. Restart the host agent. e. Once the host agent has restarted, verify that the host agent is using the correct IP address that is entered in the agentID.txt file by doing one of the following: In Unisphere, verify that the host IP address is the same as the IP address that you entered in the agentID.txt file. If the address is the same, the agentID.txt file is configured correctly.

Setting Up a Unisphere Management Station for the VNX Series

11

View the new HostIdFile.txt file. You should see the IP address that is entered in the agentID.txt file.

12. Verify that Unisphere Host Agent is installed using the Add/Remove Programs dialog box. 13. Create and apply any Event Monitor templates.

ESRS IP Client for VNX requirements

Refer to the EMC ESRS IP Client Release Notes for the latest ESRS IP Client environment and systems requirements.

The version of ESRS IP Client for VNX software must be at or later than the version of the management software bundled with the VNX Operating Environment (OE) running on each VNX for Block or legacy system that is being monitored. Also, legacy file system is not supported by ESRS IP Client, only VNX for File is supported. ESRS IP Client for VNX installation requires: Monitor station: The monitor station must be a host or virtual machine with a CPU speed of 1.0 GHz or greater, a total physical memory size of 2 GB or greater, 1 GB of hard disk space, and running a supported Windows operating system. Also, the .NET Framework version 2.0 must be installed on the monitor station. The monitor station cannot be a client (host connected to storage-system data ports), and the monitored systems must be able to connect to it over your network.
For the latest list of supported Windows operating systems, refer to the EMC ESRS IP Client Release Notes.
z z

If you do not have an existing monitor station You can create a monitor station by installing ESRS IP Client on a Windows host. If you have an existing monitor station running CLARalert You can upgrade to ESRS IP Client for VNX on the monitor station. When you perform an upgrade, the wizard asks if you want to preserve your existing email configuration or if you want to reconfigure it. If you have an existing monitor station running event monitor You can install ESRS IP Client on the monitor station.

12

Setting Up a Unisphere Management Station for the VNX Series

Fixed or static IP address: The monitor station must have a fixed or static IP address. If DHCP is used, a reserved IP address must be configured. The wizard automatically detects and configures the ESRS IP Client with the IP address for the monitor station, which is required for ESRS IP Client installation. Open TCP Ports: The monitor station uses the following TCP ports:
z z z z z z z z z z z

TCP port 80 (for HTTP, inbound/outbound) TCP port 443 (for HTTPS, inbound/outbound) TCP port 25 (for SMTP server, outbound) TCP port 6389 (for Unisphere Host Agent, outbound) TCP port 5414 (for EMCRemote Client, outbound) TCP port 9519 (for RemotelyAnywhere on CX4 systems running FLARE version 04.29 or later or on VNX systems, outbound) TCP port 6391, 6392, and 60020 (for Remote Diagnostic Agent, outbound) TCP port 22 (for CLI via SSH) TCP port 13456 (for KTCONS) TCP port 22 and 9519 (for RemoteKtrace) TCP port 80, 443, 2162, 2163, and 8000 (for USM, Unisphere, and NaviSecureCLI)

Proxy server: If the monitor station connects to the Internet through a proxy server, you must indicate this during ESRS IP Client installation and provide the IP address, port, and protocol (HTTPS or SOCKS) for the proxy server. If the proxy server requires authentication (SOCKS is supported only with authentication), you must also indicate this during installation and supply login credentials for the proxy server. You must supply both username and password for authentication. Powerlink account: You must have an existing and proper Powerlink account. You are required to log in to the EMC Powerlink website and supply your valid storage-system serial number before you can download and install ESRS IP Client software. Registered monitoring site: The monitoring site must be registered on Powerlink. During ESRS IP Client installation, you must specify contact information that includes the name, email address and phone number of a person to contact at the monitoring site.
13

Setting Up a Unisphere Management Station for the VNX Series

Portal system: The portal system must be a VNX for Block or legacy system running the latest VNX Operating Environment (OE) version that is running on the VNX for Block or legacy systems it is monitoring. You must provide the IP address for either SP of the portal system during ESRS IP Client installation. You must also supply global administrator login credentials for the portal system during installation.

If your ESRS IP Client installation will use the optional email notification, for example, as a backup communication method for the Call Home feature, you will need connectivity to an outgoing SMTP server. You must provide the IP address for the SMTP server during ESRS IP Client installation. You must also provide your email address (in the from field) for email notification.

Download and install ESRS IP Client software (EMC Online Support) You can access and download the ESRS IP Client UI-based installer wizard from the EMC Online Support website. Use the wizard to download and configure all the ESRS IP Client software components required to set up a centralized monitoring environment for your VNX for Block or legacy systems. From the monitor station: 1. On the EMC Online Support website, search for the ESRS IP Client software download link. 2. Select Download ESRS IP Client and save the software to your monitor station. 3. In the folder where you saved ESRS IP Client , double-click the ESRS IP Client executable file or if necessary, right-click the file and select Run as to run the installation wizard using a different users credentials.

4. Follow the steps in the wizard to complete the installation.

For all CX4 systems that are running FLARE version 04.29 or later and VNX for Block systems and are deployed in this ESRS IP Client configuration, you must add the monitor station IP address to the RemotelyAnywhere filter tables of those systems.

14

Setting Up a Unisphere Management Station for the VNX Series

The ESRS IP Client software installation generates four log files. Two of these log files (esrsagent_installer.log and esrsipclient_installer.log) are located under the users home directory in the EMC\ESRSIPClient folder. The third log, esrs_rscapi.log, and fourth log, esrs_jema.log, are located in the directory where the ESRS IP Client is installed. Typically, this is C:\Program Files\EMC\ESRS IP Client on 32-bit systems or C:\Program Files (x86)\EMC\ESRS IP Client on 64-bit systems. The esrs_rscapi.log log is created for VNX for Block registrations only. The esrs_jema.log log is created for VNX for File registrations only. Download and install ESRS IP Client software (VNX Installation Toolbox CD) You can access and download the ESRS IP Client UI-based installer wizard from your VNX Installation Toolbox CD. Use the wizard to download and configure all the ESRS IP Client components required to set up a centralized monitoring environment for your VNX for Block and legacy systems.
If your PC or browser is running pop-up blocking software, you must disable it before using the software on the VNX Installation Toolbox CD.

From the monitor station: 1. Insert the VNX Installation Toolbox CD. The VNX Installation Toolbox CD software license agreement appears. 2. After reading the license agreement, click Accept and then click Submit to continue. The Install Your VNX Storage System screen appears. 3. Select the applicable model and storage type from the respective list boxes. 4. Click View Procedure. The installation instructions specific to the model and storage type you selected appear. 5. Follow the hardware installation instructions and when directed to download the ESRS IP Client wizard, return to the Install Your
Setting Up a Unisphere Management Station for the VNX Series
15

VNX Storage System screen and click ESRS IP Client. A File Download dialog box appears. 6. Either select Run to run the ESRS IP Client executable file from the VNX Installation Toolbox CD or select Save to save the software to your monitor station. If you saved the ESRS IP Client executable file to a folder, in that folder double-click the ESRS IP Client executable file or if necessary, right-click the file and select Run as to run the installation wizard using a different users credentials. 7. Follow the steps in the wizard to complete the installation.

Installing the Unisphere Service Manager

The Unisphere Service Manager (USM) is a Java-based desktop application that helps you update, install, and maintain your storage-system hardware and software, and provide contact and storage-system information to your service provider. Use the wizards within the USM to perform hardware installation tasks, such as adding a new disk drive or disk-array enclosure, or hardware maintenance tasks, such as replacing a faulted disk drive or verifying that your storage system is operating normally. You can also use the USM to update your storage-system software. Downloading and installing the Unisphere Service Manager 1. From the EMC Online Support website search for the link to download the Unisphere Service Manager. 2. Select the Unisphere Service Manager link and save the software to your host or management station. 3. In the folder where you saved the USM, double-click the executable (.exe) file, and if necessary, click Run to start the installation wizard. 4. Follow the instructions that appear. After you accept the license agreement, the wizard verifies that the server is running the supported Java Runtime Environment (JRE) version. If the server is running an earlier version of the JRE, select Yes when asked if you want to continue with the installation.

16

Setting Up a Unisphere Management Station for the VNX Series

The installation wizard prompts you to download and install the later version of the JRE from the Sun website. If the server is running a later version of the JRE, the installation wizard asks if you want to continue with the installation. Select Yes to continue or No to quit the installation.
Important: If you select Yes, the USM may not work properly with a later JRE version. If you select No, and manually remove the later version of the JRE, other applications that require this version may not work properly.

5. When the installation is complete, click Done.

Setting Up a Unisphere Management Station for the VNX Series

17

Configuring a Unisphere Management Station

1. Open a new Internet browser and enter the appropriate url below: If a web server such as IIS is running on the Unisphere management station, you cannot use standard ports to access Unisphere. You must specify the ports that Unisphere defines by entering the following url: http://localhost:2162/setup If a web server is not running on the Unisphere management station, enter the following url: http://localhost/setup The Management Server Networking Configuration dialog box opens. 2. Verify the following: IP to listen on lists the IP address(es) of the server.
If you have multiple LAN cards or ports, select one of the IP addresses from the drop-down list or use the default IP address.

Management Ports lists the ports of the server that are available for communication.

3. Click Apply Settings so the Management Server recognizes the IP address.

18

Setting Up a Unisphere Management Station for the VNX Series

Initialize security for an Unisphere management station

1. In the Internet browser, enter the IP address of the Unisphere management station (the same IP address listed in the IP to listen on in the previous step). The Confirm: Unisphere Security dialog box opens. 2. Click Yes to set the security. The Create Global Administrator dialog box opens. 3. Enter a username and password, and click OK. 4. In the Confirm: Add User? dialog box, click Yes to add the new user. 5. In the Success: Initialize Security dialog box, click OK. 6. In Unisphere, log in as the global administrator using the account that you just created (File > Login).

Setting Up a Unisphere Management Station for the VNX Series

19

Starting Unisphere on the Unisphere management station

You can start Unisphere on any management station that has the Unisphere UIs installed on it, that is, on all types of stations except for a monitor station or a ESRS station. Start Unisphere using a browser, the Unisphere icon on the stations desktop, or the path Start > All Programs > EMC > Unisphere > Unisphere Management UI. If you want to connect to the station using a connection type other than the stations IP address, you must use the Unisphere icon.

Starting Unisphere using a browser

1. Start a supported browser, such as Microsoft Internet Explorer or Firefox. 2. In the browser, enter the IP address or host name of the Unisphere management station.

Starting Unisphere using the Unisphere icon

1. On the Unisphere management stations desktop, double-click the Unisphere icon. 2. Enter the Unisphere management stations IP address and click Connect.

20

Setting Up a Unisphere Management Station for the VNX Series

Copyright 20102011 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 EMC Online Support website. 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.
Setting Up a Unisphere Management Station for the VNX Series
21