EMC CLARiiON Server Support Products for AIX Server Installation Guide

Transcription

1 EMC CLARiiON Server Support Products for AIX Server Installation Guide P/N , Revision A08 January 16, 2007 This guide describes how to install and remove the Navisphere Host Agent, Navisphere Server Utility, Navisphere Command Line Interface (CLI), or admsnapsoftwareonanibmserverwiththeaixoperatingsystem. Note: This document uses the term CX3-series to refer to CX3 model 10 systems, CX3 model 20 systems, CX3 model 40 systems, and CX3 model 80 systems, and the term CX-series to refer to CX200, CX300-series, CX400, CX500-series, CX600, and CX700 storage systems. Topics include: About EMC Navisphere Software... 2 Finding current information... 5 Determining whether to install the host agent or server utility... 6 Requirements for the host agent, server utility, and CLI... 8 Installing or removing the Navisphere Host Agent and CLI... 9 Configuring the Navisphere Host Agent Using the Event Monitor configuration file Running the Navisphere Host Agent Installing and removing the Navisphere Server Utility Running the Navisphere Server Utility Installing and removing the Admsnap Utility Running the Admsnap Utility

2 About EMC Navisphere Software The following EMC server-based software is available on the server support CD that shipped with your storage system : Navisphere Host Agent Navisphere Server Utility Admsnap Utility Navisphere Command Line Interface (CLI) About the Navisphere Host Agent The host agent registers the server s HBA (host bus adapter) with the attached storage system when the host agent service starts. This action sends the initiator records for each HBA to the storage system. Initiator records are used to control access to storage-system data. For legacy storage systems, the host agent will send the initiator records only if Access Logix software is installed. Theagentcanthenretrieveinformationfromthestoragesystem automatically at startup or when requested by Manager or CLI. Thehostagentcanalso: Send drive mapping information to the attached CLARiiON storage systems. Monitor storage-system events and can notify personnel by , page, or modem when any designated event occurs. Retrieve LUN WWN (world wide name) and capacity information from Symmetrix storage systems. The host agent runs on servers attached to CX3 series and CX series. About the Navisphere Server Utility The server utility allows you to perform the following three functions: Update server information to the storage system Thisoption sends the server name and IP address to the storage system and, if needed later on, allows you to update or view this data. For 2 EMC CLARiiON Server Support Products for AIX Server Installation Guide

3 Windows servers running Navisphere Server Utility version 6.20 or higher, if the Registration Service feature remains enabled after the installation of the server utility, the utility will automatically register theserver snicsorhbaswiththestoragesystemandupdate server information whenever there is a configuration change (for example, when you mount new volumes or create new partitions). Verify server high availability (HA) Allows you to determine if the server is configured for high availability (HA) by verifying that theserverhasatleastoneconnectionpathtoeachstoragesystem SP, and that PowerPath or some other failover software, such as DMP or PV Links, is running. The utility will not detect any other native failover software, such as Sun StorEdge Traffic Manager or Linux native multipath (MPIO). This feature is currently supported only on CX3 series and CX-series storage systems. You can run the Navisphere Server Utility from the CD or you can install it on the servers that are connected to the storage system. We strongly recommend that you install the utility on each server that is connected to the storage system. Note: The server utility runs on servers attached to CX3-series, CX-series, and AX-series storage systems. CX3 model 10 systems must be running FLARE OE xxx or later. CX3 model 20 systems, CX3 model 40 systems, and CX3 model 80 systems must be running FLARE OE xxx.5.yyy or later. CX200, CX300-series, CX400, CX500-series, CX600, and CX700 systems must be running FLARE xxx.5.yyy or later. About the Admsnap Utility TheAdmsnapUtilityisanexecutableprogramthatyoucanrun interactively or by a script to manage SnapView clones and snapshots. The Admsnap Utility resides on the servers connected to the storage system with the SnapView driver installed. Use admsnap commands to: Scan for new storage devices EMC CLARiiON Server Support Products for AIX Server Installation Guide 3

4 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 Note: The Admsnap Utility runs on servers attached to CX3-series and CX-series. If you upgraded to Navisphere Manager and want to manage snapshots, you must use the SnapView software and the Admsnap Utility. For more information on SnapView and admsnap, refer to the Navisphere Manager help and the EMC SnapView Command Line Interfaces Reference. About the Navisphere CLI The CLI complements or can be used as an alternative to Manager. It provides a command line interface for storage-system management, including storage provisioning, status and configuration information retrieval, and control. You can use the CLI to automate management functions through shell scripts and batch files. CLI commands for many functions are server-based and are provided with the host agent. The remaining CLI commands are web-based and are provided with software that runs in the storage-system SPs. Navisphere CLI includes the Secure (on supported operating systems), Classic, and Java CLI functionalities. For more information, refer to the EMC Navisphere Command Line Interface (CLI) Reference Guide. Note: The Navisphere CLI can run on servers or remote management stations that are attached to CX3-series and CX-series. 4 EMC CLARiiON Server Support Products for AIX Server Installation Guide

