Page Comparison

There may be instances where for example, you successfully installed some features to your product; however, when you try to start the product it fails with various reasons. In such scenarios, you can use the following recovery mechanism to revert your product to the previous state:

...

After installing features, if you encounter server issues or startup failures, you can revert the current configuration by restoring a previous one using either the management console or the command line. The latter is recommended if you cannot start the server.   

Use the following steps to check your feature installation history and revert the server back to a previous installation. In this recovery process, some features might get installed and some uninstalled. 

Restoring using the management console

1. Log in to the management console and select Features from the Configure menu. 
2. In the Feature Management page, go to the Installation History tab. 
   
3. This tab lists the history of provisioning operations performed on the system. For example,
   Image Added
   
4. Click on a configuration to view its details. For example,
   Image Added  
   Previous configurations can be identified as previous states of the system. It is a set of installed features. When you perform a provisioning operation such as installing/uninstalling of features, a system state/configuration change occurs. 
   
5. Verify if the state is where you want to revert to and click Revert. 

Restoring using the command line

If you cannot start the server after an unsuccessful feature installation, use the following steps to restore to a previous installation.

1. Start the product with -DosgiConsole system property.

2. Once the server is started, type the following command:
   osgi>  osgi> getInstallationHistory.You will get the following

3. A list of states:previous server states appears. For example,

   Code Block

   1376883697814 August 19, 2013 at 09:11:37 IST 1376883697957 August 19, 2013 at 09:11:37 IST 1376883700725 August 19, 2013 at 09:11:40 IST 1376883701385 August 19, 2013 at 09:11:41 IST 1376883704884 August 19, 2013 at 09:11:44 IST 1376883712770 August 19, 2013 at 09:11:52 IST 1376883715952 August 19, 2013 at 09:11:55 IST 1376883743493 August 19, 2013 at 09:12:23 IST 1376933879416 August 19, 2013 at 23:07:59 IST 1376940017503 August 20, 2013 at 00:50:17 IST

   Check

   ...

4. You can check what features are installed and uninstalled in a given state , by entering the following command: 
   
   osgi> getInstallationHistory <timestamp> 

   For example:
   osgi> getInstallationHistory 1376933879416

The output will be as followsgives you details similar to the following:

   Code Block

   -- Installed features in this configuration -- Uninstalled features in this configuration WSO2 Carbon - Service Management Feature 4.2.0 WSO2 Stratos - Deployment Features 2.2.0 WSO2 Stratos - Common Composite Feature 2.2.0 WSO2 Stratos - Usage Agent Feature 2.2.0 WSO2 Stratos - Throttling Agent Feature 2.2.0 WSO2 Stratos AppServer - Dashboard UI Features 2.2.0 WSO2 Stratos AppServer - Dashboard UI Features 2.2.0

5. Decide to which state you need want to revert the system to, and thereafter use enter the following command:
   osgi> revert <timestamp> 
   
   For example: 
   osgi> revert 1376933879416

   The output will be as followssimilar to the following:

   Code Block
   Successfully reverted to 1376933879416 Changes will get applied once you restart the server.