To Install Message Queue on Solaris

1. Read the product license. Installation and use of the product are subject to acceptance of the license agreement.

2. Download the Message Queue product distribution file from the Web site into an empty, temporary working directory, temp_directory.

   The zipped distribution file name depends on the Message Queue hardware platform:

   Edition	SPARC	x86
   Platform	mq3_7-ent-solsparc.zip	mq3_7-ent-soli386.zip

3. Change to a temporary directory.

   cd temp_directory

4. Unzip the distribution file.

   unzip mq3_7-ent-platform.zip

   where platform is either solsparc or soli386, depending on the platform.

   The unzip command creates an mq3_7-ent directory which contains the distribution files: LICENSE, ENTITLEMENT, DISTRIBUTIONREADME, THIRDPARTYLICENSECREADME, README, and COPYRIGHT files; install and uninstall scripts; and a pkgs directory that contains the Message Queue packages, as well as shared Solaris packages that have been updated for use with Solaris 9 (SunOS5.9).

   Table 2–3 describes the Message Queue packages, and Table 2–4 provides a guide to the packages you need for different use scenarios. In addition, if any of these files already exist on your system, you need to check whether the patch revision number is greater than that provided by Message Queue. If it is, you should do a custom install.

5. Change to the directory containing the Message Queue distribution files.

   cd mq3_7-ent

6. Become root.

   su root

   When prompted, type your root password.

7. Run the mqinstall script.

   This script will overwrite all of the Message Queue-specific packages listed in table Table 2–3

   ./mqinstall

   The script lists the distribution packages, if any, that are already installed, and then lists the packages about to be installed. Please note that the install script will not install any shared packages (packages that do not begin with SUNWiq and that might already be installed on your system). You must install shared packages manually, as described in step 9.

8. Enter y (yes) if you want to install all the packages. If you want to install the packages manually, enter n (no).

   If you run the mqinstall script, it creates a log file in the /var/sadm/install/logs/ directory.

9. Check your system for patches to any of the shared packages listed in table Table 2–3 (packages that do not begin with SUNWiq and that might already be installed on your system). Look in the following directory to see what versions will be installed:

   ./pkgs/Solaris_versNo/pkg_name/pkginfo

   Then, find the current installed version of the shared component using a command like the following:

   % pkgparam -v pkg_name | grep VERSION

   or

   % pkgparam -v pkg_name | grep SUNW_PRODVERS

   • If there is no package already installed, then you can go ahead and install the new one.

   • If an existing package is older than the new one, remove the older one using the pkgrm command. For example,

     % pkgrm SUNWpr

     Then, add the new packages as shown in Step 10.

   • If the package version is the same, don't add or remove anything.

10. If you want to install a subset of the packages listed in table Table 2–3, if you want to install shared packages, or if you do not want to overwrite later versions of packages, do the following:

    1. Change to the pkgs directory

       cd pkgs

    2. Run the pkgadd command to install the packages you want. Note the special directions below for upgrading shared components.

       pkgadd -d ./ -a admin.conf

       The pkgadd utility lists the names of all packages in the directory available for installation (see Table 2–3). When prompted, indicate the packages you want to install, by entering the number of the package. To select multiple packages, enter a list of numbers separated by a comma.

       (The-a admin.conf option permits an overwrite of any packages that are already installed on your system.) The pkgadd utility installs the packages you specify, possibly asking for additional information, and eventually returns to the original prompt, displaying the list of packages available for installation. Please note that running the pkgadd command from the ./pkgs directory with the default selection (all), will install all the Message Queue packages as well, which are already installed by the mqinstall script

       ---

       Note –

       To upgrade shared components (indicated by a package name that does not start with SUNWiq), you must also run the command pkgadd -d from the ./pkgs/Solaris_9 directory or the ./pkgs/Solaris_10 directory, depending on the operating system where you are installing the product. (This directory contains operating-system-specific shared components only). For example, the following command adds the shared components that are needed in Solaris 10.

       cd pkgs/Solaris_10
       pkgadd -d ./ -a ../admin.conf

       ---

    3. Type q to quit.

11. Exit the root shell.

12. Back up the zip distribution file from your temporary working directory.

    This is your logical media. You will need it to uninstall or reinstall Message Queue. Treat this file as you would any other installation media and place a copy in a safe location.

    ---

    Note –

    The instance data for any pre-existing broker instance (including the default broker instance, named imqbroker) is owned by the user that created that instance. Therefore, once installation is complete, be sure to run any Message Queue broker instance as the owner with privileges to the /var/imq/instances/instanceName directory. You become the owner by logging in as that user.

    ---