For the Cluster Edition, several parameters have been added to the dataserver utility for starting and configuring a cluster.
This is the complete syntax for the dataserver command:
dataserver
-u, --admin_name=sa/sso_name
--buildquorum=[force]
-a, --caps_file=filename
-F, --cluster_input=filename
--cluster_takeover
-L, --conn_config_file=[filename]
--create_cluster_id
-D, --default_db_size=size_spec
-e, --error_log=[filename]
-G, --event_log_server=logserv_name
-f, --forcebuild
-H, --ha_server
-h, --help=[{0|1|2|3}[,display_width]]
--instance=instance_name
-y, --key_password=[key_password]
-K, --keytab_file=filename
-N, --license_prop_file=filename
-z, --logical_page_size=page_size
-Z, --master_db_size=size_spec
-d, --master_dev=master_device_name
-b, --master_dev_size=[size_spec]
-r, --master_mirror=filename
-m, --masterrecover
-g, --no_event_logging
-Q, --quorum_dev=quorum_dev
-q, --recover_quiesced
-w, --rewrite_db=database_name
-p, --sa_name=sa_name
-k, --server_principal=s_principal
-M, --shared_mem_dir=directory_name
-X, --sybmon
-T, --trace=trace_flag
-v, --version
--quorurm_dev=path_to_quorum_device – is the absolute path to the quorum device. It signals Adaptive Server to start as a shared-disk cluster. This is a required parameter for starting the Cluster Edition.
--cluster_input=input_file_name – loads the cluster configuration from the specified input file into the quorum device. Required when you include --buildquorum. You can use this parameter without buildquorum, but only when no other instances are running..
--instance=instance_name – name of the instance to start.
--create_cluster_id – pairs the master device and the quorum device. This can be used to pair an existing quorum device with an existing master device and may be required in a disaster recovery situation. Use this parameter with caution because it overrides a safety feature that prevents the Cluster Edition from booting with the wrong combination of master and quorum devices.
--buildquorum[=force] – creates a new quorum device. The force option overwrites an existing quorum device. This parameter requires that you include --cluster_input.
--cluster_takeover – used to perform a cluster takeover when you set automatic cluster takeover to zero (0). A cluster takeover is necessary when an abrubt total cluster failure leaves stale state information on the quorum device.
See the Utilities Guide for a complete description of the dataserver parameters.
Example 1 Create a new master and quorum device. The parameters in this example specify a 500 megabyte master device with a four kilobyte logical page size. The location of the master device, interface configuration file, interfaces path, and error log are specified in the cluster input file mycluster.inp. The name of the instance creating the quorum and master devices is "myase1":
dataserver --quorum_dev=/dev/raw/raw101 --buildquorum --cluster_input=mycluster.inp --logical_page_size=4K --master_dev_size=500M --instance=myase1
After the master database is built and the server is shutdown, you can restart the instance with this:
dataserver --quorum_dev=/dev/raw/raw101 --instance=myase1
Example 2 Starts the instance myase2 as part of the cluster created in Example 1:
dataserver --quorum_dev=/dev/raw/raw101 --instance=myase2
Example 3 Recreates the quorum device for mycluster without overwriting the master device (starting the instance "myase1"). The cluster must be shutdown before rebuilding the quorum.:
dataserver --quorum_dev=/dev/raw/raw101 --buildquorum --cluster_input=mycluster.inp --instance=myase1
Reload the cluster configuration from the mycluster.inp input file without recreating the quorum device or the master device (the cluster must be shutdown first):
dataserver --quorum_dev=/dev/raw/raw101 --cluster_input=mycluster.inp --instance=myase1
The Cluster Edition pairs the master device with the quorum device to prevent you from accidentally starting your master device in multiple clusters. You can use --create_cluster_id to establish a relationship between an existing master device and an existing quorum device.
The dataserver command can read the following start options from the quorum device:
-d / --master_dev -e / --error_log -c / --config_file -i / --interface_dir -T / --trace
Options are honored in the following order:
Options that are passed to dataserver.
Options in the instance section of the cluster configuration file stored on the quorum device.
Options in the cluster section of the cluster configuration file stored on the quorum device.
In many cases you can start an instance by providing only the --quorum_dev and --instance parameters. However, any traceflags passed to dataserver with the -T or --trace parameters are combined with any traceflags stored on the quorum device.
dataserver does not honor the "additional run parameters" stored on the quorum device. These must be explicitly passed to dataserver (the values stored on the quorum device are read by the Unifed Agent and passed to dataserver when it is started by the agent).
