Generic selectors
Exact matches only
Search in title
Search in content
Search in posts
Search in pages
  1. DB Best Documentation
  2. Installing and uninstalling the data migration agent
Migration Platform
  • Overview
  • Product features
    • Release notes
    • Source and target platforms
    • Third-party applications
  • Getting started
    • Creating a new project
    • Ora2Pg installation
    • Tree view filtering
    • Compatible ODAC versions
    • Opening an existing project
    • Connecting to servers
      • Connecting to an Azure SQL Database
      • Connecting to an Oracle database
      • Connecting to a PostgreSQL database
      • Connecting to a Microsoft SQL Server database
    • Command timeout
  • Mapping
    • Object mapping
    • Error mapping rules
    • Data types mapping
  • Schema conversion
  • Schema comparison
  • Data comparison
  • Data migration
    • Migration task
      • Creating migration tasks
      • Templates
      • Migration options
      • Task actions
      • Task statuses
      • Errors or non-standard situations
    • Installing migration agent
      • Installing and uninstalling the data migration agent
      • Registering the migration agents
    • Project settings
  • Test organizer
    • Creating tests
    • Auto-generating tests
    • Groups and tests execution
    • Groups and tests states and execution statuses
    • Tests moving logic
    • Importing and exporting tests
    • Advanced comparison options
    • Creating reports
    • Error handling
  • Data store
  • Development project
  • System requirements
  • Hot keys
  • Known issues
  • Support

Installing and uninstalling the data migration agent

  • Share
    • Share via Facebook
    • Share via Twitter
    • Share via Linkedin

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

Did this page help you?

Provide Feedback
PreviousErrors or non-standard situations
Next Registering the migration agents

Did this page help you? Yes

Thanks for letting us know that we did a great job.

Did this page help you? No

Thanks for letting us know that there is a problem on this page.

Send Feedback

Feel free to share your ideas or occurred issues with us. The DB Best team will be happy to make our documentation better.

Please, specify your email address so that we can reach out to you to clarify your question. Also, we will use this email address to notify you about solving the issue.

* marks the mandatory fields

Dark theme Light theme

© 2002–2021 DB Best Technologies, LLC. All rights reserved.