cli_in_eng_mode

Navisphere Development - Company Confidential 11/12/01 1

Navisphere CLI Command Set

In Engineering Mode

Functional Specification


REVISIONS ..........................................................................................................3

INTRODUCTION ..................................................................................................3

COMMANDS ........................................................................................................3navicli accesscontrol messner -loginhba UID ....................................................................................4navicli accesscontrol messner -logouthba UID ..................................................................................4navicli arraysernum [-messner]............................................................................................................4navicli arraysernum messner ArraySerialNumber...........................................................................4navicli arraysernum messner unisysformat ArraySerialNumber .................................................5navicli chglun messner l lun -makepublic ........................................................................................5navicli cru_on_off messner cru-number [0|1]....................................................................................5navicli getagent messner......................................................................................................................5navicli getlun messner stack..............................................................................................................6navicli managefiles messner put localfile arraydirectory...............................................................6navicli mirrorview messner syncrate rate .......................................................................................6navicli modeselect messner filename [-info] ......................................................................................6navicli modesense messner page-number page-length [-info] ..........................................................7navicli ndu messner install ndupathfilename [--force] --nocheck..................................................7navicli ndu messner uninstall namelist ............................................................................................7navicli ndu messner uninstallinactive ..............................................................................................8navicli port messner list.....................................................................................................................8navicli remoteconfig -messnergetconfig -megapoll .........................................................................10navicli remoteconfig messner setconfig megapoll 0|1..................................................................10navicli remoteconfig messner stop..................................................................................................11navicli responsetest phonehome .......................................................................................................11navicli storagegroup -messner list [-default (Engineering Mode only)] [gname GroupName|uid StoragegroupUID]........................................................................................................................11navicli storagegroup -messner -makedefault [-o] gname GroupName|uid StoragegroupUID .11navicli systemtype messner ...............................................................................................................11navicli trace -messner transact-[severity_number][,[qualifier_list]]...............................................11navicli unbind -messner.......................................................................................................................12navicli zerodisk messner disklist [start|stop|status|getzeromark]..................................................13


REVISIONSJagdish Garg x7730 10/03/00 Rev 0 First draftScott Kay 10/05/01 Rev 1.0 Updates for 5.3

INTRODUCTION

This document describes the Navisphere CLI commands that run in engineering mode only. Information iscollected from different documents and from source code to create this document. No other concretedocument is available for these commands i. e these commands are not listed in help file or NaviCLImanual. This document contains all those engineering mode commands that are already coded and tested.New commands will be added later if there will be any.

The syntax in this document will be very basic. Goal of this document is to provide basic information aboutthese commands to a user who knows CLI well enough.

COMMANDS

accesscontrol -loginhba UID

-logouthba UID

arraysernum ArraySerialNumber

-unisysformat ArraySerialNumber

chglun -makepublic

cru_on_off cru-number [0|1]

getagent

getlun stack

managefiles -put localfile arraydirectory

mirrorview -syncrate Rate [low|medium|high|0-3600]

modeselect filename [-info]

modesense page-number page-length [-info]

ndu -nocheck

-uninstall Namelist

-uninstallinactive


port -list

remoteconfig -getconfig -megapoll

-setconfig -megapoll 0/1 -interval interval

-stop

responsetest -phonehome

storagegroup -list -default

-makedefault [-o] gname GroupName|uid StoragegroupUID

systemtype [-config sysType(in hex)] [-o]

trace transact-[severity_number][,[qualifier_list]]

unbind

zerodisk disklist [start|stop|status|getzeromark]

navicli accesscontrol messner -loginhba UID

This command attempts to log in the specified hba. The following prompt will occur if a password for thearray exists:

Password:

Login this HBA? (y/n):

And proceed if y

navicli accesscontrol messner -logouthba UID

This command attempts to log out the specified hba.

navicli arraysernum [-messner]

This command displays serial number of an array if no other argument is specified.

arraysernum messner

Array Serial Number:F20003400873

navicli arraysernum messner ArraySerialNumber

This command attempts to set array serial number of an array to the special serial number. This commandreboots the array.


arraysernum -messner A23456

Warning: Changing the system serial number will cause an immediate reboot of the array and a new FibreChannel WWN to be created. This command will fail if the write cache is not in the disabled state and ifany I/O is outstanding. Console shall be disabled for 60 seconds to allow Flare re-boot.

Change Array serial number from F20003400873 to A23456 (y/n)?

Answering yes changes the serial number and reboots the array. Answering no does nothing.

navicli arraysernum messner unisysformat ArraySerialNumber

This command attempts to set array serial number of an array to the special serial number. This commandreboots the array. The unisysformat switch allows one to enter hyphens (-) in the arrayserialnumber.

