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
1
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 (ESRS) IP Client for VNX software
Unisphere Service Manager (USM)
Operating system for Unisphere management software Operating system
ed software
Windows 2008, Windows server 2003
All listed software
Windows XP
Unisphere UIs, Unisphere Server and USM
Windows Vista
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.
2
Setting Up a Unisphere Management Station for the VNX Series
Types of Unisphere management stations The types of Unisphere management stations are:
Remote station
Secure entry point station
Standalone performance station
Event monitoring station
EMC Secure Remote (ESRS) IP client
Remote station or secure entry point station A remote 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 , 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 s 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 system’s data ports.
4
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
Unisphere Server
Host Agent
ESRS IP Client
Unisphere Service Manager
Remote station
Yes
No
No
No
No
Secure entry point station
Yes
No
No
No
No
Standalone performance station
Yes
Yes
No
No
Optional
Monitor station
No
No
Yes
No
No
ESRS IP client
No
No
Yes
Yes
No
Setting Up a Unisphere Management Station for the VNX Series
5
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 and install the Unisphere Server from the EMC Online website to your Unisphere Management station. 1. From the EMC Online website, locate the section. 2.
Select the management server version you want to and select the option to save the software to your management station.
3. Install the Unisphere Server: a. In the directory where you saved the , double-click the executable. b. Follow the installation wizard instructions.
Installing the Unisphere Client and install the Unisphere Client from the EMC Online website to your Unisphere management station. 1. From the EMC Online website, locate the section and the link to Software s. 2. Select the Unisphere Client version you want to 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 , 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. as the or a who has istrative privileges. 2. If your server is behind a firewall, open T/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. the software: a. From the EMC Online website, locate the section and the link to Software s. 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 (32–bit) or C:\Program Files (x86)\EMC\HostAgent (64–bit). Once the Unisphere Host Agent installation is complete, the Initialize Privileged List dialog box is displayed. 5. In the Initialize Privileged List dialog box, select Create/Overwrite File and browse to the agent.config file. You will then need to add s to the Privileged List ( names for this server). Only s logged in as listed in the Privileged 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 names for this server. Only s logged in as listed in the Privileged 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 s to the Privileged List ( names for this server). Only s logged in as listed in the Privileged List can send CLI commands to the storage system.
There must be at least one entry in the Privileged List or an error message will appear.
To add a to the list
Click Add to open the Add Privileged dialog box.
In the Add Privileged dialog box, under Name, enter the person’s name, for example, .
Under System Name, enter the name of the host running Unisphere (for example, Host4) and click OK.
To remove a privileged from the list Select the privileged name, and click Remove. 6. Click OK to save the new privileged list and/or the new configuration file. The program saves the host agent configuration file with the new privileged 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 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, as the 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 > istrative 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, as the 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 > istrative Tools > Computer Management > Services and Applications > Services.
The Services pane opens.
In the Services pane, right-click Unisphere Host Agent and select Start.
Setting Up a Unisphere Management Station for the VNX Series
9
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.
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 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:
10
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
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, 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, 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. 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 ed by ESRS IP Client, only VNX for File is ed. ESRS IP Client for VNX installation requires:
Monitor station: The monitor station must be a host or virtual machine with a U 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 ed 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 ed Windows operating systems, refer to the EMC ESRS IP Client Release Notes.
12
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.
z
If you have an existing monitor station running CLARalert — You can 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.
z
If you have an existing monitor station running event monitor — You can install ESRS IP Client on the monitor station.
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 DH 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 T Ports: The monitor station uses the following T ports: z
T port 80 (for HTTP, inbound/outbound)
z
T port 443 (for HTTPS, inbound/outbound)
z
T port 25 (for SMTP server, outbound)
z
T port 6389 (for Unisphere Host Agent, outbound)
z
T port 5414 (for EMCRemote Client, outbound)
z
T port 9519 (for RemotelyAnywhere on CX4 systems running FLARE version 04.29 or later or on VNX systems, outbound)
z
T port 6391, 6392, and 60020 (for Remote Diagnostic Agent, outbound)
z
T port 22 (for CLI via SSH)
z
T port 13456 (for KTCONS)
z
T port 22 and 9519 (for RemoteKtrace)
z
T 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 ed only with authentication), you must also indicate this during installation and supply credentials for the proxy server. You must supply both name and for authentication.
Powerlink : You must have an existing and proper Powerlink . You are required to to the EMC Powerlink® website and supply your valid storage-system serial number before you can and install ESRS IP Client software.
ed monitoring site: The monitoring site must be ed on Powerlink. During ESRS IP Client installation, you must specify information that includes the name, email address and phone number of a person to at the monitoring site.
Setting Up a Unisphere Management Station for the VNX Series
13
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 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.
and install ESRS IP Client software (EMC Online ) You can access and the ESRS IP Client UI-based installer wizard from the EMC Online website. Use the wizard to 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 website, search for the ESRS IP Client software link. 2. Select 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 ’s 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 ’s 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. and install ESRS IP Client software (VNX Installation Toolbox CD) You can access and the ESRS IP Client UI-based installer wizard from your VNX Installation Toolbox CD. Use the wizard to 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 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 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 ’s 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 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 ing that your storage system is operating normally. You can also use the USM to update your storage-system software. ing and installing the Unisphere Service Manager 1. From the EMC Online website search for the link to 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 ed Java Runtime Environment (JRE) version.
16
If the server is running an earlier version of the JRE, select Yes when asked if you want to continue with the installation.
Setting Up a Unisphere Management Station for the VNX Series
The installation wizard prompts you to 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. 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 dialog box opens. 3. Enter a name and , and click OK. 4. In the Confirm: Add ? dialog box, click Yes to add the new . 5. In the Success: Initialize Security dialog box, click OK. 6. In Unisphere, as the global using the that you just created (File > ).
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 station’s 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 station’s IP address, you must use the Unisphere icon.
Starting Unisphere using a browser 1. Start a ed 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 station’s desktop, double-click the Unisphere icon. 2. Enter the Unisphere management station’s IP address and click Connect.
20
Setting Up a Unisphere Management Station for the VNX Series
Copyright © 2010–2011 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 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