Editing configurations of a remote Docker host

You can edit the host name or the port of the registered Docker host computer instead of registering it as a new remote host if any of the parameters are changed on the remote host computer. You can also change the mode of authentication of a registered remote Docker host.

Before you begin

You must have completed the following tasks:

Set up the remote Docker host computer. See Setting up a remote Docker host computer or Setting up a secure remote Docker host computer.
Registered the remote Docker host with IBM® Rational® Test Automation Server in your team space. See Registering a remote Docker host.

Procedure

Log in to Rational® Test Automation Server.

The team space that contains your project is displayed.
Click Infrastructure > Agents and Intercepts in the navigation pane.

The Agents and Intercepts page is displayed.

You can view the agents, intercepts or Dockers that are registered with Rational® Test Automation Server in your team space.
You can view the Dockers that you own in any of the following ways:
- Search for the Docker by entering the name of the Docker host in the Search field.
  Note: You can enter either the full name or any text that is in the name. The search is enabled for case sensitive text that you can enter.
- Sort the Type column to sort the items and then identify the Docker by the name displayed.
- Sort the Agents column to sort the items and identify the Docker by the owner.
You can view the following details about the Dockers that are registered with Rational® Test Automation Server in your team space:
- The projects in the team space to which the Docker host is added, are displayed in the Projects column.
- The status of the Docker host is displayed in the Status column.
Identify the Docker host that you want to modify the configuration, and then click the Edit icon .

Note: The icon is displayed in the Actions column in the row of the Docker only if you own the remote Docker host.

The Update docker host dialog is displayed.

Change any of the configurations.


To change...	Do this...
Change the host name or the port of the remote Docker host.	Enter the changed value of the host name or the port in the Remote hostname field.
Change the mode of authentication from a non-secure mode to a secure mode.	Select the Secure mode option. 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 host computer and copied the files to your local drive.
Change the mode of authentication from a secure mode to a non-secure mode.	Clear the Secure mode option that is selected.

Click Test connection to test whether a connection is established between Rational® Test Automation Server and the remote host computer:
- On a successful connection, a message is displayed.
- On a failure to connect to the remote host computer, an error message is displayed. You must resolve the error and reattempt to establish a successful connection.
Click Update.

The remote Docker host with the updated details is displayed.

Results

You have updated the registered remote Docker host with the changed parameters.

What to do next

You can now add the updated Docker host to your project. See Adding a remote Docker host to the project for running tests.