clariion server support products for aix servers ... · pdf fileemc clariion server support...

EMC CLARiiON Server SupportProducts for AIX Servers

Installation GuideP/N 300–002–044, Revision A13

October 3, 2008

This guide describes how to install and remove the EMC® Navisphere®Host Agent, Navisphere Storage System Initialization Utility, NavisphereServer Utility, Navisphere Command Line Interface (CLI), and admsnapsoftware on an IBM System p server with the AIX operating system.

If you have an RS 6000 SP server, refer to revision A08 of this guide, which isavailable on the Powerlink® website.

For information on supported operating system versions and serversoftware with a CX4 series, CX3 UltraScale™series, or a CX series storagesystem, refer to the E-Lab™ Interoperability Navigator on the Powerlink®website. For AX4–5 series storage systems, refer to the Support Matrix linkon the Install page of the storage-system support website.

Topics include:

Storage system terminology ........................................................... 3About EMC Navisphere server software ......................................... 4Software for your storage system.................................................... 7Finding current information ........................................................... 8Installing and removing the Navisphere Storage System InitializationUtility .......................................................................................... 9Running the Navisphere Storage System Initialization Utility ........... 12Determining whether to install the host agent or server utility.................................................................................................... 18

Requirements for the host agent, server utility, and CLI ................... 20Installing or removing the Navisphere Host Agent and CLI ............. 21Configuring the Navisphere Host Agent ........................................ 27Using the Event Monitor configuration file ..................................... 29Running the Navisphere Host Agent ............................................. 30Installing and removing the Navisphere Server Utility .................... 33

1

http://Powerlink.EMC.com


Running the Navisphere Server Utility ........................................... 36Installing and removing the Admsnap Utility ................................. 41Running the Admsnap Utility ........................................................ 45

2 EMC CLARiiON Server Support Products for AIX Servers Installation Guide

Storage system terminology

This document uses the following storage system terms:

CX4 series — refers to CX4-120, CX4-240, CX4-480, and CX4-960storage systems

CX3 series — refers to CX3 model 10 systems, CX3 model 20systems, CX3 model 40 systems, and CX3 model 80 storage systems

CX series — refers to CX300 series, CX500 series, and CX700 storagesystems

AX4-5 series — refers to AX4-5SC, AX4-5SCi, AX4-5, AX4-5i storagesystems

AX150 series — systems include the AX150SC, AX150SCi, AX150,and AX150i. AX100 series systems include the AX100SC, AX100SCi,AX100, and AX100i

AX series — to refer to AX150 series and AX100 series storagesystems

EMC CLARiiON Server Support Products for AIX Servers Installation Guide 3

About EMC Navisphere server software

The EMC server-based software listed below is available on the serversupport CD that shipped with your storage system.

For information on the server software supported with yourCLARiiON® storage system and the minimum FLARE® versionrequired, refer to Software for your storage system, page 7 .

Navisphere Storage System Initialization Utility

Navisphere Host Agent

Navisphere Server Utility

Admsnap Utility

Navisphere Command Line Interface (CLI)

About the Navisphere Storage System Initialization Utility

For Fibre Channel storage systems, use the Navisphere® Initializationutility to discover storage systems and set network parameters (IPaddress, subnet mask, and default gateway). In addition, for iSCSIstorage systems with iSCSI data ports attached to Windows servers, usethe utility to set network parameters for these ports.

For CX series storage systems, an authorized service provider must install andrun the initialization utility.

You can run the initialization utility from the server support CD or youcan install it on a server or other host such as a Navisphere off-arraymanagement station. The only requirement is that the host be connectedto the same network subnet as the storage-system management ports.

About the Navisphere Host Agent

The host agent registers the server’s host bus adapter (HBA) with theattached storage system when the host agent service starts. This actionsends the initiator records for each HBA to the storage system. Initiatorrecords are used to control access to storage-system data.

The agent can then retrieve information from the storage systemautomatically at startup or when requested by Manager or CLI.


The host agent can also:

Send operating system drive mapping information to the attachedCLARiiON® storage systems.

Monitor storage-system events and notify personnel by email, page,or modem when any designated event occurs.

Retrieve LUN world wide name (WWN) and capacity informationfrom Symmetrix® storage systems.

About the Navisphere Server Utility

The server utility allows you to perform the following functions:

Update server information to the storage system — Lets you sendthe server name and IP address to the storage system and, if neededlater on, allows you to update or view this data.

Verify server high availability (HA) — Lets you determine if theserver is configured for high availability (HA) by verifying thatthe server has at least one connection path to each storage-systemSP, and that PowerPath® or some other failover software, such asVMware native, DMP, PV Links, or HP native failover for 11iV3is running. The utility does not detect any other native failoversoftware, such as Sun StorEdge Traffic Manager or Linux nativemultipath (MPIO).

This feature is not available on iSCSI servers.

Use the snapshot feature — On storage systems with NavisphereExpress, you can start and stop a snapshot on the source server(server assigned to the source virtual disk or source LUN), or youcan allow or remove access to the snapshot by the secondary server(server assigned to the snapshot).

You can run the Navisphere Server Utility from the CD or you caninstall it on the servers that are connected to the storage system. Westrongly recommend that you install the utility on each server that isconnected to the storage system.


On AX4–5 series storage systems with Navisphere Manager, you cannot usethe server utility to manage snapshots. Instead, you must install and use theadmsnap utility.

About the Admsnap Utility

The Admsnap Utility is an executable program that you can runinteractively or with a script to manage SnapView® clones andsnapshots. The Admsnap Utility resides on the servers connected tothe storage system with the SnapView driver installed.

Use admsnap commands to:

Scan for new storage devices

Make storage devices inaccessible to the server operating system

