pmigrate

The pmigrate utility is used to perform different kinds of migration.

Syntax

pmigrate <source_server> <destination_server> [ options ]

The <source_server> is the source server which can be either the server where the virtual machine and Container to be migrated is residing (if you are migrating a virtual machine and Container) or the physical computer to be migrated (if you are migrating a physical computer). The <destination_server> is the destination server—that is, the Parallels server where the virtual machine and Container or the physical server is to be migrated. If the source and/or destination server are not specified, the operation is performed on the local server.

Both <source_server> and <destination_server> consist of <type> and <address> :

<type> denotes the type of computer to migrate and can be one of the following:
- h for migrating physical computers
- c for migrating Containers
- v for migrating Parallels virtual machines
- x for migrating Xen virtual machines
<address> denotes the location of computer to migrate and can be one of the following:
- The computer location if you are migrating a physical computer.
- The computer location and the virtual machine name or Container ID if you are migrating a virtual machine or Container, respectively. The location must be separated from the virtual machine name/Container ID by the slash ( / ).
The location format is as follows:

[ user [: password ]@] <destination_server_IP_address_or_hostname> [: port ]

The [ options ] you can use with pmigrate depend on whether you are migrating a virtual machine or a Container. This section describes the options you can use to migrate Parallels and Xen virtual machines, Containers, and physical computers.

General Options

Name	Description
--dst= `<path>`	Specifies the name and path of the directory on the destination server to use for storing the virtual machine files. If this option is omitted, the default directory is used.
-h, --help	Displays the information on the utility usage.

Virtual Machine Migration Options

Name	Description
--keep-src	If this option is included, the original virtual machine is not removed from the source server after migration. By default, the original virtual machine is removed from the source server.
--switch-template	Switches the virtual machine to a template and a template to a virtual machine. For example, if the source virtual machine was a template, it becomes a full featured virtual machine after the migration, and vice versa.
--changesid	Changes the resulting virtual machine SID.

Container-to-Virtual Machine Migration Options

Name	Description
-s, --size= `<size>`	Sets the limit of the resulting virtual machine disk capacity. If you omit this option or specify 0, no limit is set. In this case disk quotas set for virtual machines on the Parallels server will be used. The following size modifiers can be used: G — gigabytes, M — megabytes (default), K — kilobytes.
-r, --reg `[` =<y `\|` n> `]`	Specifies whether to register the resulting virtual machine on the Parallels server. By default, the virtual machine is registered.
-d, --remove `[` =<y `\|` n> `]`	Removes the source Container after migration. By default, the Container is left intact.
--key= `<auth_key>`	Set the authentication key for passwordless access to the Parallels server. To set this key, use the `parallels-c2v-agent --regkey` `<auth_key>` command on the server where the Container is residing ( `<auth_key>` can be any alphanumeric value).

Physical Computer-to-Virtual Machine Migration Options

Name	Description
-r, --reg `[` =<y `\|` n> `]`	Specifies whether to register the resulting virtual machine on the Parallels server. By default, the virtual machine is registered.
--osdata= `<path>`	Sets the path to the directory with data files required for the OS reconfiguration and not found on the source computer.
-a, --all	Migrate all computer's disks and partitions with all available data. If this option is omitted: For a Windows source computer, only boot and system volumes are migrated. For a Linux source computer, only the partitions specified in the `/etc/fstab` file on the source are migrated.
--key= `<auth_key>`	Set the authentication key for passwordless access to the physical computer you want to migrate. To set this key on the computer, use the `parallels-transporter-agent --regkey` `<value>` command ( `<auth_key>` can be any alphanumeric value).

Xen Virtual Machine-to-Virtual Machine Migration Options

Name	Description
-r, --reg `[` =<y `\|` n> `]`	Specifies whether to register the resulting virtual machine on the Parallels server. By default, the virtual machine is registered.
--osdata= `<path>`	Sets the path to the directory with data files required for the OS reconfiguration and not found on the source virtual machine.
--key= `<auth_key>`	Set the authentication key for passwordless access to the Xen server. To set this key on the Xen server, use the `parallels-transporter-agent --regkey` `<value>` command ( `<auth_key>` can be any alphanumeric value).
--ip= `<IP>` `[` / `mask` `]`	Sets the IP address for the resulting virtual machine. If this option is omitted, the DHCP support is enabled for the virtual machine.
--gw= `<IP>`	Sets the default gateway for the resulting virtual machine. If this options is omitted, the DHCP support is enabled for the virtual machine.
--nameserver= `<IP>`	Sets the DNS server for the resulting virtual machine.
--searchdomain= `<domain>`	Sets the DNS search domain for the resulting virtual machine.

Top of page

Feedback