5.4 Upgrading the Identity Manager Deployment of Self Service Password Reset

If you deployed Self Service Password Reset the integrated installer 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. Ensure that you are running a supported version of Identity Manager and Self Service Password Reset. For more information, see Supported Versions in the Self Service Password Reset 4.2 Administration Guide.

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

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

    4. Click Modules > Administrator > Administrator Permission.

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

  4. 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. Under Configuration Activities, click Download Configuration.

    5. Save the SSPRConfiguration.xml file 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 Theme of Self Service Password Reset in the Self Service Password Reset 4.2 Administration Guide.

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

  7. Stop Apache Tomcat by running the stop script located in the /etc/init.d/idmapps_tomcat_init directory.

    /etc/init.d/idmapps_tomcat_init 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 start script in the /etc/init.d/idmapps_tomcat_init directory.

    /etc/init.d/idmapps_tomcat_init 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. (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.

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

    4. Select NetIQ IDM / OAuth Integration.

    5. Select Save changes.

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