Create the Liberty server definition

If you installed the IBM MQ for z/OS® Unix System Services Web Components, and want to use the MQ Console, or the REST API, you need to create and customize the Liberty server definition.

Before you begin

• You need to perform this task once for each z/OS system where you want to run the MQ Console or REST API.
• You need a Liberty server for each version of IBM MQ that is running.
• You might need to refresh or modify the server configuration when migrating from a previous version.

IBM MQ for z/OS Unix System Services Web Components requires the creation of a single Liberty server, called mqweb.

The server configuration and log files are all stored under the Liberty user directory.

Procedure

1. Choose a suitable location for the Liberty user directory. The user ID that the mqweb server runs under, needs read and write access to this user directory and its contents. As this user directory will contain log files, as well as the server configuration, you should create this directory in a separate file system.
2. Ensure that your current directory is PathPrefix/web/bin, which is the location of the crtmqweb.sh script. PathPrefix is the IBM MQ Unix System Services Components installation path.
3. Create the Liberty user directory, containing the template mqweb server definition, by running the crtmqweb.sh script. Note: The crtmqweb.sh script accepts one optional parameter - the name of the Liberty user directory.

   If we do not supply a name for the Liberty user directory, a default value of /var/mqm/web/installation1 is used.

4. Change the ownership of the directories and files in the Liberty user directory, so that they belong to the user ID and group that the mqweb server runs under, using the command:

   chown -R userid:group path

   To give the group write access to the path, issue the command:

   chmod -R 770 path

What to do next