arraysernum -messner unisysformat 12-345-6789

Warning: Changing the system serial number will cause an immediate reboot of the array and a new FibreChannel WWN to be created. This command will fail if the write cache is not in the disabled state and ifany I/O is outstanding. Console shall be disabled for 60 seconds to allow Flare re-boot.

Change Array serial number from F20003400873 to 12-345-6789 (y/n)?

Answering yes changes the serial number and reboots the array. Answering no does nothing.

navicli chglun messner l lun -makepublicThis command attempts to convert a private logical unit to public. After executing the command, it does apoll.

chglun -messner -l 0 -makepublic

LUN should not be consumed to make it public.

navicli cru_on_off messner cru-number [0|1]

This command attempts to turn a CRU on or off. 0 Turn Off1 Turn On

navicli getagent messner This command displays the hostid as part of outputted information. Normally getagent does not display thehostid.

V:\cli++>navicli -h 10.14.12.207 getagent -messner

getagent -messner getagentHost ID: dfd70458-e46a-4eb9-90a8-08bd1e2ed4b1Agent Rev: 5.3.0 (7.0)

Agent Rev: 5.3.0 (7.0)Name: CD_2adf2945Desc: "DGC 0531 2adf2945"


Name: CD_2adf2945Desc: "DGC 0531 2adf2945"Node: \\.\SCSI2:0:2:0Signature: 719268165Peer Signature: 2227601989Revision: 5.31.00SCSI Id: 0Model: 4400Model Type: DesksideProm Rev: 1.05.00SP Memory: 512Serial No: m10005800021SP Identifier: ACabinet: DPE

Node: \\.\SCSI2:0:2:0Signature: 719268165Peer Signature: 2227601989Revision: 5.31.00SCSI Id: 0Model: 4400Model Type: DesksideProm Rev: 1.05.00SP Memory: 512Serial No: m10005800021SP Identifier: ACabinet: DPE

navicli getlun messner stackThis command displays the list of drivers where the logical unit is stacked. This command is applicable onprivate logical units only.

V:\cli++>cli -h cpc42120 getlun -messner -stack

LOGICAL UNIT NUMBER 1List of Driver: K10SnapCopyAdmin

LOGICAL UNIT NUMBER 2List of Driver: K10SnapCopyAdmin

navicli managefiles messner put localfile arraydirectory

This command puts a file on to the array in one of the predefined directories. It does not check format oruse of the file.

Localfile File Name with absolute pathname to be copied.Arraydirectory Directory Name where the file should be copied. Enter one of the three - ndu,

log, or dump.

navicli mirrorview messner syncrate rate

This command sets the sync rate for mirrorview. The rate can be designated as low, medium or high orentered as a number between 0-3600 seconds.

rate low|medium|high with low being the fastes rate (0)0 - 3600. low = 0, medium = 1800 and high = 3600.

navicli modeselect messner filename [-info]



filename modeselect input file. See below for details.-info Displays help screen for modesense and modeselect commands.

CLI modesense/select - help screen----------------------------------

A few pointers for using the modesense/modeselect commands... 1. All values are in hex... this includes: - the page-code, - the page-length, - modesense output, - and the modeselect input file. 2. When doing a modesense, if you are not getting the entire page back, you need to add 10(0xa) to the page length value listed in the scsi spec. 3. Recommended procedure to do a modeselect: a. use modesense and redirect output to a file b. edit file, zero out the first 8 bytes, and make any necessary changes to fields c. save file, and use in modeselect 4. There cannot be any blank lines within the modeselect input file. 5. USE THESE COMMANDS AT YOUR OWN RISK!!!

navicli modesense messner page-number page-length [-info]


Page-number Page number whose information is needed in hex.Page-length Length of the page in hex.-info Displays help screen for modesense and modeselect commands as shown in

modeselect command above.

navicli ndu messner install ndupathfilename [--force] --nocheck

This command performs an ndu without verifying the packages version dependencies.

ndupathfilename Path of ndu package to download to array.-force Will procede with the NDU without asking the user any questions.

navicli ndu messner uninstall namelist

This command removes NDU packages from the selected array.

namelist List of packages to remove from the array.


navicli ndu messner uninstallinactive

This command removes all inactive NDU packages from the selected array.

navicli port messner list

This command lists the host id information. Normally the port list command does not include this data.The highlighted portion below does not appear unless engineering mode is specified.

Information about each HBA:

HBA UID: 20:00:00:00:C9:29:0F:17:10:00:00:00:C9:29:0F:17Server Name: nlpc12214Server IP Address: 10.14.12.214Host ID: 5bae6bdc-5ab8-11d5-bf0d-00b0d0235362HBA Model Description: CLARiiON LightPulse, Fabric, FC Driver v4-2.11a0HBA Vendor Description: DGCHBA Device Driver Name: elxsli2Information about each port of this HBA:

