Upgrading WebsydianExpress for Windows 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 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 Windows to version 3.5.

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

The directories of the unzipped file holds all required files to upgrade your existing WebsydianExpress for Windows to v3.5.

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 database

A number of new tables and views have been added to the WebsydianExpress database.

1. In the directory Database locate and run the program UpgradeDB.exe
2. Press "Next" on the first dialog shown
3. Enter information about SQL Server, user, password and database name of your existing WebsydianExpress database
4. Press "Next"
5. Press "Install" to perform upgrade

Upgrade WebsydianExpress web server component

The step of upgrading your WebsydianExpress web server component depends on your platform and type of Servlet Engine used. Below you will find a number of scenarios that should help you out.

Using the pack.exe supplied with WebsydianExpress

If you normally use the pack.exe to package your WAR file and optimally automatically deploy 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 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

The final step of upgrading

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 one of your sites. 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.