Skip to content

IntelligentViewing_Linux.properties 옵션별 한글 해설 및 가이드

1. JAVA_HOME

  • 설명: JAVA_HOME 환경 변수를 지정합니다. 비워두면 시스템 환경 변수에서 JAVA_HOME 값을 자동으로 사용합니다.
  • 예시:
    JAVA_HOME=/usr/lib/jvm/java-17-openjdk-17.0.1
  • 팁: 특정 Java 버전을 사용해야 할 경우 직접 경로를 입력하세요. 서비스 실행 유저가 해당 경로에 접근할 수 있어야 합니다.

2. HTTP_PROTOCOL

  • 설명: 서비스에 사용할 프로토콜을 지정합니다. SSL을 사용하려면 https로 설정합니다.
  • 기본값: http

3. KEYSTORE 관련 설정 (SSL 사용 시)

  • KEYSTORE_PATH: SSL용 keystore 파일 경로 (.p12 또는 .jks 형식)
  • KEYSTORE_PASSWORD: keystore 비밀번호
  • KEYSTORE_ALIAS: keystore의 alias명
  • 예시:
    KEYSTORE_PATH=/home/ssl/iv.keystore.p12

4. CORS 설정

  • ENFORCE_CORS_ORIGINS: true로 설정 시 CORS 헤더를 강제 적용하고, CORS_ORIGIN_LIST 환경변수에 통합 오리진을 추가함. 기본값은 false.
  • CORS_ADDITIONAL_HEADERS_LIST: 추가로 허용할 CORS 헤더 이름(콤마로 구분). ENFORCE_CORS_ORIGINS가 false면 무시됨.

5. Forwarded Host 설정

  • ENFORCE_FORWARDED_HOSTS: true면 HTTP Forwarded, X-Forwarded-Host 헤더의 호스트가 백엔드 목록에 포함되어 있어야 함. 기본값은 false.
  • FORWARDED_HOSTS_LIST: 허용할 Forwarded Host를 콤마로 구분하여 입력.

6. 인증, 암호화 설정

  • ENABLE_OAUTH: OAuth 인증 사용 여부. 기본값 true.
  • ENABLE_CREDENTIAL_ENCRYPTION: 서비스의 .env 파일 내 민감 정보(비밀번호 등) 암호화 여부. 기본값 true.

7. 서비스별 호스트 기본값

  • DEFAULT_HOST: 모든 서비스에 기본으로 사용할 호스트명을 지정(도메인 전체, 프로토콜/포트 제외).
  • 각 서비스별 *_HOST 항목이 비어있으면 DEFAULT_HOST 값 사용.
  • 예시:
    DEFAULT_HOST=computername.domain.server

8. 데이터베이스(DB) 설정

  • DEFAULT_DB_HOST/PORT/NAME/USER/PWD/PROVIDER/USE_SSL: 전체 서비스에 공통으로 사용할 DB 정보.
  • 예시:
    DEFAULT_DB_HOST=dbserver.domain.server
    DEFAULT_DB_PORT=5432
    DEFAULT_DB_NAME=iv
    DEFAULT_DB_USER=ivuser
    DEFAULT_DB_PWD=ivpassword
    DEFAULT_DB_PROVIDER=postgresql
  • SSL DB 연결 시 DEFAULT_DB_USE_SSL=true로 설정

9. RabbitMQ 설정

  • RMQ_HOST/PORT/USER/PWD: RabbitMQ 서버 정보(호스트, 포트, 사용자, 비밀번호)
  • RMQ_USE_SSL: RabbitMQ SSL 연결 여부
  • RMQ_KEYSTORE/TRUSTSTORE 관련: SSL 사용 시 .p12/.jks 경로, 비밀번호, 타입(PKCS12/JKS) 지정 필요

10. 아티팩트 저장소 경로

  • ARTIFACT_VOLUMES_ROOT: IV에서 생성되는 아티팩트 저장 위치 경로
  • 기본값: /home/IVArtifacts