SP Name: SP B SP Port ID: 0 HBA Devicename: \\.\SCSI1:0:0:0 Trusted: NO Logged In: NO Defined: YES Initiator Type: 3 StorageGroup Name: None


HBA UID: 20:00:00:00:C9:29:0D:F3:10:00:00:00:C9:29:0D:F3Server Name: nlpc12214Server IP Address: 10.14.12.214Host ID: 5bae6bdc-5ab8-11d5-bf0d-00b0d0235362HBA Model Description: CLARiiON LightPulse, Fabric, FC Driver v4-2.11a0HBA Vendor Description: DGCHBA Device Driver Name: elxsli2Information about each port of this HBA:

SP Name: SP A SP Port ID: 0 HBA Devicename: \\.\SCSI2:0:0:0 Trusted: NO Logged In: NO Defined: YES Initiator Type: 3 StorageGroup Name: None



HBA UID: 20:00:00:00:C9:29:0D:FA:10:00:00:00:C9:29:0D:FAServer Name: nlpc12213Server IP Address: 10.14.12.213Host ID: f0e23640-d150-4133-af73-d70d131df19eHBA Model Description: CLARiiON, LP9000 Series PCI FC HBA, Fabric, v5-2.11aHBA Vendor Description: DGCHBA Device Driver Name: elxsli2Information about each port of this HBA:

SP Name: SP B SP Port ID: 0 HBA Devicename: \\.\SCSI3:0:2:0 Trusted: NO Logged In: NO Defined: YES Initiator Type: 3 StorageGroup Name: Scotts_1

SP Name: SP B SP Port ID: 1 HBA Devicename: Trusted: NO Logged In: NO Defined: YES Initiator Type: 3 StorageGroup Name: Scotts_1


HBA UID: 20:00:00:00:C9:29:0E:A5:10:00:00:00:C9:29:0E:A5Server Name: nlpc12215Server IP Address: 10.14.12.215Host ID: 2c474de4-2bfe-4d18-8625-a2558b9f36dbHBA Model Description: CLARiiON, LP9000 Series PCI FC HBA, Fabric, v5-2.11aHBA Vendor Description: DGCHBA Device Driver Name: elxsli2Information about each port of this HBA:

SP Name: SP A SP Port ID: 0 HBA Devicename: \\.\SCSI3:0:3:0 Trusted: NO Logged In: NO Defined: YES Initiator Type: 3 StorageGroup Name: Storage Group 1

SP Name: SP B SP Port ID: 0 HBA Devicename: \\.\SCSI3:0:0:0 Trusted: NO Logged In: NO Defined: YES


Initiator Type: 3 StorageGroup Name: Storage Group 1

Information about each SPPORT:

SP Name: SP ASP Port ID: 0SP UID: 50:06:01:60:88:02:A7:A7:50:06:01:60:11:02:A7:A7Link Status: UpPort Status: OnlineSwitch Present: YESSwitch UID: 50:06:01:60:88:02:A7:A7:50:06:01:60:11:02:A7:A7SP Source ID: 0

SP Name: SP ASP Port ID: 1SP UID: 50:06:01:60:88:02:A7:A7:50:06:01:61:11:02:A7:A7Link Status: DownPort Status: DISABLEDSwitch Present: NO

SP Name: SP BSP Port ID: 0SP UID: 50:06:01:60:88:02:A7:A7:50:06:01:68:11:02:A7:A7Link Status: UpPort Status: OnlineSwitch Present: YESSwitch UID: 50:06:01:60:88:02:A7:A7:50:06:01:68:11:02:A7:A7SP Source ID: 0

SP Name: SP BSP Port ID: 1SP UID: 50:06:01:60:88:02:A7:A7:50:06:01:69:11:02:A7:A7Link Status: DownPort Status: DISABLEDSwitch Present: NO

navicli remoteconfig -messnergetconfig -megapoll

This command displays whether Mega Poll is enabled or disabled. This is not a valid switch on K10.

Mega-Poll Use explicit device names Enabled/Disabled

navicli remoteconfig messner setconfig megapoll 0|1

This command enables or disables Mega Poll. This is not a valid switch on K10.

0 Disable1 Enable


navicli remoteconfig messner stop

This command stops the agent on a K10 array.

navicli responsetest phonehome

This command is for phone home reponse.

navicli storagegroup -messner list [-default (Engineering Mode only)] [gname GroupName|uid StoragegroupUID]

In Engineering Mode, list sub-command displays Null, Management, or Physical storage groups alsobesides other storage groups. Also -default option of list sub-command is specified in Engineering Modeonly and it displays default storage group.

