You can run API Suites in a project on IBM® DevOps Test Hub (Test Hub). If the API Suite uses a
transport and the transport requires third-party application 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
Test Hub is installed on
Kubernetes.
Before you begin
You must have server administrator or cluster administrator privileges.
You must have completed the following tasks:
- Identified the third-party application Jar files that
are required and copied the files. See Test run considerations for API Suites or API tests.
- Copied the third-party application Jar files from IBM DevOps Test Integrations and APIs (Test Integrations and APIs) to the
directory or folder in Kubernetes from where you can run the
kubectl commands.
About this task
You can copy the third-party application Jar files to the folder
that is specific for the application under the
/data/<application_name> folder. You need not extract
the files.
You can perform this task any time after you have installed
Test Hub and you plan to run an
API Suite that meets any of the following conditions:
- The API Suite uses transports and the transports require third-party
application Jar files to be available at the test run
time.
- The API Suite in the project has a results database configured.
You can copy the JDK version Jar files that you have used to
create the JUnit tests.
You can get help on the kubectl commands by running the command:
kubectl cp --help from the /kube
directory. For more information, refer to the kubectl documentation.
Procedure
-
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.
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 |
-
Open the command prompt from the /kube directory and copy
the Jar files to the folder that corresponds to the
application by using the following command:
kubectl cp <compressed_files> devops-system/{{main}}-userlibs-0:/data/<application_name>/
For example, if you are copying the Database Jar files,
then the name of the folder is JDBC and the command to
use is:
kubectl cp mysql-connector-java.jar devops-system/{{main}}-userlibs-0:/data/JDBC/
Note: You must substitute {main} with the release name
that you used during the installation of Test Hub.
-
Verify whether the Jar files are copied by running the
following command:
kubectl exec {{main}} -userlibs-0 -n devops-system -- ls /data/<folder_created>
For example, if you copied the Database Jar files,
mysql-connector-java.jar to the folder
JDBC, then the command to verify is:
kubectl exec {{main}} -userlibs-0 -n devops-system -- ls /data/JDBC
The following information is displayed for the
JDBC
folder:
mysql-connector-java.jar
Note: You must substitute {main} with the release name
that you used during the installation of Test Hub.
Results
You have successfully copied the third-party application Jar
files to the folder in Kubernetes.
What to do next
You can configure the API Suite run. See Configuring an API Suite or an API test run.