TSM

Tivoli Storage Manager, server and client on AIX

A lot of raw information...

Documentation

IBM Tivoli Storage Manager Version 6.2 Information Center

http://publib.boulder.ibm.com/infocenter/tsminfo/v6r2/

IBM Tivoli Storage Manager for AIX: Installation Guide (GC23-9781-02)

http://publib.boulder.ibm.com/infocenter/tsminfo/v6r2/topic/com.ibm.itsm.srv.install.doc/b_srv_install_guide_aix.pdf

Environment

TSM Server version: 6.2.3.100

Hardware: IBM POWER7

AIX oslevel: 6100-06-01-1043 => 6100-07-01-1141

Atape.driver: 12.3.4.0

Server user: root

Install - Server 6.2

Prerequisites

- install Atape driver (requires a reboot)

- enable IOCP (see below)

- extend /opt by at least 2GB (see below)

- determine required components

- configure filesystem space for instance, database etc (not covered here yet)

Silent install in non-graphical mode

# timex /tsm/install/Server621/install.bin -i silent -DLICENSE_ACCEPTED=true -DINSTALL_SERVER=true -DINSTALL_LICENSE=1 -DINSTALL_DEVICES=1
Preparing to install...
Extracting the JRE from the installer archive...
Unpacking the JRE...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...
Launching installer...
Preparing SILENT Mode Installation...
===============================================================================
Tivoli Storage Manager                           (created with InstallAnywhere)
-------------------------------------------------------------------------------
===============================================================================
Installing...
-------------
 [==================|==================|==================|==================]
 [------------------|------------------|------------------|------------------]
Installation Complete.
real 1072.75
user 293.64
sys  81.69

The whole install occupies ~1.7GB on /opt.

Install - Failed: version check (unsupported AIX version)

InstallAnywhere error on AIX 7.1:

===============================================================================
TSM Environment Check
---------------------
The installation wizard cannot run on your configuration. It will now stop.
For more details about installation error logs, enter the phrase "installation
log files" in the Search field at this site:
http://publib.boulder.ibm.com/infocenter/tsminfo/v6r2.
Version check: Failed

Log file /var/tivoli/tsm/log.txt:

Wed Dec 14 15:37:44.747 CET 2011 :    INFO : Setting log level to: ALL (from com.tivoli.dsm.check.TSMEnvironmentRule.initLogger)
Wed Dec 14 15:37:44.758 CET 2011 :    INFO : Set IA variable IA_GENERIC_LOGGER_CURRENT_FILE=/var/tivoli/tsm/log.txt (from com.tivoli.dsm.check.TSMEnvironmentRule.initLogger)
Wed Dec 14 15:37:45.799 CET 2011 :    INFO : Found AIX 6.1 with oslevel: 7100-01-00-0000
 (from com.tivoli.dsm.check.TSMEnvironmentRule.checkAIX61Level)
