Hitachi Data Systems

Hitachi Command Control Interface (CCI) Quick Reference

Guide
© Copyright 2005 V1.7 08/28/07
instance on the attached host. See HORCM_CMD • If using HiCommand, the SVOL can’t be mounted
Documentation dev_name for additional information. • If using HiCommand, the Hitachi Device Manager
®
• Hitachi TagmaStore Adaptable Modular Storage and • Command Device must be equal to or greater than software Agent must have recognized the PVOL and
®
Workgroup Modular Storage TrueCopy Synchronous 65,538 blocks (one (1) block = 512 bytes) 33 megabytes SVOL.
Remote Replication User’s Guide MK-95DF710-09 (MB) • If LUSE, the number of LDEVs must be same
• Hitachi TagmaStore Adaptable Modular Storage • WARNING: Do not create a file system or mount a
Command Control Interface (CCI) User and Reference
•
volume that will be specified as a Command Device.
Each Command Device must be mapped to a fibre port
Files
Guide MK-95DF701-12
by the CCI. Configuration and Services files:
• Hitachi TagmaStore Adaptable Modular Storage and /etc/horcm*.conf UNIX
®
Workgroup Modular Storage Navigator Modular • Up to two (2) Command Devices can be assigned per
Thunder 9500 V Series system. If two (2) Command C:\winnt\horcm*.conf Windows
Graphical User Interface (GUI) User’s Guide, MK-
Devices are defined, both will be “Alternate Command • Config for each instance ( * = instance number)
95DF711
Devices”. Only one (1) of these will be current, the other • Best practice is horcm0.conf is for PVOLs
® will be for recovery of a failure. The HOST must see both • Best practice is horcm1.conf is for SVOLs
Hitachi TrueCopy Remote Replication of these “Alternate Command Devices”.
Software Prerequisites • To force a switch to the other “Alternate Command /etc/services UNIX
• TrueCopy software license installed in all associated Device”, issue the “horcctl –C” command. C:\winnt\system32\drivers\etc\services Windows
storage systems • When you use the Synchronous TrueCopy software for • port names and numbers for horcm* instances.
• At least one (1) Differential Management LUN the Thunder 9500 V function, CCI must set the Command • horcm0 11000/udp #HDS HORCM Instance 0
(recommend 2) (Adaptable Modular Storage system only) Devices on both the local and remote disk subsystems. • horcm1 11001/udp #HDS HORCM Instance 1
• At least one (1) TrueCopy software link(s) (two (2) • Will not be managed by Hitachi Dynamic Link Manager Note: When using HiCommand to define a new group, it
recommended) configured in each storage system software will ask for Group Name, HORCM Instances and
Note: If direct connect use Fibre Channel Arbitrated HORCM ports. HiCommand will create new
Loop (FC-AL) topology. If switches, use point-to- GUID: Global Unique Identifier HORCM*.conf files with all the necessary information
point topology. ® ®
• Created for a disk when Microsoft Windows ’ Disk and write the HORCM port entries in the services file. If
• At least one (1) ( two (2) recommended) Command Management defines a partition HiCommand is used later to remove all of the
Device(s) configured in each storage system TIP: Use GUID for the Command Device if using Windows. associated pairs and groups, the corresponding entries
The “raidscan –x findcmddev drive#(x,y)” will display in the services file and the horcm*.conf files will be
Hitachi ShadowImage™ In-System PhysicalDrive# and GUID deleted.
Warning: Do not set two (2) or more paths for a single
Software Prerequisites server to the same Command Device because Windows Log files:
• ShadowImage software license installed in associated 2000/2003 may change the “GUID” when a volume with an /HORCM/log*/curlog UNIX
storage systems identical GUID is found. C:\HORCM\log*\curlog Windows
• At least one (1) Differential Management LUN (two (2)
recommend) (Hitachi Workgroup Modular Storage and Microprogram: The internal Thunder 9500 V Series Miscelleneous files:
Adaptable Modular Storage systems only) system’s software. /etc/horcmperm*.conf UNIX
• At least one (1) (two (2) recommended) Command Warning: Do not execute commands that change pair WINNT\horcmperm*.conf Windows
Device(s) configured in each storage system status. ( paircreate, pairsplit, pairresync) when loading • The default file that contains the list of the protected
microcode. The microcode load can take up to four (4) volumes
Hitachi Copy-on-Write Snapshot minutes per controller and some scripts/batch jobs may • Only used if HORCMPROMOD is set or if Hitachi RAID
Software Prerequisites indicate a failure. The controller with the new code will be Manager protection is enabled for the Command Device
restarted and CCI commands should not be run during this using “CCI”.
• Copy-on-Write software [QuickShadow] license time.
installed in associated storage systems
• At least one (1) Differential Management LUN (two (2) Protection Function
CCI Commands
recommend) (Workgroup Modular Storage and Adaptable • Protects a volume that cannot be recognized by the hosts Important Notes:
Modular Storage systems only) from pair operations To get help for commands
• At least one (1) (two (2) recommended) Command • Enabled/disabled for the Command Device by CCI • On the command line, enter the command with a –h
Device(s) configured in each storage system
• Also can be enabled/disabled by the HORCMPROMOD example: pairdisplay -h
environment variable To get help for subcommands
Terms Note: If enabled via Resource Manager, • On the command line, enter the command with a –xh
Alternate Command Device HORCMPROMOD has no affect. example: pairdisplay -xh
• A member of a defined pair of Command Devices TIP: To determine if Protection Mode is enabled for the To run a subcommand
• Used to recover from a failure of the current Command Command Device, issue the “horcctl –D” command. • Enter the main command with a –x subcommand
Device # horcctl –D example: c:\horcm\etc\>pairdisplay –x mount
• When two (2) Command Devices are defined, they are Current control device = /dev/rdsl/c0t0d0*
If the output displays the device file name appended
recognized as alternate Command Devices
with “*”, this indicates the Protect Function is enabled.
List of Common CCI commands:
• horcctl: used for maintenance and troubleshooting.
Command Device • horcmshutdown: shuts down HORCM instance(s)
• Accepts TrueCopy Synchronous software, ShadowImage PVOL: Primary (Source) volume
• TrueCopy, ShadowImage, and Copy-on-Write software • horcmstart: starts HORCM instance(s)
software, and Copy-on-Write software for Hitachi storage • inqraid: displays device info from a HOST perspective
systems CCI commands. The host does not
SVOL: Secondary (Target) volume: • paircreate: Creates pairs
communicate TrueCopy Synchronous software,
• Applies to TrueCopy and ShadowImage software • paircurchk:: Checks consistency of SVOL
ShadowImage software, or Copy-on-Write software
• pairdisplay: Displays pair status
commands directly to the volumes on Hitachi storage
systems. The CCI commands are always sent through V-VOL: Virtual (Target) volume used with Copy-on-Write • pairevtwait: Waits for return status of pair operations
the Hitachi storage system Command Device. software • pairmon: Monitors pair activity
• The Command Device is dedicated to CCI • Also called a snapshot volume • pairresync: Resyncs a split pair
communications and should not be used by any other • Pairsplit: Suspends updates to the SVOL
applications. Warnings on creating PVOL and SVOL pairs for • Pairvolchk: Display volume or group status
• Each Command Device must be defined in Hitachi ShadowImage and TrueCopy software: • raidar: displays configuration, status, and I/O activity
™
Thunder 9500 V Series modular storage systems, • ShadowImage software default controller must be • raidqry: displays configuration of Host and subsystem
Workgroup Modular Storage, and Adaptable Modular identical • raidscan: displays configuration and status of subsystem
Storage systems by the CCI. • ShadowImage and TrueCopy software require the same
number of data drives in a RAID Group.
• Each Command Device must also be defined in the Common subcommands for Windows:
HORCM_CMD section of the config file for the CCI • ShadowImage and TrueCopy software require an
identical volume size in pair.
• -x drivescan: displays the relationship between the • [-fw] Display of the volstat with wide format • -vl Specifies the vector(Local_node)
Thunder 9500 V Series system’s LDEV to the Windows • [-CLI] Display with the command line interface (CLI) • -vr Specifies the vector(Remote_node)
hard drives format
• -x env: Displays environment variables • [-CLIWP] Displays the Port_WWN for this host with the
• -x findcmddev: searches for Command Devices CLI format
• -x mount: displays/mounts specified drives • [-CLIWN] Displays the Node_WWN for this host with the Warnings for paircreate using CCI:
• -x portscan: Displays devices on specified port(s) CLI format • Use –vl if this server has the HORCCM instance that
• -x setenv: sets environment variables • [-sort] Displays and sorts by Serial# and LDEV# controls the PVOLs. However, if multiple HORCM
• -x sleep: causes CCI to wait/sleep for specified seconds • [-sort -CM] Displays and sorts the cmddev by Serial# in instances are running in this server, make sure the
• -x sync: Flushes unwritten data from Windows to horcm.conf image correct env variable is set. (Best practice is to use horcm
specified devices. The logical and physical devices to be • [-fv] Display of Volume{GUID} via $Volume for Windows instance 0 and set HORCMINST=0)
synchronized must be offline to all other applications. The 2000. • Use –vr if this server does not have the HORCM instance
sync does not propagate to a specified drive, which has a • [No arg] Find out the LDEV from harddisk#... in the that controls the PVOLs. If multiple HORCM instances
directory mount on the Windows 2000/2003 system. STDIN are running in this server, make sure the correct env
• -x umount: Unmounts the specified logical drive and • [-find[c]] Find the group by using pairdisplay from variable is set because this server will use the remote
deletes the drive letter. Before deleting the drive letter, harddisk#... in the STDIN. instance specified in the HORCM_INST ip_address of
this subcommand executes sync internally for the • [-gplba] Obtains the logical block access (LBA) for usable the horcm*.conf file that is specified in the local env
specified logical drive and flushes unwritten data. partition from disk#... in the STDIN. HORCMINST variable.
• -x usetenv: resets environment variables • [-gvinf] Obtains a drive layout and makes a layout file • Before issuing the paircreate command, verify that the
from disk#... in the STDIN SVOL is not mounted on any system. If the SVOL is
mounted after paircreate, delete the pair, unmount the
Details of CCI commands • [-svinf[=PTN]] Sets a drive layout to disk[=PTN]# in the
SVOL, and reissue the paircreate command.
horcctl: STDIN
Note: HiCommand will not create pairs if the SVOL is
-d Set to the trace control of the client • [harddisk#...] Find out the LDEV from args(harddisk#...)
mounted.
-c Set to the trace control of HORCM • [$DosDevice] Find out the LDEV from DosDevice
-S Shutdown of HORCM • $LETALL -> Specifies all of the Drive Letter paircurchk:
-D Displays the Command Device name currently used $C: -> Specifies a 'C:' drive The paircurchk command assumes that the target
by HORCM. If the command device is blocked due to $Phys -> Specifies all Physical Drives is an SVOL, is used to check consistency, and is used in
online maintenance (microcode replacement) of the $Volume -> Specifies all LDM Vols for Win2K conjunction with the horctakeover command.
Thunder 9500 V Series system, you can check the $Volume{...} -> Specifies a Volume{...} for Win2K
• -g <group> Specifies the group_name
Command Device name in advance using this option. • [echo hd0-10 | inqraid] Find out the LDEV from
• -d <pair Vol> Specifies the pair_volume_name
-C Changes the control device of HORCM harddisk#... of the echo
• -d[g] <drive#(0-N)> [mun#] Specifies the Physical drive#
-u <unitid> Specifies the unitid for '-D or -C' options • [echo hd0-10 | inqraid -find] Find out the group from
without '-g' option
-ND Show network addr and port name currently used harddisk#... of the echo
• -d[g] <Seq#> <ldev#> [mun#] Specifies the LDEV# in the
-NC Changes the network addr of HORCM • [ inqraid $LETALL -CLI ] Find out the LDEV from all of
RAID without '-g' option
-g <group> Specifies the group name in the HORCM file for the Drive letter
• -I[#] Set to HORCMINST#
'-ND or -NC' options • [ inqraid $Volume -CLI ] Find out the LDEV from all of
-l <level> Set to the trace_level • -IH[#] or -ITC[#] Set to HORC mode [and HORCMINST#]
the LDM Volumes for Win2k.
-b <y/n> Set to the trace_mode • -IM[#] or -ISI[#] Set to MRCF mode [and HORCMINST#]
• [ inqraid $Phys -gvinf -CLI ] Gets a drive layout and
-s <size(KB)> Set to the trace_size makes a layout file from all of the Physical Drives • -nomsg Not display message of paircurchk
• [ echo hd0-10 | inqraid -svinf ] Sets a drive layout to
horcmshutdown: Stops HORCM application pairdisplay:
disk#0-10
One (1) CCI instance: Displays the pairing status, which enables you to verify the
• [ls /dev/rdsk/* | /HORCM/usr/bin/inqraid] Find out the
• UNIX: # horcmshutdown.sh completion of pair creation or pair resynchronization. This
LDEV from /dev/rdsk/... of the ls
• Windows: > horcmshutdown command is used to confirm the configuration of the paired
• [ls /dev/rdsk/* | /HORCM/usr/bin/inqraid -find] Find out volume connection path (physical link of paired volumes
Two (2) CCI instances called 0 and 1: the group from /dev/rdsk/... of the ls
• UNIX: # horcmshutdown.sh 0 1 among the servers).
• [vxdisk list | grep vg_name | /HORCM/usr/bin/inqraid] • -x <command> <arg> ... Specifies the SUB command
• Windows: > horcmshutdown 0 1 Find out the LDEV from vg_name of the vxdisk
• -g <group> Specifies the group_name
• [ pairdisplay -l -fd -g VG1 | inqraid -svinf=Harddisk ] Sets
horcmstart {inst}: Starts HORCM application • -d <pair Vol> Specifies the pair_volume_name
a drive layout to disk# related to a group(VG1).
One (1) CCI instance: • -d[g] <drive#(0-N)> [mun#] Specifies the Physical drive#
• UNIX: # horcmstart.sh without '-g' option
paircreate:
• Windows: > horcmstart • -d[g] <Seq#> <ldev#> [mun#] Specifies the LDEV# in the
• -g <group> Specifies the group_name
Two (2) CCI instances called 0 and 1: RAID without '-g' option
• -d <pair Vol> Specifies the pair_volume_name
• UNIX: # horcmstart.sh 0 1 • -I[#] Set to HORCMINST#
• -d[g] <drive#(0-N)> [mun#] Specifies the Physical drive#
• Windows: > horcmstart 0 1 • -IH[#] or -ITC[#] Set to HORC mode [and HORCMINST#]
without '-g' option
Notes: • -IM[#] or -ISI[#] Set to MRCF mode [and HORCMINST#]
• -d[g] <Seq#> <ldev#> [mun#] Specifies the LDEV# in the
If argument has no instance number, then it starts one (1) RAID without '-g' option • -c Specifies the pair_check
HORCM and uses the environment variables set by the • -I[#] Set to HORCMINST# • -l Specifies the local only
user. • -IH[#] or -ITC[#] Set to HORC mode [and HORCMINST#] • -m <mode> Specifies the display_mode(cas/all) for
For UNIX-based platforms if HORCMINST is specified: cascading configuration
• -IM[#] or -ISI[#] Set to MRCF mode [and HORCMINST#]
• HORCM_CONF = /etc/horcm*.conf (* is instance • -f[x] Specifies the display of LDEV#(hex)
• -f <fence> [CTGID] Specifies the fence_level
number) (never/status/data/async) [TrueCopy and Universal • -f[c] Specifies the display of COPY rate
HORCM_LOG = /HORCM/log*/curlog HORCM_LOGS = Replicator software] • -f[d] Specifies the display of the Device file name
/HORCM/log*/tmplog
• -c <size> Specifies the track size for copy (1-15) • -f[m] Specifies the display of the Bitmap table
For UNIX-based platforms If no HORCMINST is • -f[e] Specifies the display of the External LUN mapped
• -split [ShadowImage and Copy-on-Write software only]
specified: to LDEV
Splits the paired volume after the initial copy operation is
• HORCM_CONF = /etc/horcm.conf • -CLI Specifies the display of the CLI format
complete.
HORCM_LOG = /HORCM/log/curlog • -FHORC Specifies the force operation for cascading
• -m <mode..> Specifies the create mode<'cyl or trk'> for
HORCM_LOGS = /HORCM/log/tmplog HORC_VOL
® SVOL, <grp CTG# (0-127)> [ShadowImage software
For Windows NT /2000 platform If HORCMINST is • -FMRCF [mun#] Specifies the force operation for
only] Makes a group for splitting all ShadowImage
specified: cascading MRCF_VOL
software pairs specified in a group, such as TrueCopy
• HORCM_CONF = \WINNT\horcm*.conf (* is instance • -v jnl[t] Specifies the display of the journal information
Asynchronous software, or <cc> [ShadowImage software
number) interconnected to the group (Universal Replicator only)
only]. Specifies the Hitachi Volume Migration software
HORCM_LOG = \HORCM\log*\curlog • -v ctg Specifies the display of the CT group
(CruiseControl) mode for volume migration
HORCM_LOGS = \HORCM\log*\tmplog information interconnected to the group (TrueCopy and
• -nocopy Set to the No_copy_mode (TrueCopy
For Windows NT/2000 platform If no HORCMINST is Universal Replicator software only]
software only)
specified: • -v smk Specifies display of the Marker on the volume
• -nomsg Not display message of paircreate
• HORCM_CONF = \WINNT\horcm.conf pairevtwait:
• -pid <id#> Specifies the pool ID for pooling SVOL (Copy-
HORCM_LOG = \HORCM\log\curlog • -x <command> <arg> ... Specifies the SUB command
HORCM_LOGS = \HORCM\log\tmplog on-Write software for enterprise storage systems)
• -jp <id> (HORC/Universal Replicator software only): • -g <group> group_name
If HORCM fails to start:
Basically, Universal Replicator software has the same • -d <pair Vol> pair_volume_name
• Check contents of the horcm*.conf files
characteristic as a TrueCopy Asynchronous software • -d[g] <drive#(0-N)> [mun#] Specifies the Physical drive#
• Verify that the Command Device(s) is valid.
Remote Copy Consistency Group; therefore, this option without '-g' option
is used to specify a Journal Group ID for the PVOL. • -d[g] <Seq#> <ldev#> [mun#] the LDEV# in the RAID
inqraid:
• -js <id> (HORC/Universal Replicator software only): This without '-g' option
• [-inqdump] Dump option for STD inquiry info
option is used to specify a Journal Group ID for the • -I[#] Set to HORCMINST#
• [-fx] Display of LDEV# with hexadecimal
SVOL. Both the -jp <id> and -js <id> options are valid • -IH[#] or -ITC[#] Set to HORC mode [and HORCMINST#]
• [-fp] Display of the H.A.R.D volume with adding '*' when the fence level is set to "ASYNC", and each Journal • -IM[#] or -ISI[#] Set to MRCF mode [and HORCMINST#]
• [-fl] Display of the LDEV GUARD volume with adding '*' Group ID is automatically bound to the CTGID. • -nomsg Not display message of pairevtwait
• [-fg] Display of the host group ID with port
• -nowait Set to the No_wait_mode • -c Remote_volume_check Example of displaying drives on ports 0 - 20:
• -s <status> ... Specifies the • -ss Encode of pair_status C:\horcm\etc\>raidscan -x portscan port0, 20
status_name(smpl/copy/pair/psus/psuse(psue)) • -FHORC Specifies the force operation for cascading
• -t <timeout> [interval] Wait_time HORC_VOL -x sync:
• -l Specifies the local only • -FMRCF [mun#] Specifies the force operation for -x sync A: B: C: ...
• -FHORC Specifies the force operation for cascading cascading MRCF_VOL -x sync all
HORC_VOL raidar: -x sync drive#(0-N) ...
• -FMRCF [mun#] Specifies the force operation for • -I[#] Set to HORCMINST# -x sync Volume#(0-N) ... (Windows 2000/2003 systems)
cascading MRCF_VOL • -IH[#] or -ITC[#] Set to HORC mode [and HORCMINST#] -x sync D:\directory or \directory pattern ... (Windows
• -IM[#] or -ISI[#] Set to MRCF mode [and HORCMINST#] 2000/2003 systems only)
pairmon: Example of flushing data to drive D:
• -x <command> <arg> ... Specifies the SUB command
• -xh Help/Usage for SUB commands C:\horcm\etc\> pairsplit –x sync D:
• -s <interval> [count] Specifies the starting and
• -x <command> <arg> ... SUB command interval(sec)
• -D Set to the Default_mode -x umount:
• -sm <interval> [count] Specifies the starting and -x umount drive:
• -I[#] Set to HORCMINST# interval(min) -x umount drive:[\[directory]] … Windows 2000/2003
• -IH[#] or -ITC[#] Set to HORC mode [and HORCMINST#] • -p <port> <targ> <lun> port(CL1-A or cl1-a... cl3-a or Example of unmounting F: and G: and then splitting the
• -IM[#] or -ISI[#] Set to MRCF mode [and HORCMINST#] CL3-A ... for the expansion(Lower) port) target_ID LUN# volume group called oradb
• -allsnd Set to the All_send_mode • -pd[g] <drive#(0-N)> Physical drive# C:\horcm\etc\> pairsplit -x umount F: -x umount G: -g
• -resevt Set to the Reset_mode raidqry: oradb
• -nowait Set to the No_wait_mode • -I[#] Set to HORCMINST#
• -s <status> ... Specifies the • -IH[#] or -ITC[#] Set to HORC mode [and HORCMINST#]
status_name(smpl/copy/pair/psus/psuse(psue)) • -IM[#] or -ISI[#] Set to MRCF mode [and HORCMINST#] Environment Variables
• -x <command> <arg> ... Specifies the SUB command
pairresync: HORCC_LOG:
• -l Specifies the local query
• -x <command> <arg> ... Specifies the SUB command • -r <group> Specifies the remote query • Specifies the command log directory name, default =
• -g <group> group_name /HORCM/log* (* = instance number).
• -f Specifies display for floatable host
• -d <pair Vol> pair_volume_name raidscan:
• -d[g] <drive#(0-N)> [mun#] Specifies the Physical drive# HORCC_MRCF
• -I[#] Set to HORCMINST#
without '-g' option • Required for ShadowImage or Copy-on-Write software
• -IH[#] or -ITC[#] Set to HORC mode [and HORCMINST#]
• -d[g] <Seq#> <ldev#> [mun#] the LDEV# in the RAID [formally QuickShadow]
• -IM[#] or -ISI[#] Set to MRCF mode [and HORCMINST#]
without '-g' option • To display for Win, “Set h”
• -x <command> <arg> ... Specifies the SUB command
• -I[#] Set to HORCMINST# • To set on for Win, “Set HORCC_MRCF=1”
• -p <port> [hgrp#] Specifies the port_name(CL1-A or cl1-
• -IH[#] or -ITC[#] Set to HORC mode [and HORCMINST#] • To set off for Win, “Set HORCC_MRCF=”
a... cl3-a or CL3-A... for the expansion(Lower) port)
• -IM[#] or -ISI[#] Set to MRCF mode [and HORCMINST#] • To set For B shell, “# HORCC_MRCF=1” followed by “#
• -pd[g] <drive#(0-N)> Physical drive#
• -nomsg Not display message of pairresync export HORCC_MRCF”
• -pi <'strings'> Specifies the 'strings' for -find option
• -c <size> Specifies the track size for copy (1-15) • To set for C shell, “# setenv HORCC_MRCF 1”
without using STDIN
• Do not set on this env variable if issuing TrueCopy
• -l Specifies the local only • -t <targ> Specifies the target_ID
Synchronous/Asynchronous software commands.
• -restore Specify Re_sync from SVOL to PVOL • -l <lun> Specifies the LUN#
[ShadowImage software only] • -m <mun> Scan the specified MU# only HORCM_CONF:
• -FHORC Specifies the force operation for cascading • -s <Seq#> Seq#(Serial#) of the RAID • Names the HORCM configuration file.
HORC_VOL • -f[f] display of the volume-type default = /etc/horcm.conf
• -FMRCF [mun#] Specifies the force operation for • -f[x] display of the LDEV#(hex)
cascading MRCF_VOL • -f[g] display of the Group-name HORCMINST:
• -swapp Specifies Swap_resync for Changing PVOL to • -f[d] display of the Device file name • Specifies the instance number when using two (2) or
SVOL on the PVOL side • -f[e] display of the External LUN only more CCI instances on the same server. The command
• -swaps Specifies Swap_resync for Changing SVOL to • -CLI Specifies display of CLI format execution environment and the HORCM activation
PVOL on the SVOL side
• -find[g] Find out the LDEV from the Physical drive# via environment require an instance number to be specified.
Warning for pairresync using CCIs:
STDIN. Set the configuration definition file (HORCM_CONF) and
• Ensure SVOL is not mounted prior to issuing the
• -find inst [-fx] Registers the Physical drive via STDIN to log directories (HORCM_LOG and HORCC_LOG) for
pairresync each instance.
HORCM and
• Ensure PVOL is not mounted prior to issuing the o permits its volumes on horcm.conf in Protection Mode • To display for Win, “Set h”
pairresync with the restore argument • -find verify [mun#] [-f[x][d]] Find out the relation between • To set on instance 0 for Win, “Set HORCMINST=0”
Group • To set on instance 1 for Win, “Set HORCMINST=1”
pairsplit:
! on horcm.conf and Physical drive via STDIN • To set off for Win, Set HORCMINST =”
• -x <command> <arg> ... Specifies the SUB command
• -find[g] conf [mun#][-g name] Displays the Physical drive • To set on instance 0 for B shell, “# HORCMINST=0”
• -g <group> Specifies the group_name in horcm.conf image. followed by “# export HORCMINST”
• -d <pair Vol> Specifies the pair_volume_name • -find sync [mun#][-g name] Flushes the system buffer • To set for C shell, “# setenv HORCMINST 0”
• -d[g] <drive#(0-N)> [mun#] Specifies the Physical drive# associated to a group.
without '-g' option • For example: [C:\HORCM\etc>raidscan -pi $Phys –find] HORCMPROMOD:
• -d[g] <Seq#> <ldev#> [mun#] Specifies the LDEV# in the DEVICE_FILE UID S/F PORT TARG LUN SERIAL LDEV PRODUCT_ID • Sets HORCM forcibly to protection mode
RAID without '-g' option Harddisk0 0 F CL2-A 25 0 2496 16 DF600F-CM • Command Devices in non-protection mode can be used
• -I[#] Set to HORCMINST# Harddisk1 0 F CL2-A 25 1 2496 18 DF600F as protection mode also
• -IH[#] or -ITC[#] Set to HORC mode [and HORCMINST#] Harddisk2 0 F CL2-A 25 2 2496 19 DF600F
• -IM[#] or -ISI[#] Set to MRCF mode [and HORCMINST#] • For example: [ raidscan -pi hd0-10 -find [-fx] ] HORCMPERM:
• -nomsg Not display message of pairsplit • For example: [ echo hd0-10 | raidscan -find [-fx] ] • Specifies the file name for the protected volumes. When
• -r split_mode(Read_Only) • For example: [ echo $Phys | raidscan -find [-fx] ] this variable is not specified, the default name is as
• -rw split_mode(Read_Write) o $variable specifies as follows. follows:
• -S Specify the split_mode(Simplex) o $LETALL -> All of the Drive Letter UNIX : /etc/horcmperm*.conf
• -R split_mode(Svol_Simplex) o $Phys -> All of the Physical Drives Windows NT/200X:WINNT\horcmperm*.conf
• -P split_mode(Pvol_Suspend) o $Volume -> All of the LDM Volumes for Windows2000 (* as an instance number):
• -l Specifies the local only
• -FHORC Specifies the force operation for cascading Details of Windows Sub Commands Note: The polling environment variables are validated for
HORC_PVOL -x drivescan: -x drivescan drive#(0-N) only the Hitachi Universal Storage Platform and Network
• -FMRCF [mun#] Specifies the force operation for Example of displaying windows drives 0 - 20: Storage Controller and are also validated on TrueCopy-
cascading MRCF_PVOL C:\horcm\etc\>raidscan -x drivescan harddisk0, 20 TrueCopy/ShadowImage cascading operations using “-
FHOMRCF [MU#] option. To maintain compatibility across
pairvolchk: -x findcmddev: -x findcmddev drive#(0-N) RAID subsystems, these variables are ignored by Hitachi
™
• -x <command> <arg> ... Specifies the SUB command Example to search for command device in drives 0– 20 Lightning 9900 V/9900 Series enterprise storage systems,
• -g <group> group_name C:\horcm\etc\>raidscan -x findcmddev hdisk0, 20 which enables you to use a script with “$HORCC_SPLT,
• -d <pair Vol> pair_volume_name $HORCC_RSYN, $HORCC_REST” for Universal Storage
• -d[g] <drive#(0-N)> [mun#] Specifies the Physical drive# -x mount: Platform/Network Storage Controller on the Lightning 9900
without '-g' option -x mount drive: hdisk# partition# ... (for Windows NT )
® V/9900 storage systems.
• -d[g] <Seq#> <ldev#> [mun#] the LDEV# in the RAID -x mount drive: Volume#(0-N) ... (for Windows 2000/2003)
-x mount drive: [\[directory]] Volume#(0-N) ... (for Windows HORCC_SPLT (for Enterprise):
without '-g' option
2000/2003) • “Set HORCC_SPLT=NORMAL” The “pairsplit” and
• -I[#] Set to HORCMINST#
Example to display all mounted filesystems: “paircreate –split” will be performed as non-quick mode
• -IH[#] or -ITC[#] Set to HORC mode [and HORCMINST#]
C:\horcm\etc\>raidscan –x mount regardless of the setting of the mode (122) via service
• -IM[#] or -ISI[#] Set to MRCF mode [and HORCMINST#] processor (SVP) (Remote console).
• -nomsg No message of pairvolchk
-x portscan: -x portscan port#(0-N)
• “Set HORCC_SPLT=QUICK” The “pairsplit” and drive letter and no Windows format) to the Command • Numeric type with a max of six (6)
“paircreate –split” will be performed as Quick Split Device to get a GUID. • Format can be CU:LDEV, decimal value, 0xhex value
regardless of the mode (122) via SVP (Remote console). • When a server is connected to two (2) or more Thunder • Only available on with CCI 1-16-X and higher – Can
9500 V systems, the HORCM identifies each system be used with/instead of HORCM_DEV
HORCC_RSYN (for Enterprise): using the unit ID (see Figure 2.22). The unit ID is
• “Set HORCC_RSYN=NORMAL” The “pairresync” will be assigned sequentially in the order described in this HORCM_INST dev_group
performed as Non quick Resync mode regardless of section of the configuration definition file. If more than • All group names defined in HORCM_DEV section must
setting of the mode (87) via SVP (Remote console). one (1) Command Device (maximum of two) is specified be entered here.
• “Set HORCC_RSYN=QUICK” The “pairresync” will be in a disk subsystem, the second Command Device has to
performed as Quick Resync mode regardless of setting of be described side-by-side with the already described HORCM_INST ip_address
the mode (87) via SVP (Remote console). Command Device in a line. The server must be able to • IP address or alias name of the remote server that
verify that the unit ID is the same as the Serial# (Serial contains the dev_group.
HORCC_REST (for Enterprise): ID) among servers when a Thunder 9500 V system is • If all associated instances are in one (1) server, alias of
• “Set HORCC_REST=NORMAL” The “pairresync – shared by two (2) or more servers, which can be verified `localhost’ is OK
restore” will be performed as Non quick mode regardless using the raidqry command. • If two (2) or more network addresses are on different
of the setting of the mode (80) via SVP (Remote subnets, this item must be NONE
console). HORCM_DEV dev_group
• “Set HORCC_REST=QUICK” The “pairresync –restore” • String type with max of 31, but the recommended value is HORCM_INST service
will be performed as Quick Restore regardless of the eight (8) characters Port name (requires entry in appropriate services file) or
setting of the mode (80) via SVP (Remote console). • Names a group of paired logical volumes and must be port number of remote server.
unique
• Commands can be executed for all corresponding
horcm*.conf volumes by group name Cascaded Mirrors Detail
HORCM_MON ip_address HORCM_DEV dev_name
• String type with max of 63 characters • String type with a max of 31, but the recommended value
• Actual IP address or alias name of this local server is eight (8) characters
• If all associated instances are in one (1) server, alias of • Each pair requires a unique dev_name
localhost is OK • Warning: A duplicate dev_name will cause
• If two (2) or more network addresses on different horcmstart to fail.
subnets, this item must be NONE
HORCM_DEV port #
HORCM_MON Service • String type with a max of 31 characters
• String or numeric with max of 15 characters • The port numbers must be CL1-x or CL2-x
• Port name (requires entry in appropriate services file) or • The port number can also be CL1-x-y, where y is the host
port number of local server storage group number as found on subsystem
• The Thunder 9500 V system uses the following mapping:
HORCM_MON Poll (10 ms) • CL1-A, CL1-B, CL1-C, CL1-D = 9500V/AMS/WMS port
• The interval for polling (health check) of the other 0A, 0B, 0C and 0D
instance(s) • CL2-A, CL2-B, CL2-C, CL2-D = 9500V/AMS/WMS port
• Calculating the value for poll(10ms): 1A, 1B, 1C and 1D
6000 x the number of all associated CCI instances. With Midrange only has 1:3, cascade is only ShadowImage
two (2) instances, this equals 120000ms or a poll every HORCM_DEV Target ID software on enterprise storage systems.
two (2) minutes. • Numeric type (decimal) with a max of seven (7)
• If all the CCI instances are in a single server, turn off
polling by entering –1 to increase performance
characters Return Codes
• Use TID from raidscan –p <port>.
HORCM_MON Timeout (10 ms) Pairvolchk -ss:
HORCM_DEV dev_group LU# 11 SMPL
• Timeout value for no response from remote server. • Numeric type (decimal) with a max of seven (7)
Default is 3000 x 10ms or 30 seconds. For TrueCopy Synchronous/ShadowImage software
characters 22 PVOL_COPY or PVOL_RCPY
• Use LU values from raidscan –p <port> 23 PVOL_PAIR
HORCM_CMD dev_name
• Never use hex values or data corruption may occur. If 24 PVOL_PSUS
• String type with a max of 63 characters hex has alpha character, then invalid MU# may occur.
• Command Device must be mapped to a server port 25 PVOL_PSUE
running the CCI instance. 32 SVOL_COPY or SVOL_RCPY
HORCM_DEV MU# 33 SVOL_PAIR
• Decimal 34 SVOL_PSUS
Examples of Command Devices: • MU# is blank for TrueCopy software pairs 35 SVOL_PSUE
HP-UX®: /dev/rdsk/c0t0d0 • MU# defines the remote copy number of ShadowImage For TrueCopy Asynchronous/Universal Replicator software
and Copy-on-Write, formerly QuickShadow volumes 42 PVOL_COPY or PVOL_RCPY
Solaris™: /dev/rdsk/c0t0d0s2 • If Environment variable HORCC_MRCF=1, at least one 43 PVOL_PAIR
OR (1) pair must have a MU# 44 PVOL_PSUS
/dev/rdsk/c0t50060E80000000000000A9C300000252d0s2 • The SVOL of ShadowImage or Copy-on-Write, formerly 45 PVOL_PSUE
Note: format with no label required QuickShadow must be MU#0 52 SVOL_COPY or SVOL_RCPY
53 SVOL_PAIR
AIX®: /dev/rhdiskX HORCM_LDEV dev_group 54 SVOL_PSUS
Note: X = device number is created automatically by AIX 55 SVOL_PSUE
• String type with max of 31, but the recommended value is
either (8) characters
Tru64 UNIX: /dev/rdisk/dskXc
• Names a group of paired logical volumes and must be
Note: X = device number assigned by Tru64 UNIX Pairevtwait -nowait:
unique
• Commands can be executed for all corresponding Status Return
Linux®: /dev/sdX Mnemonic Value Meaning
volumes by group name
Note: X = device number assigned by Linux Smpl 1 Simplex (No Mirror)
• Only available with CCI 1-16-X and higher – Can be
used with/instead of HORCM_DEV Copy 2 Copy
IRIX®: /dev/rdsk/dksXdXlXvol Pair 3 Paired
OR Psus 4 Suspended
/dev/rdsk/node_wwn/lunXvol/cXpX HORCM_LDEV dev_name
• String type with a max of 31, but the recommended value Psue 5 Suspended with Error
Note: X = device number assigned by IRIX
is either (8) characters
Windows NT/2000/2003: \\.\PhysicalDriveX • Each pair requires a unique dev_name
Pairevtwait :
OR • Warning: A duplicate dev_name will cause
0 Normal (Success)
\\.\CMD-Ser#-LDEV#-Port# horcmstart to fail.
232 Timeout waiting for specified status on the local host
Note: Ser# is the Serial Number of the array, LDEV3 is the • Only available with CCI 1-16-X and higher – Can be
233 Timeout waiting for specified status
array internal LU number, and Port# is the Cluster/Port to used with/instead of HORCM_DEV
which the command disk is assigned.
OR HORCM_LDEV serial#
\\.\Volume{guid} (Windows 2000/2003 only) • Numeric type with a max of 12
Note: X = device number assigned by Windows • This is the Serial Number of the subsystem of the LDEV
NT/2000/2003. If configurations change, Windows may • Only Available with CCI 1-16-X and higher – Can be
assign a different physical drive number after a subsequent used with/instead of HORCM_DEV
reboot and the Command Device will not be found. To avoid
this problem, assign a partition and logical drive (without a HORCM_LDEV CU:LDEV (LDEV#)
 Example of TrueCopy Synchronous Software for Thunder 9500 V Series System (Refer to Diagram)
Operations Commands
Display CCI version C:\HORCM\etc>raidqry -h
Model : RAID-Manager/WindowsNT
Ver&Rev: 01-11-03/00
Find Command Device C:\HORCM\etc>raidscan -x findcmddev drive#(0,20)
cmddev of Ser# 462 = \\.\PhysicalDrive4
Note: HORCM must be shutdown to run this command. cmddev of Ser# 463 = \\.\PhysicalDrive6
Write cmd dev in horcm*.conf C:\HORCM\etc>notepad c:\winnt\horcm0.conf
C:\HORCM\etc>notepad c:\winnt\horcm1.conf
• Start horcm C:\HORCM\etc>horcmstart 0 1
starting HORCM inst 0
• Set env variable for horcm instance 0 HORCM inst 0 starts successfully.
™
• Display TID and LUs for Thunder 9570V high-end systems starting HORCM inst 1
HORCM inst 1 starts successfully.
serial #65010462 C:\HORCM\etc>set HORCMINST=0
• Alter horcm0.conf if required C:\HORCM\etc>raidscan -p cl1-b -fx -s 462
• HORCM must be shutdown and restarted for any changes to PORT# /ALPA/C,TID#,LU#.Num(LDEV#....)...P/S, Status,Fence,LDEV#,P-Seq#,P-LDEV#
CL1-B / ef/ 5, 1, 24.1(18)............SMPL ---- ------ ----, ----- ----
horcm*.conf files to take affect. CL1-B / ef/ 5, 1, 25.1(19)............SMPL ---- ------ ----, ----- ----
• Set env variable for horcm instance one (1) C:\HORCM\etc>set HORCMINST=1
C:\HORCM\etc>raidscan -p cl1-b -fx -s 463
• Display TID and LUs for Thunder 9570V system serial PORT# /ALPA/C,TID#,LU#.Num(LDEV#....)...P/S, Status,Fence,LDEV#,P-Seq#,P-LDEV#
#65010463 CL1-B / ef / 5, 1, 21.1(15)............SMPL ---- ------ ----, ----- ----
CL1-B / ef / 5, 1, 22.1(16)............SMPL ---- ------ ----, ----- ----
• Alter horcm1.conf if required
• HORCM must be shutdown and restarted for any changes
to horcm*.conf files to take affect
• Set env variable for horcm instance 0 C:\HORCM\etc>set HORCMINST=0
C:\HORCM\etc>paircreate -g VG01 -vl -c 15 -f never
• Start initial copy of Volume group VG01
Display the copy status to verify COPY to PAIR status. C:\HORCM\etc>pairdisplay -g VG01 -fc
Group PairVol(L/R) (Port#,TID,LU),Seq#,LDEV#.P/S,Status,Fence, % ,P-LDEV# M
VG01 work01(L) (CL1-B , 1, 24) 462 24..P-VOL PAIR NEVER , 100 21 -
VG01 work01(R) (CL1-B , 1, 21) 463 21..S-VOL PAIR NEVER , 100 24 -
VG01 work02(L) (CL1-B , 1, 25) 462 25..P-VOL PAIR NEVER , 100 22 -
VG01 work02(R) (CL1-B , 1, 22) 463 22..S-VOL PAIR NEVER , 100 25 -
Suspend Volume Group VG01 and verify that status went from C:\HORCM\etc>pairsplit -g VG01
C:\HORCM\etc>pairdisplay -g VG01 -fc
PAIR to PSUS. Group PairVol(L/R) (Port#,TID,LU),Seq#,LDEV#.P/S,Status,Fence, % ,P-LDEV# M
VG01 work01(L) (CL1-B , 1, 24) 462 24..P-VOL PSUS NEVER , 100 21 -
VG01 work01(R) (CL1-B , 1, 21) 463 21..S-VOL SSUS NEVER , 100 24 -
VG01 work02(L) (CL1-B , 1, 25) 462 25..P-VOL PSUS NEVER , 100 22 -
VG01 work02(R) (CL1-B , 1, 22) 463 22..S-VOL SSUS NEVER , 100 25 -
Resync Volume group VG01 and verify that status went from C:\HORCM\etc>pairdisplay -g VG01 -fc
Group PairVol(L/R) (Port#,TID,LU),Seq#,LDEV#.P/S,Status,Fence, % ,P-LDEV# M
PSUS to PAIR. Make sure to use the –fc argument to display VG01 work01(L) (CL1-B , 1, 24) 462 24..P-VOL PAIR NEVER , 100 21 -
percentage, or the status may display PAIR and may not be VG01 work01(R) (CL1-B , 1, 21) 463 21..S-VOL PAIR NEVER , 100 24 -
completed. VG01 work02(L) (CL1-B , 1, 25) 462 25..P-VOL PAIR NEVER , 100 22 -
VG01 work02(R) (CL1-B , 1, 22) 463 22..S-VOL PAIR NEVER , 100 25 -
Delete the pairs and verify status went from PAIR to SIMPLEX. C:\HORCM\etc>pairsplit -g VG01 -S
C:\HORCM\etc>pairdisplay -g VG01 -fc
Group PairVol(L/R) (Port#,TID,LU), Seq#,LDEV#.P/S,Status,Fence, % ,P-LDEV# M
VG01 work01(L) (CL1-B , 1, 24) 462 24..SMPL ---- ------,----- ---- -
VG01 work01(R) (CL1-B , 1, 21) 463 21..SMPL ---- ------,----- ---- -
VG01 work02(L) (CL1-B , 1, 25) 462 25..SMPL ---- ------,----- ---- -
VG01 work02(R) (CL1-B , 1, 22) 463 22..SMPL ---- ------,----- ---- -
Shutdown horcm C:\HORCM\etc>horcmshutdown 0 1
inst 0:
HORCM Shutdown inst 0 !!!
inst 1:
HORCM Shutdown inst 1 !!!

Example of 9500V TrueCopy

HORCMINST0 W2K Server HORCMINST1

Fibre
Port

Fibre Switch

0-A 0-A
Command Command
device device

P-Vol 0-B VG01 work01 0-B S-Vol

9500V #65010462 9500V #65010462

Product ID = DF600F 1-A 1-A Product ID = DF500F

P-Vol 1-B VG01 work02 1-B S-Vol

C:\winnt\horcm0.conf C:\winnt\horcm1.conf

HORCM_MON HORCM_MON
#ip_address service poll(10ms) timeout(10ms) #ip_address service poll(10ms) timeout(10ms)
10.15.11.194 horcm0 12000 3000 10.15.11.194 horcm1 12000 3000

HORCM_CMD HORCM_CMD
#dev_name #dev_name
\\.\PHYSICALDRIVE4 #0462 \\.\PHYSICALDRIVE6 #0463

HORCM_DEV HORCM_DEV
#dev_group dev_name port# TargetID LU# MU# #dev_group dev_name port# TargetID LU# MU#
VG01 test01 CL1-B 1 5 0 VG01 test01 CL1-B 1 3 0
VG01 work01 CL1-B 1 24 0 VG01 work01 CL1-B 1 21 0
VG01 work02 CL1-B 1 25 0 VG01 work02 CL1-B 1 22 0

HORCM_INST HORCM_INST
#dev_group ip_address service #dev_group ip_address service
VG01 10.15.11.194 horcm1 VG01 10.15.11.194 horcm0