uk.ac.soton.itinnovation.grid.service.upgrade
Interface Upgrader

All Known Implementing Classes:

UpgraderImpl

public interface Upgrader

Method Summary

UpgradeReport

performUpgrade(String oldVersion, String versionBeingInstalled) This method is called to inform the service that an internal upgrade may be required.

Method Detail

performUpgrade

UpgradeReport performUpgrade(String oldVersion,
                             String versionBeingInstalled)

This method is called to inform the service that an internal upgrade may be required. e.g. a service may choose to upgrade database tables and data within tables.

Implementations must support being called many times without corrupting the upgrade. The WebConfigBase will call this method every time that a web page is refreshed during the upgrade. The method should report an UpgradeReport that describes the progress of the upgrade. If no upgrade was required, the UpgradeReport should contain a status of UpgradeStatus.COMPLETE. The UpgradeReport can contain progress information that can be used to keep the user informed of the progress of long running asynchronous upgrades.

Parameters:

oldVersion - the version of the installation being upgraded

versionBeingInstalled - the version being installed now

Returns:

UpgradeReport a report on the status of the upgrade