Recovery from Unsuccessful Feature Installation

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:

1. Start your product with the -DosgiConsole system property.

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

   You will get the following list of states:
   

   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

3. 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 follows:

   -- 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

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

   The output will be as follows:

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