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.

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,
   
   
4. Click on a configuration to view its details. For example,
    
   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 command osgi> getInstallationHistory.

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

   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
   1376883704884 August 19, 2013 at 09:11:44 IST
   ...

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 gives you details similar to the following:

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

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

   The output will be similar to the following:

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