Installing the MessageQ Client

 

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

• Installation Prerequisites

• Installation Procedures

• Uninstalling MessageQ Client for Windows

Installation Prerequisites

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

• Hardware

• Software

• Disk space

• System disk backup

Hardware Requirements

To perform the installation, you need the following hardware:

• Processor: Intel 486 or higher, or Digital Alpha

• CD-ROM drive to read software distribution media

• Approximately 3MB of free disk space

Software Requirements

Your system must meet the following software requirements before you can run the MessageQ Client software.

• The MessageQ for UNIX or Windows NT product must be installed on a server machine and a message queuing group must be configured to support the requirements of your messaging application environment. The MessageQ Client applications use messaging resources, including message queues, message buffers, and system resources on the server system. See the Installation and Configuration Guide for your MessageQ server system and review the system resource requirements for using MessageQ in your environment.

• When using TCP/IP, the host names for the client and server systems must be properly identified in the hosts files on both the client system and the MessageQ server system. Refer to the TCP/IP documentation provided by your vendor for the hosts file location.

• A Windows Sockets, Version 1.1-compliant TCP/IP protocol implementation must be available to communicate with the remote MessageQ server system. On Windows NT and Windows 95 this is provided by wsock32.dll.

• Before attempting to use the MessageQ Client, verify the TCP/IP connection between the client and server system using the ping utility. For more information about TCP/IP networking, see the documentation for your client and server systems.

• A programming development environment, such as Visual Basic, Visual C++, or Borland C++ that will allow you to use the MessageQ Client API or Custom Controls.

For a complete description of MessageQ server systems and TCP/IP transports supported by the MessageQ Client, see the MessageQ Client for Windows Release Notes.

Platforms and Transports Supported

This section describes the hardware, operating systems, and network transports supported by MessageQ Client for Windows, Version 5.0.

Client Platforms Supported

The MessageQ Client supports operating system and network environments as listed in Table 2-1.

Table 2-1 Supported Client Platforms

Operating System	Transports
Windows NT 4.0 (Intel or Alpha)	Windows NT TCP/IP
Windows 95/98	Windows 95 TCP/IP

MessageQ Server Compatibility

The MessageQ Client runs with all MessageQ, Version 2.1 or higher message server implementations with the following exceptions:

• The CLS Security Utility requires MessageQ for UNIX or MessageQ for Windows NT, Version 3.1 or later or MessageQ for OpenVMS, Version 4.0 or later.

• Use of features such as self-describing messages, handle-based messages, global naming, and selective broadcast services require MessageQ for OpenVMS, MessageQ for UNIX, or MessageQ for Windows NT systems, Version 4.0 or Version 4.0A.

• Use of features such as FML messaging, double pointers, correlation identifier, and transparent messaging between BEA MessageQ and BEA TUXEDO require Message Q for UNIX or Windows NT Version 5.0.

Disk Space Requirements

MessageQ Client systems require approximately 3 megabytes of free disk space to hold the MessageQ 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 your Microsoft Windows system documentation.

Installing on Systems Already Running the MessageQ Client

If you have a previous version of the MessageQ Client already installed on your system, we recommend that you install Version 5.0 software in the default installation directory, c:\...\BEA Systems\MessageQ.

Regardless of the directory in which the product is installed, the icons for the Program Manager are overwritten to point to the new installation. If a previous version is installed, you will not be able to access it from the Program Manager using the icons.

Installing the MessageQ Client

The following procedure describes how to install MessageQ Client for Windows software.

Note: You can stop the installation procedure at any time by clicking Exit in the Installation Options dialog. You can also return to the previous dialog by clicking Back.

1. Log into the Administrator account.

2. Load the MessageQ distribution CD-ROM into the CD reader.

3. Open Windows Explorer.

4. Double-click the applicable folder based on your system processor: WinNT for the Intel version and AlphaNT for the Alpha version.

5. Double-click setup.exe to start the installation.

6. Click Next after the SETUP utility displays the dialog box that welcomes you to the MessageQ software installation.

7. If you have BEA TUXEDO installed on your system, select a BEA TUXEDO version to install upon and click Next. You can also install MessageQ as a standalone product.

8. Choose the destination location and click Next. The default installation for MessageQ is C:\Program Files\BEA Systems\BEA MessageQ.

9. Choose between a Compact or Custom installation and click Next. (The Compact installation installs the MessageQ Client for Windows files and the Release Notes. The Custom installation allows you to choose specific components to install.)

10. If you select a Custom installation, you are prompted to select the components you want to install and click Next. The Select Components box displays a description of the selected component and shows you information on space required and space available.

11. Choose the Program Folder name and click Next.

12. After BEA MessageQ has been successfully installed and all files are transferred to your system, click Finish to complete the installation.

Figure 2-1 shows the MessageQ program group created after a Typical installation is complete.

Figure 2-1 MessageQ Program Group Server Icons

Table 2-2 describes the program group utility icons.

Table 2-2 Utility Group Programs

MessageQ Icon	Description
MessageQ Client Configuration Utility	Windows-based program that lets you configure automatic failover, message recovery services, minimize network packets (MPP) protocol, logging, and tracing.
MessageQClient MRS Utility	Windows-based program that lets you view the contents of local store-and-forward (SAF) journals.
MessageQ CLS Security Utility	Windows-based program that allows a MessageQ administrator to define a list of MessageQ client systems that can attach to CLS.
MessageQ Client Test Utility	Windows-based program that enables you to test message exchanges between the queues you configured.

If you encounter a problem while using MessageQ and you believe the error is caused by a problem with MessageQ, contact BEA Customer Support for assistance.

Adding the MessageQ Client File Drive and Directory to Your Path

After completing the installation procedure, you can verify that the MessageQ Client software is successfully installed on your system.

Ensure that the files listed in Table 2-3 are located in directories identified by the PATH environment variable:

Table 2-3 PATH Environment Variable

Windows NT or Windows 95
dmqcl32.dll
dmq.ini (Optional: Configuration can be stored in the Registry)
TCP/IP DLL

• Add the MessageQ \bin directory to your PATH environment variable. The default location is c:\...\BEA Systems\MessageQ\bin.

• To compile and link MessageQ Client applications, add the following directories to the INCLUDE and LIB environment variables as shown in Table 2-4.

  Table 2-4 INCLUDE and LIB Environment Variables

  Environment Variable	Default Directory
  INCLUDE	c:\...\BEA Systems\MessageQ\include
  LIB	c:\...\BEA Systems\MessageQ\lib

Uninstalling the MessageQ Client

To remove the MessageQ Client from your system, use the Add/Remove Programs utility on your system's Control Panel.