로그프레소 센트리 자동 설치 가이드(OS : Linux)

How To
1

본 문서는 로그프레소 센트리(OS : Linux) 원활한 자동 설치를 지원하기 위해 제작되었습니다.

내용 중 수정이 필요한 부분이나 추가 의견이 있으시면 언제든 피드백 부탁드립니다.

개요

  • 본 가이드는 단일 분석 서버 환경을 기준으로 작성되었습니다.

  • HP-UX, Solaris, AIX 환경은 자동 설치를 지원하지 않으므로 별도의 수동 설치 절차가 필요합니다.

  • Linux 필수 유틸리티: ifconfig, netstat, unzip, wget, tar, gunzip

  • /opt/logpresso-sentry 해당경로에 자동설치됩니다.

  • 설치 시 에이전트는 /opt/logpresso-sentry 경로에 자동으로 구성됩니다.

  • 셸 접속이 필요한 경우, logpresso.conf 설정 파일을 수정하여 포트를 활성화한 후 서비스를 재기동하시기 바랍니다.

사전 준비

  • 센트리 에이전트의 원활한 자동 설치 및 런타임 환경 구성을 위해, 로그프레소 서버 내 특정 경로에 JDK 파일을 사전 업로드 필요

  • JDK 업로드

    • 로그프레소 서버 설치 경로 내 download 디렉토리에 JDK 파일 업로드

      • 경로 : <패키지경로>/download/linux/x64/

    • 디렉토리 구조 (Tree 형식 참고)

      • 업로드 후의 파일 배치는 아래와 같은 구조를 유지 필요
    [root@CONTROL1-A download]# pwd
/opt/logpresso/download

[root@CONTROL1-A download]# tree
└── linux
    └── x64
        └── jre-11.0.21_9-linux-x64-signed.tar.gz

  • 패키지 및 디지털 서명 준비

    • [로그프레소 스토어]에 접속하여 대상 운영체제(Linux)에 맞는 에이전트 설치 파일 다운로드 진행

    • 패키지의 무결성 검증을 위해 스토어 화면에 표시된 디지털 서명(Signature) 값을 사전에 복사

    • [시스템] → [패키지] → [업로드] 버튼 클릭

센트리 설치 및 기동(Linux)

  1. 메뉴 진입

    • 경로: SNR UI → 시스템 → 센트리 메뉴로 이동 후 [추가] 버튼을 클릭

  2. 센트리 설정 항목 (Option)

    • 운영체제 : 리눅스

    • 센트리ID : 센트리를 식별하기 위한 고유 ID를 입력합니다. (관리 편의를 위해 서버의 hostname 사용을 권장)

    • 접속 서버 : 센트리가 연동될 서버를 선택 (본 가이드는 단일 분석 노드 기준이므로 [분석] control을 선택)

    • 인증 토큰 : 자동 생성

  3. 설치 명령어 확인

    wget --no-check-certificate -q -O install.sh "<https://100.100.100.100:44300/deploy/installer/sentry-linux?guid=linux-sentry&token=1234-abcd&base=100.100.100.100>" && chmod +x install.sh && ./install.sh

  4. 대상 서버 접속 후 센트리 설치 명령어 실행

    • 설치 과정 중 시스템 내에 logpresso 계정과 그룹이 자동으로 생성

    • 생성된 logpresso 계정은 systemctl 서비스 유닛으로 등록되며, 향후 로그프레소 서비스는 해당 계정의 권한으로 기동 및 운영

    # wget --no-check-certificate -q -O install.sh "<https://100.100.100.100:44300/deploy/installer/sentry-linux?guid=linux-sentry&token=1234-abcd&base=100.100.100.100>" && chmod +x install.sh && ./install.sh
