HP XP Cluster Extension Software Administrator Guide

5 User configuration file and XP Cluster Extension objects
Objects (also called properties in this document) define the disk array environment and
failover/failback behavior. Information comes directly from the cluster software, indirectly from the
disk array through RAID Manager, and from a configuration file created by users. This file describes
the dependencies between application services and RAID Manager device/copy groups in one
file for all application services in the cluster.
The user configuration file provides customized and default values for supported parameters. You
can specify all customizable XP Cluster Extension objects in the file, and a copy must exist on all
nodes using XP Cluster Extension. XP Cluster Extension uses the information objects to match current
disk states and configuration parameters and to invoke actions, including preparing disks to be
activated or stopping the application startup.
User configuration file location
The user configuration file is placed in the configuration directory
%ProgramFiles%\Hewlett-Packard\Cluster Extension XP\conf.
For more information, see:
• “Basic configuration example” (page 58)
• “Creating and configuring the user configuration file” (page 40)
MSFC
XP Cluster Extension integration with MSFC does not require a user configuration file when the
standard environment for XP Cluster Extension is used. The XP Cluster Extension objects that are
integrated with MSFC can be configured as resource-specific properties in the cluster software.
For more information, see “Configuring XP Cluster Extension resources” (page 18).
File structure
The configuration file consists of a COMMON section and an APPLICATION section. These sections
are distinguished by control tags. XP Cluster Extension uses the following objects as control tags:
• COMMON
• APPLICATION
Objects have one of the following formats:
A definition of an object; for example, COMMON or APPLICATIONtag
A number; for example, a timeout valueinteger
A name, which can include alphabetic and numeric characters and underscores; for example, an
application startup value
string
A list of space-separated strings, for example, a list of host names (lists of numbers are stored as lists
of strings)
list
Text that is a comment starts with the pound (#) symbol and continues until the end of the line.
Comments can start on a new line or be part of a line specifying an object.
Specifying object values
When using the default configuration, you must provide values for the following objects:
• DeviceGroup: A RAID Manager device/copy group
• DC_A_Hosts: A list of the cluster nodes in data center A
User configuration file location 47