You can install an IBM® WebSphere® MQ server on
Solaris either interactively or silently.
Before you begin
- Before you start the installation procedure, make sure that you complete the necessary steps
that are outlined in Preparing the system.
- If you are using Solaris zones, you have a choice between installing IBM WebSphere MQ into the global zone, or installing IBM WebSphere MQ into a non-global zone. For details on how to
install IBM WebSphere MQ into Solaris zones, see the following
technote: IBM WebSphere MQ V6.0 support position
regarding Solaris zones. The technote is applicable to IBM WebSphere MQ Version 7.1 or later with the following changes:
- You do not need the -G option on the pkgadd command as
GSKit is now installed as part of the WebSphere MQ installation.
- If you install IBM WebSphere MQ into the global zone
for use in sparse zones, you must copy the /var/mqm file system into the sparse
zone. You must also copy the /etc/opt/mqm/mqinst.ini installation entry into
the sparse zone.
- Limitations for shared /usr file systems: the dspmqinst
and dspmqver commands might report the primary installation incorrectly when
compared with the symbolic links in /usr/bin. To synchronize the reporting of
the primary installation in a Solaris zone and the global zone, run setmqinst with
the -i or -x parameter, on the individual zones.
- You cannot change the primary installation within a non-global zone. You must change the primary
installation through the global zone, which has the appropriate write access to
/usr/bin .
About this task
This task describes the installation of the IBM WebSphere MQ for Solaris
server, using the pkgadd program. You can
choose which components you want to install. The components are listed
in Choosing what to install.
Note: If
you are installing on the Solaris 11 operating system, ensure that
the IPS package (package/svr4) that supports pkgadd
and equivalent utilities is installed.
Procedure
- Log in as root, or switch to the superuser using the su command.
- Set your current directory to the location of the installation
file. The location might be the mount point of the server DVD, a network
location, or a local file system directory.
- Run the
mqlicense.sh
script to accept
the license: ./mqlicense.sh
If you
want to view a text-only version of the license, which can be read
by a screen reader, type:
./mqlicense.sh -text_only
The license is displayed. Follow the instructions to accept
the license. If you accept the license, the installation continues.
If you do not accept the license, you cannot continue the installation
process.
- If this installation is not the first installation on the
system, you must run crtmqpkg to create a unique
set of packages to install on the system:
- Enter the following command:
./crtmqpkg
suffix
where
suffix is a name
of your choosing that uniquely identifies the installation packages
on the system.
suffix is not the same as an installation
name, although the names can be identical.
suffix
is limited to 16 characters in the ranges A-Z, a-z, and 0-9.
The
ctrmqpkg script can use two environment
variables which are useful when you are installing from a non-disk
media location:
- CDROOT, the root of the installation media
or downloaded installation files.
- TMPDIR, the output location of the modified
installation files.
No environment variables are required if you are running
the image as ./crtmqpkg
.
- Set your current directory to the location specified
when the crtmqpkg command completes.
This
directory is a subdirectory of /var/spool , in
which the unique set of packages is created. The packages have the suffix value
contained within the file name.
- Start the installation process:
- If the installation is the first installation on the system,
enter the following command to start the installation process:
pkgadd -d.
- If the installation is not the first installation on the system,
enter the following command to start the installation process:
pkgadd mqm-suffix
where suffix
is the suffix chosen in the previous step.
- You are prompted to choose a location for installation.
- To install to the default location, /opt/mqm ,
enter y.
- To install to a non-default directory, enter n .
Then, enter the required installation path, and confirm your choice.
- When the list of components is displayed, enter the numbers
of the components that you require, separated by spaces or commas.
When you are installing (adding) an
IBM WebSphere MQ
component to an existing installation, choose option
yes when you are asked
whether to overwrite.
Note: During the IBM WebSphere MQ
base version installation, you can choose to install all components or a subset of the components.
When you install a fix pack, only the currently installed components are upgraded. If, at a later
stage, you want to add further IBM WebSphere MQ components
that are not already installed, these components can be installed (added) to the IBM WebSphere MQ base version only. If your current version of
IBM WebSphere MQ is not the base version, you must first
uninstall all the fix packs before you add the required components to the existing installation, and
then install the required fix packs. Also, when you are adding IBM WebSphere MQ components to an existing installation, you
must choose option yes when you are asked whether to overwrite by the
installation process.
- If the path chosen in step 6 does not exist, you are asked
if you want to create it. You must enter y to
proceed.
- Answer any questions appropriately for your system.
If you are prompted to choose whether to install certain IBM WebSphere MQ files as setuid/setgid
files, you must enter y.
- A message is issued when the installation is complete.
Enter q to exit the pkgadd program.
What to do next
- If you have chosen this installation to be the primary installation
on the system, you must now set it as the primary installation. Enter
the following command at the command prompt:
MQ_INSTALLATION_PATH
/bin/setmqinst -i -p MQ_INSTALLATION_PATH
where MQ_INSTALLATION_PATH
represents
the directory where IBM WebSphere MQ is
installed.
You can have only one primary installation on a system.
If there is already a primary installation on the system, you must
unset it before you can set another installation as the primary installation.
For more information, see Changing the
primary installation .
- You might want to set up the environment to work with this installation.
You can use the setmqenv or crtmqenv command
to set various environment variables for a particular installation
of IBM WebSphere MQ. For
more information, see setmqenv and crtmqenv.
- If you want to confirm that the installation was successful, you
can verify your installation. See Verifying an IBM WebSphere MQ server installation,
for more information.