Upgrading from an Earlier Version

Reflection for the Web 7.x or 8.x

If an outdated version of Reflection for the Web is installed or cached on your local computers and servers, use these instructions to upgrade to the current version of Reflection for the Web. When you upgrade, it is strongly recommended that you follow the steps in the order they are presented on this page.

To upgrade from Reflection for the Web 7.x or 8.x:

  1. Uninstall Reflection for the Web 7.x or 8.x
  2. Install Reflection for the Web 9.0 Components
  3. Upgrade Outdated Files

Step 1: Uninstall Reflection for the Web 7.x or 8.x Components

Note: For all installation methods, if you used the UDC Mapping section of the Administrative WebStation to assign custom characters to EBCDIC values and you want to retain those mappings, copy and save the udc.xml file that is in the [Reflection management server installation]/ReflectionData/ directory.

Automated Installations

If you used an automated installer, follow one of these procedures to remove Reflection for the Web 7.x or 8.x files from your server.

Performing one of these operations will preserve your Reflection management server and security proxy server configurations. You will be prompted to save modified files during the uninstallation process.

Manual Installations

If you installed using archive files, first retain these files and folders, then uninstall:

  1. Reflection management server:

    Copy and save the web.xml file in the
    [Reflection management server installation]/jakarta-tomcat-[version number]/webapps/rweb/WEB-INF/ directory.

    Copy and save any files that you customized in the
    [Reflection management server installation]/jakarta-tomcat-[version number]/webapps/rweb/ or
    [Reflection management server installation]/jakarta-tomcat-[version number]/webapps/rweb/gm/ directory.

    Copy and save any unprotected, static sessions in the
    [Reflection management server installation]/jakarta-tomcat-[version number]/webapps/rweb/session/ directory.
    These sessions may also be saved in other directories within the webapps directory. See Upgrading Static Sessions for more information.

    Copy and save the
    [Reflection management server installation]/ReflectionData/ directory.

    Copy and save cacerts in the
    [Reflection management server installation]/_jvm/lib/security/ directory.

  2. Security proxy server:

    Copy and save the
    [security proxy installation]/conf/ directory and the
    [security proxy installation]/keystores/ directory.
    This saves your server.properties file and your certificates.

  3. Metering server:

    Copy and save the web.xml file in the
    [metering server installation]/jakarta-tomcat-[version number]/rwebmeter/WEB-INF/ directory.

  4. Servlet runner:

    Copy and save the Tomcat keystore in the
    [tomcat installation]/jakarta-tomcat-[version number]/conf/ directory.

  5. Delete the directories in which you installed the Reflection for the Web components.

Step 2: Install Reflection for the Web 9.0 Components

Install the Reflection for the Web 9.0 components now. When you upgrade from a previous version:

Step 3: Upgrade Outdated Files

Automated Installations

If you used an automated installation process, the Reflection management server and servlet runner settings have been retained. No further upgrade steps are necessary if you did not customize files, add certificates to the management server trusted list, or save static sessions. Follow the steps below under For all installation types to upgrade JCE policy files, UDC files, other customized files, or certificates. Follow the steps in Upgrading Static Sessions to upgrade sessions that were not saved using the Session Manager or that were manually edited.

Upgrade of the security proxy server is complete. To ensure that you can edit your existing secure sessions or create new secure sessions in the Session Manager, export the security proxy server settings to the Administrative WebStation. Run the Security Proxy Wizard. Click Save to save your settings. You are prompted to export your settings to the management server. Ensure that the management server name, port, and context are correct, and then click Export.

Upgrade of the metering server is complete. To ensure that your settings were saved correctly, open the Metering Configuration tool. For detailed configuration information, see Setting Up the Metering Component.

Manual Installations

If you installed using archive files, ensure that these files are copied or edited correctly.

For all installation types:

Where To Go Next