background image

Chapter 3 Command Descriptions

59

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. 

The system supports 13 user profiles.

Input

create user 

name

 [level monitor|manage] [type 

standard|advanced|diagnostic] [interfaces 

interfaces

]

Parameter

Description

name

Unique name that can include a maximum of 19 
alphanumeric characters. Names are case sensitive.

level 

monitor|manage

Optional. Specifies whether the user has 

monitor

 

(view-only) or 

manage

 (modify) access for user 

interfaces. The default is 

monitor

.

type 

standard|advanced

|diagnostic

Optional. Specifies the user's level of technical 
expertise, to control access to functionality in the WBI.

standard

: Enables access to standard 

administrative functions. This is the default for 
monitor users.

advanced

: Enables access to standard and 

advanced functions. This is the default for manage 
users.

diagnostic

: Enables access to standard, 

advanced, and troubleshooting functions. This is the 
default for users of the CLI.

interfaces

 

interfaces

Optional. Specifies the interfaces that the user can 
access. Multiple values must be separated by a comma 
with no spaces. If this parameter is omitted, the 
defaults are 

cli

 and 

wbi

.

cli

: Command-line interface.

wbi

: Web-browser interface.

ftp

: File transfer protocol interface.

none

: No interfaces.

Summary of Contents for RPC12 Series

Page 1: ......

Page 2: ...ion Modes 13 Using the XML API 17 DTD 18 Example 21 Command Syntax 24 Keywords and Parameters 24 Disk Drive Syntax 24 Virtual Disk Syntax 25 Volume Syntax 25 Host Nickname Syntax 26 Volume Mapping Syn...

Page 3: ...34 Service Utilities 35 3 Command Descriptions 37 abort create 38 abort scrub 39 abort verify 40 abort volumecopy 41 alias 42 clear cache 43 clear disk metadata 44 clear expander status 45 convert ma...

Page 4: ...delete schedule 72 delete snap pool 73 delete snapshot 74 delete snapshot write data 75 delete task 76 delete user 77 delete vdisk 78 delete vdisk spare 80 delete volume 81 exit 82 expand snap pool 83...

Page 5: ...n 113 set expander phy 114 set global spare 115 set host parameters 116 set host port interconnects 119 set host wwn name 120 set iscsi host 121 set job parameters 122 set led 123 set network paramete...

Page 6: ...enclosure status 158 show events 162 show expander status 165 show frus 167 show host maps 169 show host parameters 171 show host port interconnects 174 show host wwn names 175 show iscsi hosts 176 s...

Page 7: ...how snapshots 196 show snmp parameters 198 show system 200 show task details 201 show tasks 205 show users 206 show vdisks 208 show volumecopy status 211 show volume maps 213 show volumes 215 shutdown...

Page 8: ...e 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 Befor...

Page 9: ...Type exit AaBbCc123 Text you type contrasted with on screen output set password Enter new password AaBbCc123 Variable text you replace with an actual value Use the format http ip address AaBbCc123 Com...

Page 10: ...69503 Release Notes 83 00004282 83 00005032 Installing and configuring hardware Phoenix 69501 Getting Started Guide Phoenix 69503 Getting Started Guide 83 00004284 83 00005034 Configuring and managing...

Page 11: ...12 Phoenix RPC12 Series CLI Reference Manual September 2008...

Page 12: ...nfigure monitor and manage storage systems out of band You can access the CLI in two ways Q By using a terminal emulator on a management host that is directly connected to a controller module s CLI po...

Page 13: ...iting the CLI telnet 172 22 5 55 Login monitor Password RPC 69501 001 System Name Test System Location Lab Version W420B22 show disks free ID Serial Vendor Rev State Type Size GB Rate Gb s SP 3 3KN0Z0...

Page 14: ...pect set login lindex argv 1 set password lindex argv 2 set host lindex argv 3 set command lindex argv 4 spawn telnet host expect Login send login r expect Password send password r send command r send...

Page 15: ...System Cloning Utility nLine n cliDumpFile get_config_dump txt space username password sub cLogin telnet open _ 0 telnet waitfor login username i telnet print _ 1 telnet waitfor password i telnet pri...

Page 16: ...I and print the output The output can easily be redirected to a file for archiving Using the XML API You can set the CLI output to either console or api using the set cli parameters command When set t...

Page 17: ...TTLIST OBJECT oid ID REQUIRED name CDATA IMPLIED basetype CDATA IMPLIED Property definition ELEMENT PROPERTY PCDATA ATTLIST PROPERTY display name CDATA IMPLIED draw true false IMPLIED size CDATA IMPLI...

Page 18: ...or code OBJECT The OBJECT element is a container for properties Each OBJECT also has attributes which describe the OBJECT characteristics oid Object Identifier A unique number per request which identi...

Page 19: ...the value for calculations size The number of columns to use to display the value type The type that the data should be interpreted as key Indicates whether or not this values can be used as a key to...

Page 20: ...e 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 Task To Run task1 Error Message none Task Details Task Name t...

Page 21: ...1 00 Only 1st Weekday Of Month PROPERTY PROPERTY name status type string size 20 draw true display name Schedule Status Ready PROPERTY PROPERTY name next time type string size 32 draw true display nam...

Page 22: ...ix 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...

Page 23: ...ameters Command keywords must be entered in lowercase Parameter values can be entered in uppercase and lowercase Parameter values that contain non alphanumeric characters such as spaces must be enclos...

Page 24: ...specifies a serial number and two names Volume Syntax You can specify volumes by using either Q Volume serial number A unique 32 digit number that is automatically assigned when a volume is created a...

Page 25: ...ma backslash or quotation mark however a name that includes a space must be enclosed in quotation marks Names are case sensitive Volume Mapping Syntax You specify the mapping of a host to a volume by...

Page 26: ...rd Tab Get previous command from history Up Arrow or Ctrl P Get next command from history Down Arrow or Ctrl N Move cursor left Left Arrow or Ctrl B Move cursor right Right Arrow or Ctrl F Move back o...

