IBM Tivoli Storage Manager, Version 7.1

UPDATE DEVCLASS (Update a CENTERA device class)

Use the CENTERA device class when you are using EMC Centera storage devices. The CENTERA device type uses files as volumes to store data sequentially. It is similar to the FILE device class.

Privilege class

To issue this command, you must have system privilege or unrestricted storage privilege.

Syntax


>>-UPDate DEVclass--device_class_name--------------------------->

                                     (1)   
>--HLAddress--=--ip_address?PEA_file---------------------------->

>--+--------------------------+--------------------------------->
   '-MINCAPacity--=----size---'   

>--+---------------------------+-------------------------------><
   '-MOUNTLimit--=----number---'

Notes:

For each Centera device class, you must specify an IP address. However, a Pool Entry Authorization (PEA) file name and path are optional, and the PEA file specification must follow the IP address. Use the "?" character to separate the PEA file name and path from the IP address.

Parameters

device_class_name (Required)

Specifies the name of the device class to be updated. The maximum length of the device class name is 30 characters.

HLAddress

Specifies an IP address for the Centera storage device and, optionally, the name and path of one Pool Entry Authorization (PEA) file. Specify the IP address with the dotted decimal format (for example, 9.10.111.222). A Centera device might have multiple IP addresses. However, you must specify one of them as a value for this parameter.

AIX operating systems HP-UX operating systems Sun Solaris operating systems The PEA file name and path name are case-sensitive.

If you append the name and path of a PEA file, ensure that the file is stored in a directory on the system that runs the Tivoli® Storage Manager server. Separate the PEA file name and path from the IP address or addresses with the "?" character, for example:

Windows operating systems

   HLADDRESS=9.10.111.222?c:\controlFiles\TSM.PEA

   HLADDRESS=9.10.111.222?/user/ControlFiles/TSM.PEA

Specify only one PEA file name and path for each device class definition. If you specify two different Centera device classes that point to the same Centera storage device and if the device class definitions contain different PEA file names and paths, the Tivoli Storage Manager server uses the PEA file that is specified in the device class HLADDRESS parameter that was first used to open the Centera storage device.

Note:

The Tivoli Storage Manager server does not include a PEA file during installation. If you do not create a PEA file, the Tivoli Storage Manager server uses the Centera default profile, which can allow applications to read, write, delete, purge, and query data on a Centera storage device. To provide tighter control, create a PEA file with the command-line interface that is provided by EMC Centera. For details about Centera authentication and authorization, refer to the EMC Centera Programmer's Guide.
You can also specify the PEA file name and path in an environment variable by using the syntax CENTERA_PEA_LOCATION=filePath_ fileName. The PEA file name and path that is specified with this environment variable apply to all Centera clusters. If you use this variable, you do not need to specify the PEA file name and path using the HLADDRESS parameter.
Updating the device class with a new or changed PEA file name and location might require a server restart if the Centera storage device identified by the IP address has already been accessed in the current instance of the Tivoli Storage Manager server.

MINCAPacity

Specifies the new minimum size for Centera volumes that are assigned to a storage pool in this device class. This value represents the minimum amount of data that is stored on a Centera volume before the Tivoli Storage Manager server marks it full. Centera volumes continue to accept data until the minimum amount of data is stored. This parameter is optional.

size: Specify this value as an integer followed by K (kilobytes), M (megabytes), G (gigabytes), or T (terabytes). The minimum value that is allowed is 1 MB (MINCAPACITY=1M). The maximum value that is allowed is 128 GB (MINCAPacity=128G).

MOUNTLimit

Specifies the new maximum number of sessions that access the Centera device. This parameter is optional. You can specify any number from 0 or greater; however, the sum of all mount limit values for all device classes that are assigned to the same Centera device must not exceed the maximum number of sessions that are allowed by Centera.

Feedback