Upgrading an Existing Installation

On UNIX platforms, Sun Java System ASP automatically upgrades many of your settings from an existing 3.6.2 or 4.0.2 installation of the product. To perform an upgrade to Sun Java System ASP 4.0.3, review the information listed below and take any necessary steps. Then follow the instructions in Installing Sun Java System Active Server Pages. During the installation, you will be prompted to import your settings.

This information applies to UNIX platforms only. Migration is not supported on Windows platforms.

The new installation will completely overwrite your existing installation. If your current Sun Java System ASP installation directory contains any items you want to preserve, copy them to another location or they will be lost. Be sure to back up your existing installation before beginning the upgrade.

• The Sun Java System ASP setup program preserves many (but not all) settings from your 3.6.2 or 4.0.2 installation, and imports those settings into your new Sun Java System ASP installation. Most settings imported from your existing installation will override the settings that you configure during installation.

  SequeLink DSNs are not migrated when upgrading from 3.6.2 or 4.0.2 to Sun Java System ASP 4.0.3. Neither are the administrator name and password used to access the Sun Java System ASP Administration Console (you will specify these again during the installation). Also, DO NOT press CTRL+C during setting migration.

• If necessary, upgrade to meet the requirements listed in System Requirements.

• Do not upgrade a mission-critical production server. Performing the upgrade and taking the additional configuration steps required might keep your server offline for an unacceptably long period of time. If possible, mirror the production server to a non-production server, perform the upgrade, and then test and debug the upgraded server before deploying it in your production environment.

When the setup program has completed the installation, do the following:

• Verify that any system DSNs defined for your previous installation are functioning correctly. For more information, see Configuring a Database > Configuring Data Source Names (DSNs) > Testing a DSN in the product documentation. You can create or edit the system DSNs as needed, as described in Configuring a Database > Configuring Data Source Names (DSNs). Configuration information for the system DSNs that were defined for your previous installation can be found in the following file:

  [INSTALL_DIR]/casp/INSTALL/settings.import

  where [INSTALL_DIR] is the path name of the Sun Java System ASP installation directory (/opt/casp by default).

• You may also wish to verify that the following migrated successfully:

  • Environment variables

  • ADO settings

  • ASP applications

  • Server settings

  • Custom components

  • Users