Name
[Windows Manager]
Installation_folder\SVROR\Manager\bin\convertVMtoLServer - Linking virtual PCs with virtual L-Servers
Format
convertVMtoLServer -exportfile folder [-fixfilename] convertVMtoLServer -file file.csv convertVMtoLServer -createxml
Description
convertVMtoLServer is the command used to perform batch linking of configured virtual PCs with virtual L-Servers and batch creation of XML files for changing the network.
Options
Use this option to automatically create the CSV configuration file to be specified for the -file option.
For folder, specify the folder for storing the CSV configuration file using an absolute path.
For the folder name, specify a character string containing alphanumeric characters, underscores ("_"), hyphens ("-") and periods (".").
Paths containing single-byte spaces cannot be specified.
In all of the following VM hosts registered in the VM pool, all of the information of the virtual PCs that are not linked with virtual L-Servers is output to the CSV configuration file.
VMware
Hyper-V
XenServer
If -fixfilename is specified, the CSV configuration file will be named convertVMtoLserver.csv.
If the file already exists, it will be deleted and then re-created.
Use this option when periodically linking virtual PCs with L-Servers.
The CSV configuration file that is output will be named convertVMtoLserver.csv. If the file already exists, it will be deleted and then re-created.
Specify this option to perform batch linking of virtual PCs with virtual L-Servers and batch creation of XML files for changing the network.
For file.csv, specify the CSV configuration file containing the definitions of the information regarding the virtual PCs that are already configured in the following VM hosts registered in the VM pool of Resource Orchestrator.
VMware
Hyper-V
XenServer
The CSV configuration file can be created automatically by executing the command with the -exportfile option specified.
If the information of virtual PCs that you want to exclude from the operation target is contained in the CSV configuration file to be output using the -exportfile option, delete the lines corresponding to those virtual PCs from the CSV configuration file.
Alphanumeric characters, underscores ("_"), and hyphens ("-") can be used in the file name of the CSV configuration file.
In addition, the extension of the CSV configuration file must be "csv".
For the virtual L-Servers that are successfully linked, the XML files for changing the network are output to the storage directory of the XML files for changing the network. If XML files for changing the network that have the same names as the XML files to be output already exist, the existing files will be overwritten.
See
Refer to "A.4 XML Files for Changing the Network" for details.
Specify this option to create XML files for changing the network.
Specify in the following cases:
When linking virtual PCs with virtual L-Servers was performed using the -file option but the XML files for changing the network were not created
When re-creation of the XML files for changing the network is necessary because the definition files for configuring the operation and quarantine networks were modified due to modification of or addition to the network change settings for virtual L-Servers
It is necessary to create the definition files for configuring the operation and quarantine networks beforehand.
See
For details, refer to "2.5.5 Definition File for Configuring the Business and Quarantine Networks".
Note
When multiple NICs have been connected to a virtual PC, it is necessary to generate the XML files for changing the network manually.
Refer to "A.4 XML Files for Changing the Network".
CSV Configuration Files
The format of the file is as follows.
If the CSV configuration file has been created using the -exportfile option, only the first line and the VMGuestName values in the subsequent lines are output.
CSV configuration files are named using the following format and stored in folder.
If -fixfilename is specified
convertVMtoLserver.csv
If -fixfilename is not specified
convertVMtoLserver_yyyymmddhhmmss.csv
yyyymmddhhmmss is the date and time when the CSV configuration file was created.
In the first line, specify the definition of the names of the configuration items. The first line cannot be omitted.
VMGuestName,Label,Comment,FolderName
In the second and later lines, specify the data.
Specify configuration values in the order of the configuration item names defined in the first line, separated by commas.
Specify the names of the virtual PCs to link to L-Servers. Specify using full paths. Use slashes ("/") to connect the names of the resource pool and the VM host of each virtual PC.
For each virtual PC name, enter a string beginning with an alphanumeric character, and containing up to 64 alphanumeric characters, underscores ("_") and hyphens ("-"). Both upper and lower case letters can be used.
Virtual PC names containing periods (".") are not supported.
Example
/Resource_pool_name/VM_host_name/Virtual_PC_name
Note
For resource pool names, specify the names of VM pools that have been created under the orchestration tree.
Optional.
Enter a string of up to 32 alphanumeric characters (Both double-byte and single-byte characters can be used).
Optional.
Enter a string of up to 256 alphanumeric characters (Both double-byte and single-byte characters can be used).
Optional.
For the folder name, enter a string beginning with an alphanumeric character, and containing up to 32 alphanumeric characters, underscores ("_") and hyphens ("-"). Both upper and lower case letters can be used.
Specify this item when grouping the resources of a virtual L-Server. When specifying FolderName, it is necessary to create the corresponding resource folder under the orchestration tree on the ROR [Resource] tab in advance.
For details, refer to "21.2 Creating" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".
For a hierarchized resource folder, specify the folder name using slashes ("/").
If omitted, the configuration file is placed in the home folder.
Example
Example of the CSV Configuration File
VMGuestName,Label,Comment,FolderName /VMHostPool/192.168.24.138/test1 /VMHostPool/192.168.24.138/test2,, /VMHostPool/192.168.24.138/test3,,,FolderA
Point
The relationships between virtual PC names and resources can be confirmed using the following command.
> rcxadm pool list -name /VMHostPool -resource -info lserver <RETURN>For details on this command, refer to "3.10 rcxadm pool" in the "Reference Guide (Command/XML)".
CSV Results Files
The format of the CSV results files is as follows.
The same location as the storage folder for CSV configuration files.
convertVMtoLserver_yyyymmddhhmmss_result.csv
yyyymmddhhmmss is the date and time when the CSV configuration file was created.
If -fixfilename is specified, the CSV results file will be named convertVMtoLserver_result.csv.
The details configured in the CSV configuration file are displayed as is.
The details configured in the CSV configuration file are displayed as is.
The details configured in the CSV configuration file are displayed as is.
The details configured in the CSV configuration file are displayed as is.
The post-execution status of the loading operation for each VM is displayed.
"OK" indicates that loading was successful, while "NG" indicates failure.
Error messages generated after failed operations are displayed.
Example
Output Example of the CSV Results File
VMGuestName,Label,Comment,FolderName,Result,Note /VMHostPool/192.168.24.138/test1,,,FolderA,NG,FJSVrcx:ERROR:67280:test1:convert not supported. (already in use) /VMHostPool/192.168.24.138/test2,,,FolderA,NG,FJSVrcx:ERROR:67280:test2:convert not supported. (already in use) /VMHostPool/192.168.24.138/ls-test,,,,NG,FJSVrcx:ERROR:69133:operation not possible because power is OFF /VMHostPool/192.168.24.138/test3,,,,OK, /VMHostPool/192.168.24.138/test4,,,,OK, /VMHostPool/192.168.24.138/test5,,,,OK, /VMHostPool/192.168.24.138/test6,,,,OK, /VMHostPool/192.168.24.138/test7,,,,OK, /VMHostPool/192.168.24.138/test8,,,,OK, /VMHostPool/192.168.24.138/test9,,,,OK, /VMHostPool/192.168.24.138/test10,,,,OK,
Requirements
OS administrator
Admin server
Usage Example
> convertVMtoLServer -file D:\convert_test\vm_test1.csv <RETURN>
VmGuest Convert Start
VmGuest:test3 is converting
VmGuest:test4 is converting
VmGuest:test3 convert completed
VmGuest:test4 convert completed
VmGuest Convert EndExit Status
This command returns the following values:
The command executed successfully.
An error has occurred.
Note
Specify the CSV configuration file name using an absolute path. If single-byte blank spaces are included in the specified path, the command cannot be executed.
Do not open the CSV results file during execution of the convertVMtoLServer command.