© Copyright 2004 Last updated 7/13/04

Environment variables

HORCC_MRCF=1HORCMINST=n

/etc/services file

horcm0 11000/udp #HDS ShadowImage HORCM Instance 0

horcm1 11001/udp #HDS ShadowImage HORCM Instance 1

• \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

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

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

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 3000HORCM_CMD\\.\PHYSICALDRIVE1HORCM_DEVHORCM_INST

Example HORM0.CONF

HORCM_MON#host service poll(10ms) timeout(10ms)orahost horcm0 12000 3000

HORCM_CMD#dev_name dev_name /dev/rdsk/c3t0d1s2 /dev/rdsk/c4t0d1s2 HORCM_DEV#dev_group dev_name port# TargetID LU# MU#ORADB ORADB-01 CL1-A 7 3 0ORADB ORADB-02 CL1-A 7 4 0ORALOGS ORALOG-01 CL1-A 7 5 0 HORCM_INST#dev_group host serviceORADB backuphost horcm1 ORALOGS backuphost horcm1

Start CCI instances

– UNIX: horcmstart.sh 0 1

– Windows: horcmstart 0 1

horcmshutdown command

– UNIX: horcmshutdown.sh 0 1

– Windows: horcmshutdown 0 1

HitachiData Systems

9900/9900V OPEN

ShadowImage

Quick Reference

Guide

Cascaded Mirrors Detail

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

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

Best Practice: Always talk to Instance #0(HORCMINST=0) and always use ‘-vl’

Pair Display

pairdisplay -g <group> -fcx –CLI

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

Pair Suspend

pairsplit -g <group>

pairsplit -g <group> -d <dev>

Pair Resynchronize

pairresync -g <group>

Reverse Synchronization

pairresync -g <group> -restore

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

Pair Delete

pairsplit -S -g <group>

pairsplit –S –g <group> -d <dev>

Pair Event Wait

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

• Waits until a specific pair status is achieved before returning control

Pair Event Wait (without waiting)

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

• Query the pair status and return immediately

Returns a numeric value that indicates the current pair state

Pair Event Wait Status Codes

Status ReturnMnemonic Value Meaning

smpl 1 Simplex(no mirror)

copy 2 Copy

pair 3 Paired

psus 4 Suspended

psue 5 Suspended w/Error

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:

WIN32 Umount Subcommand

pairdisplay –x umount D:

pairdisplay –x umount \Vol2

pairdisplay –x umount F:\mountpoint

SYSTEM OPTION MODES

Mode

Description and Usage

80 ShadowImage Quick Restore function

ON DKC does not perform SI quick Restore operation.

OFF

DKC performs SI quick Restore operation.

87 Quick Resync by CCI (RAID Manager)

ON DKC performs HOMRCF quick resync operations for Resync command from Raid Manager.

OFF

DKC does not perform HOMRCF quick resync operation for Resync command fromRAID Manager.

122 ShadowImage Quick Split and Resync function

ON DKC does not perform SI quick split and resync operation.

OFF

DKC performs SI quick split and resync operation.

Caution: Quick Restore option swaps the P-vol & S-vol LDEV’s @ the parity group.

NOTE: Default is OFF for all options

Pairvolchk –ss Status Codes

ReturnValue Meaning

11 SMPL

22 PVOL_COPY or PVOL_RCPY

23 PVOL_PAIR

24 PVOL_PSUS

25 PVOL_PSUE

32 SVOL_COPY or SVOL_RCPY

33 SVOL_PAIR

34 SVOL_PSUS

35 SVOL_PSUE

WIN32 Sync Subcommand

pairdisplay –x sync all

pairdisplay –x sync D:

pairdisplay –x sync D:\mountpoint

pairdisplay –x sync hdisk3 hdisk4

pairdisplay –x sync \Vol2

Flushes the system cache to disk

Sync doesn’t propagate to volume mount points under a specified drive letter

WIN32 Mount Subcommand

pairdisplay –x mount

pairdisplay –x mount D: hdisk3 p1

pairdisplay –x mount E: \Vol2

pairdisplay –x mount F:\mountpoint \Vol3