5 Finding current information The most up-to-date information about the CLARiiON server software is posted on the EMC Powerlink website. We recommend that you download the latest information before you install any server software. To access EMC Powerlink, use the following link: After you log in, select Support > Documentation/White Paper Library and find the following: Navisphere Host Agent/CLI and Utilities Release Notes EMC SnapView Command Line Interfaces Reference (P/N ) The latest version of this guide that is applicable to your software revision. For information on FC4700 storage systems, refer to revision A04 of this guide. EMC Installation Roadmap for CX3 Series, CX-Series, AX-Series, and FC-Series Storage Systems (P/N ), which provides a checklist of the tasks that you must complete to install your storage system in a storage area network (SAN) or direct attach configuration. For the most current management and security content for CX3 series, and CX-series storage systems, refer to the EMC Navisphere Manager help, which is available in the Navisphere Manager UI and in the Documentation/White Paper Library section of the Powerlink website. For FC-series and C-series management and security content, refer to the most recent versions of EMC Navisphere Manager Administrator s Guide (P/N ) and EMC Navisphere Security Domains, Multi-Domains, and User Accounts (P/N ). For CX3 series, and CX-series storage systems, refer to the latest version of the EMC Navisphere Command Line Interface (CLI) Reference (P/N ). For FC-series and C-series storage systems, refer to the most recent version of the EMC Navsphere Command Line Interface (CLI) Reference (P/N ). EMC CLARiiON Server Support Products for AIX Server Installation Guide 5

6 Determining whether to install the host agent or server utility Depending on your application needs, you can install the host agent, server utility, or bothonanattachedserver. If you want to install both applications, you must install revision or later of the server utility either before or after you install the host agent. The registration feature of the server utility will be disabled and the host agent will be used to register the server s NICs or HBAs to the storage system. Note: Prior to revision of the server utility, you could not install the host agent and server utility on the same server. However, you could install them on different servers that are connected to the same storage system. If you do not want to install both applications, but want to use some of the features available in the server utility, you can run the server utility from the server support CD. Table 1 describes the differences between the host agent and the server utility on a server attached to a storage system. Important: Depending on the revision of the server utility, some of the features listed in Table 1 may not be available. Table 1 Differences between the host agent and the server utility Function Host agent Server utility Pushes LUN mapping and OS information to the storage system. Runs automatically to send information to the storage system. Yes LUN mapping information is displayed in the Manager UI next to the LUN icon or with the CLI using the -lunmapinfo command. Yes Nouserinteractionis required. CX3-series and CX-series storage systems No LUN mapping information is not sent to the storage system. Only the host s name, ID, and IP address are sent to the storage system. Note: ThetextManually Registered appears next to the hostname icon in the Manager UI indicating that the host agent was not used to register this server. CX3-series and CX-series storage systems 6 EMC CLARiiON Server Support Products for AIX Server Installation Guide

7 Function Host agent Server utility Provides high-availability (HA) validation Requires network connectivity to the storage system. Requires installation. No Youcanruntheserver utility s HA validation feature from the CD without having to install the server utility. Yes Network connectivity allows LUN mapping information to be available to the storage system. Yes You must install the host agent on the server. CX3-series and CX-series storage systems Yes TheHAvalidation feature verifies that failover software is installed on the server and that working paths exist between the server and each SP in the storage system. CX3-series and CX-series storage systems No LUN mapping information is not sent to the storage system. Note that if you are using the server utility to upload a high availability report to the storage system, you must have network connectivity. CX3-series and CX-series storage systems No You can run the server utility from the CD. However, we recommend that you install it on the server. You must install the utility to use the registration service feature (described above). Note: If you install both the host agent and revision or later of the server utility (the order of which does not matter), the server utility s registration service feature will not be installed. Prior to revision of the server utility, you could not install the host agent and server utility on the same server. EMC CLARiiON Server Support Products for AIX Server Installation Guide 7

8 Requirements for the host agent, server utility, and CLI To run the host agent,cli,orserverutility,yourservermustmeet the following requirements: Run a supported version of the AIX operating system. Have the EMC CLARiiON supported HBA hardware and driver installed. Be connected to each SP in each storage system either directly or through a switch or hub. Each SP must have an IP connection. For the host agent andclionly-be on a TCP/IP network connected to each SP in the storage system. The TCP/IP network connection allows the server to send LUN mapping information to the storage system and it allows Navisphere Manager or CLI to communicate with the storage system over the network. Have a configured TCP/IP network connection to any remote hosts that you will use to manage the server s storage systems, including: any host whose browser you will use to access Manager 6.X. any Windows Server 2003, or Windows 2000 host running Storage Management Server software. any AIX, HP-UX, IRIX, Linux, NetWare, Solaris, Windows Server 2003, or Windows 2000 host running the CLI. If you want to use the CLI on the server to manage storage systems on aremoteserver,theservermustbeonatcp/ipnetworkconnected toboththeremoteserverandeachspintheremoteserver sstorage system. The remote server can be running AIX, HP-UX, Linux, Solaris, or the Windows operating system. Note: For information about the specific revisions of the server operating system and the storage-system FLARE and Access Logix software that are required for your revision of the host agent, see the release notes for the host agent on the EMC Powerlink website. To access this website, see Finding current information, page 5. 8 EMC CLARiiON Server Support Products for AIX Server Installation Guide

