이 장에서는 제니퍼 확장 에이전트의 설치 방법을 설명한다.
확장 에이전트 지원 버전
지원하는 OS
지원하는 Linux 배포 버전은 아래와 같고,
CentOS 7 이상
Ubuntu 18.04 이상
윈도우는 Windows Server 2012 R2 이상에서 동작한다.
에이전트 설치 및 제거
제니퍼 확장 에이전트의 압축 파일(jennifer-agent-extension-[version].zip)을 해제하면 다음의 파일이 생성된다.
install.bat (윈도우용 설치 스크립트)
install.sh (리눅스용 설치 스크립트)
jennifer-extension-darwin-amd64 (MAC용 에이전트 실행 파일)
jennifer-extension-linux-amd64 (리눅스용 에이전트 실행 파일)
jennifer-extension-x64.exe (윈도우용 에이전트 실행 파일)
uninstall.bat (윈도우용 제거 스크립트)
uninstall.sh (리눅스용 제거 스크립트)
윈도우 운영체제
설치
확장 에이전트를 실행하기 위해 제니퍼 서버 접속 정보를 갖는 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