Installing WebDocs iSeries Open Web Software on Windows PC

From Support

The WebDocs Open Web interface is a web server extension that allows the WebDocs iSeries software to continue to store its images and database information directly on the iSeries, however the actual web serving can be done via an Apache Tomcat Web Server running on the iSeries, Windows, Unix or Linux.

The WebDocs Open Web interface can run in conjunction with the standard WebDocs iSeries browser interface without causing any problems.

The WebDocs Open Web software is a great way to serve up business documents to customer and vendors without exposing the iSeries directly to the Internet.

The iSeries stays safely behind the firewall while customers, vendors and employees gain secure access to their vital business documents.

Contents 1 System Requirements 1.1 iSeries System requirements 1.2 PC Server Requirements 2 Installation and Setup Steps for Windows PC or Server

System Requirements

WebDocs Open Web interface can be run from an iSeries or Windows PC or Server. These instructions focus on installing WebDocs Open Web on a Windows PC.

iSeries System requirements

• AS/400 - iSeries V4R4 and above.
• RJS WebDocs iSeries Edition library V1.81 and above - RJSIMAGE

PC Server Requirements

• Windows 2000/XP/2003
• Java Runtime 1.4
• Windows Tomcat 5.0.28 or above installation
• WebDocs Installation WEBAPP directory.

Installation and Setup Steps for Windows PC or Server

1. Install Sun Java SDK V1.42_07 or above from Sun download site. This is the FREE Sun Java runtime and development environment.

http://java.sun.com/products/archive/j2se/1.4.2_07/index.html

When running setup, install the Sun Java SDK, install into the following subdirectory: c:\j2sdk1.4.2_07

Note: The sun Java SDK can also be downloaded directly from the RJS web site if absolutely necessary. However since the download size is 51mb downloading from the SUN site above will be faster for most customers.

http://www.rjssoftware.com/files/sun/j2sdk-1_4_2_07-windows-i586-p.exe

2. Install Apache Tomcat 5.0.28 Java Application and Web Server on PC

http://www.rjssoftware.com/files/apache/jakarta-tomcat-5.0.28.exe

Install tomcat into the following subdirectory:

C:\program files\Apache Software Foundation\Tomcat 5.0

Note: When asked for the location of the Java runtimes during Tomcat install, enter or select: c:\j2sdk1.4.2_07.

3. Install WebDocs Open Web software on PC from the following link

http://www.rjssoftware.com/files/rjsimage/jsp/WebDocsiSeriesEdition-20060728.zip

Note: RJS will provide the site user ID and password info. If you didn't receive a download user ID and password, please contact RJS support at support@rjssoftware.com

The self extracting executable will unzip the WebDocs java web application to the following folder on the PC:

C:\program files\Apache Software Foundation\Tomcat 5.0\webapps\WebDocs

4. Edit the WebDocs WEB.XML settings file and set the following setting info:

From Windows Select Start/Run and type the following command to open WEB.XML for editing. wordpad.exe "C:\program files\Apache Software Foundation\Tomcat 5.0\webapps\WebDocs\WEB-INF\web.xml"

Change the ip_address parm to match the AS/400 - iSeries IP address where the RJSIMAGE library resides

   <init-param>
      <param-name>ip_address</param-name>
      <param-value>1.1.1.1</param-value>
    </init-param>

Change the host_user and host_pwd parms to match a valid AS/400 user. For initial testing use a profile with security officer access.

   <param-name>host_user</param-name>
      <param-value>WEBDOCS</param-value>
    </init-param>
    <init-param>
      <param-name>host_pwd</param-name>
      <param-value>DOCUMENTS</param-value>
    </init-param>

Save the updated WEB.XML file.

Note: You will want to restart the Tomcat service after any changes to the WebSpool properties file.

5. Start the Apache Tomcat monitor after setting the WEB.XML file and then restart the Apache Tomcat server. This will reload the WebDocs Open Web settings from WEB.XML

The Tomcat Monitor program can be accessed via Start/Programs/Apache Tomcat 5.0/Monitor Tomcat

After opening the Tomcat Monitor program, click the Stop button to stop the Tomcat service and then click Start to restart the the service.

6. Accessing the WebDocs Open Web interface login - This is a URL that launches the WebDocs login screen. When logging in from another PC, this value should contain the actual IP address of the Tomcat server PC instead of localhost.

URL format: http://localhost:8080/WebDocs

7. Create the C:\RJSTEMP directory on the TomCat server.

Note: No additional setup should be needed since the WebDocs Open Web interface uses the standard WebDocs user and folder security.

Have fun and give us your feedback.