Flush cache data to disk

List current snapshot devices

Map and unmap to a SnapView session

Start and stop a SnapView session

About the Navisphere CLI

The CLI complements, or is an alternative to Manager. It provides acommand line interface for storage-system management, includingstorage provisioning, status and configuration information retrieval,and control. You can use the CLI to automate management functionsthrough shell scripts and batch files. For more information, refer to theEMC Navisphere Command Line Interface (CLI) Reference Guide.


Software for your storage system

Table 1 lists the minimum FLARE version that your CLARiiON storagesystem requires and the server software that it supports.

IMPORTANT

AX150 series and AX100 series storage systems are not supported on anAIX attached server.

Table 1 Minimum FLARE versions and supported software

Storage system Minimum FLARE version Supported server software

AX4-5 series 02.23.050.5.5xx (NavisphereExpress or Navisphere Manager)

AX4-5 series 02.23.050.5.xxx (NavisphereExpress only)

AX150 series 02.20.xxx.5.yyy

AX100 series 02.16.xxx.5.yyy

Storage systems with Navisphere Express— Navisphere Storage System Initialization Utility— Navisphere Server Utility— Navisphere CLIStorage systems with Navisphere Manager— Navisphere Storage System Initialization Utility— Navisphere Host Agent— Navisphere Server Utility— Admsnap Utility— Navisphere CLI

CX4–120, CX4–240, CX4–480,and CX4–960

04.28.000.5.xxx

CX3–10c 03.24.010.5.xxx

CX3 model 20 systems, CX3model 40 systems, and CX3model 80 systems

03.22.xxx.5.yyy

CX700, CX500 series, andCX300 series

02.16.xxx.5.yyy

Storage systems with Navisphere Manager— Navisphere Storage System Initialization Utility— Navisphere Host Agent— Navisphere Server Utility— Admsnap Utility— Navisphere CLI


Finding current information

The most up-to-date information about the CLARiiON® serversoftware is posted on the EMC Powerlink® website. We recommendthat you download the latest information before you install any serversoftware.

To access EMC Powerlink, use the following link:


After you log in, select Support > Technical Documentation andAdvisories and find the following:

Navisphere Host Agent/CLI and Utilities Release Notes.

EMC SnapView Command Line Interfaces Reference (P/N 069001181).

Installation Roadmap for CLARiiON Storage Systems (P/N 069001166),which provides a checklist of the tasks that you must complete toinstall your storage system in a storage area network (SAN) ordirect attach configuration.

For the most current management and security content, refer to theEMC Navisphere Manager help.

For Navisphere CLI commands, refer to the latest revision ofthe EMC Navisphere Command Line Interface (CLI) Reference (P/N300–003–628).



Installing and removing the Navisphere Storage System InitializationUtility

EMC recommends that you install the utility on the server; however,you can run the Navisphere Storage System Initialization Utility fromthe server support CD.

Installation prerequisites

To initialize a storage system using the Navisphere Storage SystemInitialization Utility, the server must meet the following requirements:

Run a supported version of the operating system.

Be connected to the same subnet as the 10/100 management ports ofthe storage system that you want to initialize. This server may alsobe a server with Fibre Channel connections to the storage system.

If you have an earlier version of the storage system initialization utilityinstalled, you must uninstall it before installing an updated version.

Installing the Navisphere Storage System Initialization Utility on a Windows host

EMC recommends that you install the most recent version of theNavisphere Storage System Initialization Utility software that isappropriate for your configuration. You can download the mostrecent version from the software download page on the Powerlinkwebsite (CX4 series, CX3 series, CX series, and AX4-5 series) or on thestorage-system support website (AX series). You can also install thesoftware from the server support CD (any storage system); however,the CD may not contain the most recent version for your configuration.

1. Log in as the administrator (or someone who has administrativeprivileges) to the Windows host that is on the same subnet as thestorage system.

2. To download the software for CX4 series, CX3 series, CX series, orAX4–5 series storage systems, do the following:

a. From the Navigator drop-down menu at the top right of thePowerlink website, select Software Downloads and Patches.



b. Select the appropriate Navisphere Storage System InitializationUtility version to download and select the option to save thesoftware to your server.

c. In the directory where you saved the software, double-click theexecutable file to start the installation wizard.

3. To install the software from the server support CD (any storagesystem), do the following:

a. In the drive of Windows host, insert the server support CD,which shipped with the storage system or the upgrade kit (forAX4-5 series or AX series systems upgrading to NavisphereManager).

The server support menu opens. If you do not see the serversupport menu, follow the steps below to open it.

From the Windows taskbar, select:

Start > Run

In the Run dialog box, enter:

drive:\locales\en_US\start.html

where drive is the letter for the CD drive. Click OK.

b. Select your language, if prompted for it.

c. From the main menu, click Install Products on Server.

d. From the Install Products menu, click Navisphere StorageSystem Initialization Utility to open the installation wizard.

4. Follow the instructions on the installation screens to install theinitialization utility.

A user interface (UI), a text-based, and a command line version ofthe utility are installed.

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


6. If you installed the initialization utility from the CD, close the serversupport menu by selecting Main Menu and then Exit. You can nowremove the CD from the server’s CD drive.

Removing the Navisphere Storage System Initialization Utility on a Windows host

1. On the Windows host running the Storage System InitializationUtility that you want to remove, log in as the administrator or theequivalent.

2. Open Control Panel by selecting Start > Settings > Control Panelor Start > Control Panel.

3. On the Control Panel pane, double-click Add/Remove Programs orProgram and Features.

4. Select Navisphere Storage System Initialization Utility and clickChange/Remove or Uninstall/Change.

5. If asked to confirm the removal, click OK and follow the steps toremove the software program.