Page 27: ...such as virtual disks and volumes are presented in base 2 binary format not base 10 decimal format Table 1 1 shows how sizes are presented in each format To check which format is being used use show...

Page 28: ...field replaceable units FRUs in the enclosure Each event has one of the following levels in decreasing severity Q Critical Events that might affect data integrity or system stability Q Warning Events...

Page 29: ...30 Phoenix RPC12 Series CLI Reference Manual September 2008...

Page 30: ...thin a logical grouping based on the command s function A command might be listed in more than one category Q CLI and Users on page 32 Q Virtual Disks and Disk Drives on page 32 Q Volumes and Mapping...

Page 31: ...word Q set prompt Q set user Q show cli parameters Q show users Virtual Disks and Disk Drives Q abort create Q abort scrub Q abort verify Q clear disk metadata Q create vdisk Q delete global spare Q d...

Page 32: ...eters Q show host maps Q show host wwn names Q show iscsi hosts Q show port wwn Q show volumes Q show volumecopy status Q show volume maps Q unmap volume Q volumecopy Snapshots Q convert master to std...

Page 33: ...ow tasks Q show task detail Event Notification Q set snmp parameters Q show events Q show snmp parameters Configuration and Utilities Q alias Q clear cache Q ping Q reset host channel link Q restart Q...

Page 34: ...der status Q show frus Q show host parameters Q show host port interconnects Q show job parameters Q show license Q show network parameters Q show protocols Q show redundancy mode Q show shutdown stat...

Page 35: ...36 Phoenix RPC12 Series CLI Reference Manual September 2008...

Page 36: ...Input The command s syntax and descriptions of its parameters Q Output A description of information that is displayed by the command Q Examples One or more examples of the command s usage if the comma...

Page 37: ...tate it was in before starting to create the virtual disk instead the virtual disk is left in an offline state status OFFL Input Example Abort creating virtual disk VD1 Related Commands Q create vdisk...

Page 38: ...fied virtual disks Input Example Abort scrubbing virtual disk VD1 Related Commands Q scrub vdisk on page 100 abort scrub vdisk vdisks Parameter Description vdisk vdisks Specifies the virtual disks by...

Page 39: ...on for specified virtual disks Input Example Abort verifying virtual disk VD1 Related Commands Q verify vdisk on page 224 abort verify vdisk vdisks Parameter Description vdisk vdisks Specifies the vir...

Page 40: ...Abort creating destination volume Copy Related Commands Q show volumecopy status on page 211 Q show volumes on page 215 Q volumecopy on page 226 abort volumecopy volume Parameter Description volume S...

Page 41: ...last five events Show existing aliases alias alias command string Parameter Description alias Optional Specifies the string to substitute for the command string An alias that includes a space must be...

Page 42: ...sk to go down Unwritable data can only exist if write back cache is enabled If writeback cache is disabled then unwritable cache will never appear Input Example Clear the cache in both controllers for...

Page 43: ...e the virtual disk as when the drive has been moved to a different system the owning virtual disk is shown as Leftover You must clear the metadata before you can use the drive in a different virtual d...

Page 44: ...l enclosures or for a specific enclosure whose status is ERROR as shown by the show expander status command Input Example Clear the expander status for the controller enclosure Related Commands Q show...

Page 45: ...lete all snapshots that exist for the master volume before converting it to a standard volume Input Example Convert master volume MV1 to a standard volume Related Commands Q delete all snapshots on pa...

Page 46: ...nput Example Convert standard volume V1 to a master volume and associate it with snap pool SP1 Related Commands Q show master volumes on page 180 Q show snap pools on page 194 convert std to master vo...

Page 47: ...es to hosts Input Example Create the nickname HBA1 for the HBA having WWPN 210000e08b095562 Related Commands Q delete host wwn name on page 69 Q set host wwn name on page 120 Q show host wwn names on...

Page 48: ...SCSI host initiator at IP address 192 168 0 254 Related Commands Q delete iscsi host on page 70 Q set iscsi host on page 121 Q show iscsi hosts on page 176 create iscsi host ip IP nickname Parameter D...

Page 49: ...e or serial number For the syntax to use see Virtual Disk Syntax on page 25 size sizeMB GB TB Specifies the volume size in MB Mbyte GB Gbyte or TB Tbyte The size uses base 10 multiples of 1000 or base...

Page 50: ...Chapter 3 Command Descriptions 51 Related Commands Q delete master volume on page 71 Q show master volumes on page 180 Q show snap pools on page 194 Q show vdisks on page 208...

Page 51: ...ning when the task will recur and expire You can use a comma between conditions start mm dd yyyy hh mm AM PM If AM PM is not specified a 24 hour clock is used If you also use the between condition bel...

Page 52: ...th with no expiration Related Commands Q create task on page 56 Q delete schedule on page 72 Q show schedule details on page 188 Q show schedules on page 190 Q show task details on page 201 Q show tas...

Page 53: ...sk size sizeMB GB TB name Parameter Description vdisk vdisk Specifies the virtual disk by name or serial number For the syntax to use see Virtual Disk Syntax on page 25 size sizeMB GB TB Specifies the...

Page 54: ...ow master volumes on page 180 Q show snapshots on page 196 create snapshots master volumes volumes snap names Parameter Description master volumes volumes Specifies a comma separated list of volumes b...

Page 55: ...the reset is performed leaving it mounted can cause data corruption You should create a scheduled job on the host to unmount the snapshot prior to resetting the snapshot Input create task name type Ta...

Page 56: ...lume Syntax on page 25 snapshot prefix prefix Label to identify snapshots created by this task Snapshot names have the format pref_S where increments from 0001 to 9999 before rolling over retention co...

Page 57: ...hot yes no Optional Specifies whether to include or exclude modified write data from the snapshot in the copy This parameter applies only when the source volume is a snapshot it is ignored if the sour...

Page 58: ...manage modify access for user interfaces The default is monitor type standard advanced diagnostic Optional Specifies the user s level of technical expertise to control access to functionality in the W...

Page 59: ...an use the web and FTP interfaces Related Commands Q delete user on page 77 Q set user on page 135 Q show users on page 206 create user jsmith level manage interfaces wbi ftp Enter Password for new us...

