5.2 Upgrading Self Service Password Reset on Linux

If you installed Self Service Password Reset by deploying the WAR file on a Linux server, you must use the following steps to upgrade your deployment.

Since Self Service Password Reset is a Java servlet application running Apache Tomcat, the steps to add a patch update are the same as upgrading Self Service Password Reset. For more information, see Adding a Patch Update in the Self Service Password Reset 4.1 Administration Guide.

To upgrade Self Service Password Reset on Linux:

  1. Download the most recent version of Self Service Password Reset WAR file from the NetIQ Patch Finder download website.

  2. Create a backup of your current configuration information.

    1. Log in to Self Service Password Reset at https://dns-name/sspr as an administrator.

    2. In the toolbar, click your name.

    3. Click Configuration Manager.

    4. Back up the configuration XML file:

      1. Under Configuration Activities, click Download Configuration.

      2. Save the SSPRConfiguration.xml file to a safe location.

  3. Back up the data stored in the local database:

    1. In the Configuration Manager, click LocalDB.

    2. Click Download LocalDB, then save the local database to a safe location.

  4. (Optional) If you have made any customization in Self Service Password Reset such as changes in the user interface copy these for later reference.

    For more information, see Customizing the Branding of Self Service Password Reset in the Self Service Password Reset 4.1 Administration Guide.

  5. Stop Apache Tomcat by running the catalina.sh script in the Tomcat_Home/bin directory.

    ./catalina.sh stop

  6. Copy the updated sspr.war to the Tomcat_Home/webapps directory.

    NOTE:Ensure that you have set the SSPR_APPLICATION operating system environment variable in the setenv file. For more information, see Setting Operating System Environment Variables.

  7. Restart the Apache Tomcat service by running the catalina.sh script in the Tomcat_Home/bin directory.

    ./catalina.sh start

  8. Import the configuration information you backed up prior to the upgrade.

    1. Log in to Self Service Password Reset at https://dns-name/sspr as an administrator.

    2. In the toolbar, click your name.

    3. Click Configuration Manager.

    4. Click Import Configuration, then browse to and select the SSPRConfiguration.xml file you created earlier.

  9. Restore the local database information.

    1. Log in to the Configuration Manager as an administrator.

    2. Click LocalDB.

    3. Click Import (Upload) LocalDB Archive File, then browse to and select the file you saved before installing the new appliance.

  10. (Optional) Copy any customization as required.

    NOTE:If you uploaded a ZIP file to the configuration editor in you previous Self Service Password Reset version, the file is embedded in the SSPRConfiguration.xml file you imported previously so you do not need to complete the following steps.

    1. Log in to Self Service Password Reset at https://dns-name/sspr as an administrator.

    2. In the toolbar, click your name.

    3. Select Configuration Editor.

    4. Click Settings > User Interface > Look & Feel > Custom Resource Bundle.

    5. Browse to and select the Custom Resource Bundle file, then click Upload File.

  11. Log in to Self Service Password Reset at https://dns-name/sspr as an administrator and verify that all of the configuration information is correct.