Deploying under WAS Advanced Edition or Enterprise Edition
version 4 (non-z/OS)
The following steps are used to deploy QMF for WebSphere
under WebSphere Application Server Advanced Edition or Enterprise
Edition, version 4 (on non-z/OS platforms).
Start the WebSphere Advanced Administrative Console
Start the WebSphere Advanced Administrative Console by
running the adminclient command from the WebSphere
bin directory.
Install the application
In the navigation tree on the left side of the Administrative
Console window:
- Expand WebSphere Administrative Domain.
- Right click on Enterprise Applications,
and select Install Enterprise Application from
the pop-up menu. The Install Enterprise Application Wizard displays.
- On the first page of the wizard, Specifying the Application or Module,
you must specify the location of the module to install. In the list
of nodes, click the machine on which you installed the QMF for WebSphere
files. Click Install Application, and then
enter the name of the directory in which you installed the files,
followed by QMFWebSphere.ear. Click Next.
- On the Mapping Users to Roles page, click Next.
(Mapping the qmfadmin role to users or groups will be performed
after installing the application.)
- Simply click Next on all of the following pages until the Selecting Application Servers page
displays. Note the name of the application server and node (in parentheses)
listed for the QMF for WebSphere module and then click Next.
- On the Completing the Application Installation Wizard page,
click Finish.
Map the qmfadmin role to users and groups
A single security role named qmfadmin is defined for the
QMF for WebSphere application. This role is used to authenticate
a user before performing various administrative tasks in QMF for
WebSphere, such as binding packages. You use the WebSphere Advanced
Administrative Console to map the qmfadmin role to users and groups.
In the navigation tree on the left side of the Administrative
Console window:
- Expand WebSphere Administrative Domain.
- Expand Enterprise Applications.
- Click on QMFWebSphere.ear. The properties
of the application display on the right side of the Administrative
Console window.
- Click on User/Role Mappings.
- Click on qmfadmin.
- Click Select. The Select Users/Groups - qmfadmin window
displays. Use this window to specify whether the role should be
mapped to everyone (effectively eliminating authentication for the
role), to all authenticated users (allowing any authenticated user
to perform QMF administration functions), or only to users or groups
that you specify.
- When you have finished creating the mappings, click OK.
- Click Apply.
Save the configuration.
Configure access to JDBC drivers
The last element of configuration that you must perform
using the WebSphere Advanced Administrative Console is to provide
access to any JDBC drivers that will be used by QMF for WebSphere.
In the navigation tree on the left side of the Administrative
Console window:
- Expand WebSphere Administrative Domain.
- Expand Nodes.
- Expand the node on which you installed the QMF for WebSphere application.
- Expand Application Servers.
- Click on the application server on which you installed the QMF
for WebSphere application. The properties of the application server
display on the right side of the Administrative Console window.
- Click on JVM Settings.
- In the Classpaths list, add all of the
*.zip or *.jar files that are required by the JDBC drivers that
will be used by QMF for WebSphere. For example, for the DB2 Universal
Database V8 Type 4 driver on Microsoft Windows, you might enter:
C:\Program Files\IBM\SQLLib\Java\db2jcc.jar
C:\Program Files\IBM\SQLLib\Java\db2java.zip
C:\Program Files\IBM\SQLLib\Java\sqlj.zip
C:\Program Files\IBM\SQLLib\runtime.zip
- When you have finished adding the required files, click OK.
Save the configuration. After the configuration is saved, you
must restart the server for the changes to take effect.
Start the application
The installation and configuration of the application
is complete, so you can now make it available.
In the navigation tree on the left side of the Administrative
Console window:
- Expand WebSphere Administrative Domain.
- Expand Enterprise Applications.
- Right click on QMFWebSphere.ear, and select Start from
the pop-up menu.
The application is now available.
