Upgrading WebsydianExpress for Windows/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 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.0.4.

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

Upgrade WebsydianExpress Windows runtime

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

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 WXPW304INS_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 WXPW304INS. 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

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