navicli storagegroup -messner -makedefault [-o] gname GroupName|uidStoragegroupUID

This command will set the specified group name to be the default storage group. If the o switch is present,navicli will proceed with the attempt. If not, navicli will ask:

Change the storage group default from OldGroupNameDefault to NewGroupName? (y/n):

And proceed if y is entered. Answering n does nothing.

navicli systemtype messner

This command is in engineering mode only for Dell and SGI versions of NaviCLI. Use help from NT client.

navicli trace -messner transact-[severity_number][,[qualifier_list]]

This command is a driver interface level (i. e transact) tracing capability from the navicli. To see allactivity transpiring from the agent to driver (and vice versa), use one of the following examples.

Special Instructions:Do not misspell any qualifiers, there is no verification (yet)Do not leave tracing on (if going to a file). It will eat much disk spaceRelease agent trace goes to c:\dumps\naviagent..log by defaultDebug agent trace goes to window by defaultTracing can significantly impact agent performanceSee /connect/transact.cxx function _dump() for other qualifiersThe tag field (in the TLD dump) should be crossed referenced with the headers:

/connect/k10driver/K10Tags.h: k10 level info/connect/k10driver/*Export.h: layered driver tags (snapview, mirrorview, ndu, etc)/connect/tlddef.hxx: legacy (pre-k10) tags

Unfortunately, the navicli can only send these AFTER agent startup, so all startuptransacts are not traced. However, there is a backdoor way to see startup trace. From theDOS window (in debug mode), set the variable DUMP to the above qualifiers (the strings


after the severity). The qualifier syntax is the same as in navicli. In release mode, setsystem variable DUMP (or mess with the registry)

Example 1: To trace all transactions in full:

navicli trace -messner transact-0

Example 2: To trace all transactions by summary

navicli trace -messner transact-0,verbose:summary

Example 3: To turn off transact trace

navicli trace -messner transact-10

Example 4: To trace only "send" transactions by summary

navicli trace messner transact-0,direction:send,verbose:summary

Example 5: To trace only "receive" transactions in full

navicli trace -messner transact-0,direction:receive

Example 6: To trace only "send mode_sense" transactions

navicli trace -messner transact-0,direction:send,operation:mode_sense

Example 7: To trace only "send mode_sense page 0x31" transactions

navicli trace -messner transact-0,direction:send,operation:mode_sense,page:49

Note: for now, page must be entered in decimal, NOT hex

Example 8: To trace only "send mode_sense EXCEPT page 0x31" transaction summary

navicli trace -messner transact-0,direction:send,operation:mode_sense,page:-49,verbose:summary

Example 9: To trace only "receive" returning with tag=0x31

navicli trace -messner transact-0,direction:receive,tag:49,verbose:dump

Note: for now, page must be entered in decimal, NOT hex "tag" qualifier needs dump verbose mode

navicli unbind -messnerThere is no change in syntax for this command in engineering mode. Use messner to unbind a nonexistent logical unit. This is primarily used for PSM failures. Also, use messner to unbind private logicalunit on a K10 array.


navicli zerodisk messner disklist [start|stop|status|getzeromark]

This command zero out the specified disks. This is very dangerous command because data cannot berecovered. Use carefully.

Start Start zeroing out the specified disks.Stop Stop zeroing out the specified disks.Status Current status of zeroing out.Getzeromark Returns zeromark status. If 0 and status is not running then a zerodisk has completed.

REVISIONSINTRODUCTIONCOMMANDSnavicli accesscontrol messner -loginhba UIDnavicli accesscontrol messner -logouthba UIDnavicli arraysernum [-messner]navicli arraysernum messner ArraySerialNumbernavicli arraysernum messner unisysformat ArraySnavicli chglun messner l lun -makepublicnavicli cru_on_off messner cru-number [0|1]navicli getagent messnernavicli getlun messner stacknavicli managefiles messner put localfile arraynavicli mirrorview messner syncrate ratenavicli modeselect messner filename [-info]navicli modesense messner page-number page-lengtnavicli ndu messner install ndupathfilename [--navicli ndu messner uninstall namelistnavicli ndu messner uninstallinactivenavicli port messner listnavicli remoteconfig -messnergetconfig -megapollnavicli remoteconfig messner setconfig megapolnavicli remoteconfig messner stopnavicli responsetest phonehomenavicli storagegroup -messner list [-default \(navicli storagegroup -messner -makedefault [-o] navicli systemtype messnernavicli trace -messner transact-[severity_number][,[qualifier_list]]navicli unbind -messnernavicli zerodisk messner disklist [start|stop|s

cli_in_eng_mode

Documents