6.1 Installing IBM WebSphere MQ on Win32

As part of installing WebSphere for the driver, you should complete the following tasks consecutively. These instructions are for Windows, but you can follow the same procedure for other platforms.

6.1.1 Placing Prerequisite Jar Files and Scripts

  1. On your messaging server, locate the following jar files:

    • com.ibm.mq.jar
    • com.ibm.mq.pcf.jar
    • com.ibm.mqjms.jar
    • connect.jar
    • dhbcore.jar
    • jta.jar
    • mqcontext.jar

  2. Copy the jar files to the Identity Manager server.

    The following table identifies where to place jar files on an Identity Management server, by platform.

    Platform

    Directory Path

    Windows

    Local installation: novell\NDS\lib

    Remote installation: novell\RemoteLoader\lib

    NetWare®

    Local installation: sys:\system\lib

    Linux/UNIX

    Local installation: /usr/lib/dirxml/classes (pre-eDirectory 8.8) or opt/novell/eDirectory/lib/dirxml/classes (eDirectory 8.8)

    Remote installation: /usr/lib/dirxml/classes (pre-eDirectory 8.8) or /opt/novell/eDirectory/lib/dirxml/classes (eDirectory 8.8)

  3. Locate where you installed the installation script during the JMS driver installation. The following table indicates the default directories where scripts are installed, by platform.

    Platform

    Directory Path

    Windows

    C:\Novell\NDS\DirXMLUtilities\jms\webmq

    NetWare

    sys:\System\DirXMLUtilities\jms\webmq

    Linux\UNIX

    install-dir/lib/dirxml/rules/jms\webmq

  4. Copy the script to your messaging server.

  5. If necessary, restart your eDirectory™ server.

6.1.2 Create a Default Queue Manager

The following instructions are for Windows; equivalent steps vary by platform.

Manually Create a Queue Manager through WebSphere MQ Explorer

  1. Click Start > Programs > IBM WebSphere MQ > WebSphere MQ Explorer.

  2. Right-click the IBM WebSphere MQ > Queue Managers folder.

  3. Select New > Queue Manager.

  4. Fill in the Name field.

  5. Select the Make this the default queue manager.

  6. Click the Finish button and wait for the operation to finish.

Set Up Auto-start for the Topic Message Broker

  1. Click Start > Programs > IBM WebSphere MQ > WebSphere MQ Explorer

  2. Right-click the IBM WebSphere MQ > Queue Managers > Advanced > Services folder.

  3. Select New > Service.

  4. Fill in the Name field.

  5. Under General:

    1. Set the Service control field to Queue Manager Start.

    2. Set the Start command field to strmqbrk.

    3. Set the Stop command field to endmqbrk.

6.1.3 Create a Server-Connection Channel and Queues

  1. From the command line, change directories to Program Files\IBM\WebSphere MQ\Java\bin.

  2. From the command line, execute the following command:

    runmqsc QM < idm_mq_install.mqsc

This file is provided only as an example, you might need to customize the content .

6.1.4 Start Publish/Subscriber Broker

  1. From the command-line, execute the following command:

    strmqbrk -m QM

You should see a message indicating that the broker is running.

6.1.5 Install System Queues Necessary for Publish/Subscribe

  1. From the command-line, execute the following command:

    runmqsc QM < MQJMS_PSQ.mqsc

You should see some tracing indicating successful queue creation.

6.1.6 Setting Up JMS

Download the following support packs:

  1. Decompress the support packs and copy the mqcontext.jar and com.ibm.mq.pcf.jar files to the Program Files\IBM\WebSphere MQ\Java\lib directory.

  2. Edit file Program Files\IBM\WebSphere MQ\Java\bin\JMSAdmin.bat:

    @echo off
::add this line at the beginning of the file
setlocal

::add these lines before call to java
set CLASSPATH=%CLASSPATH%;%MQ_JAVA_LIB_PATH%\com.ibm.mq.pcf.jar
set CLASSPATH=%CLASSPATH%;%MQ_JAVA_LIB_PATH%\mqcontext.jar
set    JRE_PATH=C:\Program Files\IBM\WebSphere MQ\gskit\jre               

::replace call to Java
"%JRE_PATH%\bin\java" -cp "%CLASSPATH%" 
-DMQJMS_INSTALL="%MQ_JAVA_INSTALL_PATH%" -DMQJMS_LOG_DIR="%MQ_JAVA_DATA_PATH%"\log -DMQJMS_TRACE_DIR="%MQ_JAVA_DATA_PATH%"\errors -DMQJMS_INSTALL_PATH="%MQ_JAVA_INSTALL_PATH%" com.ibm.mq.jms.admin.JMSAdmin %1 %2 %3 %4 %5

::add this line at end of file
endlocal

  3. Edit the Program Files\IBM\WebSphere MQ\Java\bin\JMSAdmin.config file.

    # comment out all of the INITIAL_CONTEXT_FACTORY lines using
# comment char “#” and add this line:

INITIAL_CONTEXT_FACTORY=com.ibm.mq.jms.context.WMQInitialContextFactory

# comment out all PROVIDER_URL lines and add this one:
PROVIDER_URL=localhost:1414/SYSTEM.DEF.SVRCONN

  4. From the command line, change directories to Program Files\IBM\WebSphere MQ\Java\bin.

  5. From the command line, execute the following command:

    JMSAdmin.bat -v < idm_jms_install.scp

This file is provided as an example only, you may need to customize the content.

6.1.7 Create a User Account

To create a User:

  1. Click Start > Programs > Administrative Tools > Computer Management.

  2. Expand Local Users and Groups subtree.

  3. Right-click the Users folder > select New User.

  4. Specify a username. The scripts referenced in these instructions assume idm.

  5. Specify a password. The scripts referenced in these instructions assume novell.

  6. Deselect the User must change password at next login check box.

  7. Click the Create button.

  8. Click the Close button.

To make the User a member of the mqm Group

  1. Right-click the newly created user > Select Properties.

  2. Select the Member Of tab.

  3. Left-click the mqm group

  4. Click Add.

  5. Click OK twice.