| |
 |
Hotline Question of the Month |
| by Margaret Jeronim |
|
| |
Question: “ I don't run any of mrc's Web-based applications, but I have unlimited Client/Server license. I would like to use BED.TM What do I need to do?”
|
Answer:
Here are the mrc-Productivity Series BEDTM Setup Instructions:
1. Ensure that these IBM licensed programs are installed:
a. QSHELL Interpreter - 5722SS1 Option 30.
b. Java Development Kit 1.2 or higher - 5722JV1 Option 4 - with the latest cumulative updates.
2. Install an MRCCH dated June 2, 2003 or later. Download from here.
3. Setup the Apache HTTP server.
a. If you are not already running any HTTP server on your iSeries, follow these instructions to start using the Apache HTTP server.
b. If you are running the Classic IBM HTTP server, you will need to migrate to the Apache HTTP server. Please note that migration might be necessary in any event since IBM has announced its intentions to drop support for the IBM Classic HTTP server and to support only the newer Apache HTTP server in the future.
4. Now that you have a configuration for the Apache HTTP server, you need to add some lines to the configuration file. The file is on the iSeries IFS:
/www/<apache_server_name>/conf/httpd.conf
where <apache_server_name> is the name you have chosen for your Apache HTTP server instance.
Add the following lines to the configuration. This code forces a logon for BED users:
<Location /webapp/mrc/>
Require valid-user
AuthType Basic
AuthName mrc_BED
PasswdFile %%SYSTEM%%
UserID %%SERVER%%
</Location>
You can add it immediately before this configuration line:
RewriteEngine on
Also add the following line to the configuration. This enables proper redirect abilities via BED:
UseCanonicalName Off
You can add it near the top of the configuration, such as after line:
Listen 80
To connect Tomcat to an HTTP Web Server, add the following lines to the top of your httpd.conf file:
LoadModule jk_module /QSYS.LIB/QHTTPSVR.LIB/QZTCJK.SRVPGM
JkAsfTomcat On
JkWorkersFile /tomcat4112/conf/workers.properties
JkLogFile /www/apache/logs/jk.log
JkLogLevel error
JkMount /mrcjava/servlet/* ajp13
JkMount /webapp/mrc/* ajp13
Please note that these changes require that you restart the apache HTTP server. You may use iSeries command:
STRTCPSVR SERVER(*HTTP) RESTART(*HTTP) HTTPSVR(YOURAPACHE)
to do that.
5. You will need a Web Application Server, such as Apache's Tomcat or IBM's WebSphere. Here is more information about these software products. These instructions assume the use of Tomcat.
6. Install the Apache Tomcat application server. For your convenience, mrc supplies a version of Tomcat pre-configured to serve mrc-generated Java servlets and the BED interface. It can be downloaded here. If you downloaded Tomcat from mrc after June 17, 2003, then your Tomcat configuration is complete and you should continue with the next step. If you downloaded Tomcat from mrc previously or you installed Tomcat from another source, then you'll need to add the following lines to your configuration in file '/tomcat4112/conf/server.xml': These extra lines allow the serving of the Java servlets comprising BED.
<Context path="/webapp/mrc" docBase="/mrcwebgui" debug="0" reloadable="true" >
<Logger className="org.apache.catalina.logger.FileLogger"
prefix="mrcps_log" suffix=".txt" timestamp="true"/>
</Context>
You may add it immediately after this configuration line:
<Context path="" docBase="ROOT" debug="0"/>
7. If you needed to change the Tomcat configuration file and Tomcat was already running, then you need to restart Tomcat with iSeries command MRCAPPLLIB/MRCTOMCAT *END, watch with command WRKACTJOB to ensure that the Tomcat jobs end, and then start it again with command MRCAPPLLIB/MRCTOMCAT FUNC(*START).
8. You are ready to run BED. Point your browser at the mrc-Productivity Series Main Menu by running the link below (where xxx.xxx.xxx.xxx is your iSeries IP address.)
http://xxx.xxx.xxx.xxx/webapp/mrc/servlet/MRCPS.MRC001
If you are running the Apache HTTP server on a port other than 80, you will need to use the following syntax (where yyyy is the port number on which Apache HTTP is running.)
http://xxx.xxx.xxx.xxx:yyyy/webapp/mrc/servlet/MRCPS.MRC001
Have a hotline question of your own? Send an e-mail to support@mrc-productivity.com and let our product specialists help you!
|
|
 |
mrc publishes this newsletter on a monthly basis. Subscription is free of charge. Please send any questions or comments about this newsletter to news@mrc-productivity.com. This newsletter is edited by Heather Gately.
To unsubscribe, please just reply to this e-mail with Unsubscribe in the subject line.
View our privacy promise.
|
|
|