Skip to main content

Installing IBM WebSphere MQ Workflow for AIX - Middleware News

Restriction: Advanced workflow is only available in a DB2® environment. It is not available in an Oracle environment.

Accepting the licensing terms

Before you start installing WebSphere MQ and WebSphere MQ Workflow, you need to run the mqlicense.sh (found on the WebSphere MQ CD-Rom) to accept the software licensing terms. After you finish installing WebSphere MQ, you need to run the setmqcap command. This command sets the purchased processor allowance. Please refer to the kWebSphere MQ manuals for additional details.
Similarly, before you run the WebSphere MQ Workflow silent install script (CMBWFAIXInstall.sh), you need to run the WSMQWFlicense.sh (found on the WebSphere MQ Workflow CD-Rom) to accept the WebSphere MQ Workflow license.

Installing WebSphere MQ on AIX

Before you can install WebSphere MQ for AIX® you must create and mount a /var/mqm file system, or /var/mqm/var/mqm/log, and /var/mqm/errors file systems.
Allow a minimum of 30 MB of storage for /var/mqm, 2 MB of storage for /var/mqm/errors, and 20 MB of storage for /var/mqm/log if you choose to create separate file systems.
To use SMIT for the installation:
  • Log in to SMIT with root authority. From the shell, enter: smit
  • Select the appropriate device appropriate for your installation using this sequence of windows:
    • Software Installation and Maintenance
    • Install and Update Software
    • Install and Update from latest available software
You can also use the alternative fast path command:
  • smitty install_latest
  1. Press List to display the Single Select List window.
  2. Select: /dev/cd0 (CD-ROM Drive)Select Do to display the parameters for Install Latest Level.
  3. Press F4 to obtain a list of components to install.
  4. Press Enter.
  5. If you have a previous version of the product on your system, change the Auto Install prerequisite software to No and Overwrite existing version to Yes.
  6. Select Do to install the software.
Tip: If you want to verify as root, you must add Root to the mqm group

WebSphere MQ AIX installation verification procedures

This section describes how to verify a local (standalone) installation, involving no communication links to other WebSphere MQ system.
Follow the steps in this section to install and test a simple configuration of one queue manager and one queue. In this process, you use sample applications to put a message onto the queue and to read the message from the queue.
  1. Install WebSphere MQ for AIX on the workstation (include the Base Server component as a minimum).
  2. Create a default queue manager (in this example called venus.queue.manager):
    1. At the command prompt in the window enter: crtmqm -q venus.queue.manager
    2. Press Enter. Messages are displayed telling you that the queue manager has been created, and that the default WebSphere MQ objects have been created.Tip: In prior releases of WebSphere MQ, it was necessary to run a script file called amqscoma.tst to define the WebSphere MQ default objects. This step is not required in this release of the product.
  3. Start the default queue manager:
    • Enter strmqm and then press Enter:
    • A message tells you when the queue manager starts.
  4. To enable MQSC commands, enter runmqsc and press Enter.Tip: MQSC has started when the following message appears: Starting MQ Commands. MSQC has no command prompt.
  5. Define a local queue (in this example, called ORANGE.QUEUE):
    • Enter define qlocal (orange.queue). and press Enter. Any text entered in MQSC in lowercase is converted automatically to uppercase unless you enclose it in single quotation marks. This means that if you create a queue with the name orange.queue, you must refer to it in any commands outside MQSC as ORANGE.QUEUE. The message MQ queue created is displayed when the queue is created.
    You have now defined a default queue manager called venus.queue.manager and a queue called ORANGE.QUEUE.
  6. To Stop MQSC, press Ctrl-D, or enter end and press Enter. The following message appears: Enter.The following message is displayed:
    One MQSC commands read No commands have a syntax error. All valid
    MQSC commands were processed.
    The command prompt is displayed again.
To test the queue and queue manager, use the samples amqsput (to put a message on the queue) and amqsget (to get the message from the queue) as described in the following steps.
  1. Change to /usr/mqm/samp/bin.
  2. To put a message on the queue, enter amqsput ORANGE.QUEUE and press Enter.The following message appears:
    sample amqsput0 start
    target queue is ORANGE.QUEUE
  3. Enter any message text and press Enter two times.The following message appears:
    Sample amqsput0 end
If required, change to /usr/mqm/samp/bin
To get the message from the queue, enter amqsget ORANGE.QUEUE. and press Enter. The following occurs:
  • The sample program starts.
  • Your message is displayed.
  • The sample ends.
  • The command prompt is displayed again.
The verification is complete.

Installing IBM WebSphere MQ Workflow on AIX

