OnTune Agent 설치하기 - OnTune Manager Version 3.1.6-2010-06-21 TeemStone 순서 1. Installer 를이용한 agent 설치하기 2. Windows 서버에 agent 설치하기 3. 파일에대한설명 4. 시스템재부팅시자동실행되도록설정하기 5. 직접설치하기 6. 직접실행하기 7.. Agent 종료하기 8.. Agent 제거하기 Page 1 / 13
* Installer 는 telnet, ftp 가가능한서버에 Agent 를설치할때사용합니다. ssh, sftp 등의환경일경우 [5. 직접설치하기 ] 항목을참고하시기바랍니다. Installer 는아래의링크를통해 download 받으실수있습니다. http://www.ontune.co.kr/product/v3install/installer.zip 1. Installer 를이용한 agent 설치하기아래와같이 Installer 를실행 (OnTuneV3 설치경로의 Agent 폴더아래에위치 ) 합니다. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 1. Start 버튼 : 자동설치를실행합니다. 2. Stop 버튼 : 자동설치를진행하고있을경우중간에종료합니다. 3. Agent Directory : 관리대상서버에설치될 Agent 의경로를지정합니다. 4. Manager IP Address : OnTuneV3 Manager 가설치된 NT 서버의 IP 주소를지정합니다. 5. Manager Port : OnTuneV3 Manager 의통신포트를지정합니다.(Default : 18893) 6. Auto Start After boot : Agent 를설치할때관리대상서버가재부팅될경우 agent 가자동으로실행되도록구성설정을적용합니다. (AIX 의경우 mkitab 을이용한 inittab 설정, HP-UX 의경우 init.d 설정, SUN 의경우 rc2.d 설정 ) 7. Prompt String : Telnet session 에서 prompt 인식이잘안될경우이항목을통해추가적으로지정이가능합니다. 8. Timeout(Sec.) : Telnet session 에서응답을기다리는 timeout 값입니다. Page 2 / 13
9. Add : Agent 를설치할관리대상서버를추가합니다. 1 2 3 4 5 6 7 8 1) IP Address : Agent 를설치할관리대상서버의 IP 주소를입력합니다. 2) root s Password : root 의 password 를입력합니다. 3) Telnet Port : 설치시 Telnet 접속을위해사용할 Port 번호를입력합니다. 4) ftp Port : 설치시 ftp 접속을위해사용할 Port 번호를입력합니다. 5) Telnet by Normal User : root 로 Telnet 접속이안될경우이체크박스를체크한후 Normal User(7 번항목 ) 와 Normal User s Password(8 번항목 ) 를입력합니다. 6) ftp by Normal User : root 로 ftp 가안될경우이체크박스를체크합니다. Telnet by Normal User 가체크되어있을경우에만사용가능한옵션입니다. 7) Normal User : 5 번항목에서기술한바와같이 root 로 Telnet 접속이안될경우 5 번항목을체크한후 Telnet 접속에사용할 Normal User 를입력합니다. 8) Normal User s Password : 7 번항목에입력한 Normal user 의 password 를입력합니다. *) ) IBM 의 VIO 서버의경우에는 root 의비밀번호에 aix_vioserver 라고입력하시면자동으로 VIO 서버에맞춰서설치를진행합니다. Page 3 / 13
10. Add List : 여러서버를동시에입력할때사용합니다. 공란 (Space) 이나콤마 (, ) 를구분자로 IP 주소, root 비밀번호, Telnet 포트와 ftp 포트를입력합니다. 만약 root 로 Telnet 접속이안될경우 Normal User 명과해당비밀번호도추가로입력하시면됩니다. Root 로접속이가능할경우입력하실필요가없습니다. ftp 도 Normal User 로해야할경우제일마지막에 1 이라고명시해줍니다. 위의 field 에맞게엑셀의내용을 copy & paste 하셔도됩니다. 이경우자동으로구분자를엑셀의구분자 (Tab 문자 ) 로인식합니다. 예 ) root 로 telnet 과 ftp 가가능한경우 : 192.168.0.3,rootpasswd,23,21 예 ) root 로 telnet 과 ftp 가안되어서 abcuser 를이용해야하는경우 : 192.168.0.3 rootpasswd 23 21 abcuser abcpasswd 1 *) IBM 의 VIO 서버의경우에는 root 의비밀번호에 aix_vioserver 라고입력하시면자동으로 VIO 서버에맞춰서설치를진행합니다. Page 4 / 13
- 엑셀에서 copy 하여아래와같이 paste 합니다. 위와같은상태에서 OK 를누르시면서버리스트입력이완료됩니다. 11. Edit : 입력된서버의정보를수정할때사용합니다. 12. Delete : 입력된서버의정보를삭제할때사용합니다. 13. Clear OK List : Agent 설치가정상으로완료된항목들만삭제해줍니다. 14. Telnet Log : Telnet Session 이진행될때의기록입니다. 15. Install Log : Installation 이진행될때의전체적인진행기록입니다. Page 5 / 13
2. Windows 서버에 agent 설치하기 - Installer 를이용한자동설치가안됩니다. - Windows 서버에필요한파일은아래의파일들입니다. 1) AgentConfig.exe => agent 의설정및서비스등록, 시작, 종료의기능을수행합니다. 2) WinAgentV3.exe => Windows 의서비스로동록되어 agent 기능을수행합니다. 3) WinAgentV3Updater.exe => Manager 에서 Windows 용 Agent 를 Update 할때사용되는프로그램으로내부적으로실행되기때문에별도의실행은필요없습니다. AgentConfig.exe 를실행하면아래와같은트레이아이콘을확인할수있습니다. * 중요 ) Windows Vista, Windows 7 의경우관리자권한으로실행하여야합니다. 위의빨간상자안의트레이아이콘에서마우스를우클릭하여아래와같은 Popup menu 를이용하실수있습니다. Page 6 / 13
- Config 1 2 3 4 1. Windows Service : 체크하시면 Windows 서비스로등록되어시스템재부팅시자동으로 agent 가실행됩니다.( Agent 를수행하기위해선이항목이반드시체크되어야정상수행됩니다.) Agent 를정지시킬때 Windows Service 항목을해제하여정지시킨경우서버가재부팅되어도자동으로 Agent 가실행되지않습니다. Agent 를정지시킬때 Windows Service 항목을해제하지않고트레이아이콘의 Stop Agent 만선택된경우서버가재부팅되면자동으로 Agent 가다시실행됩니다. 2. Server Setting Address : OnTuneV3 Manager 의 IP 주소를입력합니다. 3. Server Setting Port : OnTuneV3 Manager 의 Port 번호를입력합니다.( 기본값은 18893 입니다.) 4. Windows Event Alarm : 선택된이벤트는발생될때마다 OnTuneV3 Manager 로이벤트가전송되어알람및 SMS 연동이가능합니다. - Start Agent : agent 를구동시킵니다. Config 에서 Windows Service 항목이체크된상태에서 apply 버튼을누르면자동으로 start 됩니다. - Stop Agent : agent 를종료시킵니다. Config 에서 Windows Service 항목이체크해제된상태에서 apply 버튼을누르면자동으로 stop 됩니다. 서비스등록되었을경우재부팅하면종료와상관없이자동실행됩니다. - Exit : AgentConfig 프로그램이종료됩니다. Agent 서비스는종료되지않습니다. 단순히트레이아이콘에서보이는 config 프로그램만종료됩니다. Page 7 / 13
3. Unix 서버에서의 Agent 와관련된파일에대한설명 1. TAgentV3 - OnTuneV3 의 agent 로통신및성능관련정보수집합니다. 2. agent.conf - Manager 관련설정정보저장 (IP 주소및포트 (18893), errpt 로그위치 ) 3. ontune_run.sh - TAgentV3 를구동시키는 script - 실행방법 : nohup ontune_run.sh [TAgentV3 가위치된절대경로 ] >/dev/null 2>&1 & - 예 : nohup./ontune_run.sh /usr/ontune/ >/dev/null 2>&1 & 4. errptcheck.sh - H/W errpt 감시및로그저장 script(aix 용 ) - 실행방법 : errptcheck.sh [TAgentV3 가위치된절대경로로마지막에 '/' 포함시켜야합니다.] - 예 :./errptcheck.sh /usr/ontune/ Page 8 / 13
4. 시스템재부팅시자동실행되도록설정하기 (Installer 를이용할경우자동으로설정됩니다.) - AIX 의경우 mkitab 을이용하여등록합니다. # mkitab "ontune_run:2:once:[ 설치된경로 ]/ontune_run.sh [ 설치된경로 ] >/dev/null 2>&1" # mkitab "ontune_errpt:2:once:[ 설치된경로 ]/errptcheck.sh ['/' 로끝나는설치된경로 ] >/dev/null 2>&1" - SUN 의경우 /etc/rc2.d/ 아래에 S99ontune 파일을작성하여아래의내용을넣어두시면됩니다.( 실행권한도주셔야합니다.) # cat S99ontune nohup [ 설치된경로 ]/ontune_run.sh [ 설치된경로 ] >/dev/null 2>&1 & - HP-UX 의경우 rc 에등록하는절차에따라설정하셔야합니다. 예제 ) #cat /etc/s99ontune nohup [ 설치된경로 ]/ontune_run.sh [ 설치된경로 ] >/dev/null 2>&1 & 1. #cd /etc/rc.config.d #cat S99ontune S99ontune=1 #chmod 700 /etc/rc.config.d/s99ontune case $1 in 'start_msg') 2. #cd /sbin/init.d #cp template S99ontune #chmod 700 S99ontune #vi S99ontune # Emit a _short_ message relating to running this script with # the "start" argument; this message appears as part of the checklist. echo "Starting the OnTune" ;; 'stop_msg') 'start') # Emit a _short_ message relating to running this script with # the "stop" argument; this message appears as part of the checklist. echo "Stopping the OnTune ;; # source the system configuration variables if [ -f /etc/rc.config.d/s99ontune ] ; then else fi. /etc/rc.config.d/s99ontune echo "ERROR: /etc/rc.config.d/s99ontune defaults file MISSING" # Check to see if this script is allowed to run... Page 9 / 13
if [ "$S99ontune"!= 1 ]; then rval=2 else # Execute the commands to start your subsystem /etc/s99ontune fi ;; 'stop') # source the system configuration variables if [ -f /etc/rc.config.d/s99ontune ] ; then. /etc/rc.config.d/s99ontune else echo "ERROR: /etc/rc.config.d/s99ontune defaults file MISSING" fi # Check to see if this script is allowed to run... if [ "$S99ontune"!= 1 ]; then rval=2 else # Execute the commands to stop your subsystem fi ;; *) echo "usage: $0 {start stop start_msg stop_msg}" rval=1 ;; esac exit $rval 3. #cd /sbin/rc2.d #ln -s /sbin/init.d/s99ontune S99ontune Page 10 / 13
5. 직접설치하기 telnet, ftp를이용할수없고, ssh와 sftp만이용가능한환경에서는필요한파일을직접 sftp로전송하신후간단한절차를통해설치가가능합니다. 혹은 Installer로설치가원할하게진행되지않을경우아래와같이직접설치하셔야합니다. 이경우 ftp로아래설치파일들을전송하시면됩니다. 필요한파일설치에사용되는스크립트 : Installer\Files 폴더아래의 setup.org TAgentV3 파일 : Installer\Files 폴더아래의 TAgentV3_OS_ 버전형식으로된파일 TAgentV3를실행시켜주는스크립트 : Installer\Files 폴더아래의 ontune_run 파일 1. setup.org파일을 Notepad 프로그램등을이용하여수정합니다. - 수정하는항목은아래와같이 setup.org 파일의처음부분입니다. export _path=/usr/ontune OnTune Agent 설치경로입니다. export _reboot=1 시스템이재부팅될때자동으로 Agent가실행되는옵션입니다. export _ip=124.56.139.134 OnTune manager 서버의 IP 주소입니다. export _port=18893 OnTune manager의포트번호입니다. 2. 위세개의파일을 sftp로 OnTune agent를설치할경로로전송합니다. - [TAgentV3_OS_ 버전 ] 파일은 TAgentV3 로이름을변경하여야합니다.( 대소문자구분에주의하셔야합니다.) - setup.org와 ontune_run 파일은 ascii 모드로, TAgentV3는 binary 모드로 upload 시켜야합니다. 3. chmod 700./setup.org 명령어를이용하여 setup.org 에실행권한을부여합니다. 4../setup.org 를실행합니다. 5. ps ef egrep ontune TAgentV3 명령어를이용하여프로세스실행상태를확인합니다. Page 11 / 13
6. 직접실행하기 - root 권한으로아래와같이실행합니다. # nohup [ 설치경로 ]/ontune_run.sh [ 설치경로 ] >/dev/null 2>&1 & 예제 ) 설치경로가 /usr/ontune일경우 # nohup /usr/ontune/ontune_run.sh /usr/ontune >/dev/null 2>&1 & 7. Agent 종료하기 - ps ef grep TAgentV3 를이용하여 TAgentV3 의 PID 와 PPID 를 kill 명령어로종료시킵니다. (PPID 는 ontune_run.sh 가됩니다.) 8. Agent 완전히제거하기 1. ps ef grep TAgentV3 를이용하여 TAgentV3의 PID와 PPID를 kill 명령어로종료시킵니다. 2. 아래와같이각 OS 별로재부팅시실행되는설정을제거합니다. ( 아래설정을제거하지않고 ontune의 directory만변경해두셔도됩니다.) AIX rmitab ontune_run; rmitab ontune_errpt 명령을이용하여 inittab에등록된설정을제거합니다. SUN rm f /etc/rc2.d/s99ontune 명령을이용하여 rc2.d에등록된스크립트를제거합니다. HP rm -f /sbin/init.d/s99ontune; rm -f /etc/s99ontune; rm -f /etc/rc.config.d/s99ontune; rm -f /sbin/rc2.d/s99ontune 명령을이용하여등록된스크립트와설정파일을제거합니다. 제거후시스템재부팅은필요없습니다. Page 12 / 13
제조사정보회사 : TeemStone 주소 : 서울강남구도곡동우성캐릭터199 404호대표자 : 이범식전화번호 : 02-2057-7393 Page 13 / 13