Using username: logpresso, group: logpresso
Pre-checking for Logpresso Sentry Installation succeeded.
Creating /opt/logpresso-sentry, user "logpresso" and group "logpresso"...
Downloading Java Runtime Environment...done
Downloading Logpresso Linux Sentry...done
Extracting Java Runtime Environment...done
Extracting Logpresso Linux Sentry...done
Installing Logpresso Sentry...
configuration file is created: /opt/logpresso-sentry/etc/logpresso.conf
creating log directory...
Installed CA certificate to /opt/logpresso-sentry/data/logpresso-sentry/ca.jks
Installed sentry certificate to /opt/logpresso-sentry/data/logpresso-sentry/sentry.pfx
done
Installing /usr/lib/systemd/system/logpresso-sentry.service... done
Starting daemon...
Created symlink /etc/systemd/system/multi-user.target.wants/logpresso-sentry.service → /usr/lib/systemd/system/logpresso-sentry.service.
done
Installation completed in /opt/logpresso-sentry.

  5. 센트리 상태 확인

    # systemctl status logpresso-sentry
● logpresso-sentry.service - Logpresso Sentry
     Loaded: loaded (/usr/lib/systemd/system/logpresso-sentry.service; enabled; preset: disabled)
     Active: active (running) since Wed 2026-04-22 17:01:23 KST; 4min 44s ago
       Docs: <https://ko.logpresso.com/documents>
    Process: 316705 ExecStart=/bin/sh /opt/logpresso-sentry/logpresso start (code=exited, status=0/SUCCESS)
   Main PID: 316749 (java)
      Tasks: 40 (limit: 23111)
     Memory: 319.6M
        CPU: 27.161s
     CGroup: /system.slice/logpresso-sentry.service
             └─316749 /opt/logpresso-sentry/jre/bin/java -Xms128M -Xmx384M -XX:MaxDirectMemorySize=128M -XX:-OmitStackTraceInFastThrow -XX:-UseCompressedOops -XX:+UnlockExperimentalVMOptions -XX:+UseG1GC -XX:G1ConcRefinementThreads=12 -XX:G1MixedGCLiveThresholdPerc>

Apr 22 17:01:21 COLLECT2-A systemd[1]: Starting Logpresso Sentry...
Apr 22 17:01:22 COLLECT2-A sh[316705]: Logpresso Launcher 1.2.0
Apr 22 17:01:22 COLLECT2-A sh[316705]: starting Logpresso...
Apr 22 17:01:23 COLLECT2-A systemd[1]: logpresso-sentry.service: Can't open PID file /run/logpresso/logpresso-sentry.pid (yet?) after start: Operation not permitted
Apr 22 17:01:23 COLLECT2-A systemd[1]: Started Logpresso Sentry.

  6. 센트리 중지

    # systemctl stop logpresso-sentry

  7. 센트리 기동

    # systemctl start logpresso-sentry

  8. 센트리 기동 계정 변경 필요 시

    • logpresso가 아닌 다른 계정으로 logpresso 기동 필요 시, /usr/lib/systemd/system/logpresso-sentry.service 의 파일 수정 필요

    • [Service]의 User와 Group를 수정 후, 센트리 서비스 재기동 진행

    [Unit]
Description=Logpresso Sentry
After=multi-user.target network.target
ConditionPathExists=/opt/logpresso-sentry/etc/logpresso.conf
Documentation=https://ko.logpresso.com/documents

[Service]
User=logpresso
Group=logpresso
Type=forking
PIDFile=/var/run/logpresso/logpresso-sentry.pid
Environment=PKGDIR=/opt/logpresso-sentry
ExecStart=/bin/sh /opt/logpresso-sentry/logpresso start
ExecStop=/bin/sh /opt/logpresso-sentry/logpresso stop
TimeoutStopSec=1200
LimitNOFILE=65535
Restart=on-failure
RuntimeDirectory=logpresso

[Install]
WantedBy=multi-user.target

센트리 삭제(Linux)

  1. 센트리 중지

    • 삭제 전 센트리 서비스는 stop 상태여야 함
    # systemctl stop logpresso-sentry

  2. 설치된 디렉토리로 이동

    # cd /opt/logpresso-sentry

  3. logpresso 런처를 통해 uninstall 진행

    • 삭제가 완료되고 나면 해당 디렉토리에 파일이 존재하지 않음
    # ./logpresso uninstall sentry

  4. 폴더 정리

    # rm -rf /opt/logpresso-sentry