Upgrading RealServer From a Previous Version

If you are upgrading from a previous version of RealServer, you should install the new version in addition to, and not instead of, the original version. Once you have installed, configured, and tested the new RealServer, you can then replace your old version with the new installation.

Installing with a Previous Version

To install without replacing an existing RealServer

  1. Install the new version in a new directory.
  2. In your original RealServer configuration file (server.cfg) note the PnaPort entry. If the setting is not present, RealServer is using the default port 7070. You need to use a different port number for testing the new RealServer installation. To use a different port number, add or edit the following line in the server.cfg file for the new installation:

    PnaPort 7072

    Be sure to specify a port that is not used by another configuration parameter such as ResolverPort.

  3. Send a test URL to the new RealServer. Add :7072 (as in step 2, above) to the pnm URL.

    You cannot run two versions of RealServer simultaneously as a service on Windows NT. Run the new version of RealServer from a command window until you are ready to replace the original version with the new version.

    pnm://<my.server>:7072/144.rm


Configuring the New Version

After you have tested your new version of RealServer, configure it to match the original version.

To configure the new RealServer

  1. Copy the BasePath setting from the server.cfg file of your original RealServer to the server.cfg file for the new version. It is best to use an absolute base path for the BasePath entry.
  2. Send a test URL to the new RealServer. Remember to add :7072 to the pnm URL:

    pnm://<my.server>:7072/welcome.rm


Replacing the Old Version with the New Version

When you are satisfied that the new RealServer installation supplies existing content correctly, stop the original server and move the new server into production.

To replace the old version with the new version

  1. Stop both instances of RealServer. For instructions on how to do this, see Using RealServer.
  2. Rename the directory of original installation to something like /old.
  3. Rename the directory for the new installation to the name of the original installation.
  4. Copy all appropriate settings from the original configuration file into the new configuration file.
  5. Set the PnaPort entry to its original value (default 7070).
  6. Change the Web page links back to the original port number.

© 1997 RealNetworks, Inc.