Chapter 4. Operating System Support

This chapter describes the restrictions of using TPSSM in the IRIX environment, identifying volumes by device names, stopping and starting TPSSM, disabling and enabling the Event Monitor, and uninstalling storage management software.

Understanding the Restrictions

Table 4-1 provides information on the restrictions that apply to using TPSSM in the IRIX environment.


Note: Always check for a README file on the CD-ROM. This README file might contain important, late-breaking information that was not available when this Administration Guide was written. Also, see release notes, which contain a list of known issues, bug fixes, as well as enhancements. See the README file on the CD-ROM for instructions on how to view the release notes.


Table 4-1. Restrictions for the IRIX Operating Environment

Restriction

Workaround

Clicking on the vertical scro ll arrows (either up or down) causes the scroll box to move all the way to the opposite end of the scroll bar.

This is a known defect in the Java Runtime Environment.
Click the scroll box and slide it until you reach the desired position in the window.

If you are managing Storage Arrays with the host-agent software, do not download an NVSRAM configuration settings file with the Access Volume Disabled attribute. Doing so deletes the Access Volume on host-agent managed Storage Arrays, causing those Storage Arrays to become inaccessible.

If you download NVSRAM files to a host-agent managed Storage Array using the Storage Array > Download > NVSRAM option, select an NVSRAM file in the NVSRAM Download File Selection area, and then check the File Information to make sure that the file does not contain the Access Volume Disabled attribute.
Note: If you accidentally delete the Access Volume, contact your customer support representative for assistance.

After trying to add a host device to the management domain of mo re than five clients, the host-agent managed Storage Arrays attached to that host become unresponsive.

A single instance of the host-agent software can only communicate with five or fewer clients.

When both ports of a dual-port Fibre Channel drive fail while the drive is part of a Storage Array, both A and B loops are brought down. You will lose access to the data on the storage devices.
The probability of both ports failing on a single drive is remote. For example, based on 1.2 million hours MTBF, the likelihood for both ports to fail is 0.08%.

Shut down all drive tray(s) and the controller tray. Power up all of the drive tray(s) and then power up the controller tray.
The drive with the port failures will not display in the Array Management window. Revive any failed drives caused by the drive failure (data integrity is preserved.) Replace the drive that does not display in the Array Management window with a good drive. Reconstruction begins and the volume is restored.

After pulling all drives from a Storage Array, the storage management software prompts you for a password when you start the software or when you perform protected operations. Any password you enter fails.

Password information is stored on a reserved area of each drive on the Storage Array. Each drive stores a mirrored copy of the password data. With no drives in the Storage Array, the storage management software does not find the password data when you attempt password protected operations. Add one of the drives to the Storage Array and reattempt the operation.

If you configure a new Storage Array with a single controller, you must place the controller in the left slot of the controller enclosure (slot A). The controller firmware cannot recognize or talk to a single controller until slot A is populated. This restriction does not apply to Storage Arrays that are configured with two controllers.

None.

The Automatic Discovery option of the Enterprise Management window does not discover all of the appropriately configured Storage Arrays on a subnetwork.

Add the devices manually using the Add Device option. See the Enterprise Management window Help for more information.

A controller fails during I/ O transfer. The host hangs, and you might see an I/O error message.

Fix the controller, using the Recovery Guru. Restart the I/O application. No data corruption occurs.


Identifying Volumes by Operating System Device Names

The host-util software includes a utility that lets you see which Storage Array volume is associated with a particular operating system device name. Tpssmdevice provides a detailed listing of IRIX device names to the Storage Array Volume names and their World Wide Name IDs. This capability is useful for operations such as data placement and volume deletion.

To use the utility, enter the following:

> tpssmdevices

The software displays device identification information. The table below shows an example output with a description of each column.


Note: If /usr/sbin is not contained in the PATH environment variable, the full path name is required on the command line (/opt/tpssm/util/tpssmdevices).


Table 4-2. Device Identification Information

Entry in IRIX

Controller Name

Volume Group

Vol. Name

World Wide Name of Device

/dev/scsi/sc11d1l8
/dev/scsi/sc11d1l1
/dev/scsi/sc11d1l2
/dev/scsi/sc11d1l3
/dev/scsi/sc11d1l4
/dev/scsi/sc11d1l5
/dev/scsi/sc11d1l31
/dev/scsi/sc12d3l0
/dev/scsi/sc12d3l1
/dev/scsi/sc12d3l2
/dev/scsi/sc12d3l3
/dev/scsi/sc12d3l4
/dev/scsi/sc12d3l5
/dev/scsi/sc12d3l31

