Replacing a library

The following steps guide you through a procedure to replace your old tape library with a new tape library.

About this task

All of the tape cartridges must be moved from one library to a new library when you use this procedure. The procedure applies both to when you are moving the cartridges to a library of a new type, and when you are moving the cartridges to a library of the same type but with a different serial number.

The pool definitions in the old library are inherited by the new library.

Tape drives can be replaced by new tape drives.

Note: The procedure is not needed in cases where an IBM service representative replaces tape library parts for hardware maintenance, and sets the library serial number to the original serial number.

Procedure

Use the following command to get a list of all tape libraries in the IBM Storage Archive Enterprise Edition system, and their serial numbers. Identify the library name and serial number that you intend to replace, for use in the subsequent steps.
```
      # ltfsee_config –m LIST_LIBRARIES
```
If the tape drives from the old library will not be used in the new library, remove the tape drives by using the following command:
```
      # eeadm drive unassign <drive_serial> -l <library_name>
```
Stop IBM Storage Archive EE by using the following command:
```
      # eeadm cluster stop
```
Replace the physical old tape library with the new tape library.
Physically move all of the tape cartridges to the new library.
If you are moving the tape drives from the old tape library to the new library, physically remove the tape drives from the old tape library and install them in the new library.
The drives need to be attached to the same node that they were attached to before. If the drives were not removed in 2 of this library replacement procedure, the drive configurations are inherited by the new library. For more information, see Adding and removing tape drives.
Set the serial number of the new library in IBM Storage Archive EE by using the following command. The REPLACE_LIBRARY command associates the new library's serial number with the old library's ID.
```
      # ltfsee_config -m REPLACE_LIBRARY
```
In releases prior to IBM Storage Archive EE version 1.2.6, the serial number of a library was used as the library ID. Beginning with version 1.2.6, the library ID can have a unique value other than the serial number. A UUID is assigned as the library ID in libraries that are configured with version 1.2.6 and subsequent releases. With the separation of the library ID from the library serial number, IBM Storage Archive EE can replace a library by changing the library serial number that is associated with the library ID. The configuration of the cartridges, and pools, and drives in the old library is transferred to the new library.
Start IBM Storage Archive EE by using the following command:
```
      # eeadm cluster start
```
If you are using new drives in the new library, configure the drives with the eeadm drive assign command, as in the following example:
```
      # eeadm drive assign <drive_id> -n <node_id> 
```