NEC PathManager manual

NEC Storage Software NEC Storage PathManager User’s Manual (Windows version) IS201-5E[...]

© NEC Corporation 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 modi fied without notice in the future.[...]

Preface This document illustrates how to use NEC Stor age PathManager. NEC Storag e PathM anager mu ltiplexes paths b etween a s erver and a stor age unit in a s ystem with Express580 0 and the NEC Storage D isk Array SubS ystem. 1 st edition: February, 2003 5 th edition: July , 2004 Notes: (1) Functions descr ibed in this docu ment are suppor ted [...]

[...]

Contents PA RT I OVERVIEW -------------------------------------------------------------------------------------------------------------------- I-1 Chapter 1 Overview of NEC Stor age PathMa na ger -------------------------------------------------------------------------- I-2 1.1 Abou t NEC Storag e PathMa nager --------------------------------------[...]

[...]

P a r t I O v e r v v i e w P P a a r r t t I I O O v v e e r r v i i e e w w[...]

Chapter 1 Overview of NEC Storage PathManager Chapter 1 Overview of NEC Storage PathManager NEC Storage P athManager softw are multiplexes paths b etween a server and a storage unit in a system with Exp ress5800 and the NE C Storag e series D isk Array SubSystem . This softwar e automati cally sw itches p aths to be used in case of failures in path[...]

Chapter 1 Overview of NEC Storage PathManager during the course of switching the paths. Applications can continue their pro cessing without being aware of the path failure. 1 . . 1 . 2 L L o a d b a l a n c i n g f u n c t i o n 1 1 . 1 1 . . 2 2 L o o a a d d b b a a l l a a n n c c i i n n g g f f u u n n c c t t i i o o n n NEC Stora ge PathMa n[...]

Chapter 1 Overview of NEC Storage PathManager This service off ers a log extra ct function that writes log inform ation relate d to NEC Storage PathManager in the ev ent log. From internal inf ormation o f NEC Stora ge PathManager , it write s importan t informatio n in the event log. PathManager Application File system Port/miniPort driver HBA HBA[...]

Chapter 1 Overview of NEC Storage PathManager NEC Stora g e Express5800 Storage PathManager Figure 1-2 Single- server configuration 1 . . 3 . 2 M M u l t i p l e - s e r v e r c o n f i g u r a t i o n 1 1 . 3 3 . . 2 2 M u u l l t t i i p p l l e e - - s s e e r r v v e e r r c c o o n n f f i i g g u u r r a a t t i i o o n n In this system, mult[...]

Chapter 1 Overview of NEC Storage PathManager 1 . . 3 . 3 C C l u s t e r c o n f i g u r a t i o n 1 1 . 3 3 . . 3 3 C l l u u s s t t e e r r c c o o n n f f i i g g u u r r a a t t i i o o n n Below is an exam ple of a clust er system conf iguration . There are FC switches betw een the server and NEC Storage so that mul tiple server s will make [...]

P a r t I I I n s t a l l a t i o n P P a a r r t t I I I I I I n n s s t t a a l l l l a a t t i i o o n n[...]

Chapter 2 Installing NEC Storage PathManager Chapter 2 Installing NEC Storage PathManager 2 . 1 O p e r a t i n g e n v i r o n m e n t 2 2 . . 1 1 O O p p e e r r a a t t i i n n g g e e n n v v i i r r o o n n m m e e n n t t Operating envir onment for NEC Storage PathMa nager is shown below: Table 2- 1 Operating en vironm ent Enterprise Standard[...]

Chapter 2 Installing NEC Storage PathManager After in stalling NE C Storage Pat hManager and befo re starting its oper ation, make sure to read "Chapter 4 Operating NEC Storage Path Manager" an d check oper ation status an d make settin gs. 2 . . 2 . 1 B B e f o r e s e t u p 2 2 . 2 2 . . 1 1 B e e f f o o r r e e s s e e t t u u p p Rea[...]

Chapter 2 Installing NEC Storage PathManager Make sure to use HotFix (Q323289_W2 K_SP4_X86_EN.exe) contained in the Setup CD when installi ng NEC Storage PathMa nager in a Win dows 2000 Service Pack 3 environment. HotFix solves the Win dows 2000 memor y leak problem that would affect NEC St orage Pat hManager . HotFix i s for use only in a Windows [...]