Creating user ID and groups
  1. Log on as root.
  2. Enter command mkgroup fmcgrp
  3. Verify that WebSphere MQ Administrator mqm exists.
  4. Verify that DB2 database administrator group db2iadml exists.If it does not exist, check to see that you have installed DB2 correctly. If your DB2 Administrator group has a different name, be careful to substitute it whenever the default db2iadml is mentioned.
  5. Follow these steps to create an WebSphere MQ Workflow Administration user. Notice that the WebSphere MQ Workflow Administration user ID (for example, fmc) must have WebSphere MQ and DB2 administration rights. Use the following command to create the user. The following example assumes the db2 instance is of the db2iadm1 group.
    mkuser -a pgrp=fmcgrp groups=mqm,db2iadm1 fmc
  6. Set the password for user fmc with the command: passwd fmc, Alternatively, you can create the fmc user and the fmcgrp group using SMIT.
  7. Modify fmc's login file to include locale information. For example: export LANG=en_US. WebSphere MQ Workflow runtime needs that locale information to look up message bundles.
  8. Establish the use of db2 environment in fmc's profile. You can achieve this by including in the fmc's profile including the db2profile of the db2 instance which owns the WebSphere MQ Workflow runtime database. For example, include the following in the fmc's profile. The example assumes the db2inst1 is the instance owner and db2inst1 is used for the WebSphere MQ Workflow runtime database.
    export DB2INSTANCE=db2inst1
    if [ -e /home/$DB2INSTANCE/sqllib/db2profile ]; 
    then    . /home/$DB2INSTANCE/sqllib/db2profile fi
Installing WebSphere MQ Workflow on AIX
The WebSphere MQ Workflow runtime data will use /var/fmc by default. Depend on usage, it would take about 100MB to 400MB of disk space. It is recommended to check to see if the system has sufficient disk space before the installation is attempted.

  1. Log in to AIX as root.
  2. Insert the WebSphere MQ Workflow installation disk into the CD-ROM drive.
  3. Mount the CD-ROM by entering the command:
    Mount -oro -v cdrfs /dev/cd0 /cdrom
  4. Copy all the files in the workflow directory from the CD-ROM to a temporary directory (for example, /tmp/workflow).
  5. Specify the locale for this installation as well as the following configuration session. For example: export LANG=en_US.
  6. Enter: CMBWFAIXInstall.sh /cdrom to start installing the WebSphere MQ Workflow.Tips: If you choose smitty to install the WebSphere MQ Workflow, do not choose the fmcdefault (default configuration) package. Instead, always follow the next section to prepare the WebSphere MQ Workflow configuration for the DB2 Information Integrator for Content workflow.

Comments

adsrerrapop

Popular posts from this blog

IBM Websphere MQ interview Questions Part 5

MQ Series: - It is an IBM web sphere product which is evolved in 1990’s. MQ series does transportation from one point to other. It is an EAI tool (Middle ware) VERSIONS:-5.0, 5.1, 5.3, 6.0, 7.0(new version). The currently using version is 6.2 Note: – MQ series supports more than 35+ operating systems. It is platform Independent. For every OS we have different MQ series software’s. But the functionality of MQ series Default path for installing MQ series is:- C: programfiles\BM\clipse\SDK30 C: programfiles\IBM\WebsphereMQ After installation it will create a group and user. Some middleware technologies are Tibco, SAP XI. MQ series deals with two things, they are OBJECTS, SERVICES. In OBJECTS we have • QUEUES • CHANNELS • PROCESS • AUTHENTICATION • QUERY MANAGER. In SERVICES we have LISTENERS. Objects: – objects are used to handle the transactions with the help of services. QUEUE MANAGER maintains all the objects and services. QUEUE: – it is a database structure

IBM Websphere MQ Reason code list / mq reason codes / websphere mq error codes / mq error messages

Reason code list ================= The following is a list of reason codes, in numeric order, providing detailed information to help you understand them, including: * An explanation of the circumstances that have caused the code to be raised * The associated completion code * Suggested programmer actions in response to the code * 0 (0000) (RC0): MQRC_NONE * 900 (0384) (RC900): MQRC_APPL_FIRST * 999 (03E7) (RC999): MQRC_APPL_LAST * 2001 (07D1) (RC2001): MQRC_ALIAS_BASE_Q_TYPE_ERROR * 2002 (07D2) (RC2002): MQRC_ALREADY_CONNECTED * 2003 (07D3) (RC2003): MQRC_BACKED_OUT * 2004 (07D4) (RC2004): MQRC_BUFFER_ERROR * 2005 (07D5) (RC2005): MQRC_BUFFER_LENGTH_ERROR * 2006 (07D6) (RC2006): MQRC_CHAR_ATTR_LENGTH_ERROR * 2007 (07D7) (RC2007): MQRC_CHAR_ATTRS_ERROR * 2008 (07D8) (RC2008): MQRC_CHAR_ATTRS_TOO_SHORT * 2009 (07D9) (RC2009): MQRC_CONNECTION_BROKEN * 2010 (07DA) (RC2010): MQRC_DATA_LENGTH_ERROR * 2011 (07DB) (RC2011): MQRC_DYNAMIC_Q_NAME_ERROR * 2012 (07DC) (RC201

IBM WebSphere MQ – Common install/uninstall issues for MQ Version on Windows - Middleware News

Creating a log file when you install or uninstall WebSphere MQ WebSphere MQ for Windows is installed using the Microsoft Installer (MSI). If you install the MQ server or client through launchpad , MQPARMS or setup.exe , then a log file is automatically generated in %temp% during installation. Alternatively you can supply parameters on the installation MSI command msiexec to generate a log file, or enable MSI logging system-wide (which generates MSI logs for all install and uninstall operations). If you uninstall through the Windows Add/Remove programs option, no log file is generated. You should either uninstall from the MSI command line and supply parameters to generate a log file, or enable MSI logging system-wide (which generates MSI logs for all install and uninstall operations). For details on how to enable MSI logging, see the following article in the WebSphere MQ product documentation: Advanced installation using msiexec For details on how to enable system-w