upgrade server

Description

Upgrades a nonclustered Adaptive Server to the Adaptive Server Cluster Edition, and creates a cluster with a single instance.

You can perform the upgrade by answering prompts at the command line or via an input file.

You can upgrade from Adaptive Server version 12.5 and later to the Cluster Edition.

Syntax

upgrade server server_name 
	[ login login_name ]
	[ password password ]
	[ agent agent_spec ]
	[ discovery discovery_spec ]
	[ file input_file_name ]
	[ checkonly ]

Parameters

server_name: is the name of the non-clustered Adaptive Server.

login login_name: is the management agent login for the Sybase Common Security Infrastructure in the Unified Agent framework.

The default user name after installation is “uafadmin” with no password; this is the Simple Login Module in the Agent configuration. You can configure the user name and password to use several different mechanisms for authentication and authorization, including operating system logins.

password password: is the management agent password for the Sybase Common Security Infrastructure in the Unified Agent framework.

The default user name after installation is “uafadmin” with no password; this is the Simple Login Module in the Agent configuration. You can configure the user name and password to use several different mechanisms for authentication and authorization, including operating system logins.

agent agent_spec: is the agent specification that identifies the node in the cluster running a Unified Agent, and the port number that sybcluster uses to connect the Unified Agent.

When upgrading a non-clustered Adaptive Server, there is only one node. The format for agent_spec is “node_name:port_number”. The default port number is “9999.”

discovery discovery_spec: is the discovery method used to identify the agents responsible for the requested cluster.

The format is “method[(method_specification)] ”. See the description for sybcluster -d discovery_list for more information about discovery methods.

file file_name: is the input file containing values required for upgrading the server.

checkonly: performs a check run of the non-clustered Adaptive Server to determine its readiness for upgrade.

Examples

Example 1

Upgrades “myserver” to the Cluster Edition:

upgrade server

Enter the name of the cluster: new_cluster
Enter the existing Sybase installation directory for server myserver:
Enter the name of the subdirectory containing the ASE installation for server myserver:
Enter the name of the subdirectory containing the OCS installation for server myserver:
Enter the name of an sa login on server exit: [sa]
Enter a password:
Cluster new_cluster - Enter the maximum number of instances: [4]
Verifying the supplied agent specifications...
   1>tigger 9999 2.5.0 Linux
Enter the number representing the cluster node 1 [1]
Will this cluster be configured using private SYBASE installations? (Y/N)
...

The information required to upgrade a server or create a cluster are the same. See “create cluster” or the installation guide for your platform.

Usage

upgrade server prompts for these values:

The Sybase installation directory of the non-clustered Adaptive Server.
The release home directory of the non-clustered Adaptive Server.
The Open Client home directory of the non-clustered Adaptive Server.
The installation mode, private or shared.
If sybcluster detects a VCS subsystem, asks if you want to include VCS integration with the cluster.
If you have not configured LDAP, the path to the interfaces file.
The name of the first instance in the cluster.
Other values as required to create a cluster.

The checkonly option does not perform any upgrade steps, but instead check the server’s readiness for upgrade. Resolve the error conditions checkonly finds before performing the upgrade.