Wed Dec 14 15:37:45.801 CET 2011 :    INFO : Checking xlC version (from com.tivoli.dsm.check.TSMEnvironmentRule.checkXLCVersionCheck)
Wed Dec 14 15:37:45.802 CET 2011 :    INFO : Issuing cmd: lslpp -l xlC.aix61.rte (from com.tivoli.dsm.check.TSMEnvironmentRule.checkXLCVersionCheck)
Wed Dec 14 15:37:45.888 CET 2011 :    INFO : Current level: 11.1.0.2 (from com.tivoli.dsm.check.TSMEnvironmentRule.checkXLCVersionCheck)
Wed Dec 14 15:37:45.890 CET 2011 :    INFO : Issuing cmd: LANG=C lswpar (from com.tivoli.dsm.check.TSMEnvironmentRule.checkWPAR)
Wed Dec 14 15:37:46.187 CET 2011 :    INFO : stderr:  (from com.tivoli.dsm.check.TSMEnvironmentRule.checkWPAR)
Wed Dec 14 15:37:46.189 CET 2011 :    INFO : Checking xlC version (from com.tivoli.dsm.check.TSMEnvironmentRule.checkXLCVersionCheck)
Wed Dec 14 15:37:46.190 CET 2011 :    INFO : Issuing cmd: lslpp -l xlC.rte (from com.tivoli.dsm.check.TSMEnvironmentRule.checkXLCVersionCheck)
Wed Dec 14 15:37:46.280 CET 2011 :    INFO : Current level: 11.1.0.2 (from com.tivoli.dsm.check.TSMEnvironmentRule.checkXLCVersionCheck)
Wed Dec 14 15:37:46.287 CET 2011 :    INFO : Checking IOCP version (from com.tivoli.dsm.check.TSMEnvironmentRule.checkIOCPVersionCheck)
Wed Dec 14 15:37:46.289 CET 2011 :    INFO : Issuing cmd: LANG=C lslpp -L bos.iocp.rte | grep bos.iocp.rte (from com.tivoli.dsm.check.TSMEnvironmentRule.checkIOCPVersionCheck)
Wed Dec 14 15:37:46.829 CET 2011 :    INFO : stdout: bos.iocp.rte               7.1.1.1    C     F    I/O Completion Ports API (from com.tivoli.dsm.check.TSMEnvironmentRule.checkIOCPVersionCheck)
Wed Dec 14 15:37:46.831 CET 2011 :    INFO : Current level: 7.1.1.1 (from com.tivoli.dsm.check.TSMEnvironmentRule.checkIOCPVersionCheck)
Wed Dec 14 15:37:46.833 CET 2011 :    INFO : Issuing cmd: LANG=C lsdev -Cc iocp (from com.tivoli.dsm.check.TSMEnvironmentRule.checkAIXIOCP)
Wed Dec 14 15:37:46.857 CET 2011 :    INFO : stdout: iocp0 Defined  I/O Completion Ports (from com.tivoli.dsm.check.TSMEnvironmentRule.checkAIXIOCP)
Wed Dec 14 15:37:47.750 CET 2011 :  STDOUT : Checking /var :
Wed Dec 14 15:37:47.751 CET 2011 :  STDOUT :     - available space: 730865664 bytes
Wed Dec 14 15:37:47.757 CET 2011 :  STDOUT :     - required space: 5000000 bytes
Wed Dec 14 15:37:47.758 CET 2011 :  STDOUT :     - sufficient space: true
Wed Dec 14 15:37:47.798 CET 2011 :  STDOUT : Checking /usr :
Wed Dec 14 15:37:47.799 CET 2011 :  STDOUT :     - available space: 2124587008 bytes
Wed Dec 14 15:37:47.800 CET 2011 :  STDOUT :     - required space: 300000000 bytes
Wed Dec 14 15:37:47.801 CET 2011 :  STDOUT :     - sufficient space: true
Wed Dec 14 15:37:47.846 CET 2011 :  STDOUT : Checking /opt :
Wed Dec 14 15:37:47.847 CET 2011 :  STDOUT :     - available space: 4065251328 bytes
Wed Dec 14 15:37:47.848 CET 2011 :  STDOUT :     - required space: 10000000 bytes
Wed Dec 14 15:37:47.849 CET 2011 :  STDOUT :     - sufficient space: true
Wed Dec 14 15:37:47.888 CET 2011 :  STDOUT : Checking /tmp :
Wed Dec 14 15:37:47.889 CET 2011 :  STDOUT :     - available space: 219590656 bytes
Wed Dec 14 15:37:47.890 CET 2011 :  STDOUT :     - required space: 200000000 bytes
Wed Dec 14 15:37:47.896 CET 2011 :  STDOUT :     - sufficient space: true
Wed Dec 14 15:37:47.917 CET 2011 :    INFO : Issuing cmd: gunzip -V  (from com.tivoli.dsm.check.TSMEnvironmentRule.checkCmd)
Wed Dec 14 15:37:47.998 CET 2011 :    INFO : rc: 0 (from com.tivoli.dsm.check.TSMEnvironmentRule.checkCmd)
Wed Dec 14 15:37:48.000 CET 2011 :    INFO : __________________________________________________________________________ (from com.tivoli.dsm.check.TSMEnvironmentRule.printResults)
Wed Dec 14 15:37:48.006 CET 2011 :    INFO : Tivoli Storage Manager Environment Settings Check (from com.tivoli.dsm.check.TSMEnvironmentRule.printResults)
Wed Dec 14 15:37:48.008 CET 2011 :    INFO : OS name: AIX (from com.tivoli.dsm.check.TSMEnvironmentRule.printResults)
Wed Dec 14 15:37:48.009 CET 2011 :    INFO : OS version: 7.1 (from com.tivoli.dsm.check.TSMEnvironmentRule.printResults)
Wed Dec 14 15:37:48.011 CET 2011 :    INFO : arch: .*.* (from com.tivoli.dsm.check.TSMEnvironmentRule.printResults)
Wed Dec 14 15:37:48.017 CET 2011 :  FINEST : Platform check: Ok (from com.tivoli.dsm.check.TSMEnvironmentRule.printResults)
Wed Dec 14 15:37:48.019 CET 2011 :  SEVERE : Version check: Failed (from com.tivoli.dsm.check.TSMEnvironmentRule.printResults)
Wed Dec 14 15:37:48.020 CET 2011 :  SEVERE : Environment settings: Failed (from com.tivoli.dsm.check.TSMEnvironmentRule.evaluateRule)
Wed Dec 14 15:37:48.027 CET 2011 :    INFO : __________________________________________________________________________ (from com.tivoli.dsm.check.TSMEnvironmentRule.evaluateRule)
Wed Dec 14 15:37:52.937 CET 2011 :  STDERR : SHUTDOWN REQUESTED
Wed Dec 14 15:37:52.938 CET 2011 :  STDOUT : (X) commiting registry
Wed Dec 14 15:37:52.939 CET 2011 :  STDOUT : (X) shutting down service manager
Wed Dec 14 15:37:52.950 CET 2011 :  STDOUT : (X) cleaning up temporary directories
Wed Dec 14 15:37:59.699 CET 2011 :  STDERR : cleanUp()
Wed Dec 14 15:37:59.700 CET 2011 :  STDERR : calling cleanUpUNIX()
Wed Dec 14 15:38:15.197 CET 2011 :  STDERR : Exiting with exit code: 1000

