Upgrading from an Earlier Version

Static Sessions

When Reflection for the Web terminal sessions are created or modified using the Session Manager (or the Terminal Session tool in earlier versions), the protected sessions are upgraded during the upgrade procedures when using an automated installer or during Startup (when the Tomcat server is started) after a manual installation.

Follow these steps if any of these conditions exist:

  1. The sessions were not saved using Session Manager or the Terminal Session tool.

  2. The HTML in your sessions was manually modified.

  3. If you want to upgrade the static sessions for any reason.

Note: If you have keyboard map files that are not contained within a configuration file, then you must upgrade these files before you upgrade the sessions. First, follow the steps in the Upgrading External Keyboard Map Files section below.

  1. Open a Command Prompt, and change directories to find this location:

    [installation path]\ReflectionServer\jakarta-tomcat-[version number]\webapps\rweb\WEB-INF\lib

  2. On the same command line, on one continuous line, enter the appropriate syntax (displayed below) to upgrade your specified configuration files. You must specify the items displayed in red:

    1. Language. On the command line, include the language you want use: German (de), English (en), French (fr), or Japanese (ja).

    2. Name of relative or absolute directory or file that contains the configuration files. (You must be able to access this file or folder from the machine where you are upgrading.)

    3. If you are running the Microsoft JVM, enter this command as one continuous line:

      jview -cp:p microstar.jar;RWebServlet.jar com.wrq.util.upgrade.ConfigUpgrade -locale <de|en|fr|ja> <file name|directory>

    4. If you are running the Sun JVM, enter this command as one continuous line:

      java -classpath microstar.jar;RWebServlet.jar com.wrq.util.upgrade.ConfigUpgrade -locale <de|en|fr|ja> <file name|directory>

Sample Command Line Entry

For example, if you are running the Sun JVM and you want to upgrade the configurations files in the session folder for use with the English version of Reflection for the Web, you would enter this information:

  1. In the Command Prompt, change directories to arrive at this location:

        C:\Program Files\ReflectionServer\jakarta-tomcat\webapps\rweb\WEB-INF\lib>
  2. On the same continuous line, enter the command, language, and location of the session folder:

        java -classpath microstar.jar;RWebServlet.jar com.wrq.util.upgrade.ConfigUpgrade -locale en "C:\Program Files\Reflection Server\jakarta-tomcat\webapps\rweb\session"

Upgrading External Keyboard Map Files

If you exported keyboard map files (using the Export Keymap command in the Reflection terminal session), then these keymap files are not contained in a configuration file and should be upgraded when you upgrade other files. To upgrade Reflection for the Web keyboard map files:

  1. Create a temporary folder named KeymapConvert on your local computer for storing the files used in this procedure.

  2. In version 6.x: Open Administrative WebStation > Session Manager.

    In version 5.x: Open Administrative WebStation > Deployment Director.

  3. Add a session of the type that matches the keyboard map you are upgrading, and name the session KeymapConvert.

  4. In version 6.x: Click Launch, and then click Import Keymap on the Administration menu.

    In version 5.x: Skip to the Configuration tab, click Configure to start the terminal session, and then click Import Keymap on the Administration menu.

  5. Browse to the outdated keyboard map file, and click Open.

  6. In version 6.x: Close the session window, and then click Save/Exit.

    In version 5.x: On the Configuration tab, click Save and Exit Session.

  7. Close Reflection for the Web.

  8. Your sessions will be upgraded when you upgrade to Reflection for the Web 7.0 and start the Reflection management server.

Where To Go Next