Page 60: ...s determined by its RAID level Input Table 3 1 Number of Disk Drives Required for Each RAID Level RAID Level Minimum Maximum Number of Disk Drives NRAID non RAID 1 0 2 16 1 2 3 3 16 5 3 16 6 4 16 10 4...

Page 61: ...controller to own the virtual disk To have the system automatically load balance virtual disks between controllers use auto or omit this parameter spare disks Optional Specifies up to four vdisk spare...

Page 62: ...Chapter 3 Command Descriptions 63 Related Commands Q abort create on page 38 Q delete vdisk on page 78 Q set vdisk on page 137 Q show disks on page 154 Q show vdisks on page 208...

Page 63: ...disk by name or serial number For the syntax to use see Virtual Disk Syntax on page 25 size sizeMB GB TB Specifies the volume size in MB Mbyte GB Gbyte or TB Tbyte The size uses base 10 multiples of...

Page 64: ...pter 3 Command Descriptions 65 Related Commands Q delete volume on page 81 Q map volume on page 89 Q set volume on page 139 Q show vdisks on page 208 Q show volumes on page 215 Q unmap volume on page...

Page 65: ...elete all master volumes associated with snap pool SP1 Related Commands Q show master volumes on page 180 Q show snap pools on page 194 delete all master volumes snap pool volume Parameter Description...

Page 66: ...deleted and associated space in the snap pool is freed for use Input Example Delete all snapshots associated with master volume MV1 Related Commands Q show snapshots on page 196 Q show volumes on page...

Page 67: ...drives from the pool of global spares Input Example Remove the global spare having ID 5 Related Commands Q show disks on page 154 delete global spare disks disks Parameter Description disks disks Spe...

Page 68: ...xample Delete the nickname HBA1 Related Commands Q create host wwn name on page 48 Q set host wwn name on page 120 Q show host wwn names on page 175 delete host wwn name host Parameter Description hos...

Page 69: ...the iSCSI host initiator nickname iSCSI 1 Related Commands Q create iscsi host on page 49 Q set host wwn name on page 120 Q show iscsi hosts on page 176 delete iscsi host descriptor Parameter Descrip...

Page 70: ...st for the master volume before you can delete it Input Example Delete master volume MV1 Related Commands Q delete all snapshots on page 67 Q show master volumes on page 180 delete master volume volum...

Page 71: ...ple Delete schedule Sched1 Related Commands Q create schedule on page 52 Q show schedule details on page 188 Q show schedules on page 190 Q show task details on page 201 Q show tasks on page 205 delet...

Page 72: ...snap pool before you can delete it Input Example Delete snap pool SP1 Related Commands Q show master volumes on page 180 Q show snap pools on page 194 delete snap pool volume Parameter Description vo...

Page 73: ...ed and associated space in the snap pool is freed for use Alias of delete volume Input Example Delete snapshot SS1 Related Commands Q delete snapshot write data on page 75 Q show snapshots on page 196...

Page 74: ...the state when it was first taken Input Example Delete modified data from snapshot SS1 Related Commands Q delete snapshot on page 74 Q show snapshots on page 196 delete snapshot write data volume Para...

Page 75: ...sk is scheduled you must delete the schedule first Input Example Delete task Task1 Related Commands Q create task on page 56 Q delete schedule on page 72 Q show task details on page 201 Q show tasks o...

Page 76: ...including the default users Input Example Delete user jsmith Related Commands Q create user on page 59 Q set user on page 135 Q show users on page 206 delete user name noprompt Parameter Description n...

Page 77: ...d with a master volume on another virtual disk You cannot delete a virtual disk that is reconstructing Input Example Delete two virtual disks delete vdisk vdisks prompt yes no Parameter Description vd...

Page 78: ...Chapter 3 Command Descriptions 79 Related Commands Q show master volumes on page 180 Q show vdisks on page 208...

Page 79: ...e having ID 5 from virtual disk VD1 Related Commands Q show disks on page 154 Q show vdisks on page 208 delete vdisk spare disks disk vdisk Parameter Description disks disk Specifies the vdisk spares...

Page 80: ...scription Deletes a volume Input Example Delete volume V1 Related Commands Q show volumes on page 215 delete volume volume Parameter Description volume Specifies the volume to delete For the syntax to...

Page 81: ...82 Phoenix RPC12 Series CLI Reference Manual September 2008 exit Description Exits the CLI session Syntax exit...

Page 82: ...o a standard volume by using convert master to std 3 Expand the standard volume by using expand volume 4 Convert the expanded volume to a master volume by using convert std to master Input To expand a...

Page 83: ...x RPC12 Series CLI Reference Manual September 2008 Example Expand V1 by 100 Gbyte Related Commands Q expand vdisk on page 85 Q show snap pools on page 194 Q show volumes on page 215 expand volume V1 s...

Page 84: ...on drive type RAID level and other factors Table 3 2 Virtual Disk Expansion by RAID Level RAID Level Expansion Capability Maximum Drives NRAID non RAID Cannot expand 1 0 3 5 6 You can add 1 4 drives a...

Page 85: ...ed Commands Q show disks on page 154 Q show vdisks on page 208 expand vdisk vdisk disks disks Parameter Description vdisk Specifies the virtual disk by name or serial number For the syntax to use see...

Page 86: ...g convert master to std 3 Expand the standard volume by using expand volume 4 Convert the expanded volume to a master volume by using convert std to master Input To expand a volume to a specific size...

Page 87: ...x RPC12 Series CLI Reference Manual September 2008 Example Expand V1 by 100 Gbyte Related Commands Q expand vdisk on page 85 Q show snap pools on page 194 Q show volumes on page 215 expand volume V1 s...

Page 88: ...es the host channels to map and LUNs to assign For the syntax to use see Volume Mapping Syntax on page 26 host host Optional If this parameter is omitted mapped volumes for all hosts are shown For FC...

Page 89: ...read write access Map volume V2 to channels 0 1 and LUN 2 on host HBA1 and permit read only access Related Commands Q show host maps on page 169 Q show host wwn names on page 175 Q show volumes on pag...

