MaxGauge for MySQL Installation Guide
Table of contents 1. 구성도... 4 2. Maxgauge For MySQL 설치정보... 6 설치파일정보... 6 포트정보... 6 주요디렉토리... 6 소프트웨어기동 / 종료... 7 기동... 7 종료... 7 3. Maxgauge For MySQL 설치... 9 설치전준비사항... 9 Maxgauge For MySQL 설치절차... 10 모니터링서버... 10 Logging서버... 19 Window Version... 20 Linux Version... 32
MAXGAUGE FOR MYSQL 설치정보 1 구성도 3
MFM 4.1_INSTALL GUIDE 1. 구성도 4
MAXGAUGE FOR MYSQL 설치 2 MAXGAUGE FOR MYSQL 설치정보 2. Maxgauge For MySQL 설치정보... 6 설치파일정보... 6 포트정보... 6 주요디렉토리... 6 소프트웨어기동 / 종료... 7 기동... 7 종료... 7 5
MFM 4.1_INSTALL GUIDE 2. Maxgauge For MySQL 설치정보 설치파일정보 파일이름 sysmon.maxgauge4mysql_20151202_sysmon_64bit.linux.tar 설치위치 모니터링서버 maxgauge4mysql.v4.2.151207.1822.install.win.zip Logging 서버 (WINDOW 버전 ) maxgauge4mysql.v4.2.151218.1629.install.linux.tar Logging 서버 (LINUX 버전 ) license.trial_20160630.mfm.key Logging 서버 포트정보 호스트 Default 포트 설명 실시간모니터통신 8070 WAS/GAHTER 와 Client 사이의포트통신 MySQL DB 통신 3306 MySQL DB 와 WAS/GATHER 통신포트 데몬통신 9729 Daemon 과 WAS/GATHER 통신포트 주요디렉토리 디렉토리 설명 설치위치 설치경로 /maxgauge/sysmon MaxGauge Daemon 설치경로 모니터링서버 설치경로 /maxgauge/sysmon/conf/instance01 MaxGauge Daemon 설정파일경로 모니터링서버 설치경로 \maxgauge4mysql_151207_win MaxGauge WAS/GAHTER 설치경로 Logging 서버 (WINDOW 버전 ) 설치경로 /maxgauge MaxGauge WAS/GAHTER 설치경로 Logging 서버 (LINUX 버전 ) 6
MAXGAUGE FOR MYSQL 설치 소프트웨어기동 / 종료 기동 명령어 or 버튼 결과확인 설치위치./sysmonlinux -d Ps ef grep sysmon 모니터링서버./sysmonlinuObserver -d Ps ef grep sysmon 모니터링서버 Was start 프로그램확인가능 Logging 서버 Controller start 프로그램확인가능 Logging 서버 종료 명령어 or 버튼 결과확인 설치위치 Kill -9 SID 명 Ps ef grep sysmon 모니터링서버 Was stop 프로그램확인가능 Logging 서버 Controller stop 프로그램확인가능 Logging 서버 기동및종료쉘 명령어 or 버튼결과확인설치위치./main.sh Ps ef grep sysmon 모니터링서버 7
MFM 4.1_INSTALL GUIDE 3 MAXGAUGE FOR MYSQL 설치 3. Maxgauge For MySQL 설치... 9 설치전준비사항... 9 Maxgauge For MySQL 설치절차... 10 모니터링서버... 10 Logging서버... 19 Window Version... 20 Linux Version... 32 8
MAXGAUGE FOR MYSQL 설치 3. Maxgauge For MySQL 설치 설치전준비사항 작업명 작업내용 Port 준비 : 9729 (Sysmon 통신포트 ) DB 서버 DB 계정 : Maxgauge 데이터수집용 DB 계정필요. ( 모든테이블 Select 할수있는권한 ) Process 확인요청 : MySQL Error, Slowquery log 해당경로 확인요청 Port 준비 : 8070 (WAS 구동포트 / 웹서버연결 ) 8071 (WAS 종료포트 ) -Local 통신용 Logging PC (Repository DB) 8072 (Gather) -Local 통신용 3306( 모니터링서버접속포트 ) DB 계정 : MYSQL 5.6 이후정식버전 Database, Table, Function, Procedure, View 등등대부분 Crud 권한 9
MFM 4.1_INSTALL GUIDE Maxgauge For MySQL 설치절차 모니터링서버 작업명작업내용소요시간 Upload 설치파일업로드 3 분 디렉토리생성설치경로의 Maxgauge 용디렉토리생성 1 분 압축해제파일압축해제 (Tar) 1 분 Daemon 실행환경설정파일생성을위한파일실행 2 분 Mysqld 경로확인 MySQL 경로확인 ps-ef grep mysqld 으로확인 3 분 Error log, slow query 경로확인 ps ef grep mysqld 경로에서확인 3 분 Port 확인 netstat an grep 9729 포트확인 1 분 /maxgauge/sysmon/conf/instance01 환경설정 /maxgauge/sysmon/conf/mfm.conf 파일에해당정보입력 3 분 Daemon 기동./maxgauge/sysmon/bin/sysmonlinuxObserver d 1 분 설치파일업로드 sysmon.maxgauge4mysql_20151202_sysmon_64bit.linux.tar 파일업로드 설치할위치에파일업로드 10
MAXGAUGE FOR MYSQL 설치 압축해제할디렉토리생성 담당자가원하는위치에 Maxgauge For Mysql 용디렉토리를생성 Default : 설치할디렉토리위치 /maxgauge/ sysmon 담당자가원하는설치위치에 maxgauge 디렉토리를생성 mkdir maxgauge maxgauge 디렉토리안에 sysmon 디렉토리를생성 cd maxgauge mkdir sysmon sysmon 디렉토리안에 bin, tmp 디렉토리생성 cd sysmon mkdir bin mkdir tmp 설치경로 /maxgauge/sysmon/bin 디렉토리안에업로드파일을옮긴후, 압축해제 업로드받은파일을설치경로 /maxgauge/ sysmon/bin/ 으로이동 mv sysmon.maxgauge4mysql_20151202_sysmon_64bit.linux.tar 설치위치 /maxgauge/sysmon/bin/ 11
MFM 4.1_INSTALL GUIDE 압축해제 tar-xvf sysmon.maxgauge4mysql_20151202_sysmon_64bit.linux.tar 압축파일은 2) 번에서생성한 maxgauge/sysmon/tmp 디렉토리로이동 압축파일은추후버전을확인할수있도록 2) 에서생성한 tmp 위치로이동 mv sysmon.maxgauge4mysql_20151202_sysmon_64bit.linux.tar 설치위치 /maxgauge/sysmon/tmp 또는 mv sysmon.maxgauge4mysql_20151202_sysmon_64bit.linux.tar../tmp 12
MAXGAUGE FOR MYSQL 설치 환경설정파일생성을위해 sysmon/bin 폴더안에 sysmonlinux 구동후종료 설치위치 /maxgauge/sysmon/bin 위치로이동 cd 설치위치 /maxgauge/sysmon/bin 환경설정파일을생성하기위해 sysmon 데몬을기동./sysmonlinux d Or./main.sh 실행 설치위치 /maxgauge/sysmon 위치로이동하여 conf, log 디렉토리가생성되었는지확인 cd 설치위치 /maxgauge/sysmon/ 데몬 kill 환경설정을하지않은데몬 (sysmon) 이기때문에 kill sysmon 의 sid 값확인 ps ef grep sysmon kill - kill -9 SID 명 Or 13
MFM 4.1_INSTALL GUIDE./main.sh 실행 정상종료되었는지재확인 ps ef grep sysmon 포트확인 Sysmon 통신포트체크 nestat an grep 9729 mysqld 경로및포트확인 MySQL 환경설정값확인및포트확인 ps ef grep mysqld 해당경로복사 14
MAXGAUGE FOR MYSQL 설치 Error log / Data directory / Slow query 경로파악 Mysql 환경설정값에서 log error 위치확인 ps ef grep mysqld Error Log 위치확인 Data Directory 위치확인 설치위치 /maxgauge/sysmon/conf/instance01 에 MySQL 관련환경경로입력 설치위치 /maxgauge/sysmon/conf 로이동 cd 설치위치 /maxgauge/sysmon/conf instance01 에해당경로입력 vi instance01 15
MFM 4.1_INSTALL GUIDE instance01 PORT : MySQL 포트입력 PATH : MySQL 경로입력 ( 위 PORT 로해당 MySQL 을찾지못할경우, PATH 를이용해접속 ) DATA_PATH : MySQL Data Directory 경로입력 (ps ef grep mysqld 의 datadir) ERROR : ERROR LOG 경로입력 (ps ef grep mysqld 의 log-error) SLOWQUERY : SLOWQUERY 경로입력 ( 해당경로확인후입력 ) 설치위치 /maxgauge/sysmon/conf/mfm.conf 에포트입력 mfm.conf 에 Sysmon 통신포트입력 vi mfm.conf mfm.conf 값은 Default 상태로구동가능 [mfm.conf] PORT : Sysmon 포트입력 16
MAXGAUGE FOR MYSQL 설치 LEVEL : Consol( 화면출력 ):0, Packet:1( 요청응답 log 파일저장 ), Process:2( 수집데이터 log 파일저장 ) INTERVAL : 로그전송과체크주기 ( 초 ) LIMIT_MEM : 수집제한메모리 (MB) - 각 LOG 가초과되면기존수집된로그제거 LIMIT_TRANS : 한번에전송할최대크기제한 (KB) - 네트워크상황에따라변경하도록함 FILES : SysLog 경로입력 ALIAS : 인스턴스별칭으로 ; 로구분하여입력 한서버의 MySQL 이여러개일경우, 추가입력 Debug 파일이동 설치위치 /maxgauge/sysmon/bin 위치로이동 cd 설치위치 /maxgauge/sysmon/bin Debug 파일이름변경 mv readme.log.conf log.conf 17 Debug 파일설치위치 /maxgauge/sysmon/conf 위치로이동
MFM 4.1_INSTALL GUIDE mv log.conf 설치위치 /maxgauge/sysmon/conf/ Or mv log.conf../conf Deamon 구동 설치위치 /maxgauge/sysmon/bin 위치로이동 cd 설치위치 /maxgauge/sysmon/bin sysmon Observer 기동./sysmonlinuxObserver d Or./main.sh 실행 sysmon Observer 기동하면 sysmon 데몬도자동으로기동 정상기동되었는지확인 ps ef grep sysmon 18
MAXGAUGE FOR MYSQL 설치 Logging 서버 작업명작업내용소요시간 Upload 설치파일업로드 3 분 디렉토리생성설치경로의 Maxgauge 용디렉토리생성 1 분 압축해제파일압축해제 (TAR or ZIP) 1 분 License 등록 License 등록 2 분 Agent 실행 Agent(Was, Gather 설정파일 ) 실행 3 분 Logging pc MySQL 에대한정보입력 환경설정 WAS, Gather 포트입력 (default : 8070 8071) Maxgauge 용생성 DB 이름입력 Maxgauge 용 MySQL 로그인계정입력 5 분 정상접속확인 Connect test 버튼클릭후 success 확인 1 분 프로시저및테이블생성 Create Repository DDL 버튼클릭후, 필요한프로시저 및테이블자동생성 2 분 Agent 기동 Menu>Process > All Start 으로실행 1 분 19
MFM 4.1_INSTALL GUIDE Window Version 디렉토리생성 설치할위치에 Maxgauge 구분용디렉토리생성 설치파일업로드 maxgauge4mysql.v4.2.151207.1822.install.win 파일업로드 설치할위치에파일업로드 20
MAXGAUGE FOR MYSQL 설치 압축해제 maxgauge4mysql.v4.2.151207.1822.install.win 파일압축해제 압축해제한폴더에 app, bin, biz, conf, svc, 실행파일 (MaxGauge4MySQLWeb.exe) 이존재하는지확인 21
MFM 4.1_INSTALL GUIDE license 넣기 conf 폴더안에 license 폴더로이동 해당위치에 license 파일업로드 22
MAXGAUGE FOR MYSQL 설치 MaxGauge4MySQLWeb.exe 실행 실행파일 (MaxGauge4MySQLWeb.exe) 실행 23
MFM 4.1_INSTALL GUIDE Default 로 다음화면이출력되면정상 환경설정 configuration 의로깅 PC 관련환경변수입력 Process - WAS Listen Port : WAS 구동포트 / 웹접속 (Default : 8070) Stop Port : WAS 종료포트 (Default : 8071) Process Gather Listen Port : Gather 구동 (Default : 8072) Database -Repository Type : DB 타입선택 Hostname : Logging PC 의 IP 입력 DB Name : Logging PC MySQL 의 Maxgauge 데이터수집용 DB 이름 - 이름만지정하면추후 6) 번과정에서입력한이름명으로 DB 생성및프로시저적용 - ( ex : MFM150413) User : Logging PC MySQL 의접속계정 24
MAXGAUGE FOR MYSQL 설치 Password : Logging PC MySQL 의접속 Password Logging DB 의 IP 입력 (ex)192.168.123.160 필요시 MariaDB 로선택 원하는 DB 이름입력 Logging PC 의 MySQL 접속가능확인 하단 connect test 버튼클릭 Success 나오면정상 25
MFM 4.1_INSTALL GUIDE Logging PC 의 MySQL 의 Maxgauge 용 DB 생성및프로시저생성 하단 Create Repository DDL 버튼클릭 버튼클릭후, Cmd 창이자동으로오픈됨 자동으로 DB 생성및프로시저생성을진행한후, 마지막 Success 가올라오면정상 26
MAXGAUGE FOR MYSQL 설치 WAS, GATHER 실행 Save 버튼클릭후, 변경내용저장 Menu 창에서 Process > All start 클릭 첫구동시, gather 는구동되었다가등록된서버가없어다시내려감 ( 정상상태 ) 27
MFM 4.1_INSTALL GUIDE 첫구동시 정상 Chrome 접속 ip 명 : 포트로 chrome 접속 첫로그인시계정 / 비밀번호는 Admin/1 28
MAXGAUGE FOR MYSQL 설치 로그인계정추후에 Admin 페이지에서변경가능 모니터링서버등록 Menu > Server > Server 로이동 Add 버튼을클릭후, 모니터링할서버 (sysmon 데몬이설치되어있는서버 ) 정보입력 server ID : server 명 server Alias : server ID 등록하면자동으로저장됨 / 변경가능 Type : DB 선택 29
MFM 4.1_INSTALL GUIDE IP Address : 모니터링 IP 입력 Port : MySQL 포트입력 DB Login ID : DB Password : Sysmon Port : Sysmon 연결포트입력 (Default : 9729) System Encoding : Encoding 선택 SQL Text Length : SQL 텍스트길이선택 Instance Name : Ssysmon 환경설정파일이름 (Default : Instance01) Sysmon 데몬을설치한모니터링 정보를입력 Save 버튼을클릭한후, 해당모니터링서버체크후 Test Connection 버튼클릭 Success 정상확인 ( 참고 ) Menu > Server > Server 의값변경 -> 저장시에 Gather 를재시작해야적용됨 30
MAXGAUGE FOR MYSQL 설치 서버체크후 Test Connection Gather 재시작 실행파일 (MaxGauge4MySQLWeb.exe) 에서 Gather 시작 Menu 창에서 Process > Controller start 클릭 31
MFM 4.1_INSTALL GUIDE 모니터링시작 Linux Version 설치파일업로드 maxgauge4mysql.v4.2.151218.1629.install.linux.tar 파일업로드 설치할위치에파일업로드 압축해제할디렉토리생성 담당자가원하는위치에 Maxgauge For Mysql 용디렉토리를생성 Default : 설치할디렉토리위치 /maxgauge/ 담당자가원하는설치위치에 maxgauge 디렉토리를생성 mkdir maxgauge maxgauge 디렉토리안에 tmp 디렉토리를생성 cd maxgauge 32
MAXGAUGE FOR MYSQL 설치 mkdir tmp 설치경로 /maxgauge 디렉토리안에업로드파일을옮긴후, 압축해제 업로드받은파일을설치경로 /maxgauge/ sysmon/bin/ 으로이동 mv maxgauge4mysql.v4.2.151218.1629.install.linux.tar 설치위치 /maxgauge/ 압축해제 tar-xvf maxgauge4mysql.v4.1.150407.1757.install.linux.tar 압축해제하고생성된 x_convert.tar 파일압축해제 압축해제 tar-xvf x_convert.tar 33
MFM 4.1_INSTALL GUIDE 압축파일 (Tar) 은 2) 번에서생성한 maxgauge/tmp 디렉토리로이동 압축파일은추후버전을확인할수있도록 2) 에서생성한 tmp 위치로이동 mv maxgauge4mysql.v4.2.151218.1629.install.linux.tar 설치위치 /maxgauge/tmp mv x_convert.tar 설치위치 /maxgauge/tmp 또는 mv maxgauge4mysql.v4.2.151218.1629.install.linux.tar tmp mv x_convert.tar tmp 압축해제된 x_convert 디렉토리로이동후, chmod.sh 스크립트실행 압축해제된 x_convert 디렉토리로이동 cd x_convert chmod.sh 파일실행 ( 자동권한부여쉘스크립트 ) /chmod.sh 설치위치 /maxgauge/bin 디렉토리에서쉘스크립트실행시 bad interpreter 가발생하는경우에는오류!! 정상 오류발생시 1. x_convert 디렉토리로이동 2. vi trans_interpreter.sh 실행 -> OS 환경에맞는 T_INTERPRETER 설정 - ksh, bash 3. 만가능 4../trans_interpreter.sh 34
MAXGAUGE FOR MYSQL 설치 WAS 환경설정 config.sh 설치위치 /maxgauge/bin/ 으로이동 cd 설치위치 /maxgauge/bin config.sh 설정변경 vi config.sh 35
MFM 4.1_INSTALL GUIDE config.sh system.properties 설치위치 /maxgauge/conf/properties 으로이동 cd 설치위치 /maxgauge/conf/properties system.properties 설정변경 vi system.properties 36
MAXGAUGE FOR MYSQL 설치 system.properties Gather 환경설정 daemon.properties 설치위치 /maxgauge/conf/properties 으로이동 cd 설치위치 /maxgauge/conf/properties daemon.properties 설정변경 vi daemon.properties 37
MFM 4.1_INSTALL GUIDE daemon.properties Repository DB 환경설정 1. dbpool.properties 설치위치 /maxgauge/conf/properties 으로이동 cd 설치위치 /maxgauge/conf/properties dbpool.properties 설정변경 vi dbpool.properties 38
MAXGAUGE FOR MYSQL 설치 MySQL 과 MariaDB 의설정방법다르므로아래내용을참조해주시기바랍니다. dbpool.properties (MySQL 에설치시 ) mydb.url 및 mydb.password 는다음경로에서결과값을확인후입력합니다. 예 ) input String (Enter to quit) > root input String (Enter to quit) > 74e586bf3478f17f4e1. -> user / password 입력 -> 그에따른결과값출력 dbpool.properties (MariaDB 에설치시 ) 39
MFM 4.1_INSTALL GUIDE license 넣기 설치위치 /maxgauge/conf/license 로이동 cd 설치위치 /maxgauge/conf/license 해당위치에 license 파일업로드 Repository DB 생성및프로시저적용 설치위치 /maxgauge/bin/install 로이동 cd 설치위치 /maxgauge/bin/install install.sh 파일실행 ( 자동설치쉘스크립트 )./install.sh 40
MAXGAUGE FOR MYSQL 설치 정상적으로완료시마지막에 InstallDDL Result : Success 메시지표시 41
MFM 4.1_INSTALL GUIDE 프로세스시작, 종료 설치위치 /maxgauge/bin 으로이동 cd 설치위치 /maxgauge/bin 프로세스실행 ( 자동설치쉘스크립트 ) WAS 시작 :./bin/jetty.start.sh WAS 종료 :./bin/jetty.stop.sh Gather 시작 :./bin/daemon.start.sh Gather 시작 :./bin/daemon.stop.sh 전체시작 :./bin/all.start.sh 전체시작 :./bin/all.stop.sh WAS 기동 Gather 기동 42
MAXGAUGE FOR MYSQL 설치 전체기동 프로세스상태확인 설치위치 /maxgauge/bin 으로이동 cd 설치위치 /maxgauge/bin 프로세스실행 ( 자동설치쉘스크립트 ) 상태확인 :./bin/all.ps.sh 상태확인 최초 daemon 기동시서버에등록이되어있지않아서 daemon shudown 상태. 3.6 의 9) 부터동일하게설정진행 ( 해당문서의 p.21 ~ p.23 참조 ) daemon start 후상태확인 43
MFM 4.1_INSTALL GUIDE www.ex-em.com 서울강서구양천로 583, A 동 1208 호 ( 염창동, 우림비즈니스센터 ) TEL : 02 6203 6300 44