English dropdown-ico

NEC PathManager manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

Go to page of

Similar user manuals

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of NEC PathManager, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of NEC PathManager one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of NEC PathManager. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of NEC PathManager should contain:
- informations concerning technical data of NEC PathManager
- name of the manufacturer and a year of construction of the NEC PathManager item
- rules of operation, control and maintenance of the NEC PathManager item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of NEC PathManager alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of NEC PathManager, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the NEC service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of NEC PathManager.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the NEC PathManager item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

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

  • Page 2

    © 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.[...]

  • Page 3

    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 [...]

  • Page 4

    [...]

  • Page 5

    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 --------------------------------------[...]

  • Page 6

    [...]

  • Page 7

    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[...]

  • Page 8

    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[...]

  • Page 9

    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[...]

  • Page 10

    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[...]

  • Page 11

    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[...]

  • Page 12

    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 [...]

  • Page 13

    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[...]

  • Page 14

    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[...]

  • Page 15

    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[...]

  • Page 16

    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 [...]

  • Page 17

    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[...]

  • Page 18

    [...]

  • Page 19

    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[...]

  • Page 20

    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[...]

  • Page 21

    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[...]

  • Page 22

    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[...]

  • Page 23

    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[...]

  • Page 24

    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: [...]

  • Page 25

    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 [...]

  • Page 26

    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[...]

  • Page 27

    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[...]

  • Page 28

    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[...]

  • Page 29

    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 [...]

  • Page 30

    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[...]

  • Page 31

    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[...]

  • Page 32

    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[...]

  • Page 33

    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) [...]

  • Page 34

    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[...]

  • Page 35

    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 [...]

  • Page 36

    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] [...]

  • Page 37

    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[...]

  • Page 38

    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[...]

  • Page 39

    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[...]

  • Page 40

    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[...]

  • Page 41

    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[...]

  • Page 42

    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[...]

  • Page 43

    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[...]

  • Page 44

    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[...]

  • Page 45

    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[...]

  • Page 46

    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[...]

  • Page 47

    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[...]

  • Page 48

    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 [...]

  • Page 49

    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[...]

  • Page 50

    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[...]

  • Page 51

    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:[...]

  • Page 52

    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[...]

  • Page 53

    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[...]

  • Page 54

    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[...]

  • Page 55

    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 [...]

  • Page 56

    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[...]

  • Page 57

    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[...]

  • Page 58

    [...]

  • Page 59

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

  • Page 60

    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[...]

  • Page 61

    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 [...]

  • Page 62

    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 [...]

  • Page 63

    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[...]

  • Page 64

    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 ..........................[...]

  • Page 65

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