Page 90: ...packets to the remote computer at 10 0 0 1 ping host address count Parameter Description host address Specifies the remote host s IP address in dotted decimal form count Optional Specifies the number...

Page 91: ...Commands Q show channels on page 143 reset host channel link channel channels controller a b both Parameter Description channel channels Specifies a host channel number or a comma separated list of ho...

Page 92: ...Reset snapshot SS1 reset snapshot volume prompt yes no Parameter Description volume Specifies the volume by its name or serial number For the syntax to use see Volume Syntax on page 25 prompt yes no O...

Page 93: ...94 Phoenix RPC12 Series CLI Reference Manual September 2008 Related Commands Q show snapshots on page 196...

Page 94: ...ily lost until it successfully restarts If the restart fails the partner management controller remains active with full ownership of operations and configuration information Caution If you restart bot...

Page 95: ...xample Restart the management controller in controller module A Related Commands Q shutdown on page 218 restart mc a During the restart process you will briefly lose communication with the specified m...

Page 96: ...ust restart the RAID controllers and management controllers for the changes to take effect After restarting the controllers hosts might not be able to access volumes until you re map them Caution This...

Page 97: ...d the snapshot is lost Create a snapshot of the master volume as it currently exists before performing a rollback Input rollback master volume volume snapshot volume modifiedsnapshot yes no prompt yes...

Page 98: ...196 prompt yes no Optional Specifies an automatic response to the unmount prompt that either enables the rollback to proceed or prevents the rollback from proceeding yes Enable the rollback to procee...

Page 99: ...copies the primary to the secondary In addition this command scrubs virtual disk metadata and stripe and NRAID virtual disks When scrub of a virtual disk is complete an event is logged specifying the...

Page 100: ...troller failure enable disable If the cache policy is set to write back specify whether the policy automatically changes to write through when a controller fails super cap failure enable disable If th...

Page 101: ...ture exceeded enable disable Specify whether to force a controller shutdown if a temperature is detected that exceeds system threshold limits partner notify enable disable In a dual controller configu...

Page 102: ...for a fault tolerant environment because it improves the performance of write operations and throughput Write back caching is enabled by default Q Write through caching significantly impacts performa...

Page 103: ...ize setting You can however specify a different stripe size for any volume at the time you create it For more information see create volume on page 64 Input set cache parameters independent enable dis...

Page 104: ...e of the read 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 Maximum Allow...

Page 105: ...e shown as human readable console output or as XML output console is the default api sets the output to XML base 2 10 Optional Specifies whether capacities are calculated and shown in base 2 or base 1...

Page 106: ...Chapter 3 Command Descriptions 107 Example Set CLI to use a 30 second timeout base 2 and no paging Related Commands Q show cli parameters on page 146 set cli parameters timeout 30 base 2 pager disable...

Page 107: ...ed Commands Q show controller date on page 149 set controller date jan feb mar apr may jun jul aug sep oct nov dec day hh mm ss year time zone Parameter Description jan feb mar apr may jun jul aug sep...

Page 108: ...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 se...

Page 109: ...ace debug messages dms Snapshot feature debug messages emp Enclosure Management Processor debug messages fca Fibre Channel driver debug messages level A fcb Fibre Channel driver debug messages level B...

Page 110: ...ted Commands Q show debug log parameters on page 152 Q show debug log on page 150 standard Sets the messages to host on disk on mem off fo on msg on fca on fcb off fcc off fcd off misc on rcm off raid...

Page 111: ...nges to the SMART setting take effect after a rescan or a controller reboot Input Example Set the SMART setting to enable Related Commands Q show drive parameters on page 157 set drive parameters smar...

Page 112: ...e status on page 158 set expander fault isolation wwn enclosure controller a b both enable disable Parameter Description wwn enclosure Specifies the 16 hex digit logical identifier of the controller e...

Page 113: ...er enable disable Parameter Description wwn enclosure Specifies the 16 hex digit logical identifier of the controller enclosure or expansion enclosure containing the PHY to be enabled or disabled The...

Page 114: ...drive status to global spare Input Example Designate the disk drive having ID 5 as a global spare Related Commands Q delete global spare on page 68 Q show disks on page 154 set global spare disks dis...

Page 115: ...hich automatically changes for the partner host channel on the other controller Valid values for FC 2g 4g Valid values for iSCSI 10mb 100mb 1g If you change a parameter on controller A channel 0 then...

Page 116: ...ress in IPv4 format gateway address Optional iSCSI only Specifies the gateway address in IPv4 format noprompt Optional Specifies an automatic response to the confirmation prompt that enables the opera...

Page 117: ...bility to access LUNs from some hosts will be limited Are you sure yes set host parameters channel all fibre connection mode loop controller a WARNING You have requested a change on host channel param...

Page 118: ...hen the connection between peer host ports is enabled it forms an FC AL loop This command affects the connections between all host port pairs In order to enable the connections the host port fibre con...

Page 119: ...Q create host wwn name on page 48 Q delete host wwn name on page 69 Q show host wwn names on page 175 set host wwn name host wwn nickname new nickname Parameter Description host wwn nickname Specifie...

Page 120: ...ands Q create iscsi host on page 49 Q delete iscsi host on page 70 Q show iscsi hosts on page 176 set iscsi host descriptor new nickname Parameter Description descriptor Specifies an iSCSI host initia...

Page 121: ...high Parameter Description background scrub enabled on disabled off Optional Controls whether vdisks are checked for disk drive defects to ensure system health partner firmware upgrade enabled on dis...

Page 122: ...put Example Set the Power Activity Fault LED on drive module 5 Unset the Unit Locator LEDs on the controller enclosure set led disk enclosure ID on off Parameter Description disk ID Specifies a disk d...

Page 123: ...address netmask netmask gateway gateway controller a b Parameter Description dhcp Optional Specifies to use DHCP to determine the enclosure s IP address ip address Optional Specifies the enclosure s...

