pmigrate

The pmigrate utility is used to perform different kinds of migration. This utility has the following syntax:

pmigrate < source_server > < destination_server > [ options ]

< 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). < 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 is not specified, the operation is performed on the local server.

Note: The current version of pmigrate does not support migrating physical servers to virtual machines.

< source_server > and < destination_server > consists of two parts—< 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 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 >[:< destination_server_port >]

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

Common options:

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

Options specific for migrating virtual machines between Parallels servers:

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

Options specific for migrating Containers to virtual machines:

`-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 (by 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).

Options specific for migrating physical computers to virtual machines:

`-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, only data from the active disk drive is 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).

Options specific for migrating Xen virtual machine to virtual machines:

`-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