HP MPX200 Multifunction Router Remote Command Line Interface User Guide Abstract This document describes how to use the Remote Command Line Interface (Remote CLI or simply RCLI) to configure and manage the HP MPX200 Multifunction Router. It is intended for personnel who are responsible for installing and servicing an HP MPX200 Multifunction Router and the SAN equipment to which it is attached.
© Copyright 2012–2013 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents 1 Getting started...........................................................................................7 Firmware requirements..............................................................................................................7 Obtaining help........................................................................................................................7 Command line scripting......................................................................................................
help......................................................................................................................................27 list array................................................................................................................................27 list host..................................................................................................................................28 list initiator..........................................................................
set time.................................................................................................................................61 set vlan.................................................................................................................................62 set vp_group..........................................................................................................................62 show append....................................................................................
pause migration.....................................................................................................................96 remove dm_group...................................................................................................................96 remove dml............................................................................................................................97 remove migration...........................................................................................
1 Getting started This chapter provides information to help you get started using the Remote CLI utility. For instructions to install the Remote CLI, see the Readme file for the utility. Firmware requirements Some RCLI router management commands or their keywords require that you install a minimum version of the router firmware. If a minimum firmware version is required, it is noted in the description of that specific command or keyword.
Executing script files The execute script command accepts a text file containing a series of Remote CLI commands to be run in sequence. For more information, see “execute script” (page 25). Saving script files After you finish setting up a new router, or whenever you save an FRU image, HP recommends that you save the configuration script.
Table 1 Remote CLI sample scripts (continued) Folder name Description script_csv This folder contains scripts for automated migration of a large number of LUNs based on input from a migration planning spreadsheet. A csv file can display (for example, in a spreadsheet) the output (results) of the execution of the Remote CLI script. The script_csv example does just the opposite, that is, the spreadsheet is used to generate the RCLI script.
Command line syntax The following Remote CLI syntax rules apply: • Begin all commands with rcli; for example, rcli show time. • Remote CLI input is not case sensitive. Examples in this guide are shown in lowercase; however, you can interchangeably use uppercase. • Run either Linux shell scripts or Windows batch files to specify command selection and input parameters using an all-text command line syntax. • Start the command line with an action and include an item on which to perform the action.
identifying the FCIP route you want to modify. When you add a new FCIP route, fixed default values are used because there is no existing route from which to get defaults. For example, if you do not specify an MTU size, normal is the default. The view log command is a good example of persistent data use. If you issue a command to display the previous ten log entries, the current position in the log file is saved.
2 General keywords This chapter provides the description and syntax for keywords that apply to all commands. Because these keywords are defined here, they are not repeated for every command in the command reference chapters. General keywords The keywords in this section apply to all commands. -blade Use the -blade keyword to specify the primary or secondary router blade (MPX200 only). When specified, the blade selection is saved for future use as the default.
c:\> rcli show system -help=help.doc -ip Use the -ip keyword to specify the IPv4 or IPv6 management port address of the MPX200 Multifunction router. If not specified, the default is either the last value specified or 10.0.0.1. NOTE: This keyword is required for most commands. Syntax -ip=IPv4 or IPv6 address Examples To specify an IPv4 address: -ip=10.0.0.1 To specify an IPv6 address: -ip=2001::1234 -pw Use the -pw keyword to provide the RPC password, if one has been set.
Examples To create a show_system.dat file in the working directory: c:\> rcli show system /result To create a show_system_January2012.dat file in the working directory: c:\> rcli show system /result = show_system_January2012.dat -show_only_error Similar to the -quiet keyword, the -show_only_error keyword suppresses all text output from the command except for error messages. Syntax -show_only_error -textfile Use the -textfile keyword to append normal display text and error messages to a specified file.
3 Command reference This chapter provides the description, syntax, specific keywords, and examples of the RCLI commands. The commands are listed in alphabetic order. NOTE: Keywords that apply to all commands are not listed in this chapter. The general keywords described in “General keywords” (page 12) are optional for every command in this chapter.
-mtu_size= Specifies the MTU size for the iSCSI port. Values are: • min (minimum) • normal (default) • max (maximum) • jumbo (jumbo frames) • An integer ranging from 582 to 9000 -port_speed= Specifies the port speed in Mb/s. Values are: • auto (default) • 100 • 1000 • 10000 -swcompress_enable= Enables use of software compression for the newly-created route. • yes (default) • no • on • off • true • false -tcp_port= Specifies the TCP port number ranging from 1024 to 65535. The default value is 3225.
Example c:\>rcli add fcip_route -fc_port=1 -enable=yes -ge_port=1 -local_ip=10.0.0.10 -gateway_ip=10.0.0.1 -remote_ip=10.0.2.10 -mtu_size=normal -tcpwindow=16777216 -port_speed=auto -bandwidth=20 -vlan_enable=y -swcompress_enable=n /ip=10.0.0.12 FCIP route successfully set add initiator The add initiator command adds an initiator to the list known to the router. Syntax add initiator Keywords -chap_enable= Specifies that CHAP is enabled for this initiator.
-wwnn= Specifies the world wide node name of a Fibre Channel initiator. -wwpn= Specifies the world wide port name of a Fibre Channel initiator. Example c:\> rcli add initiator -wwpn=2101-00E0-8B3A-E348 -wwnn=2001-00E0-8B3A-E348 -ostype=win2k8 /ip=10.0.0.12 FC Initiator successfully added, (WWPN: 2101-00E0-8B3A-E348) add lunmask The add lunmask command adds a LUN mask to the list known to the router. A LUN mask enables a specified initiator to use a specified LUN.
-lun_eui=2, 3 Specifies the LUN EUI. -lun_naa=2, 3 Specifies the LUN NAA designator. -lun_number= 2, 3 -lun_serial= Specifies the LUN for which you want to add a LUN mask. Specifies the LUN Page 0x80 serial number. The serial number can contain special characters. To ensure that these characters are interpreted correctly when running in a Linux shell, enclose the input text for Page 0x80 serial numbers in single quotation marks (not double quotation marks).
Leave blank to disable email notifications. -event= Specifies the event type that triggers sending email to the list of recipients. If this keyword is not specified, the default is either all or dm_all, depending on the profile type. Event types include: • Use event type all, warning, and error with profile -type=default and -type=fcip. • Use event types dm_all, dm_warning, and dm_error with profile -type=dm. -http= Specifies that the notification is to be posted to an HTTP server.
connect system The connect system command verifies that the RPC connection to a router works for a specified IP address. Syntax connect system -ip=IPv4 or IPv6 IP address Example c:\> rcli connect system -ip=10.0.0.12 create host The create host command adds a host to the list known to the router. Syntax create host Keywords -host_id Specifies the symbolic name for the new host. -ostype Optional.
Syntax destroy host Keywords -host_id Specifies the symbolic name for the new host. For an explanation of the general keywords that apply to all commands, see “General keywords” (page 12) Examples c:\>rcli destroy host -host_id=myHost /ip=10.0.0.12[10.0.0.12] Host successfully removed disable beacon The disable beacon command disables flashing the router LEDs. Syntax disable beacon Example c:\> rcli disable beacon /ip=10.0.0.12 [10.0.0.
-array_with_is_target= Specifies the iSCSI target name of the storage array for which you want to stop collecting data. -array_with_lun_any_wwuln= Specifies the WWULN, T10, NAA, EUI, or Page 0x80 serial number of the storage array LUN for which you want to stop collecting data. -array_with_lun_eui=1 Specifies the EUI of the storage array LUN for which you want to stop collecting data. -array_with_lun_naa=1 Specifies the NAA of the storage array LUN for which you want to stop collecting data.
disable iscsi_port The disable iscsi_port command disables the specified iSCSI port. Syntax disable iscsi_port Keyword Specifies the port number of the iSCSI port to disable. -port Example c:\>rcli disable iscsi_port -port=1 /ip=10.0.0.12 iSCSI Port 1 successfully disabled discover iscsi_target The discover iscsi_target command discovers iSCSI targets at a specified IP address. NOTE: This command is supported with router firmware Version 3.2.3.0 or later.
Syntax enable beacon Example c:\> rcli enable beacon /ip=10.0.0.12 [10.0.0.12] Beacon successfully turned ON enable fc_port The enable fc_port command enables the specified Fibre Channel port. Syntax enable fc_port -port=port number Example c:\> rcli enable fc_port -port=1 /ip=10.0.0.12 FC Port 0 successfully enabled enable iscsi_port The enable iscsi_port command enables the specified iSCSI port.
Script "config_script.txt" completed OK find system The find system command broadcasts to discover either a specified router or all routers. Syntax find system Keyword -product= Specifies the router type to broadcast for in the local network. Similar products may also be found. For example, specifying either -product=iSR6200 or -product=iSR6250 discovers all MPX200 products. When this keyword is used, it can take approximately 25 seconds to complete.
-array_with_lun_naa=1 Specifies the NAA of the storage array LUN to which to apply the commands in this script. -array_with_lun_serial=1 Specifies the Page 0x80 serial number of the storage array LUN to which to apply the commands in this script. -array_with_lun_tten=1 Specifies the T10 designator of the storage array LUN to which to apply the commands in this script. -array_with_lun_wwuln=1 Specifies the WWULN of the storage array LUN to which to apply the commands in this script.
To view detailed information for a single storage array, use the show array command. See “show array” (page 63). Syntax list array Examples c:\> rcli list array /ip=10.0.0.12 [10.0.0.12] Array count = 1 -array_wwpn=0000-0100-0100-0000 list host The list host command lists the names of all hosts known to the router. To view detailed information for a specific host, use the show host command instead. Syntax list host Keywords This command has no specific keywords.
list log The list log command displays all log data from a file or a running system, filtered according to severity and search text. NOTE: To view a limited set of log data, use the view log command. Syntax list log If neither -find nor -severity keywords are specified, all log entries are displayed. Keywords -csv_delimiter= If used with -csv_file, specifies use of a delimiter other than comma (,). -csv_file= Specifies the name of a file to receive comma separated text.
VP Group 4 -lun_number=0 -vpgindex=4 -fc_target=5001-4380-025D-A83A Target "5001-4380-025D-A83E" VP Group 1 ... list presented The list presented command lists the names of all presented targets known to the router. TIP: To view details for a specific presented target, use the show presented command. Syntax list presented Example c:\> rcli list presented /ip=10.0.0.12 [10.0.0.
Syntax list vlan Example c:\> rcli list vlan /ip=10.0.0.12 [10.0.0.12] -port=1 -port=2 -port=3 -port=4 -port=1 -port=2 -port=3 -port=4 -ipv4 -ipv4 -ipv4 -ipv4 -ipv6 -ipv6 -ipv6 -ipv6 -enable=yes -id=32 -priority=2 -enable=no -enable=no -enable=no -enable=no -enable=no -enable=no -enable=no list vp_group The list vp_group command lists the names of all VP groups known to the router. NOTE: TIP: This command is not supported for MPX100 routers.
• true • false -chap_secret= Specifies the CHAP password. This keyword is ignored if CHAP is not enabled. -is_target Specifies the iSCSI target to log into at the specified IP address. -iscsi_ipaddr Specifies the IPv4 or IPv6 address of the iSCSI target. -tcp_port= Specifies the TCP port to use on the iSCSI target. The value must be in the range of 1024 to 65534. If this keyword is not used, the default is port 3260. Example c:\> rcli login iscsi_target -port=1 -iscsi_ipaddr=10.0.0.5 /ip=10.0.0.
Keywords -fc_port Specifies the Fibre Channel port number, where the first port is 1. -wwnn= Specifies the FC target WWNN. If the -fc_port keyword is used and this keyword is not, the router uses the default WWNN for the presented Fibre Channel target. -wwpn= Specifies the FC target WWPN. If the -fc_port keyword is used and this keyword is not, the router uses the default WWPN for the presented Fibre Channel target.
Example c:\> rcli map target -fc_target=5001-4380-025C-C7D8 -ge_port=1 -vpgindex=1 /ip=10.0.0.12 Target 5001-4380-025C-C7D8 successfully mapped to Ethernet port 1 merge csv The merge csv command collects input from multiple files and combines them into a new csv file using output from the show io_statistics or show performance commands. You can import the csv file into a spreadsheet program such as Microsoft Excel.
-gateway_ip= Specifies the IPv4 gateway address or the IPv6 default router address. The default is as currently set on the router. -ge_port= Specifies the Ethernet port number. The default is as currently set on the router. -ipv4_subnet= Specifies the IPv4 subnet mask to be associated with -local_ip. NOTE: This keyword is ignored if -local_ip is an IPv6 address. -local_ip= Specifies the local IPv4 or IPv6 address. -mtu_size= Specifies the MTU size for the iSCSI port.
-uselinklocal1 Specifies that the IPv6 link local address is used for the local end of this FCIP route. -vlan_enable= Enables use of a VLAN for the newly-created route. Values are: • yes (default) • no • on • off • true • false The default is as currently set on the router. 1 You can specify either the -local_ip or -uselinklocal keyword, but not both. Example c:\> rcli modify fcip_route -fc_port=1 -vlan_enable=n /ip=10.0.0.
modify initiator The modify initiator command changes the OS type for an existing initiator. Syntax modify initiator Keywords -fc_initiator= Required, unless the -is_initiator keyword is used instead. Specifies the Fibre Channel initiator name for which you want to add a LUN mask. -is_initiator= Required, unless the -fc_initiator keyword is used instead. Specifies the iSCSI initiator name for which you want to add a LUN mask. -ostype= Optional for both iSCSI and Fibre Channel initiators.
Example c:\> rcli modify migration -dm_jobid=0 -owner=blade_2 /ip=10.0.0.12 [10.0.0.12] Data migration job 0 sucessfully changed owner to blade 2 modify notification The modify notification command changes an existing notification profile. Syntax modify notification -name=notification profile name NOTE: You must use the -http keyword, the -email keyword, or both to specify the notification method for this profile.
Example c:\>rcli modify notification -name="my profile" -event=dm_all -http /ip=10.0.0.12 Notification "my profile" successfully modified ping system The ping system command issues a ping through either the management port or one of the GbE ports. Syntax ping system -ping_ipaddr=IPv4 or IPv6 address Keywords -packet_size= Specifies the ping packet size in bytes. The default value is 56. -port= Specifies the outbound port either as a number for an Ethernet port, or as mgmt for the management port.
Keywords -file=1 Specifies the name of a file that contains either the binary or text unique ID for RCLI. If a directory is not specified with the filename, the default is the working directory. 1 Specifies as a text string the unique ID for RCLI. -id= 1 You can use either the -id or -file keyword, but not both. If neither keyword is used, this command creates a default, unique identifier for RCLI. Example c:\> rcli register system -file=rcli_id.
remove fcip_route The remove fcip_route command removes one FCIP route. Syntax remove fcip_route -fc_port=Fibre Channel port number NOTE: The router must be capable and licensed for FCIP. To view router capabilities, issue the show features command. Example c:\> rcli remove fcip_route -fc_port=1 /ip=10.0.0.12 [10.0.0.12] FCIP route successfully removed remove initiator The remove initiator command deletes an existing initiator.
If this keyword is not used, the command displays detailed information for all storage arrays. -array_with_fc_target= Specifies the Fibre Channel target WWPN of the LUN mask that you want to remove. -array_with_is_target= Specifies the iSCSI target name of the LUN mask that you want to remove. -array_with_lun_any_wwuln= Specifies the WWULN, T10, NAA, EUI, or Page 0x80 serial number of the LUN mask that you want to remove. -array_with_lun_eui=1 Specifies the EUI of the LUN mask that you want to remove.
NOTE: To use this command with the -lun_serial, -lun_wwuln, -lun_eui, -lun_naa, or -lun_any_wwuln keyword requires router firmware version 3.2.3.0 or later. Example c:\> rcli remove lunmask -is_initiator=iqn.1991-05.com.microsoft:abcdef12 -lun_number=1 -vpgindex=1 -fc_target=5001-4380-025D-A83A /ip=10.0.0.12 [10.0.0.12] Lun Mask successfully removed remove notification The remove notification command deletes an existing notification profile.
Keyword Indicates a file name to receive the report text. -file= If no directory is specified, the file is saved in the current working directory. If this keyword is not used, the report is displayed on the console. Example c:\> rcli report log -file=logreport.txt Report saved successfully to file: "logreport.txt" rescan system The rescan system command scans LUNs for a specified target or storage array, or for all targets known to the router. NOTE: This command requires router firmware Version 3.2.3.
Syntax reset_factory system Keyword -full_reset Specifies that the management port IP address is changed after the router reboots. If this keyword is not used, the management port IP address does not change, even after the router reboots. Examples c:\> rcli reset_factory -ip=10.0.0.12 c:\> rcli reset_factory system -full_reset /ip=10.0.0.12 [10.0.0.
Syntax retval system Keyword Specifies a return value from a previously executed RCLI command. -rv Example c:\> rcli retval system -rv=140 RCLI_OK save capture_file The save capture_file command collects a file that contains diagnostic information for the router. Syntax save capture_file Keyword Specifies the name of the file to be created. -file If the specified file name does not end with .tar.gz, this command appends .tar.gz to the file name.
FRU config file saved successfully save log The save log command retrieves log data from the router and saves it to a file. Syntax save log —file=
If this keyword is not used, the output appears on the console. You can use any keywords with assigned values suitable for the command specified by the -cmd keyword. They are included as specified on every line of the script. You can use keywords with assigned values starting with csv_ are iteratively assigned a value from the specified column of the csv file. Values are: • csv_a • csv_b • csv_c • csv_a . . . • csv_z Example c:\> rcli script csv -cmd="add migration" -csv_file=c:\temp\mydata.
set array The set array command configures the name, bandwidth, and data migration target type for a storage array. NOTE: Unless the command line keywords are limited to -name and -dm_target_type only, you must specify the -dm_target_type as source, destination, or both_src_and_dest. Syntax set array Keywords -array_wwpn= Specifies the WWPN of the storage array that you want to configure. -array_with_fc_target= Specifies the Fibre Channel target WWPN of the storage array that you want to configure.
• on • off • true • false The default is the current setting on the router. -max_concurrent_io Specifies the maximum quantity of concurrent I/Os that the router issues to the specified array. Values are: • 32 • 64 • 128 • 256 The default is the current setting on the router. NOTE: This keyword is supported with keyword router firmware 3.3.1.0 or later. Specifies a symbolic name to apply to this storage array. -name= The default is the current setting on the router.
set fc The set fc command sets the link rate for a specified Fibre Channel port. Syntax set fc -port=port number Keyword -fc_link_rate= Specifies a new link rate in gigabits per second for the specified Fibre Channel port. Values are: • auto • 2Gb • 4Gb • 8Gb The default is the current setting on the router. Example c:\> rcli set fc -port=1 -fc_link_rate=auto /ip=10.0.0.
FC1 advanced info successfully configured set features The set features command sets the license key to enable extended features on the router. Syntax set features -key=license key Example c:\> rcli set features -key=abcdef /ip=10.0.0.12 [10.0.0.
Example c:\> rcli set iscsi -port=1 -ipv4_static -ipv4_addr=10.0.0.5 /ip=10.0.0.12 iSCSI Port 1 basic info successfully configured set iscsi_adv The set iscsi_adv command sets an advanced iSCSI port configuration. Syntax set iscsi_adv Keywords -port= Specifies the port number for the iSCSI port that you want to configure. -bandwidth= Specifies a bandwidth limit for the iSCSI port.
-mtu_size Specifies the MTU size for the iSCSI port. Values are: • min (minimum) • normal (default) • jumbo (jumbo frames) • max (maximum) • an integer in the range of 582–9000 The default value is set on the router. -tcpwindow Specifies the TCP window size for the iSCSI port. The default value is set on the router. The maximum TCP window size must be: • a power of 2 (for example, 8192 or 16384) • ≤ 16777216 for firmware version 3.3.0.
The default is the current setting on the router. -isns_ipaddr Specifies the IPv4 or IPv6 port address. The default is the current setting on the router. Specifies the iSNS port number. -isns_port The default is the current setting on the router. Example c:\> rcli set isns -enable=y -isns_ipaddr=10.0.0.10 -isns_port=1026 /ip=10.0.0.12 iSNS successfully configured set mgmt The set mgmt command sets the management port IP addresses.
set notification The set notification command configures notifications, including IP addresses and port numbers for SMTP servers, and contact information such as phone number, street address, and email addresses. NOTE: Specify one IPv4 or IPv6 address each for the primary and secondary SMTP servers. Syntax set notification Keywords -contact_email= Specifies the contact email address. Default is as currently set on the router. -email= Enables or disables e-mail notifications.
-ipv6_site_addr= Specifies the site-local IPv6 address for the iSCSI port. Default is the current setting on the router. -phone= Specifies the contact phone number. Default is as currently set on the router. -replyto_email= Specifies the reply to email address for generated messages. Default is as currently set on the router. -street= Specifies the contact street address. Default is as currently set on the router. -tcp_port= Specifies the TCP port number on the mail server.
Example c:\> rcli set ntp -enable=yes -ntp_ipaddr=10.0.0.100 -tz_hours=-8 -tz_mins=0 /ip=10.0.0.12 NTP -index=0 successfully configured set password The set password command changes the RPC or data migration password for the router. After you change a password, you must include the /pw=xxxxx keyword in all subsequent command lines. If you change the password back to the default value, commands will no longer require the /pw=xxxxx keyword. NOTE: line.
Example c:\> rcli set presented -chap_enable=yes -chap_secret="my password" -is_target=iqn.1986-03.com.qlogic:fcgw.mpx200.0823e00014.b2.02.50014987625da3 24 /ip=10.0.0.12 CHAP secret successfully enabled for iSCSI Presented Target iqn.1986-03.com.qlogic:fcgw.mpx200.0823e00014.b2.02.50014987625da324 set snmp The set snmp command sets the SNMP parameters. Syntax set snmp Keywords -auth_enable= Specifies if authentication is enabled or disabled for SNMP.
The default is the current setting on the router. -trap_version= Specifies the SNMP trap version. Values are 1, 2, or 3. The default is the current setting on the router. Example c:\> rcli set snmp -location="Server Room" -contact=admin@widget.com -auth_enable=n -trap_index=0 -trap_enable=yes -trap_ipaddr=10.0.0.10 -trap_port=1026 /ip=10.0.0.
• true • false The default is the current setting on the router. Specifies a symbolic name for the router. -name= The name can be blank, or contain a maximum of 63 alphanumeric characters, spaces, and symbols. Specifies whether SSH is enabled or disabled for the router. Values are: -ssh= • yes • no • on • off • true • false The default is the current setting on the router. -target_access_control= Specifies whether target access control is enabled or disabled.
Syntax set time Keywords -gmt= Specifies that the router time is set using the input treated as Greenwich Mean Time in the format MM/DD/YYYY HH:MM:SS. -local= Specifies that the router time is set using the input treated as a local time in the format MM/DD/YYYY HH:MM:SS. -use_local_time Specifies that the router time is set to the same time as is currently on the local system.
NOTE: This command is not supported for MPX100 routers. Syntax set vp_group -vpgindex=index number Keywords -enable= Specifies whether VP group names are allowed. Values are: • yes • no • on • off • true • false The default is the current setting on the router. Specifies a new name for the VP group indicated by the -vpindex keyword. The default is the current setting on the router. -name= Example c:\> rcli set vp_group -vpgindex=1 -enable=yes -name="MyVpGroup" /ip=10.0.0.
Keywords -array_wwpn= Specifies the WWPN of the storage array for which you want to view detailed information. If this keyword is not used, the command displays detailed information for all storage arrays. -array_with_fc_target= Specifies the Fibre Channel target WWPN of the storage array for which you want to view detailed information. -array_with_is_target= Specifies the iSCSI target name of the storage array for which you want to view detailed information.
Example c:\> rcli show chassis /ip=10.0.0.12 [10.0.0.
WWPN = 2103-00C0-DD12-F95C WWNN = 2003-00C0-DD12-F95C Port ID = 01-13-04 show fc_adv The show fc_adv command displays detailed information (including the frame size, execution throttle, connection type, and port mode) for the selected Fibre Channel port or all Fibre Channel ports. Syntax show fc_adv Keywords -port Specifies the Fibre Channel port number for which you want to view advanced information. If no port number is specified, advanced information is displayed for all Fibre Channel ports.
NOTE: The router must be capable and licensed for FCIP. Syntax show fcip_route Keywords -fc_port= Specifies the Fibre Channel port for which to display FCIP route information. If this keyword is not used, the command displays information for all FCIP routes. Example c:\> rcli show fcip_route /ip=10.0.0.12 [10.0.0.
IP Rcvd Packets IP Rcvd Byte Count IP Rcvd Fragments IP Datagram Reassembly Count IP V6Pkt Rcvd IP Error Packets IP Reassembly Errors TCP Xmit Segment Count TCP Xmit Byte Count TCP Xmit Acks TCP Rcvd Segment Count TCP Rcvd Byte Count TCP Rcvd Acks TCP Rcvd Window Probes TCP Timer Expired TCP ECC Error Corrections MAC Xmit Frames MAC Xmit Bytes MAC Xmit Multi Count MAC Xmit Broad Count MAC Xmit Pause Count MAC Xmit Control Frames MAC Xmit Deferrals MAC Xmit Late Collisions MAC Xmit Aborted MAC Xmit Multiple
FCIP SACK DM Offline DM Online DM Capacity DM Array Capable Capable Capable Capable Capable No License Needed No License Needed No License Needed 10240 GB Issued, 0 GB Used, 0 GB In-Use 9 Array Issued, 1 Used show host The show host command displays detailed information for a single host. To view all hosts known to the router, use the list host command instead. Syntax show host Keywords -host_id Specifies the symbolic name for the host.
CHAP is Disabled CHAP Secret = Portal = 0 Operational State = Logged Out Initiator Device Path = No port specified Discovery Method = NAME_SERVER Operating System Type = Microsoft Windows Server 2003 Initiator is NOT Mapped show io_statistics The show io_statistics command displays I/O statistics for a single LUN or for all LUNs, starts the collection of statistics when initially enabled and displays the output in a comma-delimited format suitable for import into a spreadsheet program such as Microsoft Exc
-fc_target=2 Specifies the Fibre Channel target name. -is_target=2 Specifies the iSCSI target name. -lun_any_wwuln= Accepts the LUN name in a variety of formats that are interpreted first as WWULN, and then as the T10, NAA, EUI, and Page 0x80 serial number designator until at least one LUN is found. -lun_eui=3 Specifies the LUN EUI. -lun_naa=3 Specifies the LUN NAA designator. -lun_number= 3 -lun_serial= Specifies the LUN for which you want to view statistics.
Keywords -port= Specifies the port number for the iSCSI port for which you want to view basic information. If this keyword is not used, basic information is displayed for all iSCSI ports. Example c:\> rcli show iscsi /ip=10.0.0.12 [10.0.0.12] Port = GE1 Port Status = Enabled Link Status = Down Flow Control = Disabled Number of open connections = 0 iSCSI Port name = iqn.1986-03.com.hp:fcgw.mpx200.0823e00014.b1.0 Firmware Revision = 3.00.01.
Syntax show iscsi_statistics Keywords -csv_folder= If used, an individual file containing csv is created for each port. Files are created, or appended to if they already exist. Example c:\>rcli show iscsi_statistics /ip=10.0.0.12 [10.0.0.
IP Datagram Reassembly Count IP Error Packets 0 0 0 0 0 show isns The show isns command displays iSNS information, including the IP address and port number for the server, and whether this feature is enabled. Syntax show isns Example c:\> rcli show isns /ip=10.0.0.12 [10.0.0.12] -enable=no show lun The show lun command displays detailed information either for a single LUN or for all LUNs known to the router.
-array_with_lun_tten=1 Specifies the T10 designator of the storage array LUN for which you want to view detailed information. -array_with_lun_wwuln=1 Specifies the WWULN of the storage array LUN for which you want to view detailed information. -array_with_name= Specifies the symbolic name of the storage array for which you want to view detailed information. -fc_target=2 Limits the list to the LUNs from the specified Fibre Channel target.
NOTE: If none of the optional keywords are used, detailed information is displayed for all LUN masks known to the router. If a LUN, VP group, and target are all specified, LUN masks are displayed for all initiators for a single LUN. If only one or two keywords are used, detailed information is displayed for all LUN masks that match the input. For example, if only -vpgindex is used, detailed information is displayed for all LUN masks relating to any LUNs on any targets that are in that VP group.
-lun_eui=4 Specifies the LUN EUI. -lun_naa=4 Specifies the LUN NAA designator. -lun_number= 4 -lun_serial= Specifies the LUN for which you want to view detailed LUN mask information. Specifies the LUN Page 0x80 serial number. The serial number can contain special characters. To ensure that these characters are interpreted correctly when running in a Linux shell, enclose the input text for Page 0x80 serial numbers in single quotation marks (not double quotation marks).
show notification The show notification command displays the notification feature configuration and one or more profiles. Each profile lists email addresses to which notices are sent if a specific event occurs. Syntax show notification Keywords -name= Specifies a notification profile name. If this keyword is not used, all profiles are displayed. Example c:\> rcli show notification -name="my Profile" /ip=10.0.0.12 [10.0.0.
The default value is 2 seconds. Example c:\> rcli show performance /ip=10.0.0.12 Port Bytes/s Bytes/s Bytes/s Number (init_r) (init_w) (tgt_r) ------ ---------------------GE1 0 0 0 GE2 0 0 0 GE3 0 0 0 GE4 0 0 0 FC1 0 0 0 FC2 58MB 58MB 0 Bytes/s (tgt_w) -------0 0 0 0 0 0 Bytes/s (total) -------0 0 0 0 0 117.81MB show presented The show presented command displays detailed information about one or more presented targets, or for all presented targets associated with a specified physical target.
Syntax show snmp Example c:\> rcli show snmp /ip=10.0.0.12 [10.0.0.12] -read_community=public -trap_community=private -location="Server Room" -contact=admin@widget.com -auth_enable=no -trap_index=0 -trap_ipaddr=10.0.0.10 -trap_port=1026 -trap_version=0 show status The show status command displays status information for the router. Syntax show status Example c:\> rcli show status /ip=10.0.0.12 [10.0.0.12] Sequence Number = 4 Alarm Status = Off Hardware Status = 0 Temperature at Board Front = 0x35, 53 C.
Telnet = Enabled SSH = Enabled show target The show target command displays detailed information for a single target. If you do not specify a target, detailed information is displayed for all targets. TIP: To view all targets known to the router, use the list target command. Syntax show target Keywords -fc_target=1 Specifies the name of the Fibre Channel target for which you want to view detailed information.
Syntax show vlan Keywords -ipv41 Specifies to use IPv4. 1 -ipv6 Specifies to use IPv6. -port= Specifies the iSCSI port number. 1 Only one of these keywords can be used on the same command line. Example c:\> rcli show vlan -port=1 /ip=10.0.0.12 [10.0.0.12] IPv4 VLAN ENABLED, VLAN ID = 32, VLAN Priority = 2 show vp_group The show vp_group command displays detailed information for a single VP group. NOTE: TIP: This command is not supported for MPX100 routers.
Example c:\> rcli -port=1 /ip=10.0.0.12 [10.0.0.
Keywords Specifies the number of times to ping at each hop. -count= If this keyword is not used, the default ping count is 3. Specifies the outbound port as mgmt for the management port. -port= This keyword is optional, but if used, it must specify the outbound port as mgmt. Example c:\> rcli tracert system -port=mgmt -ping_ipaddr=10.0.0.11 /ip=10.0.0.12 1) 10.0.0.
Target 5001-4380-025C-C7D8 successfully unmapped from Ethernet port 1 unregister system The unregister system command unregisters RCLI as the management client for the router. However, if another application is registered as the management client for the router, this command can fail. You can use the -force keyword to ensure that this command succeeds. Syntax unregister system Keywords -file=1 Specifies the name of a file that contains either the binary or text unique ID for RCLI.
Version 1.73.0.0.0.0 view log The view log command displays a limited portion of the log data. A position context is maintained in persistent data. Use the keywords to navigate to a specific range of the log data and display a limited number of records before or after this point. NOTE: If you do not use the -basepos and -offset keywords, the position is updated after each view command for use as the future default. If you use the -basepos keyword without specifying an -offset, the offset defaults to zero.
Enter the date and time in the format ”MM/DD/YYYY HH:MM:SS”. 1 The -time, -find, and -severity keywords are search options that start from the position after -basepos and -offset are evaluated and look for a match in the previous direction. If used in combination, they are evaluated in this order: -time, -find, and then -severity.
Keyword -seconds= Specifies the wait time in seconds. If this keyword is not used, the default delay time is 5 seconds.
4 Data Migration commands Data migration is a block-level, online and offline feature introduced in the MPX200 data transport device. The HP StorageWorks MPX Manager utility provides this optional, licensed feature to simplify data migration jobs for almost zero downtime, while providing protection against common user errors. Before you use data migration commands, ensure that: • The router is running firmware version 3.2.3.0 or later. • The router is capable of performing data migration.
Example c:\> rcli add dm_group -name="My Group" /ip=10.0.0.12 [10.0.0.12] nl Data Migration Job Group "My Group" successfully added add dml The add dml command adds a LUN to the list of data management LUNs on the router. LUN identifiers are not necessarily unique to a single LUN. If combined with other keywords, it is possible that the LUN keywords can refer to more than one LUN.
-lun_tten=3 Specifies the LUN T10 designator. -vpgindex= Specifies the VP group index number for the new data management LUN. 1 Do not combine the keywords -array_with_lun_serial, -array_with_lun_wwuln, -array_with_lun_tten, -array_with_lun_eui, and -array_with_lun_naa. To specify any LUN, use the -array_with_lun_any_wwuln 2 3 keyword. You can use either the -fc_target or the -is_target keyword, but not both. Do not combine the keywords -lun_serial, -lun_wwuln, -lun_tten, -lun_eui and -lun_naa.
This command requires router firmware version 3.3.0.0 or later for scrubbing LUNs and thin-provisioned destination LUNs. If the specified source or destination keyword matches more that one array, the command fails because there can be only one source array and one destination array. Keywords -array_wwpn= Specifies the WWPN of the source storage array. -array_with_fc_target= Specifies the Fibre Channel target WWPN of the source storage array.
-dmdest_vpgindex= Specifies the destination virtual port group. -dm_io_size= Specifies the I/O size, in kilobytes, to use for data migration. Values are: • 32 • 64 (default) • 128 • 512 • 1024 -fc_target= Specifies the source array as a Fibre Channel target. -group= Specifies the name of a data migration job group. If this keyword is not used, the default value is Group 0. -is_target= Specifies the source array as an iSCSI target.
Do not use this keyword for compare jobs. 1 Do not combine the keywords -array_with_lun_serial, -array_with_lun_wwuln, -array_with_lun_tten, -array_with_lun_eui, and -array_with_lun_naa. To specify any LUN, use the -array_with_lun_any_wwuln 2 keyword. Do not combine the keywords: -dmdest_array_with_lun_serial, -dmdest_array_with_lun_wwuln, -dmdest_array_with_lun_tten, -dmdest_array_with_lun_eui, and -dmdest_array_with_lun_naa.
Syntax list dm_group Example c:\> rcli list dm_group /ip=10.0.0.12 [10.0.0.12] Data Migration Group count = 1 -name="Group 0" list dm_log The list dm_log command displays all data migration log data from a file or a running system and optionally, saves output to a csv file. Syntax list dm_log Keywords -csv_delimiter= When used with the -csv_file keyword, specifies the use of a delimiter other than comma (,). -csv_file= Specifies the name of a file to receive comma-separated text.
Keyword -state= Specifies the status of data migration jobs to view. Values are: • running • paused • failed • completed • serial scheduled • all If this keyword is not used, all jobs are listed. Example c:\> rcli list migration /ip=10.0.0.12 [10.0.0.12] -dm_jobid=0 HP HSV200-0:VPG1:002 to NETAPP LUN-1:VPG1:002 Completed modify dm_group The modify dm_group command changes the name of a data migration job group.
Example c:\> rcli remove dm_group -name="My Group" /ip=10.0.0.12 [10.0.0.12] Data Migration Job Group "My Group" successfully removed remove dml The remove dml command removes a LUN from the list of data management LUNs on the router. Some of the identifying keywords are not necessarily unique to a single LUN and can apply to to more than one LUN. This command requires that you select a specific LUN; therefore, if the keywords specified match more than one LUN, you must use additional keywords.
Example c:\> rcli remove dml -lun_number=2 -vpgindex=1-fc_target=5001-4380-025D-A83A /ip=10.0.0.12 [10.0.0.12] Data Management LUN -lun_number=2 -vpgindex=1 -fc_target=5001-4380-025D-A83A successfully removed. remove migration The remove migration command removes a specified data migration job from the router. Syntax remove migration -dm_jobid=data migration job ID Example c:\> rcli remove migration -dm_jobid=0 /ip=10.0.0.12 [10.0.0.
Example c:\> rcli save dm_log -file=dmlogdata.dat [10.0.0.12] Data Migration Log saved successfully to file: "dmlogdata.dat" save dm_report The save dm_report command creates a file that contains data migration job reports for the router. NOTE: This command is not supported for MPX100 routers. This command requires router firmware Version 3.3.0.0 or later. Syntax save dm_report -name= Keywords -file= Specifies the name of file to be created. If the specified file name does not end with .tar.
Example c:\> rcli show dm_group -name="Group 0" /ip=10.0.0.12 [10.0.0.12] DM Job Group "Group 0" show dml The show dml command displays detailed information for a single DML or for all DMLs known to the router. If none of the optional keywords are used, detailed information is displayed for all LUNs known to the router. Some identifiers are not necessarily unique to a single LUN.
-lun_number=2 Specifies the LUN for which you want to view detailed information. -lun_serial=3 Specifies the LUN Page 0x80 serial number. The serial number can contain special characters. To ensure that these characters are interpreted correctly when running in a Linux shell, be sure to enclose the input text for Page 0x80 serial numbers in single quotation marks (not double quotation marks). -lun_tten=3 Specifies the LUN T10 designator. -lun_wwuln=3 Specifies the LUN WWULN.
Delta time (End-Start) = 15 sec Source LUN ID = LUN 1 on storage array 0000-0100-0100-0000 Source WWULN = 6005-08B4-0007-4838-0001-2000-017B-0000 Destination LUN ID = LUN 2 on storage array 0000-0200-0100-0000 Destination WWULN = NETAPP LUN HnS-aJV6WgMN DM Job Type = Online data migration DM Schedule Type = Start Now Priority = 0 Migration Owner = 1 Source LUN Start LBA = 00 Source LUN End LBA = 0c7fffff Destination LUN Start LBA = 00 start migration The start migration command starts a specific data migra
upload dm_report The upload dm_report command retrieves a file containing data migration job reports for the router, and then uploads the file to a specified server url. NOTE: This command is supported with router firmware 3.3.0.0 and later. Syntax upload dm_report -url=URL of server for HTTP notifications Keywords -password= Specifies the password (if needed) to access the server at the specified web address.
Specifies the offset position after processing this command. -offset= 1 -previous= Specifies the number of data migration log entries after all positioning keywords have been evaluated. The initial default is 20. A value of -1 displays all entries before the current position in the log after evaluating the -basepos, -offset, and -time keywords. -offset= Specifies the offset position after processing this command.
5 Support and other resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.com/support Before contacting HP, collect the following information: • Product model names and numbers • Technical support registration number (if applicable) • Product serial numbers • Error messages • Operating system type and revision level • Detailed questions Related information For additional information, see the following websites: • http://www.hp.
TIP: Provides helpful hints and shortcuts.
6 Documentation feedback HP is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback (docsfeedback@hp.com). Include the document title and part number, version number, or the URL when submitting your feedback.
A Commands by category RCLI commands Category Commands Append “set append” (page 48) “show append” (page 63) Arrays “list array” (page 27) “remove array” (page 40) “set array” (page 49) “show array” (page 63) Beacon “disable beacon” (page 22) “enable beacon” (page 24) Chassis “set chassis” (page 50) “show chassis” (page 64) CSV “merge csv” (page 34) “script csv” (page 47) Display “clear display” (page 20) FCIP routes “add fcip_route” (page 15) “modify fcip_route” (page 34) “remove fcip_route”
Category Commands “show host” (page 69) I/O statistics “disable io_statistics” (page 22) “show io_statistics” (page 70) Initiators “add initiator” (page 17) “list initiator” (page 28) “modify initiator” (page 37) “remove initiator” (page 41) “show initiator” (page 69) iSCSI ports “disable iscsi_port” (page 24) “enable iscsi_port” (page 25) “set iscsi” (page 52) “set iscsi_adv” (page 53) “show iscsi” (page 71) “show iscsi_adv” (page 72) “show iscsi_statistics” (page 72) iSCSI targets “discover iscsi
Category Commands “show ntp” (page 78) Password “set password” (page 58) Performance “show performance” (page 78) Scripts “execute script” (page 25) “generate script” (page 26) “save script” (page 47) “script csv” (page 47) SNMP “set snmp” (page 59) “show snmp” (page 79) Statistics “disable io_statistics” (page 22) “show fc_statistics” (page 66) “show fcip_statistics” (page 67) “show io_statistics” (page 70) “show iscsi_statistics” (page 72) Status “show status” (page 80) Systems “connect sys
Category Commands “wait time” (page 87) VLANs “list vlan” (page 30) “set vlan” (page 62) “show vlan” (page 81) Virtual port groups “list vp_group” (page 31) “set vp_group” (page 62) “show vp_group” (page 82) Zoning “show zone” (page 82) Data Migration commands Table 3 Data Migration commands Category Command Data Management LUNs “add dml” (page 90) “remove dml” (page 97) “show dml” (page 100) Data Migration Groups “add dm_group” (page 89) “list dm_group” (page 94) “modify dm_group” (page 96) “r
B API error codes The retval command displays a description of a specified return value. Table 4 (page 112) describes the error codes that the API can return when parsing the retval command input or producing command output. NOTE: Error codes that start with QAPI_E_ indicate a problem that prevented the command from working. Error codes that start with QAPI_S_ indicate that the command succeeded with the specified warning.
Table 4 API error codes returned by the retval command (continued) Error Description QAPI_E_INVALID_DM_JOB_TYPE Use QRouter::addScrubLUNJob() to add a scrub LUN job. QAPI_E_INVALID_DM_SCHED_TYPE Data migration schedule type must be either start now or manual start. QAPI_E_INITIATOR_PART_OF_ARRAY Initiator is part of an array. QAPI_E_UNKNOWN_ERROR Error status received from router does not correspond to a QAPI_RETURN value.
Glossary A array A storage system that contains multiple disk or tape drives. A disk array, for example, is differentiated from a disk enclosure, in that the array has cache memory and advanced functionality, like RAID and virtualization. Components of a typical disk array include disk array controllers, cache memories, disk enclosures, and power supplies. B bandwidth A measure of the volume of data that can be transmitted at a specified transmission rate.
iSCSI Internet small computer system interface. Transmits native SCSI over the TCP/IP stack. In a system supporting iSCSI, a user or software application issues a command to store or retrieve data on a SCSI storage device. The request is processed by the operating system and is converted to one or more SCSI commands that are then passed to software or to a card. The command and data are encapsulated by representing them as a serial string of bytes proceeded by iSCSI headers.
S SAN Storage area network. A network of storage devices and the initiators that store and retrieve information on those devices, including the communication infrastructure. Secure Shell See SSH. SNMP Simple Network Management Protocol. A networking protocol that enables you to monitor the router using third-party applications SSH Secure Shell. A protocol that secures connections to the switch for the command line interface. T target The storage-device endpoint of a SCSI session.
Index A acknowledge migration, 89 add dm_group, 89 add dml, 90 add fcip_route, 15 add initiator, 17 add lunmask, 18 add migration, 91 add notification, 19 array, 114 B bandwidth, 114 C CHAP, 114 clear display, 20 clear dm_log, 94 clear dm_report, 94 clear log, 20 commands ?, 15 acknowledge migration, 89 add dm_group, 89 add dml, 90 add fcip_route, 15 add initiator, 17 add lunmask, 18 add migration, 91 add notification, 19 clear display, 20 clear dm_log, 94 clear dm_report, 94 clear log, 20 connect system,
set password, 58 set presented, 58 set snmp, 59 set system, 60 set time, 61 set vlan, 62 set vp_group, 62 show append, 63 show array, 63 show chassis, 64 show dm_group, 99 show dml, 100 show fc, 65 show fc_adv, 66 show fc_statistics, 66 show fcip_route, 66 show fcip_statistics, 67 show features, 68 show host, 69 show initiator, 69 show io_statistics, 70 show iscsi, 71 show iscsi_adv, 72 show iscsi_statistics, 72 show isns, 74 show lun, 74 show lunmask, 75 show mgmt, 77 show migration, 101 show notification,
list vlan, 30 list vp_group, 31 login iscsi_target, 31 logout iscsi_target, 32 LUN, 115 M map global_iscsi_target, 32 map target, 33 merge csv, 34 modify dm_group, 96 modify fcip_route, 34 modify host, 36 modify initiator, 37 modify migration, 37 modify notification, 38 multipath routing, 115 P path, 115 pause migration, 96 ping system, 39 R reboot system, 39 register system, 39 remove array, 40 remove dm_group, 96 remove dml, 97 remove fcip_route, 41 remove initiator, 41 remove lunmask, 41 remove migrat
U unmap global_iscsi_target, 84 unmap target, 84 unregister system, 85 update firmware, 85 upload dm_report, 103 V version system, 85 view dm_log, 103 view log, 86 W wait time, 87 websites HP , 105 WWNN, 116 WWPN, 116 WWULN, 116 Z zoning, 116 120 Index
