4.2 convertVMtoLServer

convertVMtoLServer -exportfile folder [-fixfilename] [-setfolder] 
convertVMtoLServer -file file.csv 
convertVMtoLServer -createxml

-exportfile folder

Use this option 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.

-fixfilename

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.

-setfolder

Specify this when linking virtual PCs with each tenant.

For the output CSV configuration file, either the resource folder or the tenant that the VM host of the virtual PC belongs to is output as the FolderName where the L-Server is located.

-file file.csv

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

For details, refer to "A.4 XML Files for Changing the Network".

-createxml

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

For details, refer to "A.4 XML Files for Changing the Network".

Name of the CSV Configuration File

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

Format of the CSV Configuration File

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

VMGuestName

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.

Label

Optional.

Enter a string of up to 32 alphanumeric characters (Both double-byte and single-byte characters can be used).

Comment

Optional.

Enter a string of up to 256 alphanumeric characters (Both double-byte and single-byte characters can be used).

FolderName

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.

Storage Location of CSV Results Files

The same location as the storage folder for CSV configuration files.

Name of the CSV Results File

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.

Format of the CSV Results File

VMGuestName

The details configured in the CSV configuration file are displayed as is.

Label

The details configured in the CSV configuration file are displayed as is.

Comment

The details configured in the CSV configuration file are displayed as is.

FolderName

The details configured in the CSV configuration file are displayed as is.

Result

The post-execution status of the loading operation for each VM is displayed.

"OK" indicates that loading was successful, while "NG" indicates failure.

Note

Error messages generated after failed operations are displayed.

Privileges

OS administrator

Location

Admin server

> convertVMtoLServer -file D:\convert_test\vm_test1.csv  
VmGuest Convert Start 
VmGuest:test3 is converting 
VmGuest:test4 is converting 
VmGuest:test3 convert completed 
VmGuest:test4 convert completed 
VmGuest Convert End

0

The command executed successfully.

non-zero

An error has occurred.