ETERNUS SF AdvancedCopy Manager Operator's Guide for Tape Backup Option 13.0 -Microsoft(R) Windows(R) 2000/Microsoft(R) Windows Sever(TM) 2003-, -Solaris-, -HP-UX-, -Linux-, -AIX-

Contents Index

Chapter 4 Settings Performed on the Tape Server before Start of Operation

This chapter explains the settings to be made on the Tape Server before starting the tape backup operation of AdvancedCopy Manager.

4.1 Setting a Device Class

This section explains how to set a device class.

Use a TSM command to set a device class. The device class represents the device type that TSM can use. TSM checks the device class to determine the types of the drive and tape to be used. Set the device class as shown below.
For details of the command, see the TSM manual "ETERNUS SF TSM Administrator's Reference".

tsm> define devclass <device class name> devtype=<device type> format=<format> library=<library name> <mount-related-option>

Example is as follows; Define device class DRIVECLASS1 with device type LTO and format drive for library LT160.

tsm> define devclass DRIVECLASS1 devtype=LTO format=drive library=LT160

• Device class name
  Specify any name that identifies the device class.
• Device type
  Specify the device type.
• Format
  Specify the format used to write to tape.
• Library name
  Specify the library name specified in the library definition.
• Mount-related option
  If necessary, specify an option to be used when a tape is mounted on the drive. (This may be omitted.) Major options are as follows:
  • mountlimit
    Specify the maximum number of drives that TSM can use concurrently (can mount tapes on the drives concurrently) in the tape library associated with the device class. For a tape library having two drives, specify "mountlimit=2." The default is 1 (TSM can use only one drive at a time).
  • mountretention
    Specify the time to be taken before TSM unmounts a tape after it was mounted. This function thus saves the time taken for mounting a tape if another mount request is issued for the same tape once mounted. The default is 60 minutes. If you want to unmount a tape immediately after it is used, specify "mountretention=0" (0 minutes).
  • mountwait
    If the time specified for this option elapses before a tape is actually mounted after TSM issues a mount request to the tape library, the mount request is returned with an error. The default is 60 minutes. You can use the default unless you have specific requirements for this time.

The device class can be checked with the following command.

tsm> query devclass format=detail

4.2 Setting a Storage Pool

This section explains how to set a storage pool.

Use a TSM command to set a storage pool. For details of the command, see the TSM manual "ETERNUS SF TSM Administrator's Reference".

4.2.1 Creating a storage pool

A storage pool is a logical area of the backup destination. By logically allocating tapes to a storage pool, data is backed up to media in the relevant storage pool. A storage pool can be created as follows.

tsm> define stgpool <pool name> <device class name> maxscratch=<maximum number of scratch volumes>

Example is as follows; Create storage pool POOL1, with up to 50 scratch volumes, in device class DRIVECLASS1.

tsm> define stgpool POOL1 DRIVECLASS1 maxscratch=50

• Pool name
  Specify any name that identifies the storage pool.
• Device class name
  Specify the device class name specified in the device class definition.
• Maximum number of scratch volumes
  Specify the maximum number of volumes that can be fetched as scratch volumes (tapes used for Scratch operation) into the storage pool.
  Specify 0 if you do not use scratch volumes.

4.2.2 Loading a Tape (CHECKIN)

This section explains tape loading. A TSM command is used to load a tape. For details of the command, see the TSM manual "ETERNUS SF TSM Administrator's Reference".

TSM refers to the loading of a tape to the tape library as CHECKIN. On the contrary, it refers to the unloading of a tape from the tape library as CHECKOUT.

A checked-in tape cannot be used immediately but must first be registered in a TSM storage pool using the "define volume" command for volume definition. However, a tape that is used as a scratch volume need not be registered. In addition, a tape that is newly checked in must be initialized (labeled).

4.2.2.1 Checking in a new tape

The "label libvolume" command performs tape initialization (labeling) and check-in simultaneously.
When a new tape is used, it must be labeled before use. Note that labeling a tape disables data if it has been left on the tape.

+Checking in tapes by labeling one by one

This method can be used when you want to check in specific tapes.
Before executing this command, enter tapes in the entry port of the library.

tsm> label libvolume <library name> <volume name> checkin=<scratch or private> overwrite=yes

Example is as follows; Check in and label volume DAT001 in library LT160 as scratch.

tsm> label libvolume LT160 DAT001 checkin=scratch overwrite=yes

• Specifying the "status=scratch" option checks in the tape volume as scratch.
• Specifying the "status=private" option checks in the tape volume as private. To use a private volume, volume definition is required.
• Always specify the "overwrite=yes" option. Failure to do so may cause labeling to fail.

The following command can be used to check the status of the "label libvolume" command.

tsm> query process

The following command can be used to check for tapes that have been checked into the library.

tsm> query libvolume format=detail

+Checking in all tapes together in the library

You can automatically check in all volumes in the library without specifying volume names. To do so, you can enter the "label libvolume" command with the "search=yes" option specified.

tsm> label libvolume <library name> search=yes labelsource=<barcode or prompt> checkin=<scratch or private> overwrite=yes

