Conditionally required attributes

These attributes may be required depending on the desired Oracle Clusterware configuration. They have no default values. The conditionally required attributes are listed inTable 7-2, "Conditionally required attributes" and described in detail in this section.

AppCheckCmd

This attribute denotes the full command line for executing an application that checks the status of the application specified by AppName. It must include the full path name of the executable. If there are spaces in the path name, enclose the path name in double quotes. The command should return 0 when the application being checked is running and 1 when the application is not running.

Setting

Set AppCheckCmd as follows:

How the attribute is represented	Setting
`AppCheckCmd`	A string representing the command line for executing an application that checks the status of the application specified by AppName.

AppName

This attribute denotes the name of an application that will be managed by Oracle Clusterware. Oracle Clusterware uses the application name to name the corresponding resource. Any description of an application in the cluster.oracle.ini file must begin with this attribute.

Setting

Set AppName as follows:

How the attribute is represented	Setting
`AppName`	A string representing the name of the application, for example `testApp`.

AppStartCmd

This attribute denotes the command line that starts the application specified by AppName. It must include the full path name of the executable. If there are spaces in the path name, enclose the path name in double quotes.

Setting

Set AppStartCmd as follows:

How the attribute is represented	Setting
`AppStartCmd`	A string that represents the command line for starting the application specified by AppName.

AppStopCmd

This attribute denotes the command line that stops the application specified by AppName. It must include the full path name of the executable. If there are spaces in the path name, enclose the path name in double quotes.

Setting

Set AppStopCmd as follows:

How the attribute is represented	Setting
`AppStopCmd`	A string that represents the command line for stopping the application specified by AppName.

AppType

This attribute determines the data store to which the application should link.

Setting

Set AppType as follows:

How the attribute is represented Setting

How the attribute is represented	Setting
`AppType`	`Active` - The application links to the active data store of an active standby pair. `Standby` - The application links to the standby data store of an active standby pair. If the standby data store dies, applications linked to it migrate to the active data store until a new standby data store is alive. `Subscriber[index]`- The application links to a subscriber data store. The subscriber host used is the host occupying position index in either the SubscriberHosts attribute or the SubscriberVIP attribute, depending on whether virtual IP addresses are used. For a single subscriber, use `Subscriber[1]`. If no index is specified, TimesTen assumes that the application links to all subscribers.

AppType

Active - The application links to the active data store of an active standby pair.

Standby - The application links to the standby data store of an active standby pair. If the standby data store dies, applications linked to it migrate to the active data store until a new standby data store is alive.

Subscriber[index]- The application links to a subscriber data store. The subscriber host used is the host occupying position index in either the SubscriberHosts attribute or the SubscriberVIP attribute, depending on whether virtual IP addresses are used. For a single subscriber, use Subscriber[1]. If no index is specified, TimesTen assumes that the application links to all subscribers.

CacheConnect

If the active standby pair replicates cache groups, set this attribute to Y. If you specify Y, Oracle Clusterware assumes that TimesTen is connected to an Oracle database and prompts for the Oracle password.

Setting

Set CacheConnect as follows:

How the attribute is represented	Setting
`CacheConnect`	A value of `Y` (yes) or `N` (no). Default is `N`.

MasterVIP

This attribute is a list of the two virtual IP (VIP) addresses associated with two master data stores. This is used for advanced availability. This attribute is required if you intend to use virtual IP addresses.

Setting

Set MasterVIP as follows:

How the attribute is represented	Setting
`MasterVIP`	A comma separated list of two virtual IP addresses to the master data stores.

RemoteSubscriberHosts

This attribute contains a list of subscriber hosts that are part of the active standby pair replication scheme but are not managed by Oracle Clusterware.

Setting

Set RemoteSubscriberHosts as follows:

How the attribute is represented	Setting
`RemoteSubscriberHosts`	A comma-separated list of subscriber hosts that are not managed by Oracle Clusterware.

RepBackupDir

This attribute indicates the directory where the backup of the active data store is stored. This must be a directory in a shared file system that every node in the cluster can access. This attribute is required only if RepBackupPeriod is set to a value other than 0.

On Linux and UNIX, the directory must be an NFS partition that is shared by all hosts in the cluster. On Windows, it must be an OCFS (Oracle Cluster File System) partition, shared by all hosts.

If you want to enable backup, install OCFS on the shared storage during the Oracle Clusterware installation process. You can use this shared storage for backup for an active standby pair.

Setting

Set RepBackupDir as follows:

How the attribute is represented	Setting
`RepbackupDir`	Full path name to the replication backup directory.

SubscriberHosts

Lists the names of the hosts that can contain subscriber data stores. If virtual IP addresses are used, this list can overlap with the master host list provided by the MasterHosts attribute.

If the active standby pair is configured with subscribers, this attribute is required. It has no default value.

Setting

Set SubscriberHosts as follows:

How the attribute is represented Setting

How the attribute is represented	Setting
`SubscriberHosts`	A comma-separated list of host names. If virtual IP addresses are used, the order in which hosts will be assigned to subscriber virtual IP addresses. If virtual IP addresses are not used, the order is used to determine which application with an AppType of `Subscriber[index]` is attached to the subscriber data store on a specific host. Also, the number of subscriber hosts specified is the number of subscribers that are part of the active standby pair. A subscriber is brought up on every subscriber host.

SubscriberHosts

A comma-separated list of host names. If virtual IP addresses are used, the order in which hosts will be assigned to subscriber virtual IP addresses.

If virtual IP addresses are not used, the order is used to determine which application with an AppType of Subscriber[index] is attached to the subscriber data store on a specific host. Also, the number of subscriber hosts specified is the number of subscribers that are part of the active standby pair. A subscriber is brought up on every subscriber host.

SubscriberVIP

This attribute is a list of the virtual IP addresses associated with the subscriber data stores. This is used for advanced availability. This attribute is required if you intend to use virtual IP addresses.

Setting

Set SubscriberVIP as follows:

How the attribute is represented	Setting
`SubscriberVIP`	One or more virtual IP addresses. These addresses are mapped to SubscriberHosts. The number of subscriber virtual IP addresses determines the number of subscribers that are brought up as part of the active standby pair. The order of subscriber virtual IP addresses is used to determine which application with an AppType of `Subscriber[index]` is attached to the data store for a specific subscriber.

VIPInterface

This attribute is the name of the public network adapter used for virtual IP addresses on each host. This attribute is required if you intend to use virtual IP addresses.

Setting

Set VIPInterface as follows:

How the attribute is represented	Setting
`VIPInterface`	A string representing a network adapter.

VIPNetMask

This attribute is the netmask of the virtual IP addresses. This attribute is required if you intend to use virtual IP addresses.

Setting

Set VIPNetMask as follows:

How the attribute is represented	Setting
`VIPNetMask`	An IP netmask.