Deploying under WAS for z/OS
The following steps are used to deploy QMF for WebSphere
under WAS for z/OS version 4:
- Start the administration application and connect to WAS.
- Add an administrative conversation.
- Use the conversation to install the application.
- Complete and activate the conversation.
Start the administration application and create a conversation
If you have not already done so, install the WAS for z/OS
and OS/390(R) Administration
application.
- Start the administration application. The Login window
displays.
- Enter appropriate values for Bootstrap server IP name, Port, Userid,
and Password. Click OK.
- In the navigation tree on the left side of the administration
application, right click on Conversations,
and select Add from the pop-up menu. Properties for
a new conversation are displayed on the right side of the administration application.
- Enter any desired values for Conversation name and Conversation description.
- Click the Save button on the toolbar.
Install the application
After the conversation is created, install the application:
- In the navigation tree, expand the new conversation.
- Expand Sysplexes.
- Expand the sysplex on which you wish to install QMF for WebSphere.
- Expand J2EEServers.
- Right click on the server on which you wish to install QMF for
WebSphere. The Install J2EE application window
displays.
- In the EAR Filename field, enter the directory
in which you installed the QMF for WebSphere files, followed by
QMFWebSphereZOS.ear. In the Destination FTP Server field,
enter the host name of the WAS machine. Click OK.
The Reference and Resource Resolution window
displays.
- Click Set Default JNDI Path & Names for all Beans,
and then click OK to install the application.
Configure access to JDBC drivers
You must configure the J2EE application server on which
you installed the QMF for WebSphere application to provide access
to any JDBC drivers that will be used by QMF for WebSphere. This
configuration may vary widely depending on the types of JDBC driver
to be used. Consult the JDBC driver documentation for installation
and configuration information.
For accessing DB2, you must perform configuration as described
in the "JDBC and SQLJ administration" section of the DB2 manual, Application Programming Guide and Reference for Java.
In particular, described modifications to environment variable settings
must be made to the J2EE server configuration:
- In the navigation tree, expand the new conversation.
- Expand Sysplexes.
- Expand the sysplex on which you installed QMF for WebSphere.
- Expand J2EEServers.
- Click on the server on which you installed QMF for WebSphere.
The server properties display on the right side of the administration
application window.
- At the bottom of the window, make required environment variable
settings under Environment variable list.
- Click the Save button on the toolbar.
Activate the application
After the application is installed, activate it:
- In the navigation tree on the left side of the administration
application, right click on the conversation, and select Validate from
the pop-up menu.
- Right click on the conversation and select Commit from
the pop-up menu.
- Right click on the conversation and select Instructions... from
the pop-up menu.
- Review the instructions on the right side of the administration
application window, and complete the listed system tasks. At this
time, you should also update the httpd.conf file. Add the following
line:
Service /QMFWebSphere/*/
usr/lpp/WebSphere/WebServerPlugIn/bin/was400plugin.so:service_exit
This directive must be contained in a single line in the file, with
spaces after Service and *.
- Right click on the conversation and select Complete --> All Tasks from
the pop-up menu.
- Right click on the conversation and select Activate from
the pop-up menu.
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 authenticate a
user before performing various administrative tasks in QMF for WebSphere,
such as binding packages.
You must perform RACF(R) administration
in order to map the qmfadmin role to users and groups. See the
WebSphere for Application Server for z/OS and OS/390 manual, Assembling Java 2 Platform, Enterprise Edition (J2EE) Applications (SA22-7836)
for more information on this process.
Start the application
After the application is activated and security configuration
is complete, start (or restart) the http and J2EE servers. The
application is now available.