Install - Failed: IOCP

Requirement check: Failed
  - DB2 requires IOCP to be enabled on AIX platforms. Enable this manually
using "smitty iocp". If the problem persists contact a technical service
representative.

Enable and configure IOCP (I/O Completion Ports)

# chdev -l iocp0 -a autoconfig=available
# mkdev -l iocp0

Install - Failed: not enough space in /opt filesystem

This installation requires 1,730.68 MB of free disk space, but there are only
858.88 MB available at:
   /opt/tivoli/tsm
Please free at least 871.81 MB to proceed with the installation.

Resize it to 3GB, for example:

# chfs -a size=3G /opt

We could have used a separate filesystem for TSM, but normally it doesn't grow later if the logs are put somewhere else.

Install - Additional output

/stderr

/stdout

TSM Server - AIX filesets

# lslpp -lcq | awk -F\: '/tsm/ {print $2" "$7}'
tivoli.tsm.client.api.32bit TSM Client - Application Programming Interface
tivoli.tsm.client.api.64bit TSM Client - 64bit Application Programming Interface
tivoli.tsm.client.ba.64bit.base TSM Client 64 - Backup/Archive Base Files
tivoli.tsm.client.ba.64bit.common TSM Client 64 - Backup/Archive Common Files
tivoli.tsm.client.ba.64bit.image TSM Client 64 - IMAGE Backup Client
tivoli.tsm.client.ba.64bit.web TSM Client 64 - Backup/Archive Java GUI & WEB Client
tivoli.tsm.devices.acsls TSM ACSLS Support
tivoli.tsm.devices.msg.en_US TSM Device Driver Messages, locale en_US
tivoli.tsm.devices.rte TSM Device Driver
tivoli.tsm.server TSM Server
tivoli.tsm.server.license.cert TSM Server License Certificates
tivoli.tsm.server.license.rte TSM Server License Runtime
tivoli.tsm.server.msg.en_US TSM Server Messages, locale en_US
tivoli.tsm.devices.acsls TSM ACSLS Support
tivoli.tsm.devices.rte TSM Device Driver
tivoli.tsm.server TSM Server

BFF Packages are extracted by the installer under:

Server621/COI/PackageSteps/TSM_Devices/FILES/TIV-TSMDD-AIX/

Server621/COI/PackageSteps/TSM_Lang_*/

Server621/COI/PackageSteps/TSM_License/FILES/TIV-TSMLIC-AIX/

