Docs Menu
Docs Home
/
Relational Migrator
/ / /

Install Query Runner

On this page

  • About this Task
  • Before you Begin
  • Steps
  • Next Steps

To use the Test Queries pane, Relational Migrator must have access to the Query Runner. Query Runner is a Docker container with all the dependencies needed to test your converted queries.

  • If the version of Query Runner is different than the version of Relational Migrator, a warning banner displays.

  • To update Query Runner to the latest version, run the docker pull command from step number one.

  • Query Runner operates using the http protocol. Requests made from a remote machine are not encrypted.

  • Query Runner can run either locally or remotely.

Install Docker.

1
docker pull public.ecr.aws/v4d7k6c9/relational-migrator-query-runner
2
  • To run the container locally:

    docker run --name relational-migrator-query-runner -p 127.0.0.1:6080:6080 public.ecr.aws/v4d7k6c9/relational-migrator-query-runner
  • To run the container remotely:

    1. Add the server address where the service is running to the migrator.language-runner.server.address in the user.properties.

      For example:

      migrator.language-runner.server.address: http://myserver:6080

      Tip

      For details on where the user.properties file is located, see Relational Migrator File Locations.

    2. After changing the user.properties file, restart Relational Migrator.

    3. Launch the container from your remote server or container hosting service.

      To launch the container on your remote server expose port 6080 with the following docker command:

      docker run --name relational-migrator-query-runner -p 6080:6080 public.ecr.aws/v4d7k6c9/relational-migrator-query-runner
3

In your web browser, navigate to the host and port the Query Runner container is using. For example: http://localhost:6080/status.

Check the status field of the JSON data returned from the status endpoint. A status of ok means the container is running:

{
"status":"ok",
"server":"App Mod Language Runner",
"commitHash":"159119004c2bf8c534e15e5895acb9bc1bfb5b8d",
"version":"20240627"
}

Back

Test Queries