Customizing standalone-openshift.xml

Environment

• Red Hat OpenShift Container Platform (Openshift)
  • 3
  • 4
• Red Hat JBoss Enterprise Application Platform
  • 7
• Red Hat Single Sign-On
  • 7

Issue

• Where can we get the original standalone-openshift.xml?
• How do I replace the standalone-openshift.xml in the image?

Resolution

EAP 7 is not supported currently on podman/docker/docker-compose - EAP 7 images are supported only on OCP 4

The below solution describes customization for EAP 7 image building and running with docker. However, for runtime customization methods see What are the options to use a custom runtime JBoss EAP 7 configurations in OCP:

Docker getting and running with custom standalone configuration

You can get standalone-openshift.xml from original image. For example, you can refer to standalone-openshift.xml with following commands:

    $ podman run --rm -it --entrypoint=/bin/bash registry.access.redhat.com/jboss-eap-7/eap72-openshift /bin/bash

Or for RH-SSO

    $ podman run --rm -it --entrypoint=/bin/bash registry.access.redhat.com/redhat-sso-7/sso73-openshift /bin/bash

This will open a prompt inside the container. Then run:

    $ cat /opt/eap/standalone/configuration/standalone-openshift.xml

Copy and paste the text out of the terminal into a local file.

Run EAP with customized the EAP 7 configuration

• Then, after customized the standalone-openshift.xml, one can use it on your image by deploying the standalone-openshift.xml under configuration directory:

  For example:

    <YOUR_TOP_SOURCE_DIRECTORY>/configuration/standalone-openshift.xml
  

Refer to the JBoss EAP for Openshift documentation All files in the configuration source repository directory are copied to EAP_HOME/standalone/configuration. If you want to use a custom JBoss EAP configuration file, it should be named standalone-openshift.xml.

Root Cause

Currently source code of the xPaaS image is not been published.

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.