This section describes how to use the Management Console to create, configure, and manage a cluster.
Highlight the Clusters folder, right-click, and select Add.
In the New Cluster wizard, enter a name for the cluster.
Select the primary server. The default selection is the server to which the Management Console is connected.
When you synchronize the cluster, the primary server’s properties are distributed to the participating servers.
Select the participating servers. A server is available to add to the cluster only if it is not a member of another cluster.
If no servers are available to add to the cluster, you can create a new server by entering the following values, then selecting Add New Server:
Server Name – a name for the new server.
Host Name – the name of the machine that
hosts the new server. If the name of the server is different than
the name of the machine, enter the fully-qualified machine name;
for example, mach1.sybase.com.
IIOP Port Number – the server’s IIOP port number.
HTTP Port Number – the server’s HTTP port number.
A new server is created with an IIOP listener and an HTTP listener. The listeners are named serverName_iiop and serverName_http, where serverName is the name of the new server. After you create a new server, the server displays in the Participating Servers list, and it is selected as a member of the cluster.
To add another server, repeat this step.
On the Summary page, verify the cluster configuration. Select Back to return to a previous page, or select Finish to create the cluster.
When you create a cluster, these export configuration files are generated automatically:
sync-clusterName, which you can use to synchronize the cluster. clusterName represents the name of the cluster.
sync-clusterName-security, which you can use to synchronize security changes, such as new users, roles, and role assignments.
Cluster members must all have the same
administrative password
All servers in a cluster must have the same password for the
admin@system user. This password is used to establish a
trust relationship between the servers. Load balancing relies on
trusted interserver communication, as does JMS clustering.
If all the servers in a cluster run on separate machines, all the servers can use the same listener ports. If multiple servers in a cluster run on the same machine, they must use different listener ports.
Use the Management Console to connect to the primary server, and add participating servers to the cluster.
Expand the Clusters icon.
Highlight the cluster to which you want to add servers.
On the General tab, enter the following information, then click Apply:
Primary Server Select the primary server in the cluster; the default is the server to which you are connected. The configuration property name is clusterPrimary.
Cluster ID A unique ID for the cluster. The typical format is a dotted-decimal TCP/IP address, a colon, and a port number; for example, 10.11.12.13:2000. The ID must be unique across the network of connected servers that share the same database. The ID need not be globally unique or refer to an actual TCP/IP address. The default value is derived from either the iiopListeners property or the httpListeners property of the server that is first added to the cluster. You can specify the value explicitly. The configuration property name is clusterID.
Cluster Version The version number of the cluster. The configuration property name is clusterVersion.
Server Properties Not to Synchronize A comma-separated list of server properties that are not propagated during cluster synchronization; by default, httpListeners, iiopListeners, host.name, and processID. The configuration property name is serverPropertiesNotToSynchronize.
Participating Servers To add all the defined servers to the cluster, select All. To add individual servers to the cluster, choose Select, then choose each server. If you select None, the cluster contains only the primary server. The configuration property name is servers.
After you add servers to the cluster, configure and build the cluster’s export configuration to enable synchronization—see “Defining the components of an export configuration”. When you configure the export configuration, select Restart Servers After Synchronizing to ensure that all the servers in the cluster use the same security-key information for interserver configuration.
If you add more servers later, you must synchronize the cluster again.
WARNING! After you add a nonprimary server to a cluster, the Management Console warns you when you connect directly to that server. If the new server has been the target of at least one synchronization before it was added as a cluster member, direct user updates to the server’s configuration may be overwritten when the cluster is synchronized.
This example illustrates how to create a new server and a cluster that contains the default server and the new server.
Creating a new server and a cluster
While connected to the default server, create a new server:
In the Management Console, highlight Servers, right-click, and select Add.
Enter the following, then select Next:
Server Name – the name of the server.
Server Host Name – the name of the machine
on which the server runs; for example, machine2.sybase.com.
If the server and the machine on which it runs have the same name, you need not enter the domain.
Add an IIOP listener by selecting Create a New Listener, clicking Add Listener, then entering:
Listener Name – a name for the IIOP listener.
Listener URL – select IIOP, then enter the machine name and the IIOP port number.
Add an HTTP listener by clicking Add Listener, then entering:
Listener Name – a name for the HTTP listener.
Listener URL – select HTTP, then enter the machine name and the HTTP port number.
Select Finish.
Create a cluster that includes the default server and the new server:
Select the Clusters node, right-click, and choose Add.
In the wizard, enter a name for the cluster, and select Finish.
In the left pane, highlight the cluster, then on the General tab:
Primary Server – select the server to which you are connected.
Participating Servers – choose Select, then choose the server you just created.
Click Apply.
Removing a server from
a cluster
Expand the Clusters icon, and select the cluster from which to remove the server.
On the General tab, unselect the server from the list of participating servers. To remove all the servers from the cluster, select None.
Click Apply.
Re-create the cluster’s export configuration, and synchronize the cluster—select Restart Servers After Synchronizing to restart the participating servers.
Expand the Clusters icon, and select the cluster to delete.
Right-click, and select Delete. In the Delete wizard, confirm that you want to delete the cluster.
