5.4 Upgrading the Identity Manager Deployment of Self Service Password Reset

If you deployed Self Service Password Reset from the Identity Manager installation, there are separate steps you must perform to upgrade Self Service Password Reset.

To upgrade Self Service Password Reset from an Identity Manager deployment:

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

  2. Ensure that you have configured an administrator user for Self Service Password Reset.

    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 Editor > Setting > Modules > Admin > Administrator Permission.

    4. Ensure that the LDAP filter you defined includes an administrator user.

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

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

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

  6. Lock the Self Service Password Reset configuration file by accessing the Configuration Manager, then clicking Lock Configuration.

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

    ./catalina.sh stop
  8. Delete the following directories:

    • Tomcat_home/webapps/sspr

    • Tomcat_home/work/Catalina/localhost

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

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

    ./catalina.sh start
  11. 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.

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

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

  14. Configure the setting that integrates Self Service Password Reset with Identity Manager.

    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 Editor > Settings > Default Settings > LDAP Vendor Default Settings.

    4. Select NetIQ IDM / OAuth Integration.

    5. Select Save changes.

  15. Verify that all of the configuration information is correct and if you imported the customization, that Self Service Password Reset restored all of the customizations.