9 Installing or removing the Navisphere Host Agent and CLI You can install both the host agent and CLI package or just the CLI package. If you will install both, install the host agent first. To modify an existing host agent configuration refer to the next section. Note: If you want to install the host agent and use some of the features in the server utility, see Determining whether to install the host agent or server utility, page 6. Installing the host agent and CLI on an RS/6000 system To install the Navisphere agent and/or CLI, you must: Determine whether a previous version of the software you want to install (host agent and/or CLI) is currently installed on the host and, if so, remove it. Install the Navisphere agent files and/or the CLI files. Before installing the host agent, make sure that the disk-array storage system is connected to the AIX server on which you are installing Navisphere agent. Determining if a previous revision is installed Installing the agent and/or CLI files 1. On the AIX host, log in as superuser (root). 2. Open an xterm window and enter the following command to list currently installed Navisphere software: lslpp-l grepnav 3. Examine the list of software to determine if any previous revision of Navisphere agent or CLI is present. If a previous revision is present, remove it before continuing to the next section. EMC recommends that you install the most recent version of the Navisphere Host Agent/CLI software that is appropriate for your configuration. You can download the most recent version from the software download page on the Powerlink website (CX3 series and EMC CLARiiON Server Support Products for AIX Server Installation Guide 9

10 CX-series). You can also install the software from the server support CD (any storage system); however, the CD may not contain the most recent version for your configuration. Use the following procedure to install the host agent, the CLI, or both the host agent and CLI using the server support CD. 1. Log in to the AIX server as the administrator or someone who has administrative privileges. 2. To download the software for CX3 series or CX-series storage systems, do the following: a. On the Powerlink website, select Support > Downloads and Patches and navigate to the CLARiiON Navisphere Host Agent/CLI download section for AIX. b. Select the appropriate Navisphere Host Agent/CLI version and download the zip file to a Windows server. c. Transfer the.lpp file to the usr/sys/inst.images folder on an AIX server. 3. To install the software from the server support CD (any storage system), insert the CD into the host s CD drive and use the following command to mount the CD: mount -v cdrfs -o ro /dev/cd0 /cdrom 4. If the SMIT (System Management Interface Tool) System Management is not already open, enter the following command to open it: smit 5. From the SMIT System Management window, follow the path: Software Installation and Maintenance > Install and Update Software > Install and Update from ALL Available Software The Install and Update from ALL Available Software window opens. 6. In the Install and Update from ALL Available Software window, either select List and then the directory that contains the Navisphere software, or enter the directory path in the Input device/directory for Software field. 7. Click OK and at the confirmation prompt and click OK again. 10 EMC CLARiiON Server Support Products for AIX Server Installation Guide