Server621/COI/PackageSteps/TSM_Server/FILES/TIV-TSMSRV-AIX/

Server621/COI/PackageSteps/TSM_Stagent/FILES/TIV-TSMSTA-AIX/

TSM Server - Device configuration

In our case, some the existing drives and libraries were allocated for the new server while the production server was still running.

Commands in dsmadmc to determine which tape/library is free, and to check serial numbers:

q drive f=d

On-Line: Yes|No

Drive State: UNKNOWN|EMPTY <== 'EMPTY' is already in use...

Serial Number:

q path

On-Line Yes|No

q library f=d

Shared: Yes|No <== should be shared if a new server wants to access it

Serial Number:

Serial numbers can be checked in AIX with the lscfg command (see below).

Details

Determine drive allocation in TSM:

tsm> q drive f=d
                                Library Name: JA2LIB
                                  Drive Name: D01
                                 Device Type: 3592
                                     On-Line: Yes
                                Read Formats: 3592-2C,3592-2,3592C,3592
                               Write Formats: 3592-2C,3592-2,3592C,3592
                                     Element: 257
                                 Drive State: EMPTY
                                 Volume Name:
                                Allocated to:
                                         WWN: xxx
                               Serial Number: xxx
              Last Update by (administrator): xxxx
                       Last Update Date/Time: 12/07/11   16:19:51
Cleaning Frequency (Gigabytes/ASNEEDED/NONE): NONE
tsm> q path
Source Name     Source Type     Destination     Destination     On-Line
                                Name            Type
-----------     -----------     -----------     -----------     -------
TSMSERV         SERVER          JA2LIB          LIBRARY         Yes
...
tsm> q library f=d
                  Library Name: JA2LIB
                  Library Type: SCSI
                        ACS Id:
              Private Category:
              Scratch Category:
         WORM Scratch Category:
              External Manager:
                        Shared: Yes
                       LanFree:
            ObeyMountRetention:
       Primary Library Manager:
                           WWN: xxx
                 Serial Number: xxx
                     AutoLabel: No
                  Reset Drives: No
Last Update by (administrator): xxxx
         Last Update Date/Time: 09/24/10   14:38:03

AIX devices - Serial numbers

# lscfg -vpl smc* | egrep "smc|Serial"
  smc0             U5803.001.xxxxxx-P2-C7-T1-W5005076xxxxxxxxx-L1000000000000  IBM 3584 Library Medium Changer (FCP)
        Serial Number...............xxx
  ...
# lscfg -vpl rmt* | egrep "rmt|Serial"
  rmt0             U5803.001.xxx-P2-C7-T1-W5005076300000000-L0  IBM 3592 Tape Drive (FCP)
        Serial Number...............xxx

...

TSM Client - AIX filesets

# installp -agXYd. tivoli.tsm.client.api.32bit tivoli.tsm.client.api.64bit tivoli.tsm.client.ba.64bit.base tivoli.tsm.client.ba.64bit.common

...and the Web-based client (Java GUI)

# lslpp -lcq tivoli.tsm*
/usr/lib/objrepos:tivoli.tsm.client.api.32bit:6.2.2.3::COMMITTED:I:TSM Client - Application Programming Interface:
/usr/lib/objrepos:tivoli.tsm.client.api.64bit:6.2.2.3::COMMITTED:I:TSM Client - 64bit Application Programming Interface:
/usr/lib/objrepos:tivoli.tsm.client.ba.64bit.base:6.2.2.3::COMMITTED:I:TSM Client 64 - Backup/Archive Base Files:
/usr/lib/objrepos:tivoli.tsm.client.ba.64bit.common:6.2.2.3::COMMITTED:I:TSM Client 64 - Backup/Archive Common Files:

Migration from an older client version

# cp /usr/tivoli/tsm/client/ba/bin/dsm.opt /usr/tivoli/tsm/client/ba/bin64/dsm.opt
# cp /usr/tivoli/tsm/client/ba/bin/dsm.sys /usr/tivoli/tsm/client/ba/bin64/dsm.sys

Configuration files - AIX client

Adjust to a new server:

dsm.sys:

servername xxxx

...

TCPServeraddress x.x.x.x

dsm.opt:

SERVERNAME xxxx

Then connect to the server with dsmc and input the password once (applies to 'passwordaccess generate').