Example: Access MATRIXX Backoffice Customer Tool Files

In the following example, you are an administrator who wants to access the settings.json file to configure administrative features in MATRIXX Backoffice Customer Tool.

Procedure

  1. Unpack it from the matrixxbct.jar file. For example, if using Docker, use the following command: 
    docker run --entrypoint jar -v `pwd`:/hostdir -w /hostdir <image_name> xf /opt/mtx/bin/matrixxbct.jar BOOT-INF/classes/static/assets/settings.json
  2. Update the settings.json file as needed.
  3. Add settings.json to a configuration image. For example, add it to a docker image named blueprint/mtx-web-sso-config:${KTX_REVISION_ID}.
  4. Create a configuration source from the configuration image you created in the previous step by defining it in the appropriate Helm chart values file. For example, create a confirmation source called ktx-blueprint-web-sso-config.
  5. Create a configuration source for MATRIXX Backoffice Customer Tool using the provided example template. This example uses a configuration image.
  6. Place the settings.json file in the configuration image to be unpacked at /opt/mtx/conf and set the asset.location property to point to this location in the Helm values file as follows: 
    matrixx-bct:
  configuration:
    container:
      args:
        - "-Dmatrixxbct.asset.location=/opt/mtx/conf"
  7. Rebuild the configuration image and host it in your image repository.

What to do next

To apply the configuration or for more information about sources that can provide configuration information, see the discussion about configuration sources in MATRIXX Configuration.