1. Manuals
  2. Brands
  3. Phoenix Manuals
  4. Storage
  5. RPC12 Series
  6. Cli reference manual

Phoenix RPC12 Series Cli Reference Manual

Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the RPC12 Series and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Phoenix RPC12 Series

Summary of Contents for Phoenix RPC12 Series

  • Page 2: Table Of Contents

    Contents Preface ............9 Before You Read This Book .
  • Page 3 ............61 Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 4 create volume ........... . . 64 delete all-master-volumes .
  • Page 5 ........140 Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 6 show cache-parameters ..........141 show channels .
  • Page 7 ............16 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 8: Preface

    Preface This manual describes how to use the command-line interface (CLI) to configure and manage Phoenix™ storage systems, and applies to the following enclosures: 69501 FC Controller Enclosure 69503 iSCSI Controller Enclosure SAS Expansion Enclosure This book is written for system administrators who are familiar with Fibre Channel (FC), Internet SCSI (iSCSI), and Serial Attached SCSI (SAS) configurations, network administration, and RAID technology.

  • Page 9: Typographic Conventions

    A separator indicates that base 2|10 only one of the parameters or values separated by this character can be specified. 1 The fonts used in your viewer might differ. 10 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 10: Related Documentation

    Related Documentation Application Title Part Number Site planning information Phoenix Storage System Site Planning Guide 83-00004283 Late-breaking information not Phoenix 69501 Release Notes 83-00004282 included in the documentation set Phoenix 69503 Release Notes 83-00005032 Installing and configuring hardware Phoenix 69501 Getting Started Guide...
  • Page 11 12 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 12: Using The Cli

    CHAPTER Using the CLI This chapter introduces the Phoenix storage system command-line interface (CLI) and includes the following topics: “Accessing the CLI” on page 13 “Operation Modes” on page 13 “Command Syntax” on page 24 “Command Completion, Editing, and History” on page 27 “Viewing Command Help”...
  • Page 13 ID Serial# Vendor Rev. State Type Size(GB) Rate(Gb/s) SP ------------------------------------------------------------------------------ 3KN0Z0BZ00007626NM4F SEAGATE 0003 AVAIL VDK41BT4CVLPNE A9BA AVAIL SATA 250 3KN0Z6PD00007626NLV5 SEAGATE 0003 AVAIL 10 3KN0Z09500007626NM28 SEAGATE 0003 AVAIL ------------------------------------------------------------------------------ # exit Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 14 CLI commands can also be scripted using a client like Expect or a Perl telnet library. Scripts can use interactive mode to execute single commands to emulate a single-command mode. The following example shows the Perl Expect script that starts a showfree.exp session, logs into the CLI, executes a command to show free disks, and telnet...
  • Page 15 ($debug_comamnds == 1) { print "-"; print @ok; print "-\n"; if ($ok[1] =~ m/login/gi) return 0; else return 1; $ipAddr = $ARGV[0]; $username = $ARGV[1]; $password = $ARGV[2]; $telnet = new Net::Telnet ( Timeout=>10, Errmode=>'die', Prompt => '/\# $/i'); Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 16: Using The Xml Api

    if ( !cLogin($ipAddr, $username, $password) == 1 ) print("Error: $username user failed to log in. Exiting.\n"); $telnet->close; exit(0); The example shows a Perl script for logging in. is called at the start of the cLogin script to log a user into the CLI. The script uses the command-line parameters specified as the IP address, username, and password.

  • Page 17: Dtd

    P IDREF #REQUIRED G IDREF #REQUIRED > <!--- Simple Association, A and B are the oids of the Objects --> <!ELEMENT ASC EMPTY> <!ATTLIST ASC A IDREF #REQUIRED B IDREF #REQUIRED > Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 18 Elements and attributes of the DTD are described in the following table. Element Description and Attributes The RESPONSE is the top level XML object. The request attributes RESPONSE contain the details of the request that was sent. The RESPONSE is a container for objects that are returned as part of the request.
  • Page 19 • P - The part component oid. • G - The grouping component oid. The association element provides a simple association description between two objects in the response. • A • B Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 20: Example

    Example The following example shows the output of the show schedule-details command with the output first set to and second set to console set cli-parameters console Success: CLI parameter changed successfully show schedule-details Sched1 Schedule Details ---------------- Schedule Name: Sched1 Schedule Specification: Start 5/01/2007 00:01:00, Only 1st Weekday Of Month Schedule Status: Ready Next Time: 5/01/2007 00:01:00...
  • Page 21 <PROPERTY name="type" type="string" size="32" draw="true" display-name= "Task Type">TakeSnapshot</PROPERTY> <PROPERTY name="status" type="string" size="10" draw="true" display- name="Task Status">Ready</PROPERTY> <PROPERTY name="state" type="string" size="15" draw="true" display-name= "Task State">Init</PROPERTY> <PROPERTY name="master-volume-name" type="string" size="32" draw="true" display-name="Master Volume Name">mv1</PROPERTY> Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 22 <PROPERTY name="master-volume-serial" type="string" size="32" draw="true" display-name="Master Volume Serial">00c0ff0a43010048f9ca2d4601000000</PROPERTY> <PROPERTY name="snapshot-prefix" type="string" size="14" draw="true" display-name="Snapshot Prefix">ss</PROPERTY> <PROPERTY name="retention-count" type="string" size="5" draw="true" display-name="Retention Count">3</PROPERTY> <PROPERTY name="last-created" type="string" size="32" draw="true" display- name="Last Snapshot Created">none</PROPERTY> <PROPERTY name="error-message" type="string" size="100" draw="true" display-name="Error Message">none</PROPERTY> </OBJECT> </RESPONSE> Chapter 1 Using the CLI...

  • Page 23: Command Syntax

    A hyphenated range of disk drive IDs from . For example, A list of disk drive IDs, ranges, or both, separated by commas; do not include spaces before or after commas. For example, 4,6-9 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 24: Virtual Disk Syntax

    Virtual Disk Syntax You can specify virtual disks by using either: Virtual disk serial number. A unique 32-digit number that is automatically assigned when a virtual disk is created, and does not change for the life of the virtual disk. Virtual disk name.

  • Page 25: Host Nickname Syntax

    For example, 0,1,3-5 is a logical unit number (LUN) from 0–127 to assign to the mapping. For example, The following example maps channels 0 and 1 using LUN 8: 0-1.8 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 26: Command Completion, Editing, And History

    Command Completion, Editing, and History The CLI supports command completion, command editing, and command history. When using command completion, if you enter too few letters to uniquely identify a keyword, the CLI lists keywords that match the entered string and redisplays the string so you can complete it.

  • Page 27: Viewing Command Help

    1000 Gbyte 1,099,511,627,776 bytes 1 trillion bytes To check which format is being used, use “show cli-parameters” on page 146. To change the output format, use “set cli-parameters” on page 106. Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 28: Event Log

    Event Log A controller enclosure’s event log records all events that have occurred in or been detected by the controller modules and encompasses all field-replaceable units (FRUs) in the enclosure. Each event has one of the following levels, in decreasing severity: Critical.
  • Page 29 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 30: Command Categories

    CHAPTER Command Categories Commands in this manual are organized alphabetically to make it easy to find a command by name. This chapter helps you find a command within a logical grouping, based on the command’s function. A command might be listed in more than one category.

  • Page 31: Cli And Users

    Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 32: Volumes And Mapping

    Volumes and Mapping abort volumecopy create host-wwn-name create iscsi-host create volume delete host-wwn-name delete iscsi-host delete volume expand volume map volume set cache-parameters set host-wwn-name set iscsi-host set volume show cache-parameters show host-maps show host-wwn-names show iscsi-hosts show port-wwn show volumes show volumecopy-status show volume-maps unmap volume...

  • Page 33: Task Scheduling

    Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 34: Service Utilities

    set system show auto-write-through-trigger show channels show configuration show controller-date show drive-parameters show enclosure-status show expander-status show frus show host-parameters show host-port-interconnects show job-parameters show license show network-parameters show protocols show redundancy-mode show shutdown-status show sensor-status show system shutdown stty versions Service Utilities clear expander-status...
  • Page 35 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 36: Command Descriptions

    CHAPTER Command Descriptions This chapter describes the commands in alphabetical order. Each command topic includes one or more of the following sections: Description. The command’s purpose and notes about its usage. Input. The command’s syntax and descriptions of its parameters. Output.

  • Page 37: Abort Create

    “Virtual Disk Syntax” on page 25. Example Abort creating virtual disk VD1. # abort create vdisk VD1 Related Commands “create vdisk” on page 61 “set vdisk” on page 137 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 38: Abort Scrub

    abort scrub Description Aborts the operation for specified virtual disks. scrub vdisk Input vdisks abort scrub vdisk Parameter Description Specifies the virtual disks by name or serial number. For the vdisks vdisk syntax to use, see “Virtual Disk Syntax” on page 25. Example Abort scrubbing virtual disk VD1.

  • Page 39: Abort Verify

    Specifies the virtual disks by name or serial number. For the vdisks vdisk syntax to use, see “Virtual Disk Syntax” on page 25. Example Abort verifying virtual disk VD1. # abort verify vdisk VD1 Related Commands “verify vdisk” on page 224 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 40: Abort Volumecopy

    abort volumecopy Description Aborts copying a volume. When the abort is complete, the destination volume is deleted Input volume abort volumecopy Parameter Description Specifies the name or serial number of either the source or the volume destination volume. For the syntax to use, see “Virtual Disk Syntax”...

  • Page 41: Alias

    Example Create alias for a command that shows the last five events. # alias se5 "show events last 5" Show existing aliases. # alias show events last 5 show disks Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 42: Clear Cache

    clear cache Description Clears any unwritable cache in the RAID controllers for a specified volume, or any orphaned data for volumes that no longer online or no longer exist. Orphaned data can occur if there is a power loss during I/O, a drive is removed from a vdisk while the power is off, or two or more drives in the same vdisk go down causing the vdisk to go down.

  • Page 43: Clear Disk-Metadata

    Specifies the disk drives by a range or list of IDs. For the syntax to use, disks see “Disk Drive Syntax” on page 24. Example Clear metadata for disk drives having ID 0 and 4. # clear disk-metadata 0,4 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 44: Clear Expander-Status

    clear expander-status Description Note – This command should only be used by service technicians, or with the advice of a service technician. Clears the counters and status for SAS expander controller lanes. Counters and status can be reset to a good state for all enclosures, or for a specific enclosure whose status is ERROR as shown by the command.

  • Page 45: Convert Master-To-Std

    “Volume Syntax” on page 25. Example Convert master volume to a standard volume. # convert master-to-std MV1 Related Commands “delete all-snapshots” on page 67 “show master-volumes” on page 180 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 46: Convert Std-To-Master

    convert std-to-master Description Converts a standard volume to a master volume; that is, it enables the volume for snapshots and associates it with an existing snap pool. The standard volume and the snap pool must be owned by the same controller, though they can be on different virtual disks.

  • Page 47: Create Host-Wwn-Name

    Create the nickname HBA1 for the HBA having WWPN 210000e08b095562. # create host-wwn-name wwn 210000e08b095562 HBA1 Related Commands “delete host-wwn-name” on page 69 “set host-wwn-name” on page 120 “show host-wwn-names” on page 175 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 48: Create Iscsi-Host

    create iscsi-host Description Associates a nickname with an iSCSI host initiator's IP address. You can then use the nickname when mapping volumes to hosts. Input IP nickname create iscsi-host ip Parameter Description Specifies an iSCSI host initiator’s IP address in IPv4 format. Specifies a nickname for the iSCSI host initiator.

  • Page 49: Create Master-Volume

    If this parameter is omitted, no LUN is assigned. Example Create the 1-Gbyte master volume MV1 on virtual disk VD1, and associates it with snap pool SP1. # create master-volume vdisk VD1 size 1GB snap-pool SP1 MV1 Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 50 Related Commands “delete master-volume” on page 71 “show master-volumes” on page 180 “show snap-pools” on page 194 “show vdisks” on page 208 Chapter 3 Command Descriptions...

  • Page 51: Create Schedule

    |Sunday|Monday|Tuesday| Wednesday|Thursday|Friday|Saturday of year|month|January|February|March|April| May|June|July|August|September|October| November|December • count • expires [AM|PM] yyyy hh Specifies the name of the task to run. The name is case task-name tname sensitive. Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 52 Example Create schedule Sched1 that runs Task1 for the first time on March 1, 2007, runs daily between midnight and 1 AM, and runs for the last time in the morning of January 1, 2008. # create schedule Sched1 schedule-specification "start 03/01/2007 00:01 AM, every 1 days, between 12:00 AM and 1:00 AM, expires 1/1/2008 1:00 AM"...

  • Page 53: Create Snap-Pool

    Create the 10-Gbyte snap pool SP1 on virtual disk VD1. # create snap-pool vdisk VD1 size 10GB SP1 Related Commands “delete snap-pool” on page 73 “show snap-pools” on page 194 “show vdisks” on page 208 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 54: Create Snapshots

    create snapshots Description Creates a named snapshot of each specified master volume. Input volumes snap-names create snapshots master-volumes Parameter Description Specifies a comma-separated list of volumes by volumes master-volumes their names or serial numbers. For the syntax to use, see “Volume Syntax” on page 25. Specifies a comma-separated list of names for the snap-names resulting snapshots.

  • Page 55: Create Task

    Parameter Description Specifies a name for the new task, using a name maximum of 32 characters and no apostrophe ('), quotation mark ("), or backslash (\) characters. Names are case sensitive. Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 56 Parameter Description Specifies the task. type TakeSnapshot| • TakeSnapshot: Takes a snapshot of a specified ResetSnapshot| master volume. Up to 16 snapshots per controller VolumeCopy pair can exist, or more if your license permits it. • ResetSnapshot: Deletes the data in the snapshot and resets it to the current data in the associated master volume.
  • Page 57 VD2 dest-prefix C modified-snapshot yes Success: Task created Related Commands “create schedule” on page 52 “delete task” on page 76 “show schedule-details” on page 188 “show task-details” on page 201 “show tasks” on page 205 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 58: Create User

    create user Description Creates a new user profile. When you enter the command, the system prompts you to enter a case-sensitive password, which can include a maximum of 19 printable ASCII characters except backslash (\), quotation mark ( ), apostrophe ( ), or spaces.
  • Page 59 Re-enter Password:***** Info: User Type not specified, defaulting to Advanced. Success: New user created Related Commands “delete user” on page 77 “set user” on page 135 “show users” on page 206 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 60: Create Vdisk

    create vdisk Description Creates a virtual disk using the specified RAID level, disk drives, and optional vdisk spares. All disks used in a virtual disk and its spares must be either SAS or SATA; mixing disk types is not supported. Table 3-1 specifies the number of disks supported for each virtual disk type, as determined by its RAID level.

  • Page 61: Phoenix Rpc12 Series Cli Reference Manual • September

    # create vdisk level raid1 disks 1,3 VD1 Create the RAID-50 virtual disk VD2 having three RAID-5 subvirtual disks, each having three disk drives. # create vdisk level r50 disks 1-3:4-6:7-9 VD2 Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 62 Related Commands “abort create” on page 38 “delete vdisk” on page 78 “set vdisk” on page 137 “show disks” on page 154 “show vdisks” on page 208 Chapter 3 Command Descriptions...

  • Page 63: Create Volume

    “Volume Syntax” on page 25. Example Create the 10-Gbyte volume V1 on virtual disk VD1, and map it to LUN 12 on channel 1. # create volume vdisk VD1 size 10GB mapping 1.12 V1 Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 64 Related Commands “delete volume” on page 81 “map volume” on page 89 “set volume” on page 139 “show vdisks” on page 208 “show volumes” on page 215 “unmap volume” on page 222 Chapter 3 Command Descriptions...

  • Page 65: Delete All-Master-Volumes

    For the syntax to use, see “Volume Syntax” on page 25. Example Delete all master volumes associated with snap pool SP1. # delete all-master-volumes snap-pool SP1 Related Commands “show master-volumes” on page 180 “show snap-pools” on page 194 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 66: Delete All-Snapshots

    delete all-snapshots Description Deletes all snapshots associated with a specified volume, which can be a snap pool or master volume. All data associated with the snapshots is deleted and associated space in the snap pool is freed for use. Input volume delete all-snapshots volume Parameter...

  • Page 67: Delete Global-Spare

    Specifies the disk drives to remove. For the syntax to use, see “Disk disks disks Drive Syntax” on page 24. Example Remove the global spare having ID 5. # delete global-spare disks 5 Related Commands “show disks” on page 154 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 68: Delete Host-Wwn-Name

    delete host-wwn-name Description Deletes the nickname associated with a host world wide port name (WWPN). Input host delete host-wwn-name Parameter Description Specifies the HBA's nickname or 16-hex-digit WWPN. For the host nickname syntax to use, see “Host Nickname Syntax” on page 26. Example Delete the nickname HBA1.

  • Page 69: Delete Iscsi-Host

    26. Example Delete the iSCSI host initiator nickname iSCSI-1. # delete iscsi-host iSCSI-1 Related Commands “create iscsi-host” on page 49 “set host-wwn-name” on page 120 “show iscsi-hosts” on page 176 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 70: Delete Master-Volume

    delete master-volume Description Deletes a master volume. Alias of delete volume Note – You must delete all snapshots that exist for the master volume before you can delete it. Input volume delete master-volume Parameter Description Specifies the volume by its name or serial number. For the syntax to use, volume see “Volume Syntax”...

  • Page 71: Delete Schedule

    # delete schedule Sched1 Success: Schedule Deleted Related Commands “create schedule” on page 52 “show schedule-details” on page 188 “show schedules” on page 190 “show task-details” on page 201 “show tasks” on page 205 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 72: Delete Snap-Pool

    delete snap-pool Description Deletes a snap pool. Note – You must disassociate all master volumes from the snap pool before you can delete it. Input volume delete snap-pool Parameter Description Specifies the snap pool volume by its name or serial number. For the volume syntax to use, see “Volume Syntax”...

  • Page 73: Delete Snapshot

    Specifies the volume by its name or serial number. For the syntax to use, volume “Volume Syntax” on page 25. Example Delete snapshot SS1. # delete snapshot SS1 Related Commands “delete snapshot-write-data” on page 75 “show snapshots” on page 196 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 74: Delete Snapshot-Write-Data

    delete snapshot-write-data Description Deletes the modified portion of a snapshot volume. This reverts the snapshot to the state when it was first taken. Input volume delete snapshot-write-data Parameter Description Specifies the volume by its name or serial number. For the syntax to use, volume “Volume Syntax”...

  • Page 75: Delete Task

    Delete task Task1. # delete task Task1 Success: Task Deleted Related Commands “create task” on page 56 “delete schedule” on page 72 “show task-details” on page 201 “show tasks” on page 205 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 76: Delete User

    delete user Description Deletes a user profile. By default a confirmation prompt appears, which requires a response. You can delete any user including the default users. Input name delete user [noprompt] Parameter Description Specifies the user profile to delete. Names are case sensitive. name noprompt Optional.

  • Page 77: Delete Vdisk

    • yes: Stops the utility and enables the deletion to proceed • no: Prevents the deletion from proceeding If this parameter is omitted, you must manually reply to the prompt. Example Delete two virtual disks. # delete vdisk VD1,VD2 Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 78 Related Commands “show master-volumes” on page 180 “show vdisks” on page 208 Chapter 3 Command Descriptions...

  • Page 79: Delete Vdisk-Spare

    “Virtual Disk Syntax” on page 25. Example Remove the vdisk spare having ID 5 from virtual disk VD1. # delete vdisk-spare disks 5 VD1 Related Commands “show disks” on page 154 “show vdisks” on page 208 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 80: Delete Volume

    delete volume Description Deletes a volume. Input volume delete volume Parameter Description Specifies the volume to delete. For the syntax to use, see “Volume volume Syntax” on page 25. Example Delete volume V1. # delete volume V1 Related Commands “show volumes” on page 215 Chapter 3 Command Descriptions...

  • Page 81: Exit

    Description Exits the CLI session. Syntax exit Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 82: Expand Snap-Pool

    expand snap-pool Description Alias of . See “expand volume” on page 87. Expands a standard expand volume volume or snap-pool volume—but not a master volume—by a specified size. Expansion is restricted to the available space on the virtual disk that hosts the volume.
  • Page 83 Example Expand V1 by 100 Gbyte. # expand volume V1 size 100GB Related Commands “expand vdisk” on page 85 “show snap-pools” on page 194 “show volumes” on page 215 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 84: Expand Vdisk

    expand vdisk Description Adds disk drives to a virtual disk. Table 3-2 summarizes the expansion capability for each supported RAID level. Table 3-2 Virtual Disk Expansion by RAID Level Maximum RAID Level Expansion Capability Drives NRAID (non-RAID) Cannot expand. 0, 3, 5, 6 You can add 1–4 drives at a time.
  • Page 85 Expand virtual disk VD1 to include the disk drives having ID 1, 2, and 3. # expand vdisk VD1 disks 1-3 Related Commands “show disks” on page 154 “show vdisks” on page 208 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 86: Expand Volume

    expand volume Description Expands a standard volume or snap-pool volume—but not a master volume—by a specified size. Expansion is restricted to the available space on the virtual disk that hosts the volume. If insufficient space is available for expansion on the virtual disk, first expand the virtual disk by using expand vdisk Note –...
  • Page 87 Example Expand V1 by 100 Gbyte. # expand volume V1 size 100GB Related Commands “expand vdisk” on page 85 “show snap-pools” on page 194 “show volumes” on page 215 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 88: Map Volume

    map volume Description Maps a volume to host channels and assigns a specified LUN to the mapping. Input volume mapping host map volume mapping [host [access read-write|rw|read-only|ro] Parameter Description Specifies the volume to map. For the volume syntax to use, see “Volume Syntax” on page 25.
  • Page 89 # map volume V2 mapping 0-1.2 host HBA1 access ro Related Commands “show host-maps” on page 169 “show host-wwn-names” on page 175 “show volumes” on page 215 “show volume-maps” on page 213 “unmap volume” on page 222 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 90: Ping

    ping Description Tests communication with a remote host. The remote host is specified by IP address. Ping sends ICMP echo response packets and waits for replies. Input host-address count ping Parameter Description Specifies the remote host’s IP address in dotted decimal form. host-address Optional.

  • Page 91: Reset Host-Channel-Link

    Reset the link on host channel 0 from controller A. # reset host-channel-link channel 0 controller a Success: Reset Host Channel Link(s) on channel(s) 0 from controller(s) a. Related Commands “show channels” on page 143 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 92: Reset Snapshot

    reset snapshot Description Deletes the data in a snapshot and resets it to the current data in the associated master volume. The snapshot's volume characteristics are not changed. The command prompts you to unmount the snapshot from the host operating system before performing the reset;...
  • Page 93 Related Commands “show snapshots” on page 196 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 94: Restart

    restart Description Restarts the RAID controller or the management controller in either or both controller modules. If you restart a RAID controller, it attempts to shut down with a proper failover sequence, which includes stopping all I/O operations and flushing the write cache to disk, and then the controller restarts.
  • Page 95 # restart mc a During the restart process you will briefly lose communication with the specified management Controller(s). Continue? y Info: Restarting Local MC A... Related Commands “shutdown” on page 218 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 96: Restore Defaults

    restore defaults Description Note – This command should only be used by service technicians, or with the advice of a service technician. Restores the manufacturer's default configuration to the controllers. When the command informs you that the configuration has been restored, you must restart the RAID controllers and management controllers for the changes to take effect.

  • Page 97: Rollback Master-Volume

    • yes: Include modified snapshot data. • no: Exclude modified snapshot data. If this parameter is omitted, modified snapshot data is excluded. Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 98 Parameter Description Optional. Specifies an automatic response to the prompt yes|no unmount prompt that either enables the rollback to proceed or prevents the rollback from proceeding. • yes: Enable the rollback to proceed • no: Prevent the rollback from proceeding If this parameter is omitted, you must reply to the prompt.

  • Page 99: Scrub Vdisk

    “Virtual Disk Syntax” on page 25. Example Scrub the disk drives in virtual disk # scrub vdisk VD1 Related Commands “abort scrub” on page 39 “verify vdisk” on page 224 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 100: Set Auto-Write-Through-Trigger

    set auto-write-through-trigger Description Sets the trigger conditions that cause the controller to change the cache policy from write-back to write-through. By default, automatic write-back is enabled. Alias: When the cache mode is changed, an event is logged. Input set auto-write-through-trigger controller-failure |super-cap-failure|power-supply-failure |fan-failure|temperature-exceeded|partner-notify|auto-write-back enable|disable [...]...
  • Page 101 # set auto-write-through-trigger controller-failure enable partner-notify disable Success: Auto-Write-Through-Trigger parameters have been changed Related Commands “show auto-write-through-trigger” on page 140 “show events” on page 162 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 102: Set Cache-Parameters

    set cache-parameters Description Sets the RAID controller cache policy and cache optimization mode for a specified volume. Note – Only change the read-ahead cache settings if you fully understand how your operating system, application, and HBA move data so that you can adjust the settings accordingly.
  • Page 103 “Volume Syntax” on page 25. Optional. Sets the cache policy; see “Cache write-policy write-back| Policy” on page 103. write-through Optional. Sets the cache optimization optimization standard| mode; see “Cache Optimization Mode” on super-sequential page 103. Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 104 Parameter Description Optional. Specifies the size of the read- size read-ahead-size ahead cache. Valid values are: • Disabled: Turns off read-ahead cache. • Default: Sets one chunk for the first access in a sequential read and one stripe for all subsequent accesses. •...

  • Page 105: Set Cli-Parameters

    This is enabled by default. Optional. Sets the timeout value for the login session. timeout Valid values are 10–9999 seconds; the default is 1800 seconds (30 minutes). Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 106 Example Set CLI to use a 30-second timeout, base 2, and no paging. # set cli-parameters timeout 30 base 2 pager disable Related Commands “show cli-parameters” on page 146 Chapter 3 Command Descriptions...

  • Page 107: Set Controller-Date

    Set the controller date to 1:45 PM on September 22, 2006 in the U.S. Mountain time zone (GMT -07:00). # set controller-date sep 22 13:45:0 2006 -7 Related Commands “show controller-date” on page 149 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 108: Set Debug-Log-Parameters

    set debug-log-parameters Description Note – This command should only be used by service technicians, or with the advice of a service technician. Sets the types of debug messages to include in the storage controller debug log. If multiple types are specified, use spaces to separate them and enclose the list in quotation marks ( "...
  • Page 109 • misc: Internal debug messages • msg: Inter-controller message debug messages • mui: Internal service interface debug messages • raid: RAID debug messages • rcm: Removable-component manager debug messages • res2s: Internal debug messages Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 110 Parameter Description Sets the messages to: standard host: on disk: on mem: off fo: on msg: on fca: on fcb: off fcc: off fcd: off misc: on rcm: off raid: on cache: on emp: on capi: on mui: on bkcfg: on awt: off res2: off capi2: off...

  • Page 111: Set Drive-Parameters

    SMART setting. SMART is enabled by default. Example Set the SMART setting to enable. # set drive-parameters smart enable Related Commands “show drive-parameters” on page 157 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 112: Set Expander-Fault-Isolation

    set expander-fault-isolation Description When fault isolation is enabled, the expander controller will isolate PHYs that fail to meet certain criteria. When fault isolation is disabled, the errors are noted in the logs but the PHYs are not isolated. Input enclosure set expander-fault-isolation wwn [controller a|b|both] enable|disable...

  • Page 113: Set Expander-Phy

    # set expander-phy wwn 500C0FF0ABCD343C controller both index 23 disable Success: Disabled Phy #23. Related Commands “set expander-fault-isolation” on page 113 “show expander-status” on page 165 “show enclosure-status” on page 158 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 114: Set Global-Spare

    set global-spare Description Designates spare disk drives that can be used by any virtual disk. Sets the disk drive status to global-spare Input disks set global-spare disks Parameter Description Specifies the disk drives. For the syntax to use, see “Disk Drive disks disks Syntax”...

  • Page 115: Set Host-Parameters

    Point-to-point topology is only valid and allowed when port interconnects are disabled (using set host-port-interconnects). Optional. iSCSI only. Specifies the IP address for address an iSCSI port in IPv4 format. Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 116 Parameter Description Optional. iSCSI only. Specifies the netmask address netmask address in IPv4 format. Optional. iSCSI only. Specifies the gateway gateway address address in IPv4 format. Optional. Specifies an automatic response to the noprompt confirmation prompt that enables the operation to proceed.
  • Page 117 ID mode for failover and your ability to access LUNs from some hosts will be limited. Are you sure? Related Commands “show host-parameters” on page 171 “show host-port-interconnects” on page 174 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 118: Set Host-Port-Interconnects

    set host-port-interconnects Description Enables or disables the internal connection between FC host port pairs. In a dual- controller system, each host port on the upper controller is connected to a peer host port on the lower controller. When the connection between peer host ports is enabled, it forms an FC-AL loop.

  • Page 119: Set Host-Wwn-Name

    # set host-wwn-name host 100000A0B8040BAC HBA1 Change the nickname HBA1 to Test-HBA. # set host-wwn-name host HBA1 Test-HBA Related Commands “create host-wwn-name” on page 48 “delete host-wwn-name” on page 69 “show host-wwn-names” on page 175 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 120: Set Iscsi-Host

    set iscsi-host Description Changes the nickname associated with an iSCSI host initiator's IP address, or associates a nickname with an unnamed iSCSI host initiator’s IP address. Input descriptor new-nickname set iscsi-host Parameter Description Specifies an iSCSI host initiator’s IP address in IPv4 descriptor format, or nickname.

  • Page 121: Set Job-Parameters

    Example Disable background scrubbing of vdisks. # set job-parameters background-scrub off Set the job priority to low. # set job-parameters utility-priority low Related Commands “show job-parameters” on page 177 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 122: Set Led

    set led Description Changes the state of drive module or enclosure LEDs to help you locate devices. For a drive module, the Power/Activity/Fault LED will blink yellow. For an enclosure, the Unit Locator LED on the chassis ear and on each controller module will blink white.

  • Page 123: Set Network-Parameters

    Optional. Specifies whether to apply the settings to controller controller a|b A (upper) or controller B (lower). If this parameter is omitted, settings are applied to the controller being accessed. Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 124 Example Dynamically set enclosure network parameters using DHCP. # set network-parameters dhcp Statically set network parameters for controller A. # set network-parameters ip 192.168.0.10 netmask 255.255.255.0 gateway 192.168.0.1 controller a Related Commands “show network-parameters” on page 182 Chapter 3 Command Descriptions...

  • Page 125: Set Password

    Example Change the password of the default user, monitor # set password monitor Info: Changing password for user: monitor Enter new password:**** Verify new password:**** Success: Password set Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 126: Set Prompt

    set prompt Description Sets the prompt for the current CLI session. Input prompt set prompt Parameter Description Specifies the new prompt string. A string that includes a space must be prompt enclosed in quotation marks ("). Output Command line with new prompt. Example Set the prompt to >...

  • Page 127: Set Protocols

    Specifies whether to enable or disable the preceding enabled|disabled protocol. Example Disable unsecure HTTP connections and enable FTP. # set protocols http disabled ftp enabled Related Commands “show protocols” on page 185 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 128: Set Snap-Pool-Policy

    set snap-pool-policy Description Sets the recovery policy that determines the action taken when a specified snap pool's error and critical threshold levels are reached. The policy for the warning threshold is preset to . A snap pool's default error policy is notifyonly and default critical policy is deleteoldestsnapshot...
  • Page 129 10 MB for autoexpand snap pool SP1. # set snap-pool-policy SP1 error autoexpand autoexpansionsize 10MB Related Commands “set snap-pool-threshold” on page 131 “show snap-pools” on page 194 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 130: Set Snap-Pool-Threshold

    set snap-pool-threshold Description Sets the percentages of snap-pool space used that trigger the warning and error threshold policies. Three threshold levels are defined: Warning. This first threshold indicates that snap-pool space is moderately full. When exceeded, an event is generated to warn the administrator. Error.
  • Page 131 Related Commands “set snap-pool-policy” on page 129 “show snap-pools” on page 194 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 132: Set Snmp-Parameters

    set snmp-parameters Description Configures SNMP notification of events. Input set snmp-parameters [enable crit|warn|info|none] string [add-trap-host ] [del-trap-host ] [read-community string [write-community Parameter Description Optional. Sets the level of trap notification: enable crit|warn|info|none • crit: Sends critical events only. • warn: Sends all critical events and warnings.

  • Page 133: Set System

    Example Set the system name to and the contact to Test J. Doe " " # set system name Test contact J. Doe Related Commands “show system” on page 200 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 134: Set User

    set user Description Changes a user’s level, type, and interface access. To change a user’s password, use set password Input name set user [level monitor|manage] [type standard|advanced interfaces |diagnostic] [interfaces Parameter Description Specifies the user profile to change. Names are case name sensitive.
  • Page 135 Success: User-Type set to diagnostic. Success: CLI-Access enabled. Success: WBI-Access enabled. Related Commands “create user” on page 59 “delete user” on page 77 “set password” on page 126 “show users” on page 206 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 136: Set Vdisk

    set vdisk Description Sets the name and owning controller for an existing virtual disk. Input vdisk new-name set vdisk [name ] [owner a|b] Parameter Description Specifies the virtual disk by name or serial number. For the vdisk syntax to use, see “Virtual Disk Syntax” on page 25. Optional.

  • Page 137: Set Vdisk-Spare

    Designate the disk drive having ID 5 as a vdisk spare for virtual disk VD1. # set vdisk-spare disks 5 VD1 Related Commands “show disks” on page 154 “show vdisks” on page 208 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 138: Set Volume

    set volume Description Changes the name of a volume. Input volume new-name set volume name Parameter Description Specifies the volume by its name or serial volume number. For the syntax to use, see “Volume Syntax” on page 25. Specifies a new name for the volume. For new-name name the syntax to use, see “Volume Syntax”...

  • Page 139: Show Auto-Write-Through-Trigger

    Compact Flash Failure : Disabled Power Supply Failure : Disabled Fan Failure : Disabled Temperature Exceeded : Disabled Partner Notify : Disabled Auto Write Back : Enabled Related Commands “set auto-write-through-trigger” on page 101 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 140: Show Cache-Parameters

    show cache-parameters Description Shows a volume's cache policy and cache optimization mode. Input show cache-parameters volume Parameter Description Optional. Specifies the volume by its name or serial number. For the volume syntax to use, see “Volume Syntax” on page 25. Output Field Description...

  • Page 141: Phoenix Rpc12 Series Cli Reference Manual • September

    Operation Mode: Active-Active Volume Serial : 00c0ff0a48880048fd83424601000000 Volume Name : V1 Write-mode : write-back Optimization : standard Read Ahead Size: Maximum Related Commands “set cache-parameters” on page 103 “show volumes” on page 215 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 142: Show Channels

    show channels Description Shows information about channels on both controllers. Input show channels Output Field Description Controller ID Ctlr Channel number • Host: Channel to host Type • Drive: Channel to expansion enclosures • FC(P): Fibre Channel Point-to-Point Media • FC(L): Fibre Channel-Arbitrated Loop •...
  • Page 143 Primary IP address iSCSI only. Secondary IP address. This field is only displayed IP(S) during failover. Address Unique Media Access Control (MAC) hardware address, also called the physical address. Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 144 Example Show channel information for a dual-controller FC system. # show channels Ctlr Ch Type Media Topo(C) Speed(A) Speed(C) Status PID SID --------------------------------------------------------------- Host FC(P) Down Host FC(P) Down Host FC(P) Down Host FC(P) Down Drive SAS Drive SAS Host FC(P) Down Host...

  • Page 145: Show Cli-Parameters

    • disable: Pager feature is disabled. Example Show current CLI settings. # show cli-parameters Timeout: 1800 Output Format: console Base: 10 Pager: enabled Related Commands “set cli-parameters” on page 106 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 146: Show Configuration

    show configuration Description Shows system configuration information. Input show configuration Output Category and Description Fields See “show system” on page 200. SYSTEM Shows system information CONTROLLER • Serial Number Shows information about each controller • Hardware Version • CPLD Version •...
  • Page 147 (SES) information followed by component- specific information MIDPLANE FRU and ENCLOSURE FRU See “show frus” on page 167. Show information for all field-replaceable units (FRUs) in the controller enclosure and in any attached expansion enclosures Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 148: Show Controller-Date

    show controller-date Description Shows the system’s current date and time. Input show controller-date Output Field Description Day, date, time, and year Controller Date Example Show the system date and time. # show controller-date Controller Date: THU SEP 21 15:56:45 2006 Related Commands “set controller-date”...

  • Page 149: Show Debug-Log

    • error: Shows only error logs recorded for previous SC crash or improper shutdown. • debug: Shows only debug logs. • all: Shows all logs. Specifies the semaphore trace log. sem-trace-log Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 150 Parameter Description Optional. Specifies the number of entries semaphore log entries to show. If this parameter is omitted, all semaphore log entries are shown. Specifies to show the MC task status at the task-log time this command is issued. Optional. Specifies the number of task log entries entries to show.

  • Page 151: Show Debug-Log-Parameters

    Cache debug messages cache Enclosure Management Processor debug messages Internal Configuration API debug messages capi Internal service interface debug messages Internal configuration debug messages bkcfg Auto-write-through feature debug messages Internal debug messages res2 Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 152 Field Description (Continued) Internal Configuration API tracing debug messages capi2 Snapshot feature debug messages Example Show debug log parameters. # show debug-log-parameters host: off disk: on mem: off Related Commands “set debug-log-parameters” on page 109 “show debug-log” on page 150 Chapter 3 Command Descriptions...

  • Page 153: Show Disks

    For the syntax to use, see “Virtual Disk Syntax” on page 25. Output (Standard) Field Description SCSI ID Disk drive serial number Serial# Disk drive vendor Vendor Firmware revision number Rev. Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 154 Field Description • AVAIL: Disk is available for use in a vdisk State • GLOBAL SP: Global spare • LEFTOVR: Disk contains metadata but is not part of a vdisk • VDISK: Disk is part of a vdisk • VDISK SP: Disk is a spare assigned to a vdisk Any jobs running on the disk or its vdisk follow the state value: •...
  • Page 155 # show disks encl Status Encl Slot Vendor Model Serial# Size(GB) ------------------------------------------------------------------ HDS725050KLA360 KRVN03ZAG4ZPPD Missing 0 HDS725050KLA360 KRVN03ZAGA88PD HDS725050KLA360 KRVN03ZAGA8A0D HDS725050KLA360 KRVN03ZAG4L22D ------------------------------------------------------------------ Related Commands “show vdisks” on page 208 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 156: Show Drive-Parameters

    show drive-parameters Description Shows the SMART setting. Input show drive-parameters Output Field Description Shows whether SMART is enabled or SMART disabled Example Show drive parameter settings. # show drive-parameters Drive Parameters -------------- SMART: Enabled Related Commands “set drive-parameters” on page 112 Chapter 3 Command Descriptions...

  • Page 157: Show Enclosure-Status

    Product ID Product revision number Complex Programmable Logic Device revision number CPLD World wide port name of the SES device reporting the enclosure WWPN status Overall status of the enclosure Status Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 158 Enclosure Component Status fields: Field Description The component type: Type • Fan: Cooling fan unit • PSU: Power supply unit • Temp: Temperature sensor • Voltage: Voltage sensor • DiskSlot: Disk drive module Unit ID For the location of each fan and power supply, see Figure 3-1. For the location of each disk slot, see Figure 3-2.
  • Page 159 Figure 3-2 shows the numbering of disk slots by row from left to right. Here left and right are with respect to the front of the enclosure. Top row: 0–3 Center row: 4–7 Bottom row: 8–11 Figure 3-2 Drive Module (Disk Slot) Numbering Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 160 Example Show output for an enclosure. # show enclosure-status Chassis Vendor Product ID CPLD WWPN Status ------------------------------------------------------------------------------ FSCIYHAK000551-242866 DotHill R/Evo 5730-2R 2030 25 500C0FF02428663C ------------------------------------------------------------------------------ Type Status FRU P/N FRU S/N Add'l Data ------------------------------------------------------------------------------ 00 Absent Unknown Unknown 01 OK FRUHE01 FSCITOR-0607NR012C 00 Absent...

  • Page 161: Show Events

    Optional. Shows events including and after the specified from date date and time. Use the format , where MMDDYYhhmmss is the hour on a 24-hour clock. For example, 043006235900 represents Apr 30 2006 at 11:59:00 p.m. Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 162 Parameter Description Optional. Shows events before and including the date specified date and time. Use the format , where is the hour on a 24-hour MMDDYYhhmmss clock. For example, 043006235900 represents Apr 30 2006 at 11:59:00 p.m. This parameter can be used with either “from”...
  • Page 163 # show events from 043006235900 to 050206115900 Show a range of events logged by controller A. # show events from-event a100 to-event a123 Example “set snmp-parameters” on page 133 “show snmp-parameters” on page 198 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 164: Show Expander-Status

    show expander-status Description Note – This command should only be used by service technicians, or with the advice of a service technician. Shows diagnostic information relating to SAS expander controller physical channels, known as PHY lanes. Information is shown by controller for each enclosure.
  • Page 165 EGRESS 21 0 DISABLED EGRESS 22 0 DISABLED EGRESS 23 0 DISABLED EGRESS -------------------------------- Related Commands “clear expander-status” on page 45 “set expander-fault-isolation” on page 113 “set expander-phy” on page 114 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 166: Show Frus

    show frus Description Shows information for all field-replaceable units (FRUs) in the controller enclosure and in any attached expansion enclosures. Some information reported is for use by service technicians. Input show frus Output Field Description FRU name: Name • CHASSIS_MIDPLANE: 2U chassis and midplane; the metal enclosure and the circuit board to which power and cooling, controller, expansion, and drive modules connect •...
  • Page 167 Dash Level: 01 FRU Shortname: FRUKE01 Mfg Date: WED JUN 14 21:02:13 2006 Mfg Location: Milpitas California, USA Mfg Vendor ID: 0x0301 FRU Location: LEFT PSU SLOT Configuration SN: DHSIMIL-0610138139 FRU Status: OK Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 168: Show Host-Maps

    show host-maps Description Shows mapping information for volumes that are mapped to a specified host or to all hosts. Input host show host-maps [ Parameter Description Optional. If this parameter is omitted, mapped volumes for all hosts are host shown. For FC - Specifies the HBA's nickname or 16-hex-digit WWPN.
  • Page 169 ID LUN Access Channels -------------------------------------------------------------------------- R0_3_V1 00c0ff0a591300483a21f54501000000 0 R0_2_V1 00c0ff0a427d00484f28f54501000000 0 R0_1_V1 00c0ff0a427d0048466dc04501000000 na na none none R0_2_V2 00c0ff0a427d00489528f54501000000 0 Related Commands “show host-wwn-names” on page 175 “show volume-maps” on page 213 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 170: Show Host-Parameters

    show host-parameters Description Shows information about host channels on both controllers. Input show host-parameters Output Field Description Controller ID Ctlr Host channel number • Host: Channel to host Type • FC(P): Fibre Channel Point-to-Point Media • FC(L): Fibre Channel-Arbitrated Loop •...
  • Page 171 Field Description iSCSI: Netmask IP address Netmask iSCSI: Gateway IP address Gateway Service Port Service Port Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 172 Example Show host parameters for a dual-controller FC system. # show host-parameters Ctlr Ch Type Media Topo(C) Speed(A) Speed(C) Status PID SID --------------------------------------------------------------- Host FC(L) Loop Host FC(L) Loop Down Host FC(L) Loop Down Host FC(L) Loop --------------------------------------------------------------- Show host parameters for a single controller iSCSI system. # show host-parameters Host Parameters ---------------...

  • Page 173: Show Host-Port-Interconnects

    Shows the status of the internal connection between FC host port pairs. Input show host-port-interconnects Example Show the status of the host port interconnect. # show host-port-interconnects Host Port Interconnect: enabled Related Commands “set host-port-interconnects” on page 119 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 174: Show Host-Wwn-Names

    show host-wwn-names Description Shows the current list of host world wide names (WWNs). FC host channels only. Input show host-wwn-names Output Field Description Host port WWN Host-ID/WWN Nickname assigned to the host WWN Name Example Show host WWNs and nicknames assigned to them. # show host-wwn-names Host-ID/WWN Name...

  • Page 175: Show Iscsi-Hosts

    Show iSCSI host initiators. # show iSCSI iSCSI-Host-IP Name ---------------------------------------------------------------- 255.255.255.255 0000:0000:0000:0000:0000:0000:0A0B:0A65 AndiamoP4 0000:0000:0000:0000:0000:0000:0A0A:0A66 AndiamoP5 ---------------------------------------------------------------- Related Commands “create iscsi-host” on page 49 “delete iscsi-host” on page 70 “set iscsi-host” on page 121 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 176: Show Job-Parameters

    show job-parameters Description Shows parameters for background scrub, partner firmware upgrade, and other jobs. Input show job-parameters Output Field Description Shows whether disks are automatically checked Background Scrub for disk drive defects to ensure system health. Shows whether component firmware versions Partner Firmware Upgrade are monitored and will be automatically upgraded on the partner controller.

  • Page 177: Show License

    (Enabled) or excludes (Disabled) use of volume copy functions. Shows whether the Virtual Disk Service (VDS) is enabled or disabled. Shows whether the Virtual Shadow Copy Service (VSS) is enabled or disabled. Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 178 Example Show information about the installed license. # show license License Key: 570c8b65899822a37a7acc1fac3c332a Base Max Snapshots: 16 Max Snapshots: 16 Platform Max Snapshots: 64 In-Use Snapshots: 15 Volume Copy: Enabled VDS: Disabled VSS: Disabled Chapter 3 Command Descriptions...

  • Page 179: Show Master-Volumes

    Amount of snap-pool space occupied by this master volume Snap Data for its associated snapshots (preserved and write data) Either the percent complete if rollback is in progress, or Rollback “---” if rollback is not in progress Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 180 Example Show information about master volumes associated with snap pool SP1. # show master-volumes snap-pool SP1 Vdisk Serial# Name Size Status Snap-pool Name Snapshots Snap Data Rollback --------------------------------------------------------------- 00c0ff0a43180048acc3134501000000 10.0GB Valid 0.0KB --------------------------------------------------------------- Related Commands “convert master-to-std” on page 46 “convert std-to-master”...

  • Page 181: Show Network-Parameters

    Controller gateway Gateway Controller subnet mask Subnet Mask Controller's unique Media Access Control address MAC Address • Manual: Network settings set statically Addressing Mode • DHCP: DHCP used to set network parameters Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 182 Example Show the network parameters for a dual-controller system. # show network-parameters Network Parameters Controller A ------------------------------- IP Address : 172.22.1.200 Gateway : 172.22.1.1 Subnet Mask : 255.255.255.0 MAC Address : 00:C0:FF:0A:43:18 Addressing Mode: Manual Network Parameters Controller B ------------------------------- IP Address : 172.22.1.201 Gateway...

  • Page 183: Show Port-Wwn

    Field Description Controller CTRL Host channel number World wide port name (WWPN) Example Show port WWNs for both controllers. # show port-wwn CTRL CH WWPN ------------------------- 207000C0FF242866 217000C0FF242866 207800C0FF242866 217800C0FF242866 ------------------------- Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 184: Show Protocols

    show protocols Description Shows which service and security protocols are enabled or disabled. Input show protocols Output Status of each protocol. Example Show the status of service and security protocols. # show protocols Service and Security Protocols ------------------------------ Web Browser Interface (HTTP) : Enabled Secure Web Browser Interface...

  • Page 185: Show Redundancy-Mode

    • Operational: The controller is Controller Status operational • Not Installed: The controller is not installed or has failed Serial Number • Controller module serial number Controller • Not Available Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 186 Example Show the system redundancy status. # show redundancy-mode System Redundancy ----------------- Redundancy Mode : Active-Active Redundancy Status : Redundant Operation Controller A Status : Operational Controller A Serial Number: 00C0FF0A4318 Controller B Status : Operational Controller B Serial Number: 00C0FF0A4326 Chapter 3 Command Descriptions...

  • Page 187: Show Schedule-Details

    The name of the task to run Task to Run Any error message associated with this schedule Error Message Details of the task, as shown by show task- Task Details details Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 188 Example Show details for task schedule Sched1 which should run task T1. The task will run at 12:59. When the task was scheduled to run the previous time, an error occurred. # show schedule-details Sched1 Schedule Details ---------------- Schedule Name: Sched1 Schedule Specification: Start 2/19/2007 23:47:00, Every 3 Minutes Schedule Status: Ready Next Time: 2/23/2007 12:59:00...

  • Page 189: Show Schedules

    ---------------------------------------------------------------- 2/23/2007 12:59:00 2/23/2007 12:58:00 2/23/2007 12:56:00 2/23/2007 12:57:00 2/23/2007 12:59:00 2/23/2007 12:55:00 ---------------------------------------------------------------- Related Commands “create schedule” on page 52 “create task” on page 56 “show schedule-details” on page 188 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 190: Show Sensor-Status

    show sensor-status Description Shows the status and current values reported by environmental sensors in each of the controllers and power supplies. Input show sensor-status Output Field Description Where the sensor is located Sensor Name The value of the sensor Value Component status: Status •...
  • Page 191 Power Supply 2 Voltage, 12V 12.37 Power Supply 2 Voltage, 5V 5.50 Power Supply 2 Voltage, 3.3V 2.73 Overall Unit Status ---------------------------------------------------- Related Commands “show enclosure-status” on page 158 “show expander-status” on page 165 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 192: Show Shutdown-Status

    show shutdown-status Description Shows whether the RAID (storage) controllers are shut down. Input show shutdown-status Output Message stating whether each controller is up (operating) or down (shut down). Example Show the shutdown status for each controller. # show shutdown-status storage controller A is up storage controller B is up Related Commands “restart”...

  • Page 193: Show Snap-Pools

    SizeToExpand Increment size by which the snap pool is automatically expanded each time the threshold level is reached. This parameter applies when autoexpand policy is selected; otherwise its value is 0. Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 194 Example Show information for snap pools owned by either controller. # show snap-pools Vdisk Serial# Name Size Free MasterVols Snapshots ----------------------------------------------------------- 00c0ff0a48930048ea1a834601000000 30.0GB 30.0GB Threshold %Usage Policy SizeToExpand --------------------------------------------------------- Warning Notify Only Error Delete Oldest Snapshot 0.0KB Critical Delete Snapshots Related Commands “create snap-pool”...

  • Page 195: Show Snapshots

    Name of associated master volume Master Volume Name Name of associated snap pool Snap-pool Name Total amount of preserved and write data associated with Snap Data the snapshot Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 196 Field Description Amount of preserved and write data that is unique to the UniqueData snapshot Amount of preserved and write data that is shared SharedData between this snapshot and other snapshots Example This example shows information about snapshots associated with snap pool SP2. # show snapshots snap-pool SP2 Vdisk Serial# Name...

  • Page 197: Show Snmp-Parameters

    IP address of each trap host SNMP Trap Host IP Community string for read-only access, not shown to SNMP read community monitor-level users Community string for write access, not shown to SNMP write community monitor-level users Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 198 Example Show SNMP notification settings. # show snmp-parameters SNMP ---- SNMP: enabled SNMP Filter: Critical, Warning SNMP Trap Host IP1: 172.22.4.171 SNMP read community: public SNMP write community: private Related Commands “set snmp-parameters” on page 133 Chapter 3 Command Descriptions...

  • Page 199: Show System

    Shows information about the system. Input show system Output System Name System Contact System Location System Information Vendor Name Product ID Product Brand SCSI Vendor ID Enclosure Count Related Commands “set system” on page 134 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 200: Show Task-Details

    show task-details Description Shows details of a configured task. Input task show task-details Output (TakeSnapshot) Field Description Task name Task Name Task Type TakeSnapshot The status of the task: Ready, Active Task Status The current state of the task: Init, Vol Verified, Task State License Checked, Name Created, Snap Created, Snap Verified...
  • Page 201 Prefix of the destination volume Destination Volume Prefix True or False Include Modified Data Name of the last copy created Last Copy Created Any error message associated with this task Error Message Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 202 Example Show the details of the volume copy task C1. # show task-details C1 Task Details ------------ Task Name: C1 Task Type: VolumeCopy Task Status: Ready Task State: Init Source Volume Name: VD1_V1 Source Volume Serial: 00c0ffd2710700481a8fcf4501000000 Destination Vdisk Name: VD2 Destination Vdisk Serial: 00c0ffd270280048b68ecf4500000000 Destination Volume Prefix: Copy Include Modified Data: false...
  • Page 203 Related Commands “create schedule” on page 52 “create task” on page 56 “delete task” on page 76 “show schedule-details” on page 188 “show tasks” on page 205 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 204: Show Tasks

    show tasks Description Shows configured tasks. Input show tasks Output Field Description Task name Task Name Task type: TakeSnapshot, ResetSnapshot, VolumeCopy Task Type Task status: Ready, Active Task Status Example Show configured tasks for the system. # show tasks Task Name Task Type Task Status ------------------------------------------------------------...

  • Page 205: Show Users

    File transfer protocol interface Example Show configured users for a system. # show users Username Access Level User Type ----------------------------------------------------------- monitor Monitor Standard manage Manage Diagnostic Manage Standard jsmith Manage Advanced ----------------------------------------------------------- Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 206 Related Commands “create user” on page 59 “delete user” on page 77 “set user” on page 135 “show users” on page 206 Chapter 3 Command Descriptions...

  • Page 207: Show Vdisks

    Controller module that owns the virtual disk Virtual disk RAID level RAID Number of disk drives in the virtual disk Number of vdisk spares assigned to the virtual disk Virtual disk chunk size Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 208 Field Description • CRIT: The vdisk is online, however some drives are down and the Stat vdisk is not fault tolerant • FTDN: The vdisk is online and fault tolerant, however some of the drives are down • FTOL: The vdisk is online and fault tolerant •...
  • Page 209 Related Commands “abort create” on page 38 “create vdisk” on page 61 “delete vdisk” on page 78 “expand vdisk” on page 85 “set vdisk” on page 137 “show vdisks” on page 208 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 210: Show Volumecopy-Status

    show volumecopy-status Description Shows information about in-progress volume copy operations. While a volume copy is in progress, the destination volume cannot be accessed. Input show volumecopy-status [controller a|b] Parameter Description Optional. Shows volume copy operations for volumes owned controller a|b by controller A (upper) or controller B (lower) only.
  • Page 211 Related Commands “abort volumecopy” on page 41 “volumecopy” on page 226 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 212: Show Volume-Maps

    show volume-maps Description Shows mapping information for a specified volume or for all volumes. Input volume show volume-maps [ Parameter Description Specifies the volume by its name or serial number. For the syntax to use, volume see “Volume Syntax” on page 25. If this parameter is omitted, information for all volumes is shown.
  • Page 213 Show the mappings for volume V1 on a FC system. # show volume-maps V1 Volume [SN 00c0ff0a43180048517e054501000000, Name (V1)] mapping view: Access Port-WWN Nickname ----------------------------------------------- 100000A0B8040BAC HBA1 Related Commands “show volumes” on page 215 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 214: Show Volumes

    show volumes Description Shows volume information for all or specified virtual disks. Input vdisks show volumes [vdisk ] [class standard|ptsnap] [type snap-pool|mastervolume|snapshot|standard] Parameter Description Optional. Specifies the virtual disks by name or vdisks vdisk serial number. For the syntax to use, see “Virtual Disk Syntax”...
  • Page 215 Volume Serial Number Cache Opt Type ----------------------------------------------------------- 10.0GB writeback standard 00c0ff0a43180048aff0074501000000 standard standard 10.0GB writeback PTSNAP 00c0ff0a43180048d9f0074501000000 standard snap-pool 10.0GB writeback PTSNAP 00c0ff0a43180048f3f0074501000000 standard mastervol 10.0GB writeback PTSNAP 00c0ff0a4318004821f1074501000000 standard snapshot ----------------------------------------------------------- Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 216 Related Commands “create volume” on page 64 “delete volume” on page 81 “expand volume” on page 87 “set volume” on page 139 “show vdisks” on page 208 “show volume-maps” on page 213 Chapter 3 Command Descriptions...

  • Page 217: Shutdown

    A (upper), controller module B (lower), or both. Output Messages are displayed when the RAID controllers are shut down. Example Shut down RAID controller A. # shutdown a Related Commands “restart” on page 95 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 218: Stty

    stty Description Sets and shows terminal information. Input stty info | hardwrap | rows | columns Parameter Description Shows current information about the terminal info Toggles the hard wrapping of output. Terminals usually wrap at the hardwrap screen width without truncating output, but turning On hard wrapping ensures this.

  • Page 219: Trust

    Input To enable the trust command: trust enable To trust a virtual disk: vdisk trust vdisk Parameter Description Enables the trust command before use enable Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 220 Parameter Description Specifies the virtual disks by name or serial number. For the vdisk vdisk syntax to use, see “Virtual Disk Syntax” on page 25. Example Enable the trust command and then trust virtual disk VD1. # trust enable Trust Virtual-disk Enabled. # trust vdisk VD1 Are you sure? yes Virtual-disk VD1 has been trusted.

  • Page 221: Unmap Volume

    Remove the volume default mapping from LUN 8 on channels 0-3. # unmap volume V1 mapping 0-3.8 Remove the volume mapping from LUN 8 on channel 1 associated with host HBA1. # unmap volume V1 mapping 1.8 host HBA1 Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 222 Related Commands “map volume” on page 89 “show host-maps” on page 169 “show host-wwn-names” on page 175 “show volumes” on page 215 “show volume-maps” on page 213 Chapter 3 Command Descriptions...

  • Page 223: Verify Vdisk

    “Virtual Disk Syntax” on page 25. Example Verify two virtual disks. # verify vdisk VD1,VD2 Related Commands “abort verify” on page 40 “scrub vdisk” on page 100 “show vdisks” on page 208 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 224: Versions

    versions Description Shows the hardware and software versions for each controller module. Alias: show versions Input versions Output Storage Controller CPU Type Storage Controller Firmware Storage Controller Memory Storage Controller Loader Management Controller Firmware Management Controller Loader Expander Controller Firmware CPLD Revision Hardware Revision Host Interface Module...

  • Page 225: Volumecopy

    For the syntax to use, see “Virtual Disk Syntax” on page 25. Example Copy master volume MV1 to new volume RO1 on virtual disk VD2. # volumecopy source-volume MV1 dest-vdisk VD2 RO1 Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 226 Related Commands abort volumecopy “create task” on page 56 “show vdisks” on page 208 “show volumecopy-status” on page 211 “show volumes” on page 215 Chapter 3 Command Descriptions...
  • Page 227 Phoenix RPC12 Series CLI Reference Manual • September 2008...

  • Page 228: Glossary

    Glossary The glossary defines terms and acronyms used in Phoenix storage system documentation. Definitions obtained from the Storage Networking Industry Association (SNIA) Dictionary are indicated with “(SNIA)” at the end. For the complete SNIA Dictionary, go to www.snia.org/education/dictionary active-active Synonym for dual active components or controllers. A pair of...

  • Page 229: Phoenix Rpc12 Series Cli Reference Manual • September

    See block. The command-line interface that system administrators can use to configure, monitor, and manage Phoenix storage systems. The CLI is accessible from any management host that can access a controller module through an out-of-band Ethernet or RS-232 connection.
  • Page 230 controller module A FRU that contains: a storage controller processor; a management controller processor; out-of-band management interfaces; a LAN subsystem; cache protected by a capacitor pack and Compact Flash memory; host, expansion, and management ports; and midplane connectivity. If a controller enclosure contains redundant controller modules, the upper one is designated A and the lower one is designated CPLD Complex programmable logic device.
  • Page 231 Bandwidth per node via a Fabric switch remains constant when more nodes are added, and a node on a switch port uses a data path of up to 100 Mbyte/sec to send or receive data. Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 232 fabric-loop port (FL_Port) An F_Port can support an attached arbitrated loop. An FL_Port on a loop has the AL_PA hex'00', giving the fabric highest priority access to the loop. An FL_Port is the gateway to the fabric for NL_Ports on a loop.
  • Page 233 Transmission of a protocol other than the primary data protocol over the same medium as the primary data protocol. Management protocols are a common example of in-band transmission. (SNIA) This type of access is available through use of the Phoenix Configuration API (CAPI) to develop a programmed interface. initialization The process of writing a specific pattern to all data blocks on all disk drives in a virtual disk.
  • Page 234 Input/output. Internet Protocol. JBOD Just a Bunch of Disks. An expansion enclosure that is directly attached to a host. Kbyte Kilobyte (KB). See local area network (LAN). leftover drive A disk drive that contains metadata but is no longer part of a virtual disk.
  • Page 235 Hardware component that converts between digital and analog in the signal path between the storage controller, expander controller, disk drives, and SAS ports. Primary controller identifier number. Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 236 (SNIA) RAIDar The web browser interface that system administrators can use to configure, monitor, and manage Phoenix storage systems. RAIDar is accessible from any management host that can access a system through an out-of-band Ethernet connection.
  • Page 237 Services (SES) An ANSI X3T10 standard for management of environmental factors such as temperature, power, voltage, etc. (SNIA) In Phoenix storage systems, SES data is managed by enclosure management processors (EMPs). Small form-factor pluggable connector, used in FC controller module host ports.
  • Page 238 SMI-S Storage Management Interface - Specification. SMTP Simple Mail Transfer Protocol. A protocol for sending email messages between servers and from mail clients to mail servers. The messages can then be retrieved with an email client using either POP or IMAP. snap pool A volume that is configured to store snapshot data.
  • Page 239 If a bad block is encountered when the parity is regenerated, the data is copied from the other disk drive, master or slave, to the reporting disk drive reallocating the bad block. Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 240 For Phoenix storage systems, a set of disk drives that share a RAID level and disk type, and across which host data is spread for redundancy or performance. volume A logical subdivision of a virtual disk. Multiple LUNs can be assigned to the same volume, one for each host port given access to the volume.
  • Page 241 (including power failures) and to flush the cache at system restart time. (SNIA) This is how Phoenix storage systems operate. See also write-through cache. write-through cache A caching technique in which the completion of a write request is not signaled until data is safely stored on non-volatile media.

  • Page 242: Index

    Index editing, 27 history, 27 aliases, create, show, or delete, 42 syntax, 24 array, See system command-line interface, See CLI commands CLI and user, 32 base for calculations configuration and utilities, 34 set, 106 event notification, 34 show setting, 146 service utilities, 35 snapshot, 33 virtual disk and disk drive, 32...
  • Page 243 46 host WWPN create, 50 change nickname, 120 delete, 71 create nickname for, 48 delete all, 66 delete nickname, 69 rollback, 98 set nickname, 120 show, 180 show, 184 Phoenix RPC12 Series CLI Reference Manual • September 2008...
  • Page 244 Mbyte, 28 security protocols enable/disable, 128 metadata, clear disk, 44 show status, 185 service protocols enable/disable, 128 network parameters show status, 185 set, 124 shutdown status, show, 193 show settings, 182 single-command mode, 15 size of devices and logical units, 28 output format snap pool api, 17...
  • Page 245 25 set, 137 show, 208 syntax, 25 verify, 224 volume convert master to standard, 46 convert standard to master, 47 copy status, 211 create, 64 delete, 81 expand, 87 Phoenix RPC12 Series CLI Reference Manual • September 2008...

Table of Contents