#Create a Connection

To connect the Device agent to AvePoint Online Services, you need to add connections by completing the following steps:

1. Click Settings in the left pane, and select Connections to access the Connections page.

2. Click Create connection. The Create connection panel appears.

3. In the Create connection panel, complete the following settings:

   • Connection name – Enter a name for the connection.

   • Connection type – Select Device from the drop-down list to create a connection for Device.

   • AvePoint Online Services application (client) ID – Enter the ID of your app registration in AOS > Administration > App registrations.

   • Client secret – Enter the client secret of your app registration in AOS > Administration > App registrations.

   • Generate command line – Click to generate command line. The command line will be used to connect the device agent. You can click the Copy () button to copy the command line.

   • Download and install device agent – Click Download device agent to download the agent and install it on the device server. Refer to Install the Device Agent for how to install the agent.

4. Click Save to save your configurations.

On the Connections page, you can manage the existing connections.

#Install the Device Migration Agent

Refer to the following sections to prepare and install the device migration agent.

#System Requirements

Refer to the following table for the system requirements of the Fly Active Directory Migration Agent.

Components	Requirements
Operating System	Windows Server 2016, Windows Server 2019, Windows Server 2022, Windows 10, Windows 11*Note: 32-bit operating systems are not supported. Only operating systems with Desktop Experience are supported.
Number of CPU Cores	Recommended: 4 or above.
Available Physical Memory	Recommended: 8 GB or above.
Available Disk Space	The Agent server will store the temporary files and job logs of migrations. ● We recommend 50 GB or above for migration projects with less than 100 GB of data.● We recommend 100 GB or above for large migration projects with more than 200 GB of data.When checking the installation rules, Fly checks the storage space of your drive C by default. Make sure there is available space of 2 GB or above in your drive C.
.NET Framework Version	.NET Framework 4.7.2 to 4.8.
Net.Tcp Port Sharing Service	Net.Tcp Port Sharing Service has started.
Transport Layer Security (TLS) Version	TLS 1.2 is enabled.
Visual C++ Redistributable Version	Visual C++ Redistributable 2015-2022.

#System Services Port Requirements

Refer to the following information for the system services port requirements of the Fly Active Directory Migration Agent.

Application Protocol	Protocol	Ports
Lightweight Directory Access Protocol (LDAP) Server	TCP	389
Remote Procedure Call (RPC)	TCP	135
RPC randomly allocated high TCP ports	TCP	49125 - 65535

For more details, refer to .

#Network Requirements

Before performing device migrations in Fly, make sure the network of the server where you want to install the device agent can connect to the AvePoint Online Services, Fly, and the source/destination device.

If your organization has an access policy and only specific IP addresses are allowed, you need to navigate to AvePoint Online Services > Administration > Security > Reserved IP addresses to download the list of reserved IP addresses required by AvePoint Online Services and Fly, and then add the IP addresses to the safe IP address list of the server where you want to install the device agent.

#Download Agent

You can either download the device agent when creating a connection for device migration or follow the steps below to download the agent:

1. Click Settings in the left pane, and select Agents .

2. Click the Device Agent tab, and then click Download agent to download the corresponding agent.

3. In the panel, click Download.

4. To verify whether a downloaded file has been tampered with, check its hash value and compare it with the one displayed in the panel.

5. To obtain the hash value from the downloaded file, open Windows PowerShell and enter the following commands:

   Get-FileHash -Algorithm SHA256 -Path “[file path]”

6. Replace [file path] with the full path of the downloaded file.

7. 

#Install the Agent

Refer to the following steps to install the device agent:

1. Copy the downloaded file of the device agent to the machine where you want to install the agent.

2. Right-click the file and select Run as administrator.

3. On the installation wizard, click Next and accept the agreement.

4. Click Next.

5. In the Destination Folder step, configure the installation path and click Next.

6. In the Connection key step, enter the connection key and click Next.

7. Click Install to install the agent.

#Uninstall the Agent

8. Navigate to the Control Panel on the machine where you have installed agent, and click Uninstall a program.

9. Right-click the agent and select Uninstall/Change.

10. In the pop-up window, click OK.

11. Click Uninstall to uninstall the agent.

#Upgrade the Agent

Refer to the following steps to upgrade the agent:

1. Open the agent > Configuration and click Learn more in the lower-left corner of the window. Then, the configurations window appears.

2. Click Check for a new version to check if there is an upgrade available for the agent. If no new version is detected, a message will be displayed next to the current version indicating that the device migration agent is up to date. If a new version is detected, the Upgrade now button will be displayed next to the current version. You can click it to upgrade the agent.

3. By default, the Auto check for a new version feature is enabled. A new version will be automatically detected at 0:00 every day on the machine where the agent is installed. You can also disable the Auto check for a new version feature to not auto detect the upgrades.

4. *Note: The auto upgrade will fail when the agent is running.