Page 124: ...osure network parameters using DHCP Statically set network parameters for controller A Related Commands Q show network parameters on page 182 set network parameters dhcp set network parameters ip 192...

Page 125: ...racters except backslash quotation mark apostrophe or spaces The password is case sensitive Input Example Change the password of the default user monitor set password user Parameter Description user O...

Page 126: ...the prompt for the current CLI session Input Output Command line with new prompt Example Set the prompt to set prompt prompt Parameter Description prompt Specifies the new prompt string A string that...

Page 127: ...p http https service ses smis snmp ssh telnet Optional Specifies the protocol to enable or disable capi In band CAPI management interface debug Telnet debug port 4048 ftp Firmware upgrade interface ht...

Page 128: ...on volume Specifies the volume by its name or serial number For the syntax to use see Volume Syntax on page 25 error autoexpand deleteoldestsnapshot deletesnapshots haltwrites notifyonly nochange Opti...

Page 129: ...Q show snap pools on page 194 autoexpansionsize sizeMB GB TB Specifies the increment in MB Mbyte GB Gbyte or TB Tbyte by which the snap pool will be automatically expanded when the threshold level is...

Page 130: ...cal This third threshold indicates that the snap pool is nearly full and that data loss is imminent When exceeded an event is generate to alert the administrator and the associated snap pool policy is...

Page 131: ...132 Phoenix RPC12 Series CLI Reference Manual September 2008 Related Commands Q set snap pool policy on page 129 Q show snap pools on page 194...

Page 132: ...fo none Optional Sets the level of trap notification crit Sends critical events only warn Sends all critical events and warnings info Sends all events none All events are excluded from trap notificati...

Page 133: ...tains a space enclose the value in quotation marks Input Example Set the system name to Test and the contact to J Doe Related Commands Q show system on page 200 set system name value contact value loc...

Page 134: ...nal Specifies the user s level of technical expertise to control access to functionality in the WBI standard Enables access to standard administrative functions This is the default for monitor users a...

Page 135: ...type and interface access Related Commands Q create user on page 59 Q delete user on page 77 Q set password on page 126 Q show users on page 206 set user jsmith type diagnostic interfaces wbi cli Succ...

Page 136: ...set vdisk vdisk name new name owner a b Parameter Description vdisk Specifies the virtual disk by name or serial number For the syntax to use see Virtual Disk Syntax on page 25 name new name Optional...

Page 137: ...replace the smallest disk drive in the virtual disk Input Example Designate the disk drive having ID 5 as a vdisk spare for virtual disk VD1 Related Commands Q show disks on page 154 Q show vdisks on...

Page 138: ...how volumes on page 215 Q show host maps on page 169 Q show volume maps on page 213 set volume volume name new name Parameter Description volume Specifies the volume by its name or serial number For t...

Page 139: ...rite through Alias show awt Input Output Shows whether each trigger is enabled or disabled Example Show the system s trigger settings Related Commands Q set auto write through trigger on page 101 show...

Page 140: ...ription Operation Mode The volume s operation mode Possible values are Unknown Standalone Single Port Standalone Dual Port Active Active Single Port Active Active Active Pass Dual Port A A Dual Port M...

Page 141: ...for volume V1 Related Commands Q set cache parameters on page 103 Q show volumes on page 215 show cache parameters V1 Cache Parameters Operation Mode Active Active Volume Serial 00c0ff0a48880048fd834...

Page 142: ...L Fibre Channel Arbitrated Loop FC Not applicable SAS Serial Attached SCSI iSCSI iSCSI Channel Topo C FC only Configured topology Speed A Actual host channel link speed FC 2G 4G Auto SAS 1 5G 3G 6G i...

Page 143: ...2008 IP Ver iSCSI only IPv4 IP iSCSI only Primary IP address IP S Address iSCSI only Secondary IP address This field is only displayed during failover MAC Unique Media Access Control MAC hardware add...

Page 144: ...2G Down A 3 Host FC P PTP 2G 2G Down A 0 Drive SAS Up A 1 Drive SAS Up B 0 Host FC P PTP 2G 2G Down B 1 Host FC P PTP 2G 2G Down B 2 Host FC P PTP 2G 2G Down B 3 Host FC P PTP 2G 2G Down B 0 Drive SA...

Page 145: ...value in seconds for the login session Output Format console Output is shown in human readable console format api Output is shown in XML format Base 2 Capacities are shown in base 2 which uses 1024 as...

Page 146: ...er Serial Number Hardware Version CPLD Version MAC Address Node WWN IP Address IP Subnet Mask IP Gateway Disk Drives Present Virtual Disks Cache Memory Size MB Host Channels Host Bus Type Drive Channe...

Page 147: ...each virtual disk See show vdisks on page 208 SES and ENCLOSURE COMPONENTS Show general SCSI Enclosure Services SES information followed by component specific information See show enclosure status on...

Page 148: ...he system s current date and time Input Output Example Show the system date and time Related Commands Q set controller date on page 108 show controller date Field Description Controller Date Day date...

Page 149: ...debug log sem trace log entries show debug log task log entries show debug log all Parameter Description mc Specifies to show MC debug logs entries Optional Specifies the number of MC logs to show whi...

Page 150: ...Specifies the number of semaphore log entries to show If this parameter is omitted all semaphore log entries are shown task log Specifies to show the MC task status at the time this command is issued...

Page 151: ...disk Disk interface debug messages mem Internal memory debug messages fo Failover recovery debug messages msg Inter controller message debug messages fca fcb fcc fcd Four levels of Fibre Channel driv...

Page 152: ...meters Related Commands Q set debug log parameters on page 109 Q show debug log on page 150 capi2 Internal Configuration API tracing debug messages dms Snapshot feature debug messages show debug log p...

Page 153: ...isk vdisk Parameter Description disks free all encl vdisk vdisk Optional Specifies the disk drives to report information about disks Specifies the disk drives For the syntax to use see Disk Drive Synt...

Page 154: ...is in progress RCON The vdisk is being reconstructed VRFY The vdisk is being verified VRSC The vdisk is being scrubbed Type Disk drive type SAS or SATA Size GB Disk drive capacity in Gbyte Rate Gb s...

