Symantec logo

About attributes

Veritas Cluster Server has the following types of attributes, depending on the object the attribute applies to.

Resource type attributes 

 

Attributes that define the resource types in Veritas Cluster Server. These can be further classified as: 

  • Type-independent—Attributes that all agents (or resource types) understand. Examples: RestartLimit and MonitorInterval; these can be set for any resource type.

    Typically, these attributes are set for all resources of a specific type. For example, if you set the MonitorInterval for the IP resource type, the same value applies to all resources of type IP. You can also override the values of these attributes.

  • Type-dependent—Attributes that apply to a particular resource type. These attributes appear in the type definition file (.xml) for the agent.

    Examples: The MountPath attribute applies only to the Mount resource type. The Address attribute applies only to the IP resource type.

    Attributes defined in the file types.xml apply to all resources of the resource type. Defining these attributes in the main.cf file overrides the values in the .xml file for a specific resource.

    For example, setting StartVolumes = 1 for the DiskGroup resource type defaults StartVolumes to True for all DiskGroup resources. Setting the value in main.cf overrides the value on a per-resource basis.

  • Static—These attributes apply for every resource of a particular type. These attributes are prefixed with the term static and are not included in the resource's argument list. You can override some static attributes and assign them resource-specific values.

Attribute data types

Veritas Cluster Server supports the following data types for attributes.

String 

A string is a sequence of characters enclosed by double quotes. A string may also contain double quotes, but the quotes must be immediately preceded by a backslash. A backslash is represented in a string as \\. Quotes are not required if a string begins with a letter, and contains only letters, numbers, dashes (-), and underscores (_). For example, a string defining a network interface such as hme0 or eth0 does not require quotes as it contains only letters and numbers. However a string defining an IP address contains periods and requires quotes, such as: "192.168.100.1"  

Veritas Cluster Server also supports UTF-8 encoded values for some attributes.  

Integer 

Signed integer constants are a sequence of digits from 0 to 9. They may be preceded by a dash, and are interpreted in base 10. Integers cannot exceed the value of a 32-bit signed integer: 21471183247. 

Boolean 

A boolean is an integer, the possible values of which are 0 (false) and 1 (true).  

Attribute dimensions

Veritas Cluster Server attributes have the following dimensions.

Scalar 

A scalar has only one value. This is the default dimension.  

For example: 

str MountPoint

When values are assigned to a scalar attribute in the main.cf configuration file, it might resemble: 

MountPoint = "/Backup"

Vector 

A vector is an ordered list of values. Each value is indexed using a positive integer beginning with zero. Use a comma (,) or a semi-colon (;) to separate values.  

A set of brackets ([]) after the attribute name denotes that the dimension is a vector.  

For example: 

str BackupSys[]

When values are assigned to a vector attribute in the main.cf configuration file, the attribute definition might resemble:  

BackupSys[] = { sysA, sysB, sysC }

For example, an agent's ArgList is defined as: 

static str ArgList[] = { Address, SubNetMask,

MACAddress }

Keylist 

A keylist is an unordered list of strings, and each string is unique within the list. Use a comma (,) or a semi-colon (;) to separate values. 

For example, to designate the list of systems on which a service group will be started with Veritas Cluster Server (usually at system boot): 

AutoStartList = {SystemA; SystemB; SystemC}

For example: 

keylist BackupVols = {}

When values are assigned to a keylist attribute in the main.cf file, it might resemble:  

BackupVols = { vol1, vol2 }

Association 

An association is an unordered list of name-value pairs. Use a comma (,) or a semi-colon (;) to separate values. 

A set of braces ({}) after the attribute name denotes that an attribute is an association.  

For example, to designate the list of systems on which the service group is configured to run and the system's priorities: 

SystemList = {SystemA=1, SystemB=2, SystemC=3}

For example: 

int BackupSysList {}

When values are assigned to an association attribute in the main.cf file, it might resemble: 

BackupSysList{} = { sysa=1, sysb=2, sysc=3 }

Localizable attributes

Veritas Cluster Server supports UTF-8 encoded localized values for some attributes. These attributes are identified by the i18nstr keyword in the type definition file types.cf.

For example, in the FileOnOff agent, the attribute PathName is a localizable attribute.

type FileOnOff (

static i18nstr ArgList[] = { PathName }

i18nstr PathName

)

You can add a localizable string attribute using the haattr -add -i18nstring command.

Attribute scope across systems: global and local attributes

An attribute whose value is the same across all systems in the SystemList is global in scope. An attribute whose value applies on a per-system basis is local in scope.

The at operator (@) indicates the system to which a local value applies.

Windows: An example of local attributes can be found in the IP resource type where Mac addresses and routing options are assigned per machine.

IP IP_resource (

Address = "192.168.1.201"

SubNetMask = "255.255.254.0"

MACAddress @ system1= "02-B1-D5-D1-88-0E"

MACAddress @ system2= "04-B0-D0-D1-88-43"

)

Attribute life: temporary attributes

You can define temporary attributes in the types.xml file. The values of temporary attributes remain in memory as long as the Veritas Cluster Server engine (HAD) is running. Values of temporary attributes are not available when the engine is restarted. These attribute values are not stored in the main.cf file.

Temporary attributes cannot be converted to permanent, and vice-versa. When you save a configuration, Veritas Cluster Server saves temporary attributes and their default values in the file types.cf.

You can define and modify these attributes only while Veritas Cluster Server is running.