WebSpool Install

From Support

Installing WebSpool

If you have a question or seek clarification, please call Technical Support.

Please follow these instructions carefully to install WebSpool. If you experience any difficulties, you can refer to WebSpool's Troubleshooting page or contact Technical Support.

NOTE: If you are installing on Windows Server 2003 please read these instructions first.

Before You Install

Prerequisites	Corequisites	Upgrade	Optional
There are no software products from RJS that must be installed first prior to the install.	There are no software products from RJS that must be present in order for this product to work as designed.	There is no upgrade necessary after installation.	There are no optional software products for this application.

Installation

These instructions are not currently complete. To install WebSpool please contact Technical Support.

These instructions install version 1.04 of WebSpool

WebSpool can be run from an iSeries or Windows PC or Server. These instructions focus on installing WebSpool on a Windows PC.

Installing the Library

Step 1: Download

Download WebSpool from RJS.

Username = *********
Password = ***********

Step 2: Extract Files

You will be presented with the WinZip Self-Extractor message. Unzip the files to the default location.

Step 3: Confirm Extracted Files

Once the files have been extracted you will receive a message box noting the success.

Click OK.

Step 4: Welcome Message

You will be presented with the RJS FTP Install message.

Click OK.

Step 5: Begin Install

The RJS FTP Library Install program starts. You will be presented with the main dialog box.

Enter the selected System i IP address or DNS name in the AS/400 Host IP Address edit box.

Enter a valid System i security officer user ID and password in the appropriate edit boxes.

Take each numbered step, waiting until the previous step is finished before continuing.

You will see an Error 550. This is normal behavior. If you see any additional errors please contact Technical Support.

WebSpool should now be installed.

If installing website onto iSeries

iSeries System requirements

AS/400 - iSeries V4R4 and above (assuming Java toolkit works on releases older than V5R1. Otherwise V5R1 and above)
WebSpool library - RJSWBS

Installing WebSpool.WAR File Unzip the .war file to C:\Program Files\WebSpool, copy the .war file to the webapps folder: /tomcat5028/webapps in the IFS.

Example IFS location: /tomcat5028/webapps

Click here if you don't have the Apache TomCat Server installed.

Editing the WEB.XML File

Use the following iSeries command to edit the WEB.XML file:

EDTF STMF('/tomcat5028/webapps/webspool/web-inf/web.xml')

Under the ip_address setting, enter your iSeries IP address.

Press F3 to save the WEB.XML file.

Accessing WebSpool for the First Time

Make sure Apache Tomcat is running on the iSeries

ADDLIBLE RJSTOMCAT
STRTOMCAT

Example URL to Access WebSpool Login http://1.1.1.1:8080/WebSpool/index.jsp

If installing website onto PC Server

PC Server Requirements

Windows 2000/XP/2003
Java Runtime 1.4
Windows Tomcat 5.0.28 installation
WebSpool Installation WEBAPP directory.

Install Sun Java SDK V1.42_07 or above

Install Sun Java SDK V1.42_07 or above from Sun download site. This is the Java runtime.

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://downloads.rjssoftware.com/files/sun/j2sdk-1_4_2_07-windows-i586-p.exe

Install Apache Tomcat 5.0.28 Java Application and Web Server on PC

Install: Apache Tomcat 5.0.28

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: c:\j2sdk1.4.2_07

Install WebSpool on PC

Download and install the Web Application.

The installation creates a program group named: WebSpool iSeries Spool File Access

WebSpool Program Group Options Available:

Browse WebSpool Log - Displays the WebSpool error log C:\RJSTEMP\WEBSPOOLOG.TXT
Browse WebSpool RJSTEMP directory - Browses C:\RJSTEMP directory. This is where WebSpool stores its log and any temp downloaded reports.
Browse WebSpool WEBAPP directory - Browses C:\program files\Apache Software Foundation\Tomcat 5.0\webapps\webspool directory. This is where the WebSpool Java classes and JSP pages are stored after installation.
Edit WebSpool Properties - Edit the WebSpool C:\program files\Apache Software Foundation\Tomcat 5.0\webapps\webspool\WEB-INF\WEB.XML file. This file is equivalent to a Windows INI file. Usually the only setting that needs to be changed is the IP address to the iSeries.

Note: Open the attached file: webwindows.xml for an example of the Windows based Apache settings for WEB.XML

Monitor Tomcat - This option launches the Apache Tomcat monitor program which can be used to start/stop the Tomcat web application server.
WebSpool Login - This is a URL that launches the WebSpool login on the server. 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/webspool/index.jsp

WebSpool Properties

Edit WebSpool properties to set IP address to iSeries system by selecting: Start/Programs/WebSpool iSeries Spool File Access/Edit WebSpool Properties

Enter the correct IP address and then select File/Save to save the updated iSeries properties.

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

The Tomcat Monitor program can be accessed via Start/Programs/WebSpool iSeries Spool File Access/Monitor Tomcat -or- 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.

After You Install

If you are not already licensed, please read the licensing information and contact Technical Support. Feel free to search the documentation and troubleshooting help or ask Technical Support for any questions you may have.