싸권's IT Story

오픈소스 APM Scouter 설치 #2

싸권 2021. 1. 14. 11:27

Scouter 설치 두번째입니다.

 

Windows Server와 CenOS에 Scouter Server를 설치하는 부분입니다.

Scouter Server 설치를 위해 다운로드 해야할 파일들이 있습니다.

 

1. Windows용 JAVA(Java Runtime Edition)

https://www.java.com/ko/download/

 

Download Java for Linux

사용자 컴퓨터용 Java 소프트웨어 또는 Java Runtime Environment는 Java Runtime, Runtime Environment, Runtime, JRE, Java Virtual Machine, Virtual Machine, Java VM, JVM, VM, Java 플러그인, Java 추가 기능 또는 Java 다운로드라고도

www.java.com

CentOS에서는 yum 명령어를 통해 설치가 가능합니다.

(사실 이 글을 보시는 분이라면 기본적으로 이런 내용들을 다 아실거 같네요)

 

2. Scouter 파일

https://github.com/scouter-project/scouter/releases/tag/v2.10.2

 

Release v2.10.2 · scouter-project/scouter

Features [agent.java] fix some webflux filter is separated from controller in xlogs. more enhancement of reactor checkpoint profiling. anonymous class hook option added Bug Fix [agent.java] fix ...

github.com

해당 페이지에서 제가 구성할때 필요한 파일들은 세개입니다.

scouter-all-2.10.2.tar.gz  - Scouter 구성을 위한 Agent와 Server 구성 파일

scouter.client.product-win32.win32.x86.zip - Windows 용 Scouter Client(32bit용)

scouter.client.product-win32.win32.x86_64.zip - Windows 용 Scouter Client(64bit용)

 

Client는 사용할 PC의 Java bit에 따라 구분하셔야합니다.

전 64bit Java 설치를 해서 64bit용이 필요합니다.

 

Windows Server내 Scouter Server 설치

1. JRE 설치

   다운받은 JRE 설치 파일을 Server에 설치합니다.

 

2. Scouter Server 복사

   다운받은 Scouter 파일에서 Server 폴더를 Windows Server 드라이브로 복사합니다.

 

3. Scouter Server conf 파일 수정

   \server\conf 폴더내 scouter.conf 파일을 현재 구성에 맞도록 수정합니다.

 

# Agent Control and Service Port(Default : TCP 6100)
net_tcp_listen_port=6100

# UDP Receive Port(Default : 6100)
net_udp_listen_port=6100

# DB directory(Default : ./database)
db_dir=./database

# Log directory(Default : ./logs)
log_dir=./logs

#Server ID
server_id=WinSvr

 

  내용은 간단한데, 전 Windows는 6100 port를 이용하고, CentOS는 6200 port를 이용해서 서버를 구성할 생각입니다.

  scouter.conf 파일을 윈도우즈 메모장에서는 편집이 불가합니다.

  워드패드나 많이 사용하시는 Notepad++를 이용하시면 됩니다.

 

4. Scouter 서버 실행 

   \server\bin\startup.bat 파일 실행

 

  위와 같이 화면이 나타나면 Scouter Server가 실행된 것입니다.

  (기본적으로는 commad 창에서 실행이 되는데, bat 파일을 서비스로 등록하는 방법이 있긴 합니다)

  

5. Client 접속 확인

   Scouter Clinet에서 해당 서버로 접속이 가능해야 정상적으로 실행이 된 것입니다.

   아직 Agent가 설치가 안되었기에 접속만 가능하고 모니터링이 가능한 건 없겠죠.

   다운받은 Client 압축을 풀고 폴더내 scouer.exe파일을 수행합니다.

 

   첫 실행을 하면 나타나면 화면입니다.

   만약 Java bit가 맞지 않으면 에러가 날 수 있으니, Java bit에 맞는 Client를 수행시켜주셔야 합니다.

 

 

   Scouter Server를 실행한 서버의 IP와 Port를 입력해줍니다.

   위에서 전 6100 port로 구성했으니 포트를 6100으로 입력했습니다.

   ID와 Password는 초기에는 모두 admin으로 되어 있습니다.

   접속 후 패스워드는 변경할 수 있습니다.

   이때 제대로 입력했는데도 네트워크 에러가 발생하면 Windows Server의 방화벽을 해제하시거나 해당 포트를 허용해주시면 됩니다.

 

 

   정상적으로 Sever에 접속한 화면입니다.

   Object에 WinSvr이 있습니다. 

   Scouter Server 구성시 conf 파일이 입력했던 내용이 보이는 것입니다.

   이제 정상적으로 Windows Server내 Scouter Server는 구성되었습니다.

   