Example is as follows; Search library LT160, read volume names from the barcode labels, and check them in as scratch volumes.

tsm> label libvolume LT160 search=yes labelsource=barcode checkin=scratch overwrite=yes

• Specifying the "status=scratch" option checks in the tape volume as scratch.
• Specifying the "status=private" option checks in the tape volume as private. To use a private volume, volume definition is required.
• Specifying the "labelsource=barcode" option reads the barcode label and initializes (labels) the tape with the barcode label name thus read.
• Specifying the "labelsource=prompt" option enables you to enter a label name as necessary.
• Always specify the "overwrite=yes" option. Failure to do so may cause labeling to fail.
• If multiple tapes can be entered in the entry port of the library, the "search=bulk" option can be used to check in and label all the tapes in the entry port.
• "Labeling and check-in" handles tapes one by one even if the search option is specified. It does not check in multiple tapes simultaneously.

The following command can be used to check the status of the "label libvolume" command.

tsm> query process

The following command can be used to check for tapes that have been checked into the library.

tsm> query libvolume format=detail

4.2.2.2 Checking in an initialized tape

This section explains how to check in a tape that has already been initialized (labeled). The "checkin libvolume" command is used for this operation.

+Checking in tapes by labeling one by one

This method can be used when you want to check in specific tapes.
Before executing this command, enter tapes in the entry port of the library.

tsm > checkin libvolume <library name> <volume name> checkin=<scratch or private>

Example is as follows; Check in volume DAT001 in library LT160 as scratch.

tsm> checkin libvolume LT160 DAT001 checkin=scratch

• Specifying the "status=scratch" option checks in the tape volume as scratch.
• Specifying the "status=private" option checks in the tape volume as private. To use a private volume, volume definition is required. However, volume definition is not required for volumes that have been once used by TSM (volumes that are displayed by the "query volume" command).

The following command can be used to check the status of the "checkin libvolume" command.

tsm> query process

The following command can be used to check for tapes that have been checked into the library.

tsm> query libvolume format=detail

+Checking in all tapes together in the library

You can automatically check in all volumes in the library without specifying volume names. To do so, you can enter the "checkin libvolume" command with the "search=yes" option specified.

tsm> checkin libvolume <library name> status=<scratch or private> checklabel=<yes or barcode > search=yes

Example is as follows; Search library LT160, read volume names from the barcode labels, and check them in as scratch volumes.

tsm> checkin libvolume LT160 status=scratch checklabel=yes search=yes

• Specifying the "checklabel=yes" reads the label written to the tape and checks in the tape with the label name. "checklabel=yes" is the default value.
• Specifying the "checklabel=barcode" option reads the barcode label and checks in with the name thus read (a barcode reader is required).
• If multiple tapes can be entered in the entry port of the library, the "search=bulk" option can be used to check in all the tapes in the entry port.
• Check-in handles tapes one by one even if the search option is specified. It does not check in multiple tapes simultaneously.

The following command can be used to check the status of the "checkin libvolume" command.

tsm> query process

The following command can be used to check for tapes that have been checked into the library.

tsm> query libvolume format=detail

4.2.3 Registering a tape volume

When a tape that has been checked in as a private (a tape that has been checked in with the "status=private" option specified) is used, the tape must be registered in a storage pool.
Tapes that are used as scratch need not be registered.

tsm> define volume <storage pool name> <volume name>

Example is as follows; Register volume DAT001 in storage pool DAT-POOL.

tsm> define DAT-POOL DAT001

• Scratch volumes (volumes that have been checked in with the "status=scratch" option specified" need not be registered with the "define volume" command. TSM automatically registers volumes as necessary.

The following command can be used to check the status of the registered volume.

tsm> query volume <volume name> format=detail

The following command can be used to check the content of the registered volume.

tsm> query content <volume name> format=detail

4.2.4 Setting for simultaneous writing

This section explains the setting for simultaneous writing to the copy storage pool during backup. A TSM command is used for making this setting. Up to 10 copy storage pools can be specified.
Do the following to implement simultaneous writing to a copy storage pool by using an existing storage pool:

+Creating a copy storage pool

1. Create a copy storage pool.

   tsm> define stgpool <pool name> <device class name> pooltype=copy maxscratch=X

   Example is as follows; Define storage pool COPYPOOL with device class DEVC1.

   tsm> define stgpool COPYPOOL DEVC1 pooltype=copy maxscratch=50

    

2. Use the "define volume" command to define a volume in the copy storage pool.

   tsm> define volume <storage pool name> <volume name>

   Example is as follows; Define volume VOL001 in storage pool COPYPOOL.

   tsm> define volume COPYPOOL VOL001

+Defining the copy storage pool for a storage pool

1. Use the "update stgpool" command to define the copy storage pool for an existing storage pool.

   tsm> update stgpool <storage pool name> copystgpools=<copy storage pool name>

   Example is as follows; Define COPYPOOL as a copy storage pool.

   tsm> update stgpool POOL1 copystgpools=COPYPOOL copycontinue=yes

    

2. Use the following command to check the storage pool.

   tsm> query stgpool format=detail

Contents Index