20.7 Registering Workloads and Discovering Details with Migrate Agent

Migrate Agent is a command line utility that enables you to register source workloads with PlateSpin Migrate servers and send details about the workloads to the server via HTTPS (TCP/443). Registration allows you to add workloads that cannot be discovered, such as:

When you deploy Migrate server in the cloud without a site-to-site VPN
When corporate network or policy restrictions prohibit opening ports for automated discovery

Migrate Agent enables you to migrate a Windows workload without opening any inbound ports, such as SMB or NetBIOS. Only HTTPS and a replication port (TCP/3725 is the default) are needed outbound for the source workloads.

When you use the Migrate Agent on the source workload, the source workload contacts the target workload for data transfers. The direction is controlled at the server level. You must reconfigure the replication port direction on the Migrate Server (SourceListensForConnection=False). See Section 5.9, Configuring the Contact Direction for the Replication Port.

You must install the Migrate Agent utility on each source workload. When you use the register option, Migrate Agent performs discovery locally on the workload and sends its details to the Migrate Server through HTTPS (TCP/443). After you register the workload, use the Migrate Web Interface to configure the workload migration to the target cloud where the Migrate Server instance is deployed.

Registered workloads differ from discovered workloads in the following ways:

Registered source workloads do not store the source credentials on the Migrate Server.
You must use Migrate Agent to install, upgrade, and remove the Windows PlateSpin 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. See Cleaning Up Linux Workloads.

For information about the Migrate Agent, see Migrate Agent Utility.

20.7.1 Windows Workload Registration and Discovery with Migrate Agent

Log in as Administrator to the source Windows workload.
Ensure that TCP port 443 is open on the workload.
Download Migrate Agent Utility for Windows. Save the MigrateAgent.cli.exe file to a convenient location on the workload.

See Migrate Agent Utility for Windows.
In an Administrator Prompt, navigate to the location where you saved the file, then view the command Help by entering:
```
MigrateAgent.cli.exe help
```
Register the workload with the appropriate Migrate Server cloud instance. Enter
```
MigrateAgent.cli.exe /register /psserver=ps_dns_or_ipaddr <username> /password=<password>
```
Provide the credentials for an administrator-level user of the PlateSpin Migrate Server who has the permissions needed to add a workload. You can use the /password= option with the password, use the -pwdfile= option with a path to a file that contains the password, or do not specify the password in the command sequence. 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.

For example:
```
Migrate.Agent.cli.exe /register /psserver=10.10.10.101 /username=jsmith /password=jspwd
```
NOTE:If you modify the public IP address of the Migrate Server, you must run the following command on each of the source Windows workloads that are configured for the server to modify the IP address.
```
MigrateAgent.cli.exe /config /setting=psserver:<new-ps-dns-or-ipaddr>
```
For example:
```
MigrateAgent.cli.exe /config /setting=psserver:10.10.20.202
```

20.7.2 Linux Workload Registration and Discovery with Migrate Agent

The Migrate Agent Utility for Linux requires the source machine to have GNU C Library (glibc) 2.11.3 or higher installed.

Log in as the root user to the source Linux workload.
Ensure that TCP port 443 is open on the workload.
Download the Migrate Agent Utility for Linux. Extract the downloaded file to the /MigrateAgent directory,

See Migrate Agent Utility for Linux.
In a terminal, navigate to the /MigrateAgent directory, then view the command Help by entering:
```
./MigrateAgent -h
```
Register the workload with the appropriate Migrate Server cloud instance. Enter
```
./MigrateAgent register [-h] <ps_dns_or_ipaddr> <ps_username> [[-p <user_password>] | [-pf <passwordfile_path>]]
```
Specify the IP address or DNS name of the PlateSpin Migrate Server instance in the cloud. Provide the credentials for an administrator-level user of the PlateSpin Migrate Server who has the permissions needed to add a workload. You can use the -p option with the password, use the -pf option with a path to a file that contains the password, or do not specify the password in the command sequence. 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.

For example:
```
./MigrateAgent register 10.10.10.101 jsmith -p jspwd 
```
NOTE:If you modify the public IP address of the Migrate Server, you must run the following command on each of the source Linux workloads that are configured for the server to modify the IP address.
```
./MigrateAgent configure <ps_dns_or_ipaddr> <new-ps-dns-or-ipaddr>
```
For example:
```
./MigrateAgent configure 10.10.10.101 10.10.20.202
```