Page 155: ...page 208 show disks 0 0 2 4 ID Serial Vendor Rev State Type Size GB Rate Gb s SP 0 KRVN03ZAG4ZPPD ATA AD1A AVAIL SATA 500 3 0 2 KRVN03ZAGA88PD ATA AD1A AVAIL SATA 500 3 0 4 KRVN03ZAG4L22D ATA AD1A VDI...

Page 156: ...Shows the SMART setting Input Output Example Show drive parameter settings Related Commands Q set drive parameters on page 112 show drive parameters Field Description SMART Shows whether SMART is enab...

Page 157: ...es SES information followed by component specific information Input Output General SES fields show enclosure status Field Description Chassis Chassis serial number Vendor Name of enclosure vendor Prod...

Page 158: ...supply see Figure 3 1 For the location of each disk slot see Figure 3 2 Status Component status Absent Component is not present Fault One or more subcomponents has a fault OK All subcomponents are ope...

Page 159: ...al September 2008 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 Figure 3 2 Drive Module Disk Slot Numbering...

Page 160: ...nknown Voltage 02 Absent Unknown Unknown Voltage 03 OK FRUHE01 FSCITOR 0607NR012C voltage 12 370V Voltage 04 OK FRUHE01 FSCITOR 0607NR012C voltage 5 500V Voltage 05 OK FRUHE01 FSCITOR 0607NR012C volta...

Page 161: ...sequence matches the actual event sequence within about one second If SNMP is configured events can be sent to SNMP traps Input To show a certain number of events To show events by date To show events...

Page 162: ...ecified event ID If this number is larger than the ID of the oldest event events are shown up to the latest event This parameter can be used with either from parameter a b error Optional Specifies to...

Page 163: ...133 Q show snmp parameters on page 198 Severity CRITICAL Events that might affect data integrity or system stability WARNING Events that do not affect data integrity INFORMATIONAL Events that show th...

Page 164: ...enclosure Input Output show expander status Parameter Description Id Identifier for a specific PHY lane Encl Enclosure that contains the SAS expander Status OK No errors detected on the PHY lane ERRO...

Page 165: ...ow expander status SAS Status Controller A Id Encl Status Type 0 0 OK DRIVE 1 0 OK DRIVE 2 0 OK DRIVE 3 0 OK DRIVE 4 0 OK DRIVE 5 0 OK DRIVE 6 0 OK DRIVE 7 0 OK DRIVE 8 0 OK DRIVE 9 0 OK DRIVE 10 0 OK...

Page 166: ...cooling controller expansion and drive modules connect RAID_IOM Controller module BOD_IOM Expansion module POWER_SUPPLY Power and cooling module Description FRU description Part Number FRU part number...

Page 167: ...wer and cooling module Configuration SN A customer specific configuration serial number FRU Status Component status Absent Component is not present Fault One or more subcomponents has a fault OK All s...

Page 168: ...ickname or 16 hex digit WWPN For iSCSI Specifies the IP address in IPv4 or IPv6 format or a nickname For the nickname syntax to use see Host Nickname Syntax on page 26 Field Description WWN Host WWPN...

Page 169: ...w 0 1 R0_1_V1 00c0ff0a427d0048466dc04501000000 0 5 rw 0 1 R0_2_V1 00c0ff0a427d00484f28f54501000000 0 2 ro 0 1 R0_2_V2 00c0ff0a427d00489528f54501000000 0 6 ro 0 1 Host IP 10 11 10 101 Name AndiamoP4 Ma...

Page 170: ...rbitrated Loop SAS Serial Attached SCSI iSCSI iSCSI Channel Topo C FC Configured topology Speed A Actual host channel link speed FC 2G 4G Auto SAS 1 5G 3G 6G Auto iSCSI 10Mb 100Mb 1G Blank if not appl...

Page 171: ...172 Phoenix RPC12 Series CLI Reference Manual September 2008 Netmask iSCSI Netmask IP address Gateway iSCSI Gateway IP address Service Port Service Port Field Description...

Page 172: ...opo C Speed A Speed C Status PID SID A 0 Host FC L Loop 2G 2G Up 0 A 1 Host FC L Loop 2G 2G Down B 0 Host FC L Loop 2G 2G Down B 1 Host FC L Loop 2G 2G Up 1 show host parameters Host Parameters Ctlr A...

Page 173: ...Description Shows the status of the internal connection between FC host port pairs Input Example Show the status of the host port interconnect Related Commands Q set host port interconnects on page 11...

Page 174: ...Example Show host WWNs and nicknames assigned to them Related Commands Q create host wwn name on page 48 Q delete host wwn name on page 69 Q set host wwn name on page 120 show host wwn names Field Des...

Page 175: ...mmands Q create iscsi host on page 49 Q delete iscsi host on page 70 Q set iscsi host on page 121 show iscsi hosts Field Description Host IP iSCSI host initiator s IP address in IPv4 format Name iSCSI...

Page 176: ...utomatically checked for disk drive defects to ensure system health Partner Firmware Upgrade Shows whether component firmware versions are monitored and will be automatically upgraded on the partner c...

Page 177: ...pshots Number of snapshots allowed without an installed license Max Snapshots Number of snapshots allowed by the installed license Platform Max Snapshots Number of snapshots that the highest level lic...

Page 178: ...mple 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...

Page 179: ...er volumes associated with a specified snap pool volume name or serial number For the syntax to use see Volume Syntax on page 25 Field Description Vdisk Virtual disk name Serial Master volume serial n...

Page 180: ...ster to std on page 46 Q convert std to master on page 47 Q delete all master volumes on page 66 Q delete master volume on page 71 Q rollback master volume on page 98 show master volumes snap pool SP1...

Page 181: ...each RAID controller Input Output show network parameters Field Description IP Address Controller IP address Gateway Controller gateway Subnet Mask Controller subnet mask MAC Address Controller s uniq...

Page 182: ...n page 124 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 Par...

Page 183: ...port name WWPN for each host channel Input Output Example Show port WWNs for both controllers show port wwn Field Description CTRL Controller CH Host channel number WWN World wide port name WWPN show...

