Administering Universal Messaging Containers

You can administer a Universal Messaging server running as a container by using any of the available administration tools, including the Enterprise Manager and the runUMTool command-line tool. You must use a mapped host machine port to connect to the server.

You can use the runUMTool tool available in the server container for administrative purposes. To run the tool inside the container, use a command similar to the following:

docker exec umcontainer runUMTool.sh ListChannels -rname=nsp://localhost:9000

As an alternative to using the built-in administrative tools, you can run a Universal Messaging server container in serverless mode. This means you can run only the tools component to administer other server containers as follows:

  1. docker run -d --name umtoolsonly -e TOOLS_ONLY=true
    cp.icr.io/cp/webmethods/universalmessaging/universalmessaging-server:11.1
  2. docker exec umtoolsonly runUMTool.sh ListChannels -rname=nsp://host:mappedPort

For more information about using the runUMTool tool, see Syntax reference for command line tools.

Importing a Realm Configuration from a File

You can import a realm configuration from an XML file by using the following command:

  • On Windows:
    docker run -v %cd%/Realm.xml:/opt/softwareag/Realm.xml -e
    STARTUP_COMMAND="runUMTool.sh ImportRealmXML -rname=nsp://localhost:9000
    -filename=Realm.xml -importall=true" -d -p 9000:9000 -p 9200:9200
    cp.icr.io/cp/webmethods/universalmessaging/universalmessaging-server:11.1

    where %cd% resolves to the current working directory.

  • On Unix:
    docker run -v "$(pwd)"/Realm.xml:/opt/softwareag/Realm.xml -e
    STARTUP_COMMAND="runUMTool.sh ImportRealmXML -rname=nsp://localhost:9000
    -filename=Realm.xml -importall=true" -d -p 9000:9000 -p 9200:9200
    cp.icr.io/cp/webmethods/universalmessaging/universalmessaging-server:11.1

    where "$(pwd)" resolves to the current working directory.