Preparing to Upgrade

If you are upgrading from an earlier version non-clustered Adaptive Server to Adaptive Server Cluster Edition version 15.7 SP100, run the preupgrade utility. You must have system administrator privileges to perform an upgrade. These steps do not apply you are upgrading from an earlier version of Adaptive Server Cluster Edition.

If your server is at a 15.x level, do not use the sqlupgrade or sqlupgraderes upgrade utilities.

Each new server version contains features that introduce parameters, commands, reserved words, and so on. The preupgrade utility prepares the old server by making sure all necessary directories and settings are correct for the upgrade. When running the preupgrade utility, manually stop and start the server. You need not start the server before running the sqlupgrade upgrade utility; the utility starts the server when needed.

If you are upgrading from:
  • Version 12.5.3 with cache bindings on sybsystemdb – drop the cache bindings for sybsystemdb that are bound to a user-defined cache before you run the preupgrade utility.
  • Earlier than version 15.x but later than 12.5.3 – from the Adaptive Server 15.7 SP100 installation directory, use the preupgrade utility to perform the preupgrade checks on the old server. The utility is located in $SYBASE/ASE-15_0/upgrade.

Manually drop objects before you execute procedures for the first time. The first time you run the server after an upgrade, the server internally rebuilds procedures from the text in syscomments. The procedure may not execute properly if it contains code that drops, then re-creates, an existing object.

Note:
Any upgrade of a Cluster Edition of Adaptive Server to Cluster Edition version 15.7 SP 50 PL 00 is a minor upgrade, and does not require the upgrade utility. Use upgrade only when upgrading:
  • Either the Cluster Edition or nonclustered Adaptive Server, from version 12.5.4 or earlier to version 15.x.
  • Upgrading from a nonclustered Adaptive Server version 15.x to Adaptive Server Cluster Edition version 15.x.
  1. Go to the directory where your current version of Adaptive Server is installed.
  2. Enter cd in to go to the directory ASE-version, where version is your current version of Adaptive Server.
  3. Perform cd in to the upgrade directory.
  4. Enter preupgrade to run the preupgrade utility.