Hp MPX200 Multifunction Router User Manual

HP MPX200 Multifunction Router RemoteCommand Line InterfaceUser GuideAbstractThis document describes how to use the Remote Command Line Interface (Rem

Command line syntaxThe following Remote CLI syntax rules apply:• Begin all commands with rcli; for example, rcli show time.• Remote CLI input is not c

Examplec:\> rcli show dm_group -name="Group 0" /ip=10.0.0.12[10.0.0.12]DM Job Group "Group 0"show dmlThe show dml command displ

Specifies the LUN for which you want to view detailed information.-lun_number=2Specifies the LUN Page 0x80 serial number.-lun_serial=3The serial numbe

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

upload dm_reportThe upload dm_report command retrieves a file containing data migration job reports for therouter, and then uploads the file to a spec

Specifies the offset position after processing this command.-offset=Specifies the number of data migration log entries after all positioning keywordsh

5 Support and other resourcesContacting HPFor worldwide technical support information, see the HP support website:http://www.hp.com/supportBefore cont

TIP: Provides helpful hints and shortcuts.106 Support and other resources

6 Documentation feedbackHP is committed to providing documentation that meets your needs. To help us improve thedocumentation, send any errors, sugges

A Commands by categoryRCLI commandsCommandsCategory“set append” (page 48)Append“show append” (page 63)“list array” (page 27)Arrays“remove array” (page

CommandsCategory“show host” (page 69)“disable io_statistics” (page 22)I/O statistics“show io_statistics” (page 70)“add initiator” (page 17)Initiators“

identifying the FCIP route you want to modify. When you add a new FCIP route, fixed defaultvalues are used because there is no existing route from whi

CommandsCategory“show ntp” (page 78)“set password” (page 58)Password“show performance” (page 78)Performance“execute script” (page 25)Scripts“generate

CommandsCategory“wait time” (page 87)“list vlan” (page 30)VLANs“set vlan” (page 62)“show vlan” (page 81)“list vp_group” (page 31)Virtual port groups“s

B API error codesThe retval command displays a description of a specified return value. Table 4 (page 112)describes the error codes that the API can r

Table 4 API error codes returned by the retval command (continued)DescriptionErrorUse QRouter::addScrubLUNJob() to add a scrub LUNjob.QAPI_E_INVALID_D

GlossaryAarray A storage system that contains multiple disk or tape drives. A disk array, for example, isdifferentiated from a disk enclosure, in that

iSCSI Internet small computer system interface. Transmits native SCSI over the TCP/IP stack. In a systemsupporting iSCSI, a user or software applicati

SSAN Storage area network. A network of storage devices and the initiators that store and retrieveinformation on those devices, including the communic

IndexAacknowledge migration, 89add dm_group, 89add dml, 90add fcip_route, 15add initiator, 17add lunmask, 18add migration, 91add notification, 19array

set password, 58set presented, 58set snmp, 59set system, 60set time, 61set vlan, 62set vp_group, 62show append, 63show array, 63show chassis, 64show d

list vlan, 30list vp_group, 31login iscsi_target, 31logout iscsi_target, 32LUN, 115Mmap global_iscsi_target, 32map target, 33merge csv, 34modify dm_gr

2 General keywordsThis chapter provides the description and syntax for keywords that apply to all commands. Becausethese keywords are defined here, th

Uunmap global_iscsi_target, 84unmap target, 84unregister system, 85update firmware, 85upload dm_report, 103Vversion system, 85view dm_log, 103view log

c:\> rcli show system -help=help.doc-ipUse the -ip keyword to specify the IPv4 or IPv6 management port address of the MPX200Multifunction router. I

ExamplesTo create a show_system.dat file in the working directory:c:\> rcli show system /resultTo create a show_system_January2012.dat file in the

3 Command referenceThis chapter provides the description, syntax, specific keywords, and examples of the RCLIcommands. The commands are listed in alph

Specifies the MTU size for the iSCSI port. Values are:-mtu_size=• min (minimum)• normal (default)• max (maximum)• jumbo (jumbo frames)• An integer ran

Examplec:\>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 -tcpw

Specifies the world wide node name of a Fibre Channel initiator.-wwnn=Specifies the world wide port name of a Fibre Channel initiator.-wwpn=Examplec:\

Specifies the LUN EUI.-lun_eui=2, 3Specifies the LUN NAA designator.-lun_naa=2, 3Specifies the LUN for which you want to add a LUN mask.-lun_number=Sp

© Copyright 2012–2013 Hewlett-Packard Development Company, L.P.Confidential computer software. Valid license from HP required for possession, use or c

Leave blank to disable email notifications.Specifies the event type that triggers sending email to the list of recipients. If thiskeyword is not speci

connect systemThe connect system command verifies that the RPC connection to a router works for a specifiedIP address.Syntaxconnect system -ip=IPv4 or

Syntaxdestroy hostKeywordsSpecifies the symbolic name for the new host.-host_idFor an explanation of the general keywords that apply to all commands,

Specifies the iSCSI target name of the storage array for which you want to stopcollecting data.-array_with_is_target=Specifies the WWULN, T10, NAA, EU

disable iscsi_portThe disable iscsi_port command disables the specified iSCSI port.Syntaxdisable iscsi_portKeywordSpecifies the port number of the iSC

Syntaxenable beaconExamplec:\> rcli enable beacon /ip=10.0.0.12[10.0.0.12]Beacon successfully turned ONenable fc_portThe enable fc_port command ena

Script "config_script.txt" completed OKfind systemThe find system command broadcasts to discover either a specified router or all routers.Sy

Specifies the NAA of the storage array LUN to which to apply the commands in thisscript.-array_with_lun_naa=1Specifies the Page 0x80 serial number of

To view detailed information for a single storage array, use the show array command. See“show array” (page 63).Syntaxlist arrayExamplesc:\> rcli li

list logThe list log command displays all log data from a file or a running system, filtered accordingto severity and search text.NOTE: To view a limi

Contents1 Getting started...7Firmware requirements...

VP Group 4-lun_number=0 -vpgindex=4 -fc_target=5001-4380-025D-A83ATarget "5001-4380-025D-A83E"VP Group 1...list presentedThe list presented

Syntaxlist vlanExamplec:\> rcli list vlan /ip=10.0.0.12[10.0.0.12]-port=1 -ipv4 -enable=yes -id=32 -priority=2-port=2 -ipv4 -enable=no-port=3 -ipv4

• true• falseSpecifies the CHAP password.-chap_secret=This keyword is ignored if CHAP is not enabled.Specifies the iSCSI target to log into at the spe

KeywordsSpecifies the Fibre Channel port number, where the first port is 1.-fc_portSpecifies the FC target WWNN.If the -fc_port keyword is used and th

Examplec:\> rcli map target -fc_target=5001-4380-025C-C7D8 -ge_port=1-vpgindex=1 /ip=10.0.0.12Target 5001-4380-025C-C7D8 successfully mapped to Eth

Specifies the IPv4 gateway address or the IPv6 default router address.The default is as currently set on the router.-gateway_ip=Specifies the Ethernet

Specifies that the IPv6 link local address is used for the local end of this FCIP route.-uselinklocal1Enables use of a VLAN for the newly-created rout

modify initiatorThe modify initiator command changes the OS type for an existing initiator.Syntaxmodify initiatorKeywordsRequired, unless the -is_init

Examplec:\> 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 2modif

Examplec:\>rcli modify notification -name="my profile" -event=dm_all -http/ip=10.0.0.12Notification "my profile" successfully m

help...27list array

KeywordsSpecifies 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

remove fcip_routeThe remove fcip_route command removes one FCIP route.Syntaxremove fcip_route -fc_port=Fibre Channel port numberNOTE: The router must

If this keyword is not used, the command displays detailed information for all storagearrays.Specifies the Fibre Channel target WWPN of the LUN mask t

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 l

KeywordIndicates 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

Syntaxreset_factory systemKeywordSpecifies that the management port IP address is changed after the router reboots.-full_resetIf this keyword is not u

Syntaxretval systemKeywordSpecifies a return value from a previously executed RCLI command.-rvExamplec:\> rcli retval system -rv=140RCLI_OKsave cap

FRU config file saved successfullysave logThe save log command retrieves log data from the router and saves it to a file.Syntaxsave log —file=<outp

If this keyword is not used, the output appears on the console.You can use any keywords with assigned values suitable for the command specifiedby the

set arrayThe set array command configures the name, bandwidth, and data migration target type fora storage array.NOTE: Unless the command line keyword

set time...61set vlan...

• on• off• true• falseThe default is the current setting on the router.Specifies the maximum quantity of concurrent I/Os that the router issues to the

set fcThe set fc command sets the link rate for a specified Fibre Channel port.Syntaxset fc -port=port numberKeywordSpecifies a new link rate in gigab

FC1 advanced info successfully configuredset featuresThe set features command sets the license key to enable extended features on the router.Syntaxset

Examplec:\> rcli set iscsi -port=1 -ipv4_static -ipv4_addr=10.0.0.5/ip=10.0.0.12iSCSI Port 1 basic info successfully configuredset iscsi_advThe set

Specifies the MTU size for the iSCSI port. Values are:-mtu_size• min (minimum)• normal (default)• jumbo (jumbo frames)• max (maximum)• an integer in t

The default is the current setting on the router.Specifies the IPv4 or IPv6 port address.-isns_ipaddrThe default is the current setting on the router.

set notificationThe set notification command configures notifications, including IP addresses and portnumbers for SMTP servers, and contact informatio

Specifies the site-local IPv6 address for the iSCSI port.-ipv6_site_addr=Default is the current setting on the router.Specifies the contact phone numb

Examplec:\> rcli set ntp -enable=yes -ntp_ipaddr=10.0.0.100 -tz_hours=-8-tz_mins=0 /ip=10.0.0.12NTP -index=0 successfully configuredset passwordThe

Examplec:\> rcli set presented -chap_enable=yes -chap_secret="my password"-is_target=iqn.1986-03.com.qlogic:fcgw.mpx200.0823e00014.b2.02.

pause migration...96remove dm_group.

The default is the current setting on the router.Specifies the SNMP trap version.-trap_version=Values are 1, 2, or 3.The default is the current settin

• true• falseThe default is the current setting on the router.Specifies a symbolic name for the router.-name=The name can be blank, or contain a maxim

Syntaxset timeKeywordsSpecifies that the router time is set using the input treated as Greenwich Mean Timein the format MM/DD/YYYY HH:MM:SS.-gmt=Speci

NOTE: This command is not supported for MPX100 routers.Syntaxset vp_group -vpgindex=index numberKeywordsSpecifies whether VP group names are allowed.

KeywordsSpecifies the WWPN of the storage array for which you want to view detailedinformation.-array_wwpn=If this keyword is not used, the command di

Examplec:\> rcli show chassis /ip=10.0.0.12[10.0.0.12] Product Name = MPX200 Chassis Name = Multifunction Router Serial Number = 0823E0001

WWPN = 2103-00C0-DD12-F95C WWNN = 2003-00C0-DD12-F95C Port ID = 01-13-04show fc_advThe show fc_adv command displays detailed information (in

NOTE: The router must be capable and licensed for FCIP.Syntaxshow fcip_routeKeywordsSpecifies the Fibre Channel port for which to display FCIP route i

IP Rcvd Packets 25143IP Rcvd Byte Count 0IP Rcvd Fragments 613

FCIP SACK Capable No License NeededDM Offline Capable No License NeededDM Online Capable No License NeededDM Capacity Capable

1 Getting startedThis chapter provides information to help you get started using the Remote CLI utility.For instructions to install the Remote CLI, se

CHAP is Disabled CHAP Secret = Portal = 0 Operational State = Logged Out Initiator Device Path = No port specified Discovery Method = NAM

Specifies the Fibre Channel target name.-fc_target=2Specifies the iSCSI target name.-is_target=2Accepts the LUN name in a variety of formats that are

KeywordsSpecifies the port number for the iSCSI port for which you want to view basicinformation.-port=If this keyword is not used, basic information

Syntaxshow iscsi_statisticsKeywordsIf used, an individual file containing csv is created for each port. Files are created,or appended to if they alrea

IP Datagram Reassembly Count 0 0 0 0IP Error Packets 0show isnsThe show isns command displays iS

Specifies the T10 designator of the storage array LUN for which you want to viewdetailed information.-array_with_lun_tten=1Specifies the WWULN of the

NOTE: If none of the optional keywords are used, detailed information is displayed for all LUNmasks known to the router.If a LUN, VP group, and target

Specifies the LUN EUI.-lun_eui=4Specifies the LUN NAA designator.-lun_naa=4Specifies the LUN for which you want to view detailed LUN mask information.

show notificationThe show notification command displays the notification feature configuration and one ormore profiles.Each profile lists email addres

The default value is 2 seconds.Examplec:\> rcli show performance /ip=10.0.0.12Port Bytes/s Bytes/s Bytes/s Bytes/s Bytes/sNumb

Executing script filesThe execute script command accepts a text file containing a series of Remote CLI commandsto be run in sequence.For more informat

Syntaxshow snmpExamplec:\> rcli show snmp /ip=10.0.0.12[10.0.0.12]-read_community=public -trap_community=private -location="Server Room"-

Telnet = Enabled SSH = Enabledshow targetThe show target command displays detailed information for a single target.If you do not specify a ta

Syntaxshow vlanKeywordsSpecifies to use IPv4.-ipv41Specifies to use IPv6.-ipv61Specifies the iSCSI port number.-port=1Only one of these keywords can b

Examplec:\> rcli -port=1 /ip=10.0.0.12[10.0.0.12]Zone set: CA_101 (FC1) Zone: My_mpx200_vp1 Port Name 21:0:0:c0:dd:12:f9:5c Port N

KeywordsSpecifies 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

Target 5001-4380-025C-C7D8 successfully unmapped from Ethernet port 1unregister systemThe unregister system command unregisters RCLI as the management

Version 1.73.0.0.0.0view logThe view log command displays a limited portion of the log data. A position context is maintainedin persistent data. Use t

Enter the date and time in the format ”MM/DD/YYYY HH:MM:SS”.1The -time, -find, and -severity keywords are search options that start from the position

KeywordSpecifies the wait time in seconds.-seconds=If this keyword is not used, the default delay time is 5 seconds.Examplec:\> rcli wait time -sec

4 Data Migration commandsData migration is a block-level, online and offline feature introduced in the MPX200 data transportdevice. The HP StorageWork

Table 1 Remote CLI sample scripts (continued)DescriptionFolder nameThis folder contains scripts for automated migration of a large number of LUNsbased

Examplec:\> rcli add dm_group -name="My Group" /ip=10.0.0.12[10.0.0.12]nlData Migration Job Group "My Group" successfully added

Specifies the LUN T10 designator.-lun_tten=3Specifies the VP group index number for the new data management LUN.-vpgindex=1Do not combine the keywords

This command requires router firmware version 3.3.0.0 or later for scrubbing LUNs andthin-provisioned destination LUNs.If the specified source or dest

Specifies the destination virtual port group.-dmdest_vpgindex=Specifies the I/O size, in kilobytes, to use for data migration. Values are:-dm_io_size=

Do not use this keyword for compare jobs.1Do not combine the keywords -array_with_lun_serial, -array_with_lun_wwuln, -array_with_lun_tten,-array_with_

Syntaxlist dm_groupExamplec:\> rcli list dm_group /ip=10.0.0.12[10.0.0.12]Data Migration Group count = 1 -name="Group 0"list dm_logThe

KeywordSpecifies the status of data migration jobs to view. Values are:-state=• running• paused• failed• completed• serial scheduled• allIf this keywo

Examplec:\> rcli remove dm_group -name="My Group" /ip=10.0.0.12[10.0.0.12]Data Migration Job Group "My Group" successfully remo

Examplec:\> 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 -vpgi

Examplec:\> rcli save dm_log -file=dmlogdata.dat[10.0.0.12]Data Migration Log saved successfully to file: "dmlogdata.dat"save dm_reportTh