Decommissioning a client node

If a client node is no longer required, you can start a process to remove it from the production environment. For example, if a workstation was backing up data to a Tivoli Storage Manager server, but the workstation is no longer used, you can decommission the workstation.

About this task

When you start the decommission process, the server locks the client node to prevent it from accessing the server. Files that belong to the client node are gradually deleted, and then the client node is deleted. You can decommission the following types of client nodes:

Application client nodes

Application client nodes include email servers, databases, and other applications. For example, any of the following applications can be an application client node:

FlashCopy Manager
Tivoli® Storage Manager for Databases
Tivoli Storage Manager for Enterprise Resource Planning
Tivoli Storage Manager for Mail
Tivoli Storage Manager for Virtual Environments

System client nodes

System client nodes include workstations, network-attached storage (NAS) file servers, and API clients.

Virtual machine client nodes

Virtual machine client nodes consist of an individual guest host within a hypervisor. Each virtual machine is represented as a Tivoli Storage Manager file space.

The simplest method for decommissioning a client node is to use the Operations Center. The decommission process runs in the background. If the client is configured to replicate client data, the Operations Center automatically removes the client from replication on the source and target replication servers before it decommissions the client.

Tip: Alternatively, you can decommission a client node by issuing the DECOMMISSION NODE or DECOMMISSION VM command. You might want to use this method in the following cases:

To schedule the decommission process for the future or to run a series of commands by using a script, specify the decommission process to run in the background.
To monitor the decommission process for debugging purposes, specify the decommission process to run in the foreground. If you run the process in the foreground, you must wait for the process to be completed before you continue with other tasks.

Procedure

Take one of the following actions:

To decommission a client in the background by using the Operations Center, complete the following steps:
1. On the Operations Center Overview page, click Clients and select the client.
2. Click More > Decommission.
To decommission a client node by using an administrative command, take one of the following actions:
- To decommission an application or system client node in the background, issue the DECOMMISSION NODE command. For example, if the client node is named AUSTIN, issue the following command:
```
decommission node austin
```
- To decommission an application or system client node in the foreground, issue the DECOMMISSION NODE command and specify the wait=yes parameter. For example, if the client node is named AUSTIN, issue the following command:
```
decommission node austin wait=yes
```
- To decommission a virtual machine in the background, issue the DECOMMISSION VM command. For example, if the virtual machine is named AUSTIN, the file space is 7, and the file space name is specified by the file space ID, issue the following command:
```
decommission vm austin 7 nametype=fsid
```
- To decommission a virtual machine in the foreground, issue the DECOMMISSION VM command and specify the wait=yes parameter. For example, issue the following command:
```
decommission vm austin 7 nametype=fsid wait=yes
```