Chapter 2 Installing NEC Storage PathManager When turning on the server after uninstalling NEC Storage PathMana ger, make sure that t he connection betw een the server and NE C Storage is not redundant. You can also set the cross call o f NEC Storage to "Off." Turning on th e server while th e connection is redundant may r esult in unexpe[...]

[...]

P a r t I I I F u n c t i o n s P P a a r r t t I I I I I I F F u u n n c c t t i i o o n n s s[...]

Chapter 3 Functions of NEC Storage PathManager Chapter 3 Functions of NEC Storage PathManager This chapter describes functions that NEC Storage PathMa nager off ers. B asic func tions of NE C Storage Pat hManage r can be roughly categorized as follows: /1/ Pa th state display This function displays info rmation rega rding state of paths. /2/ Path c[...]

Chapter 3 Functions of NEC Storage PathManager 3 . . 1 . 1 P P a a a t h s t a t e 3 3 . 1 1 . . 1 1 P t t h h s s t t a a t t e e There are roughly four ty pes of path state: /1/ In use This is the path that is currentl y in use. For each logi cal unit , there can only be one pa th in use . /2/ Active This is a path that is r eady for use, and the[...]

Chapter 3 Functions of NEC Storage PathManager C:>spscmd -getlun *** LogicalUnit #0 *** > 0: Priority=2, PathNumber=4:0:0:0 1: Priority=1, PathNumber=5:0:1:0 *** LogicalUnit #1 *** X 0: Priority=1, PathNumber=4:0:0:1 > 1: Priority=2, PathNumber=5:0:1:1 +++ LogicalUnit #2 +++ [round robin] > 0: Priority=2, PathNumber=5:0:1:2 @ 1: Priori[...]

Chapter 3 Functions of NEC Storage PathManager When devices become compl etely invisi ble due to dis connection of the FC cab le for example, th e correspon ding path inf ormation di sappears in stead of the path state being di splayed as "Fa iled." C:>spscmd -getlun *** LogicalUnit #0 *** > 0: Priority=2, PathNumber=4:0:0:0 1: Pri[...]

Chapter 3 Functions of NEC Storage PathManager C:>spscmd -getlun -v *** LogicalUnit #0 ** * State=0x0 Config=0x0 LBMode=0x0 LogialDiskNumber='00000' ProductId='iStorage 2000 ' SerialNumber='12341234123 41234 ' > 0: Priority=2, Po rtNumber=4, PathId=0 , TargetId=0, Lun=0 BusNumber=0, S lotNumber=9 Wwpn=34129078: [...]

Chapter 3 Functions of NEC Storage PathManager of their nu mber. Fo r other logic al units, the paths will be displayed i n the order of priority . If not specifically set, this display orde r will be applied. - s1: Paths wi ll be displayed in t he order of their numbe r. - s2: Paths will be displayed in the order of priority . The following image [...]

Chapter 3 Functions of NEC Storage PathManager order of prio rity, from the highest to the l owest for eac h I/O. After the path with the lowest pri ority is used, the order returns to the path with the highest priority . When path priori ty or path state has bee n changed by the spscmd de scribed be low, the resul t will immediately be in effect f[...]

Chapter 3 Functions of NEC Storage PathManager A path with di sabled prio rity will be exclude d from the decisi on process of the order of p ath use by priority and dynamic load bal ancing process. No te that this does not mean that this path will be a bsolutely unavailable. I nstead, thi s path is trea ted as a path ha ving an even lo wer priorit[...]

Chapter 3 Functions of NEC Storage PathManager The following image shows an example when the -avail option is used. C:>spscmd -getlun *** LogicalUnit #0 *** @ 0: Priority=2, PathNumber=4:0:0:0 > 1: Priority=1, PathNumber=5:0:1:0 C:>spscmd -avail 4:0:0:0 C:>spscmd -getlun *** LogicalUnit #0 *** > 0: Priority=2, PathNumber=4:0:0:0 1[...]

Chapter 3 Functions of NEC Storage PathManager When using the -path op tion to sp ecify a path, a p ath num ber (PathNumber) displayed in the -getlun option is inputted as an argum ent. Her e, part of th e path num ber input can be omit ted. If multiple paths in the sa me logical unit match t he resu lt of partiall y omitted path number input, the [...]

