Restoring Functionality in Adaptive Server

Learn how to restore functionality in the server after an upgrade.

  1. Reset the configuration parameters.

    If you changed any configuration parameters before upgrading, use sp_configure to set them back to their earlier values.

  2. Use sp_dboption to reset any database options you disabled before upgrading.
  3. After you complete the upgrade, but before you use the upgraded server, verify that all scripts developed at your site point to Adaptive Server 15.5.
  4. Verify procedure cache allocation after upgrading.

    This section is for information only. After the upgrade Adaptive Server ensures that procedure cache size is the same as before upgrade, unless the original size was less than the default value.

    If you are upgrading from a version of Adaptive Server that is earlier than version 12.5.x, procedure cache percent is changed to procedure cache size. Adaptive Server now allocates memory dynamically and determines the size of the procedure and data caches in terms of megabytes. During the upgrade process, the server converts the procedure cache percent to an absolute value and sets procedure cache size based on this value.

    For example, if procedure cache percent is configured as 20 percent of 200MB of memory, then the absolute value of procedure cache percent is 40MB. During the upgrade process, the server converts procedure cache percent at 20 percent to procedure cache size at 40MB. If the value for procedure cache size is less than the default value, the server sets procedure cache size to the default value. For example, if procedure cache percent is set to 10 percent in the example above, and the absolute value of 10 percent is less than the default value of procedure cache size, then procedure cache size is set to the default value.

    With the introduction of dynamically reconfigured memory configuration parameters in Adaptive Server 12.5.x, an increase in the server’s memory use does not decrease the size of the procedure cache or the data cache. That is, if your default data cache is set to 40MB, and you increase your procedure cache, the default data cache is still 40MB.

    For more information about sp_configure, see the Reference Manual.

  5. Check the procedure cache requirements.

    Stored procedures, triggers, and other compiled objects require much more memory to run Adaptive Server 15.0.x than older versions.

    You may increase the procedure cache size during runtime, using sp_configure. You can use the verify option in sp_configure to verify any changes you make to the configuration file without having to restart Adaptive Server. The syntax is:
    sp_configure "configuration file", 0, "verify", "full_path_to_file"
    For example:
    sp_configure "configuration file", 0, "verify", 
       "/work2/Sybase/ASE125.cfg"

    For more information about sp_configure and sp_sysmon, see the Reference Manual and the Performance and Tuning Guide. For more information about configuring memory, see the System Administration Guide.

  6. Verify data cache allocation after upgrading.

    The server ensures that all the data cache sizes after an upgrade, are the same as before the upgrade. Adaptive Server 12.5.x and later treats the default data cache size as an absolute value and sets it in the config file. The string DEFAULT in the config file has a different meaning for default data cache size in Adaptive Server 12.5.x and later.

    In pre-12.5 Adaptive Server, it meant all the memory left after allocating memory for other configurations, procedures, and user-defined named caches. In Adaptive Server 12.5.x and later, it means a default value of 8MB.

    During the upgrade process, the server ensures that the default data cache size remains the same. Therefore, during the preupgrade process, the size of the default data cache is obtained and written to the configuration file as an absolute value, not as a “DEFAULT”. This enables the server to have the same default data cache size as before the upgrade. If this size is less than the default size of default data cache of 8MB, then the server allocates a default data cache of size 8MB.

  7. If you unmirrored devices, remirror them, using the disk remirror command.
  8. For information about upgrading compiled objects, see Upgrading compiled objects with dbcc upgrade_object.
  9. If you used two-phase commit in 11.9.x, run the script to install the two-phase commit tables:
    isql -Usa -Psa_password -Sserver_name 
    -i$SYBASE/$SYBASE_ASE/scripts/installcommit

    You do not need to run this script if you do not use two-phase commit.