Page 184: ...ls show protocols Service and Security Protocols Web Browser Interface HTTP Enabled Secure Web Browser Interface HTTPS Enabled Command Line Interface Telnet Enabled Secure Command Line Interface SSH E...

Page 185: ...ne Dual Port Active Active Single Port Active Active Active Pass Dual Port A A Dual Port Multi ID and Independent Cache Performance Mode Redundancy Status Redundant Operation Both controllers are oper...

Page 186: ...dancy status show redundancy mode System Redundancy Redundancy Mode Active Active Redundancy Status Redundant Operation Controller A Status Operational Controller A Serial Number 00C0FF0A4318 Controll...

Page 187: ...rameter Description schedule Specifies the schedule name Field Description Schedule Name Schedule name Schedule Specification Parameters of the schedule Schedule Status Ready or Active Next Time The n...

Page 188: ...ls 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 Task To Run T1 Error Message Schedule unable to execute Task...

Page 189: ...2 Q create task on page 56 Q show schedule details on page 188 show schedules Field Description Schedule Name Schedule name Task To Run Task name Next Time The next time the task will run or none if t...

Page 190: ...w sensor status Field Description Sensor Name Where the sensor is located Value The value of the sensor Status Component status Absent Component is not present Fault One or more subcomponents has a fa...

Page 191: ...OK CM Temperature Lower Ctlr B 38 OK Power Supply 1 Temperature 38 OK Power Supply 2 Temperature 40 OK Capacitor Pack Voltage Ctlr A 8 29 OK Capacitor Pack Voltage Ctlr B 8 25 OK Capacitor Cell 1 Vol...

Page 192: ...are shut down Input Output Message stating whether each controller is up operating or down shut down Example Show the shutdown status for each controller Related Commands Q restart on page 95 Q shutdo...

Page 193: ...p pool name Size Total size of the snap pool volume Free Amount of free space available in this snap pool MasterVols Number of master volumes associated with this snap pool Snapshots Number of snapsho...

Page 194: ...n page 73 Q expand snap pool on page 83 Q set snap pool policy on page 129 Q set snap pool threshold on page 131 show snap pools Vdisk Serial Name Size Free MasterVols Snapshots NP 00c0ff0a48930048ea1...

Page 195: ...ied master volume name or serial number For the syntax to use see Volume Syntax on page 25 snap pool volume Optional Only includes snapshots associated with the specified snap pool name or serial numb...

Page 196: ...t of preserved and write data that is unique to the snapshot SharedData Amount of preserved and write data that is shared between this snapshot and other snapshots show snapshots snap pool SP2 Vdisk S...

Page 197: ...n is disabled SNMP Filter Critical Only critical events are sent as traps Warning All critical events and warnings are sent as traps Informational All events are sent as traps None No events are sent...

Page 198: ...e Show SNMP notification settings Related Commands Q set snmp parameters on page 133 show snmp parameters SNMP SNMP enabled SNMP Filter Critical Warning SNMP Trap Host IP1 172 22 4 171 SNMP read commu...

Page 199: ...ystem Description Shows information about the system Input Output Q System Name Q System Contact Q System Location Q System Information Q Vendor Name Q Product ID Q Product Brand Q SCSI Vendor ID Q En...

Page 200: ...f the task Init Vol Verified License Checked Name Created Snap Created Snap Verified Master Volume Name Master volume name Master Volume Serial Volume serial number Snapshot prefix Label identifying t...

Page 201: ...tatus of the task Ready Active Task State The current state of the task Init Vol Verified Name Created Vol Created Source Volume Name Name of the volume to be copied Source Volume Serial Serial number...

Page 202: ...Vdisk Name VD2 Destination Vdisk Serial 00c0ffd270280048b68ecf4500000000 Destination Volume Prefix Copy Include Modified Data false Last Copy Created none Error Message none show task details T1 Task...

Page 203: ...ix RPC12 Series CLI Reference Manual September 2008 Related Commands Q create schedule on page 52 Q create task on page 56 Q delete task on page 76 Q show schedule details on page 188 Q show tasks on...

Page 204: ...reate schedule on page 52 Q delete task on page 76 Q show schedule details on page 188 Q show task details on page 201 show tasks Field Description Task Name Task name Task Type Task type TakeSnapshot...

Page 205: ...ss to selected user interfaces User Type Applies to the WBI only Standard Has access to standard administrative functions Advanced Has access to standard and advanced functions Diagnostic Has access t...

Page 206: ...Chapter 3 Command Descriptions 207 Related Commands Q create user on page 59 Q delete user on page 77 Q set user on page 135 Q show users on page 206...

Page 207: ...or serial number For the syntax to use see Virtual Disk Syntax on page 25 If this parameter is omitted information is shown for all virtual disks Field Description Name Virtual disk name Size Virtual...

Page 208: ...uarantined because some drives are missing QROF The vdisk is offline and has been quarantined because some drives are missing UP The vdisk is online and does not have fault tolerant attributes Jobs DR...

Page 209: ...2 Series CLI Reference Manual September 2008 Related Commands Q abort create on page 38 Q create vdisk on page 61 Q delete vdisk on page 78 Q expand vdisk on page 85 Q set vdisk on page 137 Q show vdi...

Page 210: ...rameter Description controller a b Optional Shows volume copy operations for volumes owned by controller A upper or controller B lower only If this parameter is omitted all volume copy operations are...

Page 211: ...212 Phoenix RPC12 Series CLI Reference Manual September 2008 Related Commands Q abort volumecopy on page 41 Q volumecopy on page 226...

Page 212: ...is omitted information for all volumes is shown Field Description SN Volume serial number Name Volume name CH Host channels that volume is mapped on ID Host channel ID LUN Logical unit number Access A...

Page 213: ...8f54501000000 Name R0_2_V1 mapping view CH ID LUN Access Host Port Identifier Nickname 0 1 0 25 rw 10 11 10 101 AndiamoP4 0 1 0 26 rw 10 10 10 102 AndiamoP5 0 1 0 2 ro all other hosts Volume SN 00c0ff...

