사용자매뉴얼

Agent 설치하기

SMS 에이전트

서버를 모니터링 하기 위해서는 매니저 프로그램을 설치하고 모니터링 하고자 하는 서버에 에이전트 프로그램을 설치해야 합니다.

에이전트 프로그램 설치

SMS 에이전트 프로그램은 UNIX/WINDOWS 서버에 설치 파일로 수동 설치합니다.

UNIX OS 에이전트 설치

UNIX OS 용 에이전트 프로그램을 서버에 설치하는 방법은 다음과 같습니다.

* 에이전트 프로그램은 매니저 프로그램이 설치된 서버에 함께 설치할 수 있습니다.

1UNIX OS 용 설치 파일을 서버의 설치 디렉터리로 이동 후 파일을 업로드 합니다.

2에이전트 파일의 이름 및 실행 권한을 변경하세요.

[root@RND1 ~]# cd /home/zenius/zenius7.0/bin/

[root@RND1 bin]# mv zagent-cen3-x64_109_20170425 zagent

[root@RND1 bin]# chmod 700 zagent

3에이전트를 서비스에 등록하여 부팅 시 자동으로 시작되게 설정하려면 zagent –install 을 실행하세요.

[root@RND1 bin]# zagent -install

Execute user <default:root> ?:

4자동으로 실행될 때 실행할 아이디를 입력하세요.

[root@RND1 bin]# zagent -install

Execute user <default: root=""> ?: root

INSTALL: 'zagent', Path : '/home/zenius/zenius7.0/bin', User : 'root'

Link /etc/rc.d/init.d/zagent /etc/rc.d/rc2.d/S99zagent

Link /etc/rc.d/init.d/zagent /etc/rc.d/rc3.d/S99zagent

Link /etc/rc.d/init.d/zagent /etc/rc.d/rc4.d/S99zagent

Link /etc/rc.d/init.d/zagent /etc/rc.d/rc5.d/S99zagent

Install completed

5에이전트가 접속할 매니저 IP를 입력하세요.

[root@RND1 bin]# zagent –a admin 10.0.0.13

ZENIUS_PROGRAM_PATH=/home/zenius/zenius7.0/manager

File Path: '/home/zenius/zenius7.0/bin'

Current path: '/home/zenius/zenius7.0/manager/zagent'

* 에이전트 설치를 위해서는 매니저 구동 및 운영자 아이디(admin) 생성, 라이선스 할당이 되어 있어야 합니다.

Ex) zagent –a <사용자 아이디> <매니저IP>

DBMS 에이전트

DB 관리 모니터링을 위해서는 매니저 프로그램을 설치하고 DB 서버에 에이전트 프로그램을 설치해야 합니다.

에이전트 프로그램 설치

DBMS 에이전트 프로그램은 UNIX/WINDOWS 서버에 설치 파일로 수동 설치합니다.

UNIX OS 에이전트 설치

UNIX OS 용 에이전트 프로그램을 서버에 설치하는 방법은 다음과 같습니다.

* 에이전트 프로그램은 매니저 프로그램이 설치된 서버에 함께 설치할 수 있습니다.

1UNIX OS 용 설치 파일을 서버의 설치 디렉터리로 이동 후 파일을 업로드 합니다.

2에이전트 파일의 이름 및 실행 권한을 변경하세요.

[root@QA-cent6-64 ~]# cd /usr/sbin

[root@QA-cent6-64 sbin]# mv zdba-cen3-ora11-64_1007 zdba

[root@QA-cent6-64 sbin]# chmod 700 zdba

[root@QA-cent6-64 sbin]# ls -al zdba

-rwx------ 1 root root 8058424 2017-05-24 13:15 zdba

3에이전트를 서비스에 등록하여 부팅 시 자동으로 시작되게 설정하려면 zdba –install 을 실행하세요.

[root@QA-cent6-64 sbin]# zdba -install

Hard limit is 4096

Current limit is 1024

Current limit is changed to 4096

Execute user <default: root> ?:

4자동으로 실행될 때 실행할 아이디를 입력하세요.

[root@QA-cent6-64 sbin]# zdba -install

Hard limit is 4096

Current limit is 1024

Current limit is changed to 4096

Execute user <default: root> ?: root

INSTALL: 'zdba', Path : '/usr/sbin', User : 'root'

Link /etc/rc.d/init.d/zdba /etc/rc.d/rc2.d/S99zdba

Link /etc/rc.d/init.d/zdba /etc/rc.d/rc3.d/S99zdba

Link /etc/rc.d/init.d/zdba /etc/rc.d/rc4.d/S99zdba

Link /etc/rc.d/init.d/zdba /etc/rc.d/rc5.d/S99zdba

Install completed

5에이전트가 접속할 매니저 IP 및 사용자 아이디를 입력하세요.

[root@QA-cent6-64 sbin]# zdba -a admin 10.0.0.13

Hard limit is 4096

Current limit is 1024

Current limit is changed to 4096

ZENIUS_PROGRAM_PATH=

File Path: '/usr/sbin'

Current path: '/var/zdba'

* 에이전트 설치를 위해서는 매니저 구동 및 운영자 아이디(admin) 생성, 라이선스 할당이 되어 있어야 합니다.

Ex) zdba –a <사용자 아이디> <매니저IP>

6에이전트가 수집할 DB 접속 정보를 입력하세요.

[root@QA-cent6-64 sbin]# zdba -c ora11 zenius zenius123

