BEA Logo BEA MessageQ Release 5.0

  Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy


   MessageQ Doc Home   |   Client for UNIX User's Guide   |   Previous Topic   |   Next Topic   |   Contents   |   Index

Installing the MessageQ Client


This chapter describes how to install the MessageQ Client for UNIX software. It includes the following topics:

Preinstallation Requirements

To successfully install MessageQ Client for UNIX software on your client machine, you must ensure that your environment meets the following installation requirements:

Refer to the BEA MessageQ Release Notes for specific hardware and software environments that are supported by this product.

You may need to be able to log in as root (superuser) on the system where you are installing MessageQ if your system requires you to mount the cdrom drive as root. Otherwise, unless you need to uninstall a version of MessageQ prior to V5.0, or you want your new MessageQ installation to be owned by root, there is no need to be logged in as root to install MessageQ.

Any installation of BEA MessageQ with a version less than 5.0 must be uninstalled prior to using BEA MessageQ 5.0 or later. Prior to V5.0, only one version of BEA MessageQ was allowed to be installed on any single machine at a time, and the installation procedure symbolically linked files into the /usr/bin, /usr/lib, /usr/man, etc. directories. Starting with V5.0, installation files are no longer placed in any subdirectory of /usr, and multiple versions may be installed one a single machine as long as they are all V5.0 or later. If you do not uninstall MessageQ installations with versions less than 5.0 before you attempt to use V5.0 or later installations of MessageQ, you may experience serious operational problems. See the BEA MessageQ Installation and Configuration Guide for UNIX for instructions on uninstalling older versions of MessageQ.

Software Requirements

Your environment must meet the following software requirements to run install the MessageQ Client for UNIX software:

  1. You must install MessageQ Server software on a UNIX or Windows NT system. In addition, a minimum of one message queuing bus and one message queuing group must be configured. The group must also be configured to run the MessageQ Client Library Server (CLS).

    For information on how to install and configure MessageQ Server software, refer to the installation and configuration guide for the platform that you are using.

  2. Network software must be installed and running. TCP/IP networking is supported on all platforms.

  3. If you intend to develop client applications, you must have a program development environment that allows you to compile and link your applications.

Disk Space Requirements

MessageQ Client for UNIX systems requires approximately 2 megabytes of free disk space to store the MessageQ Client installation files.

Backing Up Your System Disk

We recommend that you back up your system disk before installing any software. For details on performing a system disk backup, see the system documentation for your server platform.

Choosing Installation Options

The MessageQ for UNIX installation dialogue displays a list of options that let you choose installation options. If you choose a package or option and then decide you don't want to install it, you can cancel your selection and redisplay the list of options. The installation options include:

Table 2-1 describes the installation packages.

Table 2-1 MessageQ Packages

Installation Subset



MessageQ software for UNIX platforms.

MessageQ Online Documentation

MessageQ Online Documentation in HTML format.

Table 2-2 describes the installation options for connecttivity with BEA TUXEDO..

Table 2-2 MessageQ Connectivity Options

Installation Subset



Install MessageQ over an existing BEA TUXEDO V6.4 installation.

BEA M3 2.1

Install MessageQ over an existing BEA M3 V2.1 installation


Install MessageQ as a standalone product, with no BEA TUXEDO or BEA M3 connectivity.

Table 2-3 describes the installation options.

Table 2-3 MessageQ Installation Options

Installation Subset


Both client and server

Installed on licensed systems used for developing or running MessageQ applications. This option includes the Client Library Server, include files, and examples. The programming examples that illustrate how applications can use interprocess message queuing to exchange information. For more information about the programming examples, refer to the Programmer's Guide.

Client Library

Provides remote client applications access to message queuing using MessageQ for UNIX. This option also installs the MessageQ include files.

Installing the MessageQ Client for UNIX Software

The following describes how to install MessageQ Client for UNIX software on UNIX systems from supported vendors. You can stop the installation procedure at any time by using the -q option or the terminal interrupt key sequence for your UNIX system (see your UNIX system documentation for a description of the terminal interrupt key sequence). If you stop the installation, files created up to that point are not automatically deleted. You must delete these files manually.

