DEVICE_CLASS parameters for dynamic target allocation

The parameters that are defined in the device class section of the Tivoli® Storage FlashCopy® Manager profile file, configure Tivoli Storage FlashCopy Manager for use with IBM® Storwize® family or IBM System Storage® SAN Volume Controller storage systems.

CLONE_DATABASE

This parameter is preset by the setup script. If you use the setup script for configuration, it is not necessary to manually update any parameters. The following list identifies the possible options:

YES: Use the device class for cloning. When the parameter is set to YES, the device class is unavailable for non-cloning backup or restore operations. The device class is ignored during backup expiration and reconciliation processing.
NO: Do not use the device class for cloning. When the parameter is set to NO, any cloning request fails with an error message and return code 2.

Default: This parameter is not explicitly set. The setup script sets the value, depending on if the device class is specified in the CLIENT or CLONING section.

Advanced mode only: No

COPYSERVICES_HARDWARE_TYPE

This parameter is required. Only one device can be specified.

SVCDTA: Specify the SVCDTA option when the storage system is SAN Volume Controller or Storwize family and you require the target volumes to be dynamically allocated during the backup process.

Default: None

Advanced mode only: No

COPYSERVICES_SERVERNAME

Defines the TCP/IP host name of the storage system where the application data to protect is allocated.

Default: None

Advanced mode only: No

COPYSERVICES_USERNAME

Identifies the user name. Specify the user name that is used to log on to the SAN Volume Controller cluster. For Storwize family, specify the Storwize family user name.

Default: superuser

Advanced mode only: No

SVC_SSHKEY_FULLPATH

Specifies the path and the file name to the private SSH key file. The key file is used to authenticate to the storage system with the user name specified for the COPYSERVICES_USERNAME parameter.

Default: $HOME/.ssh/svc_sshkey

Advanced mode only: Yes

SSH_DIR

Specifies the path to the Secure Shell protocols and executable files.

Default: /usr/bin

Advanced mode only: Yes

SVC_COPY_RATE

Specifies the priority that the storage system gives to the FlashCopy background process for the current backup or restore operation. Enter a value from the range 1 - 100.

The SVC_COPY_RATE parameter only applies for full copy backups (FLASHCOPY_TYPE COPY). For space-efficient backups (FLASHCOPY_TYPE NOCOPY), the copy rate is implicitly set to 0.

Default: 0

Advanced mode only: Yes

STORAGE_SYSTEM_ID

The STORAGE_SYSTEM_ID parameter refers to the storage system Cluster ID.

Default: None

Advanced mode only: Yes

FLASHCOPY_TYPE

Specifies whether the storage solution does a bit-level copy of data from one logical volume to another. This parameter applies to any FlashCopy storage system. The following options are available:

COPY

Directs the storage system to run a bit-level copy of the data from one physical volume to another. Specify this value when the following conditions are true:

A fast snapshot restore of a backed-up database is required.
A complete copy of the database data on the target volume is required.

NOCOPY

Directs the storage system to run a bit-level copy of a track if the data is modified after the initial FlashCopy request. This technique is typically referred as copy-on-write. Specify this value when the following conditions are true:

A complete copy of the source volumes that contain the database files is not required on the target volumes.
A fast snapshot restore of a backed-up database is required.
Backup time constraints are a concern.

Default: NOCOPY

Advanced mode only: No

ALLOW_NOCOPY_FLASHCOPY

Use this parameter with the CLONE_DATABASE parameter. The following list identifies the possible options:

YES: Create a Tivoli Storage FlashCopy Manager clone on space-efficient targets. For this device class, use space-efficient targets and set FLASHCOPY_TYPE to NOCOPY. FlashCopy backups cannot be stored on the same source volumes.
NO: Do not create a Tivoli Storage FlashCopy Manager clone on space-efficient targets. If both backup and cloning must be completed on the same source volumes, cloning is completed to full targets and the ALLOW_NOCOPY_FLASHCOPY parameter is set to NO.

Default: NO

Advanced mode only: Yes

SVC_GRAIN_SIZE

Specifies the grain size, in KB, for FlashCopy mapping for space-efficient virtual disks on SAN Volume Controller or Storwize family. The grain size of the space-efficient virtual disk must match the grain size of the FlashCopy. The options for this parameter are 64, and 256.

After the parameter is set, the value cannot be changed until the backup is deleted with the option -F to remove the mappings.

Note: When you are migrating from the SVC adapter with static target allocation, you must ensure that the grain size for the new SVCDTA device classes is set to the same value as it was for the device classes for SVC.

Default: 256

Advanced mode only: Yes

SVC_POOLNAME

This parameter specifies the name of the storage pool that is used to create target volumes for the FlashCopy backups, and creates consistency groups and the FlashCopy map for restore operations.

Default: Name of the storage pool on the source volume where the FlashCopy relationship is established.

Advanced mode only: Yes

SVC_IOGROUP

Specifies the name of the input and output (IO) group, which is used to create target volumes for the FlashCopy backups.

Default: Name of the IO group on the source volume where the FlashCopy relationship is established.

Advanced mode only: Yes

SVC_MOUNT_POOLNAME

Specifies the name of the storage pool that is used to create temporary duplicates of the target volumes of a FlashCopy backup, which then mounts to a host.

Default: Name of the storage pool on the target volume that is used to create duplicate volumes for the mount operation.

Advanced mode only: Yes

SVC_MOUNT_IOGROUP

Specifies the name of the IO group, which is used to create duplicate volumes for the mount operation.

Default: Name of the IO group on the target volume that is used to create duplicate volume for the mount operation.

Advanced mode only: Yes

SVC_TARGET_VOLUME_REAL_SIZE

Specify the percentage of the source volume size to allocate, which is used to create the actual target volumes during the backup operation.

The SVC_TARGET_VOLUME_REAL_SIZE parameter only applies to FLASHCOPY_TYPE NOCOPY

Default: 10

Advanced mode only: Yes

RECON_INTERVAL

This parameter specifies the interval, in hours, between two subsequent reconciliation operations. The options are whole numbers between 0 and 24 inclusive.

Default: 12

Advanced mode only: Yes