2.10.1 Batch Loading Virtual PCs Using the convertVMtoLServer Command

This section explains the procedure for using the convertVMtoLServer command to batch load virtual PCs to virtual L-Servers.

Purpose

Execute this command to perform batch linking of virtual PCs with virtual L-Servers and batch creation of XML files for changing the network of virtual L-Servers.

Procedure

Execute the convertVMtoLServer command to create the CSV configuration file.
Execute the following command.
```
> convertVMtoLServer -exportfile Storage_folder_of_the_CSV_configuration_file <RETURN>
```
The CSV configuration file is created with the following name in the storage_folder_of_the_CSV_configuration_file.
convertVMtoLserver_yyyymmddhhmmss.csv
yyyymmddhhmmss is the date and time when the CSV configuration file was created.
Link the virtual PCs with virtual L-Servers and perform batch creation of the XML files for changing the network of virtual L-Servers.
Execute the following command. Specify the CSV configuration file created in step 1.
```
> convertVMtoLServer -file Storage_folder_of_the_CSV_configuration_file\convertVMtoLserver_yyyymmddhhmmss.csv <RETURN>
```

Information

In the following cases, edit the CSV configuration file created in step 1 before performing step 2.
- When you want to include comments or labels in the CSV configuration file
- When you want to use a folder structure to organize the resources of L-Servers
If the CSV configuration file created in step 1 contains the information of a virtual PC that you do not want to load, delete the line in the CSV file which corresponds to that virtual PC before performing step 2.

See

For details on the convertVMtoLServer command, refer to "4.2 convertVMtoLServer".

Confirmation of Results

Confirm the following:

View the CSV results file, and confirm that no error messages have been output.
After executing the command, a CSV results file is generated under the storage_folder_of_the_CSV_configuration_file, and the execution results and any error messages are output to it.
If there are any virtual PCs which could not be linked with L-Servers, refer to the information in the Note column to identify the cause of the error, and then perform the relevant "Appendix B Corrective Actions for Errors".
See
For details on the CSV results file, refer to "CSV Results Files".
Confirm that the network information of each linked virtual L-Server contains the IP address of the relevant virtual PC.
Select the virtual L-Server from the GUI (ROR console), and then select [Resource Details]-[Network Information].
Confirm that the relevant IP address and network resource name are shown in the corresponding columns in the displayed information.
If the information of the relevant virtual PC has not been obtained, refer to "B.2 When the IP Address of a Linked Virtual L-Server Is Not Displayed in the Network Information for the Virtual L-Server" and take the appropriate corrective action.
Confirm that the XML files for changing the network of the linked virtual L-Servers have been created.
Storage Location of the XML Files for Changing the Network
[Windows Manager]
Installation_folder\SVROR\Manager\etc\files\avmgr
Names of the XML Files for Changing the Network
quarantine_L-Server_name.xml
unquarantine_L-Server_name.xml
If the XML files for changing the network are not created automatically, refer to "B.3 When the XML Files for Changing the Network Have Not Been Created" and create them manually.

Note

Specify the CSV configuration file name using an absolute path.
If this command is executed again with the same CSV configuration file specified, the CSV results file output during the previous execution will be overwritten. To prevent the file being overwritten, back up previously output CSV results files.
Only virtual PCs that are powered on can be loaded to virtual L-Servers. If you attempt to load a virtual PC that is powered off to a virtual L-Server, the error message 69133 will be output. Power on the virtual PC, wait a couple of minutes, and then execute the command again.
If the convertVMtoLServer -exportfile command is executed, even if the attempt to link the virtual PC with a virtual L-Server of Resource Orchestrator fails, the information of the target virtual PC will be still be output to the CSV configuration file. However, if the convertVMtoLServer -file command is executed, the attempt to link the target virtual PC to a virtual L-Server will result in an error, and the error message 67154 will be output. Refer to "B.1 When Linking of Virtual PCs with Virtual L-Servers Fails", and perform corrective action for the relevant virtual PC.
If there are multiple VM guests which have the same name operating on the VM hosts registered in a VM pool, execution of the convertVMtoLServer -exportfile command will not result in an error. Instead, the same line describing the duplicated VM guest name will be output on multiple lines in the CSV configuration file. If this CSV configuration file is specified during execution of the convertVMtoLServer -file command, the attempt to link any duplicate VM guests after the first one to a virtual L-Server will result in an error, and the error message 67280 will be output. Take corrective action according to the details of error message 67280.
If the linking of a virtual PC with a virtual L-Server succeeds, but an error in the description of the definition file, etc. causes the creation of the XML files for changing the network to fail, resolve the cause of the error, and then use the convertVMtoLServer -createxml command to create the XML definition files for changing the network. For details, refer to "B.3 When the XML Files for Changing the Network Have Not Been Created".
When a virtual PC is configured with multiple NICs, refer to "A.4 XML Files for Changing the Network", and create XML files for changing the network that describe multiple NICs.