Administrator's Guide

4 CLI commands and utilities
Using its CLI and command-line utilities, HP 3PAR Cluster Extension can be integrated with almost
any cluster software.
CLI commands
The HP 3PAR Cluster Extension CLI command clx3PARrun can be:
• Used as a standalone utility
• Integrated into any cluster software or custom application
clx3PARrun
Description Use clx3PARrun to manually prepare the application service's
disk set before an existing application service start procedure is
invoked. You can use clx3PARrun in custom solutions and startup
scripts.
When using clx3PARrun, the status of the associated volume
group is checked to ensure that access to the virtual volume(s) will
occur under data consistency and concurrency situations only.
You must invoke clx3PARrun before the application service disk
set can be activated; it is considered an online-only program.
However, the CLI features provide the same disaster recovery
features as the integrated versions of HP 3PAR Cluster Extension.
Syntax clx3PARrun [–version] [–forceflag] app_name
Operands Displays the HP 3PAR Cluster Extension version–version
–forceflag Force startup
app_name Application name configured in the UCF.cfg file
Example 1 This example assumes you have defined an APPLICATION tag
named my-exchange in the UCF.cfg file, and have specified all
necessary objects, including the RCVolumeGroupA and
RCVolumeGroupB objects, to map the Remote Copy volume group
to the application service my-exchange. HP 3PAR Cluster Extension
will check the virtual volume set mapped to the application service
my-exchange, run the necessary failover procedure, and generate
a return code.
# clx3PARrun my-exchange
Example 2 This example assumes you have defined an APPLICATION tag
named my-exchange in the UCF.cfg file and have specified all
necessary objects, including the RCVolumeGroupA and
RCVolumeGroupB objects, to map the Remote Copy volume group
to the application service my-exchange. HP 3PAR Cluster Extension
will check the virtual volume set mapped to the application service
my-exchange, and run the necessary failover procedure to enable
read/write access to the virtual volumes.
# clx3PARrun -forceflag my-exchange
CLI commands 55