Copying third-party application Jars to a remote Docker host

You can run API Suites in a project on Rational® Test Automation Server on a remote Docker host. If the API Suites use a transport and the transport requires third-party Jar files for a successful run, you must ensure that the third-party application Jar files are available at the test run time. To achieve this, you must copy the third-party application Jar files to the computer where you have set up the remote Docker host.

Before you begin

If you want to copy the third-party application Jar files to the to the computer where Rational® Test Automation Server is installed on Kubernetes, see Copying third-party application Jars to Kubernetes.

You must have server administrator privileges.

You must have completed the following tasks:
  • Set up and configured the remote Docker host. See Managing Docker hosts.
  • Identified the third-party application Jar files that are required and copied the Jar files. See Test run considerations for API Suites.
  • Copied the Jar files of the third-party application jars to the directory or folder on the remote Docker host from where you can run the docker commands.

About this task

You can copy the required third-party application Jar files to the folder that is specific for the application under the /myFiles/Userlibs/<application_name> folder. You need not extract the files.

You can perform this task any time after you have configured the remote Docker host and you plan to run an API Suite on the remote Docker host. The API Suite uses transports and the transports require third-party application JAR files to be available at the test run time.

You can get help on the docker commands by running the command: $ docker help from the docker command line. For more information about the docker commands, refer to the Docker command line documentation.

Procedure

  1. Use the following table to find the name of the folder that corresponds to the specific third-party application for the transport used in the API Suite.
    Note: You must provide the name of the folder listed for the third-party application as the <application_name> in the docker command.
    Table 1. Name of the folder for the application
    Application Name of the folder to use
    Camel Camel
    CentraSite CentraSite
    CICS CICS
    Coherence Coherence
    Database JDBC
    IMS IMS
    Integra Integra
    JMS JMS
    SAP RFC SAP
    Software AG Universal Messaging SoftwareAGUM
    TIBCO EMS TIBCO
    TIBCO Rendezvous
    TIBCO SmartSockets
    WebSphere Application Server Service Integration Bus (SiBus) WAS
    WebLogic WebLogicJMX
    Software AG webMethods webMethods
    WebSphere MQ WMQ
  2. Run the following docker command to create or update the volume that contains the application Jar files:

    docker run --rm -v /<anyFolder>/UserLibs/<application_name>:/ulsrc -v userlibs/<application_name>:/uldest alpine:latest cp -r /ulsrc/. /uldest/UserLibs/<application_name>

    Attention: You must run the docker command when no other tests are running in the Docker host to prevent concurrent access problems.

Results

You have successfully copied the third-party application Jar files to the folder in the remote Docker host.

What to do next