CentOS내 Scouter Server 설치

1. Java 설치

   #yum install java-18.0

   위 명령어로 java를 설치해줍니다. 

   설치 후 java -version 명령어로 설치된 걸 확인합니다.

 

   위와 같이 버전과 상세사항이 나타나면 제대로 설치가 된 것입니다.

 

2. Scouter Server 복사

   Windows Server에서와 마찬가지로 Server 폴더만 업로드해줍니다.

   로컬PC에서 업로드시 파일질라등의 sftp 클라이언트를 이용하시면 되는데, 업로드 후 permission과 owner 등은 꼭 확인해서 필요시 수정해주시면 됩니다. 특히 *.sh 파일들은 permission을 755로 수정해야합니다.

 

3. Scouter Server conf 파일 수정

   마찬가지로   /server/conf 폴더내 scouter.conf 파일을 현재 구성에 맞도록 수정합니다.

# Agent Control and Service Port(Default : TCP 6100)
net_tcp_listen_port=6200

# UDP Receive Port(Default : 6100)
net_udp_listen_port=6200

# DB directory(Default : ./database)
db_dir=./database

# Log directory(Default : ./logs)
log_dir=./logs

#Server ID
server_id=Centos

   Windows Server와 구분을 위해 포트를 6200으로 설정했습니다.

 

4. Scouter 서버 실행 

   /server/startup.sh를 실행하면 서버가 동작합니다.

#cd /scouter/server  <- 해당 디렉토리 이동
#./startup.sh

   부팅시 자동적으로 수행하길 원하면 /etc/rc.d/rc.local 파일내 해당 command를 추가해주시면 됩니다.

   마찬가지로 CentOS에서도 방화벽을 해제하시거나 해당 포트는 열어두시면 됩니다.

 

#systemctl stop firewalld       <-- 방화벽 데몬 중단
#systemctl disable firewalld    <-- 방화벽 서비스 삭제(부팅시 동작 안함)

또는
#firewall-cmd --zone=public --permanent --add-port=6200/tcp  <-- 6200포트 방화벽 허용 추가
#firewall-cmd --reload  <-- 방화벽 재수행

 

5. Client 접속 확인

   Windows Server에 접속되어 있는 Client에 CentOS를 추가하도록 하겠습니다.

   그렇게 관리를 해야 하나의 Client에서 여러개의 서버를 관리하기가 편합니다.

 

 

   Objects에서 컴퓨터 모양의 아이콘을 누르면 Server List가 나오는데, 해당 메뉴에서 Add 메뉴를 눌러서 서버를 추가합니다. CentOS의 IP와 지정했던 6200 포트를 지정해줍니다. 

   그렇게 등록을 하면 Objects에는 그냥 IP만 표시가 되는데 아직 서버가 연결이 되지 않아서입니다.

   해당 서버 리스트에서 오른쪽 마우스를 눌러 "Open Sever" 메뉴를 클리하면 로그인 화면이 나타납니다.

 

   

   Open Server를 눌러서 나온 로그인 창에 ID admin, Password admin을 입력합니다.

 

    제대로 입력되어 로그인이 되면 위와 같이 conf 파일에 지정했던 CentOS가 나타납니다.

 

 

여기까지 정상적으로 되었다면 Windows와 CentOS에 Scouter 서버가 제대로 실행된 것입니다.

다음은 Windows와 CentOS에 Agent 설치를 진행하도록 하겠습니다.