StructWSF Upgrader

From TechWiki

Jump to: navigation, search
The structWSF upgrader takes an existing structWSF instance an upgrade it to the latest version. What the upgrader does is to:
  1. Upgrade the code of structWSF to its latest version
  2. Add potentially new configuration(s)
  3. Delete potentially deprecated configuration(s)
  4. Modify potentially modified configuration(s)
  5. Install potentially new software(s)

Depending on the version to upgrade, the structWSF upgrader will do one of these things, or all of them. If a step is needed by the user, it will tell him what needs to be done.

The upgrader works as follow. It checks the version of the current structWSF instance. Then, it checks if a new version is available. If a new version is available, then it upgrades the current version to the immediate next version. If three versions have been released since the last upgrade, then the other two versions won't immediately be installed. The upgrader will need to be ran for each of these versions until it tells the user that no new version is available to be installed.

As you can see, upgrading a structWSF instance is really an iterative process. An instance needs to be upgrade to the immediate next version. This is needed to ensure that all the modifications that are needed between versions are applied to a running instance.

Osf installer.png

Contents

Requirements

  1. Ubuntu 10.04 (Lucid)
  2. 32 Bits Operating System
  3. Access to internet from your server
  4. a previously installed version of structWSF that has a version greater or equal to: v1.0a92

Upgrading structWSF

The only steps needed to upgrade a running structWSF instance are:

  1. Create a folder where to put the structWSF upgrader
  2. Download the structWSF-Upgrader-v1.0a2.zip upgrading package
  3. Make the structwsf-upgrade.sh upgrading script executable
  4. Run the structwsf-upgrade.sh upgradingscript

You can perform these four easy steps by copying and pasting these few commands in your shell:

cd /mnt/
sudo wget https://github.com/downloads/structureddynamics/structWSF-Upgrader/structWSF-Upgrader-v1.0a2.zip
sudo unzip structWSF-Upgrader-v1.0a2.zip
cd `ls -d structureddynamics*/`
sudo chmod 755 structwsf-upgrade.sh
sudo ./structwsf-upgrade.sh

System Integration Tests

It is always a good thing to run the system integration tests after each upgrade to make sure that your instance is always properly working. These tests are available here

For More Help

If you are experiencing issues with this upgrade process, please do make an outreach to the Open Semantic Web Mailing List.

Describe the specifications of the server where you are trying to upgrade structWSF. Tell us where the issue happens in the upgrade process. Also add any logs that could be helpful in debugging the issue.

Personal tools