Additional Steps If You Used 15.0.3 Cluster Edition Features Before Downgrading

If you are rolling back after having used any of the 15.0.3 Cluster Edition features, additional steps may be necessary. Some steps must be completed before downgrading to 15.0.1 Cluster Edition and 15.0.1 cluster Edition ESDs, and other steps are performed immediately after downgrading. Read the documentation on the features below that may require manual changes.

To correct errors related to:
  • Encrypted columns – see Chapter 2” Encrypted Columns” in Adaptive Server 15.0.2 New Feature Guide.
  • User passwords – see Chapter 10 “Supported Security Features” in Adaptive Server 15.0.2 New Feature Guide.
  • instead of triggers – see Chapter 22, “Instead of Triggers” in Adaptive Server 15.0.2 New Feature Guide.
  • SQL user-defined functions – see Chapter 17 “User Defined SQL Functions” in Adaptive Server 15.0.2 New Feature Guide.
  • Hash built-ins – see Chapter 19 “Changes to System Procedures, Functions and Commands” in Adaptive Server 15.0.2 New Feature Guide.

In general, no additional steps are required when you are returning to an Adaptive Server version in which the feature was already available.

  1. If you used Real-Time Messaging features – Drop all stored procedures, views, and triggers that use the messaging built-ins for the real-time messaging feature. For more information about real-time messaging, see the Real Time Data Services Messaging Users Guide.
  2. If you used New Sort Orders – If a new nocase sortorder for Chinese or Japanese character sets is configured as Adaptive server's default sortorder then, before downgrading to a 15.0 or 15.0.1 release, switch to a sortorder that is compatible to that release. Switching a sortorder means all user indexes need to be reindexed. Please refer to Chapter 9, “Configuring Character Sets, Sort Orders, and Languages,” in the System Administration Guide for details on how to change server’s default sort order. If sp_downgrade is called when the new nocase sort order is in use, you see the following error message, and the downgrade process is aborted:
    Cannot downgrade to '%1!' server, which does not support
    server's current default sortorder.
  3. If you used Native XML – The XML Service feature of Adaptive Server includes the new xmltable function. You will get an error if you create views or stored procedures using the xmltable function in 15.0.2 then return to 15.0 or 15.0.1.
  4. If you usedinstead of Triggers – instead of triggers are objects stored in the system catalogs. Remove these objects before downgrading. When the 15.0 or 15.0.1 server is started, any unremoved instead of triggers remain in the system catalogs but do not execute.
  5. If you used SQL User-Defined Functions – SQL user-defined functions are objects stored in the system catalogs. If you do not remove them before downgrading, they remain in the catalogs after downgrade. Attempts to drop or execute a SQL user-defined function from a 15.0 or 15.0.1 version will result in misleading error messages.
  6. If you installed the 15.0.2 automatic database expansion procedures using installdbextend then applied the threshold procedure to one or more database segments, the thresholds might not work properly when applied to the log segment after a downgrade to 15.0 or 15.0.1. To clear all auto-expansion thresholds that might exist on one or more segments before downgrading, run:
    sp_dbextend 'clear', 'threshold'
    Alternatively, before downgrading, you can disable the entire automatic expansion feature server-wide without changing any existing rules or clearing any thresholds. Execute the following using sa_role:
    use master 
    go 
    sp_dbextend 'disable', 'database', 'server-wide' 
    go
    This prevents threshold procedures from doing any work even if they were fired at runtime.
    Note: Sybase recommends that you leave all the policies and thresholds in place, and simply disable the entire feature server-wide before the downgrade. This simplifies re-enabling automatic expansion if you return to 15.0.2 later.
  7. If you have Replication Issues with downgrade – When downgrading a server that has replication enabled on databases that contain encrypted data, perform one of the following before you start the downgrade procedure:
    1. Ensure that all replicated data in the primary database transaction log has been successfully transferred to the standby or replicate database. The process for doing this is application dependent.
    1. Using the following commands truncate the transaction log in the primary database, and zero the RS locator for that database in the Replication Server®. In the primary database run:
      sp_stop_rep_agent primary_dbname
      dbcc settrunc ('ltm', 'ignore') 
      dump tran primary_dbname with truncate_only 
      dbcc settruc ('ltm', 'valid')
      Shut down Replication Server. In the RSSD for the Replication Server run:
      rs_zeroltm primary_servername, primary_dbname


Created June 23, 2009. Send feedback on this help topic to Sybase Technical Publications: pubs@sybase.com