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:


  1. Log in to HCL OneTest Server.

    The My Projects page is displayed.

  2. 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 HCL OneTest Server.

  3. 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 HCL OneTest Server:
    • The projects 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.
  4. Identify the Docker host that you want to modify the configuration, and then click the Edit icon Image of the edit icon.
    Note: The image of the edit icon 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 box is displayed.

  5. 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.
    1. Select the Secure mode option.
    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 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.
  6. Click Test connection to test whether a connection is established between HCL OneTest 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.
  7. Click Update.

    The remote Docker host with the updated details is displayed.


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.