제니퍼 에이전트(extension) 설치 및 구성

이 장에서는 제니퍼 확장 에이전트의 설치 방법을 설명한다.

확장 에이전트 지원 버전

지원하는 OS

지원하는 Linux 배포 버전은 아래와 같고,

윈도우는 Windows Server 2012 R2 이상에서 동작한다.

에이전트 설치 및 제거

제니퍼 확장 에이전트의 압축 파일(jennifer-agent-extension-[version].zip)을 해제하면 다음의 파일이 생성된다.

윈도우 운영체제

설치

확장 에이전트를 실행하기 위해 제니퍼 서버 접속 정보를 갖는 config 파일이 필요하다. 이를 위해 기본적인 템플릿을 다음과 같이 생성할 수 있다.

// 압축을 해제한 디렉터리를 c:\jennifer-extension으로 가정

c:\jennifer-extension> jennifer-extension-x64.exe --generate-config

위의 명령어는 다음과 같은 내용의 app.config 파일을 생성한다.

C:\jennifer-extension> type app.config
# Configuration file for JENNIFER Agent Extension
server_address = 127.0.0.1
server_port    = 5000
domain_id      = 1000
inst_id        = 1
옵션 설명

이름

설명

server_address

제니퍼 서버가 실행 중인 컴퓨터의 IP 또는 이름

server_port

제니퍼 서버가 대기 중인 포트

domain_id

제니퍼 서버의 도메인 ID

inst_id

확장 에이전트를 구분하기 위한 ID

정상적으로 app.config 파일의 옵션을 설정했다면 이제 명령행에서 다음과 같이 실행할 수 있다.

c:\jennifer-extension> jennifer-extension-x64.exe --console --config=app.config

원한다면 서비스로 등록할 수 있다.

// 서비스 등록 시에는 config 파일을 절대 경로로 설정
// 반드시 관리자 권한으로 실행

c:\jennifer-extension> install.bat

이후 일반적인 NT 서비스와 같이 실행/중지를 할 수 있다.

// 서비스 시작 (관리자 권한으로 실행)
c:\jennifer-extension> net start jennifer-extension

// 서비스 중지 (관리자 권한으로 실행)
c:\jennifer-extension> net stop jennifer-extension

제거

서비스로 등록한 경우에만 필요하며 단순히 관리자 권한으로 다음과 같이 실행한다.

// 관리자 권한으로 실행
c:\jennifer-extension> uninstall.bat

리눅스 환경

설치

확장 에이전트를 실행하기 위해 제니퍼 서버 접속 정보를 갖는 config 파일이 필요하다. 이를 위해 기본적인 템플릿을 다음과 같이 생성할 수 있다.

$ ./jennifer-extension-linux-amd64 --generate-config

위의 명령어는 다음과 같은 내용의 app.config 파일을 생성한다.

$ cat app.config
# Configuration file for JENNIFER Agent Extension
server_address = 127.0.0.1
server_port    = 5000
domain_id      = 1000
inst_id        = 1

정상적으로 app.config 파일의 옵션을 설정했다면 이제 명령행에서 다음과 같이 실행할 수 있다.

$ jennifer-extension-linux-amd64 --console --config=app.config

원한다면 systemctl 유형의 데몬으로 등록할 수 있다.

// 데몬 등록 시에는 config 파일을 절대 경로로 설정
// root 권한 필요

$ sudo ARIES_CONFIG=/usr/bin/jennifer-extension/app.config ./install.sh

이후 일반적인 데몬과 같이 실행/중지를 할 수 있다.

// 데몬 시작 (root 권한 필요)
$ sudo systemctl start jennifer-extension

// 데몬 중지 (root 권한 필요)
$ sudo systemctl stop jennifer-extension
// 또는, kill
$ sudo kill -9 [...pid...]

제거

데몬으로 등록한 경우에만 필요하며 단순히 root 권한으로 다음과 같이 실행한다.

// root 권한 필요
$ sudo ./uninstall.bat