Upgrading WebsydianExpress for iSeries to version 3.0.4

Before you perform the upgrade as described in this document, ensure that you have read the what's new document and the general upgrade guide for version 3.0.4 and have investigated all issues that are relevant for your installation.

Note that this document only describes upgrading from version 3.0 and later to version 3.0.4. If you are at an earlier version, you must start by upgrading to version 3.0.

Your current version can be found by opening the WebsydianExpress administration interface and looking at the Welcome page. At the top and at the bottom you will find the current version of your WebsydianExpress installation.

Download

Go to the WebsydianExpress download page and download the zip-file: Upgrade WebsydianExpress for iSeries to version 3.0.4.

Unzip this file to your disk. This creates a folder structure:

The iSeries folder contain an exe file WXP304INS_install.EXE, which can be used to transfer the upgrade objects to the iSeries.

It also contains the save file that is being transferred.

The Upgrade folder contains files that is used to upgrade the administration sites.

The Web Server Component folder contain all objects you need to update on the web server.

Move the objects to the iSeries

Using the install program

The easiest way to move the objects to the iSeries is to run the WXP304INS_install.EXE program found in the iSeries folder.

1. Press "Next" on the first page shown.
2. Select "Standard", Press "Next".
3. Select "Use TCP/IP", specify the name of the iSeries and the iSeries user and password. Press "Next".
4. Press "Next" to start the installation.
   The installation will create a library named WXP304INS. If this library already exist on the iSeries, you will be asked to either overwrite the existing library or to specify another name for the library to install.
5. Press "Finish" to exit the tool.

Manually move the save file

If you of some reason can't use the install program (e.g. due to security restrictions on TCP/IP connections to the iSeries), you can move the save file found in the iSeries folder to the iSeries manually (e.g. using FTP).

Restore the save file to an empty library.

Run the upgrade command

In order for the upgrade command to run successfully you will need to stop WebsydianExpress.

Add the library you have restored to to the library list of your interactive session.

Run the command WXPUPGRADE, press F4 to specify the following parameters:

PGMLIB

Specify the program library of the current WebsydianExpress installation. This is the library that contains the WebsydianExpress runtime. One of the objects it contains is a RPG program called EXPRESS.

DBLIB

Specify the database library of the current WebsydianExpress installation. This is the library that contains the WebsydianExpress files. One of the files it contains is a physical file called WSBSCRP.

The upgrade command will create new physical and logical files in this library and messages will be added to the WebsydianExpress message files found in this library.

PTFLIB

This is the PTF-library of your current WebsydianExpress installation. This is the library where all programs installed by this upgrade command will be placed.

IFSDIR

This the the top folder (EXPRESS30) for your current WebsydianExpress installation. This folder must contain the subfolders: bin, html, jars, license, logs, temp, upgrade, and webcomponent.

Note that this command can take some minutes to execute.

When command have executed please start the WebsydianExpress again.

Update WebsydianExpress web server component

Depending on the type of Websydian web server component and platform you have selected for your WebsydianExpress installation you will need to update a number of resources (images, buttons. style sheets) provided with WebsydianExpress.

WebsydianExpress web server component on IBM HTTP Server (Default)

New and updated resources have been installed automatically to the directory of the WebsydianExpress on your iSeries and you will not have to do any further.

WebsydianExpress web server component on Tomcat

Manually copy the new and updated files located in the upgrade directory Web Server Component\resources\res to your Tomcat instance. By default the target directory of these files are C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps\express30\res but this might vary.

If you deployed the Websydian web server component as a WAR file you will need to update the WAR file as described below.

Restart the WebsydianExpress web server component by restarting the Tomcat service.

WebsydianExpress web server component on WebSphere or Servlet Exec

Start by obtaining your current version of your deployed WAR file. Normally the WAR file will be available on the server where you deployed the WAR file in the first place.

1. Rename the WAR file to file suffix ZIP
2. Unpack the ZIP file to a directory of your choice using the standard Windows tool to do so. (Right click the file and select extract to)
3. Copy the files located in the upgrade Web Server Component\resources\res to the unpacked structured into the directory res.
4. Pack the ZIP file using the standard Windows tool. (Right click the file and select send to and then compressed (zipped) folder
5. Rename the ZIP file to file suffix WAR
6. Your WAR file is now ready to be redeployed to your WebSphere or Servlet Exec.

Restart the WebsydianExpress web server component by restarting the servlet engine or using the servlet engine administration interface to restart the servlet holding the component.

Upgrade the administration interface

As version 3.0.4 introduces a new administration menu item, you need to upgrade the administration interface using the "Update Admin" menu item for each of your sites.

1. Open the administration interface. Go to Utilities→Update Admin.
   If you get a warning about a digital signature, just accept it.
2. Press the "Open import file" button.
   This opens a file selector, select the file Administration Interface Upgrade - v3.0.4.txt in the Upgrade folder (in the structure that was created when you unzipped the downloaded file). Press "Open" to select the file.
3. Press the "Import" button to perform the import - this import can take some time.
   After the import has finished, refresh the administration menu (press F5 or Ctrl-F5) and check whether the section Site Structure contains the "Authorized Events" menu item.
4. Access the "Authorized Events" menu item to ensure that the new html templates for this menu item have been installed in the html-folder.