Running the Navisphere Storage System Initialization Utility

You can start the storage system initialization utility from theserver on which it is installed or from the server support CD. Thestorage system initialization utility has three methods for executingcommands — a user interface (UI) version, a command line interfacethat can be scripted, or a text-based utility that cannot be scripted.Before continuing, make sure that the storage system is powered upcompletely.

For storage-system initialization, connect the server from which you arerunning the utility and the storage system to the same network subnet. Onceyou have assigned an IP address to the storage system, the server and storagesystem can be on different subnets.

Starting the initialization utility UI on a Windows host

To start the UI version of the initialization utility from the server,select Start > Programs > EMC > Navisphere > Navisphere StorageSystem Initialization or Start > All Programs > EMC > Navisphere> Navisphere Storage System Initialization.

Starting the text-based or command line initialization utility on a Windows host

To start the text-based version, at a command prompt enter cdC:\Program Files\EMC\Navisphere Storage System InitializationWizard or cd C:\Program Files (x86)\EMC\Navisphere StorageSystem Initialization Wizard; then enter NaviInitToolCLI.exe.

To start the command line version, at a command prompt enter cdC:\Program Files\EMC\Navisphere Storage System InitializationWizard or cd C:\Program Files (x86)\EMC\Navisphere StorageSystem Initialization Wizard; then enter ./naviinittoolcli and any


of the command line switches in Using the command line initializationutility, page 14.

Starting the initialization utility on a Windows host from the CD

1. Log in to the Windows server as the administrator or someone whohas administrative privileges.

2. In the server’s drive, insert the server support CD, which shippedwith the storage system or the upgrade kit (for AX4-5 series or AXseries systems upgrading to Navisphere Manager). The serversupport menu opens. If you do not see the server support menu,follow these steps to open it:

From the Windows taskbar, select:

Start > Run

In the Run dialog box, enter:

drive:\locales\en_US\start.html

where drive is the letter for the CD drive. Click OK.

3. From the main menu select Run Products from CD. The RUNPRODUCTS page opens.

4. To start the utility, select Navisphere Storage System InitializationUtility.

Using the UI version of the initialization utility

After you start the utility, it automatically scans the subnet forsupported storage systems. When this storage-system discoveryoperation is complete, the utility lists, by hardware serial number,all uninitialized and initialized storage systems it found. Thestorage-system serial number is on a blue label located on the SPEchassis behind the front bezel.The hardware serial number is on a bluelabel on the rear of the chassis.The hardware serial number is on ahanging tag at the rear of the storage system.

If the discovery operation did not find the storage system youare installing, verify that the storage system’s management portsare properly cabled to the LAN on which the server resides. Themanagement ports and the server must both reside on the same subnet.


Proceed through the wizard screens, providing information whererequired. For more information about completing the wizard, clickHelp in the wizard’s menu bar.

For a CX4 and CX3 series storage systemsIf you entered an SP IP address for the first time or changed an SP IPaddress, the utility reboots the storage system, and the SP fault light onthe back of each SP starts blinking. The reboot takes several minutesto complete. When it has completed, the SP fault light (LEDs) on eachSP stops blinking and remains off.

For an AX4-5 series storage systemIf you entered an SP IP address for the first time or changed an SP IPaddress, the utility reboots the storage system, and green lights flash toindicate activity. The reboot takes 5 to 6 minutes to complete. Whenit has completed, the power button on each SP remains solid/steadygreen.

Using the command line initialization utility

After you start the command line version of the initialization utility,use any of the switches below with the naviinittoolcli .

To start the command line version of the initialization utility, at a commandprompt enter cd C:\Program Files\EMC\Navisphere Storage SystemInitialization Wizard or cd C:\Program Files (x86)\EMC\Navisphere StorageSystem Initialization Wizard; then enter ./naviinittoolcli.

eula [-language language]

discover [-all] [-xml]

