Special Upgrade Instructions

Upgrading from a 12.5.3 installation with cache bindings on sybsystemdb

If you are upgrading from Adaptive Server version 12.5.3 ESD #4 or later to the 15.0.3 Cluster Editor, and the sybsystemdb system database is bound to a user-defined cache, you may encounter the following error in the module 'bufdlink' during preupgrade, with the modules 'pg_getreserved', 'pg_recacloam', 'bufpindirty' reported in the stack trace:

Current process... infected with 11

To avoid this error, drop the cache bindings for sybsystemdb that are bound to user-defined cache, a and re-run preupgrade.

Upgrading Job Scheduler

When upgrading from a 12.5.x version to an Adaptive Server Cluster Edition version of Job Scheduler, increase the size of sybmgmtdb from 50MB to 90MB.

If jobs are created from templates, upgrade those jobs. See the instructions on upgrading Job Scheduler in the Users Guide to Clusters.

Upgrading from 15.0.1 Cluster Edition requires updating jar and xml files

After you upgrade your Adaptive Server Cluster Edition from version 15.0.1 to 15.0.3, perform the following one-time procedures for each of your user-created nodes to update the jar and xml files.

Shut down the UAF agent.

Enter the following:

mv $SYBASE/UAF-2_5/nodes/<Host Name>/plugins/<Cluster OR Instance Name>/lib $SYBASE/UAF-2_5/nodes/<Host Name>/plugins/<Cluster Or Instance Name>/lib.SDC

ln -s $SYBASE/UAF-2_5/templates/plugins/com.sybase.ase.cluster/15.0.1/lib $SYBASE/UAF-2_5/nodes/<Host Name>/plugins/<Cluster OR Instance Name>

mv $SYBASE/UAF-2_5/nodes/<Host Name>/plugins/<Cluster OR Instance Name>/arl.xml $SYBASE/UAF-2_5/nodes/<Host Name>/plugins/<Cluster OR Instance Name>/arl.xml.SDC

ln -s $SYBASE/UAF-2_5/templates/plugins/com.sybase.ase.cluster/15.0.1/arl.xml $SYBASE/UAF-2_5/nodes/<Host Name>/plugins/<Cluster OR Instance Name>/arl.xml

mv $SYBASE/UAF-2_5/nodes/<Host Name>/plugins/<Cluster OR Instance Name>/mbean-descriptor.xml $SYBASE/UAF-2_5/nodes/<Host Name>/plugins/<Cluster OR Instance Name>/mbean-descriptor.xml.SDC

ln -s $SYBASE/UAF-2_5/templates/plugins/com.sybase.ase.cluster/15.0.1/mbean-descriptor.xml $SYBASE/UAF-2_5/nodes/<Host Name>/plugins/<Cluster OR Instance Name>/mbean-descriptor.xml

Restart the UAF agent.
Repeat this procedure for all the nodes in your cluster.

The following example shows a two-node cluster with cluster name "mycluster", and node names "node1", and "node2":

Update node1 information:

mv $SYBASE/UAF-2_5/nodes/node1/plugins/mycluster/lib $SYBASE/UAF-2_5/nodes/node1/plugins/mycluster/lib.SDC
ln -s $SYBASE/UAF-2_5/templates/plugins/com.sybase.ase.cluster/15.0.1/lib $SYBASE/UAF-2_5/nodes/node1/plugins/mycluster 

mv $SYBASE/UAF-2_5/nodes/node1/plugins/mycluster/arl.xml $SYBASE/UAF-2_5/nodes/node1/plugins/mycluster/arl.xml.SDC
ln -s $SYBASE/UAF-2_5/templates/plugins/com.sybase.ase.cluster/15.0.1/arl.xml $SYBASE/UAF-2_5/nodes/node1/plugins/mycluster/arl.xml 

mv $SYBASE/UAF-2_5/nodes/node1/plugins/mycluster/mbean-descriptor.xml $SYBASE/UAF-2_5/nodes/node1/plugins/mycluster/mbean-descriptor.xml.SDC
ln -s $SYBASE/UAF-2_5/templates/plugins/com.sybase.ase.cluster/15.0.1/mbean-descriptor.xml $SYBASE/UAF-2_5/nodes/node1/plugins/mycluster/mbean-descriptor.xml

Update node2 information:

mv $SYBASE/UAF-2_5/nodes/node2/plugins/mycluster/lib $SYBASE/UAF-2_5/nodes/node2/plugins/mycluster/lib.SDC
ln -s $SYBASE/UAF-2_5/templates/plugins/com.sybase.ase.cluster/15.0.1/lib $SYBASE/UAF-2_5/nodes/node2/plugins/mycluster 

mv $SYBASE/UAF-2_5/nodes/node2/plugins/mycluster/arl.xml $SYBASE/UAF-2_5/nodes/node2/plugins/mycluster/arl.xml.SDC
ln -s $SYBASE/UAF-2_5/templates/plugins/com.sybase.ase.cluster/15.0.1/arl.xml $SYBASE/UAF-2_5/nodes/node2/plugins/mycluster/arl.xml 

mv $SYBASE/UAF-2_5/nodes/node2/plugins/mycluster/mbean-descriptor.xml $SYBASE/UAF-2_5/nodes/node2/plugins/mycluster/mbean-descriptor.xml.SDC
ln -s $SYBASE/UAF-2_5/templates/plugins/com.sybase.ase.cluster/15.0.1/mbean-descriptor.xml $SYBASE/UAF-2_5/nodes/node2/plugins/mycluster/mbean-descriptor.xml