Configuring the stand-alone IBM MQ Web Server

From IBM® MQ 9.3.5, you can run the mqweb server that hosts the IBM MQ Console and REST API in a stand-alone IBM MQ Web Server installation.

1. Create the IBM MQ Web Server data directory.
   The data directory is used to store the configuration and log files for the mqweb server that runs the IBM MQ Console and REST API. You can use any directory that you choose as the IBM MQ Web Server data directory.
   The user ID that you use to start the mqweb server must be granted read and write access to the data directory.
2. Set the MQ_OVERRIDE_DATA_PATH environment variable to the data directory that you created in step 1.
   For example, if you chose to use /var/mqweb as your IBM MQ Web Server data directory, issue the following command:

   export MQ_OVERRIDE_DATA_PATH=/var/mqweb

3. Use the setmqenv command to set up the IBM MQ environment.
   Change to the bin directory of the IBM MQ Web Server installation directory, then issue the following command:

   . setmqenv -s

4. Use the crtmqdir command to create the IBM MQ directories and files, in the data directory. The files that are created include a template definition for the mqweb server.
   Issue the following command:

   crtmqdir -s -f

5. Optional: If this mqweb server is the first that you created to run with this installation of the stand-alone IBM MQ Web Server, use the mqlicense command to review and accept the IBM MQ license.
   You must run this command as a user that has write access to the IBM MQ Web Server installation directory.
   For example, issue the following command to view the IBM MQ license:

   mqlicense

   For more information, see mqlicense.
6. Optional: To migrate an existing mqweb server to run in the newly configured stand-alone IBM MQ Web Server installation, complete the following steps:
   1. Back up your existing mqweb server configuration.
   2. Restore the files into the MQ_OVERRIDE_DATA_PATH/web/installations/MQWEBINST directory, where MQ_OVERRIDE_DATA_PATH is the IBM MQ Web Server data directory that you created in step 1.

   For more information, see Backing up and restoring your mqweb server configuration.
   Note: Some features of the IBM MQ Console and REST API are not available in a stand-alone IBM MQ Web Server installation. If you migrate a mqweb server from an IBM MQ installation to a stand-alone IBM MQ Web Server installation, these features cannot be used after migration. For more information about the restrictions that apply in a stand-alone IBM MQ Web Server installation, see The IBM MQ Console and REST API.