1. DB Best Documentation
  2. Installing and uninstalling the data migration agent

Installing and uninstalling the data migration agent

Migration agents communicate with the DB Best Migration Platform through the Windows web service that leverages REST requests.

By default, the platform utilizes one migration agent. However, you can reduce the migration time by leveraging several migration agents. Thus, the DB Best Migration Platform distributes data load between several machines that allows for optimizing the process.

Installing the data migration agent with default settings

To install the Data Migration agent with default settings,  run the install.bat file as administrator.

In this case, the agent is run with the following settings:

  • agentPort — 9000
  • pathToLogFolder — [currentPath] \ logs
  • pathToSnapshotFolder — [currentPath] \ storage
  • agentIndex — “”
Figure 1. Install agent

Figure 1. Installing the data migration agent

Installing the data migration agent with additional settings

To install the Data Migration agent with additional setting run the instail.bat file as administrator and specify the following parameters:

install.bat agentPort pathToLogFolder pathToSnapshotFolder agentindex

Where:

  • agentPort — a value of the agent port. Note: You cannot use a busy port
  • pathToLogFolder — a path to the folder on the local computer where the log files are saved
  • pathToSnapshotFolder — a  path to the folder on the local computer where the agent’s snapshots are saved
  • agentIndex — the index for the agent identification (for the cases when there are several agents installed)

Example:

install.bat 9020 "C:\Migration agent\x64\Release\logs" "C:\Migration agent\x64\Release\storage" 20

Installing multiple agents on the same computer

To install multiple Data Migration agents follow these steps:

  1. Copy all the agents’ files to a new folder
  2. Start the installation process from this folder
  3. Specify the settings that differ from the settings of agents already installed on this computer.

Note: When installing multiple agents on the same computer, you must specify different folders for saving logs and snapshots.

Uninstalling agent

To uninstall the data migration agent open the folder where the agent is installed and run the uninstall.bat file as administrator.

Figure 2. Uninstall agent

Figure 2. Uninstall agent

Note: To remove one of the multiple agents, specify the agent index in the parameter when running  uninstall.bat (e.g. uninstall.bat 4).

Didn’t find the answer?

You can report problems, ask questions or share ideas for improvements on our email [email protected].