본문으로 건너뛰기

Manager Agent 설치

1. 모듈 설명​

exemONE Manager Agent(exem-manager-agent)는 호스트, DB, NDM 에이전트 등 다른 엑셈원 에이전트들을 관리하고 모니터링하는 역할을 수행합니다. Manager Agent는 관리 대상 에이전트들과의 호환성을 지원하는 버전이어야 하며, 각 관리할 에이전트들의 ID가 작성된 파일이 정상적으로 존재해야 합니다. 또한, Manager Agent가 설치되는 서버에서 관리하는 대상 에이전트들 중 가장 높은 권한이 있는 계정 기준으로 설치해야 합니다.

2. 지원 환경​

항목내용
OSLinux kernel 2.6 이상
AIX 5.3 ~ 7.1
(5.3 은 32bit 지원 · 7.1 은 64bit 만)
HP-UX 11.23 ~ 11.31
Solaris 5.10 이상
Windows XP / Server 2003 SP1 이상
Arch64bit
32bit
(Linux · AIX 5.3 만 — AIX 7.1 은 64bit 만)
ProtocolTCP 9010 → Receiver
Targetexem-host-agent
exem-db-agent
exem-cloud-agent
exem-ndm-agent
exem-webserver-agent
(v3.0.21+)

3. 사전 설정​

Manager Agent를 설치하기 전에 다음 사항을 확인하고 준비해야 합니다.

  • Manager Agent가 사용할 포트를 사전에 개방해야 합니다.
  • 관리할 에이전트들이 Manager Agent와 호환을 지원하는 버전인지 확인해야 합니다.
  • 각 관리할 에이전트들의 ID가 작성된 파일이 정상적으로 존재해야 합니다.
  • 설치 파일(setup_exem-manager-agent_{version}.bin 또는 setup_exem-manager-agent_{version}.exe)을 준비합니다.

4. 설치 방법​

4-1. Linux 및 Unix 환경 설치​

설치 진행 중 데이터 입력 시, 입력 문구 마지막 대괄호 안쪽이 기본값으로 적용됩니다. 아무것도 입력하지 않으면 대괄호 내부 값이 사용됩니다. Manager Agent와 다른 에이전트들의 포트가 겹치지 않도록 주의하세요.

  1. setup 파일 실행: 준비된 setup_exem-manager-agent_{version}.bin 파일을 실행합니다.

  1. 설치 옵션 설정: [ install(patch) ]를 선택한 후, 다음 환경 변수를 설정합니다.
    • MGR_EXEM_HOME: 엑셈원 에이전트들을 설치할 디렉토리를 설정합니다. (필수, 기본값: setup 파일 실행 위치에 exem 폴더 추가)
    • MGR_RECEIVER_IP: Manager Agent와 연결할 Receiver의 IP를 입력합니다. (필수, 기본값 없음)
    • MGR_RECEIVER_PORT: Manager Agent와 연결할 Receiver의 PORT를 입력합니다. (필수, 기본값: 9010)

clipboard

  1. 설치 완료: 옵션을 전부 입력하면 설정 확인 후 설치가 완료됩니다.

  1. Agent 연결 Key 파일 작성: Manager Agent가 관리하는 에이전트 연결을 위해 agent_config.json (v3.0.9 이상) 또는 agent_key_info.json (v3.0.1 ~ 3.0.8) 파일을 작성합니다.

4-2. Linux 및 Unix 환경 간편 설치 (v3.0.21 이상)​

설치 방법 ① 패키지 파일이 설치 대상 HOST 서버에 있는 경우

  1. install config 파일 준비: INSTALL_PATH, RECEIVER_IP, RECEIVER_PORT 정보를 key=value 형식으로 텍스트 파일에 작성합니다.
  2. config 파일을 사용하여 setup 파일 실행: 준비된 config 파일을 setup 파일 실행 시 첫 번째 인자로 넣어 실행합니다. 예시: ./setup_exem-manager-agent_3.0.21.bin manager-install-config

clipboard

설치 방법 ② 고객사의 원격 repository를 이용하는 방법 (v3.0.21 이상)

  1. install_exem-manager-agent.sh 수정: RECEIVER_IP, RECEIVER_PORT, AGENT_SETUP_FILE_URL을 수정합니다.
  2. 원격 repository에 파일 업로드: 수정한 install_exem-manager-agent.sh와 setup_exem-manager-agent_(버전).bin 파일을 고객사의 원격 repository에 업로드합니다.
  3. 설치 대상 HOST 서버에서 패키지 설치 및 실행: curl 또는 wget 명령어를 사용하여 원격 repository에 업로드된 install_exem-manager-agent.sh 파일을 실행합니다. 예시 (curl): curl -k -fsSL <URL> | sh && sudo ./exem/manager/start.sh

설치 방법 ③ 수집 서버의 repository를 이용하는 방법 (v3.0.21 이상)

  1. 수집 서버에서 스크립트 수정:
    • v3.0.21 버전: install_exem-manager-agent.sh 파일을 수정하여 RECEIVER_IP, RECEIVER_PORT, FILEREPO_PORT를 입력합니다.
    • v3.0.22 버전 이상: install_exemone-filerepo.sh 파일을 수정하여 RECEIVER_IP, UPLOAD_AGENT_LIST, UPLOAD_INI_FILE을 입력합니다.
  2. 수집 서버에서 install_exemone-filerepo.sh 실행: 스크립트 실행 후 출력되는 curl 명령어를 복사합니다.

clipboard

  1. 설치 대상 HOST 서버에서 패키지 설치 및 실행: 복사한 curl 명령어를 설치 대상 HOST 서버의 설치 경로에서 실행합니다.

clipboard

4-2. Linux 및 Unix 환경 통합 설치 (v3.0.22 이상)​

