background image

Appendix A  spscmd 

 
 

   Appendix A  spscmd 

[Name] 

spscmd - Settings for NEC Storage PathManager and display of its status. 

 

[Syntax] 

 

   spscmd 

avail 

path_number 

 

   spscmd 

failback 

path_number

 

 

   spscmd 

failbackall

 

 

   spscmd 

getfbmode

 

 

   spscmd 

getlun [-v] [-s0 | -s1 | -s2]

 

 

   spscmd 

getmode

 

 

   spscmd 

getmscsmode 

 

   spscmd 

getver 

 

   spscmd 

getwatcher 

param 

 

   spscmd 

lbmode 

path_number mode 

 

   spscmd 

notavail 

path_number 

 

   spscmd 

path 

path_number 

 

   spscmd 

priority 

path_number priority 

 

   spscmd 

setfbmode 

state 

 

   spscmd 

setmscsmode 

state 

 

   spscmd 

setwatcher 

param 

 

   spscmd 

swap 

path_number1 path_number2 

 

[Description] 

           It is used to make settings for NEC Storage PathManager and to display its 

status. 

 

Options 

spscmd recognizes the following options and arguments: 

 

     spscmd 

avail 

path_number 

   

It enables priority of the path specified by "path_number." 

 

     spscmd 

failback 

path_number 

 

 It executes failback targeting the path specified by 

"path_number." 

 
 

2

 

 

Summary of Contents for Storage Software PathManager

Page 1: ...NEC Storage Software NEC Storage PathManager User s Manual Windows version IS201 5E...

Page 2: ...oration 2003 2004 No part of the contents of this book may be reproduced or transmitted in any form without permission of NEC Corporation The contents of this book may be modified without notice in th...

Page 3: ...rted by the following software NEC Storage PathManager 3 1 Enterprise for Windows NEC Storage PathManager 3 1 Standard for Windows 2 Microsoft R Windows R and Windows NT R are registered trademarks or...

Page 4: ......

Page 5: ...Setup II 2 PART III FUNCTIONS III 1 Chapter 3 Functions of NEC Storage PathManager III 2 3 1 Path state display III 2 3 2 Path control III 7 3 3 Load balancing III 12 3 4 Cluster liaison III 15 3 5 Pa...

Page 6: ......

Page 7: ...Part I Overv view P Pa ar rt t I I O Ov ve er rvi ie ew w...

Page 8: ...d and used so far in order to reduce failure occurrence in storage units and smoothly recover from failures Examples include RAIDs hot spares and replications These functions are also provided in NEC...

Page 9: ...failover function for nodes in cluster systems in order to avoid path failures 1 2 C Configuration of NEC Storage PathManager 1 1 2 2 Co on nf fi ig gu ur ra at ti io on n o of f N NE EC C S St to or...

Page 10: ...scmd HP HP HP Server iStorage NEC Storage PathManager driver NEC Storage command Operation Figure 1 1 Configuration of NEC Storage PathManager 1 3 System configuration 1 1 3 3 S Sy ys st te em m c co...

Page 11: ...ra at ti io on n In this system multiple servers are directly connected to NEC Storage This system configuration is used when multiple servers having different tasks share a relatively large NEC Stor...

Page 12: ...ti io on n Below is an example of a cluster system configuration There are FC switches between the server and NEC Storage so that multiple servers will make the same logical unit visible NEC Storage...

Page 13: ...Part II Installation P Pa ar rt t I II I I In ns st ta al ll la at ti io on n...

Page 14: ...23 MB HBA Host bus adapter specified by NEC Storage NEC Storage 4000 series 3000 series 2800 series 2000 series 1000 series 100 series 2800 series 2000 series 1000 series 100 series 1 Storage PathMana...

Page 15: ...d NEC Storage may result in fatal damage to file systems 3 Follow the HBA setup procedure manual to set up the FibreChannel driver 4 Set the cross call of NEC Storage to On For settings of the cross c...

Page 16: ...he installation is complete connect NEC Storage and the server used in installation if you are requested to reboot the system first reboot the system and then make the above connection For further inf...

Page 17: ...Storage PathManager 1 Completely disconnect the server and NEC Storage while the server is turned off 2 Turn the server on and log in as an administrative user 3 Insert the Setup CD into the CD drive...

Page 18: ......

Page 19: ...Part III Functions P Pa ar rt t I II II I F Fu un nc ct ti io on ns s...

