Chapter 3. Installing the TPSSM Software

This chapter describes the process of uninstalling and installing the TPSSM Agent and Client software.


Note: If version 7.xx of the TPSSM7 software is already installed, it must be uninstalled before installing TPSSM version 8.3x or later.


Uninstalling the TPSSM7 Software

To uninstall the TPSSM7 software, follow these steps:

  1. Enter the following commands:

    > su to root
    > inst -f none
    

  2. Select option 7 (remove)

  3. Enter the following:

    > tpssm*
    

  4. To start the software removal, enter the following:

    > go
    


    Note: For more information, see the README file located on CD-ROM, which contains TPSSM software.


The following output is normal during software removal:

: ( rm -f /etc/rc2.d/S99tpssm7agent; rm -f /etc/rc0.d/K00tpssm7agent )
Running exit-commands ..  97%
: ( kill -9 `ps -ef | grep 'opt/tp9400/bin/SM7age' | grep java | grep -v grep |
awk '{print $2}' 2>/dev/null`)


Note: The above will only be seen if verbosity level is set on.


TPSSM Software Installation Procedure

If you are installing the software on the host, install the agent, util, and runtime software. If you are installing the software on the management station, install the client and runtime software.


Note: The installation software includes Java JRE, so it does not matter if your system has the Java Runtime Environment (JRE) installed or not.


IRIX Installation

Follow these steps to install the TPSSM software on an IRIX system:

  1. To verify the version level of IRIX installed on the system, enter the following:

    > uname -Ra
    

    This should display:

    IRIX perf36 6.5 6.5.9m or 6.5.9f
    


    Note: The TPSSM software is supported only on IRIX 6.5.9 and later.


  2. To display the main menu, enter the following:

    > inst -f /CDROM/irix/dist
    


    Note: /CDROM/ is the mount point for the CD-ROM. If this is not the mount point for your system, replace this part of the command with the actual CD-ROM mount point, for example: inst -f /mnt/irix/dist


  3. Enter the following:

    > list
    

    A list of TPSSM software components will be displayed.


    Note: All files are installed by default. If installing on a management station, you need only install TPSSM and TPSSM runtime files. If installing on a host server, you need only install TPSSM agent, TPSSM util, and TPSSM runtime. If installing on a host server acting as a management station, you need to install TPSSM, TPSSM agent, TPSSM util, and TPSSM runtime.


  4. To verify that there are no software confilicts, enter the following:

    > conflicts 
    


    Note: Before you install the TPSSM software, you must remove any earlier versions of the software. See “Uninstalling the TPSSM7 Software”.


  5. To install the software, enter the following:

    > go
    

    This might take several minutes.

  6. Enter the following:

    > quit
    

    At the end of the TPSSM installation process, a script will automatically run to configure the communication device and start the host software.


    Note: TPSSM monitor will not be started automatically. It should only be started on a specific management station (when using direct (network) management).


Linux Installation

To install the TPSSM software on a Linux system, perform the following procedure:

  1. Ensure that you have root privileges, which are required to install the software.

  2. Insert the CD that contains the management software and, if necessary, mount the CD-ROM drive.

  3. Install the software packages in the order listed.

    1. At the system prompt, type the appropriate installation command and press enter. In the following commands, CDROM is the mount point of the CD-ROM drive and build is the management software version level (for example, 09.10.A8.00-1).

      > cd /CDROM/linux/rpms/ia64
      > rpm -ivh TPSSMRuntime-LINUX-build.ia64.rpm
      > rpm -ivh TPSSM-LINUX-build.noarch.rpm
      > rpm -ivh TPSSMAgent-LINUX-build.ia64.rpm
      > rpm -ivh TPSSMUtil-LINUX-build.ia64.rpm
      


      Note: TPSSMAgent and TPSSMUtil should be installed only on the server that will be used for in-band (host agent) management.


    2. At the system prompt, type the appropriate verify command for each installed package and press enter:

      > rpm -qi TPSSMRuntime
      > rpm -qi TPSSM
      > rpm -qi TPSSMAgent
      > rpm -qi TPSSMUtil
      

Windows Installation

To install the TPSSM software on a Windows system, run the following command line from the root of your CD-ROM drive:

x:\nt\SMclient\setup.exe

In the example, x: corresponds to the drive letter of your CD-ROM drive. If you prefer, navigate to the \nt\SMclient folder on the CD-ROM and double-click setup.exe.

Completing the Installation

Use the following procedures to finish installing the TPSSM software.

Starting the Enterprise Management Window

