RECOMMISSION VM (Recommission a virtual machine)

Use this command to recommission a virtual machine that was decommissioned by using the DECOMMISSION VM command.

The RECOMMISSION VM command resets the status of a virtual machine file space that was previously decommissioned from the production environment. After a decommissioned virtual machine is recommissioned, the decommissioned state and decommission timestamp for the file space that represents the virtual machine are reset.

Review the following considerations:
  • After the RECOMMISSION VM command runs, virtual machine data can be backed up to the server.
  • Any backup data that was deactivated during the DECOMMISSION VM operation will not be reactivated after the virtual machine is recommissioned. If active backup data is required, you must run an on-demand backup operation or schedule a backup operation to repopulate the active versions of the data.
  • When a virtual machine is recommissioned, client files are retained on the server according to your storage management policies.
  • A virtual machine that is recommissioned by using the RECOMMISSION VM command can subsequently be decommissioned by using the DECOMMISSION VM command.
  • After you recommission a virtual machine, you can verify that the virtual machine is no longer decommissioned by issuing the following command:
    query filespace format=detailed

Privilege class

To issue this command, you must have system privilege.

Syntax

Read syntax diagramSkip visual syntax diagramRECommission VMnode_namevm_name NAMEType=FSID

Parameters

node_name (Required)
Specifies the name of the data center node that hosts the virtual machine to be recommissioned.
vm_name (Required)

Identifies the file space that represents the virtual machine to be recommissioned. Each virtual machine that is hosted by a data center node is represented as a file space.

If the name includes one or more spaces, you must enclose the name in double quotation marks when you issue the command.

By default, the server interprets the file space name that you enter by using the server code page and also attempts to convert the file space name from the server code page to the UTF-8 code page. Conversion might fail if the string includes characters that are not available on the server code page, or if the server cannot access system conversion routines.

If the name of the virtual machine is a non-English-language name, this parameter must specify the file space ID (FSID). By specifying the NAMEType parameter, you can instruct the server to interpret the file space name by its FSID.

NAMEType
Specifies how the server interprets the file space name that you enter to identify the virtual machine. This parameter is useful when the server has clients with Unicode support. You can specify the following value:
FSID
The server interprets the file space name by its FSID.

Example: Recommission a virtual machine

Recommission the virtual machine vm62.

recommission vm dept06node vm62

Related commands

Table 1. Commands related to RECOMMISSION VM
Command Description
DECOMMISSION VM Decommissions a virtual machine.
DECOMMISSION NODE Decommissions an application or system.
QUERY FILESPACE Displays information about data in file spaces that belong to a client.
RECOMMISSION NODE Recommissions a decommissioned node.