The steps to install the MessageQ Client for UNIX are as follows:

  1. Mount the CD-ROM media.

    Place the CD-ROM media in the CD-ROM tray and close the door. If your system automatically mounts your CD-ROM media when the door is closed, you may proceed to the next step.

    Depending on your system, you may have to manually mount the CD-ROM media. You may have to do this logged in as root (superuser). If you must log in as root to mount the CD-ROM media, do so now.

    If you do not have a standard procedure or tool for mounting CD-ROM media, use the following table of platform specific syntax information::


    mount -v cdrfs -r device directory

    Digital UNIX

    mount -t cdfs -r device directory


    mount -F cdfs -r device directory


    mount -F cdfs -r device directory

    SCO Unixware

    mount -r device directory

    SCO OpenServer

    mount -r device directory

    Sequent DYNIX

    mount -r device directory


    mount -t hsfs -r device directory

    Note: When installing the MessageQ Client for UNIX on Solaris systems, ensure that the lsocket and lnsl libraries are present on the system. These libraries are required when compiling.

  2. Run the installation script.

    Note that it is not necessary to be logged in as root (superuser) to install MessageQ as long as you have permission to write to the directory where you direct the installation script to install MessageQ.

    Before you run the installation script, move to the directory where the CD-ROM media is mounted. Assuming you mounted the CD-ROM media on directory /cdrom, you would issue the following command:

    %cd /cdrom

    (If your CD-ROM media was automatically mounted, or you used a different tool or process than outlined in the previous step, you may have to move to a subdirectory of the mount point in order to successfully install MessageQ.)

    After you have moved to the appropriate directory, determine the case of the installation script name. This depends on what options or tools you used to mount your CD-ROM media. You are looking for a file named or INSTALL.SH. Issue the following command to determine whether the script name is lower case or upper case:


    If the script name is in lower case letters, issue the following command:

    % sh ./

    otherwise, issue the command like this:

    % sh ./INSTALL.SH

    A list of supported platforms (operating system and machine or processor type) is displayed.

    01) aix41/rs6000 02) aix42/rs6000 03) aix43/rs6000
    04) dux/alpha 05) dynix/i386 06) hpux10/hppa
    07) hpux11/hppa 08) mpras/x86 09) sco/x86
    10) sco_uw/x86 11) sol251/sparc 12) sol26/sparc

    The following table provides detailed platform information:


    IBM AIX 4.1.4, RS/6000 SP2


    IBM AIX 4.2.1, RS/6000 SP2


    IBM AIX 4.3, RS/6000 SP2


    Digital UNIX 4.0, Alpha


    Sequent DYNIX ptx 4.4.1, Intel 386


    HP HP-UX 10.2, HPPA


    HP HP-UX 11, HPPA


    NCR MP-RAS 3.01 or 3.02, Intel x86


    SCO OpenServer 5, Intel x86


    SCO UnixWare 2.1, Intel x86


    Sun Solaris 2.5.1, SPARC


    Sun Solaris 2.6, SPARC

  3. Enter the number next to the selected installation platform:

    Install which platform's files? [01-    12, q to quit, l for list]: 4

    ** You have chosen to install from dux/alpha **

  4. Confirm your choice of platform:

    BEA MessageQ 5.0

    This directory contains the BEA MessageQ Core System for
    Digital Unix 4.0 on DEC Alpha.

    Is this correct? [y,n,q]: y

    The following MessageQ packages are listed.

      1    msgq           BEA MessageQ
    2 msgqdoc BEA MessageQ Online Documentation

  5. Select the packages you wish to install:

    Select the package(s) you wish to install (or 'all' to install
    all packages) (default: all) [?,??,q]: 1

    Copyright and trademark information is displayed:

    BEA MessageQ
    (alpha) Release 5.0
    Copyright (c) 1998 BEA Systems, Inc.
    Portions * Copyright 1986-1998 RSA Data Security, Inc.
    All Rights Reserved.

  6. Select one of the following connectivity options in respect to BEA TUXEDO:

    The following connectivity options are available:

      1    tux64          Install On Top Of BEA TUXEDO v6.4
    2 tux65 Install On Top Of BEA TUXEDO v6.5
    3 none Install Without BEA TUXEDO

    Select an option (default: none) [?,??,q]: 3

  7. Select one of the following connectivity options in respect to other BEA Systems products:

    The following connectivity options are available:

      1     tux64           Install On Top Of BEA TUXEDO v6.4
    2 m3_21 Install On Top Of BEA M3 v2.1
    3 none Install Without BEA TUXEDO

    Select an option (default: none) [?,??,q]: 2

    Note: The BEA M3 V2.1 installation option is only available on platforms where BEA M3 V2.1 is supported.

  8. Select one of the following installation options with respect to client and server environments:

    The following installation options are available:

      1     both            Server and client
    2 client Client only

    Select an option (default: both) [?,??,q]: 2

  9. Specify the directory where MessageQ files are to be installed:

    Directory where MessageQ files are to be installed [?,q]: /opt/messageq
    Creating /opt/messageq

    The system determines if sufficient space is available in the installation directory, unloads the files for the selected installation options, and sets file permissions:

    Determining if sufficient space is available ...
    2000 blocks are required
    1361008 blocks are available to /opt/messageq

    Using /opt/messageq as the MessageQ base directory

    Changing file permissions...
    .. finished

    Installation of BEA MessageQ was successful

    Please don't forget to fill out and send in your registration card

    Before you unmount your CD-ROM media, don't forget to move out of the /cdrom directory or you will get a message that the /cdrom device is busy:

    % cd /
    % umount /cdrom

Once MessageQ software is installed, see the Postinstallation Tasks topic in the MessageQ for UNIX Installation and Configuration Guide.

Recovering from Errors During the Installation

If errors occur during the MessageQ Client installation procedure, recheck your preinstallation steps to ensure that the correct versions of prerequisite software have been installed. Errors can occur during the installation if the following conditions exist:

For descriptions of the error messages generated by these conditions, see the system management documentation for the UNIX system that you are using. If an error occurs while installing MessageQ and you believe the error is caused by a problem with the MessageQ Client for UNIX software, call BEA Technical Support at the number provided in the Preface.

Adding the Initialization File Directory to Your PATH

The dmq.ini template file is installed in the /templates subdirectory.

Copy the template to a local directory or a directory shared by multiple users, then add that directory to your PATH. Refer to Chapter 3, "Configuring the MessageQ Client" for instructions on using the configuration utility to specify dmq.ini options.