Installing on OpenShift

With QMF 13.1.2, you can deploy QMF Server on OpenShift. Only single pod deployment is supported for each instance of QMF Server. You cannot create replicas of QMF Server on OpenShift.

Before you begin

  1. Install the latest version of Docker by completing the steps that are described in the Docker documentation.
  2. Copy the QMFServerxxx.war file in the docker folder, where xxx is the version number.
  3. In the Dockerfile_tomcat and Dockerfile_liberty files, replace QMFWebSpherexxx with QMFServerxxx.
  4. Install the latest version of OpenShift by completing the steps that are described in the OpenShift documentation.
  5. Add the JVM parameter -Dqmf.registry.serviceURL and specify its value as http://<node-name>:<port-number>/<context-name>.

    The <port-number> is the port on which the application server is running. For example, http://xxxx-xxxx-xxxxx-xxxx:31590/QMFServer131

  6. Set the nodeName parameter in the deployment.yaml file to the same value that you specified for <node-name> in the -Dqmf.registry.serviceURL parameter in 5.

About this task

To use QMF Server on OpenShift, create and deploy the image of QMF Server to OpenShift.

Procedure

  1. Create the QMF Server image by running the dockerEntry.sh script that is available in the docker folder.
    Important: Before running the dockerEntry.sh script, replace QMFWebSpherexxx with QMFServerxxx.
  2. Push the QMF Server image to a container registry, such as Docker Hub.
  3. Import the QMF Server image into OpenShift and create a deployment.
  4. Open the newly created deployment in OpenShift, and click Services > YAML.
    1. Set the type parameter to NodePort.
    2. Set the nodePort parameter to the same value of the port number that you specified in 5 in the Before you begin section.

      For IBM WebSphere Application Server Liberty, set the nodePort parameter that corresponds to targetPort: 9080 and for Apache Tomcat server, set the nodePort parameter that corresponds to targetPort: 8080.

Results

You can now use QMF Server on OpenShift.

What to do next

If you want to start the Broker Service for QMF Server on OpenShift, configure the Broker Service port by using the steps that are mentioned in Setting Broker Configuration preferences.