설치 개요 및 환경설정

본 장에서는 호스트 매니저를 설치하는 과정 및 환경설정에 대해서 설명한다.

1. 실행 환경

JEUS 설치 시 hostmanager는 JEUS_HOME/hostmanager 경로에 설치된다.

SUPERFRAME_HOME 환경 변수를 JEUS_HOME/hostmanager 경로로 지정 후 hostmanager를 실행할 수 있다.

2. Host Manager 환경설정

호스트 매니저를 실행하기 전에 config 디렉터리의 hostmanager.yml 파일에 기본 호스트 설정을 입력해야 한다.

다음은 hostmanager.yml 파일에 입력 가능한 설정의 설명이다.

platform:
  superframe
## host configuration
host:
  # host manager home directory path
  rootDir: /home/tmax/hostmanager
  address: 192.168.1.1
  port: 7730
  envs:
    JEUS_HOME: ${JEUS_HOME}
    JEUS_USERNAME: administrator
  engines:
    JEUS:
      additionalArgs: ['-cachelogin']
항목 설명

platform

호스트 매니저를 실행하는 플랫폼 환경을 입력한다. 현재는 superframe 만을 지원한다.

host.rootDir

설치된 호스트 매니저의 루트 디렉터리를 입력한다. (기본값: ${SUPERFRAME_HOME})

SUPERFRAME_HOME 환경변수가 입력되지 않았을 경우 현재 디렉터리(bin)의 상위 디렉터리가 SUPERFRAME_HOME으로 설정된다.

host.address

호스트 매니저가 마스터로부터 명령을 받을 listen address 호스트 값을 입력한다. (기본값: localhost)

host.port

호스트 매니저가 마스터로부터 명령을 받을 listen port 값을 입력한다.

(기본값: 7730)

host.envs

호스트 매니저에서 프로그램 인스턴스를 실행할 때 적용할 환경변수 값을 입력한다. 엔진을 실행하는 데 필요한 환경변수 값(예: JEUS_HOME)도 입력할 수 있다. 동일한 환경변수에 대하여 hostmanager.yml에 입력된 환경변수 값을 시스템 환경변수 값보다 우선시한다.

기본값으로 JEUS_USERNAME이 administrator로 설정되어 있다.

host.engines.JEUS.additionalArgs

제우스 엔진 실행시 필요한 추가 인수들을 배열로 입력한다.

예) 캐시로그인 ['-cachelogin'] (캐시로그인 기능 사용시 jeusadmin -u [user] -p [password] -cachelogin 명령 필요)

캐시로그인 파일 수동 설정(절대경로 권장) ['-cachelogin', '-f', '/home/tmax/jeus21/bin/jeusEncode']

환경변수의 JEUS_PASSWORD를 사용하지 않고 additinalArgs를 사용할 경우 ['-p', 'jeus']

3. 엔진 환경변수 지정

일부 엔진 실행에는 환경변수 지정이 필수적이다. 예를 들어 JEUS 엔진의 경우 JEUS_HOME, JEUS_USERNAME, JEUS_PASSWORD 환경변수가 필수적이다. 호스트 매니저에 입력하기 위해서는 hostmanager.yml 파일의 env 값으로 입력할 수 있다.