This documentation is for WSO2 Identity Server 5.1.0 . View documentation for the latest release.
Skip to end of metadata
Go to start of metadata

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.
  • No labels