Test run considerations for running tests on remote Docker hosts

Before you can configure a test to run on a remote Docker host, you must read the considerations that you must take into account.

You can run all the tests that are supported on Rational® Test Automation Server on remote Docker hosts.

Important: You can run virtual services only in the Default Cluster location of Rational® Test Automation Server. You cannot run virtual services on a remote Docker host.

When you plan to run any of the tests on a remote Docker host from a project on Rational® Test Automation Server, you must complete the following tasks:

	Tasks	More information...
1.1	Set up non-secure remote Docker hosts.	Setting up a remote Docker host computer
1.2	Set up secure remote Docker hosts.	Setting up a secure remote Docker host computer
2	Register the remote Docker host on Rational® Test Automation Server.	Registering a remote Docker host
3	View the registered Docker hosts.	Viewing remote Docker hosts that are registered with IBM Rational Test Automation Server
4	Add a remote Docker host to the Rational® Test Automation Server project.	Adding a remote Docker host to the project for running tests
5	Configure a run for your test that you want to run on the remote Docker host by performing the following actions: Go to Test run configurations. Check for the prerequisite tasks that you must perform before you configure a test run for the test. Select the task for the test that you want to configure for a run, and then follow the steps to run the test.	Test run configurations Prerequisites to running tests Test run configurations

If you plan to run API Suites that use a transport and the transport requires third-party application Jar files for a successful run on a remote Docker host, then you must perform the following task:

You must copy the third-party application Jar files to the third-party application folder on the computer where the remote Docker host is installed. See Copying third-party application Jars to a remote Docker host.

After you set up and register the remote Docker host with Rational® Test Automation Server, you can add the remote Docker hosts to your project on Rational® Test Automation Server. See Adding a remote Docker host to the project for running tests.

You can find information about the tasks that you can perform when you use remote Docker hosts that are set up and registered with Rational® Test Automation Server.

When you configure a test run and in the step in which you select the remote Docker, if you encounter any of the following conditions because these were changed on the remote Docker host:
- The host name or port of the remote Docker is not displayed correctly.
- You want to change the mode of authentication with the remote Docker host.
You must edit the configuration settings for the remote Docker host. See Editing configurations of a remote Docker host.
When you want to delete a remote Docker host from your Rational® Test Automation Server project, see Removing a remote Docker host from a project.
When you want to remove or unregister a remote Docker host from Rational® Test Automation Server, see Unregistering a remote Docker host from IBM Rational Test Automation Server.