Attributes

Required attributes

Required attribute

Description

IpAddress 

The IP address or DNS name of a node in the remote cluster. The IP address can be either physical or virtual. 

When configuring a virtual IP address of a remote cluster, do not configure the IP resource as a part of the remote service group. 

Type and dimension: string-scalar 

Examples: "www.example.com" or "11.183.12.214" 

 

Port 

This is a required attribute when the remote cluster listens on a port other than the default value of 14141. 

See Port 

GroupName 

The name of the service group on the remote cluster that you want the RemoteGroup agent to monitor or manage. 

Type and dimension: string-scalar 

Example: "DBGrp" 

 

VCSSysName 

You must set this attribute to either the VCS system name or the ANY value. 

  • ANY

    The RemoteGroup resource goes online if the remote service group is online on any node in the remote cluster.

  • VCSSysName

    Use the name of a VCS system in a remote cluster where you want the remote service group to be online when the RemoteGroup resource goes online. Use this to establish a one-to-one mapping between the nodes of the local and remote clusters.

Type and dimension: string-scalar 

Example: "vcssys1" or "ANY" 

 

ControlMode 

Select only one of these values to determine the mode of operation of the RemoteGroup resource: MonitorOnly, OnlineOnly, or OnOff.  

  • OnOff

    The RemoteGroup resource brings the remote service group online or takes it offline.

    When you set the VCSSysName attribute to ANY, the SysList attribute of the remote service group determines the node where the remote service group onlines.

  • MonitorOnly

    The RemoteGroup resource only monitors the state of the remote service group. The RemoteGroup resource cannot online or offline the remote service group.

    Make sure that you bring the remote service group online before you online the RemoteGroup resource.

  • OnlineOnly

    The RemoteGroup resource only brings the remote service group online. The RemoteGroup resource cannot take the remote service group offline.

    When you set the VCSSysName attribute to ANY, the SysList attribute of the remote service group determines the node where the remote service group onlines.

Type and dimension: string-scalar 

 

Username 

This is the login user name for the remote cluster.  

When you set the ControlMode attribute to OnOff or OnlineOnly, the Username must have administrative privileges for the remote service group that you specify in the GroupName attribute. 

When you use the RemoteGroup Wizard to enter your username data, you need to enter your username and the domain name in separate fields. For a cluster that has the Symantec Product Authentication Service, you do not need to enter the domain name. 

For a secure remote cluster: 

  • Local Unix user

    user@nodename—where the nodename is the name of the node that is specified in the IpAddress attribute. Do not set the DomainType attribute.

  • NIS or NIS+ user

    user@domainName—where domainName is the name of the NIS or NIS+ domain for the user. You must set the value of the DomainType attribute to either to nis or nisplus.

Type and dimension: string-scalar 

Example:  

  • For a cluster without the Symantec Product Authentication Service: "johnsmith"
  • For a secure remote cluster: "foobar@example.com"

 

Password 

This is the password that corresponds to the user that you specify in the Username attribute. You must encrypt the password with the vcsencrypt -agent command.  

Note   Do not use the vcsencrypt utility when entering passwords from a configuration wizard or the Cluster Manager (Java Console).

Type and dimension: string-scalar 

 

Optional attributes

Optional attribute

Description

DomainType 

For a secure remote cluster only, enter the domain type information for the specified user. 

For users who have the domain type unixpwd, you do not have to set this attribute. 

Type: string-scalar 

Example: "nis", "nisplus" 

 

BrokerIp 

For a secure remote cluster only. If you need the RemoteGroup agent to communicate to a specific authentication broker, set the value of this attribute to the broker's IP address. 

Type: string-scalar 

Example: "128.11.295.51" 

 

Port 

The port where the remote engine listens for requests. 

This is an optional attribute, unless the remote cluster listens on a port other than the default value of 14141. 

Type and dimension: integer-scalar 

Default: 14141 

 

OfflineWaitTime 

The maximum expected time in seconds that the remote service group may take to offline. VCS calls the clean function for the RemoteGroup resource if the remote service group takes a longer time to offline than the time that you have specified for this attribute. 

Type and dimension: integer-scalar 

Default: 0 

 

Type-level attributes

Type level attributes

Description

OnlineRetryLimit 

OnlineWaitLimit 

ToleranceLimit 

MonitorInterval 

 

In case of remote service groups that take a longer time to Online, Symantec recommends that you modify the default OnlineWaitLimit and OnlineRetryLimit attributes. 

If you expect the RemoteGroup agent to tolerate sudden offlines of the remote service group, then modify the ToleranceLimit attribute. 

See the Veritas Cluster Server Administrator's Guide for more information about these attributes.