To complete the installation procedure, you must initiate Storage Array discovery using the Enterprise Management window. Start the Enterprise Management window using this procedure:

  1. Enter the following:

    > tpssm
    

    The client software will start, displaying the Enterprise Management window and the Confirm Initial Automatic Discovery dialog box (Figure 3-1).


    Note: If tpssm: command not found is reported, then try one of the following workarounds:

    Enter rehash, then enter tpssm.

    OR

    Enter /opt/tpssm/client/tpssm.

    The above workarounds are only applicable during the initial installation. The next time you log in or create a new shell window, they should not be required.


    Figure 3-1. The Confirm Initial Enterprise Management Window and Automatic Discovery Dialog Box

    The Confirm Initial Enterprise Management Window and Automatic Discovery Dialog Box


    Note: If /usr/sbin is not contained in the PATH environment variable, the full path name is required on the command line (/opt/tpssm/client/tpssm) to open the Enterprise Management window.

    The Enterprise Management window might take several minutes to open. No wait cursor is displayed.

    If you do not want to perform the initial automatic discovery, select No. You can use the Edit > Add Devices pulldown menu option to add hosts and Storage Arrays. (See “Adding Devices” for more information.)

  2. Select Yes to begin an initial automatic discovery of hosts and Storage Arrays attached to the local subnetwork on which the management station is installed. This might take several minutes.

    The software sends a broadcast message across the local subnetwork where the management station is installed. It discovers host-agent managed Storage Arrays if the hosts that provide network management connections to the Storage Arrays respond to the broadcast. The software discovers directly managed Storage Arrays if the controllers in those Storage Arrays respond to the broadcast message.


    Note: It might take several minutes for the Enterprise Management window to refresh after an initial automatic discovery.

    If you need to stop the automatic discovery operation for any reason, close the Enterprise Management window.

    When the initial automatic discovery is completed, you should see all of the hosts and Storage Arrays attached to the local subnetwork (Figure 3-2).

    Figure 3-2. Enterprise Management Window

    Enterprise Management Window

    If you do not see all of the hosts and Storage Arrays you expected to see:

    • Check the hardware and connections for possible problems (see the hardware documentation listed in “Related Publications” for specific procedures).

    • Verify that the software is installed.

    • Verify that TPSSM is running.

    • See the Enterprise Management window Help topic about discovering Storage Arrays.

    • Make sure that the device is on the local subnetwork. If not, use the Add Device option.

If any device shows a status of Unresponsive, use the software to remove the device from the management domain and add it again. See the Enterprise Management window Help for instructions on removing and adding devices.


Note: A Storage Array might be duplicated in the Device Tree after an automatic discovery if the Storage Array is directly managed but is attached to a host with the host-agent software installed and running. In this case, remove the duplicate Storage Array icon from the Device Tree using the Remove Device option in the Enterprise Management window.


Adding Devices

You might want to add hosts or Storage Arrays outside the local subnetwork. To learn more about this option, see the Enterprise Management window Help.


Note: If you are managing Storage Arrays through the host-agent software and you physically add new Storage Arrays, you must stop and restart the host-agent software so it can recognize the new Storage Arrays (see “Stopping and Starting the Host-Agent Software on IRIX Systems” in Chapter 4). Then go to the Enterprise Management window and select Tools > Rescan to add the new Storage Arrays to the management domain.


Setting Up Alert Notifications

After you have added devices to the management domain, you should set up alert notification options to report critical events on the Storage Arrays. The following options are available for alert notification:

  • Notification to designated e-mail addresses.

  • Notification to designated alphanumeric pagers (when a third-party software package is used to convert e-mail messages).

The Enterprise Management window must remain open if you want to monitor the condition of Storage Arrays included in your management domain. If you close this window, you will not receive alert notifications. You can minimize the window.


Note: See the Enterprise Management window Help for more information on alert notification options.


Starting the Array Management Window

Use this procedure to start an Array Management window for a selected Storage Array.

  1. In the Enterprise Management window, select a Storage Array.

  2. Select Tools > Manage Device.


    Note: Optionally, right-click the storage array and select Manage Devices to start an Array Management window.

    The software displays the Array Management window for the selected Storage Array (Figure 3-3).

    Figure 3-3. Array Management Window

    Array Management Window


    Note: The Array Management window you opened lets you manage only the selected Storage Array. However, you can open multiple Array Management windows to manage other Storage Arrays.


Renaming Storage Arrays

When you start the storage management software for the first time, the Storage Arrays are unnamed. You must use the Array Management window to rename each Storage Array from <unnamed> to the name you want. Refer to the names you entered in the information record you created using Table 2-3. Then, see the renaming Storage Arrays topic in the Array Management window Help. The Help topic provides detailed instructions for renaming Storage Arrays.

Other Storage Array Management Tasks

There are several other tasks you might want to perform at this time. These tasks include:

  • Locating a Storage Array

  • Viewing a Storage Array profile

  • Configuring a Storage Array password

  • Creating and managing volumes and volume groups

  • Creating storage partitions (if applicable)

  • Synchronize the controller clocks

To create storage partitions, you must obtain the worldwide name or port name of each host adapter in each host connected to the Storage Array.


Note: To learn more about these and other Storage Array management tasks, see the appropriate topics in the Array Management window Help.