Hitachi AMS 2000 Series User manual

Applicable platforms
Changes in this revision
Getting help
Table of contents
F AST F IND L INKS
MK-97DF8121-20
Hitachi AMS 2000 Family Command Control
Interface (CCI) Reference Guide

ii
Hitachi AMS 2000 Family Command Control Interface (CCI) Reference Guide
© 2008-2014 Hitachi, Ltd. All rights reserved.
No part of this publication may be reproduced or transmitted in any form or by any means, electronic or
mechanical, including photocopying and recording, or stored in a database or retrieval system for any
purpose without the express written permission of Hitachi, Ltd. and Hitachi Data Systems Corporation
(hereinafter referred to as “Hitachi”).
Hitachi, Ltd. and Hitachi Data Systems reserve the right to make changes to this document at any time
without notice and assume no responsibility for its use. Hitachi, Ltd. and Hitachi Data Systems products and
services can only be ordered under the terms and conditions of Hitachi Data Systems' applicable agreements.
All of the features described in this document may not be currently available. Refer to the most recent
product announcement or contact your local Hitachi Data Systems sales office for information on feature and
product availability.
Notice: Hitachi Data Systems products and services can be ordered only under the terms and conditions of
Hitachi Data Systems’ applicable agreements. The use of Hitachi Data Systems products is governed by the
terms of your agreements with Hitachi Data Systems.
Hitachi is a registered trademark of Hitachi, Ltd. in the United States and other countries. Hitachi Data
Systems is a registered trademark and service mark of Hitachi in the United States and other countries.
All other trademarks, service marks, and company names in this document are properties of their respective
owners.

