Sun ONE Message Queue 3.0.1, Service Pack 1 Installation Instructions

Installing Sun ONE Message Queue 3.0.1, Service Pack 1
on Sun ONE Application Server 7.0,
Update Release 1

Version 3.0.1, SP1

Part Number 816-6828-10

May, 2003

This installation note applies only to installing Sun™ Open Net Environment (Sun ONE) Message Queue 3.0.1, Service Pack 1 (MQ 3.0.1, SP1) on Sun ONE Application Server 7.0, Update Release 1 (AS7 UR1). Message Queue is the Java™ Message Service (JMS) provider used by Sun ONE Application Server.

Specifically, if you are upgrading Application Server 7.0 to AS7 UR1, the upgrade script fails to upgrade MQ 3.0.1 to the appropriate new version—MQ 3.0.1, SP1. Therefore, if you wish to upgrade MQ when upgrading Application Server, you have to perform the MQ upgrade manually, in accordance with the procedure documented in this installation note.

If you install AS7 UR1 from scratch, the installer will properly install MQ 3.0.1, SP1 software, and the procedure documented in this note is not required.

This installation note contains the following sections:

Upgrading MQ on AS7 UR1 (Solaris™)

The MQ 3.0.1, SP1 bundle that needs to be installed on AS7 UR1 already resides in the Application Server directory structure. The procedure below describes how to replace MQ 3.0.1 with MQ 3.0.1, SP1.

  To upgrade MQ on AS7 UR1

  1. Change directory to the location of the MQ 3.0.1, SP1 bundle:

    2. cd AS7_UR1 download directory/imq

  2. Run the imq3_0_1-plt-solsparc.sh command script:

    3. sh imq3_0_1-plt-solsparc.sh

    The command displays the first page of the license for the product.

  3. Read the product license. Installation and use of the product is subject to acceptance of the license agreement.

    4. To display the entire license, one page at a time, repeatedly press the space bar. When you reach the end of the license, the program prompts you to accept the license.

    • If you choose not to accept the license agreement, type no or n and the installation terminates.
    • If you choose to accept the license agreement, type yes or y and the installation continues. The following files are extracted:
      • README
      • imq3_0_1-plt-solsparc.tar.Z
      • COPYRIGHT
      • LICENSE (a copy of the license agreement)
  4. Extract the archived files:

    5. /bin/zcat imq3_0_1-plt-solsparc.tar.Z | tar xvfp -

    A new directory, imq3_0_1-pkgs, is created.

    Note

    To avoid possible problems, do not use the GNU tar utility when installing MQ.

  5. Change directories:

    6. cd imq3_0_1-pkgs

  6. Become root:

    7. su root

  7. Create an installation defaults file (man admin(4)) that will instruct pkgadd how to handle installation if a previous version of a package already exists.
    1. Copy /var/sadm/install/admin/default to your current directory:

      2. cp /var/sadm/install/admin/default  .

    2. Edit this file and change the line:

      3. instance=unique

      to

      instance=overwrite

  8. Run pkgadd to update the existing MQ packages:

    9. pkgadd -d ./ -a ./default

    The pkgadd utility lists the names of all packages in the directory available for installation.

  9. When prompted to select packages, hit return.

    10. All the MQ packages will be updated.

  10. Type q to quit.
  11. Exit the root shell.
  12. Confirm that MQ 3.0.1, SP1 was installed by entering the following command:

    13. pkgparam -v SUNWiqr | grep PRODVERS

    Look for the following output:

    SUNW_PRODVERS='3.0.1 SP1'

Upgrading MQ on AS7 UR1 (Windows)

The MQ 3.0.1 software installed on Application Server 7.0, is a private copy that cannot be overwritten. Hence the MQ bundle provided with AS7 UR1, cannot be used to upgrade (overwrite) the MQ 3.0.1 version installed with Application Server 7.0.

The only way to upgrade MQ, therefore, is by first uninstalling Application Server (and the MQ 3.0.1 that is part of it), and then doing a full install of AS7 UR1, which will also install MQ 3.0.1, SP1. (If you have already upgraded to AS7 UR1, then you will first have to uninstall the Application Server (to remove MQ) before doing a full re-install of AS7 UR1.)

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. Email your comments to Sun at this address:

Please include the part number (816-6828-10) of the document in the subject line and the book title (Message Queue 3.0.1, SP1 Installation Instructions) in the body of your email.

Copyright © 2003 Sun Microsystems, Inc. All rights reserved.

Sun, Sun Microsystems, the Sun logo, Java, the Java Coffee Cup logo, and Solaris, are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. Use of Sun ONE Message Queue is subject to the terms described in the license agreement accompanying it.