WebSpool Install
From Support
Contents |
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
Installation
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
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.
| Upgrade | License | Documentation | Troubleshooting |