Table of Contents iii
Hitachi AMS 2000 Family Command Control Interface (CCI) Reference Guide
Table of contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vii
Intended audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .viii
Product version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .viii
Release notes and readme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .viii
Document revision level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .viii
Changes in this revision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Document organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Applicable platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .x
Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiii
Convention for storage capacity values. . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiv
Related documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiv
Getting help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xix
Comments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xix
1 Performing CCI Operations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Important notice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Environment variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
Instance number and option for command execution environment. . . . . . . 1-4
Creating pairs (paircreate). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7
Splitting pairs (pairslpit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-14
Timing of pairsplit operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-19
Resynchronizing pairs (pairresync). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-20
Confirming pair operations (pairevtwait). . . . . . . . . . . . . . . . . . . . . . . . . . 1-25
Monitoring pair activity (pairmon) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-29
Checking attribute and status (pairvolchk) . . . . . . . . . . . . . . . . . . . . . . . . 1-31
Displaying pair status (pairdisplay). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-34
Checking pair currency (paircurchk) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-40
Performing takeover operations (horctakeover) . . . . . . . . . . . . . . . . . . . . . 1-43
Horctakeover command functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-46
Takeover-switch function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-46
Swap-takeover function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-48

iv Table of Contents
Hitachi AMS 2000 Family Command Control Interface (CCI) Reference Guide
SVOL-takeover function. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-48
PVOL-takeover function (TrueCopy only). . . . . . . . . . . . . . . . . . . . . . .1-49
Applications of the horctakeover command . . . . . . . . . . . . . . . . . . . . . . .1-49
Displaying configuration information . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-51
Raidscan command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-51
Raidar command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-57
Raidqry command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-58
Data protection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-60
Raidvchkset command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-60
Volume restrictions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-62
Raidvchkdsp command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-62
Raidvchkscan command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-66
Controlling CCI activity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-68
Horcmstart command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-68
Horcmshutdown command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-70
Horcctl command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-70
Windows 2000 and Windows Server subcommands . . . . . . . . . . . . . . . . . .1-73
Findcmddev subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-73
Drivescan subcommand. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-74
Portscan subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-75
Sync and syncd subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-76
Mount subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-78
Umount subcommand. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-81
Environment variable subcommands. . . . . . . . . . . . . . . . . . . . . . . . . . . .1-83
Command tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-85
Inqraid command tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-85
Mkconf command tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-93
Host group control. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-96
Specifying a host group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-96
Commands and options including a host group . . . . . . . . . . . . . . . . . . . .1-96
Volume migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-98
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-98
Specifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-98
Commands to control the Volume Migration . . . . . . . . . . . . . . . . . . . . . .1-99
Relations between “cc” command issues and status. . . . . . . . . . . . . . . . 1-100
Synchronous waiting command (pairsyncwait) . . . . . . . . . . . . . . . . . . . . . 1-101
2 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1
ShadowImage troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2
SnapShot troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-4
TrueCopy troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-6
TCE troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-11
General troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-16
Error reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-19
Data recovery for PSUE using ShadowImage . . . . . . . . . . . . . . . . . . . . . . .2-31

Table of Contents v
Hitachi AMS 2000 Family Command Control Interface (CCI) Reference Guide
Recovering the pair. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-31
Internal LUN, device recognized by the host . . . . . . . . . . . . . . . . . . . . . .2-32
Pair-splitting guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-32
Data recovery for PSUE using SnapShot . . . . . . . . . . . . . . . . . . . . . . . . . . .2-33
Recovering the pair. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-33
Data recovery for PSUE using TrueCopy and TCE . . . . . . . . . . . . . . . . . . . .2-34
Recovering the pair. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-34
3 Maintenance log and tracing functions . . . . . . . . . . . . . . . . . . . . .3-1
Log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Trace files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Trace control command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
How to read detailed error log codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8
Sense code and detail code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
Logging of a command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-66
4 Command options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-1
Command options for copy types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Glossary
Index

vi Table of Contents
Hitachi AMS 2000 Family Command Control Interface (CCI) Reference Guide

Preface vii
Hitachi AMS 2000 Family Command Control Interface (CCI) Reference Guide
Preface
The Command Control Interface (CCI) Reference Guide describes
and provides instructions for performing Command Control
Interface (CCI) software operations on the Adaptable Modular
Storage (AMS) array. The CCI software enables you to issue
Copy-on-write SnapShot (hereafter called SnapShot),
ShadowImage in-system replication (hereafter called
ShadowImage), Synchronous Remote Copy (hereinafter called
TrueCopy), and Asynchronous Remote Copy (hereinafter called
TCE) commands to the AMS array from the open-systems host
(UNIX-based or PC server host).
This preface includes the following information:
Product version
Release notes and readme
Changes in this revision
Changes in this revision
Intended audience
Document organization
Applicable platforms
Document conventions
Convention for storage capacity values
Related documents
Getting help
Comments

viii Preface
Hitachi AMS 2000 Family Command Control Interface (CCI) Reference Guide
Intended audience
This document is intended for system administrators, Hitachi Data Systems
representatives, and Authorized Service Providers who are involved in
installing, configuring, or operating the AMS.
This document assumes that you, as the user:
• Have a background in data processing and understand RAID storage
arrays and their basic functions.
• Are familiar with the AMS array.
• Are familiar with the functionality of the ShadowImage and SnapShot
features.
• Are familiar with the functionality of the TrueCopy and TCE features.
• Have read and understand the ShadowImage in-system Replication
User’s Guide.
• Have read and understand the Copy-on-write SnapShot User’s Guide.
• Have read and understand the Modular Volume Migration User’s Guide.
• Have read and understand the TrueCopy Remote Replication User’s
Guide.
• Have read and understand the TrueCopy Extended Distance User’s
Guide.
Product version
This document revision applies to CCI software version 01-32-03/01 or
later, and AMS 2000 Family firmware version 08C5/K or later.
Release notes and readme
Read the release notes and readme file before installing and using this
product. They may contain requirements or restrictions that are not fully
described in this document and updates or corrections to this document.
Changes in this revision
• Revised the first note on page 1-81.
Document organization
The following table provides an overview of the contents and organization
of this document. Click the chapter title in the left column to go to that
chapter. The first page of each chapter provides links to the sections in that
chapter.
Chapter Description
Chapter 1, Performing CCI
Operations Provides details of CCI functionality.

Preface ix
Hitachi AMS 2000 Family Command Control Interface (CCI) Reference Guide
Applicable platforms
This document applies to the following platforms:
Chapter 2, Troubleshooting Provides troubleshooting guidelines and customer support
contact information.
Chapter 3, Maintenance log
and tracing functions Discusses logs and tracing functions.
Chapter 4, Command
options Describes command options execution.
Vendor Operating System
Oracle Solaris 8 (SPARC)
Solaris 9 (SPARC)
Solaris 10 (SPARC)
Solaris 10 (x86)
Solaris 10 (x64)
Microsoft Windows 2000
Windows Server 2003 (IA32)
Windows Server 2008 (IA32)
Windows Server 2003 (x64)
Windows Server 2008 (x64)
Windows Server 2003 (IA64)
Windows Server 2008 (IA64)
Windows Server 2012 (x64)
Red Hat Red Hat Linux AS 2.1 (IA32)
Red Hat Linux AS/ES 3.0 (IA32)
Red Hat Linux AS/ES 4.0 (IA32)
Red Hat Linux AS/ES 5.0 (IA32)
Red Hat Linux AS/ES 3.0 (AMD64/EM64T)
Red Hat Linux AS/ES 4.0 (AMD64/EM64T)
Red Hat Linux AS/ES 5.0 (AMD64/EM64T) Note 2
Red Hat Linux AS/ES 6.0 (AMD64/EM64T) Note 2
Red Hat Linux AS/ES 3.0 (IA64)
Red Hat Linux AS/ES 4.0 (IA64) Note 1
HP HP-UX 11i V1.0 (PA-RISC)
HP-UX 11i V2.0 (PA-RISC)
HP-UX 11i V3.0 (PA-RISC)
HP-UX 11i V2.0 (IPF)
HP-UX 11i V3.0 (IPF)
Tru64 UNIX 5.1

xPreface
Hitachi AMS 2000 Family Command Control Interface (CCI) Reference Guide
Virtual OS applies to the following platforms:
The following table shows the IPv6-supported platforms.
IBM AIX 5.1
AIX 5.2
AIX 5.3
AIX 6.1
SGI IRIX 6.5.x
Vendor Operating System
NOTE 1: The 32-bit library is required to execute the CCI command in the
AMD64/EM64T environment. The 32-bit library is not installed in the
AMD64/EM64T by default and must be installed.
NOTE 2: To execute the CCI command when Red Hat Linux AS4.0 is used
in the IPF environment (IA64), it is required to install all the 32-bit
compatible packages for IA-32EL (Execution Layer). When you install the
IA-32EL, install all the 32-bit compatible packages (except CCI for Linux/
IA64).
Vendor Host Operating System Guest Operating System
VMware VMware ESX Server 3.0 Windows 2000
Windows Server 2003
Red Hat Linux AS3.0
Red Hat Linux AS4.0
VMware ESX Server 4.0 Windows Server 2003
Windows Server 2008
VMware ESXi Server 5.0 Windows Server 2003
Windows Server 2008
Red Hat Linux AS5.0
Microsoft Windows Server 2008 Hyper-V Windows Server 2003 SP2
Windows Server 2008
Windows Server 2008 R2 Hyper-
V2.0 Windows Server 2003 SP2
Windows Server 2008 R2
Hitachi Virtage (58-12) Windows Server 2008 R2
Red Hat Enterprise Linux 5.4