Preparing to Upgrade

Before you upgrade, run the preupgrade utility. You must have system administrator privileges to perform an upgrade.

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. preupgrade prepares the old server for upgrade by making sure all necessary directories and settings are correct for the upgrade. When running preupgrade, 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 preupgrade.
- Earlier than version 15.x but later than 12.5.3 – from the Adaptive Server 15.7 installation directory, perform the preupgrade checks on the old server using the preupgrade utility, located at $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.