Upgrading Redwood Platform

You want to upgrade your existing Redwood Platform installation. You should backup the software-tree and your database prior to upgrading Redwood Platform, to do so, please follow the instructions of your database vendor.

Preparation

Redwood recommends you unzip the new version over the old. Special care has been taken to preserve your changes in files. The system automatically handles changes to the following files:

• <install_dir>/j2ee/cluster/server<n>/conf/Catalina/localhost/scheduler.xml (customers who upgraded from 9.1.4 or earlier)
• <install_dir>/j2ee/cluster/server<n>/conf/Catalina/localhost/redwood.xml (new installations of 9.1.5 or higher)
• <install_dir>/j2ee/cluster/server<n>/conf/server.xml
• <install_dir>/j2ee/cluster/server<n>/bin/setvars.{sh|cmd}

If you have changed any other configuration files, such as <install_dir>/j2ee/cluster/server<n>/bin/platform.{sh|cmd} for example, you will need to take manual steps.

For <install_dir>/j2ee/cluster/server<n>/bin/platform.{sh|cmd}, simply put your changes into <install_dir>/j2ee/cluster/server<n>/bin/setvars.{sh|cmd} - note that you might have to create that file. For other files, identify the changes you made as they will be overwritten.

note

You should not change <install_dir>/j2ee/cluster/server<n>/bin/platform.{sh|cmd}.

Deliverables

File	Description	Required
redwood-platform.zip	Scheduler administration tool with GUI	Always

Procedure

Unzip the New Deliverable

1. Unzip the deliverable over the existing installation.
2. On UNIX-based systems.
3. $ cd <install_dir> (make sure the directory contains the j2ee directory).
4. $ unzip redwood-platform.zip.
5. On Windows.
6. C:\\Users\\Example> cd /d <install_dir> (make sure the directory contains the j2ee directory).
7. <install_dir>> 7z x redwood-platform.zip (Here we use 3rd party software (7zip) to illustrate the procedure, you can also use the built-in graphical extraction tool in Windows).

Redeploy the Adminserver1 and Server1

Windows:

%install_dir%/j2ee/cluster/adminserver1/bin/redeploy.cmd
%install_dir%/j2ee/cluster/server1/bin/redeploy.cmd

UNIX:

${install_dir}/j2ee/cluster/adminserver1/bin/redeploy.sh
${install_dir}/j2ee/cluster/server1/bin/redeploy.sh

Upgrade the Database Schema

Start up the Scheduler admin tool by running the start command.

Windows:

%install_dir%/j2ee/cluster/adminserver1/bin/start.cmd

UNIX:

${install_dir}/j2ee/cluster/adminserver1/bin/start.sh

1. Connect to the Scheduler admin tool with a web browser by going to the /scheduler-admin path on the server (for example http://localhost:10185/scheduler-admin/) and login with the user admin. The default password is admin.
2. On the Database Connection Configuration page confirm database connection details.
3. Choose Update and Connect.
4. On the Database Installation/Upgrade page choose Upgrade to upgrade the database.

Upgrade the Database and Start the Scheduler

Start up the Scheduler by running the start command.

Windows:

%install_dir%/j2ee/cluster/server1/bin/start.cmd

UNIX:

${install_dir}/j2ee/cluster/server1/bin/start.sh

note

The upgrade of the database can take some time, as quite a lot of data is written to the database.

onsiteTopic