Page 214: ...For the syntax to use see Virtual Disk Syntax on page 25 class standard ptsnap Optional Specifies the class of volumes to show type snap pool mastervolume snapshot standard Optional Specifies the typ...

Page 215: ...k Volume Name Size WR Policy Class Volume Serial Number Cache Opt Type VD1 V1 10 0GB writeback standard 00c0ff0a43180048aff0074501000000 standard standard show volumes vdisk VD1 Vdisk Volume Name Size...

Page 216: ...3 Command Descriptions 217 Related Commands Q create volume on page 64 Q delete volume on page 81 Q expand volume on page 87 Q set volume on page 139 Q show vdisks on page 208 Q show volume maps on p...

Page 217: ...shut down before removing a controller module or powering down the system Caution You can continue to use the CLI when either or both RAID controllers are shut down but information shown might be inv...

Page 218: ...rap at the screen width without truncating output but turning On hard wrapping ensures this rows Specifies the number of rows that a terminal can display The terminal usually sets this value this is a...

Page 219: ...stamps to differ which the system interprets as a problem with the late disks In this case the virtual disk functions normally after being trusted Q A virtual disk is offline because a drive is faili...

Page 220: ...n trust virtual disk VD1 vdisk vdisk Specifies the virtual disks by name or serial number For the syntax to use see Virtual Disk Syntax on page 25 trust enable Trust Virtual disk Enabled trust vdisk V...

Page 221: ...me Specifies the volume by its name or serial number For the syntax to use see Volume Syntax on page 25 mapping mapping Specifies the host to volume mapping For the syntax to use Volume Mapping Syntax...

Page 222: ...Chapter 3 Command Descriptions 223 Related Commands Q map volume on page 89 Q show host maps on page 169 Q show host wwn names on page 175 Q show volumes on page 215 Q show volume maps on page 213...

Page 223: ...sks the command compares the primary and secondary drives and if it finds a mismatch it copies the primary to the secondary Input Example Verify two virtual disks Related Commands Q abort verify on pa...

Page 224: ...w versions Input Output Q Storage Controller CPU Type Q Storage Controller Firmware Q Storage Controller Memory Q Storage Controller Loader Q Management Controller Firmware Q Management Controller Loa...

Page 225: ...use see Virtual Disk Syntax on page 25 dest vdisk vdisk Specifies the destination virtual disk by name or serial number For the syntax to use see Virtual Disk Syntax on page 25 modified snapshot yes...

Page 226: ...Chapter 3 Command Descriptions 227 Related Commands Q abort volumecopy Q create task on page 56 Q show vdisks on page 208 Q show volumecopy status on page 211 Q show volumes on page 215...

Page 227: ...228 Phoenix RPC12 Series CLI Reference Manual September 2008...

Page 228: ...e other takes on the entire task Dual active controllers are connected to the same set of storage devices improving both I O performance and failure tolerance compared to a single controller SNIA addr...

Page 229: ...uration API channel A physical path used for the transfer of data and control information between storage devices and a RAID controller or a host or a SCSI bus in a controller module The terms channel...

Page 230: ...one disk drive is simultaneously written to another disk drive If one disk fails the other disk can be used to run the virtual disk and reconstruct the failed disk The primary advantage of disk mirror...

Page 231: ...disk drives and one or two expansion modules See expansion module expansion module A FRU that contains host expansion and management ports an Enclosure Management Processor and midplane connectivity...

Page 232: ...cted Many systems provide fault tolerance by using RAID architecture to give protection against loss of data when a single disk drive fails Using RAID 1 3 5 10 or 50 techniques the RAID controller can...

Page 233: ...RU Gbyte Gigabyte GB global spare A spare disk drive that is available to all virtual disks in a system HBA See host bus adapter HBA host bus adapter HBA An I O adapter that connects a host I O bus to...

Page 234: ...t SNIA For example a LUN identifies the mapping between a volume logical unit and a host port target loop address Indicates the unique ID of a node in FC loop topology A loop address is sometimes refe...

Page 235: ...device does its FC communication node loop port NL_Port An N_Port that can operate on FC AL topology Non RAID The RAID level option that can be used for a virtual disk having a single disk drive and...

Page 236: ...he controller s minimum resources to high which uses the controller s maximum resources RAID Redundant Array of Independent Disks a family of techniques for managing multiple disks to deliver desirabl...

Page 237: ...a snapshot taken of that volume SAN See Storage Area Network SAN SAS Serial Attached SCSI SATA Serial Advanced Technology Attachment SC See storage controller SC SCSI Small Computer System Interface A...

Page 238: ...t and retrieval of data the setting or writing of data and traps that signal the occurrence of events SNIA spare See dynamic spare global spare vdisk spare standard volume A volume that is not enabled...

Page 239: ...k Abbreviation for virtual disk vdisk spare A disk drive that is marked as a spare to support automatic data rebuilding after a disk drive associated with a virtual disk fails For a vdisk spare to tak...

Page 240: ...rive WWNs from the serial numbers of controller modules and expansion modules world wide node name WWNN A globally unique 64 bit identifier assigned to each Fibre Channel node process SNIA world wide...

Page 241: ...rite 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 Write performance with a write through cache is appr...

Page 242: ...127 command completion 27 editing 27 history 27 syntax 24 command line interface See CLI commands CLI and user 32 configuration and utilities 34 event notification 34 service utilities 35 snapshot 33...

Page 243: ...ts set 119 show setting 174 host WWPN change nickname 120 create nickname for 48 delete nickname 69 set nickname 120 show 184 show nickname 175 host map volume to 89 host test communication with 91 I...

Page 244: ...ts using 15 security protocols enable disable 128 show status 185 service protocols enable disable 128 show status 185 shutdown status show 193 single command mode 15 size of devices and logical units...

Page 245: ...creation of 38 abort scrub 39 abort verification 40 add disk drives 85 bring online for emergency data collection 220 create 61 delete 78 expand 85 name 25 scrub for disk defects 100 See also vdisk se...

Reviews: