Environment variables

Hitachi
Data Systems

HORCC_MRCF=1
HORCMINST=n
/etc/services file
horcm0
11000/udp
#HDS ShadowImage HORCM Instance 0
horcm1
11001/udp
#HDS ShadowImage HORCM Instance 1

9900/9900V
OPEN
ShadowIma
ge
Quick
Reference
Guide

\winnt\system32\drivers\etc\services on
Windows NT and 2000
Windows services file must have a return
after the last line
Finding The Command Device
-Solaris:
ls /dev/rdsk/* | ./inqraid
or for larger systems
ls /dev/rdsk/* | ./inqraid | grep CVS
-HP-UX:
ioscan fun | grep rdsk | ./inqraid
-Windows:
raidscan x findcmddev hdisk0,99 or
inqraid $Volume CLI fv -fx
-AIX:
lsdev -C -c disk | grep rhdisk | ./inqraid
Look for a Hitachi disk with a -CM in the
device identifier
Specifying the Command Device
Use system raw device name
Solaris: /dev/rdsk/c1t1d2s2
HP-UX: /dev/rdsk/c1t1d2
Windows:\\.\PhysicalDrive4 or
\\.\Volume{GUID}
AIX: /dev/rhdiskXX
where XX = device number assigned by
AIX

Copyright 2004

Last updated 7/13/04

Note: Solaris requires the Command Device to

be labeled by the Solaris "format" utility.
Windows requires the Command Device to be
"signatured" by Windows.
Note: The \\.\Volume{GIUD} must be made
by setting a partition using the disk
management without file system format. The
\\.\Volume{GIUD} will be kept as the same
command device, HORCM will convert to
\\.\PhysicalDriveX by finding the Physical
Drive number through \\.\Volume{GUID} if
\\.\Volume{GUID} is specified to
HORCM_CMD.
Location of configuration files

If using Host Storage Domains, you will

use the LUN number that corresponds to the
underlying LDEV rather than the LUN number
presented to the host via the Host Storage
Domain.
Absolute bare minimum HORCM0.CONF

HORCM_MON
#host service poll(10ms)
timeout(10ms)
127.0.0.1
horcm0 12000
HORCM_CMD
\\.\PHYSICALDRIVE1
HORCM_DEV
HORCM_INST

Example HORM0.CONF

horcmn.conf
UNIX: /etc/
Windows: C:\WINNT\ (NT4.0 & W2K)
C:\WINDOWS (WIN2K3 & XP)
Finding the Target ID (TID) & LUN
raidscan fx p CL1-A CLI
The above command will display all LUNs
(LDEVs in hex due to -fx) mapped to CL1-A
raidscan fx p CL1-A 9 CLI
The above command will display all LUNs
(LDEVs in hex due to -fx) mapped to CL1-A on
hostgroup 9
Mapping volumes to LDEVs
Compare volume mounts, LUNs, and LDEVs
-Solaris:
ls /dev/rdsk/* | ./inqraid
-HP-UX:
ioscan fun | grep rdsk | ./inqraid
-Windows:
inqraid $Volume
-AIX:
lsdev -C -c disk | grep hdisk | ./inqraid

3000

HORCM_MON
#host
service
timeout(10ms)
orahost
horcm0
12000
HORCM_CMD
#dev_name
/dev/rdsk/c3t0d1s2
HORCM_DEV
#dev_group
MU#
ORADB
0
ORADB
0
ORALOGS
0
HORCM_INST
#dev_group
ORADB
ORALOGS

poll(10ms)
3000

dev_name
/dev/rdsk/c4t0d1s2

dev_name

port# TargetID

LU#

ORADB-01

CL1-A

ORADB-02

CL1-A

ORALOG-01

CL1-A

host
backuphost
backuphost

service
horcm1
horcm1

Start CCI instances

UNIX: horcmstart.sh 0 1
Windows: horcmstart 0 1
horcmshutdown command
UNIX: horcmshutdown.sh 0 1
Windows: horcmshutdown 0 1

Reverse Synchronization

Cascaded Mirrors Detail

pairresync -g <group> -restore

Meaning

11

SMPL

22

PVOL_COPY or PVOL_RCPY

23

PVOL_PAIR

24

PVOL_PSUS

25

PVOL_PSUE

32

SVOL_COPY or SVOL_RCPY

Waits until a specific pair status is

achieved before returning control

33

SVOL_PAIR

34

SVOL_PSUS

Pair Event Wait (without waiting)

35

SVOL_PSUE

Pair Delete
pairsplit -S -g <group>
pairsplit S g <group> -d <dev>
Pair Event Wait

Midrange CCI software requires MU# to be

present, even if it's default of 0. Enterprise
CCI software assumes MU# of 0 if not present.
NOTE: command option -g effects the entire
group. The g with the d option only effects
that device in the group.
Pair Create

pairevtwait -g <group> -s <status> -t

<timeout>

pairevtwait -g <group> -s <status>

-nowait

paircreate -g <group> [ -vl | -vr ]

paircreate g <group> -d <dev> [-vl |
-vr]
Environment variable HORCMINST points to
current *local* HORCM instance.
-vl makes the local instance the primary
-vr makes the remote instance the primary

pairdisplay x umount D:

Return
Value

pairresync g <group> -d <dev> -restore

Query the pair status and return

immediately
Returns a numeric value that
indicates the current pair state
Pair Event Wait Status Codes

Status
Mnemonic

Return
Value

WIN32 Sync Subcommand

Meaning

Paired

pairdisplay -g <group> -fcx CLI

psus

Suspended

pairdisplay x mount

pairdisplay -g <group> -d <dev> -fcx

-CLI

psue

Suspended w/Error

pairdisplay x mount D: hdisk3 p1

pairresync -g <group>
pairresync -g <group> -d <dev>

Simplex(no mirror)

Flushes the system cache to disk

pair

Pair Resynchronize

Description and Usage

80

ShadowImage Quick Restore function

87

ON

DKC does not perform SI quick

Restore operation.

OF
F

DKC performs SI quick Restore

operation.

Quick Resync by CCI (RAID Manager)

ON

DKC performs HOMRCF quick

resync operations for Resync
command from Raid Manager.

OF
F

DKC does not perform HOMRCF

quick resync operation for
Resync command fromRAID
Manager.

pairdisplay x sync \Vol2

Copy

pairsplit -g <group> -d <dev>

Mod
e

pairdisplay x sync hdisk3 hdisk4

pairsplit -g <group>

SYSTEM OPTION MODES

pairdisplay x sync D:\mountpoint

copy

Pair Suspend

pairdisplay x umount F:\mountpoint

pairdisplay x sync D:

Pair Display

pairdisplay x umount \Vol2

pairdisplay x sync all

smpl

Best Practice: Always talk to Instance #0

(HORCMINST=0) and always use -vl

WIN32 Umount Subcommand

Pairvolchk ss Status Codes

Pair Volume Check

Queries the status of a single side of pair set
Check the state of a local instance volume:
pairvolchk g <group> -ss

Check the state of a remote instance volume:

pairvolchk g <group> -c -ss

Sync doesnt propagate to volume mount

points under a specified drive letter

122

ShadowImage Quick Split and Resync

function
ON

DKC does not perform SI quick

split and resync operation.

OF
F

DKC performs SI quick split and

resync operation.

WIN32 Mount Subcommand

pairdisplay x mount E: \Vol2

pairdisplay x mount F:\mountpoint \Vol3

Caution: Quick Restore option swaps the Pvol & S-vol LDEVs @ the parity group.
NOTE: Default is OFF for all options