This documentation is for WSO2 Storage Server 1.1.0. View documentation for the latest release.
Page Comparison - Upgrading from a Previous Release (v.3 vs v.4) - Storage Server 1.1.0 - WSO2 Documentation

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


  • Before you upgrade to the latest version of WSO2 SS, you create a staging database, which is essentially an empty database. Note that you should NOT connect a new version of WSO2 SS to an older database that has not been upgraded. 

  • Make a backup of the database and the <SS_HOME> directory prior to upgrading. The <SS_HOME> directory can simply be copied to the new databasedirectory.

  • Stop all the Carbon servers connected to the database before running the migration scripts.


    Note that the upgrade should be done during a period when there is low traffic on the system.


  • This upgrade can only be done for some database typesif the database type is the same. For example, if you are using MySQL currently and you need to migrate to Oracle in the new version, these scripts will not work.
  • You cannot roll back an upgrade. It is impossible to restore a backup of the previous server and retry the upgrade process.


The downtime is limited to the time taken for switching databases when the staging database is promoted to the actual production status.