# @(#)50 1.3 src/ssa/usr/lib/methods/ssareadme/README.ssatools, ssacmds, ssa43D 9/5/97 11:23:29 # # COMPONENT_NAME: MayAix # # FUNCTIONS: SSA Tools Readme # # ORIGINS: 27 # # (C) COPYRIGHT International Business Machines Corp. 1995 # All Rights Reserved # Licensed Materials - Property of IBM # # US Government Users Restricted Rights - Use, duplication or # disclosure restricted by GSA ADP Schedule Contract with IBM Corp. # ################################################################### README for the SSA tools. There are several command line programs in this directory. These commands have been provided to allow some of the functions which are available in the SSA service aids to be accessed from the command line. The commands are very simple and intended to be used primarily from within shell scripts. They do not have extensive error checking and error messages. If these are required, the SSA service aids should be used. In general the command will print a usage string if the syntax is incorrect but will not print a message if the command fails. If the command executes without error the return code will be 0. If there is an error, the return code will be a value other than 0. ------------------------------------------------------------------------ ssaxlate command Purpose Translates between SSA logical disks (hdisks) and SSA physical disks (pdisks) Syntax ssaxlate -l LogicalDiskName ssaxlate -l PhysicalDiskName Description If the parameter is a SSA Logical Disk, the output will be a list of SSA Physical Disk names which are involved in supporting that logical disk. If the parameter is a SSA Physical Disk, the output will be a list of SSA Logical Disk names which depend upon that physical disk. Flags -l DiskName Specifies the SSA logical or physical disk ------------------------------------------------------------------------ ssaadap command Purpose Lists the adapters to which a SSA Logical Disk or SSA Physical Disk is connected. Syntax ssaadap -l LogicalDiskName ssaadap -l PhysicalDiskName Description The output is the list of SSA adapters to which the SSA logical or physical disk is connected. If there is more than one adapter, the first adapter listed is the primary adapter. Flags -l DiskName Specifies the SSA logical or physical disk ------------------------------------------------------------------------ ssaidentify command Purpose Sets or clears identify mode for a SSA Physical Disk. Syntax ssaidentify -l PhysicalDiskName -y ssaidentify -l PhysicalDiskName -n Description If the -y parameter is specified the disk is set into identify mode. This causes the disk to flash the amber light at approximately 1 second intervals. The -n flag turns off identify mode. Flags -l PhysicalDiskName Specifies the device to place into identify mode. -y Turns on identify mode. -n Turns off identify mode. ------------------------------------------------------------------------ ssaconn command Purpose Displays the SSA connection details for the physical disk. Syntax ssaconn -l PhysicalDiskName -a AdapterName Description The ssaconn command performs a function similar to the "SSA Link Verification" service aid. The output is the PhysicalDiskName followed by the adapter name followed by four 'hop counts'. The four hop counts are represent the number of SSA devices between the adapter and the A1 A2 B1 B2 ports of the adapter respectively. If the disk is not connected to a particular adapter port, the hop count is replaced by a '-' character. Flags -l PhysicalDiskName Specifies the SSA physical disk whose connection details should be listed. -a AdapterName Specifies the adapter to list the connection details relative to. ------------------------------------------------------------------------ ssacand command Purpose Displays the unused connection locations for an SSA adapter Syntax ssacand -a AdapterName -P|-L Description The ssacand command is used to list out the available connection locations on an SSA adapter. These correspond to devices which are connected to the adapter, but for which there are no AIX devices configured. Flags -a AdapterName Specifies the adapter to list the connection locations for. -P Produce a list of possible connection locations for SSA physical disks. -L Produce a list of possible connection locations for SSA logical disks. ------------------------------------------------------------------------ ssadisk command Purpose Displays the names of SSA disks connected to an SSA adapter Syntax ssadisk -a AdapterName -P|-L Description The ssadisk command is used to list out the names of SSA disks connected to an SSA adapter. These correspond to devices which are in the customized device data base, and have the SSA adapter as their 'adapter_a' or 'adapter_b' attribute. Flags -a AdapterName Specifies the adapter which the disks are connected to. -P Produce a list of SSA physical disks. -L Produce a list of SSA logical disks. ------------------------------------------------------------------------ ssadload command Purpose Downloads microcode to SSA physical disk drives Syntax ssadload -d PhysicalDiskName -f CodeFileName ssadload -u ssadload -s [-d PhysicalDiskName] Description The ssadload command is used perform microcode downloads to SSA physcial disk drives. It can be used in two modes of operation: (i) Load a specific level of microcode on to a specific SSA physical disk drive. (ii) Ensure that all the SSA physical disk drives connected to the system are operating with the latest available levels of microcode on the system. Using the command in mode (i) above allows you to force load any available microcode level on to any compatible SSA disk drive. Using the command in mode (ii) above allows you to be sure that the latest available microcode has been loaded on to all compatible SSA disk drives in the system. Flags -d PhysicalName Specifies the physical disk drive to recieve the microcode. -f Specifies the microcode file to download. -u Ensure that all SSA physical disk drives are loaded with the most upto date microcode available on the system. -s Show current code levels on all available disks -s [-d PhysicalDisk Name] Show current code level on a specific disk Notes The microcode files which this utility can download are ones which have file names of the form 'ssadisk.ros.XXXX', where XXXX identifies the microcode level (also known as the ROS id) which the file contains. These microcode files are different from those with names of the form 'ssadisk.XXXXXXX.YY', which contain a different form of drive microcode. These microcode files are automatically downloaded by the system configuration software as necessary, and will not work with this utility. SSA disk drives can receive downloads whilst they are in use by the system. It is not necessary to vary off any volume groups which they are in. If a download microcode to a disk drive which in use by AIX, the system may experience a slight delay while the code is loaded by the disk drive. The microcode images are stored in the directory '/etc/microcode'. Examples ssadload -d pdisk0 -f ssadisk.ros.7899 This will load microcode file 'ssadisk.ros.7899' onto pdisk0. ssadload -u This will identify the latest levels of SSA disk drive microcode available in /etc/microcode and check each SSA disk drive to ensure that they are running with at least that level of code. Any which are found to be downlevel will be downloaded with the appropriate latest level of microcode. ssadload -s This will list the current level of microcode on all of the available SSA disk drives. ------------------------------------------------------------------------