Upgrading WebsydianExpress for Windows/iSeries to version 3.5

Before upgrading

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.5 and have investigated all issues that are relevant for your installation.

Note that this document only describes upgrading from version 3.0.x to version 3.5. If you are at earlier versions, 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 Win/iSeries to version 3.5.

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

The Application Service folder contains the objects that is going to be created/updated in the WebsydianExpress runtime.

Common contains a set of new Websydian jar files (used by the web server).

The iSeries folder contain an exe file WXPW35UPG.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.

Stop WebsydianExpress and perform a complete backup

Before starting the upgrade stop WebsydianExpress and do a backup of the entire WebsydianExpress installation folder. It is also recommended to do a backup of the database.

Upgrade WebsydianExpress Windows runtime

1. Copy all files and directories from the upgrade directory to your existing WebsydianExpress for Windows directories replacing any existing files

Upgrade WebsydianExpress iSeries objects

Move the objects your iSeries

Using the install program

The easiest way to move the objects to the iSeries is to run the WXPW35UPG.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 WXPW35UPG. 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.

Run the upgrade command

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.

Upgrade 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.

Using the pack.exe supplied with WebsydianExpress

If you normally use the pack.exe to package your WAR file and optimally automatically deploying on a local Tomcat instance just run the Pack.exe located in the Web Server Component directory.

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.

Manually deployed on Tomcat

Manually copy the new and updated files located in the upgrade directory Web Server Component\webcontainer to your Tomcat instance. By default the target directory of these files are C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps\express30 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.

Deployed using WAR files on WebSphere, Servlet Exec or Tomcat

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 directory Web Server Component\webcontainer to the root of the unpacked directory structure
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, Servlet Exec or Tomcat

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.5 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. Start WebsydianExpress and open the administration interface of any available site. 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.5.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.