For the following example, an Exabyte EXB-210 library containing two drives is attached to the server system. The example takes you through the steps necessary to get TSM to use the devices in the library for storing client data.
You can use this example as a guide when configuring other automated tape devices. This example presents the procedure with a minimum of customization. If you want to do more, see the references in the steps.
Note: | Each tape autochanger that you attach for TSM use must be on its own SCSI adapter card. |
Note: | In some automated libraries, the drives and the autochanger share a single SCSI ID, but have different LUNs. For these libraries, only a single SCSI ID is required. Check the documentation for your device. |
Attention: Each device connected in a chain to a single SCSI bus must be set to a unique SCSI ID. If each device does not have a unique SCSI ID, you may have serious system problems.
Attention:
Record the special file names for the library and its drives on the device worksheet. The names are needed to define the library and drives to TSM.
You created the special file names for the library when you configured a SCSI pass-through driver for it. The operating system automatically assigns the special file names for the drives. If you do not remember the names, you can use SAM or the ioscan command.
Keep the Worksheets: | The information you record on the worksheets can help you when you need to perform operations such as adding volumes to an autochanger. Keep them for future reference. |
define library auto8mmlib libtype=scsi device=/dev/tsm/library
For automated libraries, the library type is always SCSI. The DEVICE parameter gives the device driver's name for the library, which is the special file name. See step 6.
See also Defining Libraries and SCSI Libraries.
define drive auto8mmlib drive1m device=/dev/rmt/1m element=82
define drive auto8mmlib drive2m device=/dev/rmt/2m element=83
Both drives belong to the AUTO8MMLIB library. The DEVICE parameter gives the device driver's name for the drive. In this example, each drive is given a TSM name that connects it with the device special file name. See step 6 for determining the device driver's name for the drive.
Element Address: The element address is a number that indicates the physical location of a drive within an automated library. TSM needs the element address to connect the physical location of the drive to the drive's SCSI address. When you define a drive, the element address is required if more than one drive is in an automated library. The element numbers are taken from the device worksheet filled out in step 6.
See Defining Drives.
define devclass auto8mm_class devtype=generictape library=auto8mmlib
Key Choice: The default mount limit value is DRIVES. The DRIVES parameter indicates that every time a mount point is allocated, the number of drives online and defined to the library is used to calculate the true mount limit value. The maximum value for this parameter is 256 and the minimum value is 0. A zero value prevents new transactions from gaining access to the storage pool.
See Defining and Updating Device Classes for Sequential Media.
query library
query drive
query devclass
See Requesting Information about Libraries, Requesting Information about Drives, and Requesting Information about a Device Class.
define stgpool auto8mm_pool auto8mm_class maxscratch=20
Key Choices:
For more information, see Defining or Updating Primary Storage Pools.
You can do one of the following to update TSM policy:
The following steps assume that you are modifying the standard, IBM-supplied policy objects, named STANDARD, to allow clients to back up data directly to tape. However, if you want some clients to back up directly to tape and some to disk, keep the standard policy as is. For the clients that need to back up directly to tape, define new policy (policy domain, management class, copy groups) and assign these clients to the new policy domain. For details on the standard policy, see Using the Standard Policy. For how to define new policy, see Creating Your Own Policies.
You can choose to have clients back up directly to the new tape storage pool that you defined.
Key choice: | If you back up directly to tape, the number of clients that can back up data at the same time is equal to the number of drives available to the storage pool (through the mount limit of the device class). If you have only one drive, only one client at a time can back up data. |
Performance of tape drives is often lower when backing up directly to tape than when backing up to disk and then migrating to tape. Backing up data directly to tape usually means more starting and stopping of the tape drive. Backing up to disk then migrating to tape usually means the tape drive moves more continuously, meaning better performance.
update copygroup standard standard standard type=backup destination=auto8mm_pool
Note: | You may want clients in the STANDARD policy domain to be able to choose whether to back up directly to disk or to tape. If so, instead of updating the copy group in the STANDARD management class, you can define a new management class and a new copy group in the STANDARD domain. See Defining and Updating a Backup Copy Group. |
activate policyset standard standard
You can have clients back up data to disk storage, then let TSM migrate the data to the new tape storage pool when the amount of disk storage used reaches the migration threshold. For example, you can have data migrate from the default disk storage pool, BACKUPPOOL, to the new storage pool, AUTO8MM_POOL, by using the following command:
update stgpool backuppool nextstgpool=auto8mm_pool
If you have not changed the defaults for BACKUPPOOL, TSM will migrate data from this disk pool to the AUTO8MM_POOL when the disk pool is 90% full. See Defining or Updating Primary Storage Pools.
If you updated the default STANDARD policy to use the new storage pool as a destination for backups from clients, the clients must be registered to that policy domain. To register a client named ASTRO to the STANDARD policy domain and assign the client the password CADET, enter this command:
register node astro cadet
You do not need to specify a policy domain because the STANDARD policy domain is the default.
For information on options when registering clients, see Registering Nodes with the Server.
To ensure that enough volumes are available to TSM in the library:
label libvolume auto8mmlib search=yes labelsource=barcode overwrite=no checkin=scratch