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.
- 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
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
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. |