G.2 Migrate Agent Utility for Windows

G.2.1 Downloading and Installing Migrate Agent on a Source Windows Workload

To download and install the Migrate Agent utility for Windows to the source workload:

Log in to the source Windows machine as the Administrator user.
In a web browser, launch the PlateSpin Migrate Web Interface and log in.
Click the Downloads tab.
Click the Migrate Agent application link for the Windows target platform, then save the compressed MigrateAgent.cli.exe file.
Extract the contents of the file to access the executable file.
(Optional) View the Migrate Agent Help by entering
```
MigrateAgent.cli.exe -h
```

G.2.2 Migrate Agent Commands for Windows

The syntax for running the Migrate Agent utility for Windows is:

MigrateAgent.cli.exe {command} [command_option] [/psserver=%IP%]

Table G-1 describes the commands, command options, and switch available for the MigrateAgent.cli.exe command on Windows.

Table G-1 Migrate Agent Utility for Windows Commands, Command Options, and Switch

Usage	Description
Commands
h \| ? \| help	Displays usage and options for the command.
logs \| view-logs	Opens the application log directory.
reg \| register /reg /psserver=%IP% /username=<username> [[ /password=<password>] \| [/pwdfile=<path-to-password-file>]] If you do not specify the password or a path to a file that contains the password, you will be prompted for the password. The password is obscured as you type it and it does not appear in the process list. Example: MigrateAgent.cli.exe /register /psserver=10.10.10.101 /username=jsmith /password=jspwd	Registers this machine as a workload on the specified server. It also checks for driver upgrades from the specified PlateSpin Server. Enables you to add workloads that cannot be discovered. Registered workloads differ from discovered workloads in the following ways: Registered source workloads do not store the source credentials. You must use Migrate Agent to install, upgrade, and remove Block-based Transfer (BBT) drivers from registered source workloads. After you delete the contract for a registered source workload, you must manually remove the OFX controller from the workload. To remove the OFX controller from the workload, see KB Article.
status /status [/psserver=%IP%]	Shows installation status for the PlateSpin controller and drivers on this workload. If you specify the PlateSpin Server, it checks for driver upgrades from the server.
din \| driver-install /din [/psserver=%IP%]	Installs the PlateSpin drivers. NOTE:Before you install block-based transfer drivers on source Windows workloads, ensure that you have applied the latest Windows updates on the workload. If you specify the PlateSpin Server, it checks for driver upgrades from the server.
dup \| driver-upgrade /dup [/psserver=%IP%]	Upgrades the PlateSpin drivers. If you specify the PlateSpin Server, it checks for driver upgrades from the server.
dun \| driver-uninstall [/dun /psserver=%IP%]	Uninstalls the PlateSpin drivers.
con \| config /con /setting=<setting_name>:<value> Example: migrateagent.cli.exe /config /setting=psserver:10.10.10.202	Specifies the name of the setting and its value to change in the configuration file on this workload. The psserver option stops the OFX Controller (ofxcontroller) service, modifies the OfxController.exe.config file with the new IP address, and restarts the service. If you modify the public IP address of the PlateSpin Server, you must run this command on each of the source workloads that are configured for the server.
Switch
/psserver=%IP%	Specifies the IPv4 address of the PlateSpin Server. Downloads the block-based transfer drivers from the specified server when you invoke the status, driver-install, or driver-upgrade options.
Command Options
username /username=value	Specifies the PlateSpin Server user name for an administrator-level user with rights to add a workload.
password \| pwd \| p /password= value	Specifies the password for the specified PlateSpin Server user name. If you exclude the password from the command line, the script will prompt for it. The password is obscured as you type it and it does not appear in the process list. Do not combine this option with the pwdfile option.
pwdfile \| pf /pwdfile=value	Specifies the path to a file that contains the password for the specified PlateSpin Server user name. Do not combine this option with the password option.
setting /setting=<setting_name>:<value>	Specifies the setting name and value of the configuration setting to modify. Supported setting names are: psserver altAddress heartbeat

Usage

Description

Commands

h | ? | help

Displays usage and options for the command.

logs | view-logs

Opens the application log directory.

reg | register

/reg /psserver=%IP% /username=<username> [[ /password=<password>] | [/pwdfile=<path-to-password-file>]]

If you do not specify the password or a path to a file that contains the password, you will be prompted for the password. The password is obscured as you type it and it does not appear in the process list.

Example:

MigrateAgent.cli.exe /register /psserver=10.10.10.101 /username=jsmith /password=jspwd

Registers this machine as a workload on the specified server. It also checks for driver upgrades from the specified PlateSpin Server.

Enables you to add workloads that cannot be discovered. Registered workloads differ from discovered workloads in the following ways:

Registered source workloads do not store the source credentials.
You must use Migrate Agent to install, upgrade, and remove Block-based Transfer (BBT) drivers from registered source workloads.
After you delete the contract for a registered source workload, you must manually remove the OFX controller from the workload. To remove the OFX controller from the workload, see KB Article.

status

/status [/psserver=%IP%]

Shows installation status for the PlateSpin controller and drivers on this workload.

If you specify the PlateSpin Server, it checks for driver upgrades from the server.

din | driver-install

/din [/psserver=%IP%]

Installs the PlateSpin drivers.

NOTE:Before you install block-based transfer drivers on source Windows workloads, ensure that you have applied the latest Windows updates on the workload.

If you specify the PlateSpin Server, it checks for driver upgrades from the server.

dup | driver-upgrade

/dup [/psserver=%IP%]

Upgrades the PlateSpin drivers.

If you specify the PlateSpin Server, it checks for driver upgrades from the server.

dun | driver-uninstall

[/dun /psserver=%IP%]

Uninstalls the PlateSpin drivers.

con | config

/con /setting=<setting_name>:<value>

Example:

migrateagent.cli.exe /config /setting=psserver:10.10.10.202

Specifies the name of the setting and its value to change in the configuration file on this workload.

The psserver option stops the OFX Controller (ofxcontroller) service, modifies the OfxController.exe.config file with the new IP address, and restarts the service. If you modify the public IP address of the PlateSpin Server, you must run this command on each of the source workloads that are configured for the server.

Switch

/psserver=%IP%

Specifies the IPv4 address of the PlateSpin Server.

Downloads the block-based transfer drivers from the specified server when you invoke the status, driver-install, or driver-upgrade options.

Command Options

username

/username=value

Specifies the PlateSpin Server user name for an administrator-level user with rights to add a workload.

password | pwd | p

/password= value

Specifies the password for the specified PlateSpin Server user name.

If you exclude the password from the command line, the script will prompt for it. The password is obscured as you type it and it does not appear in the process list.

Do not combine this option with the pwdfile option.

pwdfile | pf

/pwdfile=value

Specifies the path to a file that contains the password for the specified PlateSpin Server user name.

Do not combine this option with the password option.

setting

/setting=<setting_name>:<value>

Specifies the setting name and value of the configuration setting to modify.

Supported setting names are:

psserver
altAddress
heartbeat