Recovering from Unsuccessful Feature Installation

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.

Reverting using the management console

1. Log in to the management console.
2. On the Configure menu, click Features. 
   The Feature Management page appears. 
3. Click on the Installation History tab.
   The Installation History page appears.
   
   
4. Click on the configuration to which you wish to revert. 
   The actions that take place when reverting to the selected configuration is listed below.
   
   
5. Click Revert, to revert the current configuration to a previous configuration.

Reverting using the command line

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

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 the state to which you need to revert the system, 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.