Chapter 3 Functions of NEC Storage PathManager specified integer. C:>spscmd -getlun *** LogicalUnit #0 *** > 0: Priority=2, PathNumber=4:0:0:0 1: Priority=1, PathNumber=5:0:1:0 C:>spscmd -priority 5:0:1:0 3 C:>spscmd -getlun *** LogicalUnit #0 *** 0: Priority=2, PathNumber=4:0:0:0 > 1: Priority=3, PathNumber=5:0:1:0 C:> Prio r[...]

Chapter 3 Functions of NEC Storage PathManager LUN0 LUN1 Path 0 Path 1 Figure 3-5 Static lo ad balancing Use the -path op tion or the -swa p option of the spscmd to make settings for static load balancing. The following image shows an example. C:>spscmd -getlun *** LogicalUnit #0 *** > 0: Priority=2, PathNumber=4:0:0:0 1: Priority=1, PathNum[...]

Chapter 3 Functions of NEC Storage PathManager It is possible to confirm t hat static load balancing is i n effect once the -pat h option is applied to the logical unit 1. 3 . . 3 . 2 D D y n a m i c l o a d b a l a n c i n g 3 3 . 3 3 . . 2 2 D y y n n a a m m i i c c l l o o a a d d b b a a l l a a n n c c i i n n g g In this method, l oads are d[...]

Chapter 3 Functions of NEC Storage PathManager for dynamic l oad balanc ing must be set for each unit. Second argu ment 0: do not e xecute dyna mic load bala ncing (speci fied whe n load balanci ng will not be executed or when st atic load balancing will be execut ed) Second argument 1: execu te dynamic load balancin g (in the r ound robin method) [...]

Chapter 3 Functions of NEC Storage PathManager C:>spscmd -getmscsmode MSCS : Disable C:>spscmd -setmscsmode E C:>spscmd -getmscsmode MSCS : Enable C:> The -getmode option of the spscmd ca n also be used to chec k the settings fo r MSCS liaison. C:>spscmd -getmode Class : Enterprise Failback : Active MSCS : Disable C:> Note a[...]

Chapter 3 Functions of NEC Storage PathManager for use. If th e I/O resu lts in an error or if it is not com plete b efore time-o ut, the p aths are regarded as bein g unavailable for use. 3 . . 5 . 1 H H e a l t h c h e c k 3 3 . 5 5 . . 1 1 H e e a a l l t t h h c c h h e e c c k k This function detect s failed paths and ma kes them fail over by [...]

Chapter 3 Functions of NEC Storage PathManager 3 . . 5 . 3 S S e e e t t i n g s f o r p a t h p a t r r o l 3 3 . 5 5 . . 3 3 S t t t t i i n n g g s s f f o o r r p p a a t t h h p p a a t t r o o l l Use the -setwatcher option of the spscmd to make set tings for path patrol. Use the -get watcher option t o check the settings. [For Windows 2000] [...]

Chapter 3 Functions of NEC Storage PathManager (Recovery ch eck is not fo r Windows Server 2003 .) /2/ Reques t interval The path patrol s ervice issues mo nitoring r equests fo r each path to the N EC Storage PathManager dr iver at this interval (d efault : 60, unit: seconds). /3/ Threshold This ref ers to a p eriod of time in which paths h ave no[...]

Chapter 3 Functions of NEC Storage PathManager [For Windows Server 200 3] C:>spscmd -getwatcher Health check : Enable Request interval : 30 sec C:>spscmd -setwatcher :60:: C:>spscmd -getwatcher Health check : Ena ble Request interval : 60 sec C:> Set only Request interval at 60 seconds 3 . 6 F F a i l u r e a v o i d a n c e a n d f[...]

Chapter 3 Functions of NEC Storage PathManager LUN0 LUN1 Path 0 Path 1 LUN0 LUN1 Path 0 Path 1 ? ? Failures ? ? Recovery Figure 3-9 Failover (left) and f ailback (right) Standby In use Failures Unavailavle Available Active Figure 3-10 Failover as a r esult of failure avoidance Standby In use Failures Unavailable Available Active Figure 3- 11 Failba[...]