Manager Agent v3.0.22 이상 버전부터는 매니저 에이전트의 설치로 다른 에이전트 설치를 지원합니다. 통합 설치 에이전트들은 같은 경로 및 계정으로 제한됩니다. 지원 가능한 에이전트 최소 버전은 exem-host-agent v3.0.15, exemone-db-agent v3.0.604.0입니다.

설치 서버 파일 업로드 방식

  1. 동일 계정 및 권한으로 설치 파일을 업로드합니다.

  1. 커맨드 기반 설치: 다음 명령어를 실행합니다. ./setup_exem-manager-agent_3.0.22.bin -i {RECEIVER_IP} -a {설치할에이전트_1,설치할에이전트_2}

clipboard

  1. 환경파일 기반 설치: 환경 파일 샘플을 생성하고 작성한 뒤 다음 명령어를 실행합니다. ./setup_exem-manager-agent_3.0.22.bin -f {FILE}

clipboard

수집 서버 파일 업로드 방식

  1. 수집 서버 파일 업로드: install_exemone-filerepo.sh 스크립트 내부의 필수 정보를 입력합니다.

clipboard

  1. 스크립트 수행 후 출력되는 curl 명령어를 설치 서버에서 실행합니다.

clipboard

  1. 커맨드 기반 설치: curl -fsSL http://10.20.30.40:9011/install_exem-manager-agent.sh | sh -s -- --agent=host,db 명령어를 실행합니다.

clipboard

  1. 환경파일 기반 설치: curl -fsSL http://10.20.30.40:9011/install_exem-manager-agent.sh | sh -s -- --ini=sample.ini 명령어를 실행합니다.

clipboard

  1. 수집 서버 파일 업로드 해제: 설치 서버 사용 완료 후 수집 서버 컨테이너 정리를 위해 ./uninstall_exemone-filerepo.sh를 실행합니다.

4-3. Windows 환경 설치​

  1. setup 파일 실행: setup_exem-manager-agent_[version].exe 파일을 실행합니다.

  1. 설치 경로 설정: 설치 폴더를 설정합니다. 기본 경로는 C:\Program Files (x86)\exem입니다.

  1. Receiver IP & Port 설정: MGR_RECEIVER_ADDR에 {IP}:{port} 형식으로 Receiver IP와 Port를 입력합니다. (예: 10.10.10.10:9010) 기본값이 설정되어 있지 않으므로 반드시 지정해야 합니다.

  1. Receiver IP & Port 확인: 설정된 정보를 확인하고 [Yes (Y)]를 선택하여 설치를 시작합니다.

clipboard

  1. 서비스 등록 선택: 서비스를 등록할지 여부를 선택합니다. 서비스를 등록하면 Manager Agent가 비정상적으로 종료될 경우 자동으로 재시작됩니다.

  1. 설치 완료: 설치가 완료되면 [Close]를 선택합니다. 서비스를 등록한 경우 Manager Agent가 자동으로 시작됩니다.

  1. Agent 연결 Key 파일 작성: Manager Agent가 관리하는 에이전트 연결을 위해 agent_config.json (v3.0.9 이상) 파일을 작성합니다.

5. 실행 참고 사항​

5-1. 실행/중지 방법​

  • Linux/Unix: ${MGR_EXEM_HOME}/manager 디렉토리의 start.sh와 stop.sh를 사용하여 실행/중지합니다.
  • Windows: $MGR_MANAGER_HOME/manager 경로의 start.bat과 stop.bat을 관리자 권한으로 실행하여 시작/중지합니다.

5-2. 정상 실행 확인 방법​

  • Linux/Unix: ps -ef | grep exem-manager-agent 명령어를 실행하여 프로세스 목록에서 exem-manager-agent가 실행 중인지 확인합니다.

  • Windows: 작업 관리자 > 프로세스 탭에서 "exem-manager-agent"가 목록에 있는지 확인합니다.

5-3. 버전 확인 방법​

  • Linux/Unix (간단한 방법): ${MGR_EXEM_HOME}/manager/pkg_version.sh 명령어를 실행합니다.

  • Linux/Unix (자세한 방법): ${MGR_EXEM_HOME}/manager/bin/exem-manager-agent -v 명령어를 실행합니다.

  • Windows (간단한 방법): Windows PowerShell에서 $EXEM_MANAGER_HOME 폴더로 이동 후 .\pkg_version.bat 명령어를 실행합니다.

  • Windows (자세한 방법): Windows PowerShell에서 $EXEM_MANAGER_HOME/bin 폴더로 이동 후 .\exem-manager-agent_win_64.exe -v 명령어를 실행합니다.

5-4. 서비스 등록 확인 (Windows)​

서비스 목록에서 "EXEM MANAGER AGENT"로 등록되어 있는지 확인합니다.

6. 패치 방법​

기존에 실행되고 있는 Manager Agent가 있는 경우 종료 후 패치를 진행해야 합니다. 패치 진행 시 기존 설정한 ${MGR_EXEM_HOME} 디렉토리를 변경 없이 진행해야 하며, ${MGR_EXEM_HOME}/manager/data/manager_id 파일이 유지되어야 기존과 동일한 Manager로 인식됩니다. setup 파일을 사용한 패치를 권장합니다.

  1. setup 파일 실행: [ install(patch) ]를 선택합니다.

  1. 설치 옵션 설정: 설정했던 MGR_EXEM_HOME을 입력하고, 이미 설치되어 있는지 확인 후 패치 여부를 선택합니다. 설치 이후 변경된 옵션(예: RECEIVER_IP/PORT)은 반영되지 않으므로 해당 설정 값을 필수로 확인해야 합니다.

clipboard

  1. 패치 완료: 패치가 완료됩니다.

참고 문서