HP 3PAR StoreServ Cluster Extension Software Administrator Guide (5697-2442, July 2013)

4 CLI commands and utilities
Using its CLI and command-line utilities, HP 3PAR StoreServ Cluster Extension can be integrated
with almost any cluster software.
CLI commands
The HP 3PAR StoreServ Cluster Extension CLI command clx3PARrun can be:
• Used as a standalone utility
• Integrated into any cluster software or custom application
• Executed manually to provide the automated disaster recovery for the applications whose
data is on the 3PAR storage (RC group LUN)
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 StoreServ Cluster
Extension.
Syntax clx3PARrun [–version] [–forceflag] app_name
Operands Displays the HP 3PAR StoreServ 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 StoreServ 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 StoreServ 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.
CLI commands 57