Chapter 3 Functions of NEC Storage PathManager 3 . . 6 . 2 S S e e e l e c t i n g a m e t h o d o f f a i l b a c k 3 3 . 6 6 . . 2 2 S l l e e c c t t i i n n g g a a m m e e t t h h o o d d o o f f f f a a i i l l b b a a c c k k In NE C Storage PathManager , two types of failback meth ods are available: active failbac k and standby failback. /1[...]

Chapter 3 Functions of NEC Storage PathManager 3 . . 6 . 3 M M a a a n u a l f a i l b a c k 3 3 . 6 6 . . 3 3 M n n u u a a l l f f a a i i l l b b a a c c k k When the abovement ioned recovery check function is disabled, failback will not be exe cuted even though failed paths have re covered from the failur es. In such a case, use the -failback o[...]

Chapter 3 Functions of NEC Storage PathManager 3.7 Log e xtrac tion 3 3 . . 7 7 L L o o g g e e x x t t r r a a c c t t i i o o n n This function outputs log i nformation re lated to NE C Storage PathManage r to an event log. NE C Storage PathManager in ternally holds log info r mation (SPS logs ). From the log in formation, the l og service o utpu[...]

Chapter 3 Functions of NEC Storage PathManager spsevent.log spsevent.log Log storage folder spsevent.log.old The file name is changed, and... a new one is created. Figure 3-8 Storing SPS logs (2) When the new "spsevent.log" becomes full, the previous log file "spsevent.log.old" will be deleted. Then "spsevent.l og" bec[...]

Chapter 3 Functions of NEC Storage PathManager 3 . . 7 . 2 E E v v v e n t l o g s 3 3 . 7 7 . . 2 2 E e e n n t t l l o o g g s s Among the pieces of information stor ed in the SPS logs, important inform ation such as in formation related to failov er and failb ack will be ou tputted to th e event log (system) by the log servi ce. Refer to the fol[...]

Chapter 3 Functions of NEC Storage PathManager 3.8 Messa ge(ES MPRO liai son) 3 3 . . 8 8 M M e e s s s s a a g g e e ( ( E E S S M M P P R R O O l l i i a a i i s s o o n n ) ) The message function of ESMP RO reports the most important events among thos e outputted to the event log by NEC Sto rage Path Manager. No particul ar settings ar e require[...]

Chapter 3 Functions of NEC Storage PathManager If you would like to use th e Alert Manager feature of ESMPRO M anager, you have to set up the regis tries shown below on the ser ver which ESMPR O Manager i s installed. /1/ Set the registries shown below. [HKEY_LOCAL_MACHINESOF TWARENEC NVBASEAlertView erAler tTypeStoragePath] W a v D e f a u l[...]

P a r t I V O p e r a t i o n P P a a r r t t I I V V O O p p e e r r a a t t i i o o n n[...]

Chapter 4 Operating NEC Storage PathManager Chapter 4 Operating NEC Storage PathManager 4 . 1 O p e r a t i o n i n n o r m a l s t a t e 4 4 . . 1 1 O O p p e e r r a a t t i i o o n n i i n n n n o o r r m m a a l l s s t t a a t t e e 4 . . 1 . 1 S S t a r t i n g o p e r a t i o n 4 4 . 1 1 . . 1 1 S t t a a r r t t i i n n g g o o p p e e r r [...]

Chapter 4 Operating NEC Storage PathManager During re dundant ope ration, multi ple paths a re display ed under each "LogicalUn it." The example ab ove shows that the re are two logical uni ts and two pa ths in NEC Stor age. Re fer to "Chapte r 3 Functions of NE C Storage Pat hManager" f or detailed i nformation abo ut the displ[...]

Chapter 4 Operating NEC Storage PathManager /3/ For an already r ecognized path to an al ready reco gnized lo gical unit, th e state of priority wil l be maintained eve n after the sy stem is reboote d. /4/ When a path is al ready r ecognized as a path to an alread y recogni zed logica l unit, and is recover ed from path failures, the path will hav[...]

Chapter 4 Operating NEC Storage PathManager C:>spscmd -avail ::: C:>spscmd -getlun *** LogicalUnit #0 *** 0: Priority=1, Pat hNumber=4:0:0:0 1: Priority=2, Pat hNumber=5:0:1:0 2: Priority=3, Pat hNumber=6:0:2:0 > 3: Priority=4, Pat hNumber=7:0:3:0 *** LogicalUnit #1 *** 0: Priority=1, Pat hNumber=4:0:0:1 1: Priority=2, Pat hNumber=5:0:1:[...]

