WebDocs - iSeries Edition Upgrade Version 2

From Support

Jump to: navigation, search
If you have a question or seek clarification, please call Technical Support.

Use the following instructions for your WebDocs - iSeries Edition upgrade.

If you encounter any problems, please contact Technical Support

You must be at version 3.01 or above to use this upgrade process.
This upgrade will bring WebDocs - iSeries Edition to version 3.18
For help finding what version you are currently at, please read the FAQ

NOTE: These instructions assume you're using the Apache web server with server name APACHEDFT.

  • If you are running a different server, or if it has a different name, please change the commands as needed.

This new upgrade process does an in-place upgrade. Your data will be preserved without requiring that you copy or rename the RJSIMAGE library. This should result in less down-time, as well as better information about exit programs and changed commands, etc.

Contents

Before You Upgrade

  • Have your local administrator notify users that WebDocs will be down during the upgrade; this includes people using RJS Imaging Scan Workstation, users of the browser interface, Batch Import Utility and anything else that interacts with WebDocs.
  • Use option 25 of WebDocs menu to check subsystem QHTTPSVR for instances of HTTP server running and end any instance that is running WebDocs.
  • Execute WRKOBJLCK RJSIMAGE/RJSIMAGE *MENU to get an idea whether anyone is using objects in library RJSIMAGE.
  • Save your current RJSIMAGE library using the SAVLIB command. A save to tape is preferable, but it is OK to use a SAVF. NOTE: Do not start the SAVF name with RJSIMA.
DO NOT SKIP THIS STEP. The upgrade process does save the RJSIMAGE library to a SAVF, in order to be able to restore the current installation, should problems occur in the upgrade. Nonetheless, we strongly recommend that you also have saved the RJSIMAGE library yourself.
  • This upgrade will provide reports on any new or removed files, as well as any files in RJSIMAGE not created by RJS. If you have customized the exit programs, modified the source, added logical files or changed command defaults, your changes will be preserved. See the post-upgrade section for details. Please direct any questions regarding the process to Technical Support.

Upgrade

1. Download the WebDocs library from RJS.

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

2. Use FTP Library Installation to install WebDocs - iSeries Edition library (RJSIMAGE) onto System i.

Click Unzip

Unzip the file to the default location.

FTP Install

Enter your System i IP Address, username and password.
Take Steps 1, 2, 3, 6, and 7, waiting until the previous step is finished before continuing.
Do not take Step 4 or 5 - the RJSIMAGE library must be left with all objects in place in order to use this upgrade process.
You may see an Error 550. This is normal behavior in Step 2 when the temporary installation library does not exist. If you see any additional errors please contact Technical Support.

3. Restore the new upgrade objects with the following command:

RSTOBJ DOCUPG2* RJSIMAGE *SAVF SAVF(PCSINST/PCSINSTSVF) RSTLIB(QTEMP) MBROPT(*ALL) ALWOBJDIF(*ALL)

4. Start the upgrade with the following command:

DOCUPG2
  • Prompt the command to change product library, backup location, or temporary installation location, as needed.
  • If Packet Printing is installed, you will see compile messages for it.

Understanding the DOCUPG2 process

  • You will see status messages, such as Collecting version information...., that describe the stages of the upgrade process.
//Fill in spool file notes//

After You Upgrade

1. Use option 20 on the WebDocs menu to install the updated web site files.

If you have customized the web interface to WebDocs, read the following instructions carefully
Custom Interface: You will need to backup the RJSIMAGE folder mentioned above prior to running option 20. Rename it to something simple, like RJSIMAGEV1.
REN OBJ('/www/apachedft/htdocs/RJSIMAGE') NEWOBJ('RJSIMAGEV1')
Otherwise, proceed with option 20.
GO RJSIMAGE
20

Restore Image IFS Directory

2. Use option 27 of WebDocs menu to start the HTTP instance that runs WebDocs

Personal tools