HP 3PAR Cluster Extension Software Administrator Guide (5697-0925, May 2011)
Installing HP 3PAR InForm Command Line Interface (CLI)
HP 3PAR Cluster Extension communicates with the HP 3PAR storage system using the HP 3PAR
InForm Command Line Interface (CLI). Ensure that you install the supported version of HP 3PAR
Command Line Interface (CLI) on a host where Clx3PARrun can be used.
Creating and configuring the user configuration file
The CLI expects as an argument the name configured as the APPLICATION tag value.
The following is an example of a customized user configuration file when using clx3PARrun:
#
COMMON
#LogLevel error # error|info default: error (optional)
# The APPLICATION part defines failover information for the application
specified
# as value of the APPLICATION tag. For example, the command - clx3PARrun MS
SQLCLX -
# will use the below settings to check and allow access to the disk set
specified
# as volume Group MS SQL.
# Necessary object when clxrun is used are:
# APPLICATION, DC_A_InServStorage_SerNum, DC_B_InServStorage_SerNum,
RCVolumeGroupA, RCVolumeGroupB, DC_A_Hosts and DC_B_Hosts
#APPLICATION MS SQLCLX # package/service/cluster group test_application
#DC_A_InServStorage_SerNum 30380
#DC_B_InServStorage_SerNum 30368
#RCVolumeGroupA vg_a
#RCVolumeGroupB vg_a.r23
#DC_A_Hosts clx_node1 clx_node2 # clx_node1, clx_node2 are data centre A cluster
nodes
#DC_B_Hosts clx_node3 clx_node4 # clx_node3, clx_node4 are data centre B cluster
nodes
#ApplicationStartup resyncwait # values: fastfailback | resyncwait
#Live Migration operation related parameters for CLX resource sapCLX which
belongs to VM group
#ClusterNotifyWaitTime 5
#ClusterNotifyCheckTime 10
#StatusRefreshInterval 300
Timing considerations
HP 3PAR Cluster Extension gives priority to storage system operations over cluster software
operations. If HP 3PAR Cluster Extension is invoked during a virtual volumes of Remote Copy
volume group are in resynchronization or full synchronization operation or is gathering information
about the remote storage system, it waits until the requested status information is reported. This
ensures the priority of data integrity over cluster software failover behavior. Because the failover
timing depends on the configuration of your Remote Copy environment, load on the HP 3PAR
storage system and the settings in the UCF.cfg file, you must evaluate the following considerations:
• HP 3PAR Cluster Extension uses HP 3PAR Command Line Interface (CLI) to communicate with
the HP 3PAR storage system, depending on the settings of HP 3PAR command timeout property,
and the number of remote Copy volume groups managed by HP 3PAR storage systems, the
online operation could time out. This can also happen if clx3PARrun is used in a script or
called by another program or 3PAR storage system IP cannot be reached.
• In the UCF.cfg file, if the ApplicationStartup attribute is set to RESYNCWAIT, HP 3PAR Cluster
Extension tries to resynchronize virtual volumes and waits until the Remote Copy volume group
is in a synced state. Depending on the amount of data to be transferred, it could take hours
to resynchronize. If this is the case, clx3PARrun may take some time to return. Do not stop
50 CLI commands and utilities