11 8. On the line, SOFTWARE to install, selectlist. 9. Fromthelistthatappears,selecttheNavispheresoftwarethatyou want to install (NAVIAGENT or NAVICLI or both), and click OK. 10. Click OK in the ALL Available Software window. 11. When the confirmation window is displayed, click OK. The installation process begins and the progress of the installation appears in the Install and Update from ALL Available Software window. When the installation completes, the same window indicates that the installation was successful. Note: You may need to scroll down to the bottom of the output window to view the Installation Summary. 12. Using SMIT, verify that the Navisphere Agent and/or CLI software are installed. 13.ConfiguretheLUNZdeviceforAIXusingthecfgmgr command. 14. 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. Note: 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 Navisphere 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 CLARiiON storage system, you need to configure the host agenttobindtoaspecificnic.youdothisbysettingupanagentid.txt file. a. Using a text editor that does not add special formatting, create or edit a file named agentid.txt(casesensitive)ineither/(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 EMC CLARiiON Server Support Products for AIX Server Installation Guide 11

12 Forexample,ifyourhostisnamedhost28 on the domain mydomain.com and your host contains two HBAs/NICs, HBA1/NIC1 with IP address and HBA2/NIC2 with IP address , and you want the Navisphere agent to use NIC 2, you would configure agentid.txt as follows: host28.mydomain.com 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 HBA/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. If you created the agentid.txt file in a directory other than root, for host agent to restart after a system reboot using the correct path to the agentid.txt file, set the environment variable EV_AGENTID_DIRECTORY to point to the directory where you created agentid.txt. e. If a HostIdFile.txt file is present in the directory shown for your operating system, delete or rename it. The HostIdFile.txt file is located in /etc/log/hostidfile.txt. f. Stop and then restart the host agent. g. Once the host agent has restarted, verify that host agent is using the IP address that is entered in the agentid.txt file. To do this, view the new HostIdFile.txt file. You should see the IP address that is entered in the agentid.txt file. What next? For legacy storage systems Go to the next section, go to Configuring thenavispherehostagent,page19. For CX3-series or CX-series storage systems Ifyouaresettingup a new server, go to Running the Navisphere Host Agent, page 33. If you 12 EMC CLARiiON Server Support Products for AIX Server Installation Guide

13 arejustupgradingthehostagentorclionanexistingsystem,youare finished with the upgrad Installing the host agent and CLI on an RS/6000SPsystem Installing the agent and/or CLI files The following sections describe the procedures for installing the host agent and CLI on an SP system. These procedures install the software from the control workstation on all nodes simultaneously. Use the following procedure to install the host agent, the CLI, or both the host agent and CLI. If you will install both, install the host agent first. Hardware and software requirements To run the host agent and/or CLI, the following software must be running on the control workstation and SP nodes: RS/6000 SP Parallel System Support Programs. HACMP for AIX (optionally if HACMP support software is to be installed). Determining if a previous revision is installed 1. At the control workstation, log in as superuser (root). 2. Open an xterm window and enter the following command to list currently installed Navisphere software: dsh lslpp -L grep NAV 3. Examine the list of software to determine if a previous version of the software you want to install (host agent and/or CLI) is currently installed on the host and, if so, remove it. EMC recommends that you install the most recent version of the Navisphere Host Agent/CLI software that is appropriate for your configuration. You can download the most recent version from the software download page on the Powerlink website (CX3 series and CX-series). You can also install the software from the server support CD (any storage system); however, the CD may not contain the most recent version for your configuration. Follow the steps below to install the Navisphere agent/cli software using the server support CD. This procedure installs the software on all SP nodes at once from the control workstation. EMC CLARiiON Server Support Products for AIX Server Installation Guide 13

14 ! CAUTION When performing this procedure, it is important to be in the control workstation window, and not a node or other window. Creating a directory for the Navisphere agent/cli software 1. Verify that you are logged in as superuser (root). 2. On the control workstation, change directories to: /spdata/sys1/install/pssplpp/pssp Create the subdirectory Navisphere, usingthefollowing command: mkdir Navisphere Copying the Navisphere agent/cli software to the new lpp source directory Use the following procedure to copy the agent/cli software (using SMIT) to the new lpp source directory: 1. To download the software for CX3 series or CX-series storage systems, do the following: a. On the Powerlink website, select Support > Downloads and Patches and navigate to the navigate to the CLARiiON Navisphere Host Agent/CLI download section for AIX b. Select the appropriate Navisphere Host Agent/CLI version and download the zip file to a Windows server. c. Transfer the.lpp file to the usr/sys/inst.images folder on an AIX server. 2. To install the software from the server support CD (any storage system), do the following: a. Insert the CD into the control workstation s CD-ROM drive. b. Enter this command at the AIX shell prompt: smit bffcreate c. SMIT displays the Copy Software to Hard Disk for Future Installation screen and prompts for an input device. d. On the screen that appears, select the source directory (either the CD-ROM device or directory) by clicking List at the Input device field. 14 EMC CLARiiON Server Support Products for AIX Server Installation Guide

15 e. From the list that appears, select the input device or drive. For example, for the CD-ROM, select /dev/cd0 (SCSI Multimedia CD-ROM Drive). f. At the SOFTWARE package to copy field, click all. g. At the DIRECTORY for storing software package field, enter /spdata/sys1/install/pssplpp/pssp-3.1.1/navisphere h. At the DIRECTORY for temporary storage during copying field, select /tmp. i. At the EXTEND file systems if space needed? field, select yes. j. At the Process multiple volumes? field, select yes. Installing Navisphere agent/cli software Note: Using SMIT requires you to install the Navisphere agent/cli software on each SP node individually and is not recommended for installation. 1. Using NFS, mount the image directory from specified SP nodes: dsh mount cwsname:/spdata/sys1/install/pssplpp/pssp-3.1.1/mnt 2. Run the installp command on all nodes from the Navisphere directory: dsh installp -agxd /mnt/navisphere NAVIAGENT NAVICLI 3. Configure the LUNZ device for AIX using the cfgmgr command. 4. 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. Note: Amultihomed 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 Navisphere 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 CLARiiON storage system, you need to configure the host agent to bindtoaspecificnic.youdothisbysettingupanagentid.txt file. EMC CLARiiON Server Support Products for AIX Server Installation Guide 15

16 a. Using a text editor that does not add special formatting, create or edit a file named agentid.txt(casesensitive)ineither/(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 Forexample,ifyourhostisnamedhost28 on the domain mydomain.com and your host contains two HBAs/NICs, HBA1/NIC1 with IP address and HBA2/NIC2 with IP address , and you want the Navisphere agent to use NIC 2, you would configure agentid.txt as follows: host28.mydomain.com 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 HBA/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. If you created the agentid.txt file in a directory other than root, for host agent to restart after a system reboot using the correct path to the agentid.txt file, set the environment variable EV_AGENTID_DIRECTORY to point to the directory where you created agentid.txt. e. If a HostIdFile.txt file is present in the directory shown for your operating system, delete or rename it. The HostIdFile.txt file is located in /etc/log/hostidfile.txt. f. Stop and then restart the host agent. g. Once the host agent has restarted, verify that host agent is using the IP address that is entered in the agentid.txt file. To do this, view the new HostIdFile.txt file. You should see the IP address that is entered in the agentid.txt file. 5. Using SMIT, verify that the Navisphere Agent and/or CLI software are installed. 16 EMC CLARiiON Server Support Products for AIX Server Installation Guide

17 What next? Before you can use the host agent, you must edit the host agent configuration file. Removing the Navisphere agent and/or CLI on an RS/6000 system Note: To avoid losing site-specific information, copy the Navisphere agent configuration file (agent.config) to a safe location before removing any Navisphere software. 1. On the AIX host, log in as superuser (root). 2. AttheAIXshellpromptinanxtermwindow,startSMIT: smit The SMIT System Management window opens. 3. From the SMIT System Management window, follow this path: Software Installation and Maintenance > Software Maintenance and Utilities > Remove Installed Software The Remove Installed Software window opens. 4. In the Remove Installed Software window, click the List button for Software name. 5. Fromthelistthatappears,selecttheNavispheresoftwareyouwant to remove (NAVIAGENT, NAVICLI, or both), and click OK. 6. In the Remove Installed Software window, click the List button for PREVIEW only? (The remove operation will NOT occur). 7. Fromthelistthatappears,clickno. 8. In the Remove Installed Software window, click the List button for REMOVE dependent software? 9. Fromthelistthatappears,clickyes. 10. In the Remove Installed Software window, click OK. EMC CLARiiON Server Support Products for AIX Server Installation Guide 17

18 11. When the confirmation window is displayed, click OK.Thefilesare removed. The removal process is complete when you see a success message. Removing the Navisphere agent and/or CLI on an RS/6000 SP system Note: To avoid losing site-specific information, copy the Navisphere agent configuration file (agent.config) to a safe location before removing any Navisphere software. Uninstall existing agent and CLI software on specified nodes: dshinstallp-unaviagentnavicli 18 EMC CLARiiON Server Support Products for AIX Server Installation Guide

19 Configuring the Navisphere Host Agent Configuring CX3 series or CX-series storage systems Before you can use the Navisphere CLI navicli register command to configure a CX3 series or CX-series storage system connected to a host agent, you must make sure the host agent configuration file includes a privileged user, as described in Adding privileged users, page 22. Note: The pathname of the host agent configuration file is /etc/navisphere/agent.config. Configuring legacy storage systems Before you can use Navisphere Manager or Navisphere CLI to configure legacy storage systems connected to a host agent, you must make sure the host agent configuration includes the information listed below. Note: A legacy system is an FC-series or C-series storage system that is not running storage management server software. Table 2 Information to add to the host agent configuration file for legacy storage systems Information to add to the host agent configuration file (legacy storage systems only) Manager Required for CLI Communication path for the host agent to the storage system Yes Yes IP addresses of the portal system Yes No Privileged user No Yes What next? Go to the appropriate selection below for the information you need to add to the host agent configuration file. Specifying a communication channel for legacy storage systems, page20 Adding IP addresses for a portal system, page20 EMC CLARiiON Server Support Products for AIX Server Installation Guide 19

20 Adding privileged users, page22 Specifying a communication channel for legacy storage systems Note: Do not add a communication channel for an SP in a CX3 series or CX-series storage system. Doing so will cause Navisphere Manager to display an unnecessary unmanaged storage-system icon for the SP. What next? Each SP in a storage system is connected to the server by a Fibre Channel arbitrated loop (FC-AL) or fabric connection to a Fibre Channel adapter, sometimes called a host bus adapter (HBA). The path from the adapter through the SP to one LUN in the storage system is a communication channel to the storage system for the host agent. The device entries in the agent configuration file define the communication channels. The fibre controllers use SCSI mapping. To use automatic device scanning, which updates device entries each timethehostagentstarts,makesurethehostagentconfigurationfile has a device entry with the following format: device auto auto This entry eliminates the need to enter specific devices in the configuration file and it is an entry in the default host agent configuration file. To add IP addresses for a portal system Continue to the next section, Adding IP addresses for a portal system, page 20. To add a privileged user GotoAdding privileged users, page22. Adding IP addresses for a portal system Note: You must also use a portal system to centrally monitor storage system events. For detailed instructions, refer to the Navisphere Manager online help. If you will use Navisphere Manager 6.X to configure the host agent and manage legacy storage systems, you will use a portal system. A portal system is a CX3-series or CX-series storage system (storage-system 20 EMC CLARiiON Server Support Products for AIX Server Installation Guide

21 portal), or a Windows Server 2003, or Windows 2000 server (server portal) running Storage Management Server software. When Navisphere 6.X requests information from a host agent, the request gets routed through the storage management server on the storage-system portal or the server portal to the host agent. For this reason, when using servers to monitor or perform management operations, you must enter the IP address for both SPs of the storage-system portal and the IP address for the server portal to the privileged user s list in the host agent configuration file. If you know the IP addresses for the portal system, you can add them to the host agent configuration file now. Note: When using Navisphere Manager 6.X, failure to enter the correct IP addresses, results in a Caller not priveleged error when attempting an operation to those host agents. To enter an IP address into the host agent configuration file, you can either edit the host agent configuration file manually or use Navisphere CLI. Using a text editor to edit the host agent configuration file To enter an IP address into the host agent configuration file, do one of the following: If you are using a storage-system portal, add the IP address for each SP in the portal to the /etc/navisphere/agent.config file using the following format: user system@ipaddress where IPaddress istheipaddressforanspintheportalstorage system For example, once you have configured a CX3-series or CX-series storage system as the storage-system portal, you must add the IP address for each SP in the portal to the host agent configuration file as follows: user system@ user system@ If you are using a server portal, add the IP address for the server to the /etc/navisphere/agent.config file using the following format: EMC CLARiiON Server Support Products for AIX Server Installation Guide 21

22 Using CLI to edit the host agent configuration file What next? user where IPaddress is the IP address for the server portal. For example, once you have configured a Windows Server 2003, or Windows 2000 server as the server portal, you must add the IP address for the server to the host agent configuration file as follows: user system@ Add the IP address for each SP in the storage-system portal, or the IP address for the server portal to the host agent configuration file using the following CLI command: navicli remoteconfig -setconfig -adduser system@ipaddress where IPaddress is the IP address for each SP in the storage-system portal, or the IP address for the server portal. For example, for a storage-system portal, you might enter the following IP addresses: navicli remoteconfig -setconfig -adduser system@ navicli remoteconfig -setconfig -adduser system@ For a server portal, you might enter the following IP address: navicli remoteconfig -setconfig -adduser system@ To add a privileged user, continue to the section, Adding privileged users, page 22. If you are done editing the host agent configuration file, go to Saving the host agent configuration file, page23. Adding privileged users If you will use Navisphere CLI to configure any storage system, the host agent configuration file must include an entry that defines the person who will issue the CLI commands as a privileged user. Todefineaprivilegeduser,addalocalorremoteprivilegeduserby adding the appropriate entry below. For a local user: user name 22 EMC CLARiiON Server Support Products for AIX Server Installation Guide

23 For a remote user: user name@hostname where name is the person s account name and hostname isthenameof the remote server thepersonwillbeusing. The default host agent configuration file includes a user root entry. What next? Continue to the next section, to save the host agent configuration file. Saving the host agent configuration file What next? 1. Save the host agent configuration file. 2. If you are done adding information to the host agent configuration file, stop and restart the host agent by entering the following commands: rc.agent stop rc.agent start For CX3 series and CX-series storage systems You are done editing the host agent configuration file. For legacy storage systems You can now use Manager, CLI, or a text editor to edit the information for each managed storage system, such as the following: Agent description and contact Polling frequency SP event log entries to transfer Using Navisphere Manager Use the remote agent configuration featureasdescribedinthenavispheremanagerhelp. Using Navisphere CLI Usethenavicli remoteconfig command as described in the Navisphere Command Line Interface (CLI) Reference. EMC CLARiiON Server Support Products for AIX Server Installation Guide 23

24 Using a text editor (textedit, vi, or emacs) Refer to Manually editing the host agent configuration file (legacy storage systems only), page 24. Manually editing the host agent configuration file (legacy storage systems only) Before the host agent can communicate with a legacy storage system, youmustedittheagent sconfigurationfiletoincludespecific information. Normally, you use the remote agent configuration feature of Navisphere Manager to modify this file. However, before someone can use this feature to configure the host agent, you must manually add a user entry for that person to the host agent s configuration file. Note: You need to edit the host agent configuration file only if you have legacy storage systems connected to the server. A previous section explained how to edit the file to add one privileged user who could configure storage systems, but this section explains all the configuration file entries. Note: The host agent configuration file does not require any device entries for CX3-series or CX-series storage systems, and none of the other parameters defined in the file affect the storage systems. Thepathnametothehostagentconfigurationfileis: /etc/navisphere/agent.config The configuration file contains the following information for each storagesystemtobemanaged: Agent description and contact Communication channel(s) to the SP Users who can configure a managed storage system Polling frequency SP event log entries to transfer The following sections show a sample configuration file and describe how to specify this information. 24 EMC CLARiiON Server Support Products for AIX Server Installation Guide

25 Sample host agent configuration file (agent.config) Navisphere agent.config This file is used by Navisphere Agent to configure site specific values. All entries in this file have this form: object value-list Where "object" tells what sort of information is to be configured, and "value-list" is a whitespace-separated list of values to be configured. Samples, which should be edited, appear below for all permissible types of objects. White space (tabs, space, line-feeds, carriage-returns) and blank lines are ignored; To continue a line onto the next line, use "\" as the last character of that line. The "\" is dropped when the next line is concatenated to the continued line. Description specification The "clardescr" object takes arbitrary text values intended to describe the agent and its location. clardescr Navisphere Agent The "clarcontact" object takes arbitrary text values intended to describe who is responsible for the configured agent, and how to reach them. clarcontact John Smith, Device specification The format of "device" objects for CLARiiON devices is: devicedevice-specname "description" where the device-specification is the device name to open to access the CLARiiON device. It can be a SCSI-2 file name. If this is "auto", all attached arrays with bound LUNs will be automatically configured. (Currently, dummy arguments are required for name and description, when using auto-configuration.) This can NOT be defaulted. The name is the per CLARiiON name that can be used to identify each CLARiiON to the manager application. The name is REQUIRED and cannot contain spaces (even if surrounded by quotes). This can NOT be defaulted. The description is a quoted string that contains a brief description of the CLARiiON chassis being managed. It defaults to "" if not specified, and to EMC CLARiiON Server Support Products for AIX Server Installation Guide 25

26 the device name for auto-configuration. SAMPLES: device sp0 NAVISPHERE-0 "NAVISPHERE-0" device sp1 NAVISPHERE-1 "NAVISPHERE-1" device sp2 NAVISPHERE-2 "NAVISPHERE-2" device sp3 NAVISPHERE-3 "NAVISPHERE-3" device sp4 NAVISPHERE-4 "NAVISPHERE-4" device sp5 NAVISPHERE-5 "NAVISPHERE-5" automatically detect manageable devices device auto auto User Specification The format of "user" objects is" user localuserid OR user These build a list of users who are allowed to perform WRITE operations to the CLARiiON devices managed by this agent. By default, as specified below, only root on this machine has WRITE access. Others can be granted access by including their login name and host which they can access from. A null list prevents anyone, including admin, from having write access. In order to get write access, this file would have to be modified and the Agent stopped and restarted to re-read the configuration file, or an appropriate remote configuration file would have to be sent to the agent from an already-priviledged user. user root only on this machine user sblue@picasso individual user "sblue" on host "picasso" user lgreen@hannibal individual user "lgreen" on host "hannibal" Poll specification The "poll" object takes a numerical count of seconds. This specifies how often the agent solicits information from the array, rather than using cached information. The minimum is "10". poll 60 Eventlog specification The eventlog object takes a numerical count of log entries. This defines the maximum number of SP log events received by the agent on startup, and received by clients per poll. A value of 0 causes the device s entire log to be read at startup. A minimum of 100 events will be read on serial, and 2048 on fibre, 26 EMC CLARiiON Server Support Products for AIX Server Installation Guide

27 Specifying the host agent description and contact Specifying communication channels to the SPs overriding any lower value configured below. eventlog 100 end of configuration file Thehostagentdescription(clarDescr) and contact (clarcontact) entries are optional informational text strings that Manager does not use. You can use the clardescr entry to include information about the agent, such as its revision, and the clarcontact entry to include information about the person to contact concerning any agent questions or problems that might occur. To specify the host agent description, either modify the clardescr entry or add a new clardescr entry. A clardescr entry has this format: clardescr [description] where description is a description of the host agent, such as the name of the agent and its revision; for example, Disk-Array Agent, revision x, where x is the revision of the agent you are running. To specify the contact description, either modify the clarcontact entry or add a new clarcontact entry. A clarcontact entry has this format: clarcontact [contact_info] where contact_info is any optional information you want to include about whom to contact should any questions or problems with the agent arise. You could include the name of a person to contact and the person s electronic mail address and phone number. Each SP in a storage system is connected to the server by a Fibre Channel arbitrated loop (FC-AL) or a fabric connection to a Fibre Channel adapter, sometimes called a host bus adapter (HBA), or by a SCSI bus connected to a SCSI-2 adapter, also sometimes referred to as an HBA. The path from the adapter through the storage processor to one LUN in the storage system is a communication channel to the storage system for the host agent. The device entries in the host EMC CLARiiON Server Support Products for AIX Server Installation Guide 27

28 agent s configuration file define the communication channels. The fibre controllers use SCSI mapping. Storage systems with two SPs If the storage system has two SPs that are both connected to host bus adapters in the same server, as they are in a dual-adapter/dual-sp configuration, the server s host agent configuration file must have a device entry (device) for the communication channel through each SP. If the SPs are connected to host bus adapters in different servers, the host agent configuration file in each server must have a device entry for the communication channel through the SP connected to that server. Adding a storage system to the server If you add a storage system to the server in the future, you must make sure that the host agent configuration file has a device entry for the communication channel througheachstorageprocessorinthenewstoragesystem. You need to know the FC-AL address IDs or the SCSI target IDs of each storage-system SP and host HBA to which the SP(s) are connected. The FC-AL address ID or the SCSI target ID of an SP is set by switches on the back of the storage system, as described in the storage-system installation and maintenance manual. In addition, you need to know the number for the LUN owned by each SP in the storage system. To specify a communication channel Note: DonotaddacommunicationchannelforanSPinaCX3-series or CX-series storage system. Doing so will cause Manager to display an unnecessary unmanaged storage-system icon for the SP. Either modify the device entry or add a new device entry in the /etc/navisphere/agent.config file. The device entry must have one of the formats below: For automatic device scanning on host agent startup: device auto auto auto With the device entry of device auto auto, the host agent will automatically select the communication channel to one LUN per SP in each storage system every time the host agent starts. This method is the easiest way to enter device information in the agent configuration file. Use it instead of explicitly entering devices with the following format. 28 EMC CLARiiON Server Support Products for AIX Server Installation Guide

29 For access to a specific device: device channel name [description] where: Adding users to the host agent configuration file channel is a required field for the communication channel (device path, device name, or disk name) that the agent uses to communicate with the storage system. The format is cdtsdl where: For SCSI disks: D is the number of the SCSI bus on the SCSI-2 adapter to which the storage system is connected. S is the SCSI ID of the storage system s SP that is connected to SCSI bus cd. If the adapter identified by cd provides a narrow SCSI bus, this SCSI ID can range from 0 through7;andiftheadapterprovidesawidescsi bus, this SCSI ID can range from 0 through 15. L is the ID of a LUN owned by the SP identified by ts. For Fibre Channel disks: D, S, andl depend on the number of LUNs in the storage system and the setting of the FC-AL ID rotary switches on the SPs. You must use the ioscan utility and the CLI command systemtype to discover the device name, as explained in the following section name is a required label for identifying the communication channel. We recommend that this name include a name for the storage system, the SP, and the LUN. For example, if the name of the storage system is cpc220, the SP is SP A, and the LUN is 0, you could use the name cpc220_spa_lun0. Navisphere Manager does not use this information, but the Navisphere CLI does. [description] is an optional description of the connection to thechassis. Besuretoenclosethedescriptioninquotation marks. For example, Path from host img01 to cps220 SP A. The Navisphere Manager does not use this information, but the Navisphere CLI does. The information you specify here may be critically useful to anyone who maintains the storage systems connected to this server. Any user who can log in to a server that is a Navisphere management station can monitor the status of its managed storage systems. However, EMC CLARiiON Server Support Products for AIX Server Installation Guide 29

30 Specifying a polling frequency for the host agent a user must be a privileged user in the host agent configuration file to change a managed storage system s configuration. If you will be using Navisphere Manager 6.X to configure the host agent and manage your storage systems, you will be using a portal system for legacy storage systems. To add privileged users for a portal configuration, see Adding IP addresses for a portal system, page 20. To add other privileged users, see Adding privileged users, page22. Polling frequency sets the time interval for the agent to execute an automatic hardware poll to the storage system and update the agent s image of the storage system. Polling frequency determines how often the storage system is polled. The default polling interval is 60 seconds. Note: This background polling is automatic and occurs whether or not a client is communicating with the storage system. Since polling uses storage-system resources, setting the polling frequency value too low may affect performance. Specifying the number of SP events to read Add the following line to the host agent configuration file: poll n where n is 0 or an integer specifying the number of seconds between each poll of the host agent s SP. The minimum value, other than 0, is 10. We recommend that n be equal to or greater than 60 (the default value). If n is omitted, host agent polling is disabled and the SP is inaccessible. If n equals 0, the host agent will poll the SP every time it gets a poll request. The host agent reads event entries from the SP unsolicited event log at startup. You specify the number of the most current event to read. Since the complete log can contain as many as 16,800 entries, you may notwanttoburdennavisphereagentwithreadingallofthem. Note: If you enter a small value, Navisphere Manager and Navisphere CLI users will not be able to view the entire contents of the log without first stopping all applications, changing the value in the configuration file, saving the configuration file, restarting the agent, and restarting the applications. 30 EMC CLARiiON Server Support Products for AIX Server Installation Guide