configure –serial serialnumber [-file filename] [–ipaspAIpaddress|–sphosta spAhostname] [-ipb spBIpaddress|–sphostb spBhostname] [–mask subnetmask] [–gateway gatewayaddress][-user username] [–password password] [–storagename storageName][-ipv6mode |automatic|disable| [manual [-globalprefix prefix[-ipv6gateway ipv6gateway]] [ -help]

where:


eula

Displays the EMC end-user license agreement (EULA) in the specified language.

-language language The default language is English.Currently, the only valid languageis English.

discover

Discovers and displays a list of partially initialized storage systems.

-all Discovers and displays a list ofinitialized and partially initializedstorage systems.

-xml Specifies that the output is in xmlformat.


configure

Specifies the network parameters for the specified storage system.

-serial serialnumber Specifies the serial number ofthe storage system you want toinitialize.

-file filename Specifies the name of the filethat will store all the networkparameters.

-ipa spAipaddress |-sphosta spAhostname Specifies the IP address of SP A,or the server name for SP A for thespecified storage system.

-ipb spBipaddress |-sphostb spBhostname Specifies the IP address of SP B,or the server name for SP B for thespecified storage system.

-mask subnetmask Specifies the subnet mask for thespecified storage system.

-gateway gateway Specifies the gateway for thespecified storage system.

-user username Specifies the storage-system loginusername.

-password password Specifies the storage-system loginpassword.

-storagename storagename Specifies the name for the specifiedstorage system.

-help Displays the help screen and doesnot start the initialization process

-ipv6mode automatic | disable |[manual –globalprefix prefix–ipv6gateway ipv6gateway]

Specifies the configuration type forthe IPv6 network. Refer to the IPv6configuration type table below fordetails. IPv6 is supported with CX4series systems only.


Table 2 IPv6 parameter values based on IPv6 configuration type (CX4 seriessystems only)

Existing configuration type(What you see when you open the

initialization utility)

New configuration type(What you see after changing the configuration type)

Disabled Auto Manual

Link Local: TBD*

Global IP: TBD*

GlobalPrefix:

Blank/editable

Disabled All IPv6 parameteers areblank and grayed out.IPv4 will be used

All IPv6parametersare set toTBD*

Gateway: blank/editable

Link Local: visible**

Global IP: visible**

GlobalPrefix:

visible/editable**

Auto Current IPv6 parameters arevisible but not editable.

All IPv6 parametersare blank andgrayed out *IPv4 will be used

Gateway: visible/editable**

Link Local: visible

Global IP: visible

GlobalPrefix:

visible/ed-itable

Manual

Gateway: visible/ed-itable

All IPv6 parametersare blank andgrayed out * IPv4will be used

Current IPv6Link Localparameter isvisible. Allothers are setto TBD **

* After changing the configuration type from Disabled to Auto or Manual, or from Auto or Manual to Disabled, the new values will be setafter the automatic reboot of the storage system. After the reboot completes, open the initialization utility again to view the new IPv6 values.** After changing the configuration type from Manual to Auto or from Auto to Manual, a reboot is not required.


Determining whether to install the host agent or server utility

Depending on your application needs, you can install the host agent,server utility, or both on an attached server.

If you want to install both applications, you must install version 6.22.20or later of the server utility either before or after you install the hostagent. The registration feature of the server utility will be disabledand the host agent will be used to register the server’s NICs or iSCSIHBAs to the storage system.

Prior to version 6.22.20 of the server utility, you could not install the host agentand server utility on the same server. However, you could install them ondifferent servers that are connected to the same storage system.

If you do not want to install both applications, but want to use someof the features available in the server utility, you can run the serverutility from the server support CD.

The host agent is not supported with AX4-5 series storage systems withNavisphere Express; you can only use the server utility.

Table 3 describes the differences between the host agent and the serverutility on a server attached to a storage system.

Depending on the version of the server utility, some of the features listed inTable 3 may not be available.

Table 3 Differences between the host agent and the server utility

Function Host agent Server utility

Pushes LUN mappingand OS information to thestorage system.

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

AX4–5 series storage systemsYes – LUN mapping information is displayed in theManager UI next to the LUN icon, or with the CLI usingthe -lunmapinfo command. In Navisphere Express thisinformation is displayed in the Manage Virtual Disks page.Note: The text Manually Registered appears next to thehostname icon in the Manager UI indicating that the host agent wasnot used to register this server.


Function Host agent Server utility

CX4 series, CX3 series, and CX series storage systemsNo – LUN mapping information is not sent to the storage system. Onlythe server’s name, ID, and IP address are sent to the storage system.Note: The text Manually Registered appears next to thehostname icon in the Manager UI indicating that the host agent wasnot used to register this server.

Runs automatically tosend information to thestorage system.

Yes – No user interaction isrequired.

AX4–5 series storage systemsNo – You must manually update the information bystarting the utility or you can create a script to run the utility. Sinceyou run the server utility on demand, you have more control as tohow often or when the utility is executed.CX4 series, CX3 series, and CX series storage systemsNo – You must manually update the information by starting the utilityor you can create a script to run the utility. Since you run the serverutility on demand, you have more control as to how often or when theutility is executed.

Provides high-availability(HA) validation.

No – You can run the server utility’sHA validation feature from the CDwithout having to install the serverutility.

AX4–5 series storage systemsCurrently not supported.CX4 series, CX3 series, and CX series storage systemsYes – The HA validation feature verifies that failover software isinstalled on the server and that working paths exist between theserver and each SP in the storage system.

Requires networkconnectivity to the storagesystem.

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

AX4–5 series storage systemsNo – LUN mapping information is sent through adata path to the storage system.CX4 series, CX3 series, and CX series storage systemsNo – LUN mapping information is not sent to the storage system.Note that if you are using the server utility to upload a high availabilityreport to the storage system, you must have network connectivity.

Requires installation. Yes – You must install the hostagent on the server.

AX4–5 series storage systemsNo – You can run the server utility from the CD.However, we recommend that you install it on the server.CX4 series, CX3 series, and CX series storage systemsNo – You can run the server utility from the CD. However, werecommend that you install it on the server.

Note: If you install the host agent and then version 6.22.20 or later of the server utility, the server utility’s registration service feature willnot be installed. Prior to version 6.22.20 of the server utility, you could not install the host agent and server utility on the same server.


Requirements for the host agent, server utility, and CLI

To run the host agent, CLI, or server utility, your server must meetthe following requirements:

Run a supported version of the AIX operating system.

For Fibre Channel connections, have the EMC CLARiiONsupported HBA hardware and driver installed.

Be connected to at least one SP (two SPs for high-availability) ineach storage system either directly or through a switch or hub. EachSP must have an IP connection.

For the host agent and CLI only - Be on a TCP/IP network connectedto at least one SP (two SPs for high-availability) in the storagesystem. The TCP/IP network connection allows the server to sendLUN mapping information to the storage system and it allowsNavisphere Manager or CLI to communicate with the storagesystem over the network.

Have a configured TCP/IP network connection to any remote hoststhat you will use to manage the server’s storage systems, including:

any server whose browser you will use to access Manager 6.X.

any Windows Server 2008, 2003, or Windows 2000 serverrunning Storage Management Server software.

any AIX, HP-UX, Linux, VMware ESX Server, NetWare, Solaris,Windows Server 2003, or Windows 2000 server running the CLI.

If you want to use the CLI on the server to manage storage systems ona remote server, the server must be on a TCP/IP network connectedto both the remote server and each SP in the remote server’s storagesystem. The remote server can be running AIX, HP-UX, Linux, Solaris,or the Windows operating system.

For information about the specific revisions of the server operating systemand the storage-system FLARE and Access Logix software that are requiredfor your version of the host agent, see the release notes for the host agenton the EMC Powerlink website. To access this website, see Finding currentinformation, page 8 .


Installing or removing the Navisphere Host Agent and CLI

You can install both the host agent and CLI, or you can install themseparately.

To modify an existing host agent configuration refer to the next section.

If you want to install the host agent and use some of the features in the serverutility, see Determining whether to install the host agent or server utility , page 18.

Installing the host agent and CLI on an AIX server

To install the Navisphere agent and/or CLI, you must:

Determine whether a previous version of the software you want toinstall (host agent and/or CLI) is currently installed on the hostand, if so, remove it.

Install the Navisphere agent files and/or the CLI files. Beforeinstalling the host agent, make sure that the disk-array storagesystem is connected to the AIX server on which you are installingNavisphere agent.

Determining if an earlier version is installed

1. On the AIX server, log in as superuser (root).

2. Open an xterm window and enter the following command to listcurrently installed Navisphere software:

lslpp -L | grep NAV

3. Examine the list of software to determine if an earlier version ofNavisphere agent or CLI is present. If a previous version is present,remove it before continuing to the next section.

Installing the agent and/or CLI files

EMC recommends that you install the most recent version of theNavisphere Host Agent/CLI software that is appropriate for yourconfiguration. You can download the most recent version from the


software download page on the Powerlink website. You can also installthe software from the server support CD; however, the CD may notcontain the most recent version for your configuration.

Use the following procedure to install the host agent, the CLI, or boththe host agent and CLI:

1. To download the software for CX4 series, CX3 series, CX series, orAX4–5 series storage systems, do the following:


b. Select the appropriate Navisphere Host Agent/CLI version anddownload the zip file to a Windows host.

c. Unzip the zip file you downloaded.

d. Log in to the AIX server as root.

e. Transfer the .lpp file to the /usr/sys/inst.images folder on anAIX server.

2. To install the software from the server support CD, insert the CDinto the host’s CD drive and use the following command to mountthe CD:

mount -v cdrfs -o ro /dev/cd0 /cdrom

3. If the SMIT (System Management Interface Tool) SystemManagement is not already open, enter the following commandto open it:

smit

4. From the SMIT System Management window, follow the path:

Software Installation and Maintenance > Install and UpdateSoftware > Install and Update from ALL Available Software

The Install and Update from ALL Available Software windowopens.

5. In the Install and Update from ALL Available Software window,either select List and then the directory that contains the Navispheresoftware, or enter the directory path in the Input device/directoryfor Software field.



6. Click OK and at the confirmation prompt and click OK again.

7. On the line, SOFTWARE to install, select List .

8. From the list that appears, select the Navisphere software that youwant to install (NAVIAGENT or NAVICLI or both), and click OK.

For AX4–5 storage systems with Navisphere Express, you can only installthe Navisphere CLI; the host agent is not supported.

9. Click OK in the ALL Available Software window.

10. When the confirmation window is displayed, click OK.

The installation process begins and the progress of the installationappears in the Install and Update from ALL Available Softwarewindow. When the installation completes, the same windowindicates that the installation was successful.

You may need to scroll down to the bottom of the output window to viewthe Installation Summary.

11. Using SMIT, verify that the Navisphere Agent and/or CLI softwareare installed.

12. Configure the LUNZ device for AIX using the cfgmgr command.

13. If you have a multihomed host (multiple NIC cards installed onthe host), create an agentID.txt file to ensure that the agent findsthe correct NIC card.

A multihomed host machine has multiple IP addresses connected tonetworks; it is physically connected to multiple data links that can be on thesame or different networks. When you install Navisphere Host Agent on amultihomed host, the host agent, by default, binds to the first NIC in thehost. If your host is multihomed, for the host agent to successfully registerwith the desired CLARiiON storage system, you need to configure the hostagent 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, createor edit a file named agentID.txt (case sensitive) in either / (root)or in a directory of your choice.


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 HBA/NIC port that you

want Navisphere agent to use

For example, if your host is named host28 on the domainmydomain.com and your host contains two HBAs/NICs,HBA1/NIC1 with IP address 192.111.222.2 and HBA2/NIC2with IP address 192.111.222.3, and you want the Navisphereagent 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 anyformatting. The first line should contain the hostname and the secondline should contain the IP address of the HBA/NIC port as describedabove. Both lines should end with a carriage return. As a result, thecursor will be on a third line but this line should not contain any text.

c. Save the agentID.txt file.

d. If you created the agentID.txt file in a directory other thanroot, for host agent to restart after a system reboot using thecorrect path to the agentID.txt file, set the environment variableEV_AGENTID_DIRECTORY to point to the directory whereyou created agentID.txt.

e. If a HostIdFile.txt file is present in the directory shown for youroperating system, delete or rename it. The HostIdFile.txt file islocated in /etc/log/HostIdFile.txt.

f. Stop and then restart the host agent.

g. Once the host agent has restarted, verify that the host agent isusing the IP address that is entered in the agentID.txt file. Todo this, view the new HostIdFile.txt file. You should see the IPaddress that is entered in the agentID.txt file.


What next?

If you installed the host agent and you are setting up a new server, goto Running the Navisphere Host Agent , page 30. If you are just upgradingthe host agent or CLI on an existing system, or if you are just installingthe CLI, you have finished the installation.

Removing the Navisphere Host Agent and/or CLI on an AIX server

To avoid losing site-specific information, copy the Navisphere agentconfiguration file (agent.config) to a safe location before removing anyNavisphere software.


2. At the AIX shell prompt in an xterm window, start SMIT:

smit

The SMIT System Management window opens.

3. From the SMIT System Management window, follow this path:

Software Installation and Maintenance > SoftwareMaintenance and Utilities > Remove Installed SoftwareThe Remove Installed Software window opens.

4. In the Remove Installed Software window, click the List buttonfor Software name.

5. From the list that appears, select the Navisphere software you wantto remove (NAVIAGENT, NAVICLI, or both), and click OK.

6. In the Remove Installed Software window, click the List button forPREVIEW only? (The remove operation will NOT occur).

7. From the list that appears, click no.

8. In the Remove Installed Software window, click the List button forREMOVE dependent software?

9. From the list that appears, click yes.

10. In the Remove Installed Software window, click OK.


11. When the confirmation window is displayed, click OK. The files areremoved. The removal process is complete when you see a successmessage.


Configuring the Navisphere Host Agent

Before you can use the Navisphere CLI navicli register command toconfigure your storage system, you must make sure the host agentconfiguration file includes a privileged user, as described in Addingprivileged users, page 27.

The pathname of the host agent configuration file is /etc/Navisphere/agent.con-fig.

If you are configuring a legacy storage system, refer to revision A08 ofthis guide.

A legacy system is an FC series storage system that is not running storagemanagement server software.

Adding privileged users

If you will use Navisphere CLI to configure any storage system, thehost agent configuration file must include an entry that defines theperson who will issue the CLI commands as a privileged user.

To define a privileged user, add a local or remote privileged user byadding the appropriate entry below.

For a local user:

user name

For a remote user:

user name@hostname

where name is the person’s account name and hostname is the name ofthe remote server the person will be using.

The default host agent configuration file includes a user root entry.

Saving the host agent configuration file

1. Save the host agent configuration file.


2. If you have finished adding information to the host agentconfiguration file, stop and restart the host agent by entering thefollowing commands:

rc.agent stoprc.agent start


Using the Event Monitor configuration file

The Navisphere Host Agent can monitor storage-system events andtake such action as sending email or paging you if specified eventsoccur. The Event Monitor that ships with Navisphere Managerprovides an interactive way to define these events and actions. If youdo not have Event Monitor, you can still define such events and actionsby editing the Event Monitor configuration file.

/etc/Navisphere/Navimon.cfg

The file is self-documenting; that is, text in it describes how to defineevents and the actions you want taken if the events occur. You cantest the file after editing it using the Navisphere CLI commandresponsetest, as explained in the Navisphere Command Line InterfaceReference.


Running the Navisphere Host Agent

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

Starting and stopping the Navisphere Host Agent

The host agent starts automatically when you bring the server up toinit level 2. When you first start the host agent, look at the system logfor the server’s operating system to make sure the agent started andno device errors occurred.

When a storage system experiences heavy input/output traffic (that is,applications are using the storage system), information may not be reportedto the host agent in a timely manner, resulting in the host agent taking severalminutes to execute a storage-system management task. This behavior is mostevident when one host agent is managing multiple storage systems. Also, if theSP event log is large and the host agent configuration file is set up to read allevents, it may take a few minutes for the host agent to start.

Starting the host agent

Log in as root and enter this command:

rc.agent start

Stopping the host agent

Log in as root and enter this command:

rc.agent stop

Testing the host agent connections

Before continuing, you should test the host agent connections asfollows:

1. Start the host agent as described in Starting and stopping theNavisphere Host Agent, page 30.

2. Look for any errors on the console and in the operating system logto make sure the agent started and no device errors occurred.


3. Verify that the host agent on the server can see the storage systemas follows:

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

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

where:

[-d device] is the device name for the storage system (onlysupported with legacy systems).

-h hostname is the IP address of the SP.

For each HBA in the server, a listing similar to the following willbe displayed. For storage systems in a SAN (shared storage)environment, the listing includes HBAs in all connected hosts.Information about each HBA:HBA UID: 10:00:00:60:B0:3E:46:AC:10:00:00:60:B0:3E:46: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, examine the information for each HBA installed inthe host to verify the path from the HBA to the SP.

Host agent status and error logging

While the system is running, the operating system tracks informationabout host agent events and host agent errors, and places thisinformation in log files on the server.


The host agent error log tracks information about the host agent’sstartup, the host agent shutdown, and errors that might occur, such asthe host agent’s inability to access a device in the configuration file. Ifproblems occur, log files are a good place to start your troubleshooting.

Host agent events and errors are logged in /etc/log/agent.log.


Installing and removing the Navisphere Server Utility

This section describes how to install the Navisphere Server Utility.

Installing the Navisphere Server Utility on an AIX server

EMC recommends that you install the most recent version of theNavisphere Server Utility software that is appropriate for yourconfiguration. You can download the most recent version from thesoftware download page on the Powerlink website. You can also installthe software from the server support CD; however, the CD may notcontain the most recent version for your configuration.

Determining if an earlier version is installedTo determine if an earlier version is installed:

1. At the AIX server, log in as superuser (root).

2. Open an xterm window and enter the following command to listcurrently installed Navisphere software:

lslpp -L | grep HOST

3. Examine the list of software to determine if an earlier versionof Navisphere Server Utility is installed. If an earlier version isinstalled, remove it before continuing.

Installing the Navisphere Server UtilityEMC recommends that you install the most recent version of theNavisphere Server Utility software that is appropriate for yourconfiguration. You can download the most recent version from thesoftware download page on the Powerlink website. You can also installthe software from the server support CD; however, the CD may notcontain the most recent version for your configuration.

1. Log in to the AIX server as the administrator or someone who hasadministrative privileges.

2. To download the software from the Powerlink website for yourstorage system, do the following:


b. Select the appropriate Navisphere Server Utility version anddownload the zip file to a Windows host.





d. Transfer the .lpp file to the usr/sys/inst.images folder on an AIXserver.

3. To install the software from the server support CD (any storagesystem), insert the CD into the server’s CD drive and use thefollowing command to mount the CD:

mount -v cdrfs -o ro /dev/cd0 /cdrom

4. Change the current directory to the server or CD directory withthe HOSTUTIL software.

5. If you are not in the SMIT (System Management Interface Tool)System Management window, open this window by entering thefollowing command:

smit



The Install and Update from ALL Available Software windowopens.

7. In the Install and Update from ALL Available Software window,select List and then the directory that contains the HOSTUTILsoftware.

8. Click OK in the ALL Available Software window.

9. When the confirmation window is displayed, click OK. Theinstallation process begins and the progress of the installationappears in the Install and Update from ALL Available Softwarewindow.

The installation is complete when you see an installation summarymessage.

10. If you installed the software from the CD, unmount the CD andthen remove the CD from the server’s CD drive:


unmount /cdrom

Removing the server utility on an AIX server

1. At the root directory, start SMIT by entering:

smit


2. From the SMIT System Management window, follow this path:Software Installation and Maintenance > SoftwareMaintenance and Utilities > Remove Installed SoftwareThe Remove Installed Software window opens.


4. From the list that appears, select HOSTUTIL, and click OK.

5. Click the List button for PREVIEW only? (remove operation

will NOT occur).


7. Click the List button for REMOVE dependent software.


9. Then click OK.

10. When the confirmation window appears, click OK. The files areremoved.


Running the Navisphere Server Utility

This section describes how to start and use the server utility. You canrun the server utility from the server or from the server support CD.

Starting the Navisphere Server Utility on an AIX server

1. Open a shell window.

2. Navigate to the HOSTUTIL directory and run the server utility:

/usr/lpp/HOSTUTIL/naviserverutil

Starting the Navisphere Server Utility on an AIX server from the CD

1. In the server’s drive, insert the server support CD that shippedwith your storage system.

2. At the AIX shell prompt, create a CD directory:

mkdir /cdrom

3. Mount the CD drive:

mount -v cdrfs -p -r /dev/cd0 /cdrom

4. Navigate to the following AIX directory:

cd /cdrom/aix/usr/sys/inst.images

5. Run the server utility:

./naviserverutil

Using the Navisphere Server Utility

The Navisphere Server Utility allows you to perform the followingfunctions:

Update server information on the storage system

Generate a high-availablity report (not available on servers withiSCSI connections)


Updating server information on the storage system

The Update Server Information option allows you to send informationabout the server to all connected storage systems. To update serverinformation, select option 1 from the server utility’s Welcome screen,and follow the instructions on the utility.

Generating a high-availability report

The Generate high availability report option (option 3) and thenaviserverutilcli hav command determine if the server is configuredfor high availability by verifying that the server has at least oneconnection path to each storage-system SP, and that PowerPath or someother failover software, such as DMP is running.

After the verification, the utility generates a summary report andsaves it to the server. If you issue the -upload switch with thenaviserverutilcli hav command, the utility also sends the report to thespecified storage system.

Generate a high-availability report to:

check the status of a server.

prepare for a software installation on a storage system.

For AX4 systems only — Use the -upload switch to upload the HA reportto the storage system only if you will use the Navisphere Software Assistantto install new software. We strongly recommend that you use the SoftwareAssistant, and not the -ndu install command to update your software. The-ndu install command does not perform the same pre-install validation checksas the Software Assistant. The Software Assistant is included in the NavisphereService Taskbar.

Checking the status of a serverTo periodically check the high-availability status of a server, you canselect option 3 from the server utility’s Welcome screen, and follow theinstructions on the utility to generate a high-availability report, or issuethe naviserverutilcli hav[-directory | -d outputdirectory] command.

where:


-directory | -doutputdirectory

Specifies the directory to which you want to deposit the report onthe server. This switch is required only if you are running the serverutility from the CD. Otherwise the report is automatically saved to theNavisphere Server Utility installation directory.If the server utility is installed on your server and you specify a directory,the directory you specify will override the server utility’s installationdirectory.

Preparing for a software installation on a storage systemIf you are generating a high-availability report as a prerequisite toupdating storage-system software, you need to upload this report to thestorage system prior to installing the software on the storage system.To generate and upload an HA report, issue the following commandfrom the directory in which you installed the utility:

naviserverutilcli hav -upload -ip IPaddress |-hIPaddress|network_name -user|-u username -password|-puserpassword -scope|-s scopelevel -secfilepath securityfilepath-port 443|2163 [-directory | -d outputdirectory]

where:


-ip IPaddress Specifies the IP address of an SP on the storage system to which youwill upload the report. You cannot use this switch in conjunction withthe -h switch.

-h IPaddress |network_name

Specifies the IP address or the network name of an SP on the storagesystem to which you will upload the report. You cannot use this switchin conjunction with the -ip switch.

-user | -uusername

Specifies the login name for the storage system. You must use this switchin conjunction with the -password | -p and -scope | -s switches. Youcannot use this switch in conjunction with the -secfilepath switch.

-password | -puserpassword

Specifies the password required for access to the storage system. Youmust use this switch in conjunction with the -user | -u and -scope | -sswitches. You cannot use this switch in conjunction with the -secfilepathswitch.

-scope | -sscopelevel

Specifies the level of access this username and password has to thestorage system: 0 = global; 1 = local; 2 = LDAP. You must use this switchin conjunction with the -user | -u and -password | -p switches. Youcannot use this switch in conjunction with the -secfilepath switch.

-secfilepathsecurityfilepath

Searches the security file for the specified IP address. If the utility doesnot find the specified IP address, then the utility will use the default entryin the security file.A security file is required to run this switch. For information on how tocreate a security file, refer to the EMC Navisphere Command Line (CLI)Reference guide.You cannot use this switch in conjunction with the -user | -u, -password |-p , and -scope | -s switches.

-port 443 | 2163 Specifies the Navisphere Management Server port number. The defaultis 443.

-directory | -doutputdirectory

Specifies the directory to which you want to deposit the report onthe server. This switch is required only if you are running the serverutility from the CD. Otherwise the report is automatically saved to theNavisphere Server Utility installation directory.If the server utility is installed on your server and you specify a directory,the directory you specify will override the server utility’s installationdirectory.

After uploading the HA reportIn addition to running the server utility to validate server highavailability, we strongly recommend that you perform the followingmanual checks.


Verify support of software and hardware — Make sure thatyou have verified that all software and hardware is supportedaccording to the EMC E-Lab™ Interoperability Navigator andsupport matrices.

This tool does not verify that you are running supported switch firmware,nor that you are using redundant switches (recommended).

Upgrading storage–system software — If you are about to performa storage-system online software upgrade or you added an HBA, aLUN, or changed connectivity (added a path or changed zoning):

Make sure that you have validated all software and hardwarethat are supported and interoperable according to EMC E-LabInteroperability Navigator and support matrices.

Verify that all LUNs (virtual disks) that your servers will accessduring the upgrade are under path management softwarecontrol. For servers running PowerPath and DMP, see theFailover Software section on the Details tab of the report andlocate these LUNs. If they are not in the list, the server will loseaccess to those LUNs during the software upgrade.


Installing and removing the Admsnap Utility

EMC strongly recommends that you install admsnap on all serversconnected to a storage system that has the SnapView driver installed.

Important: If you are upgrading your storage system to FLARE OEversion 02.19.xxx.5.yyy or later, you must upgrade admsnap to version2.9.x or later. Before you upgrade FLARE, verify that your operatingsystem version supports admsnap version 2.9.x or later. Refer to theAdmsnap Release Notes.

Installation prerequisites

Before you can install and use the Admsnap Utility, you must:

Install SnapView on a supported CLARiiON storage system. Fora list of supported storage systems, refer to the release notes forSnapView and admsnap.

Enable data access control on the same CLARiiON storage system.

Installing the Admsnap Utility on an AIX server

EMC recommends that you install the most recent version of theAdmsnap Utility software that is appropriate for your configuration.You can download the most recent version from the software downloadpage on the Powerlink website. You can also install the software fromthe server support CD; however, the CD may not contain the mostrecent version for your configuration.


2. Open an xterm window and enter the following command to listcurrently installed admsnap software:

lslpp - L admsnap

3. Examine the list to determine if any previous revision of admsnapis present. If a previous revision is present, remove it as describedin Removing the Admsnap Utility on an AIX server, page 43.

4. To download the software for CX4 series, CX3 series, CX series, orAX4–5 series storage systems with Navisphere Manager, do thefollowing:



b. Select the appropriate Admsnap Utility version and downloadthe zip file to a Windows host.


d. Transfer the .lpp file to the usr/sys/inst.images folder on an AIXserver.

5. To install the software from the server support CD, do the following:

a. Insert the server support CD into the server’s CD drive.

b. Enter the following command at the AIX shell prompt:

crfs -v cdrfs -p ro -d cd0 -m /cd_tmp

c. Type the following commands to mount the CD, go to theCD directory, copy the admsnap files to the correct hard diskdirectory, and recreate the table of contents:

mount /cd_tmpcd cd_tmp/AIX/admsnap/AIX5.xcp * /usr/sys/inst.imagescd /usr/sys/inst.imagesrm .tocinutoc

6. If you are not in the SMIT (System Management Interface Tool)System Management window, open this window by entering smit



The Install and Update from LATEST Available Software windowopens.

8. In this window, click List.

9. From the displayed list select the usr/sys/inst.images directory.

10. In the Install and Update from ALL Available Software window,click OK.

11. Click the List button for SOFTWARE to Install.



12. From the list that appears, select the software that you want toinstall (admsnap) and click OK.

13. Click OK in the LATEST Available Software window.

14. When the confirmation window appears, click OK.

The installation process begins and the progress of theinstallation appears in the Install and Update fromALL Available Software window. The installation iscomplete when you see a message similar to the following:

Name Level Part Event Resultadmsnap XXXXX USR INSTALL Success

The software is installed in the directory /usr/admsnap.

Your installation is complete.

Removing the Admsnap Utility on an AIX server

1. At the root directory, start SMIT by entering:

smit



Software Installation and Maintenance > Software Maintenanceand Utilities > Remove Installed Software

The Remove Installed Software window opens.


4. From the list that appears, select ADMSNAP, and click OK.

5. Click the List button for PREVIEW only? (remove operation willNOT occur).


7. Next, click the List button for REMOVE dependent software.



9. Then click OK.

10. When the confirmation window appears, click OK.

The files are removed. The removal process is complete when yousee a message similar to the following displayed in the bottom ofthe window:

Name Level Part Event Resultadmsnap XXXXX USR DEINSTALL Success


Running the Admsnap Utility

Refer to the EMC SnapView Command Line Interfaces Reference forinformation on running admsnap commands.


Copyright© 2004–2008 EMC Corporation. All Rights Reserved.

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 OR WARRANTIES OF ANY KIND WITH 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 mentioned herein are the property of their respective owners.


clariion server support products for aix servers ... · pdf fileemc clariion server support...

Documents