add instance

Description

Adds one new instance to the cluster.

You can add an instance interactively, with sybcluster prompting for necessary configuration information, or through an input file. add instance also creates a local system temporary database for the new instance. add instance prompts vary depending on whether configuration for the cluster is shared or private.

Syntax

add instance instance_name [ file “input_file”]

Parameters

Usage

• add instance creates a local system temporary database for the new instance. Before executing add instance, make sure that a device with sufficient space for the local system database exists.

• The input file for add instance has the same format as the cluster input file. However, the add instance input file may limit the instance definitions to the new instance in the node section.

• add instance may prompt for this information:

  • The instance name, if you did not enter an instance name in the command statement.

  • The node hosting the instance

  • The port number of the UAF agent on the node

  • The query port number

  • The primary and secondary address of the node

  • The primary and secondary port specification

• If you have configured single Backup Servers for the cluster, add instance asks whether Backup Server is already configured for the new instance node. If no, add instance asks if Backup Server should be configured. If yes, it prompts for the Backup Server port for the node.

  If you have configured multiple Backup Servers for the cluster, add instance prompts for:

  • The name of the Backup Server

  • The Backup Server log file path

  • The Backup Server port for the new instance

  add instance also prompts for XP Server port number information for the new instance.

• If the installation mode is private, add instance prompts for additional information for the new instance:

  • The $SYBASE home directory.

  • The environment shell script path.

  • The Adaptive Server home directory.

  • The server configuration file path.

  • The interfaces file path, if LDAP is not configured.