SysMaster 설치안내서 SysMaster v4.0 Fix #1 Copyright 2011 TmaxSoft Co., Ltd. All Rights Reserved.
Copyright Notice Copyright 2011 TmaxSoft Co., Ltd. All Rights Reserved. 대한민국경기도성남시분당구서현동 272-6 우 )463-721 Restricted Rights Legend All TmaxSoft Software (Tmax SysMaster ) and documents are protected by copyright laws and the Protection Act of Computer Programs, and international convention. TmaxSoft software and documents are made available under the terms of the TmaxSoft License Agreement and may only be used or copied in accordance with the terms of this agreement. No part of this document may be transmitted, copied, deployed, or reproduced in any form or by any means, electronic, mechanical, or optical, without the prior written consent of TmaxSoft Co., Ltd. 이소프트웨어 (Tmax SysMaster ) 사용설명서의내용과프로그램은저작권법, 컴퓨터프로그램보호법및국제조약에의해서보호받고있습니다. 사용설명서의내용과여기에설명된프로그램은 TmaxSoft Co., Ltd. 와의사용권계약하에서만사용이가능하며, 사용권계약을준수하는경우에만사용또는복제할수있습니다. 이사용설명서의전부또는일부분을 Tmaxsoft의사전서면동의없이전자, 기계, 녹음등의수단을사용하여전송, 복제, 배포, 2차적저작물작성등의행위를하여서는안됩니다. Trademarks Tmax SysMaster is a registered trademark of TmaxSoft Co., Ltd. Other products, titles or services may be reg istered trademarks of their respective companies. Tmax SysMaster 은 TmaxSoft Co., Ltd. 의등록상표입니다. 기타모든제품들과회사이름은각각해당소유주의상표로서참조용으로만사용됩니다. Open Source Software Disclaimer This product includes various open source software that has been developed and/or licensed by OpenSSL, RSA Data Security, Inc., Apache Foundation, or Jean-loup Gailly and Mark Adler. TmaxSoft fully respects the aforementioned parties and the open source software used in this product. More details can be found within the directory ${INSTALL_PATH}/license/oss_licenses 본제품은 OpenSSL, RSA Data Security, Inc., Apache Foundation 및 Jean-loup Gailly와 Mark Adler 에의해개발또는라이선스된오픈소스소프트웨어를포함합니다. 오픈소스소프트웨어와개발자에대해경의를표합니다. 관련상세정보는제품의디렉터리 ${INSTALL_PATH}/license/oss_licenses 에기재된사항을참고해주십시오. 안내서정보안내서제목 : SysMaster 설치안내서발행일 : 2011-12-30 소프트웨어버전 : SysMaster v4.0 Fix #1 안내서버전 : v2.1.2
내용목차 안내서에대하여... vii 제1장 SysMaster 소개... 1 1.1. 개요... 1 1.2. 설치전확인사항... 2 1.3. 시스템환경... 3 1.4. 설치순서... 4 제2장 MASTER 설치... 5 2.1. Repository DB 설정... 5 2.1.1. Repository DB 요구사항... 5 2.1.2. 생성 DB Table 구조... 5 2.1.3. SQL 파일실행... 6 2.2. Master 설치... 6 2.2.1. Master 설치... 7 2.2.2. Master의디렉터리구조... 14 2.2.3. Master 환경설정확인... 15 2.3. JEUS 설치내역확인... 31 2.3.1. JEUS의디렉터리구조... 18 2.3.2. 라이선스확인... 19 2.3.3. 바이너리파일확인... 19 2.3.4. JEUS 환경설정확인... 19 2.3.5. 내장 WebtoB 환경설정확인... 27 2.4. Master 기동과종료... 31 2.4.1. Master 기동... 29 2.4.2. WEB UI 실행... 30 2.4.3. Master 종료... 30 2.5. Master FileJOB 설정... 31 제3장 Agent 설치... 33 3.1. 개요... 33 3.2. Agent 설치... 33 3.3. Agent의디렉터리구조... 37 3.4. Agent 환경설정및등록... 38 3.4.1. 환경설정... 38 3.4.2. Agent 등록... 40 3.5. Agent 기동과종료... 43 3.5.1. Agent 기동... 43 3.5.2. Agent 종료... 43 제4장 리소스등록... 45 4.1. 리소스등록전처리사항... 45 4.1.1. 리소스별 SQL 문장수행... 45 SysMaster iii
4.1.2. 리소스별압축파일 (*.zip) 업데이트... 46 4.1.3. 리소스별 WEB UI 압축파일추가... 47 4.1.4. 리소스등록환경확인... 47 4.2. WAS 리소스등록... 48 4.2.1. WEB UI에서리소스등록... 49 4.2.2. 환경설정... 51 4.2.3. sminst_rt.jar 파일생성... 53 4.2.4. libdcagent library 파일복사... 55 4.2.5. JEUSMain.xml 파일수정... 56 4.2.6. JEUS 및 Agent 재기동... 57 4.3. Oracle 리소스등록... 57 4.3.1. WEB UI에서리소스등록... 58 4.3.2. DB User 생성및 Table 생성... 62 4.3.3. ORACLE DC 설정... 62 4.3.4. oradc.cfg 파일설정... 64 4.3.5. Trace/Object File 수집을위한 FileJOB 설정... 67 4.4. AnyLink 리소스등록... 69 4.4.1. WEB UI에서리소스등록... 69 4.4.2. Hooking Engine/DC 설치및설정... 71 4.4.3. Table 생성및 Gateway 속성등록... 77 4.4.4. 대역폭모니터링설정값입력... 78 4.4.5. Trace File 수집을위한 FileJob 설정... 79 4.4.6. TMAXADM 서비스설정... 81 iv SysMaster 설치안내서
그림목차 [ 그림 2.1] WEB UI 실행화면... 30 [ 그림 3.1] Agent 추가화면... 41 [ 그림 3.2] Agent 추가완료화면... 42 [ 그림 4.1] 리소스등록확인... 48 [ 그림 4.2] WAS 리소스등록... 49 [ 그림 4.3] Oracle 리소스등록... 58 [ 그림 4.4] Oracle 리소스등록확인... 59 [ 그림 4.5] AnyLink 리소스등록... 69 [ 그림 4.6] AnyLink 리소스등록확인... 71 SysMaster v
안내서에대하여 안내서의대상 본안내서는여러서버에산재해있는애플리케이션들의성능을통합관리하기위한 APM(Application Performance Management) 솔루션인 SysMaster ( 이하 SysMaster) 제품을설치하고운영하려는사용자를대상으로기술한다. 안내서의전제조건 본안내서는 SysMaster를설치하는데필요한과정과 SysMaster의기본적인개념을기술한안내서이다. 본안내서를원활히이해하기위새서는다음과같은사항을미리알고있어야한다. UNIX 기본명령어에대한이해 SysMaster가지원하는각종자원들에대한이해 TP-Monitor, WAS, 웹서버, 애플리케이션서버등 데이터배이스에대한기본지식 안내서의제한조건 본안내서는 SysMaster 를실무에적용하거나운용하는데필요한모든사항을포함하고있지않다. 따라 서 SysMaster 의세부적인환경설정과운용및관리에대해서는각제품안내서를참고하기바란다. 안내서에대하여 vii
안내서구성 설치하기안내서는총 4개의장과 Appendix로이루어져있다. 각장의주요내용은다음과같다. 제1장 : SysMaster 소개 SysMaster의기본개념과특징, SysMaster를설치하기전에확인해야할사항을기술한다. 제2장 : Master 설치 SysMaster를설치하는과정을 DB 테이블생성, Master 설치, WEB UI 설치로나누어기술한다. 제3장 : Agent 설치 Agent를설치하는과정을기술한다. 제4장 : 리소스등록 SysMaster가모니터링을하는대상인리소스를등록하는방법을기술한다. viii SysMaster 설치안내서
안내서규약 표기 <AaBbCc123> <Ctrl>+C [Button] 진하게 " "( 따옴표 ) ' 입력항목 ' 하이퍼링크 > +---- ---- 참고 [ 그림 1.1] [ 표 1.1] AaBbCc123 의미프로그램소스코드의파일명 Ctrl과 C를동시에누름 GUI의버튼또는메뉴이름강조다른관련안내서또는안내서내의다른장및절언급화면 UI에서입력항목에대한설명메일계정, 웹사이트메뉴의진행순서하위디렉터리또는파일있음하위디렉터리또는파일없음참고또는주의사항그림이름표이름명령어, 명령어수행후화면에출력된결과물, 예제코드 안내서에대하여 ix
연락처 Korea TmaxSoft Co., Ltd 272-6 Seohyeon-dong, Bundang-gu, Seongnam-si, Gyeonggi-do, 463-721 South Korea Tel: +82-31-8018-1000 Fax: +82-31-8018-1115 Email: info@tmax.co.kr Web (Korean): http://www.tmax.co.kr 기술지원 : http://technet.tmaxsoft.com USA TmaxSoft, Inc. 560 Sylvan Avenue Englewood Cliffs, NJ 07632 U.S.A Tel: +1-201-567-8266 Fax: +1-201-567-7339 Email: info@tmaxsoft.com Web (English): http://www.tmaxsoft.com Japan TmaxSoft Japan Co., Ltd. 5F Sanko Bldg, 3-12-16 Mita, Minato-Ku, Tokyo, 108-0073 Japan Tel: +81-3-5765-2550 Fax: +81-3-5765-2567 Email: info@tmaxsoft.co.jp Web (Japanese): http://www.tmaxsoft.co.jp x SysMaster 설치안내서
China TmaxSoft China Co., Ltd. Beijing Silver Tower, RM 1508, 2# North Rd Dong San Huan, Chaoyang District, Beijing, China, 100027 China Tel: +86-10-6410-6145~8 Fax: +86-10-6410-6144 Email: info.cn@tmaxsoft.com Web (Chinese): http://www.tmaxsoft.com.cn 안내서에대하여 xi
제 1 장 SysMaster 소개 본장에서는 SysMaster 의기본개념과특징, SysMaster 를설치하기전에확인해야할사항을설명한다. 1.1. 개요 SysMaster는여러서버에산재해있는여러종류의자원들의성능을통합하여관리하기위한제품이다. 이를만족시키기위해서 SysMaster는웹서버, WAS, TP-Monitor, 애플리케이션서버등 (provider 군 ) 시스템전반에걸친모든자원들을통합하여관리할수있도록하였고보다직관적인화면을제공하여사용자가여러형태의자원을하나의뷰에서모니터링할수있도록하였다. SysMaster는 WEB UI를통해자원들을실시간상태를감시할수있고효율적인자원관리및장애대책을지원한다. 시스템전반의모든자원의효율적인성능관리, 보다빠른장애감지및처리, 각종통계 report 를통한체계적인시스템성능관리를할수있다. SysMaster는다양한형태의관리환경을제공하며관리환경을사용자임의대로편집할수있도록하여사용자의리소스중원하는정보에보다효율적으로접근할수있도록하였다. 참고 본안내서에서는 SysMaster 가제공하는모니터링대상제품군을프로바이더 (Provider) 라고하고, 개개의모니터링단위와인스턴스를리소스 (Resource) 라고한다. 다음은 SysMaster의특징이다. 다양한자원의성능을통합관리한다. 성능및장애대책의설계를지원한다. 하드웨어및운영체제에독립적이다. 사용자가편집가능한 WEB UI 환경을지원한다. 사용자정의관리기능을제공한다. 다양한형태의모니터링화면을제공한다. 통계정보조회및레포트를제공한다. 제 1 장 SysMaster 소개 1
1.2. 설치전확인사항 SysMaster 를설치하기전에는다음의사항을미리확인해야한다. 계정정보 Master와 Agent, DB를같은머신과같은계정에설치하여도기능상문제는없지만, 각각다른머신, 다른계정에설치할것을강력히권장하는바이다. 특히, WAS, DB 등모니터링을지원할경우에는설치되는머신의성능을고려하여적절히부하를분산할수있도록해야한다. Agent는 root( 슈퍼유저 ) 계정이거나혹은지원할 Resource와동일한계정인것이좋다. root계정도아니고, 동일한계정도아닐경우, 모니터링을할때권한관련문제가발생할수있다. 또한 Resource 계정으로설치할경우, Resource 계정마다 Agent를설치해야한다. DB 자원정보 DB(Database) 를위해필요한자원은다음과같다. DB 용량 SysMaster 운영을위해기본 1GB의크기가필요하며, 기타지원 Resource의종류와수, 해당사이트의운영원칙에따라 DB의크기를설정하도록한다. 보통 Resource 하나당 1GB 이상을추가로확장할것을권장한다. Master, Agent, WEB UI의용량설치머신의해당계정에각각최소 512MB 이상의디스크용량을확보해야한다. 라이선스발급 SysMaster의 Master를기동하기위해서는라이선스 (License) 파일및라이선스와관련된 library 파일이필요하다. SysMaster 라이선스발급과관련된절차는담당영업대표및엔지니어에게문의하거나, 관련부서에게직접요청하여발급받을수있다. 담당영업대표및엔지니어에게문의할수없는경우, 본안내서의서두에서언급된 TmaxSoft의연락처로문의하도록한다. 2 SysMaster 설치안내서
1.3. 시스템환경 시스템요구사항 SysMaster 를설치하기위해필요한 S/W 와 H/W 는다음과같다. 표기 Platform 요구사항 IBM AIX 5L 32/64 bit IBM AIX 6L 32/64 bit HP-UX 11 32 /64 bit HP-UX 11 32/64 bit ia64 Solaris 7-10 32/64 bit Solaris 32(x86) bit Linux Kernel 2.x/2.x ia64 Windows Win32 Master JDK 1.5 Memory 1024MB 이상권장 ( 최소 512MB) 최소 1GB 하드디스크공간 Agent JDK 1.5 Memory 512MB 이상권장 ( 최소 256MB) 최소 512MB 하드디스크공간 WEB UI JRE 1.6 Memory 512MB 이상권장 ( 최소 256MB) 최소 512MB 하드디스크공간 DataBase Oracle 10g 이후 Tibero 3.x 이후 제 1 장 SysMaster 소개 3
리소스요구사항 SysMaster 설치를위한리소스요구사항은다음과같다. Resource AnyLink JEUS WebLogic Websphere Oracle AS Oracle 지원버전 3.2.x 이후 4.x 이후 9.x 10.x 5.x 6.x 9.x 10g 이후 1.4. 설치순서 SysMaster의설치순서는다음과같다. 1. DB 테이블생성 2. Master 설치 3. WEB UI 설치 (JEUS 6 설치 ) 4. Agent 설치 5. Resource 등록 4 SysMaster 설치안내서
제 2 장 MASTER 설치 본장에서는 SysMaster 를설치하는과정을 DB Table 생성, Master 설치, Web UI 설치로나누어설명한 다. 2.1. Repository DB 설정 SysMaster는자체의정보와각종리소스 ( WAS, Oracle, AnyLink, Base) 의통계정보를비롯한메타정보들을 DB에저장하므로 DB는 SysMaster 운영에필수조건이다. 본절에서는 SysMaster 설치에필요한 DB가이미설치되어있다고가정하고기본요구사항및 Table을생성하는방법에대해서설명한다. 2.1.1. Repository DB 요구사항 SysMaster는동시에여러리소스를관리하고통계정보및실행정보를 DB에저장하기때문에관리되는리소스의개수및실행액션에비례하여 DB 용량이추가로요구된다. 통계및실행액션의운영방법에의해서많이달라질수있으므로최초 SysMaster 설치과정에담당엔지니어와충분한협의를거친후사용될 DB의용량을결정해야한다. 2.1.2. 생성 DB Table 구조 DB Table 은관리측면에서총 3 가지로분류할수있다. 구분 Base Table Resource Table Site Table 설명기본적인운영및공통기능관련된 Table로운영에필요한기본 Table로반드시생성되어야한다. 리소스운영에필요한 Table로해당자원이설치되는경우해당리소스의 Table을반드시생성해주어야한다. 사이트별로요구되는사항을정의하는 Table로사용자관련 Table이나사이트별로별도로추가기능에필요한내용으로생성한다. Table 생성이끝난후에는다음의순서에따라서 Table에기본적으로요구되는데이터를 Insert 해주어야한다. 1. Base Table 설치및데이터 Insert 2. Resouce Table 설치및데이터 Insert 제 2 장 MASTER 설치 5
3. Site Table 설치및데이터 ( 필요한경우진행 ) 2.1.3. SQL 파일실행 DB Table을생성하기위해서 SQL 파일을실행한다. SysMaster에서지원해야하는제품의수에상관없이기본적으로실행해야하는 SQL 파일은다음의 4가지이다. base ddl base stat ddl base dml resource was ddl 설치 SQL 정보 다음은 Master 설치시반드시실행해야하는 SQL 파일의목록이다. BASE SQL sysmaster-base-ddl.sql sysmaster-base-ddl-stat.sql sysmaster-base-dml.sql WAS 지원 SQL sysmaster-resource-was-ddl.sql 2.2. Master 설치 Master 설치과정을요약하면다음과같다. 1. Master 설치 2. Master 디렉터리구조 3. Master 환경설정확인 4. Master 기동 5. Master 종료 6. WEB UI 실행 참고 Master 는 JDK 1.5 이상만지원한다, 6 SysMaster 설치안내서
2.2.1. Master 설치 최초설치파일은 SysMaster4_0_Master_Agent.bin 으로존재한다. 참고 제공되는 Installer 는 no JVM(Java 가포함되어있지않은 Installer) 으로서설치되는서버에반드시 jvm 1.5 이상이설치되어있어야한다. Master의설치순서는다음과같다. 1. 다음과같이 SysMaster4_0_Master_Agent.bin 파일의실행권한설정한뒤에실행한다. tmaxi7@jachun:/data1/jachun/master4>./sysmaster4_0_master_agent.bin Preparing to install... Extracting the installation resources from the installer archive... Configuring the installer for this system's environment... Launching installer... Preparing CONSOLE Mode Installation... =============================================================================== SysMaster4.0 Fix#1 (created with InstallAnywhere by Macrovision) ------------------------------------------------------------------------------- =============================================================================== Installation cannot proceed --------------------------- Installer couldn?t find supported architectures and os To choose platform, click 'change'. To cancel the installation, click 'Quit'. APPLIES TO : HP-UX HP-UX IA64 AIX 5L Solaris 7~10 Linux 2.X Linux 2.X IA64 32bit/64bit 32bit/64bit 32bit/64bit 32bit/64bit 32bit/64bit 32bit/64bit ->1- Quit 2- Change 제 2 장 MASTER 설치 7
ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 2 =============================================================================== Introduction ------------ InstallAnywhere will guide you through the installation of SysMaster4.0 Fix#1. It is strongly recommended that you quit all programs before continuing with this installation. Respond to each prompt to proceed to the next step in the installation. want to change something on a previous step, type 'back'. If you You may cancel this installation at any time by typing 'quit'. PRESS <ENTER> TO CONTINUE: 2. 라이선스준수화면이나타난다. =============================================================================== License Agreement ----------------- Installation and Use of SysMaster4.0 Fix#1 Requires Acceptance of the Following License Agreement: SysMaster This Software is made by 'TmaxSoft Co.,Ltd.' and this software is distributed under our license agreement. Software End-User License Agreement Product : SysMaster This is a legal agreement between you (either an individual or an entity) and TmaxSoft, Incorporated. By opening the sealed software package and/or by using the software, you agree to be bound by the terms of this agreement. SysMaster Software License 1. Grant of License: This SysMaster Software License Agreement ("License") permits you to use one copy of the TmaxSoftware product Tmax, on any single 8 SysMaster 설치안내서
computer, provided the software is in use on only one computer at any one time. If this package is a license pack, you may make and use additional copies of the software up to the number of licensed copies authorized. If you have multiple licenses for the software, then at any time you may have as many copies of the software in use as you have licenses. The software is "in use" on a computer when it is loaded into the temporary PRESS <ENTER> TO CONTINUE: 3. 라이선스동의여부를묻는다. 동의한다면 y 를입력후 <ENTER> 키를누른다. PRESS <ENTER> TO CONTINUE: DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): y 4. 목록중에서설치할 Install Set 을고른다. Master를설치할것임으로 1을입력한뒤 <ENTER> 키를누른다. Choose Install Set ------------------ Please choose the Install Set to be installed by this installer. ->1- Master 2- Agent 3- Only Provider ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS <ENTER> TO ACCEPT THE DEFAULT : 5. 목록중에서설치할플래폼을선택한다. =========================================================================== Choose Platform --------------- Choose current system ( platform-architecture ) 1)HP-UX 2)HP-UX IA64 3)AIX 5L 4)AIX 6L 5)Solaris 7 ~ 10 6)Linux 2.X 7)Linux 2.X IA64 Quit) Quit Installer Choose Current System (DEFAULT: ): 6. 커널의 bit를선택한다. =========================================================================== Choose Kernel Bit Please Choose Kernel Bit? ->1-32bit 제 2 장 MASTER 설치 9
2-64bit 3- previous ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 7. JDK 의경로를설정한다. =============================================================================== Choose JDK Folder ----------------- Please Choose a Folder: Input User JDK Folder (DEFAULT: /usr/java5_64): 8. Master의정보를설정한다. =============================================================================== Choose Install Master Folder ---------------------------- Where would you like to install? (DEFAULT: /data1/jachun/sysmaster) : /data1/jachun/master4 =============================================================================== Directory Check --------------- User Specified Directory exists. To overwrite SysMaster4.0, click 'Overwrite'. To choose a Different directory, click 'Change'. To cancel the installation, click 'Cancel'. ->1- Overwrite 2- Change... 3- Cancel ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT =============================================================================== Password Input -------------- Enter the Password for the administrator account. This password will be registered in JEUS as the first user. Input Password: jeusadmin 10 SysMaster 설치안내서
Confirm Password: jeusadmin =========================================================================== Choose Master Infomation ------------------------ Master IP (DEFAULT: 192.168.1.87): Master BASE PORT (DEFAULT: 22000): JEUS BASE PORT (DEFAULT: 9736): WEBTOB BASE PORT (DEFAULT: 8080): 9. 사용할 DB를선택한다. =============================================================================== Choose DB type --------------- 1- Oracle 2- Tibero ENTER A COMMA-SEPARATED LIST OF NUMBERS REPRESENTING THE DESIRED CHOICES, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 2 10. DB 정보를설정한다. =============================================================================== Get Tibero JDBC Data Source --------------------------- Enter requested information Tibero Hostname (DEFAULT: 192.168.1.87): Tibero Database Name (DEFAULT: tibero): Tibero User Name (DEFAULT: tibero): sm40fix1 Tibero Password (DEFAULT: ): sm40fix1 Tibero listener port number (DEFAULT: 8629): 11. 프로바이더설치여부문의한다. =============================================================================== Install Provider 제 2 장 MASTER 설치 11
---------------- Do you wish to install Provider file? ->1- YES 2- NO ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 12. 설치할프로바이더를선택한다. 다수의프로바이더를설치하고자할때에는콤마 (,) 로구분한다. (ex. was를선택했을경우진행 ) ================================================================ Choose Provider --------------- 1- was ENTER A COMMA-SEPARATED LIST OF NUMBERS REPRESENTING THE DESIRED CHOICES, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 1 =============================================================================== Get Was DC ---------- Master IP (DEFAULT: 192.168.1.87): Master Base Port (DEFAULT: 22000): DC Host IP (DEFAULT: 192.168.1.87): DC Base Port (DEFAULT: 23000): DC State Port (DEFAULT: 23006): Resource ID (DEFAULT: R003): Node Container (DEFAULT: tmaxi7.container1): =============================================================================== Install Provider Change ----------------------- You Choose was Do you wish to change Provider file? Choose Yes or No ->1- NO 12 SysMaster 설치안내서
2- YES ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 13. 설치가진행되기전에설정한정보를보여준다. <ENTER> 키를눌러설치를진행한다. =============================================================================== Pre-Installation Summary ------------------------ Please Review the Following Before Continuing: Product Name: SysMaster4.0 Fix#1 Disk Space Information (for Installation Target): Required: 597,896,099 bytes Available: 39,289,208,832 bytes PRESS <ENTER> TO CONTINUE: 14. 설치완료되면다음과같은화면이나타난다. =============================================================================== Installing... ------------- [================== ================== ================== ==================] [------------------ ------------------ ------------------ ------------------] =============================================================================== Installation Complete --------------------- Congratulations. SysMaster4.0 Fix#1 has been successfully installed to: /data1/jachun/master4/fix1 PRESS <ENTER> TO EXIT THE INSTALLER: 제 2 장 MASTER 설치 13
2.2.2. Master 의디렉터리구조 Master의설치가완료되면다음과같은디렉터리가생성된다. Master가설치될디렉터리를 sysmaster로정한경우이다. $sysmaster +- master +- bin +- config +- files +- jeus +- lib +- license +- logs +- provider +- sqls +- UninstallerData +- update bin smadmin, smmaster 등의실행파일이위치한다. config Master 운영에필요한속성파일들이위치한다. files Master 운영에필요한파일이위치한다. jeus JEUS 에서설치된파일들이위치한다. lib 라이브러리파일이위치한다. license 라이센스파일이위치한다. logs 로그파일이저장되는디렉터리이다. provider SysMaster가제공하는프로바이더의 *.zip, *.sql, Console 파일등이위치한다. sqls Master 운영에필요한기본 DB 구성 SQL 문장이위치한다. UninstallData SysMaster 삭제작업관련파일이위치한다. 14 SysMaster 설치안내서
update Master, Agent, Console 의자동업데이트를위한신규파일들이위치한다. 2.2.3. Master 환경설정확인 설치과정에서설정했던값들중일부가다음의파일에정의되어있다. $SYSMASTER_HOME/config/sysmaster.properties $SYSMASETR_HOME/bin/smmaster.env $SYSMASTER_HOME/bin/smmaster 위의파일은 Master를기동하는데필요한기본적인속성들을정의한다. JEUS 환경설정확인은 2.3. JEUS 설치내역확인 를참고한다. 참고 Master/WEB UI의 Timezone과 Agent 의 Timezone 이다르면동일한시간값이라도다르게표시될수있다. Master가기동하는중에시간정보를갱신하지않는다는것을주의한다. 시간설정은각 OS 별로차이가있기때문에, 해당 OS의매뉴얼을참고한다. SysMaster의환경설정파일은다음과같다. 수정된내용을확인한다.(smdown 파일은수정되지않는다.) sysmaster.properties database 설정내용및 hostname이정상적으로반영이되었는지확인한다. # DB for General db.vendor=oracle db.datasource.refname=system #db.client.charset= #db.server.charset= #db.encode=false... 중략 ############################################################################################## # # [ NETWORK ] # # master.hostname Master Hostname(IPAddress) # # master.hostname Master Hostname(IPAddress) # ############################################################################################## master.hostname=192.168.1.89 제 2 장 MASTER 설치 15
항목 db.vendor master.hostname 설명 설정된 database vendor 가반영되었는지확인한다.(oracle, tibero) master server 의 IP 가반영되었는지확인한다.(Master IP) sysmasgter.properties에서의 FileJOB 설정 Table이정상적으로설치되었다면 SysMaster가 DB에접속하기위한 URL을설정해주어야한다. 자세한내용은 Master 환경설정을참고한다. # DB for DbLoader stat.dbloader.vendor=tibero stat.dbloader.fullpath=/data1/jachun/tibero4/client/bin/tbloader stat.dbloader.sid=tibero stat.dbloader.username=sm40_fix1 stat.dbloader.password=sm40_fix1 #stat.dbloader.password.encrypt= stat.dbloader.tablespace=ts_sm4 stat.dbloader.index.tablespace=ts_sm4 #stat.dbloader.locale.language= smmaster.env smmaster.env는 SysMaster 바이너리설치과정에서이미입력하여설정된값이다. 제대로반영이되었는지확인한다. # # For customizing SysMaster environment. # # set up SYSMASTER_HOME. SYSMASTER_HOME=/data1/jachun/master4/fix1_release # set up SYSMASTER_BASEPORT. SYSMASTER_BASEPORT=22000 # set up JEUS_HOME. JEUS_HOME=$SYSMASTER_HOME/jeus # set up SYSMASTER_LOGPATH. SYSMASTER_LOGPATH=$SYSMASTER_HOME/logs # set up SYSMASTER_JAVA_ARGS. SYSMASTER_JAVA_ARGS="-Dsysmaster.home=$SYSMASTER_HOME -Dsysmaster.port=$SYSMASTER_BASEPORT -Djeus.home=$JEUS_HOME" # set up JAVA_HOME. JAVA_HOME=/usr/java5_64 16 SysMaster 설치안내서
# setup JAVA_ARGS. JAVA_ARGS="-Xms32m -Xmx64m" export SYSMASTER_HOME SYSMASTER_BASEPORT SYSMASTER_LOGPATH SYSMASTER_JAVA_ARGS export JEUS_HOME JAVA_HOME JAVA_ARGS 다음은각항목에대한설명이다. 항목 SYSMASTER_HOME SYSMASTER_BASEPORT JEUS_HOME SYSMASTER_LOGPATH SYSMASTER_JAVA_ARGS JAVA_HOME, JAVA_ARGS 설명설치디렉터리이다. BASEPORT(Default: 22000) 설정된포트에 +1 ~ +7까지의포트가자동으로설정된다. $SYSMASTER_HOME/jeus로설정한다. $SYSMASTER_HOME/logs로설정한다. 추가설정사항은없다. 추가설정사항은없다. SYSMASTER_BASEPORT에대한설명 / Agent와의통신포트는양방향모두개봉해야한다. masterportrmiregistry = baseport; masterportjrmpadaptor = baseport + 1; masterportrequest = baseport + 2; masterporteventserver = baseport + 3; asterporteventreceiverserver = baseport + 4; masterportfileserver = baseport + 5; masterportstatserverdefault = baseport + 6; masterporttxserverdefault = baseport + 7; smmaster Installer가실행될때설정했던 password 값이정상적으로반영이되었는지확인한다. # # Set up SysMaster master environment values. #. smmaster.env echo "***************************************************************" echo " - SysMaster Home : ${SYSMASTER_HOME} " echo " - SysMaster Base Port : ${SYSMASTER_BASEPORT} " echo "***************************************************************" # # Update SysMaster master library. # 제 2 장 MASTER 설치 17
echo "/usr/java5_64/bin/java -classpath $BOOTSTRAP_CLASSPATH $SYSMASTER_JAVA_ARGS sysmaster.startup.master.updatebootstrap F*" $JAVA_HOME/bin/java -classpath $BOOTSTRAP_CLASSPATH $SYSMASTER_JAVA_ARGS sysmaster.startup.master.updatebootstrap F* # # Start up SysMaster master. # $JEUS_HOME/bin/jeus -xml -Uadministrator -Pjeusadmin 다음은 JEUS 기동설정하는방법이다. $JEUS_HOME/bin/jeus -xml -Uadministrator -P{ 설정했던패스워드 } 2.3. JEUS 설치내역확인 2.3.1. JEUS 의디렉터리구조 $MASTER_HOME +- jeus +- bin +- config +- lib +- license +- logs +- webhome +- webserver +- UninstallerData 각디렉터리용도에대한설명은 "JEUS 6.0 Menual" 을참고한다. 2.3.2. 라이선스확인 SysMaster 라이선스 $SYSMASTER_HOME/license/license.dat JEUS 라이선스 $SYSMASTER_HOME/jeus/license/license.dat 파일확인 18 SysMaster 설치안내서
2.3.3. 바이너리파일확인 JEUS_HOME/lib/application 폴더파일확인 JEUS_HOME/lib/application 폴더에다음의파일이있는지확인한다. US_export_policy.jar libsmlic.a activation.jar libsmlic.so commons-cli.jar libsmlic64.a commons-codec.jar libsmlic64.so commons-collections.jar local_policy.jar commons-configuration-1.6.jar log4j.jar commons-dbcp.jar mail.jar commons-fileupload-1.2.jar ognl-2.6.11.jar commons-httpclient.jar oro.jar commons-io-1.3.2.jar poi-3.6-20091214.jar commons-lang-2.4.jar sqlbuilder-2.0.5.jar commons-logging.jar sqlbuilder-util-1.0.4.jar commons-net-1.4.0.jar struts2-core-2.0.11.jar commons-pool.jar sysmaster-base-bootstrap.jar commons-primitives.jar sysmaster-base.jar freemarker-2.3.8.jar webt30.jar jmxri.jar xwork-2.0.4.jar json_simple-1.1.jar 참고 각운영체제에맞는라이센스라이브러리를 $JEUS_HOME/lib/system 폴더에넣는다. webhome 폴더확인 SysMaster 의 Master 기동후에는 sysmaster 폴더를확인할수있다. $SYSMASTER_HOME/jeus/webhome/sysmaster 2.3.4. JEUS 환경설정확인 다음은 JEUS 환경설정파일에적용되는 SysMaster4.0 내용이다. JEUSMain.xml 수정 Container에서 servlet engine을확인한다. <engine-container> <name>container1</name> <command-option>-xms512m -Xmx1024m -Dsysmaster.name=container1 제 2 장 MASTER 설치 19
-XX:+HeapDumpOnOutOfMemoryError</command-option> <engine-command> <type>servlet</type> <name>engine1</name> </engine-command> <sequential-start>true</sequential-start> <lifecycle-invocation> <class-name>sysmaster.master.managedserverbootstrap</class-name> <invocation> <invocation-method> <method-name>start</method-name> </invocation-method> <invocation-type>after_deploy</invocation-type> </invocation> <invocation> <invocation-method> <method-name>stop</method-name> </invocation-method> <invocation-type>before_undeploy</invocation-type> </invocation> </lifecycle-invocation> </engine-container> <engine-container> <!-- UI Container --> <name>container2</name> <command-option>-xms64m -Xmx128m -Dsysmaster.name=container2</command-option> <engine-command> <type>servlet</type> <name>engine2</name> </engine-command> <sequential-start>true</sequential-start> <lifecycle-invocation> <class-name>sysmaster.master.uiserverbootstrap</class-name> <invocation> <invocation-method> <method-name>start</method-name> </invocation-method> <invocation-type>after_deploy</invocation-type> </invocation> </lifecycle-invocation> </engine-container> application 에서경로설정을확인한다. <application> <absolute-path>/data1/jachun/master4/fix1_release/jeus/webhome/app_home</absolute-path> 20 SysMaster 설치안내서
<name>sysmaster</name> <path>sysmaster</path> <deployment-type>component</deployment-type> <web-component /> <deployment-target> <target> <engine-container-name>tmaxi7_container2</engine-container-name> <web-context-group> <name>sysmaster</name> </web-context-group> </target> </deployment-target> </application> datasource 부분설정을확인한다. (ex. tibero) data-source는 "system", "statistic" 으로총 2개의 database를설정하도록한다. <database> <vendor>oracle</vendor> <export-name>system</export-name> <data-source-class-name>oracle.jdbc.pool.oracledatasource</data-source-class-name> <data-source-type>datasource</data-source-type> <database-name>tibero</database-name> <data-source-name>oracle.jdbc.pool.oracledatasource</data-source-name> <service-name>symaster_db</service-name> <description/> <network-protocol/> <port-number>8629</port-number> <server-name>192.168.1.87</server-name> <user>sm40fix1</user> <password>sm40fix1</password> <driver-type>thin</driver-type> <connection-pool> <pooling> <min>2</min> <max>4</max> <step>1</step> <period>600000</period> </pooling> <wait-free-connection> <enable-wait>true</enable-wait> <wait-time>10000</wait-time> </wait-free-connection> </connection-pool> </database> 제 2 장 MASTER 설치 21
Table이정상적으로설치되었다면 SysMaster가 DB에접속하기위한 URL을설정해주어야한다. 자세한내용은 Master 환경설정을참고한다. 각 DB Vendor 별설정은아래와같다. Oracle <vendor>oracle</vendor> <export-name>system</export-name> <data-source-class-name>oracle.jdbc.pool.oracledatasource</data-source-class-name> <data-source-type>datasource</data-source-type> <database-name>tibero</database-name> <data-source-name>oracle.jdbc.pool.oracledatasource</data-source-name> <service-name>symaster_db</service-name> <description/> <network-protocol/> <port-number>8629</port-number> <server-name>192.168.1.87</server-name> <user>sm40fix1</user> <password>sm40fix1</password> <driver-type>thin</driver-type> TIBERO <vendor>tibero</vendor> <export-name>system</export-name> <data-source-class-name>com.tmax.tibero.jdbc.ext.tbconnectionpooldatasource</data-source-class-name> <data-source-type>connectionpooldatasource</data-source-type> <database-name>tibero</database-name> <port-number>8629</port-number> <server-name>192.168.1.87</server-name> <user>sm40_fix1</user> <password>sm40_fix1</password WEBMain.xml 확인 WEBMain.xml 파일의위치는다음과같다. $JEUS_HOME/ config/{hostname}_servlet_engine1 // Master Container(Container1) $JEUS_HOME/ config/{hostname}_servlet_engine2 // UI Container(Container2) <{hostname}_servlet_engine1/cat WEBMain.xml> <?xml version="1.0"?> <web-container xmlns="http://www.tmaxsoft.com/xml/ns/jeus" version="6.0"> <context-group> <group-name>sysmaster</group-name> <webserver-connection> <http-listener> 22 SysMaster 설치안내서
<listener-id>http1</listener-id> <port>9488</port> <thread-pool> <min>10</min> <max>20</max> <step>1</step> </thread-pool> </http-listener> </webserver-connection> <encoding> <request-url-encoding> <forced>utf-8</forced> </request-url-encoding> <request-encoding> <default>euc-kr</default> </request-encoding> <response-encoding> <default>utf-8</default> </response-encoding> </encoding> </context-group> </web-container> <{hostname}_servlet_engine2/cat WEBMain.xml> <?xml version="1.0"?> <web-container xmlns="http://www.tmaxsoft.com/xml/ns/jeus" version="6.0"> <context-group> <group-name>sysmaster</group-name> <webserver-connection> <webtob-listener> <listener-id>webtob1</listener-id> <!--<port></port>--> <port>9900</port> <thread-pool> <min>10</min> <max>10</max> <step>1</step> <max-idle-time>30000</max-idle-time> </thread-pool> <webtob-address>localhost</webtob-address> <registration-id>mygroup</registration-id> </webtob-listener> </webserver-connection> <encoding> <request-url-encoding> <forced>utf-8</forced> </request-url-encoding> 제 2 장 MASTER 설치 23
<request-encoding> <default>euc-kr</default> </request-encoding> <response-encoding> <default>utf-8</default> </response-encoding> </encoding> </context-group> </web-container> <{hostname}_servlet_engine3/cat WEBMain.xml - filejob container> <?xml version="1.0"?> <web-container xmlns="http://www.tmaxsoft.com/xml/ns/jeus" version="6.0"> <context-group> <group-name>mygroup</group-name> <webserver-connection> <http-listener> <listener-id>http1</listener-id> <port>8089</port> <thread-pool> <min>10</min> <max>20</max> <step>1</step> </thread-pool> </http-listener> </webserver-connection> <logging> <access-log> <handler> <file-handler> <name>handler1</name> <valid-day>1</valid-day> </file-handler> </handler> </access-log> </logging> </context-group> </web-container> vhost.properties 확인 vhost.properties 파일의위치는다음과같다. JEUS_BASEPORT 를확인한다.. $JEUS_HOME/ config/vhost.properties 다음은 vhost.properties의내용이다. 24 SysMaster 설치안내서
jeus.vhost.enabled=true {hostname}={hostname}:9736 jeus.properties 확인 jeus.properties 파일의위치는다음과같다. $JEUS_HOME/ bin/jeus.properties 1. JEUS_BASEPORT를설정한다. 2. JEUS_LIBPATH에 lib/application를추가한다. 3. JAVA_ARGS에 SYSMASTER_JAVA_ARGS를추가한다. ( 장비마다다름 ) 다음은 jeus.properties의내용과항목에대한설명이다. # # For customizing JEUS environment. # # set up JEUS_BASEPORT. JEUS_BASEPORT=9736 # set up JEUS_WSDIR. JEUS_WSDIR="${JEUS_HOME}/webserver" # set up JEUS_LIBPATH. JEUS_LIBPATH="${JEUS_HOME}/lib/system:${JEUS_HOME}/lib/application" # Select language for JEUS. Available value can be jp. JEUS_LANG=ko # set up SESSION_MEM SESSION_MEM=-Xmx512m # set up JAVA_HOME="/usr/java5_64" # setup JAVA_ARGS. JAVA_ARGS="-d64 -Djeus.vm.bits=64 $SYSMASTER_JAVA_ARGS" # set up JDK vendor. Possible values are Sun, HP, IBM, etc. Default, Sun. JAVA_VENDOR=IBM 제 2 장 MASTER 설치 25
export JEUS_HOME JEUS_BASEPORT JEUS_LIBPATH JEUS_LANG export JEUS_WSDIR JAVA_HOME JAVA_ARGS JAVA_VENDOR SESSION_MEM jeus 파일수정확인 jeus 파일의위치는다음과같다. -Djeus.properties.replicate 에 sysmaster가추가된다. $JEUS_HOME/ bin/jeus 다음은 jeus의내용이다. "${JAVA_HOME}/bin/java" $VM_OPTION $SESSION_MEM \ -Xbootclasspath/p:"${JEUS_HOME}/lib/system/extension.jar" \ -classpath "${JEUS_HOME}/lib/system/bootstrap.jar" \ -Dsun.rmi.dgc.client.gcInterval=3600000 \ -Dsun.rmi.dgc.server.gcInterval=3600000 \ -Djava.library.path="${JEUS_LIBPATH}" \ -Djava.endorsed.dirs="${JEUS_HOME}/lib/endorsed" \ -Djava.naming.factory.initial=jeus.jndi.JNSContextFactory \ -Djava.naming.factory.url.pkgs=jeus.jndi.jns.url \ -Djava.net.preferIPv4Stack=true \ -Djava.util.logging.config.file="${JEUS_HOME}/bin/logging.properties" \ -Djeus.home="${JEUS_HOME}" \ -Djeus.baseport=${JEUS_BASEPORT} \ -Djeus.jvm.version=${VM_TYPE} \ -Djeus.tm.checkReg=true \ -Djeus.tool.webadmin.locale.language=${JEUS_LANG} \ -Djeus.tm.checkReg=true \ -Djeus.tool.webadmin.locale.language=${JEUS_LANG} \ -Djeus.net.reuseAddress=true \ -Djeus.properties.replicate=sysmaster,jeus,sun.rmi,java.util,java.net \ ${JAVA_ARGS} \ jeus.server.jeusbootstrapper ${BOOT_PARAMETER} policies.xml 수정확인 policies.xml 파일의위치는다음과같다. $JEUS_HOME/ config/hostname/security/system_domain/policies.xml 다음은 policies.xml의내용이다. resource-permissions 부분을확인한다. <policies xmlns="http://www.tmaxsoft.com/xml/ns/jeus" version="6.0"> <policy> <role-permissions> <role-permission> 26 SysMaster 설치안내서
<principal>administrator</principal> <role>administratorsrole</role> </role-permission> <role-permission> <principal>anonymous</principal> <role>jndiuser</role> </role-permission> </role-permissions> <resource-permissions> <context-id>default</context-id> <resource-permission> <role>administratorsrole</role> <resource>jeus.*</resource> <actions>*</actions> </resource-permission> <resource-permission> <role>jndiuser</role> <resource>jeus.jndi.*</resource> <actions>*</actions> </resource-permission> </resource-permissions> </policy> </policies> ~ 2.3.5. 내장 WebtoB 환경설정확인 다음은 JEUS 환경설정파일에적용되는 SysMaster4.0 내용이다. ws_engine.m 수정 JEUS WEBMain.xml 에서설정한 JSVPORT와 group name으로해당설정에맞게수정한다. 자세한내용은 WebtoB 설정가이드참조한다. <ws_engine.m> *DOMAIN jeuservice *NODE tmaxi7 WEBTOBDIR = "/data1/apmqam/master_4x/jeus/webserver", SHMKEY = 61000, DOCROOT = "/data1/apmqam/master_4x/jeus/webserver/docs", PORT = "8488", LOGGING = "log1", ERRORLOG = "log2", 제 2 장 MASTER 설치 27
JSVPORT = 9900, HTH = 1 *SVRGROUP htmlg cgig ssig jsvg NODENAME = "tmaxi7", SVRTYPE = HTML NODENAME = "tmaxi7", SVRTYPE = CGI NODENAME = "tmaxi7", SVRTYPE = SSI NODENAME = "tmaxi7", SVRTYPE = JSV *SERVER html SVGNAME = htmlg, MinProc = 1, MaxProc = 2, ASQCount = 1 cgi SVGNAME = cgig, MinProc = 1, MaxProc = 2 ssi SVGNAME = ssig, MinProc = 1, MaxProc = 2 MyGroup SVGNAME = jsvg, MinProc = 1, MaxProc = 5 *URI uri1 Uri = "/cgi-bin/", Svrtype = CGI uri2 Uri = "/sysmaster", Svrtype = JSV uri3 Uri = "/exploded", Svrtype = JSV *ALIAS alias1 URI = "/cgi-bin/", RealPath = "/data1/apmqam/master_4x/jeus/webserver/cgi-bin/" *LOGGING log1 Format = "DEFAULT", FileName = "/data1/apmqam/master_4x/jeus/webserver/log/access.log", Option = "sync" log2 Format = "ERROR", FileName = "/data1/apmqam/master_4x/jeus/webserver/log/error.log", Option = "sync" *EXT htm MimeType = "text/html", SvrType = HTML jsp Mimetype ="application/jsp", Svrtype=JS 작성된설정파일을실행한다. [apmqam@tmaxi7:/data1/apmqam/master_4x/jeus/webserver/config]$wscfl -i ws_engine.m Current configuration: Number of client handler(hth) = 1 Supported maximum user per node = 8162 Supported maximum user per handler = 8162 CFL is done successfully for node(tmaxi7(tmaxi7)) [apmqam@tmaxi7:/data1/apmqam/master_4x/jeus/webserver/config]$wsgst SVC tables are successfully generated GST is successfully done 28 SysMaster 설치안내서
정상적으로실행후다음의명령을사용해서 WebtoB 를기동한다. wsboot 2.4. Master 기동과종료 2.4.1. Master 기동 SysMaster의 Master를기동하는과정은다음과같다. 1. $MASTER_HOME/bin디렉터리의 smmaster를실행한다. $ pwd $ SYSMASTER_HOME/bin $ smmaster 2. 정상적으로 Master가기동되었다면다음과같은로그를확인할수있다. ************************************************************** MASTER [container3] READY... - server : Default Managed Server started - server : File Job Master Server started ************************************************************** SysMaster master boot success... [18:37:30] All stdout,stderr will be redirect to: /data1/apmqam/master_4x/epost_2010/logs/smlog.container3 [2011.09.28 18:37:30][2][b242] [container3-1] [JMX-0011] create MBean : JEUS:j2eeType=JeusService,jeusType=WebListener, JMXManager=tmaxs7_container3,WebEngine=tmaxs7_servlet_engine3, J2EEServer=tmaxs7_container3,JeusManager=tmaxs7, ContextGroup=MyGroup,name=http1 [2011.09.28 18:37:30][2][b242] [container3-1] [JMX-0011] create MBean : JEUS:j2eeType=JeusService,jeusType=ThreadPool_WEBC,JMXManager=tmaxs7_container3, ContextGroup=MyGroup,WebEngine=tmaxs7_servlet_engine3, J2EEServer=tmaxs7_container3,JeusManager=tmaxs7,WebListener=http1,name=http1 [2011.09.28 18:37:30][2][b242] [container3-1] [WEB-3250] worker thread pool created. id = http1 [2011.09.28 18:37:30][2][b242] [container3-1] [WEB-2052] <listener(http1)> connection init successful. port = 8089 [2011.09.28 18:37:30][2][b242] [container3-1] [WEB-3413] (MyGroup) ready to receive request [2011.09.28 18:37:30][2][b242] [container3-1] [MGR-0103] engine container[tmaxs7_container3] is READY [2011.09.28 18:37:30][2][b242] [container3-1] [MGR-0101] currently running engines 제 2 장 MASTER 설치 29
of engine container[tmaxs7_container3] : [tmaxs7_servlet_engine3] [2011.09.28 18:37:30][0][b242] [tmaxs7-77] [MGR-0303] engine container[tmaxs7_container3] initialization successfully done [pid : 29447] [2011.09.28 18:37:30][0][b242] [tmaxs7-1] [MGR-0242] JeusServer one-step booting successful : [tmaxs7_container1, tmaxs7_container2, tmaxs7_container3] 2.4.2. WEB UI 실행 Master 기동후접속 URL 은아래와같다. http://xxx.xxx.xxx.xxx:8488/sysmaster/base/frame.action [ 그림 2.1] WEB UI 실행화면 2.4.3. Master 종료 SysMaster Server이종료는실행중인 was server의 process를종료하는것으로 JEUS Server의종료내용과동일하다. 각 container의프로세스가모두종료되고 was administrator 프로세스가종료된다. 종료과정은다음과같다. 1. $MASTER_HOME/bin디렉터리의 smdown를실행한다. $ pwd /EMC01/apmqam/sysmaster/bin $ smdown 2. 정상적으로 Master 가종료되었다면다음과같은로그를확인할수있다. 30 SysMaster 설치안내서
[2011.09.29 02:00:29][1][b242] [tmaxs7-19] [Network-1023] OnePortServer virtual listener 6739 unregistered [2011.09.29 02:00:29][2][b242] [tmaxs7-19] [JMX-0019] destroy MBean : JEUS:j2eeType=JeusService,jeusType=ThreadPool,JMXManager=tmaxs7,JeusManager=tmaxs7,J2EEServer=null,name=WebLinkManager [2011.09.29 02:00:29][1][b242] [tmaxs7-19] [EJB-6453] class ftp unexported [2011.09.29 02:00:29][2][b242] [tmaxs7-19] [JMX-0019] destroy MBean : JEUS:j2eeType=JeusService,jeusType=ClassFTPService,JMXManager=tmaxs7,JeusManager=tmaxs7,name=tmaxs7 [2011.09.29 02:00:29][2][b242] [tmaxs7-19] [JMX-0019] destroy MBean : JEUS:j2eeType=JeusService,jeusType=NodeControllerService,JMXManager=tmaxs7,JeusManager=tmaxs7,name=tmaxs7 [2011.09.29 02:00:29][2][b242] [tmaxs7-19] [JMX-0019] destroy MBean : JEUS:j2eeType=JeusService,jeusType=SecurityService,JMXManager=tmaxs7,JeusManager=tmaxs7,name=SecurityService [2011.09.29 02:00:29][1][b242] [tmaxs7-19] [Network-1023] OnePortServer virtual listener SecurityServer unregistered [2011.09.29 02:00:29][0][b242] [tmaxs7-18] [Network-0214] close NIO selector : ServerSecurity-Selector [2011.09.29 02:00:29][2][b242] [tmaxs7-19] [MGR-0186] Node security manager uninstalled [2011.09.29 02:00:29][0][b242] [tmaxs7-95] [Network-0214] close NIO selector : DefaultSelector [2011.09.29 02:00:29][0][b242] [tmaxs7-19] [MGR-0248] JEUS Manager is SHUTDOWN [2011.09.29 02:00:29][0][b242] [tmaxs7-10] [MGR-0565] JVM process is shutting down [2011.09.29 02:00:35][0][b242] [tmaxs7-10] [MGR-0566] JVM process will be terminated 2.5. Master FileJOB 설정 Master 설치하는경우자동으로 FileJob 서버설치도완료된다. Filejob 서버의기동은 smmaster 환경파일에서주석제거후가능하다. FileJOB 서버를설정하는방법은다음과같다. 1. Master 실행 script인 smmaster를확인해보면다음과같은내용이주석으로처리되어있다. 주석을해제하면 smmaster script를실행할때 Master 기동에이어 FileJOB 서버가기동된다. $JAVA_HOME/bin/java -Dsmjobmaster-Djava.security.manager -Djava.security.policy=$SYSMASTER_HOME/bin/sm-policy.policy -Xms256m -Xmx512m -classpath $SYSMASTER_SYS_CPATH: $SYSMASTER_USR_CPATH $SYS_PROPSsysmaster.server.filejob.master.FileJobMaster $*& 2. Oracle, AnyLink FileJOB 설정은각리스소설치메뉴얼을참조한다. 제 2 장 MASTER 설치 31
제 3 장 Agent 설치 본장에서는 Agent 설치방법에대해서기술한다. 3.1. 개요 설치전확인사항의 Agent 부분을확인하고 Hardware, Software에대한조건을모두갖추었다면 Agent를설치한다. Agent를설치하는방법은 Master를설치하는방법과유사하다. Master를이미설치했다면, Agent를설치하기가용이할것이다. Agent를 root 계정이나리소스와동일한계정으로설치하면한노드에다수의리소스가존재해도모든리소스의제어가가능하지만, root계정이나리소스와동일한계정이아닌경우각리소스를설치한계정마다 Agent를설치해주어야한다. 따라서하나의노드에여러리소스를관리해야할필요가있다면 Agent 를 root 계정이나리소스와동일한계정에설치하는것이좋다. Agent 설치과정을요약하면다음과같다. 1. Agent 설치 2. Agent 디렉터리구조 3. Agent 환경설정및등록 4. Agent 기동과종료 참고 SysMaster 의 smadmin 툴을통한 Agent 설치방법은 "SysMaster 관리자안내서 " 를참고한다. 3.2. Agent 설치 최초설치파일은 SysMaster4_0_Master_Agent.bin으로존재한다. Agent의설치과정은다음과같다. 1. SysMaster4_0_Master_Agent.bin 파일의실행권한설정한뒤에실행한다. 다음과같은화면이나타나면 <ENTER> 키를눌러다음으로진행한다. [sysmaster1@qpsx1 20080000]$ chmod u+x SysMaster4_0_Master_Agent.bin [sysmaster1@qpsx1 20080000]$ SysMaster4_0_Master_Agent.bin Preparing to install... Extracting the installation resources from the installer archive... 제 3 장 Agent 설치 33
Configuring the installer for this system's environment... Launching installer... Preparing CONSOLE Mode Installation... =============================================================================== SysMaster4.0 Fix#1 (created with InstallAnywhere by Macrovision) ------------------------------------------------------------------------------- Introduction ------------ InstallAnywhere will guide you through the installation of SysMaster3.2. It is strongly recommended that you quit all programs before continuing with this installation. Respond to each prompt to proceed to the next step in the installation. If you want to change something on a previous step, type 'back'. You may cancel this installation at any time by typing 'quit'. PRESS <ENTER> TO CONTINUE: 2. 라이선스준수화면이나타난다. <ENTER> 키를눌러다음으로진행한다. =============================================================================== License Agreement ----------------- Installation and Use of SysMaster4.0 Fix#1 Requires Acceptance of the Following License Agreement: SysMaster This Software is made by 'TmaxSoft Co.,Ltd.' and this software is distributed under our license agreement. Software End-User License Agreement Product : SysMaster This is a legal agreement between you (either an individual or an entity) and TmaxSoft, Incorporated. By opening the sealed software package and/or by using the software, you agree to be bound by the terms of this agreement. SysMaster Software License 1. Grant of License: This SysMaster Software License Agreement ("License") permits you to use one copy of the TmaxSoftware product Tmax, on any single computer, provided the software is in use on only one computer at any one time. If this package is a license pack, you may make and use additional copies of 34 SysMaster 설치안내서
the software up to the number of licensed copies authorized. If you have multiple licenses for the software, then at any time you may have as many copies of the software in use as you have licenses. The software is "in use" on a computer when it is loaded into the temporary PRESS <ENTER> TO CONTINUE: 3. 라이선스동의여부를묻는다. 동의한다면 y 를입력후 <ENTER> 키를누른다. PRESS <ENTER> TO CONTINUE: DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): y 4. 목록중에서설치할 Install Set 을고른다. Agent를설치할것임으로 2를입력한뒤 <ENTER> 키를누른다. =========================================================================== Choose Install Set ------------------ Please choose the Install Set to be installed by this installer. 1- Master ->2- Agent 3- Only Provider ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS <ENTER> TO ACCEPT THE DEFAULT : 5. 목록중에서설치할플랫폼을선택한다. =========================================================================== Choose Platform --------------- Choose current system ( platform-architecture ) 1)HP-UX 2)HP-UX IA64 3)AIX 5L 4)Solaris 7 ~ 10 5)Linux 2.X 6)Linux 2.X IA64 Quit) Quit Installer Choose Current System (DEFAULT: 5): 6. 커널의 bit를선택한다. =========================================================================== Choose Kernel Bit Please Choose Kernel Bit? ->1-32bit 2-64bit 3- previous 제 3 장 Agent 설치 35
ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 7. JDK 의경로를설정한다. =============================================================================== Choose JDK Folder ----------------- Please Choose a Folder: Input User JDK Folder (DEFAULT: /usr/java5_64): 8. Agent가설치될경로를설정한다. =========================================================================== Choose Install Master Folder ---------------------------- Where would you like to install? (DEFAULT: /home/sysmaster1/sysmaster/agent): 9. Agent에서연결할 Master의정보를설정한다. ================================================================ Choose Master Infomation ------------------------ Master IP (DEFAULT: 192.168.1.87): Master Base Port (DEFAULT: 22000): Master Request Port (DEFAULT: 22002): Master State Port (DEFAULT: 22006): 10. Agent 의정보를설정한다. Agent IP (DEFAULT: 192.168.1.87): Agant JRMP Port (DEFAULT: 22100): 11. 설치완료되면다음과같은화면이나타난다. <ENTER> 키를눌러인스톨러를종료한다. =============================================================================== Pre-Installation Summary ------------------------ Please Review the Following Before Continuing: 36 SysMaster 설치안내서
Product Name: SysMaster4.0 Disk Space Information (for Installation Target): Required: 17,677,757 bytes Available: 213,394,419,712 bytes PRESS <ENTER> TO CONTINUE: =============================================================================== Installing... ------------- [================== ================== ================== ==================] [------------------ ------------------ ------------------ ------------------] =============================================================================== Installation Complete --------------------- Congratulations. SysMaster4.0 has been successfully installed to: /data1/jachun/sysmaster/fix1_agent PRESS <ENTER> TO EXIT THE INSTALLER: 3.3. Agent 의디렉터리구조 Agent의설치가완료되면다음과같은디렉터리가생성된다. Agent가설치될디렉터리를 sysmaster로정한경우이다. $sysmaster +- agent +- bin +- config +- lib +- logs +- UninstallerData 다음은 Master의각디렉터리에대한설명이다. bin smagent 등의실행파일이위치한다. 제 3 장 Agent 설치 37
config Master 운영에필요한속성파일들이위치한다. lib 라이브러리파일이위치한다. logs 로그파일이저장되는디렉터리이다. UninstallData SysMaster 삭제작업관련파일이위치한다. 3.4. Agent 환경설정및등록 3.4.1. 환경설정 sysmaster.properties 수정다음의파일을확인한다. $AGENT_HOME/config/sysmaster.properties 다음은 sysmaster.properties 파일의내용이다. ############################################################################################## # # [ NETWORK(Mandatory) ] # # master.hostname Master Hostname(IP) # master.baseport Master Base Port # # master.port.req Master Request Port(default : master.baseport + 2) # master.port.stat Master Statistic Port # # agent.hostname Agent Hostname(IP) # agent.port.jrmpadaptor Agent Port for JRMP Adaptor Export # ############################################################################################## master.hostname=192.168.1.87 master.port.base=22000 master.port.req=22002 master.port.stat=22006 agent.hostname=192.168.1.87 38 SysMaster 설치안내서
다음은각수정항목에대한설명이다. 항목 master.hostname master.port.base 설명 Master 의 IP 이다. Master 기본포트이다. smmaster.env 파일내 SYSMASTER_BASEPORT 해당한다. master.port.req master.port.stat agent.hostname 사용자실시간요청을위한 nio port로 SYSMASTER_BASEPORT + 2 에해당한다. 디폴트설치경우해당하고, 컨테이너가 3개이상일경우수정이필요하다. Agent, DC 등으로부터데이터를전달을위한 port이다. 디폴트로설치하는경우 SYSMASTER_BASEPORT + 6 로설정된다. 컨테이너가 3개이상일경우수정이필요하다. Agent의 IP 주소이다. smagent.env 수정다음의파일을확인한다. $AGENT_HOME/bin/smagent.env 다음은 smagent.env 파일의내용이다. # # For customizing SysMaster agent environment. # # set up SYSMASTER_HOME. SYSMASTER_HOME=/data1/jachun/sysmaster/fix1_agent # set up SYSMASTER_BASEPORT. SYSMASTER_BASEPORT=22000 # set up SYSMASTER_SYSMON_HOME. SYSMASTER_SYSMON_HOME=$SYSMASTER_HOME/lib/provider/sysmon/aix5L_64 # set up JAVA_HOME JAVA_HOME=/usr/java5_64 # set up JAVA_ARGS JAVA_ARGS="-Xms32m -Xmx64m" export SYSMASTER_HOME SYSMASTER_BASEPORT SYSMASTER_SYSMON_LIB export JAVA_HOME JAVA_ARGS 다음은각수정항목에대한설명이다. 제 3 장 Agent 설치 39
항목 SYSMASTER_HOME SYSMASTER_BASEPORT SYSMASTER_SYS MON_HOME 설명 ${AGENT_HOME} 설정한다. Master의 base port 설정이필요하다. OS 폴더를설정한다. ${AGENT_HOME}/lib/provider/sysmon/os명 다음은지원가능한플랫폼정보이다. ( 각 OS별 naming [OS명 + bit수 ]) AIX 계열 : aix4.3_32, aix4.3_64, aix5l_32, aix5l_64, aix6l_32, aix6l_64 HP 계열 : hpux11_32, hpux11_64, hpux11_32_ia64, hpu11_64_ia64 Solaris 계열 : solaris8_32, solaris8_64, solaris9_32, solaris9_64, solaris10_32, solaris10_64, solaris8_32_x86 기타 : linux2.x, linux2.x_ia64, true64_5.0, true64_5.1, win32 JAVA_HOME JAVA HOME 을설정한다. smboot 생성다음의파일을생성한다. ( 파일을생성하기전에먼저 WEB Admin에서해당 Agent를등록한다.) $AGENT_HOME/bin/vi smboot 다음은 smboot 파일의내용이다. #!/bin/sh smagent -n {WEB admin에서등록한 Agent name} 3.4.2. Agent 등록 Agent를기동하기전에기동시킬 Agent를 Master에등록해야한다. Agent의등록과정은 SysMaster WEB UI를통해이루어진다. SysMaster WEB UI에서 Agent 등록과정을마치면 Agent를기동하기위한모든준비가완료된다. SysMaster WEB UI를실행한후 [ADMIN] > [SysMaster] > [ 리소스 ] 메뉴를선택하면 SysMaster Agent 를등록하고리소스를관리할수있는 Sysmaster 관리환경을시작할수있다. 오른쪽상단에서 Agent를선택하고 [ 추가 ] 버튼을선택하면아래와같은화면이나타난다. 필수입력항목에입력완료후 [ 확인 ] 버튼을클릭하면등록이완료된다. 40 SysMaster 설치안내서
[ 그림 3.1] Agent 추가화면 다음은각입력항목에대한설명이다.( * 필수입력사항 ) 항목 Agent Name(*) OS Name(*) Host Name(*) User Name(*) Log Level(*) Sysmon Generate Desc Message 설명사용자가임의로지정할수있다. 일반적으로설치한서버의노드명을사용하면어떤노드에설치된 Agent인지쉽게구분할수있다. ( 최대길이 32자 ) Agent가설치된장치의 OS를선택한다. Agent가설치된장치의호스트이름을입력한다. Agent를설치할때사용했던 user명을입력한다. 확인할로그레벨을선택한다. 선택하면 SysMon Resource가자동으로생성된다.( 해당서버에최초설치하는경우에는반드시체크해야한다.) Agent에대한간단한설명을추가할수있다. ( 최대 2000자 ) Desc보다긴설명을입력한다. SysMon Resource 까지등록이완료되면아래와같이등록된내역을확인할수있다. 제 3 장 Agent 설치 41
[ 그림 3.2] Agent 추가완료화면 자동으로설치된 Node 를선택하면아래화면과같이등록된노드정보를확인할수있다. Agent 와동시에설치된 Provider 는 Sysmon Provider 로시스템의자원현황을모니터링한다. 42 SysMaster 설치안내서
3.5. Agent 기동과종료 3.5.1. Agent 기동 Agent를기동하는과정은다음과같다. 1. smboot를생성하지않았다면다음과같이 $AGENT_HOME/bin 디렉터리에서 smagent를실행시킨다. $ $AGENT_HOME/bin/smagent -n {Agent 이름 } Agent 이름은필수입력사항으로 Agent를등록할때입력한 Agent 이름을입력해주면된다. 2. 정상적으로 Agent가기동했다면다음과같은화면을확인할수있다. [14:02:11] SysMaster agent main started [14:02:11] Resource moniotor [was] scheduler started [14:02:11] Resource moniotor [sysmon] scheduler started [14:02:11] Resource resource [R013] monitor task scheduler started [14:02:11] Resource resource [R012] monitor task scheduler started [14:02:11] Agent jmx context [rx4641] registered [14:02:11] *** Agent [rx4641] configuration *** host : rx4641 user : kks home : /data2/kks/sysmaster/agent40_0906/ [14:02:11] Agent [rx4641] registered ====================================================== AGENT [rx4641] READY... ====================================================== SysMaster agent [rx4641] boot success... [14:02:11] All stdout,stderr will be redirect to: /data2/kks/sysmaster/agent40_0906/logs/smlog 3.5.2. Agent 종료 실행된 Agent를종료시킬때는 -n 옵션을반드시넣어야한다. 1. 다음과같이 $AGENT_HOME/bin 디렉터리에서 smagent를실행시킨다. $ $AGENT_HOME/bin/smdown -n 2. 정상적으로 Agent 가기동했다면다음과같은화면을확인할수있다. 제 3 장 Agent 설치 43
Starting agent shutdown... 13:59:48 SMSTR INFO Now starting stop agent server... 13:59:48 SMSTR INFO [SmNioClientManger] Finish SmNioClientManger Stop 13:59:48 SMSTR INFO Trying to shutdown File job client 13:59:48 SMSTR INFO Destroy AGENT file job client success. 13:59:48 SMSTR INFO Destroy AGENT Sysmonadmin success. 13:59:48 SMSTR INFO Stop running file job client [rx4641] 13:59:49 SMSTR INFO Resource resource [R012] monitor task scheduler ended 13:59:49 SMSTR INFO Resource resource [R013] monitor task scheduler ended 13:59:49 SMSTR INFO Destroy AGENT PROVIDER mbeans.xml configurations. 13:59:49 SMSTR INFO Master Connector closed 13:59:49 SMSTR INFO SysMaster agent main stopped 13:59:49 SMSTR INFO Destroy MASTER registration 13:59:49 SMSTR INFO Destroy AGENT mbean server 13:59:49 SMSTR INFO Destroy AGENT Jrmpadaptor port [23000] Agent shutdowned... 44 SysMaster 설치안내서
제 4 장리소스등록 본장에서는 SysMaster 가모니터링을하는대상인리소스를등록하는방법을설명한다. 4.1. 리소스등록전처리사항 리소스등록은 SysMaster 설치가완료된후, 관리대상이되는리소스를 Master 및 Agent에게알리고, Master와 Agent가해당자원의성능관리를시작하도록하기위한작업이다. 최초의 Provider( 리소스 ) 등록은 Master 서버를재기동해야한다.(WAS Provider 제외 ) 리소스의등록과정은 WEB UI를통해서이루어진다. Master와 Agent가정상적으로동작하는지확인한다음리소스등록을시작해야한다. 또한모니터링대상이되는리소스에대한바이너리업데이트가정상적으로이루어졌는지확인해야한다. 참고 현재 SysMaster 4.0 Fix#1 에서제공되는리소스에는 WAS, Oracle, AnyLink Provider 가있다. 리소스등록과정을요약하면다음과같다. 1. 리소스별 SQL 문장 (DML, DDL) 수행 2. 리소스별압축파일업데이트 ( 최초등록하는경우 Master Server 재기동 ) 3. 리소스별 WEB UI 압축파일 (Console) 추가 4. 리소스별등록전처리과정수행 5. WEB UI를통한리소스등록 6. 프로바이더별 DC(Data Collector) 설치 (Oracle, WAS, AnyLink 해당 ) 7. 프로바이더별 FileJOB 설정 (Oracle, AnyLink 해당 ) 4.1.1. 리소스별 SQL 문장수행 특정리소스모니터링을수행하기위해서는해당리소스의정보를저장하기위한스키마를생성하여야한다. SQL 문장은초기설치파일중 SQL 디렉터리에서복사하여사용한다. 리소스별로수행해야하는 SQL 문장은제공된바이너리의폴더명을참조한다. 제 4 장리소스등록 45
4.1.2. 리소스별압축파일 (*.zip) 업데이트 SysMaster에서배포된바이너리에서 update 폴더아래 provider 폴더에서설치하고자하는 provider의압축파일을다음의디렉터리아래에복사한다. 각폴더 (provider) 내에있는압축파일 (*.zip) 을풀어서넣도록한다. $SYSMASTER_HOME/update/provider 다음은 WAS와 AnyLink povider를복사하는경우의예이다. [apmqam@tmaxi7:/data1/apmqam/master_4x/update/provider]$ls sysmaster-provider-anylink.zip sysmaster-provider-was_aix5l_32.zip sysmaster-provider-anylink_aix5l_32.zip sysmaster-provider-was_aix5l_64.zip sysmaster-provider-anylink_aix5l_64.zip sysmaster-provider-was_aix6l_32.zip sysmaster-provider-anylink_aix6l_32.zip sysmaster-provider-was_aix6l_64.zip sysmaster-provider-anylink_aix6l_64.zip sysmaster-provider-was_hpux11_32.zip sysmaster-provider-anylink_hpux11_32.zip sysmaster-provider-was_hpux11_32_ia64.zip sysmaster-provider-anylink_hpux11_32_ia64.zip sysmaster-provider-was_hpux11_64.zip sysmaster-provider-anylink_hpux11_64.zip sysmaster-provider-was_hpux11_64_ia64.zip sysmaster-provider-anylink_hpux11_64_ia64.zip sysmaster-provider-was_linux2.x.zip sysmaster-provider-anylink_linux2.x.zip sysmaster-provider-was_linux2.x_ia64.zip sysmaster-provider-anylink_linux2.x_ia64.zip sysmaster-provider-was_solaris10_32.zip sysmaster-provider-anylink_solaris10_32.zip sysmaster-provider-was_solaris10_64.zip sysmaster-provider-anylink_solaris10_64.zip sysmaster-provider-was_solaris7_32.zip sysmaster-provider-anylink_solaris7_32.zip sysmaster-provider-was_solaris7_64.zip sysmaster-provider-anylink_solaris7_64.zip sysmaster-provider-was_solaris8_32.zip sysmaster-provider-anylink_solaris8_32.zip sysmaster-provider-was_solaris8_64.zip sysmaster-provider-anylink_solaris8_64.zip sysmaster-provider-was_solaris9_32.zip sysmaster-provider-anylink_solaris9_32.zip sysmaster-provider-was_solaris9_64.zip 46 SysMaster 설치안내서
sysmaster-provider-anylink_solaris9_64.zip sysmaster-provider-was_solaris_32_x86.zip sysmaster-provider-anylink_win32.zip sysmaster-provider-was_win32.zip sysmaster-provider-was.zip 4.1.3. 리소스별 WEB UI 압축파일추가 SysMaster에서각리소스단위의모니터링을지원하기위해 DB Table과 provider별바이너리를업데이 트했던것과같이, WEB UI에서도리소스별로작업을해야한다. 초기설치디렉터리내에 update/console 디렉터리에프로바이더별로 WEB UI 압축파일이존재한다. 해당폴더구조전체를다음의디렉터리아래복사한다. $SYSMASTER_HOME/update/console 다음은 Admin, AnyLink, Sysmon, WAS Web UI를복사하는경우의예이다. [apmqam@tmaxi7:/data1/apmqam/master_4x/update/console]$ls -al total 7584 drwxr-xr-x 2 apmqam rnd 256 Nov 21 15:26. drwxr-xr-x 6 apmqam rnd 256 Nov 7 20:47.. -rw-r----- 1 apmqam rnd 102303 Nov 21 15:26 sysmaster-ui-admin.zip -rw-r----- 1 apmqam rnd 263313 Nov 21 15:26 sysmaster-ui-anylink.zip -rw-r----- 1 apmqam rnd 93188 Nov 21 15:26 sysmaster-ui-sysmon.zip -rw-r----- 1 apmqam rnd 276637 Nov 21 15:26 sysmaster-ui-was.zip -rw-r----- 1 apmqam rnd 3127893 Nov 21 15:26 sysmaster-ui.zip 4.1.4. 리소스등록환경확인 Master Server 재기동후에모니터링대상이되는 Provider의리소스등록환경을확인한다. Resource Type 리스트박스에해당 provider가있고, 최상위메뉴에모니터링대상 Provider의메뉴가등록되어있으면설정환경이정상적으로등록된것으로본다. 제 4 장리소스등록 47
[ 그림 4.1] 리소스등록확인 4.2. WAS 리소스등록 WAS 리소스등록은 DC를설치하는과정이대부분이다. Agent 와관계가있는부분이있으나별도로수정해야하는부분은없다. Agent 등록은 Agent 설치하는 제3장 Agent 설치 에서이미설명이되었으므로생략한다. WAS DC는별도의라이브러리파일로배포된다. DC를설치하는과정을요약하면다음과같다. 1. WEB UI에서 Agent 등록 2. WAS 리소스등록 3. node, container 등록 4. sminst_rt.jar 파일생성 5. 환경파일설정 (sm.properties) 6. libdcagent library 파일복사 7. WAS 기동할때등록되는환경파일 (JEUSMain.xml) 수정 8. WAS 재기동후 WEB UI에서정상모니터링여부확인 참고 본안내서에서는 TmaxSoft 의 WAS 제품인 JEUS 를기준으로리소스등록방법을설명한다. 48 SysMaster 설치안내서
다음은 WAS 등록을위해필요한파일들이다. 배포된라이브러리에서확인할수있다. sminst_rt.jar(jdk 1.4), sminst_15.jar(jdk 1.5) smrtcvt( 실행파일 ) libdcagent library 파일 (JDK 1.4와 1.5가별도의라이브러리로구성 ) sm.properties 위의파일은다음의위치에서확인할수있다. MASTER_HOME/provider/was/dc DC 바이너리는배포되는 dc_binary/was_dc 위치에있는파일에서확인할수있다. 4.2.1. WEB UI 에서리소스등록 WAS를등록하기전 Agent가기동중이라면, Agent기동을중지시키고 WAS를등록하도록한다. 1. [ADMIN] 메뉴에서등록된 Agent를선택하고, 우측상단의리스트박스에서 'Resource' 를선택하고 [ 추가 ] 버튼을클릭한다. [ 그림 4.2] WAS 리소스등록 다음은각속성에대한설명이다. 속성명 필수 Default Value 설명 was.account O NONE Jeusadmin 의계정이다. ( 예 : admin) 제 4 장리소스등록 49
속성명 필수 Default Value 설명 was.password O NONE Jeusadmin 계정의비밀번호이다. was.host O NONE JEUS 가설치된서버의 IP 이다. ( 예 : 192.1.1.1 ) was.node O NONE JEUS 가설치된서버의노드명이다. was.admin.port X NONE JEUS 가 admin port 이다. was.http.port X NONE JEUS port 번호이다. ( 예 : 9777 ) was.version X NONE JEUS 버전정보이다. was.pool.enable X NONE DB pool 모니터링여부이다. 2. 등록후오른쪽상단에리스트박스에서 'Node' 를선택하고 [ 추가 ] 버튼을클릭한다. 3. 등록후오른쪽상단에리스트박스에서 'Container" 를선택하고 [ 추가 ] 버튼을클릭한다. 50 SysMaster 설치안내서
컨테이너의전체이름 ( 노드이름 _ 컨테이너이름 ) 을등록해야한다. 노드별컨테이너의이름을입력한다음 [ 확인 ] 버튼을클릭하면, 하나씩등록된다. 기존에는컨테이너이름을사용자가임의적으로정할수가있었으나 SysMaster 3.2 SP2 버전이후에는 JEUS Admin의기능추가로인해컨테이너이름입력할때다음의형태로입력해야한다. 컨테이너이름 = Node_Container 항목 Path(*) Node Name 설명노드를등록할때 Path명에 ".{ 컨테이너명 }" 으로등록해야인식이가능하다. (tmaxi7.container1). 노드명을입력한다. 4.2.2. 환경설정 WAS 리소스등록과정에서설정해야하는환경파일에대해설명한다.( 추가설정및수정이필요한환경파일은다음의 3가지이다.) sm.properties 파일을수정하는과정은다음과같다. 각컨테이너개수만큼생성한다. 1. 임의의디렉터리에 MASTER_HOME/provider/was/dc 폴더를복사한다 ( 일반적으로 AGENT_HOME/dc). 2. 해당디렉터리를 sm.home으로할때에 sm.home/sm_properteis 디렉터리에있는 sm.properties 파일을 Master에등록한컨테이너수만큼생성한다. 물론, 이때 sm.properties파일이름은같지않아야한다.( 예 : sm.properties1, sm.properties2, ) 3. 각각의 sm.properties 파일들을각컨테이너별환경에맞도록설정한다. 다음은각 sm.properties 파일마다반드시수정이필요한항목을수정한예이다. # Sysmaster home # - Data Collector's Home directory ################################################################################ sm.home=/data1/apmqam/agent_4x/sm1007/dc_was ################################################################################ # Network config # # - Data Collector's network properties # - net.master.host : Master's ip # - net.master.port : Master's socket port # - net.collector.host : Collector's ip # - net.history.port : Collector's history socket port # - net.stat.port : Collector's statistic socket port # ################################################################################ 제 4 장리소스등록 51
# Master Network Config net.master.host=192.168.1.87 net.master.port=22002 # Collector Network Config net.collector.host=192.168.1.87 net.history.port=22007 net.stat.port=22006 ################################################################################ # Container props # # - Set Resource id # - Set cfg path "sm3.properties" 240 lines, 8837 characters # - Set Resource id # - Set cfg path # - Set OutOfMemory Error detect enable : defaule true # - Set Socket Trace enable : defaule true # - Set File Trace enable : defaule true # - Set sun's thread cpu time bug enable (linux & sun jdk1.4.x) # - Set ClassLoader Trace enable : defaule true # ################################################################################ resource.id=r012 container.path=tmaxi7_was.container3 #oomerror.detect.enable=false #socket.trace.enable=false #file.trace.enable=false #sun.threadtime.bug.enable=false #bci.classloader.enable=false... 계속 항목 net.master.host net.master.port net.collector.host net.history.port net.stat.port resource.id container.path 설명 Master Server의 IP 주소, DC의기본통신포트이다. Master Server의 BasePort+2이다. Master Server의 IP 주소이다. Master Server의 BasePort+7, 이력정보전송포트이다. Master Server의 BasePort+6, 통계정보전송포트이다. WEB UI에 ADMIN에등록된 Resource ID이다. WEB UI에 ADMIN에등록된 Resource Container Path vale이다. 52 SysMaster 설치안내서
항목 dc.tx.threshold dc.tx.rate exception.collect.enable logging.enable logging.level 설명 DC에서 tx정보를수집할때응답시간임계치이다. ( 정해진임계치이상일경우에해당서비스에대한 stacktrace정보를수집하는기준 ) 임계치초과서비스가수행되는비율이다. 예외가발생하는서버시에대한 trace 수집여부를설정한다. 로깅여부를설정한다. 로깅작성레벨을설정한다. 4.2.3. sminst_rt.jar 파일생성 sm.home 디렉터리에서 smrtcvt 실행파일을통하여 JDK 의 rt.jar이나 core.jar 파일로 sminst_rt.jar 파일을생성한다. * rt.jar 혹은 core.jar파일은 SysMaster에설정된 JAVA_HOME/jre/lib 디렉터리에서찾는다. * smrtcvt는내부적으로 sminst.jar 를이용하게되는데기본으로제공하는 sminst.jar 는 JDK 1.4 용이며 JDK 1.5로 was 를돌릴경우에는 sminst_15.jar 파일을 sminst.jar 로파일명을변경하여사용한다. 다음은 smrtcvt 실행파일을실행할때사용하는명령어의문법이다. 명령어를실행하기전에 "which java" 명령어를통해사용하고있는 java의위치를확인한다. (WAS와다른계정으로설치할경우에는해당 WAS가사용하고있는 Java의위치를확인하고사용하도록한다.) USAGE: smrtcvt <rt.jar(or core.jar)> 명령어는아래와같이 smrtcvt를실행하면사용예를볼수있다. [apmqam@tmaxi7:/data1/apmqam/agent_4x/sm1007/dc_was]$smrtcvt USAGE : smrtcvt(.bat) <rt.jar(or core.jar)> <Expected Name> <Vendor> <jdk version> <current sminst path> ex) smrtcvt(.bat) /usr/jdk1.4/jre/lib/rt.jar rt_14.jar SUN 1.3 /home/apmtest/dc/sminst.jar ex) smrtcvt(.bat) /usr/jdk1.5/jre/lib/core.jar rt_15.jar IBM 1.4 /home/apmtest/dc/sminst.jar ex) smrtcvt(.bat) /usr/jdk14/jre/lib/rt.jar rt_14.jar JROCKIT 1.5 /home/apmtest/dc/sminst15.jar ex) smrtcvt(.bat) /usr/jdk1.4/jre/lib/rt.jar rt_14.jar SUN 1.6 /home/apmtest/dc/sminst15.jar 다음은 sminst_rt.jar 파일을생성하는예이다. Java 1.5 버전이상일경우에는 sminst_15.jar 파일을이용하 고 1.4 버전일경우에는 sminst.jar 파일을이용한다. 아래와같은로그를확인할수있다. *************************************************** SysMaster Provider(WAS DC) 4.0 제 4 장리소스등록 53
*************************************************** SYSMASTER Patch Classes... 각 java/io/fileinputstream.class : patch... java/io/fileoutputstream.class : patch... java/util/hashmap.class : patch... java/util/arraylist.class : patch... java/util/hashset.class : patch... java/util/identityhashmap.class : patch... java/util/linkedlist.class : patch... java/util/treeset.class : patch... java/net/socket.class : patch... SYSMASTER /usr/java5_64/jre/lib/vm.jar processed SYSMASTER Patch Classes... java/util/hashtable.class : patch... java/util/vector.class : patch... SYSMASTER /data1/apmqam/agent_4x/sm1007/dc_was/sminst15_rt.jar created 생성된 sminst_rt.jar 파일과함께 WAS 환경설정파일에등록되는라이브러리들에대한검증을 Check Env.class 를이용해서검증할수있다. ( 예. IBM J9) 아래내용과같이검증이진행된다. 1. -agentlib:/data1/apmqam/agent_4x/sm1007/dc_was/dcagent/jvmti/aix6l_64/dcagent64 apmqam@dc_home]$ java -agentlib:/data1/apmqam/agent_4x/sm1007/dc_was/dcagent/jvmti/aix6l_64/dcagent64 CheckEnv success jvmti_interface=110206288 sun.boot.library.path:/usr/java5_64/jre/bin * libdcagent 파일이있는폴더 path를입력한다. 64 bit일경우에는 dsagent64라고표기하고테스트한다. 2. -javaagent:/data1/apmqam/agent_4x/sm1007/dc_was/sminst_15.jar apmqam@dc_home]$ java -javaagent:/data1/apmqam/agent_4x/sm1007/dc_was/sminst_15.jar CheckEnv [SMDC] All stdout,stderr will be redirect to: /data1/apmqam/resourceid_node.container1/logs/smlog_resourceid_node.container1 ************************************************************** SysMaster Provider(WAS DC) 4.0 ************************************************************** - Property path : 54 SysMaster 설치안내서
/data1/apmqam/agent_4x/smagent/dc_was/sm_properties/sm2.properties - Extend BCI path : - Resource ID : R012 - Container PATH : tmaxi7_was.container2 - Master IP : 192.168.1.87 - Collector IP : 192.168.1.87 - Req Port : 22002 - Tx Port : 22007 - Mon Port : 22006 - OOM Detect : true - SQL PARAM TRACE : true - Thread Command : true - Socket Trace : true - TX His threshold : 3000 ms - TX View threshold : 100 ms - TX His send rate : 0.05 - TX view send rate : 0.2 - TX header send rate : 0.2 - User profile enable : true - User profile filter : included packages and classes sun.boot.library.path:/usr/java5_64/jre/bin 3. -Xbootclasspath/p:/data1/apmqam/agent_4x/sm1007/dc_was/rt_15.jar:/data1/ap mqam/agent_4x/sm1007/dc_was/sminst_15.jar apmqam@dc_home]$java -Xbootclasspath/p:/data1/apmqam/agent_4x/sm1007/dc_was/sminst15_rt.jar:/data1/apmqam/agent_4x/sm1007/dc_was/sminst_15.jar CheckEnv sun.boot.library.path:/usr/java5_64/jre/bin 4. -Dsm.property=/data1/apmqam/agent_4x/sm1007/dc_was/properties/sm1.properties apmqam@dc_home]$java -Dsm.property=/data1/apmqam/agent_4x/sm1007/dc_was/properties/sm1.properties CheckEnv sun.boot.library.path:/usr/java5_64/jre/bin 4.2.4. libdcagent library 파일복사 JDK1.5 버전다음위치의각시스템에해당하는 libdcagent library 파일을 sm.home으로이동한다. sm.home/dcagent/jvmti JDK1.4 버전 제 4 장리소스등록 55
다음위치의각시스템에해당하는 libdcagent library 파일을 JEUS_HOME/lib/system 에복사한다. sm.home/dcagent/jvmpi 참고 64bit 일경우, 파일명이 libdcagent64 이므로복사할때파일명을 libdcagent 로변경한다. 4.2.5. JEUSMain.xml 파일수정 JEUSMain.xml파일의각각의container절에서 command-option속성에 sminst.jar와 sminst_rt.jar파일을부트시참조하도록 bootclasspath옵션에절대경로위치를잡아주고, 각컨테이너별로참조할 sm.properties 파일위치도설정한다. JDK1.4 버전과 JDK1.5버전의 JEUSMain.xml 설정은다르다. 주의 libdcagent.so 파일을설정할때, JDK1.4에서는 JEUSHOME/lib/system/ 아래두거나기타 library path가잡혀있는곳에해당파일을두어야하지만, JDK1.5에서는 DC Home( 일반적인경우 ) 아래두고, 해당경로를잡아주도록한다. JDK 1.5에서는 JEUSHOME/lib/system/ 폴더아래나기타 library path 아래두지않도록한다. JDK1.4 다음은 JEUSMain.xml을설정하는예이다. <engine-container> <name>container1</name> <command-option> -Xbootclasspath/p:/data1/tmaxqas/agent3009/dc/sminst_rt.jar:/data1/ tmaxqas/agent3009/dc/sminst.jar -Dsm.property=/data1/tmaxqas/agent3009/dc/sm.properties1 </command-option> JDK1.5 다음은 JDK1.5 에서 JEUSMain.xml을설정하는예이다. <engine-container> <name>container1</name> <command-option> -javaagent:/data/apmqas/agent3011/dc/sminst.jar -agentpath:/data/apmqas/ agent3011/dc/libdcagent.so -Xbootclasspath/p:/data/apmqas/agent3011/dc/sminst_rt.jar:/data/apmqas/agent3011/dc/sminst.jar -Dsm.property=/data/ apmqas/agent3011/dc/sm.properties1 </command-option> DK1.5 IBM J9 56 SysMaster 설치안내서
다음은 JDK1.5 IBM J9에서의설정예이다. - agentlib:/jeus/sysmaster/agent/dc/dcagent/jvmti/aix/dcagent - javaagent:/jeus/sysmaster/agent/dc/sminst_15.jar - Xbootclasspath/p:/jeus/sysmaster/agent/dc/sminst_rt.jar: /jeus/sysmaster/agent/dc/sminst_15.jar - Dsm.property=/jeus/sysmaster/agent/dc/properties/sm1.properties 참고 JDK 종류와버전에따라 JEUSMain.xml 의설정옵션은조금씩차이가날수있으므로, 설치환경에 맞는옵션을관리자에게문의한다. 4.2.6. JEUS 및 Agent 재기동 모든설정이끝난후에는설정이반영될수있도록 JEUS 와 Agent 를재기동한다. 4.3. Oracle 리소스등록 Oracle 리소스를등록하는과정을요약하면다음과같다. 1. WEB UI에서리소스등록 2. DB User 생성및 Table 생성 3. ORACLE DC 설정 4. oradc.cfg 파일설정 5. FileJOB 서버설정 6. Trace/Object File 수집을위한 FileJOB 설정 다음은 Oracle을등록할때필요한파일이다. smoradc( 실행파일 ) evmap.cfg(config 파일 ) oradc.cfg(config 파일 ) stmap.cfg(config 파일 ) libsqlora8.a(library 파일 ) 위의파일은다음의디렉터리에서시스템별로압축파일의형태로제공된다. MASTER_HOME/provider/oracle/dc 제 4 장리소스등록 57
4.3.1. WEB UI 에서리소스등록 WEB UI에서리소스등록과정은다음과같다. 1. 시스마스터관리화면에서등록된 Agent를선택하고, 우측상단의 Select 박스에서 Resource를선택하고 [ 추가 ] 버튼을클릭한다. [ 그림 4.3] Oracle 리소스등록 2. 출력된화면에서리소스등록에필요한속성을설정한다. 4.3.2. DB User 생성및 Table 생성 에서등 록한사용자의정보와모니터링대상 DB 의기본정보를설정한다. 58 SysMaster 설치안내서
항목 db.user db.password db.cluster 설명 DB 사용자의이름이다. DB 사용자의패스워드이다. 클러스터의이름이다. RAC 로구성되어있지않더라도임의의값으로구성해주어야한다. Oracle DB 의이름을권장한다. db.sid SID 이다. 다음의 SQL 문장을사용해 SID 를확인할수있다. select instance_name from v$instance; jdbc.driver.class.name jdbc.url JDBC 드라이버의이름이다. JDBC URL 이다. URL 은다음과같다. jdbc:oracle:thin:@192.168.11.8:1521:ora9i Agent 를기동시키기전에 JDBC jar 파일을 Agent 의 lib 디렉터리에복사해 주거나 class path 에경로를잡아주어야한다. db.address db.port db.oracle.home DB 의 IP 주소이다. DB 의포트번호이다. Oracle 홈디렉터리의경로이다. /home/oracle/oracle/product 3. 등록과정이종료되면 Agent 를재기동한다. 4. 재기동을한뒤 Console 창을통하여다음과같이리소스의등록을확인할수있다. [ 그림 4.4] Oracle 리소스등록확인 제 4 장리소스등록 59
4.3.2. DB User 생성및 Table 생성 모니터링대상 DB 에다음의스크립트를이용하여 User 및 Table을생성한다. sysmaster-provider-oracle-ddl-sys.sql sysmaster-provider-oracle-ddl-base.sql sysmaster-provider-oracle-procedure_locktree.sql sysmaster-provider-oracle-procedure_virtual_index.sql Default user 명인 SMADM을사용하지않는다면 agent/sysmaster-provider-oracle-ddl-sys.sql 파일의 user 생성부분을수정해야한다. 해당 SQL 문장은 sysdba 권한에서수행을해야한다. 그외의 SQL 문장은생성한 user 명으로접속하여수행하도록한다. 같이제공되는 sysmaster-for-oracle-installer.sh를통하여쉽게 SQL 문장을생성할수있다. 다음의파일이존재하는지확인한뒤스크립트를수행한다. 해당스크립트를수행하기위해서는 sys 계정의비밀번호가필요하다. DBA 권한이있는계정에서만아래의스크립트를수행할수있다. ( 계정을확보하지못하면담당자에게부탁하도록한다.) sysmaster-for-oracle-create-general1.sql sysmaster-for-oracle-create-general2.sql sysmaster-for-oracle-create-procedure.sql sysmaster-for-oracle-create-sys.sql sysmaster-for-oracle-create-tablespace.sql sysmaster-for-oracle-create-user.sql Oracle 프로바이더는 SQL 통계정보수집을위하여 MERGE_SQL_EXEC_COUNT 프로시저를 repositgory DB 계정에서수행한다. 해당프로시저에서호출되는 SQL 의수행을위하여 repository DB 계정에다음과같이권한을주어야한다. GRANT CREATE TABLE TO {USER}; 주의 프로스저에서호출되는 SQL 은롤단위로권한을부여해서는적용되지않음에주의하도록한다. SQL 실행계획조회를위해서는생성된 sm_plan_table 에대하여 sys 또는 system 계정으로다음의작업을수행해야한다. CREATE PUBLIC SYNONYM SM_PLAN_TABLE FOR smadm.sm_plan_table; GRANT ALL ON SM_PLAN_TABLE TO PUBLIC; ORACLE DC 설정 본절에서는공유메모리를사용하기위해 Oracle DC 를설정하는방법을설명한다. 메모리가하나인경우 60 SysMaster 설치안내서
메모리가하나일경우 DC 를설정하는방법은다음과같다. 1. 다음과같이설정한다. oradc.sga.shm_num=1 2. DC를실행하는계정이 sysresv를실행해서공유메모리정보를얻을수있는지없는지에따라설정방법이다음과같이달라진다. a. sysresv로공유메모리정보를얻을수있는경우 : shm_ids와 shm_addrs를설정하지않아도 DC 에서자동으로처리한다. b. sysresv로공유메모리정보를얻을수없는경우 : shm_addrs는별도로설정하지않아도 DC에서자동으로처리한다. 공유메모리 ID가 21이라고가정하면, 다음과같이설정한다. oradc.sga.shm_ids=21 메모리가다수인경우메모리가다수인경우 DC를설정하는방법은다음과같다. 1. sysdba 권한으로 ( 일반적으로 sys계정 ) sqlplus로 DB에접속한다. 2. sqlplus 프롬프트에서다음두가지명령어를차례로수행한다. oradebug setmypid oradebug ipc 3. 다음의명령어를수행하여덤프파일이저장되는위치를확인한다. show parameter user_dump_dest 4. 셸로돌아와서 user_dump_dest 디렉터리로이동한뒤, 다음명령어를실행한결과의첫번째파일을 편집기로연다. ls -t 5. 파일내용중 "Area #0 Fixed Area" 라는부분을찾는다. Shmid가공유메모리의 ID값이며, Stable Addr이접근할공유메모리주소이다. Shmid가같은데 Stable Addr 부분만다르게여러개로표시되어있는경우, 공유메모리가하나인경우에해당하므로처음에나온더작은주소값을써주고나머지는무시한다. 참고 위의방법을실행하려면 sysdba 권한이필요하므로이권한을주지않는사이트에서는담당 DBA 에 게작업을요청해야한다. 제 4 장리소스등록 61
다음은 Oracle DC를설정하는예이다. oradc.sga.shm_num=3 oradc.sga.shm_ids=21,22,30 oradc.sga.shm_addrs=c000000040000000,c000000080000000,c000000210000000 위의예는공유메모리개수가 3개이고, 각각의 ID가 21, 22, 30이고, 각각의주소가 c000000040000000, c000000080000000, c000000210000000일경우의설정이다. 4.3.3. ORACLE DC 설정 본절에서는공유메모리를사용하기위해 Oracle DC를설정하는방법을설명한다. Oracle DC는 Oracle Server의 SGA영역의주소값을등록하고해당메모리에접근해서정보를수집하는 프로세스로서설치계정이 DBA그룹에속해있어야한다. ( 메모리를조회하는명령어에는 ipcs -m 이있 다. 조회된내용에서 dba 그룹의 shm_id 값을찾는다.) 제공된바이너리의압축을풀면아래와같이구성되어있다. [daehun@tmaxi7:/data1/daehun/sysmaster40/smoradc_aix64]$ls -al total 176 drwxr-xr-x 9 daehun dba 256 Nov 15 14:51. drwxr-xr-x 8 daehun dba 256 Nov 18 11:57.. drwxr-xr-x 2 daehun dba 4096 Dec 19 20:16 bin drwxr-xr-x 2 daehun dba 256 Jun 09 2010 config drwxr-xr-x 2 daehun dba 256 Jun 09 2010 lib drwxr-xr-x 2 daehun dba 4096 Dec 23 00:00 logs drwxr-xr-x 2 daehun dba 256 Jun 09 2010 monitor -rw-r--r-- 1 daehun dba 0 Jun 09 2010 readme.txt drwxr-xr-x 2 daehun dba 4096 Nov 15 14:53 sql drwxr-xr-x 2 daehun dba 73728 Dec 23 20:30 trace 항목 bin config lib logs monitor trace 설명 oradc 라이브러리실행파일폴더이다. (smoradc, dcdown 등 ) Oracle SGA영역의정보와 Master 정보를등록하는환경파일폴더이다. ( oradc.cfg) Oracle DC의라이브러리가위치이다. Oracle DC의로그파일위치이다. Oracle DC의실행이력이다. Oracle DC에서수집한 trace 파일위치이다. 설치된파일에서수정해야할파일은 $ORACLEDC_HOME/config/oradc.cfg 파일이있다. 사용하는포트에는 oradc.cfg 파일에설정하는아래의포트가있다.. oradc.master.monitor.port=22006 oradc.master.request.port=22002 62 SysMaster 설치안내서
메모리가하나인경우메모리가하나일경우 DC를설정하는방법은다음과같다. 1. 다음과같이설정한다. oradc.sga.shm_num=1 2. DC를실행하는계정이 sysresv를실행해서공유메모리정보를얻을수있는지없는지에따라설정방법이다음과같이달라진다. a. sysresv로공유메모리정보를얻을수있는경우 : shm_ids와 shm_addrs를설정하지않아도 DC 에서자동으로처리한다. b. sysresv로공유메모리정보를얻을수없는경우 : shm_addrs는별도로설정하지않아도 DC에서자동으로처리한다. 공유메모리 ID가 21이라고가정하면, 다음과같이설정한다. oradc.sga.shm_ids=21 메모리가다수인경우메모리가다수인경우 DC를설정하는방법은다음과같다. 1. sysdba 권한으로 ( 일반적으로 sys계정 ) sqlplus로 DB에접속한다. 2. sqlplus 프롬프트에서다음두가지명령어를차례로수행한다. oradebug setmypid oradebug ipc 3. 다음의명령어를수행하여덤프파일이저장되는위치를확인한다. show parameter user_dump_dest 4. 셸로돌아와서 user_dump_dest 디렉터리로이동한뒤, 생성된덤프파일을파일을 vi 편집기로연다. 5. 파일내용중 "Area #0 Fixed Area" 라는부분을찾는다. Shmid가공유메모리의 ID값이며, Stable Addr이접근할공유메모리주소이다. Shmid가같은데 Stable Addr 부분만다르게여러개로표시되어있는경우, 공유메모리가하나인경우에해당하므로처음에나온더작은주소값을써주고나머지는무시한다. 참고 위의방법을실행하려면 sysdba 권한이필요하므로이권한을주지않는사이트에서는담당 DBA 에 게작업을요청해야한다. 제 4 장리소스등록 63
다음은 Oracle DC를설정하는예이다. oradc.sga.shm_num=3 oradc.sga.shm_ids=21,22,30 oradc.sga.shm_addrs=c000000040000000,c000000080000000,c000000210000000 위의예는공유메모리개수가 3개이고, 각각의 ID가 21, 22, 30이고, 각각의주소가 c000000040000000, c000000080000000, c000000210000000일경우의설정이다. 4.3.4. oradc.cfg 파일설정 다음은 oradc.cfg 파일에설정예이다. # DB connection information setting ################################################################################ # oradc.db.address: # Address of Oracle Database(ip or hostname). # oradc.db.port: # Port number of Oracle Database. # oradc.db.user: # Oracle user id. # oradc.db.password: # Password of Oracle user. # oradc.db.sid: # Oracle sid. # oradc.db.priv: # Oracle privilege for connection(for SYSDBA only). # Let this value empty if you want to connect with general privilege. ################################################################################ oradc.db.address=192.168.1.35 oradc.db.port=1521 oradc.db.user=smadm40 oradc.db.password=smadm40 oradc.db.sid=ora10g oradc.db.priv= ################################################################################ # Master connection information setting ################################################################################ # oradc.resource_name: # Sysmaster resource name which is registered in Master. # oradc.master.address: # Address of Master(ip or host name). # oradc.master.port: # Port number of Master. ################################################################################ oradc.resource_id=r007 64 SysMaster 설치안내서
oradc.resource_name=tmaxi4_oracle_ora10g oradc.master.address=192.168.1.87 oradc.master.monitor.port=22006 oradc.master.request.port=22002 ################################################################################ # SGA acces information setting ################################################################################ # oradc.sga.shm_num: # Number of shared memory of SGA # oradc.sga.shm_ids: # Shared memmory id. You can specify mutiple ids by seperating with, # like 22,31,23 # oradc.sga.shm_keys: # Shared memmory key. You can only specify one of id or key. # The key must be specified with hexadecimal value.(0x prefix is optional) # You can specify mutiple keys by seperating with, # like 1020,2111,0x333 # oradc.sga.shm_addrs: # Allocated shared memmory addresses which oracle created. # You can specify mutiple ids by seperating with, # like c0000000a0000000,b0000000 ################################################################################ oradc.sga.shm_num=1 oradc.sga.shm_ids=1048577 #oradc.sga.shm_keys= #oradc.sga.shm_addrs= oradc.trace_data.dir=/home/apmqam/agent32_sp2_f1_080421/smoradc/trace oradc.trace.count_per_sec=20 oradc.sql_trace.milisec=0 oradc.monitor_data.dir=/user/apmqam/smoradc/monitor oradc.log.dir=/home/apmqam/agent32_sp2_f1_080421/smoradc/logs oradc.log.level=debug oradc.event_map_file=/home/apmqam/agent32_sp2_f1_080421/smoradc/config/evmap.cfg oradc.stat_map_file=/home/apmqam/agent32_sp2_f1_080421/smoradc/config/stmap.cfg DB 연결정보설정 (DB connection information settting) 모니터링대상 DB의정보를설정한다. Console을통하여 DB 정보를설정해주었다면주석처리해도된다. oradc.db.address=192.168.1.35 oradc.db.port=1521 oradc.db.user=smadm40 제 4 장리소스등록 65
oradc.db.password=smadm40 oradc.db.sid=ora10g oradc.db.priv= Master 연결정보설정 (Master connection information settting) Master에등록한리소스명과 Master 정보를설정한다. oradc.resource_id=r007 oradc.resource_name=tmaxi4_oracle_ora10g oradc.master.address=192.168.1.87 oradc.master.monitor.port=22006 oradc.master.request.port=22002 SGA 접속정보설정 (SGA access information setting) Oracle의 SGA 가사용하고있는공유메모리 (shared memory) 정보를설정한다. 공유메모리의자세한설정방법은 "3.3 Oracle DC 설정 " 을참고한다. oradc.resource_id=r007 oradc.resource_name=tmaxi4_oracle_ora10g oradc.master.address=192.168.1.87 oradc.master.monitor.port=22006 oradc.master.request.port=22002 트레이스데이터정보설정 (Trace data information setting) Agent 가수집한트레이스데이터정보를설정한다. oradc.trace_data.dir=/home/apmqam/agent32_sp2_f1_080421/smoradc/trace oradc.trace.count_per_sec=20 oradc.sql_trace.milisec=0 모니터링데이터정보설정 (Monitor data information setting) 모니터링데이터파일이저장되는디렉터리를설정한다. oradc.monitor_data.dir=/user/apmqam/smoradc/monitor 데이터요청정보설정 (Request data information setting) 데이터수집질의를수행하는스레드의수를설정한다. oradc.request_thread.num=2 로그설정 (Log Setting) 로그파일정보를설정한다. oradc.log.dir=/home/apmqam/agent32_sp2_f1_080421/smoradc/logs oradc.log.level=debug 66 SysMaster 설치안내서
이벤트매핑파일과통계매핑파일설정 (Event and stat maapping files) Oracle의다음과같은파일의위치를설정한다. oradc.event_map_file=/home/apmqam/agent32_sp2_f1_080421/smoradc/config/evmap.cfg oradc.stat_map_file=/home/apmqam/agent32_sp2_f1_080421/smoradc/config/stmap.cfg 4.3.5. Trace/Object File 수집을위한 FileJOB 설정 Orcle의이벤트, 통계, 잠금 (Lock), 세션통계정보를모니터링하기위해서는 Master Server에서다음의설정을해주어야한다. Trace File JOB 설정 1. $SysMaster_HOME//jeus/lib/application/provider/oracle/filejobs.xml 파일에다음과같이추가한다. <job name="[ora]trace_action_r007" desc="" depends=""> <job-execute>true</job-execute> <job-logging>true</job-logging> <job-compress>true</job-compress> <job-parallel>false</job-parallel> <job-timeout>1200000</job-timeout> <!-- 20Minute --> <job-clazz> <clazz-name> sysmaster.provider.oracle.master.filejob.transaction.oracletracefilejob </clazz-name> <clazz-param>10</clazz-param> <convert-clazz-name> sysmaster.provider.oracle.master.filejob.transaction.oracletracefileconverter </convert-clazz-name> </job-clazz> <agent-file-manager> <file-home>/data1/apmqas/m40_agent/smoradc_aix64/trace/</file-home> <file-delete>0</file-delete> <!-- -1:not-delete, 0:delete-now --> </agent-file-manager> <master-file-manager> <file-home>/data1/apmqam/master_4x/temp/oracle/</file-home> <file-delete>-1</file-delete> <!-- -1:not-delete, 0:delete-now --> </master-file-manager> </job> 최초로설정할때에는위의설정중 <agent-file-manager> 와 <master-file-manager> 만수정해서사용하며, 이후추가적으로 FilejJb 등록할때 <job name> 이겹치지않게추가해야한다. 제 4 장리소스등록 67
2. oracle.xml 에작성한 <job name> 을 Console의 executefilejobname 액션으로등록한뒤, 스케줄러를이용하여동작시킨다. 이때스케줄러의동작주기는 10분에한번으로한다. 최초로설정하는경우에는등록되어있는 Trace_Collect_Min 액션을사용하여도무방하며추가적인 FileJob을등록할경우 executefilejobname 항목에해당 job name 을입력한뒤스케줄러에추가시키도록한다. 스케줄러는기본으로제공하는 Trace_Collect_Min을사용하도록한다 참고 XML 파일수정후에는 Master 를재기동해야적용이된다. Object File JOB 설정 1. $SysMaster_HOME//jeus/lib/application/provider/oracle/oracle.xml 파일에다음과같이추가해주어야한다. <job name="[ora]object_job_r007" desc="" depends=""> <job-execute>false</job-execute> <job-logging>false</job-logging> <job-compress>true</job-compress> <job-parallel>false</job-parallel> <job-timeout>1200000</job-timeout> <job-clazz> <clazz-name> sysmaster.provider.oracle.master.filejob.change.oraclechangehistoryfilejob </clazz-name> <clazz-param>10</clazz-param> <convert-clazz-name> sysmaster.provider.oracle.master.filejob.change.oraclechangehistoryfileconverter </convert-clazz-name> </job-clazz> <agent-file-manager> <file-home>/data1/apmqas/m40_agent/smoradc_aix64/monitor/</file-home> <file-delete>0</file-delete> </agent-file-manager> <master-file-manager> <file-home>/data1/apmqam/master_4x/temp/oracle/</file-home> <file-delete>-1</file-delete> </master-file-manager> </job> 2. oracle.xml 에작성한 <job name> 을 Console 의 executefilejobname 액션으로등록한뒤, 스케줄러를 이용하여동작시킨다. 이때스케줄러의동작주기는하루에한번으로한다. 68 SysMaster 설치안내서
참고 XML 파일수정후에는 Master 를재기동해야적용이된다. 4.4. AnyLink 리소스등록 AnyLink 리소스를등록하는과정을요약하면다음과같다. 1. WEB UI에서리소스등록 2. Hooking Engine/DC 설치및설정 3. Table 생성및 Gateway 속성등록 4. 대역폭모니터링설정값입력 5. Trace File 수집을위한 FileJob 설정 4.4.1. WEB UI 에서리소스등록 WEB UI에서의리소스등록과정은다음과같다. 1. 시스마스터관리화면에서등록된 Agent를선택하고, 우측상단의 Select 박스에서 Resource를선택하고 [ 추가 ] 버튼을클릭한다. [ 그림 4.5] AnyLink 리소스등록 제 4 장리소스등록 69
2. 출력된화면에서리소스등록에필요한속성을설정한다 항목 config.file.path 설명 AnyLink 환경설정파일위치를설정한다. ( ex. /openframe/apmqaoh/anylink_nh/config/anylink.m) tmaxadm.filter.backupsvr config.domain.name tmaxadm.svcname faile( 고정 ) AnyLink 환경파일의 domain.name 이다. TMAXADM 서버설정이름이다. 참고리소스등록후에는반드시노드를등록해줘야한다. 3. 등록과정이종료되면 Agent를재기동한다. 4. 재기동을한뒤 Console 창을통하여다음과같이리소스의등록을확인할수있다. 70 SysMaster 설치안내서
[ 그림 4.6] AnyLink 리소스등록확인 4.4.2. Hooking Engine/DC 설치및설정 다음은 Hooking Engine/DC 설치및설정하는방법에대한설명이다. Hooking Engine/DC 설치 install.sh 과설치관련파일이압축되어있는 tar 를제공한다. 참고 제공되는 tar 파일명은상황에따라유동적으로변경되므로주의한다. 설치순서는다음과같다. 1. 설치계정의 '.profile' 에 Hooking Engine 및 DC 를설치할경로를추가한다. # Set up the AnyLink environment: export SMTRC_HOME=/anylink_user/hook_enigne_dc 2. 설치경로에설치파일복사후압축을해제한다. $ cd $SMTRC_HOME $ tar xvf sysmaster_for_anylink_engine_dc.tar $ ls anylink_engine_dc.tar.gz install.sh 3. 설치셸을실행한다. 설치가성공적으로완료되면아래와같은정보가출력된다. 제 4 장리소스등록 71