ServerView Resource Orchestrator Cloud Edition V3.2.0 User's Guide for Infrastructure Administrators (Resource Management)

17.10.2 Exporting

This section explains how to export a virtual L-Server.

The VM converter provides the function for exporting virtual L-Servers from the GUI and the CLI.

The export function for virtual L-Servers exports a selected virtual L-Server to the specified folder.

17.10.2.1 Preparations for Exporting the VM Converter

Installing the VM Converter Agent Program

In preparation for importing the virtual machine at the migration destination, the virtual machine to be exported must have the VM Converter agent program installed beforehand.

The installer for the agent program is stored in the installation folder of VM Converter:

VM_Converter_installation_folder\VMConverter\Agent\x86\TransportAgent.msi
VM_Converter_installation_folder\VMConverter\Agent\x64\TransportAgent.msi

Select the installer that supports the OS bit mode of the target virtual machine to export and execute it on the virtual machine to install the agent program.

Note

The agent program is included in V1.1.0 and later versions of VM Converter.
When performing import, ensure that V1.1.0 or a later version of VM Converter is used.

17.10.2.2 Exporting Using the VM Converter GUI

It is possible to use the CLI of the VM Converter to start the export and obtain the progress report of the export process (task) of the target L-Server.

1. When the VM Converter is started from the start menu, the home screen that has export, import, and task progress display buttons is displayed.

   Figure 17.4 Home

   

2. Select the source cloud system and the destination cloud system. If not specifying the destination cloud, select N/A.

   Figure 17.5 Select a Cloud

   

3. Enter account information of the source cloud system.

   Figure 17.6 Enter Account Information

   

4. The virtual L-Server list of the tenant corresponding to the logon account is displayed. Select the virtual L-Server to export. At this time, only one L-Server can be selected.

   Figure 17.7 Select a Virtual L-Server

   

5. Input the account information of the VM host that the selected virtual L-Server is on.

   Figure 17.8 Enter VM Host Information

   

6. Specify the folder used to store the exported files. A meta information file for the virtual L-Server will also be generated and stored with the exported files in this folder.

   Figure 17.9 Specify the File Storage Folder

   

7. Check the displayed confirmation screen and then click the [Launch] button. Afterwards, the home screen is displayed.

   Figure 17.10 Confirmation Window

   

8. When the [Task Status] button is clicked on the home screen, the progress report screen is displayed. The content is automatically refreshed every 60 seconds.

   Figure 17.11 Progress Window

   

   
   

For the parameters and explanations of each parameter output by the display function for task progress, see the table below.

Table 17.18 Parameters Output by the Display Function for Task Progress

GUI Parameter Name	CLI Parameter Name	Description
TID	TaskID	Task ID "TASK5-digit value"
Name	VMName	Name of the virtual L-Server being exported
Src.	SourceCloudType	Source cloud name When exporting "ROR" When importing "N/A"
Dst.	DestinationCloudType	Destination cloud name When exporting "N/A" When importing "ROR"
Operation		Process phase: "Export" or "Import"
Status		Status of the task Initializing Running Succeeded Error Aborted
Progress		Ratio of task progress (percentage)
Start Time		Time task was started (yyyy/MM/dd HH:mm:ss)
End Time		Time task finished (yyyy/MM/dd HH:mm:ss)
Message		When Status is Initializing, Running, or Succeeded When exporting The name of the storage folder for the file being exported or processed When importing The name of the virtual machine which has been imported or is being processed When Status is Error or Aborted An error message regarding the export or import process

17.10.2.3 Exporting Using the VM Converter CLI

Starting the export and obtaining the progress report of the export process (task) of the target L-Server is possible using the CLI of the VM Converter.

CLI is provided as the following cmdlet in Windows PowerShell 2.0 or later.

To use cmdlets, it is necessary to execute the Import-Module command and import the module manifest file in advance.

The PowerShell module manifest file is in the following folder.

VM_Converter_installation_folder\VMConverter\Client\PowerShell\Fujitsu.VMConverterClient.psd1

Move to the above folder and execute the Import-Module command.

Import-Module .\Fujitsu.VMConverterClient.psd1

The syntax of the cmdlet is as follows.

Login to the Source Cloud

>Connect-SourceCloud -SourceCloudType String -SourceServer String -SourceServerUserName String -SourceServerPassword String <RETURN>

cmdlet Name	Description	Parameters				Output (Return Value)
		Parameter Name	Type	Mandatory	Description
Connect-SourceCloud	Log in to source cloud system.	SourceCloudType	String	True	Specify the source cloud type. Only "ROR" can be specified.	None
		SourceServer			Specify the server name of the source cloud using its FQDN name or IP address. Only Resource Orchestrator manager servers are supported.
		SourceServerUserName			Specify the user ID for logon to the source server.
		SourceServerPassword			Specify the user password for logon to the source server.

Logout from the Source Cloud

>Disconnect-SourceCloud -SourceCloudType String <RETURN>

cmdlet Name	Description	Parameters				Output (Return Value)
		Parameter Name	Type	Mandatory	Description
Disconnect-SourceCloud	Logs out from the source cloud system.	SourceCloudType	String	True	Specify the source cloud type. Only "ROR" can be specified.	None

Obtain VM list from the Source Cloud

>Get-VMList -SourceCloudType String <RETURN>

cmdlet Name	Description	Parameters				Output (Return Value)
		Parameter Name	Type	Mandatory	Description
Get-VMList	Obtains the VM list from the source cloud.	SourceCloudType	String	True	Specify the source cloud type. Only "ROR" can be specified.	Hashtable (VM list) Name: Current folder name Value: VM names (comma separated)

Start Export Task

>Start-ExportTask -SourceCloudType String [-SourceServer String] -SourceVMName String -SourceServerUserName String] [-SourceServerPassword String] -VMHostUserName String -VMHostPassword String -DestinationCloudType String -OutFolderPath String [-Wait switch] <RETURN>

cmdlet Name	Description	Parameters				Output (Return Value)
		Parameter Name	Type	Mandatory	Description
Start-ExportTask	Starts the export task.	SourceCloudType	String	True	Specify the source cloud type. Only "ROR" can be specified.	Task ID (String)
		SourceServer		False	Specification is not necessary if already logged in. Specify the admin server name of the source cloud using its FQDN name or IP address. Only Resource Orchestrator manager servers are supported.
		SourceVMName		True	Specify the name of the VM to export (the VM name on the source cloud)
		SourceServerUserName		False	Specification is not necessary if already logged in. Specify the user ID for logon to the source server.
		SourceServerPassword			Specification is not necessary if already logged in. Specify the user password for logon to the source server.
		VMHostUserName		True	Specify the user ID for logon to the VM host of the VM to be exported.
		VMHostPassword			Specify the password for logon to the VM host of the VM to be exported.
		DestinationCloudType			Specify the destination cloud type. Only "N/A" can be specified.
		OutFolderPath			Specify the folder used to store the exported files. A local folder or a shared folder on another machine that can be accessed by this tool can be specified.
		Wait	Switch	False	Specify this if you want to wait until the export task ends. In general, the command will be returned immediately after the task starts but specifying this option makes it wait until the task ends.

Update Task Status and Display

>Update-ConvertTask [-Show] <RETURN>

cmdlet Name	Description	Parameters				Output (Return Value)
		Parameter Name	Type	Mandatory	Description
Update-ConvertTask	Updates the managed task status. (Updates the task database)	Show	Switch	False	If specified, the updated task status is shown.	None

For the parameters and explanations of each parameter output by the display function for task progress, refer to "Table 17.18 Parameters Output by the Display Function for Task Progress".