3 User configuration file and HP 3PAR Cluster Extension objects

Objects (also called properties in this document) define the HP 3PAR storage system environment and failover/failback behavior. You can customize HP 3PAR Cluster Extension objects in the user configuration file or in the cluster software.

User configuration file

For the CLI implementation of HP 3PAR Cluster Extension, the user configuration file UCF.cfg is used to configure application service-specific information. UCF.cfg describes the dependencies between application services and HP 3PAR Remote Copy volume groups in one file for all application services in the cluster.

AUCF.cfg file is available in the HP 3PAR Cluster Extension sample directory %ProgramFiles%\ Hewlett-Packard\Cluster Extension 3PAR\sample. This file can be copied and modified to suit a specific configuration.

After the user configuration file has been created, it must be copied to the /conf directory on all cluster nodes.

%ProgramFiles%\Hewlett-Packard\Cluster Extension 3PAR\conf

For more information, see “Sample configuration file” (page 53)and “Creating and configuring the user configuration file” (page 57).

Windows Clustering

HP 3PAR Cluster Extension integration with Windows cluster does not require a user configuration file when the standard environment for HP 3PAR Cluster Extension is used. The HP 3PAR Cluster Extension objects that are integrated with Windows cluster can be configured as resource private properties in the cluster software. See “Configuring HP 3PAR Cluster Extension” (page 16) for more information.

File structure

The configuration file consists of a COMMON section and an APPLICATION section. These sections are distinguished by control tags. HP 3PAR Cluster Extension uses the following objects as control tags:

•COMMON

•APPLICATION

Objects have one of the following formats:

tag

A definition of an object; for example, COMMON or APPLICATION

 

 

integer

A number; for example, a timeout value

 

 

string

A name, which can include alphabetic and numeric characters and underscores; for

 

example, an application startup value

 

 

list

A list of space-separated strings, for example, a list of host names (lists of numbers are

 

stored as lists of strings)

 

 

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.

User configuration file

47