Registering a remote Docker host with IBM® Rational® Test Automation Server

You must register the remote Docker host with Rational® Test Automation Server before you add the remote Docker host to your project, which contains the test assets that you want to run on the remote Docker host.

Before you begin

Depending on the mode of connection with Rational® Test Automation Server, you must have set up the remote Docker host system either for a secured mode or unsecured mode of connection. See Setting up a remote Docker host system or Setting up a secure remote Docker host system.

You must have configured the remote Docker host system on Rational® Test Automation Server. See Configuring the remote Docker host system on Rational Test Automation Server.

Procedure

  1. Log in to Rational® Test Automation Server.
  2. Click the User icon Image of the user icon. on the menu bar and select Docker Hosts.

    The Manage docker hosts dialog box is displayed.

  3. Click New docker host.
  4. Enter the host name and the port of the remote Docker host in the format <host name or IP_address>:<port> in the Remote Docker Host field.
    Note: You must enter the same details for the remote Docker host that you have set in the docker-compose.yml file.
    If you do not provide the port that you have configured for the remote Docker host, then the default port that is used is as follows:
    • Port 2375 for the unsecured mode
    • Port 2376 for the secured mode
  5. Choose from any of the following authentication modes to establish the connection between Rational® Test Automation Server and the remote Docker host system:
    • For the secured mode, the Secure mode checkbox is selected by default.
      Perform the following steps:
      1. Select Secure mode, if it is not selected.
      2. Click the action labels to browse and select the .pem files that correspond to ca_certificate.pem, client_certificate.pem, and client_key.pem.
      Note: You must have generated the .pem files on the remote Docker host system and copied the files to your local drive.
    • For the unsecured mode, the Secure mode checkbox must not be selected.
      Perform the following step:
      1. Clear the Secure mode checkbox, if selected.
  6. Click Test connection to test if a connection is established between Rational® Test Automation Server and the remote host system.
    • On a successful connection, a message is displayed.
    • On a failure to connect to the remote host system, an error message is displayed. You must resolve the error and reattempt to establish a successful connection.
    Important: The remote Docker host system must be connected successfully before you can register the remote Docker host with Rational® Test Automation Server.
  7. Click Register.
    The remote Docker host that you registered is displayed.
    Important: The remote Docker host must be registered successfully with Rational® Test Automation Server before you add the remote Docker host to your project.
  8. Click Close to exit.

Results

You have registered the remote Docker host with Rational® Test Automation Server.

What to do next

You must add the registered remote Docker host to your project before you use the remote Docker host as a location to run tests in your project.