IBM XCLI Utility User Manual
IBM XIV Storage System
XCLI Utility User Manual
Ve r s i o n 1 0 . 2 .1
GA32-0638-03
IBM XIV Storage System
XCLI Utility User Manual
Ve r s i o n 1 0 . 2 .1
GA32-0638-03
Note
Before using this information and the product it supports, read the information in “Notices” on page 15.
This edition applies to version 10, release 2 modification 1, of IBM XIV Storage System, and to all subsequent
releases and modifications until otherwise indicated in new editions.
This edition replaces GA32-0638-02.
© Copyright IBM Corporation 2009, 2010.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Figures ...............v
About this guide ..........vii
Who should use this guide .........vii
Conventions used in this guide .......vii
Publications and related information ......vii
Getting information, help, and service .....xi
Ordering publications ...........xi
Sending your comments ..........xi
Chapter 1. Overview of the IBM XIV
Storage System command-line interface. 1
Interactive and basic modes .........2
Chapter 2. Getting started with XCLI . . 3
Installing the XCLI ............3
Starting the XCLI .............4
Starting the XCLI on a Windows system ....4
Starting the XCLI on a Linux system .....5
Exiting an interactive XCLI session .......5
Interactive mode features ..........5
Understanding the command syntax ......6
Command syntax quick reference ......6
Syntax example ............7
Chapter 3. Using the XCLI .......9
Using identification parameters ........9
User and password parameters .......9
Defining XCLI configurations........9
Display options .............11
Using display options ..........11
Table display options ..........12
Running commands in batch mode ......13
Displaying XCLI help and version.......14
Notices ..............15
Trademarks ..............17
Glossary ..............19
Index ...............21
© Copyright IBM Corp. 2009, 2010 iii
iv IBM XCLI User Manual
Figures
1. XCLI commands running on the IBM XIV
Storage System ............1
2. XCLI prompt on Windows ........4
© Copyright IBM Corp. 2009, 2010 v
vi IBM XCLI User Manual
About this guide
This document describes how to use the IBM®XIV®Storage System command-line
interface (XCLI) to invoke XCLI utility and system commands.
Who should use this guide
This publication is for personnel that are responsible for administering IBM XIV
Storage Systems.
Conventions used in this guide
These notices are used to highlight key information.
Note: These notices provide important tips, guidance, or advice.
Important: These notices provide information or advice that might help you avoid
inconvenient or difficult situations.
Attention: These notices indicate possible damage to programs, devices, or data.
An attention notice appears before the instruction or situation in which damage
can occur.
CAUTION:
These notices indicate a situation that is potentially hazardous to people because
of some existing condition or where a potentially dangerous situation might
develop because of some unsafe practice.
DANGER
These notices indicate a situation that is potentially lethal or extremely
hazardous to people. For example, after a computer side panel is removed,
exposed high-voltage wires might be lethal.
Publications and related information
Product manuals, other IBM publications, and websites contain information that
relates to the IBM XIV Storage System.
To view a PDF file, you need Adobe Acrobat Reader, which can be downloaded for
free from the Adobe website (www.adobe.com/products/acrobat/readstep.html)
website.
Information centers
From the IBM XIV Storage System Information Center website
(publib.boulder.ibm.com/infocenter/ibmxiv/r2/index.jsp), you can browse all
product documentation.
© Copyright IBM Corp. 2009, 2010 vii
Publications
Information that is available in the information center is also available in a set of
publications, in PDF format.
IBM XIV Storage System
v
v
v IBM XIV Storage System Host Attachment Guides
IBM XIV Storage System Product Overview (publib.boulder.ibm.com/
infocenter/ibmxiv/r2/topic/com.ibm.help.xiv.doc/docs/GA32-0791-
02.pdf)
This document contains an overview of the IBM XIV Storage System
hardware and software.
IBM XIV Storage System Planning Guide (publib.boulder.ibm.com/
infocenter/ibmxiv/r2/topic/com.ibm.help.xiv.doc/docs/GA32-0770-
05.pdf)
This document defines installation requirements for IBM XIV Storage
System. It is important to ensure that you meet all requirements to
guarantee a fast and reliable installation.
These documents provide information about attaching host systems to
the IBM XIV Storage System:
–
–
Host System Attachment Guide for AIX (publib.boulder.ibm.com/
infocenter/ibmxiv/r2/topic/com.ibm.help.xiv.doc/docs/hag_1_5_x/
GA32-0643-06.pdf)
Host System Attachment Guide for HP-UX
(publib.boulder.ibm.com/infocenter/ibmxiv/r2/topic/
com.ibm.help.xiv.doc/docs/hag_1_5_x/GA32-0645-02.pdf)
–
–
–
–
v
(publib.boulder.ibm.com/infocenter/ibmxiv/r2/topic/
com.ibm.help.xiv.doc/docs/GC27-2213-10.pdf), GC27-2213
This document describes the IBM XIV command-line interface (XCLI)
system and utility commands used to manage and maintain the XIV
system, including the command syntax, parameter descriptions, output
descriptions, and examples.
Host System Attachment Guide for Linux (publib.boulder.ibm.com/
infocenter/ibmxiv/r2/topic/com.ibm.help.xiv.doc/docs/hag_1_5_x/
GA32-0647-02.pdf)
Host System Attachment Guide for Solaris
(publib.boulder.ibm.com/infocenter/ibmxiv/r2/topic/
com.ibm.help.xiv.doc/docs/hag_1_5_x/GA32-0649-02.pdf)
Host System Attachment Guide for Windows
(publib.boulder.ibm.com/infocenter/ibmxiv/r2/topic/
com.ibm.help.xiv.doc/docs/hag_1_5_x/GA32-0652-03.pdf)
Host System Attachment Guide for VMware
(publib.boulder.ibm.com/infocenter/ibmxiv/r2/topic/
com.ibm.help.xiv.doc/docs/
Host_System_Attachment_Guide_for_VMWare2.pdf)
IBM XIV Storage System XCLI Reference Guide
viii IBM XCLI User Manual
v IBM XIV Storage System XCLI User Manual
(publib.boulder.ibm.com/infocenter/ibmxiv/r2/topic/
com.ibm.help.xiv.doc/docs/GA32-0638-03.pdf), GA32-0638
This document describes how to use the IBM XIV command-line
interface (XCLI) to run XIV system and utility commands.
VSS Provider - Xprov
v
IBM XIV Storage System VSS Provider - Xprov Release Notes
(publib.boulder.ibm.com/infocenter/ibmxiv/r2/topic/
com.ibm.help.xiv.doc/docs/xProv_2_2_4.pdf)
This document describes the supported environment, new features,
known issues, and installation information.
Remote Mirroring for VCS Cluster
v
IBM XIV Storage System Remote Mirroring for VCS Installation Guide
(publib.boulder.ibm.com/infocenter/ibmxiv/r2/topic/
com.ibm.help.xiv.doc/docs/
IBM_XIV_Remote_Mirroring_Agent_for_VCS_2.1.0_Installation_Guide.pdf)
This guide describes how to install and configure the VERITAS Cluster
Server (VCS) enterprise agent for IBM XIV Remote Mirroring.
v
IBM XIV Storage System Remote Mirroring for VCS Release Notes for
Windows (publib.boulder.ibm.com/infocenter/ibmxiv/r2/topic/
com.ibm.help.xiv.doc/docs/
IBM_XIV_Remote_Mirroring_Agent_for_VCS_2.1.0_Release_Notes_for_Windows.pdf)
This document describes the supported environment, new features, fixes,
and known issues.
v
IBM XIV Storage System Remote Mirroring for VCS Release Notes for
Solaris (publib.boulder.ibm.com/infocenter/ibmxiv/r2/topic/
com.ibm.help.xiv.doc/docs/
IBM_XIV_Remote_Mirroring_Agent_for_VCS_2.1.0_Release_Notes_for_Solaris.pdf)
This document describes the supported environment, new features, fixes,
and known issues.
MPIO Management Console
v
IBM XIV Storage System MPIO Management Console User's Guide
(publib.boulder.ibm.com/infocenter/ibmxiv/r2/topic/
com.ibm.help.xiv.doc/docs/GA32-0795.pdf), GA32-0746
This guide discusses the IBM XIV MPIO Management Console
application, which provides monitoring and management capabilities to
the multipath subsystems of the IBM XIV Storage System.
Remote Support Proxy
v
IBM XIV Storage System Remote Support Proxy Installation and User's
Guide (publib.boulder.ibm.com/infocenter/ibmxiv/r2/topic/
com.ibm.help.xiv.doc/docs/GA32-0795.pdf), GA32-0795
This guide describes how to install, configure, and use the IBM XIV
Storage System Remote Support Proxy to connect an XIV system to the
XIV Remote Support Center.
Management Console for VMware vCenter
About this guide ix
v IBM XIV Storage System Management Console for VMware vCenter
User's Guide (publib.boulder.ibm.com/infocenter/ibmxiv/r2/topic/
com.ibm.help.xiv.doc/docs/
IBM_XIV_MNG_Console_2.0.0_for_VMware_vCenter_User_Guide.pdf),
GA32-0820
This guide provides installation, configuration, and usage instructions
for the IBM XIV Management Console for VMware vCenter.
IBM Redbooks publications and technical papers
Various IBM Redbooks®publications, Redpapers, and white papers are available
for the IBM XIV Storage System. For additional papers, see the IBM XIV Storage
System (www.ibm.com/systems/storage/disk/xiv/) website.
v
v
v
v
IBM XIV Storage System: Architecture, Implementation, and Usage
(www.redbooks.ibm.com/abstracts/sg247659.html?Open&cm_sp=MTE10970)
This Redbooks publication describes the concepts, architecture, and
implementation of the XIV system, which is designed to be a scalable enterprise
storage system based upon a grid array of hardware components.
IBM XIV Storage System with the Virtual I/O Server and IBM i
(www.redbooks.ibm.com/abstracts/redp4598.html?Open&cm_sp=MTE11087)
This Redbooks publication discusses and explains how you can connect the XIV
system to the IBM i operating system through the Virtual I/O Server (VIOS). A
connection through the VIOS is especially useful for IT centers that have many
small IBM i partitions. When using the VIOS, the fibre-channel host adapters can
be installed in the VIOS and shared by many IBM i clients using virtual
connectivity to the VIOS.
XIV Storage System: Host Attachment and Interoperability
(www.redbooks.ibm.com/redpieces/abstracts/sg247904.html?Open)
This Redbooks publication describes how to attach an XIV system to various
hosting operating system platforms in combination with databases and other
storage-oriented application software. It also provides solutions for combining
the IBM XIV Storage System with other storage platforms, host servers, or
gateways.
IBM XIV Storage System: Copy Services and Migration
(www.redbooks.ibm.com/abstracts/sg247759.html?Open)
This Redbooks publication describes IBM XIV Storage System copy and
migration functions for various data protection scenarios, to enhance your
business continuance, data migration, and online-backup solutions. These
include point-in-time copies (also known as snapshots and full volume copies)
and remote-copy capabilities in synchronous or asynchronous mode. This book
also discusses how to integrate the snapshot function with the IBM Tivoli
FlashCopy Manager, built-in migration capability, and migration alternatives
based on the IBM SAN Volume Controller (SVC).
x IBM XCLI User Manual
Related websites
View these websites to get more information about the XIV system.
v
IBM XIV Storage System website (www.ibm.com/systems/storage/disk/
xiv/)
Loading...