11. OTDS(인증 시스템) 설정

  • OTDS_ORIGIN: OTDS 서버 URL (http://<host>/otdsws 형식)
  • OTDS_ADMIN_USER/OTDS_ADMIN_PW: OTDS 관리 사용자/비밀번호 (설정 시 OTDS 자동 구성)
  • LICENSE_RESOURCE: OTDS_ADMIN_USER 미설정 시만 입력(라이센스 리소스)
  • PUBLISHER_AUTH_CLIENT_ID/SECRET, PUBLICATION_AUTH_CLIENT_ID/SECRET: OTDS 관리 계정 미설정 시만 입력

12. Content Server 연동 옵션

  • OTCS_ADMIN_USER/OTCS_ADMIN_PW: Content Server 관리자 계정
  • OTCS_ORIGIN: Content Server 주소 (http://<host>:8080/OTCS/cs)
  • OTCS_RESOURCE_NAME: Content Server 리소스명(기본값 cs)
  • OT_INTEGRATION: OpenText 제품과 연동 시 true, 이외 false
  • OT_INTEGRATION_URL: OpenText 제품 연동 시 해당 인스턴스 URL

13. 서비스별 상세 설정

  • VIEWER_HOST/PORT, MARKUP_SERVICE_HOST/PORT, SEARCH_SERVICE_HOST/PORT, ...
    각 서비스의 호스트 및 포트(비어 있으면 DEFAULT_HOST, DEFAULT_DB_* 값 사용)
  • MARKUP_JWT_SECRET, ENABLE_ROLE_BASED_ACCESS_CONTROL: 마크업 서비스의 JWT/역할 기반 접근 제어 설정
  • TRUSTED_SOURCE_ORIGINS: 파일 소스 허용 오리진 목록(인증 필요/불필요 구분)

14. 각 서비스별 DB 상세 설정

  • *_DB_HOST/PORT/NAME/USER/PWD/USE_SSL/PROVIDER
    개별 서비스(DB 분리 필요시)별 DB 정보 지정 가능

15. 기타 옵션

  • ACCESS_CHECK_TIMEOUT_SECONDS: 소스 파일 접근 시 타임아웃(초), 기본값 3
  • ASSET_SERVICE_HOST/PORT: Asset 서비스 설정

설정 예시

아래는 실제 환경에서 필요한 값만 채워서 사용할 수 있는 예시입니다.

JAVA_HOME=/usr/lib/jvm/java-17-openjdk-17.0.1
HTTP_PROTOCOL=https
KEYSTORE_PATH=/home/ssl/iv.keystore.p12
KEYSTORE_PASSWORD=yourpassword
KEYSTORE_ALIAS=iv
DEFAULT_HOST=ivserver.domain.com
DEFAULT_DB_HOST=dbserver.domain.com
DEFAULT_DB_PORT=5432
DEFAULT_DB_NAME=iv
DEFAULT_DB_USER=ivuser
DEFAULT_DB_PWD=ivpassword
DEFAULT_DB_USE_SSL=true
DEFAULT_DB_PROVIDER=postgresql
RMQ_HOST=rabbitmq.domain.com
RMQ_PORT=5672
RMQ_USER=rmquser
RMQ_PWD=rmqpassword
ARTIFACT_VOLUMES_ROOT=/home/IVArtifacts
OTDS_ORIGIN=http://otds.domain.com/otdsws
OTDS_ADMIN_USER=otdsadmin
OTDS_ADMIN_PW=otdspassword
VIEWER_HOST=
VIEWER_PORT=3358
...

사용 가이드 요약

  1. 필수 항목을 반드시 입력합니다 (예: DEFAULT_HOST, DB 정보, RMQ 정보, ARTIFACT_VOLUMES_ROOT 등).
  2. SSL/인증/암호화 옵션 등은 필요에 따라 활성화합니다.
  3. 서비스별 세부 설정은 기본값을 사용하거나 분리된 값이 필요한 경우 직접 지정합니다.
  4. 설치 후 서비스 별 환경파일(.env 등)에서 추가적으로 암호화 적용, 오리진 허용 등 세부 조정이 필요할 수 있습니다.
  5. 설치 가이드 문서(Install Guide)를 함께 참고하면 더욱 안전하게 배포할 수 있습니다.