Starting and stopping MQIPT

We can start MQIPT either from the command line, or make it start automatically when the system is started. We can stop MQIPT by using either the Administration Client or the command line.

Starting MQIPT from the command line

MQIPT is installed into an installation directory, such as:

• /opt/mqipt, with executable scripts in /opt/mqipt/bin
• C:\MQIPT, with executable scripts in C:\MQIPT\bin

MQIPT also uses a home directory, which contains the configuration file mqipt.conf and any files that are output by MQIPT when it is running. The following subdirectories of the MQIPT home directory are created automatically when MQIPT is invoked for the first time:

• An errors directory in which any First Failure Support Technology (FFST) and trace files are written
• A logs directory in which the connection log is kept

The user ID under which MQIPT runs must have permission to create these directories, or alternatively the directories must already exist and the user ID must have permission to create, read, and write files in them. Also, if you are using a Security Manager policy then the security policy must grant the required permissions for these directories. For more information about Security Manager policy settings refer to Java Security Manager.

We can use the installation directory as a home directory. If we use this directory, you must ensure that the user ID under which MQIPT runs has the appropriate permissions, and that any Security Manager policy is configured correctly.

To start MQIPT, enter the following command:

• On Windows systems:

  MQIPT_INSTALLATION_PATH\bin\mqipt MQIPT_HOME_DIR
  

• On UNIX and Linux systems:

  MQIPT_INSTALLATION_PATH/bin/mqipt MQIPT_HOME_DIR
  

Note that the MQIPT home directory can be specified as either an absolute path or relative to the current working directory of the command shell. Console messages show the status of MQIPT. If an error occurs, see Troubleshooting and support. The following messages are an example of the output when MQIPT starts successfully:

5639-L92 (C) Copyright IBM Corp. 2000, 2020. All Rights Reserved
MQCPI001 IBM WebSphere MQ Internet Pass-Thru V2.1.0.0 starting
MQCPI004 Reading configuration information from mqipt.conf
MQCPI021 Password checking has been enabled on the command port
MQCPI008 Listening for control commands on port 1881
MQCPI011 The path C:\MQIPT\logs will be used to store the log files
MQCPI006 Route 1414 is starting and will forward messages to :
MQCPI034 ....examplehost(1414)
MQCPI035 ....using MQ protocols
MQCPI057 ....trace level 5 enabled
MQCPI078 Route 1414 ready for connection requests

Starting MQIPT automatically

To start MQIPT automatically when the system is started, use the mqiptService command to install the MQIPT service.

• On Windows systems, see Use a Windows service control program.
• On other platforms, see Use a UNIX or Linux init.d system service.

Stop MQIPT

We can stop MQIPT by using either the Administration Client or the command line.

• To use the Administration Client, mqiptGui, see Use the IPT Administration Client.
• To use the command line administration tool, mqiptAdmin, see Administer MQIPT by using the command line.