Chapter 4 Operating NEC Storage PathManager [For Windows 2000] C:>spscmd -getwatcher Health check : Enable Recovery check : Enable Request interval : 60 sec Threshold : 60 sec Timeout duration : 120 sec C:> [For Windows Server 200 3] C:>spscmd -getwatcher Health check : Ena ble Request interval : 60 sec C:> 4 . . 1 . 4 R R e c o m m[...]

Chapter 4 Operating NEC Storage PathManager take up to a minu te longer for NEC S torage PathMana ger to recognize p ath failu res due to execution of failover. To avoid such situations, it is recommended tha t paths having priorities in numerical seque nce do not have common resources. ???????? ? ? ? ? Ex p ress5800 NEC Storage StoragePathSavior P[...]

Chapter 4 Operating NEC Storage PathManager ???????? ? ? ? ? Ex p ress5800 NEC Storage StoragePathSavior Priority: 4 2 3 1 Storage PathManager Figure 4-2 Setting priority (2) IV-8[...]

Chapter 4 Operating NEC Storage PathManager 4.2 Handli ng a bnorm aliti es 4 4 . . 2 2 H H a a n n d d l l i i n n g g a a b b n n o o r r m m a a l l i i t t i i e e s s 4 . . 2 . 1 F F A Q s a n d t r o u b l e s h o o t i n g 4 4 . 2 2 . . 1 1 F A A Q Q s s a a n n d d t t r r o o u u b b l l e e s s h h o o o o t t i i n n g g If only one path [...]

Chapter 4 Operating NEC Storage PathManager /2/ Select [Sys tem Inform ation] from the tree. /3/ Select [Action] -> [Save as Sy stem Information File...] from th e menu bar. /4/ Specify [File Name]. /5/ Click on [Save]. System information will be collected in a file with the specifie d file name. (2) Disk drive information Use "Device Manag[...]

Chapter 4 Operating NEC Storage PathManager Then starting from step /2/ above, select [Appl ication] instead of [System] t o coll ect application logs using the same proced ures. (5) SPS logs Collect the SPS log file "spsevent.log." If the default installation destina tion of NEC Storage PathManager (C :Program FilesNECSPS) is used, sp[...]

[...]

A p p p e n d i x A A p p p e e n n d d i i x x[...]

Appendix A spscmd Appendix A spscmd [Name] spscmd - Settings for NEC Storag e PathManager and display of its status. [Syntax] spscmd – avail path _number spscmd – failback p ath_number spscmd – failbackal l spscmd – getfbmode spscmd – getlun [-v ] [-s0 | -s1 | -s2] spscmd – getmode spscmd – getmscsmod e spscmd – getver spscmd – ge[...]

Appendix A spscmd spscmd – failba ckall It executes failb ack targeting a ll paths that are unavailable for use. spscmd – getfbm ode It displays the f ailback method currently set. Active: active f ailback Standby: standby fai lback spscmd – getlun [-v] [-s0 | -s1 | -s2] It displays a path li st. It displays a detaile d list if the -v option [...]

Appendix A spscmd It displays settings for path contr ol. Health check: Settin gs for health check (Enable/D isable) Recovery check: Setting s for recovery check (Enable /Disable) Request interval: In terval for iss uing monitoring requests (in seconds) Threshold: Duration of time that a path has not b een used (in seconds). This information is ne [...]

Appendix A spscmd state = Enable or E: MSCS liaison is enabled state = Disable or D : MSCS liaison is disabled spscmd – setwat cher param It sets the sta te of path cont rol to the sta te specified by "param." Specify "param" using fo ur numbers with a colon (:) i n between (param = /1/:/2/: /3/:/4/) /1/ Health check / Re cove[...]

Index Informat ion gatheri ng necessary in case of failur es .. I V-9 A Initial settings ............................................................ IV-3 Installation ........................................................... II-2, II-4 a period of time in whic h paths ha ve not been us ed. II I-19 internal informati on ..........................[...]

Priority size rela tionship ............................................ III-9 ProductId ....................................................................III-6 R Recommended settings for priority ........................... IV-6 Recovery check ........................................................III-17 Registry ...............................[...]