Learn about how to install WebSphere® Message Broker Administration
for WebSphere Application
Server on z/OS®.
Install the WebSphere Message Broker administration
package onto your WebSphere Application
Server system
by running a script and passing it the location of the WebSphere Application
Server feature installation file.
The script and the installation file are included in your WebSphere Message Broker installation.
Before installing the administration package, complete
the following preparation steps:
- Identify the file system locations that are used in the
installation. The instructions use the following variables
to represent these locations:
- WAS_HOME
- This term represents the location of your server configuration,
and its value is usually assigned to the $WAS_HOME environment
variable. The path typically ends with /AppServer. $WAS_HOME/bin is
the path that you specify for WebSphere Application
Server commands
such as startServer.sh.
- WAS_RO_HOME
- This term represents the location of the WebSphere Application
Server product installation files
that are referenced from the server configuration. Its value is not
assigned by default to an environment variable. It is usually defined
to be read-only. The path to WAS_RO_HOME/systemApps/isclite.ear/isclite.jar typically
has no symbolic links.
- Ensure that your user ID has write access to both WAS_HOME and WAS_RO_HOME,
and has administrative authority to make WAS_RO_HOME writable.
- For WebSphere Application
Server V8, you
must set the program control on the bbgjutil module.
A user ID with administrative authorities is required to set this
control.
For example:
extattr +p WAS_HOME/lib/s390x9-64/bbgjutil
extattr +p WAS_HOME/lib/s390x-64/bbgjutil
- Copy the installation file wmb.admin.zos.tar to
a suitable location on your WebSphere Application
Server system. The file is installed as part of your WebSphere Message
Broker installation at the following
location:
- On Windows: wmqi_install_path\tools\wmb.admin.zos.tar
- On Linux, UNIX, and z/OS: wmqi_install_path/tools/wmb.admin.zos.tar
where wmqi_install_path is the WebSphere Message
Broker installation directory.
- Create a directory into which to extract the contents of wmb.admin.zos.tar.
The creating user ID is automatically given write access to the directory.
For example, run the following command:
mkdir /tmp/unpack
- Extract the files from wmb.admin.zos.tar into
the directory that you created.
For example, from
directory
/tmp/unpack, enter the following command:
tar -xvf wmb.admin.zos.tar
You can now see three new files in this directory:
- installBrokerPlugin.sh
- uninstallBrokerPlugin.sh
- wmb.admin.tar
- Ensure that the files are executable.
For
example, run the following command:
chmod a+x *.sh
- Create a new directory to permanently contain the WebSphere Message
Broker installation files. The creating
user ID is automatically given write access to the directory.
For example, run the following command:
mkdir /my/brokerplugin
To install the administration package, complete the following
steps:
- First, ensure that any servers created from this WebSphere Application
Server installation are stopped.
Navigate to the WAS_HOME/bin directory.
On a command line, enter the following command:
stopServer server1 -profileName profileName
server1 is
the name of the application server.
profileName identifies
the profile of the server process in a multi-profile installation.
This parameter is not required for a single-profile installation.
- Go to the location where the installation files were unpacked.
For example, run the following command:
cd /tmp/unpack
- If the WAS_RO_HOME directory is read-only,
set it as writable during the installation.
For example,
run the following command:
chmount -w WAS_RO_HOME
- As a user with administrative authorities, run the installation
script installBrokerPlugin.sh. This script generates
a large amount of output, so direct this output to a file or to a
utility such as more to read it easily.
For
example, run the following command:
./installBrokerPlugin.sh -u extract_location -d was_install_root -f tar_file
- extract_location is the directory into which wmb.admin.tar is
to be extracted. In this example /my/brokerplugin would
be used.
- was_install_root is the WAS_HOME directory
if you are using WebSphere Application
Server V7,
or the WAS_RO_HOME directory if you are using WebSphere Application
Server V8.
- tar_file is the full path and file name for wmb.admin.tar.
In this example /tmp/unpack/wmb.admin.tar would
be used.
The script returns information about
any running WebSphere Application
Server processes
that are preventing the installation from completing. These processes
must be stopped before the script is run again.
- If the WAS_RO_HOME directory was set
to writable, set it back to read-only.
For example,
run the following command:
chmount -r WAS_RO_HOME
- Restart any WebSphere Application
Server servers
that were previously stopped.
Now that you have installed the
WebSphere Message Broker feature, configure the
administration run time by using the
WebSphere Application
Server manageprofiles command.
See
Configuring WebSphere Message Broker Administration for WebSphere Application Server.