Hard limit is 4096

Current limit is 1024

Current limit is changed to 4096

ZENIUS_PROGRAM_PATH=

File Path: '/usr/sbin'

Current path: '/var/zdba'

Ex) # zdba –c <DB TNS> <DB사용자> <DB 비밀번호>

APM 에이전트

응용 프로그램을 모니터링 하기 위해서는 매니저 프로그램을 설치하고 모니터링 하고자 하는 대상 WAS (혹은 보다 일반적으로 임의의 Java 응용 프로그램) 시작 시에 에이전트를 포함하여 실행하도록 설정해야 합니다.

에이전트 프로그램 설치

에이전트 프로그램을 서버에 설치하는 방법은 다음과 같습니다.

* APM 에이전트는 설치 완료 후 WAS 재기동시 APM 매니저를 통해서 자동으로 모니터링 대상으로 등록됩니다.
따라서 에이전트 설치 전 APM 매니저를 먼저 설치하여 매니저가 정상 기동되어 있고 할당된 라이선스 잔여분이 충분한 상태에서 에이전트를 설치해 주십시오.

1WAS 기동 시의 사용자 계정으로 서버에 접속하세요.

2제공되는 99-for_agent 폴더 전체를 설치 대상 서버로 복사 합니다.
압축파일로 제공된 경우 압축 해제 과정이 필요 할 수 있습니다.

3복사된 폴더로 이동하여 설치 프로그램을 실행 합니다.

[zenius@apmdev ~]$ cd ./99-for_agent

[zenius@apmdev 99-for_agent]$ sh ./install.sh

4설치 프로그램의 안내에 따라 필요한 설치 정보를 입력 합니다.
아무것도 입력하지 않는 경우 출력된 기본 값이 자동 입력 됩니다. 아래 예제를 참고해 주십시오.

> RUN_JAVA=java

- Agent installer for Zenius APM -

Enter installation path (default: /home/zenius/99-for_agent)

:/home/zenius/apmagent

The directory does not exist. make it? (default: yes)

:y

[/home/zenius/apmagent]

Enter configuration path (default: /home/zenius/apmagent)

:/home/zenius/apmagent

[/home/zenius/apmagent]

Enter manager ip (default: 127.0.0.1)

:10.0.2.15

[10.0.2.15]

Enter manager port (default: 8081)

:8081

[8081]

Enter agent ip

:10.0.2.1

[10.0.2.1]

Enter host number (default: 0)

:

[0]

Enter WAS port

:8080

[8080]

Enter agent registration account. must be an administrator (default: admin)

:

[admin]

Protocol Version : 1209

5요약된 입력 값을 다시 한번 확인한 후 문제가 없는 경우 설치를 계속 진행 합니다.

Install Path     [/home/zenius/apmagent]

config Path     [/home/zenius/apmagent]

Manager IP     [10.0.2.15]

Manager Port   [8081]

Agent IP       [10.0.2.1]

HostNumber    [0]

Reg Account    [admin]

WAS Port      [8080]

Protocol Version [1209]

Do you want to install it with the information entered? (default: yes)

:yes

6설치가 진행 정상 적으로 진행 되고 WAS와 연동에 필요한 JVM 옵션이 표시 됩니다.

0%                                               50%                                                100%

[====|====|====|====|====|====|====|====|====|=====]

Installation completed. Please add the following options.

        -javaagent:/home/zenius/apmagent/sujiboot.jar

Installation completed. Succeed

7추가 설치가 필요한 경우 [yes]를 입력하여 동일한 설치 과정을 진행 합니다.
추가 설치가 필요하지 않은 경우 [no]를 입력하여 설치 프로그램을 종료 합니다.

Do you want to continue with the other installation? (default: no)

:no

Exit the installation.

87번에서 확인된 JVM 옵션을 기존 WAS 기동 옵션에 추가 합니다.
옵션 추가 방법은 WAS 제품 별로 각각 다를 수 있으므로 해당 제품의 매뉴얼을 참고하여 주십시오.

다음은 주요 WAS별 JVM 옵션 예시 입니다.

[ Tomcat ]

${TOMCAT_HOME}/bin/catalina.sh

JAVA_OPTS="$JAVA_OPTS -javaagent:/home/zenius/apmagent/sujiboot.jar"

[ WebLogic ]

${DOMAIN_HOME}/bin/startWebLogic.sh

JAVA_OPTIONS="$JAVA_OPTIONS -javaagent:/home/zenius/apmagent/sujiboot.jar"

[WebSphere 7.x]

<jvmentries xmi:id="JavaVirtualMachine_1183122130078" verbosemodeclass="false" verbosemodegarbagecollection="true" verbosemodejni="false" runhprof="false" hprofarguments="" debugmode="false" debugargs="-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=7777" genericJvmArguments="-javaagent: /home/zenius/apmagent/sujiboot.jar" executableJarFileName="" disableJIT="false">

[JEUS 7.x]

* Management Console 사용

${JEUS_HOME}/domains/jeus_domain/config/domain.xml

<jvm-config>

<jvm-option>-Xmx1024m -XX:MaxPermSize=256m -javaagent: /home/zenius/apmagent/sujiboot.jar<jvm-option>

</jvm-config>

9WAS를 다시 시작합니다.
WAS 기동 후에 Zenius Web UI를 통하여 자동 등록된 에이전트의 정보를 확인하고 수정할 수 있습니다.
자세한 방법은 에이전트 설정을 참고하여 주십시오.