Page 20: ...ailed paths when failures occur uses the failover function to use alternative paths and uses the failback function at the time of failure recovery 7 Log extraction This function outputs operation info...

Page 21: ...his path is not in effect 4 Failed This is the path that is unavailable due to failures Active In use Failures Unavailable Available Standby Figure 3 1 State transition 3 1 2 P Pa a ath list display 3...

Page 22: ...only supports round robin as a type of dynamic load balancing Other logical unit numbers are surrounded by the symbol 2 Path state This shows the state of each path In use This is the path that is cu...

Page 23: ...alUnit 0 0 Priority 2 PathNumber 4 0 0 0 1 Priority 1 PathNumber 5 0 1 0 C C spscmd getlun LogicalUnit 0 0 Priority 1 PathNumber 5 0 1 0 C Disconnection occurs in the path 4 0 0 0 The path information...

Page 24: ...balancing LogicalDiskNumber number given to a logical disk ProductId product ID of NEC Storage SerialNumber serial number given to an NEC Storage unit PortNumber number given to a port PathId ID of a...

Page 25: ...PathManager Use an spscmd to use this function Path priority which becomes important when controlling the paths will be described first Then spscmd options to be used in path control will be describe...

Page 26: ...pscmd to temporarily disable priority The state of a path with deactivated priority will turn from In use or Active to Standby Standby In use Failures Unavailable Available notavail Active Figure 3 2...

Page 27: ...e of failures in all the other paths In this case the priority of this path will be enabled before it is used The following figure shows the priority relationship between normal paths which are the pa...

Page 28: ...rity of the specified path and by switching the priorities of the specified path and the currently used path Note that the priorities will not be switched if the specified path becomes the path to be...

Page 29: ...ri io or ri it ti ie es s Use the swap option of the spscmd to switch the orders of paths to be used The swap option switches priorities of two specified paths Note that the enabled disabled status o...

Page 30: ...he priority of the path that has failed back will be changed refer to 4 1 2 Initial settings As described above the priority option must be used with much caution Unless it is absolutely necessary use...

Page 31: ...1 0 LogicalUnit 1 0 Priority 2 PathNumber 4 0 0 1 1 Priority 1 PathNumber 5 0 1 1 C In this example path 0 path number 4 0 0 x will be used when accessing logical units 0 and 1 Once the settings for s...

Page 32: ...e option of the spscmd to make settings for dynamic load balancing The following image shows an example C spscmd getlun LogicalUnit 0 0 Priority 2 PathNumber 4 0 0 0 1 Priority 1 PathNumber 5 0 1 0 C...

Page 33: ...hManager first attempts to switch paths If this does not work then the cluster control program will switch nodes NEC Storage PathManager can be used in EXPRESSCLUSTER CLUSTERPRO and MSCS Microsoft clu...

Page 34: ...e health check function paths that are available for use are monitored and the failover function is automatically activated in case of failures In the recovery check function paths that are not used d...

Page 35: ...n is used mainly to monitor failures in alternative paths in environments except for those in which dynamic load balancing is conducted Standby In use Failures Unavailable Available Active Figure 3 7...

Page 36: ...2 C spscmd getwatcher Health check Enable 1 Request interval 30 sec 2 C Four numbers with a colon in between are specified as arguments of the setwatcher option They correspond to respective parameter...

Page 37: ...onds This parameter is not for Windows Server 2003 4 Timeout duration This refers to the timeout duration for monitoring I O NEC Storage PathManager will decide that failures have occurred if monitori...

Page 38: ...cute failover so that alternative paths will be used and execute failback at the time of failure recovery The abovementioned path patrol executes failover and failback by using these functions 3 6 1 F...

Page 39: ...ath1 Failures Recovery Figure 3 9 Failover left and failback right Standby In use Failures Unavailavle Available Active Figure 3 10 Failover as a result of failure avoidance Standby In use Failures Un...

Page 40: ...es disabled Select standby failback when you do not wish to have any extra path switching at the time of failback If this type of failback is selected it is necessary to manually enable the path prior...

Page 41: ...spscmd failback 4 0 0 0 C spscmd getlun LogicalUnit 0 0 Priority 2 PathNumber 4 0 0 0 1 Priority 1 PathNumber 5 0 1 0 C The failback option executes failback targeting the specified paths Meanwhile t...

