Cnfiguring and Mnitring NetApp Prducts eg Enterprise v5.6
Restricted Rights Legend The infrmatin cntained in this dcument is cnfidential and subject t change withut ntice. N part f this dcument may be reprduced r disclsed t thers withut the prir permissin f eg Innvatins, Inc. eg Innvatins, Inc. makes n warranty f any kind with regard t the sftware and dcumentatin, including, but nt limited t, the implied warranties f merchantability and fitness fr a particular purpse. Trademarks Micrsft Windws, Windws NT, Windws 2000, Windws 2003 and Windws 2008 are either registered trademarks r trademarks f Micrsft Crpratin in United States and/r ther cuntries. The names f actual cmpanies and prducts mentined herein may be the trademarks f their respective wners. Cpyright 2012 eg Innvatins, Inc. All rights reserved.
Table f Cntents CONFIGURING AND MONITORING NETAPP FILERS... 1 1.1 Administering the eg Manager t wrk with a NetApp Filer... 1 1.2 Mnitring the NetApp Filer... 4 CONFIGURING AND MONITORING NETAPP NETCACHE... 5 2.1 Administering the eg Manager t wrk with the NetApp NetCache... 5 2.2 Mnitring the NetApp NetCache... 6 CONFIGURING AND MONITORING THE NETAPP UNIFIED STORAGE SYSTEM... 7 3.1 Hw des eg Enterprise Mnitr the NetApp USD?... 7 3.1.1 Cnfiguring the eg Agent t Receive SNMP Traps frm the NetApp USD... 7 3.1.2 Cnfiguring the eg Agent t Pll the SNMP MIB f the NetApp USD t Pull Out the Metrics... 7 3.1.3 Cnfiguring the eg Agent t Use the NetApp Manageability SDK... 7 3.1.3.1 Creating a New User with the Privileges Required fr Mnitring the NetApp USD... 8 3.2 Administering the eg Manager t mnitr the NetApp Unified Strage system... 10 3.3 Mnitring the NetApp Unified Strage system... 20 CONCLUSION... 21
Table f Figures Figure 1.1: Adding a new NetApp Filer... 1 Figure 1.2: List f uncnfigured tests page listing sme uncnfigured tests fr the NetApp Filer... 2 Figure 1.3: Cnfiguring the NetApp System test... 2 Figure 2.1: Adding a new NetApp NetCache... 5 Figure 2.2: List f uncnfigured tests fr the NetApp NetCache... 6 Figure 3.1: Adding the NetApp Unified Strage system... 10 Figure 3.2: List f tests that need t be cnfigured fr the NetApp Unified Strage system... 10 Figure 3.3: Cnfiguring the NetApp LUNs test... 11 Figure 3.4: Cnfiguring the Cnsistency Pints test... 13 Figure 3.5: Cnfiguring the NetApp Aggregates test... 14 Figure 3.6: Cnfiguring the NetApp Syslg test... 16 Figure 3.7: Cnfiguring the Failure Traps test... 18
C n f i g u r i n g a n d M n i t r i n g N e t A p p F i l e r s Cnfiguring and Mnitring NetApp Filers This chapter explains the prcedures invlved in cnfiguring and mnitring NetApp filers. 1.1 Administering the eg Manager t wrk with a NetApp Filer T achieve the abve, d the fllwing: 1. Lg int the eg administrative interface. 2. Add the NetApp Filer hardware t the eg Enterprise system as illustrated by Figure 1.1. Since the NetApp filer is a nn-prt-based cmpnent, the eg Enterprise system des nt autmatically discver the filer. Therefre, yu need t manually add the filer hardware t the eg Enterprise system. Fr mre details n adding cmpnents, refer t Cnfiguring and Mnitring Web Servers dcument. Figure 1.1: Adding a new NetApp Filer 3. Next, try t sign ut f the eg administrative interface. 4. Upn ding s, a LIST OF UNCONFIGURED TESTS listing the filer-specific tests requiring manual cnfiguratin, will appear (see Figure 1.2). 1
C n f i g u r i n g a n d M n i t r i n g N e t A p p F i l e r s Figure 1.2: List f uncnfigured tests page listing sme uncnfigured tests fr the NetApp Filer 5. Click n the NetApp System test in the list f tests (see Figure 1.2) t cnfigure it (see Figure 1.3). Figure 1.3: Cnfiguring the NetApp System test 6. The NetApp System test reprts usage f system resurces by the NetApp filer. When the test cnfiguratin screen appears (see Figure 1.3), specify the fllwing: TEST PERIOD Hw ften shuld the test be executed HOST - The hst fr which the test is t be cnfigured. SNMPCOMMUNITY - The SNMP cmmunity name that the test uses t cmmunicate with the server. SNMPPORT The prt at which the server expses its SNMP MIB. The default is 161. SNMPVERSION By default, the eg agent supprts SNMP versin 1. Accrdingly, the default selectin in the SNMPVERSION list is v1. Hwever, if a different SNMP framewrk is in use in yur envirnment, say SNMP v2 r v3, then select the crrespnding ptin frm this list. SNMPCOMMUNITY The SNMP cmmunity name that the test uses t cmmunicate with the target device. This parameter is specific t SNMP v1 and v2 nly. Therefre, if the SNMPVERSION chsen is v3, then this parameter will nt appear. USERNAME This parameter appears nly when v3 is selected as the SNMPVERSION. SNMP versin 3 (SNMPv3) is an extensible SNMP Framewrk which supplements the SNMPv2 Framewrk, by additinally supprting message security, access cntrl, and remte SNMP cnfiguratin capabilities. T extract perfrmance statistics frm the MIB using the highly secure SNMP v3 prtcl, the eg agent has t be cnfigured with the required access privileges in ther wrds, the eg agent shuld cnnect t the MIB using the credentials f a user with access permissins t be MIB. Therefre, specify the name f such a user against the USERNAME parameter. 2
C n f i g u r i n g a n d M n i t r i n g N e t A p p F i l e r s AUTHPASS Specify the passwrd that crrespnds t the abve-mentined USERNAME. This parameter nce again appears nly if the SNMPVERSION selected is v3. CONFIRM PASSWORD Cnfirm the AUTHPASS by retyping it here. AUTHTYPE This parameter t appears nly if v3 is selected as the SNMPVERSION. Frm the AUTHTYPE list bx, chse the authenticatin algrithm using which SNMP v3 cnverts the specified USERNAME and PASSWORD int a 32-bit frmat t ensure security f SNMP transactins. Yu can chse between the fllwing ptins: MD5 Message Digest Algrithm SHA Secure Hash Algrithm ENCRYPTFLAG This flag appears nly when v3 is selected as the SNMPVERSION. By default, the eg agent des nt encrypt SNMP requests. Accrdingly, the ENCRYPTFLAG is set t NO by default. T ensure that SNMP requests sent by the eg agent are encrypted, select the YES ptin. ENCRYPTTYPE If the ENCRYPTFLAG is set t YES, then yu will have t mentin the encryptin type by selecting an ptin frm the ENCRYPTTYPE list. SNMP v3 supprts the fllwing encryptin types: DES Data Encryptin Standard AES Advanced Encryptin Standard ENCRYPTPASSWORD Specify the encryptin passwrd here. CONFIRM PASSWORD Cnfirm the encryptin passwrd by retyping it here. TIMEOUT Specify the duratin (in secnds) beynd which the SNMP query issues by this test shuld time ut. The default perid is 10 secnds. DETAILED DIAGNOSIS - T make diagnsis mre efficient and accurate, the eg Enterprise suite embeds an ptinal detailed diagnstic capability. With this capability, the eg agents can be cnfigured t run detailed, mre elabrate tests as and when specific prblems are detected. T enable the detailed diagnsis capability f this test fr a particular server, chse the On ptin. T disable the capability, click n the Off ptin. The ptin t selectively enabled/disable the detailed diagnsis capability will be available nly if the fllwing cnditins are fulfilled: The eg manager license shuld allw the detailed diagnsis capability Bth the nrmal and abnrmal frequencies cnfigured fr the detailed diagnsis measures shuld nt be 0. 7. Finally, click the Update buttn t register the changes. 8. Then, sign ut f the admin interface. 3
C n f i g u r i n g a n d M n i t r i n g N e t A p p F i l e r s SNMP access t the NetApp filer must be enabled fr eg agents t mnitr it. 1.2 Mnitring the NetApp Filer T mnitr the NetApp Filer, d the fllwing: 1. Lgin as a mnitr / supermnitr user. 2. Click n the Cmpnents ptin in the menu bar, and select the Servers ptin frm the Cmpnents menu. 3. Frm the COMPONENT LIST, click n the NetApp Filer being mnitred. 4
C n f i g u r i n g a n d M n i t r i n g N e t A p p N e t C a c h e Cnfiguring and Mnitring NetApp NetCache This chapter will explain the prcess f cnfiguring and mnitring the NetApp NetCache. 2.1 Administering the eg Manager t wrk with the NetApp NetCache T achieve the abve, d the fllwing: 1. Lg int the eg administrative interface. 2. Add the NetApp NetCache t the eg Enterprise system as illustrated by Figure 2.1. Since the NetApp NetCache is a nn-prt-based cmpnent, the eg Enterprise system cannt autmatically discver it. Therefre, yu need t manually add the NetCache t the eg Enterprise system. Fr mre details n adding cmpnents, refer t Cnfiguring and Mnitring Web Servers dcument.. Figure 2.1: Adding a new NetApp NetCache 3. Next, try t sign ut f the eg administrative interface. 4. Upn ding s, a LIST OF UNCONFIGURED TESTS listing the NetCache-specific tests requiring manual cnfiguratin, will appear (see Figure 2.2). 5
C n f i g u r i n g a n d M n i t r i n g N e t A p p N e t C a c h e Figure 2.2: List f uncnfigured tests fr the NetApp NetCache 5. Click n the NetApp System test in the list f tests t cnfigure it. Fr details n hw t cnfigure the NetApp System test, refer t Sectin 1.1. 6. Finally, click the Update buttn t register the changes. 7. Then, sign ut f the admin interface. 2.2 Mnitring the NetApp NetCache T mnitr the NetApp NetCache, d the fllwing: 1. Lgin as a mnitr / supermnitr user. 2. Click n the Cmpnents ptin in the menu bar, and select the Servers ptin frm the Cmpnents menu. 3. Frm the COMPONENT LIST page, click n the NetApp NetCache being mnitred. 6
Cn f i g u r i n g a n d M n i t r i n g t h e N e t A p p U n i f i e d S t r a g e s y s t e m Cnfiguring and Mnitring the NetApp Unified Strage system 3.1 Hw des eg Enterprise Mnitr the NetApp USD? In rder t mnitr a NetApp USD, eg uses best-f-bth-wrlds cmbinatin f SNMP and NetApp Manageability SDK. While a few tests intercept SNMP traps t btain infrmatin f interest, a few thers directly pll the SNMP MIB f the device t pull ut the metrics. Mst tests hwever run the NetApp Manageability SDK cmmands fr metrics cllectin. T knw hw t cnfigure each f these mnitring mechanisms, refer t the sectins belw. 3.1.1 Cnfiguring the eg Agent t Receive SNMP Traps frm the NetApp USD Whenever an SNMP agent detects an errr in an SNMP-enabled netwrk device / applicatin, it sends SNMP traps with the errr infrmatin t a daemn prcess knwn as the SNMP Trap Receiver (Snmptrapd). In the eg Enterprise system, the external agent includes an ptinal SNMP trap receiver that can lg traps it receives int a lg file which can be parsed/interpreted by the external agent. Therefre, t enable the eg external agent which externally mnitrs the NetApp USD t intercept SNMP traps sent ut by that device, yu need t setup Snmptrapd n the external agent hst. The prcedure fr setting up Snmptrapd differs accrding t the perating system f the external agent hst. Fr detailed setup prcedures per perating system, refer t the Handling SNMP Traps using eg Enterprise dcument. Once the Snmptrapd is setup and started, yu need t cnfigure the fllwing tests t integrate with Snmptrapd fr pulling ut the desired metrics: Failure Traps test Shutdwn Traps test Warning Traps test T knw hw t cnfigure these tests, refer t the Mnitring NetApp USD dcument. 3.1.2 Cnfiguring the eg Agent t Pll the SNMP MIB f the NetApp USD t Pull Out the Metrics Yu can cnfigure tests t peridically pll the SNMP MIB f the NetApp USD fr cllecting metrics f interest. Fr this, yu have t SNMP-enable the NetApp USD. 3.1.3 Cnfiguring the eg Agent t Use the NetApp Manageability SDK The NetApp Manageability SDK (NMSDK) prvides resurces t develp applicatins that mnitr and manage NetApp strage systems. 7
Cn f i g u r i n g a n d M n i t r i n g t h e N e t A p p U n i f i e d S t r a g e s y s t e m Many tests that execute n the NetApp USD run API cmmands prvided by this SDK t extract the perfrmance metrics. T run these cmmands, the fllwing pre-requisites need t be fulfilled: An eg remte agent shuld be installed n a remte Windws/Unix hst in the envirnment. This remte agent shuld be assigned t the target strage device when managing that device using the eg administrative interface. The eg remte agent shuld be able t access the target strage device. The NMSDK shuld be available n the eg remte agent hst. T achieve this, fllw the steps discussed belw: Dwnlad the NMSDK frm the fllwing URL t any lcatin n the remte agent hst: http://supprt.netapp.cm/now/cgi-bin/sftware T dwnlad the NMSDK, yu will have t create a NOW lgin; t achieve this, g t the fllwing URL: http://supprt.netapp.cm The NMSDK will be dwnladed as a zip file named netapp-manageability-sdk- <SDK_versin>.zip. Extract the cntents f the zip file t any lcatin n the eg remte agent hst. Next, cpy the netapp-manageability-sdk-<sdk_versin>\netapp-manageability-sdk- <SDK_versin>\lib\java\classes\managentap.jar file frm the extracted cntents t the <EG_AGENT_INSTALL_DIR>\lib directry (n a Windws hst; n Unix, this will be the /pt/egurkha/lib directry). Then, start the eg agent. T invke the API cmmands, the eg agent has t be cnfigured with the privileges f a NetApp user with the fllwing privileges: lgin-http-admin,api-aggr-check-spare-lw,api-aggr-list-inf,apiaggr-mediascrub-list-inf,api-aggr-scrub-list-inf,api-cifs-status,api-clne-list-status,apidisk-list-inf,api-fcp-adapter-list-inf,api-fcp-adapter-stats-list-inf,api-fcp-servicestatus,api-file-get-file-inf,api-file-read-file,api-iscsi-cnnectin-list-inf,api-iscsi-initiatrlist-inf,api-iscsi-service-status,api-iscsi-sessin-list-inf,api-iscsi-stats-list-inf,api-luncnfig-check-alua-cnflicts-inf,api-lun-cnfig-check-cfmde-inf,api-lun-cnfig-checkinf,api-lun-cnfig-check-single-image-inf,api-lun-list-inf,api-nfs-status,api-perf-bjectget-instances-iter*,api-perf-bject-instance-list-inf,api-quta-reprt-iter*,api-snapshtlist-inf,api-vfiler-list-inf,api-vlume-list-inf-iter* Fr this purpse, yu can either grant the afresaid privileges t an existing user, r create a new user fr this purpse. The new user creatin prcess has been detailed in 3.1.3.1 belw. Once such a user is created, make sure that yu cnfigure the eg tests with the credentials f such a user. 3.1.3.1 Creating a New User with the Privileges Required fr Mnitring the NetApp USD As mentined earlier, t run the API cmmands prvided by the NMSDK and cllect metrics, the eg agent requires the fllwing privileges: lgin-http-admin,api-aggr-check-spare-lw,api-aggr-list-inf,apiaggr-mediascrub-list-inf,api-aggr-scrub-list-inf,api-cifs-status,api-clne-list-status,api-disklist-inf,api-fcp-adapter-list-inf,api-fcp-adapter-stats-list-inf,api-fcp-service-status,api-fileget-file-inf,api-file-read-file,api-iscsi-cnnectin-list-inf,api-iscsi-initiatr-list-inf,api-iscsiservice-status,api-iscsi-sessin-list-inf,api-iscsi-stats-list-inf,api-lun-cnfig-check-aluacnflicts-inf,api-lun-cnfig-check-cfmde-inf,api-lun-cnfig-check-inf,api-lun-cnfig-check- 8
Cn f i g u r i n g a n d M n i t r i n g t h e N e t A p p U n i f i e d S t r a g e s y s t e m single-image-inf,api-lun-list-inf,api-nfs-status,api-perf-bject-get-instances-iter*,api-perfbject-instance-list-inf,api-quta-reprt-iter*,api-snapsht-list-inf,api-vfiler-list-inf,apivlume-list-inf-iter* T create a new user with the afresaid privileges, d the fllwing: 1. Lgin t the system hsting the remte agent. 2. Cnnect t the strage cntrller s cnsle via SSH (say, using putty.exe). 3. Run the fllwing cmmand at the cnsle t create a new rle: useradmin rle add <Name_f_new_rle> -c "<A_brief_descriptin_f_new_rle>" -a <Cmmaseparated_list_f_privileges_t_be_granted_t_the_new_rle> Fr instance, t create a rle named eg_rle with all the privileges required fr mnitring NetApp USD, the cmmand will be as fllws: useradmin rle add eg_rle -c "rle fr eg user" -a lgin-http-admin,api-aggr-check-spare-lw,api-aggrlist-inf,api-aggr-mediascrub-list-inf,api-aggr-scrub-list-inf,api-cifs-status,api-clne-list-status,apidisk-list-inf,api-fcp-adapter-list-inf,api-fcp-adapter-stats-list-inf,api-fcp-service-status,api-file-get-fileinf,api-file-read-file,api-iscsi-cnnectin-list-inf,api-iscsi-initiatr-list-inf,api-iscsi-service-status,apiiscsi-sessin-list-inf,api-iscsi-stats-list-inf,api-lun-cnfig-check-alua-cnflicts-inf,api-lun-cnfigcheck-cfmde-inf,api-lun-cnfig-check-inf,api-lun-cnfig-check-single-image-inf,api-lun-list-inf,apinfs-status,api-perf-bject-get-instances-iter*,api-perf-bject-instance-list-inf,api-quta-reprt-iter*,apisnapsht-list-inf,api-vfiler-list-inf,api-vlume-list-inf-iter* 4. Once the rle is created successfully, prceed t create a new user grup and assign the newly created rle t it. The cmmand fr this will be: useradmin grup add <Name_f_new_grup> -c "<A_brief_descriptin_f_new_grup>" -r <Name_f_new_rle> Fr instance, t create a grup named eg_grup and t assign the eg_rle t it, the cmmand will be as fllws: useradmin grup add eg_grup -c "Grup fr eg user" -r eg_rle 5. Then, create a new user and add that user t the newly created grup. The cmmand fr the same is as fllws: useradmin user add Mname_f_new_user> -c "<A_brief_descriptin_f_new_user>" -g <Name_f_new_grup> Fr instance, t create a user named eg_user and t add that user t the eg_grup that yu created previusly, the cmmand will be as fllws: useradmin user add eg_user -c "User fr eg t mnitr NetApp" -g eg_grup This cmmand, upn executin, will request fr the passwrd f the new user. The passwrd is casesensitive, and shuld be atleast 8 characters lng. It must cntain atleast 2 alphabets and 1 digit. New passwrd: ReType new passwrd: Then, cnfirm the new user s passwrd by retyping it. 9
Cn f i g u r i n g a n d M n i t r i n g t h e N e t A p p U n i f i e d S t r a g e s y s t e m 3.2 Administering the eg Manager t mnitr the NetApp Unified Strage system T administer the eg Manager t mnitr the NetApp Unified Strage system, d the fllwing: 1. Lg int the eg administrative interface. 2. eg Enterprise cannt autmatically discver the NetApp Unified Strage system. Yu need t manually add the strage system using the ADD/MODIFY COMPONENTS page (see Figure 3.1) that appears when the Infrastructure -> Cmpnents -> Add/Mdify menu sequence is fllwed. Remember that cmpnents manually added are managed autmatically. Figure 3.1: Adding the NetApp Unified Strage system 3. When yu attempt t sign ut, a list f uncnfigured tests will appear as shwn in Figure 3.2. Figure 3.2: List f tests that need t be cnfigured fr the NetApp Unified Strage system 4. Click n the NetApp LUNs test in Figure 3.2 t cnfigure it. This test aut-discvers the LUNs cnfigured n the NetApp Unified Strage system, mnitrs the availability, state, and the prcessing ability f each LUN. 10
Cn f i g u r i n g a n d M n i t r i n g t h e N e t A p p U n i f i e d S t r a g e s y s t e m Figure 3.3: Cnfiguring the NetApp LUNs test 5. T cnfigure the test, specify the fllwing in Figure 3.3. TEST PERIOD - Hw ften shuld the test be executed HOST The IP address f the strage device. PORT - Specify the prt at which the specified HOST listens in the PORT text bx. By default, this is NULL. USER - Here, specify the name f the user wh pssesses the fllwing privileges: lgin-httpadmin,api-aggr-check-spare-lw,api-aggr-list-inf,api-aggr-mediascrub-list-inf,apiaggr-scrub-list-inf,api-cifs-status,api-clne-list-status,api-disk-list-inf,api-fcpadapter-list-inf,api-fcp-adapter-stats-list-inf,api-fcp-service-status,api-file-get-fileinf,api-file-read-file,api-iscsi-cnnectin-list-inf,api-iscsi-initiatr-list-inf,api-iscsiservice-status,api-iscsi-sessin-list-inf,api-iscsi-stats-list-inf,api-lun-cnfig-checkalua-cnflicts-inf,api-lun-cnfig-check-cfmde-inf,api-lun-cnfig-check-inf,apilun-cnfig-check-single-image-inf,api-lun-list-inf,api-nfs-status,api-perf-bjectget-instances-iter*,api-perf-bject-instance-list-inf,api-quta-reprt-iter*,apisnapsht-list-inf,api-vfiler-list-inf,api-vlume-list-inf-iter*. If such a user des nt pre-exist, then, yu can create a special user fr this purpse using the steps detailed in Sectin 3.1.3.1 f this dcument. PASSWORD - Specify the passwrd that crrespnds t the abve-mentined USER. CONFIRM PASSWORD - Cnfirm the PASSWORD by retyping it here. AUTHENTICATION MECHANISM In rder t cllect metrics frm the NetApp Unified Strage system, the eg agent cnnects t the ONTAP management APIs ver HTTP r HTTPS. By default, this cnnectin is authenticated using the LOGIN_PASSWORD authenticatin mechanism. This is why, LOGIN_PASSWORD is displayed as the default AUTHENTICATION MECHANISM. USE SSL - Set the USE SSL flag t Yes, if SSL (Secured Scket Layer) is t be used t cnnect t the NetApp Unified Strage System, and N if it is nt. API PORT - By default, in mst envirnments, NetApp Unified Strage system listens n prt 80 11
Cn f i g u r i n g a n d M n i t r i n g t h e N e t A p p U n i f i e d S t r a g e s y s t e m (if nt SSL-enabled) r n prt 443 (if SSL-enabled) nly. This implies that while mnitring the NetApp Unified Strage system, the eg agent, by default, cnnects t prt 80 r 443, depending upn the SSL-enabled status f the NetApp Unified Strage system - i.e., if the NetApp Unified Strage system is nt SSL-enabled (i.e., if the USE SSL flag abve is set t N), then the eg agent cnnects t the NetApp Unified Strage system using prt 80 by default, and if the NetApp Unified Strage system is SSL-enabled (i.e., if the USE SSL flag is set t Yes), then the agent- NetApp Unified Strage system cmmunicatin ccurs via prt 443 by default. Accrdingly, the API PORT parameter is set t default by default. In sme envirnments hwever, the default prts 80 r 443 might nt apply. In such a case, against the API PORT parameter, yu can specify the exact prt at which the NetApp Unified Strage system in yur envirnment listens, s that the eg agent cmmunicates with that prt fr cllecting metrics frm the NetApp Unified Strage system. VFILERNAME - A vfiler is a virtual strage system yu create using MultiStre, which enables yu t partitin the strage and netwrk resurces f a single strage system s that it appears as multiple strage systems n the netwrk. If the NetApp Unified Strage system is partitined t accmmdate a set f vfilers, specify the name f the vfiler that yu wish t mnitr in the VFILERNAME text bx. In sme envirnments, the NetApp Unified Strage system may nt be partitined at all. In such a case, the NetApp Unified Strage system is mnitred as a single vfiler and hence the default value f nne is displayed in this text bx. OPERATIONS THRESHOLD - This test nt nly reprts a set f metrics fr each LUN n the strage device, but als reprts metrics fr the fllwing descriptrs: Busy LUNs and Slw LUNs. The OPERATIONS THRESHOLD value (in peratins/sec) yu set determines which LUNs will be cunted as Busy LUNs by this test. Typically, if the rate f peratins t a LUN exceeds the rate specified against OPERATIONS THRESHOLD, then the test will cnsider such a vlume t be a Busy LUN. This measure is deprecated frm v5.6.5. AVG LATENCY THRESHOLD - This test nt nly reprts a set f metrics fr each LUN n the strage device, but als reprts metrics fr the fllwing descriptrs: Busy LUNs and Slw LUNs. The AVG LATENCY THRESHOLD value (in millisecnds) yu set determines which LUNs will be cunted as Slw LUNs by this test. Typically, if the latency registered by a LUN exceeds the AVG LATENCY THRESHOLD yu specify, then the test will cnsider such a vlume t be a Slw LUN. The default value mentined here is 20ms. This measure is deprecated frm v5.6.5. TIMEOUT - Specify the duratin (in secnds) beynd which the test will timeut if n respnse is received frm the device. The default is 120 secnds. DD FREQUENCY - Refers t the frequency with which detailed diagnsis measures are t be generated fr this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time this test runs, and als every time the test detects a prblem. Yu can mdify this frequency, if yu s desire. Als, if yu intend t disable the detailed diagnsis capability fr this test, yu can d s by specifying nne against DD FREQUENCY. DETAILED DIAGNOSIS - T make diagnsis mre efficient and accurate, the eg Enterprise suite embeds an ptinal detailed diagnstic capability. With this capability, the eg agents can be cnfigured t run detailed, mre elabrate tests as and when specific prblems are detected. T enable the detailed diagnsis capability f this test fr a particular server, chse the On ptin. T disable the capability, click n the Off ptin. The ptin t selectively enabled/disable the detailed diagnsis capability will be available nly if the fllwing cnditins are fulfilled: The eg manager license shuld allw the detailed diagnsis capability Bth the nrmal and abnrmal frequencies cnfigured fr the detailed diagnsis measures shuld nt be 0. 6. Then, click the Update buttn in Figure 3.3, t save the changes. 12
Cn f i g u r i n g a n d M n i t r i n g t h e N e t A p p U n i f i e d S t r a g e s y s t e m 7. Nw, when yu try t signut f the administrative interface, yu will be prmpted t cnfigure a list f tests. Click n the Cnsistency Pints test frm the list t cnfigure it as shwn in Figure 3.4. 8. Specify the fllwing in Figure 3.4: Figure 3.4: Cnfiguring the Cnsistency Pints test TEST PERIOD - Hw ften shuld the test be executed HOST The IP address f the device. PORT - Specify the prt at which the specified HOST listens in the PORT text bx. By default, this is NULL. SNMPPORT - The prt number thrugh which the device expses its SNMP MIB. The default value is 161. SNMPVERSION By default, the eg agent supprts SNMP versin 1. Accrdingly, the default selectin in the SNMPVERSION list is v1. Hwever, if a different SNMP framewrk is in use in yur envirnment, say SNMP v2 r v3, then select the crrespnding ptin frm this list. SNMPCOMMUNITY The SNMP cmmunity name that the test uses t cmmunicate with the Cisc ruter. This parameter is specific t SNMP v1 and v2 nly. Therefre, if the SNMPVERSION chsen is v3, then this parameter will nt appear. USERNAME This parameter appears nly when v3 is selected as the SNMPVERSION. SNMP versin 3 (SNMPv3) is an extensible SNMP Framewrk which supplements the SNMPv2 Framewrk, by additinally supprting message security, access cntrl, and remte SNMP cnfiguratin capabilities. T extract perfrmance statistics frm the MIB using the highly secure SNMP v3 prtcl, the eg agent has t be cnfigured with the required access privileges in ther wrds, the eg agent shuld cnnect t the MIB using the credentials f a user with access permissins t be MIB. Therefre, specify the name f such a user against the USERNAME parameter. AUTHPASS Specify the passwrd that crrespnds t the abve-mentined USERNAME. This parameter nce again appears nly if the SNMPVERSION selected is v3. CONFIRM PASSWORD Cnfirm the AUTHPASS by retyping it here. AUTHTYPE This parameter t appears nly if v3 is selected as the SNMPVERSION. Frm the AUTHTYPE list bx, chse the authenticatin algrithm using which SNMP v3 cnverts the specified USERNAME and PASSWORD int a 32-bit frmat t ensure security f SNMP 13
Cn f i g u r i n g a n d M n i t r i n g t h e N e t A p p U n i f i e d S t r a g e s y s t e m transactins. Yu can chse between the fllwing ptins: MD5 Message Digest Algrithm SHA Secure Hash Algrithm ENCRYPTFLAG This flag appears nly when v3 is selected as the SNMPVERSION. By default, the eg agent des nt encrypt SNMP requests. Accrdingly, the ENCRYPTFLAG is set t NO by default. T ensure that SNMP requests sent by the eg agent are encrypted, select the YES ptin. ENCRYPTTYPE If the ENCRYPTFLAG is set t YES, then yu will have t mentin the encryptin type by selecting an ptin frm the ENCRYPTTYPE list. SNMP v3 supprts the fllwing encryptin types: DES Data Encryptin Standard AES Advanced Encryptin Standard ENCRYPTPASSWORD Specify the encryptin passwrd here. CONFIRM PASSWORD Cnfirm the encryptin passwrd by retyping it here. TIMEOUT - Specify the duratin (in secnds) within which the SNMP query executed by this test shuld time ut in the TIMEOUT text bx. The default is 10 secnds. 9. Click the Update buttn and try t signut f the administrative interface. Once again, yu will be prmpted t cnfigure a list f tests. Select the NetApp Aggregates test t cnfigure it. Figure 3.5: Cnfiguring the NetApp Aggregates test 10. Specify the fllwing in Figure 3.5 t cnfigure the NetApp Aggregates test. TEST PERIOD - Hw ften shuld the test be executed HOST The IP address f the strage device. PORT - Specify the prt at which the specified HOST listens in the PORT text bx. By default, this is NULL. USER - Here, specify the name f the user wh pssesses the fllwing privileges: lgin-httpadmin,api-aggr-check-spare-lw,api-aggr-list-inf,api-aggr-mediascrub-list-inf,apiaggr-scrub-list-inf,api-cifs-status,api-clne-list-status,api-disk-list-inf,api-fcp- 14
Cn f i g u r i n g a n d M n i t r i n g t h e N e t A p p U n i f i e d S t r a g e s y s t e m adapter-list-inf,api-fcp-adapter-stats-list-inf,api-fcp-service-status,api-file-get-fileinf,api-file-read-file,api-iscsi-cnnectin-list-inf,api-iscsi-initiatr-list-inf,api-iscsiservice-status,api-iscsi-sessin-list-inf,api-iscsi-stats-list-inf,api-lun-cnfig-checkalua-cnflicts-inf,api-lun-cnfig-check-cfmde-inf,api-lun-cnfig-check-inf,api-luncnfig-check-single-image-inf,api-lun-list-inf,api-nfs-status,api-perf-bject-getinstances-iter*,api-perf-bject-instance-list-inf,api-quta-reprt-iter*,api-snapshtlist-inf,api-vfiler-list-inf,api-vlume-list-inf-iter*. If such a user des nt pre-exist, then, yu can create a special user fr this purpse using the steps detailed in Sectin 3.1.3.1 f this dcument. PASSWORD - Specify the passwrd that crrespnds t the abve-mentined USER. CONFIRM PASSWORD - Cnfirm the PASSWORD by retyping it here. AUTHENTICATION MECHANISM In rder t cllect metrics frm the NetApp Unified Strage system, the eg agent cnnects t the ONTAP management APIs ver HTTP r HTTPS. By default, this cnnectin is authenticated using the LOGIN_PASSWORD authenticatin mechanism. This is why, LOGIN_PASSWORD is displayed as the default AUTHENTICATION MECHANISM. USE SSL - Set the USE SSL flag t Yes, if SSL (Secured Scket Layer) is t be used t cnnect t the NetApp Unified Strage System, and N if it is nt. API PORT - By default, in mst envirnments, NetApp Unified Strage system listens n prt 80 (if nt SSL-enabled) r n prt 443 (if SSL-enabled) nly. This implies that while mnitring the NetApp Unified Strage system, the eg agent, by default, cnnects t prt 80 r 443, depending upn the SSL-enabled status f the NetApp Unified Strage system - i.e., if the NetApp Unified Strage system is nt SSL-enabled (i.e., if the USE SSL flag abve is set t N), then the eg agent cnnects t the NetApp Unified Strage system using prt 80 by default, and if the NetApp Unified Strage system is SSL-enabled (i.e., if the USE SSL flag is set t Yes), then the agent- NetApp Unified Strage system cmmunicatin ccurs via prt 443 by default. Accrdingly, the API PORT parameter is set t default by default. In sme envirnments hwever, the default prts 80 r 443 might nt apply. In such a case, against the API PORT parameter, yu can specify the exact prt at which the NetApp Unified Strage system in yur envirnment listens, s that the eg agent cmmunicates with that prt fr cllecting metrics frm the NetApp Unified Strage system. VFILERNAME - A vfiler is a virtual strage system yu create using MultiStre, which enables yu t partitin the strage and netwrk resurces f a single strage system s that it appears as multiple strage systems n the netwrk. If the NetApp Unified Strage system is partitined t accmmdate a set f vfilers, specify the name f the vfiler that yu wish t mnitr in the VFILERNAME text bx. In sme envirnments, the NetApp Unified Strage system may nt be partitined at all. In such a case, the NetApp Unified Strage system is mnitred as a single vfiler and hence the default value f nne is displayed in this text bx. TIMEOUT - Specify the duratin (in secnds) beynd which the test will timeut if n respnse is received frm the device. The default is 120 secnds. TRANSFERS THRESHOLD - Yu can set a threshld value fr the rate at which the transfers are serviced by an aggregate. Specifying such a value in the TRANSFERS THRESHOLD text bx implies that the aggregates vilating this threshld value will be termed as Busy aggregates. This measure is deprecated frm v5.6.5. DD FREQUENCY - Refers t the frequency with which detailed diagnsis measures are t be generated fr this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time this test runs, and als every time the test detects a prblem. Yu can mdify this frequency, if yu s desire. Als, if yu intend t disable the detailed diagnsis capability fr this test, yu can d s by specifying nne against DD FREQUENCY. 15
Cn f i g u r i n g a n d M n i t r i n g t h e N e t A p p U n i f i e d S t r a g e s y s t e m DETAILED DIAGNOSIS - T make diagnsis mre efficient and accurate, the eg Enterprise suite embeds an ptinal detailed diagnstic capability. With this capability, the eg agents can be cnfigured t run detailed, mre elabrate tests as and when specific prblems are detected. T enable the detailed diagnsis capability f this test fr a particular server, chse the On ptin. T disable the capability, click n the Off ptin. The ptin t selectively enabled/disable the detailed diagnsis capability will be available nly if the fllwing cnditins are fulfilled: The eg manager license shuld allw the detailed diagnsis capability Bth the nrmal and abnrmal frequencies cnfigured fr the detailed diagnsis measures shuld nt be 0. 11. Then, Click the Update buttn and signut f the eg administrative interface. Nw yu will be prmpted t cnfigure the Netapp Syslg test. Figure 3.6: Cnfiguring the NetApp Syslg test 12. T cnfigure the Netapp Syslg test, specify the fllwing in Figure 3.6. TEST PERIOD - Hw ften shuld the test be executed HOST The IP address f the strage device. PORT - Specify the prt at which the specified HOST listens in the PORT text bx. By default, this is NULL. USER - Here, specify the name f the user wh pssesses the fllwing privileges: lgin-httpadmin,api-aggr-check-spare-lw,api-aggr-list-inf,api-aggr-mediascrub-list-inf,apiaggr-scrub-list-inf,api-cifs-status,api-clne-list-status,api-disk-list-inf,api-fcpadapter-list-inf,api-fcp-adapter-stats-list-inf,api-fcp-service-status,api-file-get-fileinf,api-file-read-file,api-iscsi-cnnectin-list-inf,api-iscsi-initiatr-list-inf,api-iscsiservice-status,api-iscsi-sessin-list-inf,api-iscsi-stats-list-inf,api-lun-cnfig-checkalua-cnflicts-inf,api-lun-cnfig-check-cfmde-inf,api-lun-cnfig-check-inf,api-luncnfig-check-single-image-inf,api-lun-list-inf,api-nfs-status,api-perf-bject-getinstances-iter*,api-perf-bject-instance-list-inf,api-quta-reprt-iter*,api-snapsht- 16
Cn f i g u r i n g a n d M n i t r i n g t h e N e t A p p U n i f i e d S t r a g e s y s t e m list-inf,api-vfiler-list-inf,api-vlume-list-inf-iter* If such a user des nt pre-exist, then, yu can create a special user fr this purpse using the steps detailed in Sectin 3.1.3.1 f this dcument. PASSWORD - Specify the passwrd that crrespnds t the abve-mentined USER. CONFIRM PASSWORD - Cnfirm the PASSWORD by retyping it here. AUTHENTICATION MECHANISM In rder t cllect metrics frm the NetApp Unified Strage system, the eg agent cnnects t the ONTAP management APIs ver HTTP r HTTPS. By default, this cnnectin is authenticated using the LOGIN_PASSWORD authenticatin mechanism. This is why, LOGIN_PASSWORD is displayed as the default AUTHENTICATION MECHANISM. USE SSL - Set the USE SSL flag t Yes, if SSL (Secured Scket Layer) is t be used t cnnect t the NetApp Unified Strage System, and N if it is nt. API PORT - By default, in mst envirnments, NetApp Unified Strage system listens n prt 80 (if nt SSL-enabled) r n prt 443 (if SSL-enabled) nly. This implies that while mnitring the NetApp Unified Strage system, the eg agent, by default, cnnects t prt 80 r 443, depending upn the SSL-enabled status f the NetApp Unified Strage system - i.e., if the NetApp Unified Strage system is nt SSL-enabled (i.e., if the USE SSL flag abve is set t N), then the eg agent cnnects t the NetApp Unified Strage system using prt 80 by default, and if the NetApp Unified Strage system is SSL-enabled (i.e., if the USE SSL flag is set t Yes), then the agent- NetApp Unified Strage system cmmunicatin ccurs via prt 443 by default. Accrdingly, the API PORT parameter is set t default by default. In sme envirnments hwever, the default prts 80 r 443 might nt apply. In such a case, against the API PORT parameter, yu can specify the exact prt at which the NetApp Unified Strage system in yur envirnment listens, s that the eg agent cmmunicates with that prt fr cllecting metrics frm the NetApp Unified Strage system. VFILERNAME - A vfiler is a virtual strage system yu create using MultiStre, which enables yu t partitin the strage and netwrk resurces f a single strage system s that it appears as multiple strage systems n the netwrk. If the NetApp Unified Strage system is partitined t accmmdate a set f vfilers, specify the name f the vfiler that yu wish t mnitr in the VFILERNAME text bx. In sme envirnments, the NetApp Unified Strage system may nt be partitined at all. In such a case, the NetApp Unified Strage system is mnitred as a single vfiler and hence the default value f nne is displayed in this text bx. SYSLOG FULL PATH - Specify the full path t the mst recent syslg file in the SYSLOG FULL PATH text bx. The default value displayed in this text bx is /vl/vl0/etc/messages SEARCHPATTERN - Enter the specific patterns f alerts t be mnitred. The pattern shuld be in the fllwing frmat: <PatternName>:<Pattern>, where <PatternName> is the pattern name that will be displayed in the mnitr interface and <Pattern> is the pattern that yu need t search fr in the lg file. The <Pattern> can either be a text string r an expressin f the frm *expr*. Fr example, say yu specify Inf_Msgs:inf in the SEARCHPATTERN text bx. This indicates that "Inf_Msgs" is the pattern name t be displayed in the mnitr interface. The value "inf" indicates that the test will mnitr nly thse lines in the syslg which cntain the string "inf". Similarly, if yur pattern specificatin reads: Errr_Msgs:vl*errr, then it means that the pattern name is Errr_Msgs and the test will mnitr nly thse lines in the syslg which begin with the string vl and end with the string errr. Multiple search patterns can be specified as a cmma-separated list. Fr example: Inf_Msgs:inf,Errr_Msgs:vl*errr TIMEOUT - Specify the duratin (in secnds) beynd which the test will timeut if n respnse is 17
Cn f i g u r i n g a n d M n i t r i n g t h e N e t A p p U n i f i e d S t r a g e s y s t e m received frm the device. The default is 120 secnds. DD FREQUENCY - Refers t the frequency with which detailed diagnsis measures are t be generated fr this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time this test runs, and als every time the test detects a prblem. Yu can mdify this frequency, if yu s desire. Als, if yu intend t disable the detailed diagnsis capability fr this test, yu can d s by specifying nne against DD FREQUENCY. DETAILED DIAGNOSIS - T make diagnsis mre efficient and accurate, the eg Enterprise suite embeds an ptinal detailed diagnstic capability. With this capability, the eg agents can be cnfigured t run detailed, mre elabrate tests as and when specific prblems are detected. T enable the detailed diagnsis capability f this test fr a particular server, chse the On ptin. T disable the capability, click n the Off ptin. The ptin t selectively enabled/disable the detailed diagnsis capability will be available nly if the fllwing cnditins are fulfilled: The eg manager license shuld allw the detailed diagnsis capability Bth the nrmal and abnrmal frequencies cnfigured fr the detailed diagnsis measures shuld nt be 0. 13. When yu finish cnfiguring the Netapp Syslg test and try t signut f the eg administrative interface, yu will be prmpted t cnfigure the Failure Traps test. Figure 3.7: Cnfiguring the Failure Traps test 14. Specify the fllwing in Figure 3.7 t cnfigure the Failure Traps test. TESTPERIOD - Hw ften shuld the test be executed HOST - The hst fr which the test is t be cnfigured. SOURCEADDRESS - Specify a cmma-separated list f IP addresses r address patterns f the hsts frm which traps are cnsidered in this test. Fr example, 10.0.0.1,192.168.10.*. A leading '*' signifies any number f leading characters, while a trailing '*' signifies any number f trailing characters. OIDVALUE - Prvide a cmma-separated list f OID and value pairs returned by the traps. The values are t be expressed in the frm, DisplayName:OID-OIDValue. Fr example, assume that the fllwing OIDs are t be cnsidered by this test:.1.3.6.1.4.1.9156.1.1.2 and.1.3.6.1.4.1.9156.1.1.3. The values f these OIDs are as given hereunder: OID Value.1.3.6.1.4.1.9156. 1.1.2 Hst_system 18
Cn f i g u r i n g a n d M n i t r i n g t h e N e t A p p U n i f i e d S t r a g e s y s t e m.1.3.6.1.4.1.9156. 1.1.3 NETWORK In this case the OIDVALUE parameter can be cnfigured as Trap1:.1.3.6.1.4.1.9156.1.1.2- Hst_system,Trap2:.1.3.6.1.4.1.9156.1.1.3-Netwrk, where Trap1 and Trap2 are the display names that appear as descriptrs f this test in the mnitr interface. An * can be used in the OID/value patterns t dente any number f leading r trailing characters (as the case may be). Fr example, t mnitr all the OIDs that return values which begin with the letter 'F', set this parameter t Failed:*-F*. Typically, if a valid value is specified fr an OID in the OID-value pair cnfigured, then the test cnsiders the cnfigured OID fr mnitring nly when the actual value f the OID matches with its cnfigured value. Fr instance, in the example abve, if the value f OID.1.3.6.1.4.1.9156.1.1.2 is fund t be HOST and nt Hst_system, then the test ignres OID.1.3.6.1.4.1.9156.1.1.2 while mnitring. In sme cases hwever, an OID might nt be assciated with a separate value instead, the OID itself might represent a value. While cnfiguring such OIDs fr mnitring, yur OIDVALUE specificatin shuld be: DisplayName:OID-any. Fr instance, t ensure that the test mnitrs the OID.1.3.6.1.4.1.9156.1.1.5, which in itself, say represents a failure cnditin, then yur specificatin wuld be: Trap5:.1.3.6.1.4.1.9156.1.1.5-any. SHOWOID Specifying true against SHOWOID will ensure that the detailed diagnsis f this test shws the OID strings alng with their crrespnding values. If yu enter false, then the values alne will appear in the detailed diagnsis page, and nt the OIDs. TRAPOIDS By default, this parameter is set t all, indicating that the eg agent cnsiders all the traps received frm the specified SOURCEADDRESSes. T make sure that the agent cnsiders nly specific traps received frm the SOURCEADDRESS, then prvide a cmma-separated list f OIDs in the TRAPOIDS text bx. A series f OID patterns can als be specified here, s that the test cnsiders nly thse OIDs that match the specified pattern(s). Fr instance, *94.2*,*.1.3.6.1.4.25*, where * indicates leading and/r trailing spaces. DD FREQUENCY - Refers t the frequency with which detailed diagnsis measures are t be generated fr this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time this test runs, and als every time the test detects a prblem. Yu can mdify this frequency, if yu s desire. Als, if yu intend t disable the detailed diagnsis capability fr this test, yu can d s by specifying nne against DD FREQUENCY. DETAILED DIAGNOSIS - T make diagnsis mre efficient and accurate, the eg Enterprise suite embeds an ptinal detailed diagnstic capability. With this capability, the eg agents can be cnfigured t run detailed, mre elabrate tests as and when specific prblems are detected. T enable the detailed diagnsis capability f this test fr a particular server, chse the On ptin. T disable the capability, click n the Off ptin. The ptin t selectively enabled/disable the detailed diagnsis capability will be available nly if the fllwing cnditins are fulfilled: The eg manager license shuld allw the detailed diagnsis capability Bth the nrmal and abnrmal frequencies cnfigured fr the detailed diagnsis measures shuld nt be 0. 15. Nw, click the Update buttn and signut f the eg administrative interface. This time yu will be prmpted t cnfigure the Disk Health Mnitr Events test, Shutdwn Traps test, Virus Scanner Traps test and the Warning Traps test. Cnfigure the tests ne after the ther as discussed in Step 14. 19
Cn f i g u r i n g a n d M n i t r i n g t h e N e t A p p U n i f i e d S t r a g e s y s t e m 16. Finally, signut f the eg administrative interface. 3.3 Mnitring the NetApp Unified Strage system T mnitr the NetApp Unified Strage system, d the fllwing: 1. Lgin as a mnitr / supermnitr user. 2. Click n the cmpnents ptin in the menu bar, and select the Servers ptin frm the cmpnents menu. 3. Frm the cmpnent list page, click n the NetApp Unified Strage system fr which yu wish t view measurements. 20
C n c l u s i n Cnclusin This dcument has described in detail the steps fr cnfiguring and mnitring the NetApp Prducts. Fr details f hw t administer and use the eg Enterprise suite f prducts, refer t the user manuals. We will be adding new measurement capabilities int the future versins f the eg Enterprise suite. If yu can identify new capabilities that yu wuld like us t incrprate in the eg Enterprise suite f prducts, please cntact supprt@eginnvatins.cm. We lk frward t yur supprt and cperatin. Any feedback regarding this manual r any ther aspects f the eg Enterprise suite can be frwarded t feedback@eginnvatins.cm. 21