[Storage Array RAID7/8,
[Storage Array RAID7/8,
[Storage Array RAID7/8,
[Storage Array RAID7/8,
[Storage Array RAID7/8,
[Storage Array RAID7/8,
[Storage Array RAID7/8,
[Storage Array RAID7/8,
[Storage Array RAID7/8,
[Storage Array RAID7/8,
[Storage Array RAID7/8,
[Storage Array RAID7/8,
[Storage Array RAID7/8,
[Storage Array RAID7/8,

Volume LUN 0,
Volume LUN 1,
Volume LUN 2,
Volume LUN 3,
Volume LUN 4,
Volume LUN 5,
Vol. Acc. volume,
Volume LUN 0,
Volume LUN 1,
Volume LUN 2,
Volume LUN 3,
Volume LUN 4,
Volume LUN 5,
Vol. Acc. volume,

LUN 0,
LUN 1,
LUN 2,
LUN 3,
LUN 4,
LUN 5,
LUN 31,
LUN 0,
LUN 1,
LUN 2,
LUN 3,
LUN 4,
LUN 5,
LUN 31,

WWN <600a0b80000664d400000073396cd12f>]
WWN <600a0b80000664d400000075396cd134>]
WWN <600a0b80000664d400000077396cd138>]
WWN <600a0b80000664d400000079396cd13c>]
WWN <600a0b8000001396000000833977470f>]
WWN <600a0b800007b8370000000b39775aa1>]
WWN <600a0b800007b8370000000000000000>]
WWN <600a0b80000664d400000073396cd12f>]
WWN <600a0b80000664d400000075396cd134>]
WWN <600a0b80000664d400000077396cd138>]
WWN <600a0b80000664d400000079396cd13c>]
WWN <600a0b8000001396000000833977470f>]
WWN <600a0b800007b8370000000b39775aa1>]
WWN <600a0b80000013960000000000000000>]


Stopping and Starting the Host-Agent Software on IRIX Systems

On IRIX systems, follow these procedures to stop and start the host-agent software installed on the host.

You must stop the host-agent software if you want to add Storage Arrays. When you restart the software, the host-agent discovers the new Storage Arrays and adds them to the management domain.

  • To stop the host-agent software, enter the following:

    > /etc/init.d/tpssmagent stop
    

The host-agent software automatically starts after you reboot the host. However, you must start the software manually if you stop it to add Storage Arrays.

  • To start the host-agent software, enter the following:

    > /etc/init.d/tpssmagent start
    


    Note: It might take several minutes for the agent deamon startup process to complete.



    Note: The agent will not be started if the tpssmagent configuration flag is set to off (see chkconfig(1M) for details).


Starting and Stopping the Host-Agent Software on Linux Systems

On Linux systems, follow these procedures to stop and start the host-agent software installed on the host.

You must stop the host-agent software if you want to add Storage Arrays. When you restart the software, the host-agent discovers the new Storage Arrays and adds them to the management domain.

  • To stop the host-agent software, enter the following:

    > /etc/rc.d/init.d/tpssmagent stop
    

The host-agent software automatically starts after you reboot the host. However, you must start the software manually if you stop it to add Storage Arrays.

  • To start the host-agent software, enter the following:

    > /etc/rc.d/init.d/tpssmagent start
    


    Note: It might take several minutes for the agent deamon startup process to complete.



    Note: For Altix systems with 2.4.x kernels and XSCSI software subsystem, you must invoke the following before starting the agent, where CDROM is the mount point of the CD-ROM drive.

    > cp /CDROM/Linux/client/xscsi_to_sg_utm_init /opt/tpssm/agent
    > /opt/tpssm/agent/xscsi_to_sg_utm_init


Disabling and Enabling the Event Monitor

The Event Monitor, which is packaged with TPSSM client software, monitors storage arrays and handles error notification through e-mail or SNMP traps when the storage management software is not actively running on the storage management station or host.


Note: If you installed TPSSM client software and configured alert notifications on multiple machines, you may receive duplicate error messages from the same storage array. To avoid receipt of duplicate error messages, disable the Event Monitor on all but one machine. It is recommended that you run the Event Monitor on one machine that will run continually.



Note: If using direct (network) management, only one machine should be running the Event Monitor software.

You can disable and enable the event monitor without having to reboot a management station (workstation) or host (server), or you can permanently disable or enable the boot-time loading of the event monitor.

Disabling the Event Monitor

On IRIX systems, enter the following to disable the Event Monitor:

> /etc/init.d/tpssmmonitor stop

On Linux systems, enter the following to disable the Event Monitor:

> /etc/rc.d/init.d/tpssmmonitor stop

Enabling the Event Monitor

On IRIX systems, enter the following to enable the Event Monitor:

> /etc/init.d/tpssmmonitor start


Note: The Event Monitor will not be started if the tpssm monitor configuration file is set to off (see chkconfig(1M) for details).

On Linux systems, enter the following to enable the Event Monitor:

> /etc/rc.d/init.d/tpssmmonitor start

Disabling Boot-time Loading of the Event Monitor

On IRIX systems, enter the following to disable boot-time loading of the Event Monitor:

> chkconfig tpssmmonitor off

On Linux systems, enter the following to disable boot-time loading of the Event Monitor, where CDROM is the mount point of the CD-ROM drive:

> cp /CDROM/Linux/client/tpssmmonitor_symlink /opt/tpssm/client
> /opt/tpssm/client/tpssmmonitor_symlink delete

Enabling Boot-time Loading of the Event Monitor

On IRIX systems, enter the following to enable boot-time loading of the Event Monitor:

> chkconfig tpssmmonitor on

On Linux systems, enter the following to enable boot-time loading of the Event Monitor, where CDROM is the mount point of the CD-ROM drive:

> cp /CDROM/Linux/client/tpssmmonitor_symlink /opt/tpssm/client
> /opt/tpssm/client/tpssmmonitor_symlink create

Uninstalling the TPSSM Software

See the README file located on the CD-ROM for instructions on removing the storage management software.