Cnfiguring and Mnitring AS400 Servers 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 AS400 SERVERS...1 1.1 ADMINISTERING THE EG MANAGER TO WORK WITH AN AS400 SERVER...1 1.2 MONITORING THE AS400 SERVER...10 CONCLUSION...11
Table f Figures Figure 1.1: Managing the selected AS400 server...1 Figure 1.2: The uncnfigured tests f the AS400 server...2 Figure 1.3: Cnfiguring the Hst System test...2 Figure 1.4: Cnfiguring the IBM CPU test...4 Figure 1.5: Cnfiguring the AS400 Batch Jbs test...5 Figure 1.6: Cnfiguring the AS400 Message Queues test...6 Figure 1.7: Cnfiguring the AS400 Jb Status test...7 Figure 1.8: Cnfiguring the AS400 User Message Queues test...8
Chapter 1 Cnfiguring and Mnitring AS400 Servers In this chapter, we will be discussing hw t cnfigure and mnitr AS400 servers. 1.1 Administering the eg Manager t wrk with an AS400 Server T achieve the abve, d the fllwing: 1. Lg int the eg administrative interface. 2. Since the eg Enterprise suite des nt autmatically discver the AS400 server in an envirnment, add the cmpnent manually using the ADD/MODIFY COMPONENTS page (Infrastructure -> Cmpnents -> Add/Mdify). Remember that cmpnents manually added are managed autmatically. Discvered cmpnents, hwever, are managed using the COMPONENTS - MANAGE/UNMANAGE page. Figure 1.1 clearly illustrates the prcess f adding the AS400 server. Fr mre details n managing cmpnents, refer t Cnfiguring and Mnitring Web Servers dcument. Figure 1.1: Managing the selected AS400 server 1
3. AS400 servers are by default mnitred in an agentless manner. Accrdingly, the Agentless flag in Figure 1.1 is set t Yes by default. T perfrm agentless mnitring f the AS400 server, select Other as the OS and SNMP as the Mde in Figure 1.1. Then, select a Remte agent and click the Add buttn t manage the server. 4. Next, try t sign ut f the eg administrative interface. 5. A LIST OF UNCONFIGURED TESTS listing the AS400 tests requiring manual cnfiguratin, will appear (see Figure 1.2). Figure 1.2: The uncnfigured tests f the AS400 server 6. Click n the HstSystem test t cnfigure it. Ding s will reveal the Hst System test cnfiguratin page (see Figure 1.3). This test mnitrs the number f users accessing a server, and the prcesses executing n the server. Figure 1.3: Cnfiguring the Hst System test 7. In this page, 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 string SNMPPORT - The prt used t pll fr SNMP statistics (default 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. 2
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 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. 8. Finally, click n the Update buttn f Figure 1.3. 9. When yu try t signut f the eg administrative interface,yu will still be prmpted t cnfigure a set f tests. Click n the IIBM CPU test in the LIST OF UNCONFIGURED TESTS, t cnfigure it. This test mnitrs the CPU usage f an IBM server (RS6000, AS/400, etc.). 3
Figure 1.4: Cnfiguring the IBM CPU test 10. In the test cnfiguratin page that appears (see Figure 1.4), prvide 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 string SNMPPORT - The prt used t pll fr SNMP statistics (default 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. 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. 4
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. 11. Finally, click n the Update buttn f Figure 1.4. 12. Nw it will prmpt t cnfigure the AS400 Batch Jbs test. Figure 1.5: Cnfiguring the AS400 Batch Jbs test 13. In the test cnfiguratin page that appears (see Figure 1.5) prvide the fllwing. TEST PERIOD - Hw ften shuld the test be executed HOST - The hst fr which the test is t be cnfigured PORT - The prt at which the specified HOST listens. By default, this is NULL. SERVERNAME This test cnnects t the AS400 server being mnitred t extract the required metrics. Therefre, specify the name f the AS400 server t cnnect t in the SERVERNAME text bx. USERID T enable the test t lgin t the specified AS400 server, yu need t prvide the test with the credentials f a valid user t the AS400 server. Hence, specify a valid USERID. PASSWORD - Prvide the PASSWORD that crrespnds t the specified USERID. CONFIRM PASSWORD - Cnfirm the passwrd by retyping it in the CONFIRM PASSWORD text bx. 14. Finally, click n the Update buttn f Figure 1.6. Nw, yu will be prmpted t cnfigure the AS400 Message Queues test. 5
Figure 1.6: Cnfiguring the AS400 Message Queues test 15. In the test cnfiguratin page that appears (see Figure 1.6), prvide the fllwing. TEST PERIOD - Hw ften shuld the test be executed HOST - The hst fr which the test is t be cnfigured PORT - The prt at which the specified HOST listens. By default, this is NULL. SERVERNAME This test cnnects t the AS400 server being mnitred t extract the required metrics. Therefre, specify the name f the AS400 server t cnnect t in the SERVERNAME text bx. USERID T enable the test t lgin t the specified AS400 server, yu need t prvide the test with the credentials f a valid user t the AS400 server. Hence, specify a valid USERID. PASSWORD - Prvide the PASSWORD that crrespnds t the specified USERID. CONFIRM PASSWORD - Cnfirm the passwrd by retyping it in the CONFIRM PASSWORD text PATH Indicate the full path t the message queues t be mnitred. 16. Once again, try t signut f the administrative interface. This time yu will be prmpted t cnfigure the AS400 Jb Status test. This test mnitrs the status f defined jb patterns. Clicking n this test will invke Figure 1.7. 6
Figure 1.7: Cnfiguring the AS400 Jb Status test 17. This test takes the fllwing parameters: TEST PERIOD - Hw ften this test needs t be executed. HOST Specify the hst name f the server fr which the test is t be cnfigured has t be specified. PORT Indicates the prt at which the server listens. By default, this is NULL. SERVERNAME - Specify the IP Address/hstname f the AS400 server. USERID - Enter the user name using which this test shuld lgin t the AS400 server. PASSWORD - Mentin the passwrd that crrespnds t the cnfigured USERID in the PASSWORD text bx. CONFIRM PASSWORD - Cnfirm the PASSWORD by retyping it in the CONFIRM PASSWORD text bx. SELECTACTIVE - T mnitr all the jbs in the active state, set SELECTACTIVE t True. By default, this flag is set t True. SELECTJOBQ - T mnitr all the jbs in the JbQ state, set the SELECTJOBQ flag t True. By default, this flag is set t False, indicating that, by default, this test mnitrs nly thse jbs that are nt in the JbQ state. SELECTOUTQ - T mnitr all the jbs with an OutQ status, select the True ptin against SELECTOUTQ. By default, this flag is set t False, indicating that, by default, this test mnitrs nly thse jbs that are nt with an OutQ status. COUNT - By default, the COUNT text bx is set t 10. This indicates that, by default, the detailed diagnsis capability f this test, if enabled, will prvide the details f the tp-10 CPU cnsuming jbs that match the cnfigured patterns. If yu want the detailed diagnsis t include mre number f CPU cnsumers, then yu can change the value f the COUNT parameter accrdingly. JOB - In the JOB text bx, specify the jb patterns t be mnitred, in the fllwing 7
frmat: Name:JbPattern. Here, Name refers t the display name f the jb pattern that will appear as a descriptr f this test in the eg mnitring cnsle. Pattern can be the full name f the jb, r can include wild cards. Fr instance, t mnitr all jbs that begin with the string GLNK, yur JOB specificatin wuld be: DMIRROR:GLNK*. Nte that yur jb patterns cannt include wild card characters in the middle r at the beginning - i.e., fr the example abve, yur specificatin cannt be: DMIRROR:*GLNK r DMIRROR:G*LNK. Multiple jb patterns can be prvided as a cmma-separated list. DD FREQUENCY - Refers t the frequency with which detailed diagnsis measures are t be generated fr this test. The default is 2: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. 18. Finally, click the Update buttn in Figure 1.7. 19. Once again, try t signut f the administrative interface. This time yu will be prmpted t cnfigure the AS400 User Message Queues test. This test mnitrs a specific user s message queues fr cnfigured message patterns. Click n the test t view its cnfiguratin parameters (see Figure 1.8). Figure 1.8: Cnfiguring the AS400 User Message Queues test 8
20. In Figure 1.8, specify the fllwing: TESTPERIOD - Hw ften this test needs t be executed. HOST - The hst name f the server fr which the test is t be cnfigured has t be specified. PORT - Indicates the prt at which the server listens. By default, this is NULL. SERVERNAME Specify IP Address/hstname f the AS400 server. USERID - Enter the user name using which this test shuld lgin t the AS400 server. PASSWORD - Mentin the passwrd that crrespnds t the cnfigured USERID in the PASSWORD text bx. CONFIRM PASSWORD - Cnfirm the PASSWORD by retyping it in the CONFIRM PASSWORD text bx. PATH - Specify the PATH f the user queue t be mnitred. If yu want t mnitr the default message queue fr the cnfigured user, then prvide *CURRENT in the PATH text bx. Please nte that * is mandatry. If yu wuld like t mnitr the message queue f the specific user, yu need t prvide /QSYS.LIB/QUSRSYS.LIB/>>userID<<.MSGQ in the PATH, where user ID represents the ID f the user whse message queue needs t be mnitred. SEARCH PATTERN - Mentin the patterns f messages t be mnitred by the test in SEARCH PATTERN text bx. The frmat f yur specificatin shuld be: DisplayName:Pattern.Here, DisplayName refers t the display name f the SEARCH PATTERN that will appear as the descriptr f this test in the eg mnitring cnsle. Pattern refers t the message pattern(s) t be mnitred. Fr example, yur SEARCH PATTERN can be: RestartDM:*Restart*DM*, where RestartDM is the display name f the pattern, and *Restart*DM* mnitrs all messages cntaining the strings Restart and DM. Multiple search pattern can be prvided as a cmma seperated list. Fr example, RestartDM:*Restart*DM*,MSGWaiting:*There*is*MSGW*,DMI dle:*in*target*dm*status*idle*. DD FREQUENCY - Refers t the frequency with which detailed diagnsis measures are t be generated fr this test. The default is 2: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. 21. Then, click the Update buttn in Figure 1.8. 22. Once again, try t signut f the administrative interface. This time yu will be prmpted 9
t cnfigure the Netwrk Interfaces test. Fr mre details n cnfiguring the Netwrk Interfaces test, refer t Cnfiguring and Mnitring Netwrk Elements dcument. 23. Finally, signut f the eg administrative interface. 1.2 Mnitring the AS400 Server T mnitr the AS400 server, 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 AS400 server being mnitred. 10
Cnclusin Chapter 2 Cnclusin This dcument has described in detail the steps fr cnfiguring and mnitring the AS400 servers. 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. 11