Tivoli Storage Manager for AIX: Managed System for SAN Storage Agent User's Guide
Figure 5 shows the results of completing Step 2. Client System and Step 3. Server.
- Note:
- This figure does not include all the required options. Steps 2 and 3
provide more details.
Figure 5. Communications information. Results of Steps 2 and 3. The passwords are shown as "xxxxxxx" because they are encrypted in the file.
Do the following on the client system:
- Install or upgrade to the latest level of the client software and the TSM
API software.
- Install the storage agent software.
- Check that the client system meets the prerequisites for client
software. See the applicable documentation. Install the client
software if it is not already installed on the system, or upgrade the software
to the latest level as necessary. You can ensure this by checking http://www.tivoli.com/support/storage_mgr/tivolimain.html.
If there is a more recent package, you will want to download and
install. See step 3 for the install instructions.
- Modify the TSM options file (dsm.sys).
For information about the dsm.opt and dsm.sys files, see
Tivoli Storage Manager Installing the Clients.
- Edit the dsm.sys file to specify the communications method between
the TSM client and server. You should see the following:
commmethod tcpip
tcpserveraddress garden.tucson.tivoli.com
tcpport 1501
and
commmethod sharedmem
shmport 1511
- If you specified the TCP/IP communication method, edit the dsm.opt
file to name the server specified in the communication method. For
example,
servername garden
-
Specify that you want the client to use SAN-attached devices during backup,
restore, archive, and retrieve processing, if the path to the SAN devices is
available. Activate the following options in the dsm.sys
file:
enablelanfree yes
LANFREECommethod TCPIP
LANFREETCPPort 1501
and
LANFREECommethod SharedMem
LANFREESHMPORT 1511
-
Update the API software to the latest level by following the procedure
described below or install the latest client.
- Note:
- Ensure that the client is already installed.
- Create the Tivoli Storage Manager API option files
- Copy APIINSTALLPATH/dsm.sys.smp to dsm.sys if your
system has not been set up to use Tivoli Storage Manager.
- Edit the dsm.sys file to include the Tivoli Storage Manager server
to which you want to connect. For example:
SErvername server_a
COMMmethod TCPip
TCPPort 1500
TCPServeraddress server_a.domain.company.COM
It is assumed that the dsm.sys file is controlled by the system
administrator. The Tivoli Storage Manager server administrator should
supply the name and IP address of the Tivoli Storage Manager server, as well
as the node name and password.
- Set up the environment variables. The BASE API uses unique
environment variables to locate files.
- DSMI_CONFIG is the fully qualified name for the client user option
file.
- DSMI_DIR points to the path containing dsm.sys, dsmtca, and the
subdirectory en_US.
- en_US subdirectory must contain dsmclientV3.cat.
- DSMI_LOG points to the path for the dsierror.log file
The following are examples on how to set up these environment
variables.
export DSMI_CONFIG=APIINSTALLPATH/dsm.opt
export DSMI_DIR=APIINSTALLPATH
export DSMI_LOG=/home/user_a/logdir
- Note:
- The quickest way to set these is to add these variables to the user's
.profile file.
- Using shared memory.
The Tivoli Storage Manager API client user must be logged in as root or
have the same user ID as the process running the Tivoli Storage Manager
server.
|
- |Note:
- It is recommended that the Storage Agent not be installed on the same machine
|as the Tivoli Storage Manager Server.
|
On the same system as the client, install the storage agent. The
default installation directory is
/usr/tivoli/tsm/StorageAgent/bin.
The instructions in this section are shown using the Software Management
and Installation Tool (SMIT). You can also use the Install and Update
Software Manager (installm).
- Note:
- Throughout this procedure, /dev/cd0 is used for
CD-ROM. This may be different in your environment. Loading the
server files can take several minutes.
Here is the SMIT procedure:
- Gather the following information:
- Storage agent: Name and password for the storage
agent. The name and password must be the same as the name and password
that is used to define the storage agent as a server to the TSM server.
For example:
- Name: IRIS
- Password: jonquil
- TCP/IP address: arbor.tucson.tivoli.com
- TSM server: Information about the TSM server with which
the storage agent will communicate. This is the same TSM server with
which the client communicates. For example:
- Name: GARDEN
- Password: botanical
- TCP/IP address: garden.tucson.tivoli.com
- TCP/IP port: 1500
- Log in as the root user.
- Load the Storage Agent CD-ROM into the selected drive.
- From your desktop window, access SMIT and make selections according to the
level of your AIX operating system.
Enter:
+--------------------------------------------------------------------------------+
|smit install_update & |
+--------------------------------------------------------------------------------+
For AIX 4.3, select:
+--------------------------------------------------------------------------------+
|Install and Update Software |
| Install and Update from the LATEST Available Software |
+--------------------------------------------------------------------------------+
For AIX 5.1, select:
+--------------------------------------------------------------------------------+
|Install Software |
| Install Software |
+--------------------------------------------------------------------------------+
- On the next window, select the device that you are using for
the installation. You can enter the drive name in the window or click
on List to access the device list.
If you click on List, select the CD-ROM drive that you are using
for the installation (for example, /dev/cd0).
- Click on OK.
- Locate the line Software to Install.
- To install all components listed in the table at step 8, continue at step 10.
- To selectively install components, click on List for the latest
available software packages and continue at step 8.
- Select the component that you require. The following table
lists the component fileset file names.
Table 2. Package and Fileset Names for Installation
AIX 4.3.3 Platforms
|
Package Name
| Fileset Names
| Description
|
tivoli.tsm.StorageAgent.rte
| tivoli.tsm.StorageAgent.rte
| StorageAgent common functions, examples
|
tivoli.tsm.devices.aix43.rte
| tivoli.tsm.devices.aix43.rte
| SCSI runtime device support
|
tivoli.tsm.msg.en_US.devices
| tivoli.tsm.msg.en_US.devices
| SMIT screens
|
tivoli.tsm.msg.en_US.server
| tivoli.tsm.msg.en_US.server
| Message catalog and Online help
|
Table 3. Package and Fileset Names for Installation
AIX 5.1 Platforms
|
Package Name
| Fileset Names
| Description
|
tivoli.tsm.StorageAgent.rte
| tivoli.tsm.StorageAgent.rte
| StorageAgent common functions, examples
|
tivoli.tsm.devices.aix5.rte64
| tivoli.tsm.devices.aix5.rte64
| SCSI runtime device support
|
tivoli.tsm.msg.en_US.devices
| tivoli.tsm.msg.en_US.devices
| SMIT screens
|
tivoli.tsm.msg.en_US.server
| tivoli.tsm.msg.en_US.server
| Message catalog and Online help
|
- Click OK.
- Check the default settings for the options on this window.
- Click OK.
SMIT responds:
+--------------------------------------------------------------------------------+
|ARE YOU SURE?... |
+--------------------------------------------------------------------------------+
- Click OK.
This installation may take several minutes.
- Click Done after the installation is complete, remove the CD,
and exit from SMIT.
- Ensure that a device configuration file exists and that the matching
DEVCONFIG option is in the dsmsta.opt file. For example, for a
device configuration file named devconfig located at
/usr/tivoli/tsm/StorageAgent/bin, edit the dsmsta.opt file
and enter the following line:
DEVCONFIG devconfig
- Use the information that you collected in step 1 to issue the DSMSTA SETSTORAGESERVER command. For
example:
dsmsta setstorageserver myname=iris mypassword=jonquil
myhladdress=arbor.tucson.tivoli.com
servername=garden serverpassword=botanical
hladdress=garden.tucson.tivoli.com lladdress=1500
See Set Installation Data for the Storage Agent: DSMSTA SETSTORAGESERVER for the details on the command parameters.
The command generates the following lines in the device configuration file
for the storage agent:
+--------------------------------------------------------------------------------+
|set staname iris |
|SET STAPASSWORD xxxxxxx |
|SET STAHLADDRESS arbor.tucson.tivoli.com |
|DEFINE SERVER garden serverpassword=xxxxxxxxxxx |
| HLADDRESS=garden.tucson.tivoli.com LLADDRESS=1500 |
| |
+--------------------------------------------------------------------------------+
The passwords (shown here as xxxxxxxx) are encrypted in the
file.
The command also generates the following line in the dsmsta.opt
file:
+--------------------------------------------------------------------------------+
|SERVERNAME garden |
+--------------------------------------------------------------------------------+
See The Storage Agent Options File and The Device Configuration File for the Storage Agent for details on these files.
- Note:
- The TSM server console (Microsoft Management Console, MMC) provides a snapin
that contains a storage agent configuration wizard. This wizard
performs all of the manual steps listed here and allows you to skip to step
4. For additional information, see the TSM server console online
help.
The following is an overview of the steps that you need to do on the TSM
server. For details, see Administrator's Guide.
On the server, do the following:
- Configure the SAN drives. This involves the following steps:
Tape Device
- Define a shared SCSI or 3494 library
- Define drives that are associated with the library
- Define the device class
- Define the storage pool
Disk Device
Configure Enterprise Management and define a device class of DEVTYPE=FILE and
SHARED=YES. TSM automatically defines a new FILE library and also
defines drives corresponding to the mount limit for the FILE device
class. The FILE library name is the same as the device class
name. Each drive uses the library name with a numeric suffix. If
the mount limit is changed, the number of drives also changes.
- Note:
- The mount limit should correspond to the number of concurrent backups you
expect, as each session gets exclusive access to a file volume.
- For each client for which you want to enable SAN data transfer, define the
client's storage agent as if it was a server. You must use the
same name and password that you set for the storage agent when you installed
it on the client system. The DEFINE SERVER command must be issued from
the server (library manager or library client) that will manage the
client's data. For example:
define server iris serverpassword=jonquil
hladdress=sanclient.tucson.tivoli.com lladdress=1500
- Modify policy for the client so that the storage agent acting on behalf of
the client uses the drives on the SAN. The client must use a management
class that has copy groups with a destination storage pool. The
destination storage pool must be associated with the library on the SAN for
which you have mapped drives for the client. See
Administrator's Guide for details on changing policy for
clients that can use SAN drives. For example, do the following:
- Create a policy domain for clients that will use the SAN devices for
direct data transfer.
- Create a policy set in that domain.
- In the default management class for that policy set, modify the copy
groups. Set the destination storage pool to the storage pool associated
with the SAN drives that you configured and mapped for the client.
- Note:
- If you decide not to use the default management class for the SAN drives, you
will need to create a new management class. Clients that want to use
the SAN drives need to update the include-exclude list to specify the new
management class. See Tivoli Storage Manager Installing the
Clients for details on the include-exclude list.
- Activate the policy set.
- Register or update the client nodes so that they are in the new policy
domain.
See Administrator's Reference for details on the
commands.
To review the expected results of the steps that you have just completed,
see Figure 5.
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]