Page 42: ...ger and information regarding operation of NEC Storage PathManager and failed I O are recorded in the SPS logs SPS logs are stored in a log storage folder installation directory Log and consist of a c...

Page 43: ...ld will be deleted Then spsevent log becomes spsevent log old A new spsevent log is created and logs will be stored in this file spsevent log spsevent log Log storage folder spsevent log old spsevent...

Page 44: ...Path Priority was changed successfully 1 Date Time 2 266 Failed to change Priority Err Failed to change Path Priority 1 Date Time 2 267 Start changing LBMode Info Start changing LoadBalancing Mode 1...

Page 45: ...s 262 Failback failed Err No Yes 263 Failback completed Info No Yes 264 Start Changing priority Info No Yes 265 Changing Priority was done Info No Yes 266 Failed to change Priority Err No Yes 267 Star...

Page 46: ...NVBASE AlertViewer AlertType StoragePath WavDefault REG_SZ Default wav AniDefault REG_SZ Default bmp Image REG_SZ Default bmp SmallImage REG_SZ Default bmp 2 Set the permissions shown below HKEY_LOCAL...

Page 47: ...Part IV Operation P Pa ar rt t I IV V O Op pe er ra at ti io on n...

Page 48: ...age PathManager automatically groups paths for each logical unit and conceals the paths in applications to make only one path visible Use an spscmd to check current NEC Storage PathManager operation s...

Page 49: ...he spscmd to return the result If only one path is displayed in the getlun option of the spscmd first refer to 4 2 1 FAQs and troubleshooting to see if solutions can be found before making inquiries 4...

Page 50: ...ogical unit they will be sequentially allocated with priority that goes up by 1 for each path Their priorities will be disabled Once priority is allocated after the system is rebooted the same priorit...

Page 51: ...installing the HBA driver make sure to check the settings for priority and make settings again as needed 2 Failback method When NEC Storage PathManager is installed the failback method is set to stan...

Page 52: ...also experiencing failures then a path having the third highest priority will become the next candidate It may seem rare that more than two paths experience failures at the same time however this can...

Page 53: ...orage PathManager Figure 4 1 Setting priority 1 In the next figure path priorities are set to 4 2 3 and 1 from left to right In this case only one execution of failover is necessary to determine which...

Page 54: ...Chapter 4 Operating NEC Storage PathManager Express5800 NEC Storage StoragePathSavior Priority 4 2 3 1 Storage PathManager Figure 4 2 Setting priority 2 IV 8...

Page 55: ...HBA manual for detailed information on the Emulex Configuration Tool Is NEC Storage connected with the server Confirm the connection between NEC Storage and the server When fibre channel fabrics exist...

Page 56: ...tree 3 Open Disk drives 4 Take a screen shot 3 Logical drive information Use Disk Management of Windows to collect logical drive information bitmap image 1 Open Start Settings Control Panel Administr...

Page 57: ...Prompt 2 Using the command prompt execute the following command C spscmd getlun v file name Path information will be saved in a file specified in File Name 7 Registry Use Registry Editor of Windows t...

Page 58: ......

Page 59: ...Ap ppendix A App pe en nd di ix x...

Page 60: ...e spscmd notavail path_number spscmd path path_number spscmd priority path_number priority spscmd setfbmode state spscmd setmscsmode state spscmd setwatcher param spscmd swap path_number1 path_number2...

Page 61: ...f their number For other logical units the paths will be displayed in the order of priority If not specifically set this display order will be applied s1 Paths will be displayed in the order of their...

Page 62: ...by path_number mode will set dynamic load balancing Mode 0 Dynamic load balancing will not be executed no load balancing will be executed or static load balancing will be executed Mode 1 Dynamic load...

Page 63: ...abled 2 health check disabled recovery check enabled 3 health check enabled recovery check enabled 2 Request interval Interval for issuing monitoring requests in seconds 3 Threshold Duration of time t...

Page 64: ...2 III 27 Disk drive information IV 9 monitoring I O III 19 dynamic load balancing III 4 III 7 III 14 MSCS II 4 III 15 E MSCS liaison III 15 IV 5 Multiple server configuration I 5 ESMPRO liaison III 2...

Page 65: ...Setup II 2 setwatcher III 18 III 19 Single server configuration I 4 SlotNumber III 6 Sorted path list display III 6 SPS log III 24 IV 10 spscmd I 3 2 spsevent log III 24 Standby III 3 III 4 III 8 sta...

Reviews: