1. 서버 시스템 프로퍼티

본 절에서는 서버 시스템 프로퍼티에 대해 설명한다.

  • jeus.home

    설명

    XML이나 코드 등을 생략한다.

    기본값

    JEUS가 설치된 디렉터리

  • jeus.launcher.log.home

    설명

    JEUS Launcher Log가 생성되는 위치를 지정한다. 지정하지 않을 경우 JEUS_SERVER_HOME/logs에 남게 된다.

    기본값

    null

  • jeus.boot.printclasspath

    설명

    시스템 클래스 로더의 클래스 패스에 대한 출력 여부를 결정한다.

    기본값

    false

  • jeus.jdk.home

    설명

    JDK Home 디렉터리 경로로 javac, tools.jar 경로를 설정할 때 사용한다.

    기본값

    지정되어 있지 않으면 java.home을 사용

  • jeus.properties.replicate

    설명

    Luncher에서 서버를 띄울 때 전달할 시스템 프로퍼티의 prefix이다.

    domain.xml의 server/jvm-config/jvm-option이 우선한다.

    기본값

    jeus

  • jeus.server.check-interrupted-status

    설명

    JEUS에서 EJB, JDBC operation을 수행하는 Thread가 Interrupt 신호를 받으면 Exception의 발생 여부를 설정한다.

    JEUS에서는 특정 작업하는 경우 Thread가 Interrupt가 걸려있으면 Exception이 발생하므로 해당 Exception에 대해서는 사용자 애플리케이션에서 처리해 주어야 한다.

    기본값

    true

  • jeus.threadpool.queuesize

    설명

    JEUS 시스템의 Threrad Pool에서 사용하는 Thread Pool의 내부 Queue size를 설정한다. Thread Pool에서는 Task 수행을 위해 내부 Queue를 사용하는데 이 Queue의 크기를 설정한다. 만약 시스템의 부하가 많으나 설정 Thread의 개수가 작을 경우 Queueing되는 Task들이 증가할 것이고, 이때 최대 설정한 Queue 크기만큼만 Queueing을 허용한다. 이 시스템 프로퍼티보다 domain.xml의 server/system-thread-pool/queue-size 값이 우선한다.

    기본값

    4096

  • jeus.threadpool.keepalive

    설명

    JEUS 시스템의 Threrad Pool에서 사용하는 Thread Pool에 적용될 Keep alive time을 설정한다. 만약 min 이하의 Thread에 대해서 설정된 시간 동안 사용되지 않는다면, 해당 Thread는 Thread Pool에서 제거된다.

    이 시스템 프로퍼티보다 domain.xml의 server/system-thread-pool/keep-alive-time 값이 우선한다.

    기본값

    600000 (단위: ms)

  • jeus.rmi.defaultPort

    설명

    RMI의 default export port이다. export-port가 지정되지 않은 모든 EJB에도 적용된다.

    기본값

    - base port + 7

  • jeus.vm.bits

    설명

    JVM의 bit 수이다.

    서버가 기동할 때 64bit JVM인 경우 64를 설정하면 -d64가 추가된다(IBM의 경우에는 -d64가 필요없다).

  • jeus.interop.ssl.keystore

    설명

    CORBA CSIv2에서 사용할 SSL Keystore를 지정한다.

    기본값

    jeus.net.ssl.keystore의 값

  • jeus.interop.ssl.keypass

    설명

    CORBA CSIv2에서 사용할 SSL Keystore의 패스워드를 지정한다.

    기본값

    jeus.net.ssl.keypass의 값

  • jeus.interop.ssl.truststore

    설명

    CORBA CSIv2에서 사용할 SSL Truststore를 지정한다.

    기본값

    jeus.net.ssl.truststore의 값

  • jeus.interop.ssl.trustpass

    설명

    CORBA CSIv2에서 사용할 SSL Truststore의 패스워드를 지정한다.

    기본값

    jeus.net.ssl.trustpass의 값

  • jeus.jvm.version

    설명

    JEUS가 사용하는 JVM의 버전에 대한 정보이다.

    기본값

    hotspot (-server를 사용함)

  • jeus.server.cpumonitor.enabled

    설명

    HOST CPU 사용률을 측정하기 위한 모니터링 기능을 활성화한다.

    기본값

    false

  • jeus.server.cpumonitor.interval

    설명

    HOST CPU 사용률을 모니터링하는 기능을 사용하는 경우 CPU 사용률을 측정할 주기이다.

    기본값

    60000 (단위: ms)

  • jeus.server.process.cpumonitor.enabled

    설명

    Process CPU 사용률을 측정하기 위한 모니터링 기능을 활성화한다.

    기본값

    false

  • jeus.server.process.cpumonitor.interval

    설명

    Process CPU 사용률을 모니터링하는 기능을 사용하는 경우 CPU 사용률을 측정할 주기이다.

    기본값

    2000 (단위: ms)

  • jeus.server.cpumonitor.ratio

    설명

    Process CPU 사용률을 모니터링하는 기능을 사용하는 경우 CPU 오버플로우의 기준치를 설정한다. 소숫점으로 설정하며 CPU 사용량을 최대 100으로 볼 때 최대 몇 퍼센트의 CPU를 사용하고 있는 경우 오버플로우로 가정할지를 설정한다.

    기본값

    0.8

  • jeus.server.enable.restart.in.memory.shortage

    설명

    메모리가 오버플로우될 때 서버의 재기동 여부를 설정한다.

    기본값

    true

  • jeus.server.memorymonitor.enabled

    설명

    서버의 메모리 사용률을 측정하기 위한 모니터링 기능을 활성화한다. 모니터링할 때 Thread Dump가 로그에 남게 된다.

    기본값

    false

  • jeus.server.memorymonitor.interval

    설명

    메모리 사용률을 모니터링하는 기능을 사용하는 경우 메모리 사용률을 측정하고자 하는 주기이다.

    기본값

    2000 (단위: ms)

  • jeus.server.memorymonitor.duration

    설명

    메모리 사용률을 모니터링하는 기능을 사용하는 경우 메모리 오버플로우 현상의 지속 시간을 설정한다. 설정한 시간동안 메모리 오버플로우 시간이 지속되면 서버가 종료된다.

    기본값

    60000 (단위: ms)

  • jeus.server.memorymonitor.ratio

    설명

    메모리 사용률을 모니터링하는 기능을 사용하는 경우 메모리 오버플로우의 기준치를 설정한다. 소숫점으로 설정하며 메모리 사용량을 최대 100으로 볼 때 최대 몇 퍼센트의 메모리를 사용하고 있는 경우 오버플로우로 가정할지를 설정한다.

    기본값

    0.8

  • jeus.server.maxdowntime

    설명

    메모리 사용률을 모니터링하는 기능을 사용하는 경우 메모리 오버플로우가 발생하여 서버를 종료할 때 서버가 종료될 때까지 대기하는 시간을 설정한다.

    설정한 시간이 지나도 서버가 종료되지 않으면 서버는 강제종료된다.

    기본값

    0 (단위: ms)

  • jeus.server.configfile.backup.size

    설명

    동적 변경할 때 저장되는 백업 domain.xml의 갯수를 지정한다.

    기본값

    50

  • jeus.server.standby.retrycount

    설명

    서버를 STANDBY 상태로 기동한 경우 기동을 재시도할지 여부 및 횟수를 지정한다.

    STANDBY 상태로 기동하는 원인을 정확하게 파악하고 있고, 확실하게 복구 가능하다고 판단되는 경우에만 설정해야 한다.

    기본값

    0 (재시도하지 않음), 5 (클러스터에 속한 서버인 경우)

  • jeus.server.standby.retryinterval

    설명

    jeus.server.standby.retrycount를 통해 횟수를 지정하고, 본 시스템 프로퍼티를 통해 재시도 사이에 간격을 지정한다.

    기본값

    60000 (단위: ms)

  • jeus.print-system-properties

    설명

    설정된 시스템 프로퍼티를 출력할지를 설정한다.

    기본값

    false

  • jeus.management.snmp.dynamic

    설명

    SNMP를 서버에 사용하는 경우 Dynamic OID 생성 여부를 설정한다.

    SNMP를 서버에 사용하는 경우 OID를 Static으로 할지, Dynamic으로 할지 설정한다.

    • true : Static일 경우로 MIB 파일 기반의 OID를 생성한다.

    • false : Dynamic일 경우로 객체에 따라서 동적으로 생성된 OID가 Static OID의 접미사로 추가된다.

    기본값

    true

  • jeus.management.snmp.dynamic.shortoid

    설명

    Dynamic OID의 길이를 선택한다.

    MIB 기반의 OID에 추가적으로 더해지는 OID의 구성요소의 자리 수를 결정한다.

    • true : Short OID일 경우로 8자리의 ID가 추가된다.

    • false : Short OID가 아닐 경우로 32자리의 ID가 추가된다.

    기본값

    false

  • jeus.domainadminserver.deploy.socket

    설명

    MASTER(Master Server)가 유지하는 deploy 용도 소켓 커넥션 갯수의 최댓값이다.

    MS(Managed Server)에서는 부팅 시간을 단축시키기 위해 MASTER로부터 애플리케이션를 받아올 때 커넥션을 여러 개 맺고 병렬로 받아올 수 있다. 이때 MASTER는 한순간에 여러 MS로부터 많은 커넥션을 맺게 되므로 이 최댓값를 설정할 수 있도록 한다.

    MASTER의 deploy 커넥션이 최댓값이 된 상태에서 다른 MS로부터 애플리케이션 전송 요청이 올 경우에는 해당 MS는 1개의 커넥션만을 사용하여 순차적으로 애플리케이션를 받아오도록 한다.

    기본값

    100

  • jeus.managedserver.deploy.socket

    설명

    MASTER로부터 애플리케이션를 받아올 때 MS가 사용하는 boot time deploy connection의 최댓값이다.

    MS가 boot하면서 MASTER로부터 애플리케이션를 받아오게 되는데 이때 병렬적으로 받아오기 위해 사용하는 MS boot time deploy connection 갯수의 최댓값을 설정한다. MS가 너무 많은 커넥션을 설정해서 MASTER에서의 커넥션 갯수가 full이 되버릴 경우 다른 MS가 영향을 받을 수 있으므로 주의하여 사용한다.

    애플리케이션 전송이 끝나면 해당 커넥션은 바로 해제되어 MASTER의 가용한 커넥션의 갯수를 다시 늘려준다. 또한 해당 설정의 커넥션 갯수를 크게 설정하더라도 받아올 애플리케이션의 갯수가 작다면 내부적으로 유지하는 커넥션의 갯수는 애플리케이션의 갯수로 자동으로 설정된다.

    기본값

    5

  • jeus.logging.useAsync

    설명

    프로퍼티에 대한 자세한 내용은 JEUS Server 안내서의 개요를 참고한다.

    기본값

    true

  • jeus.access.logging.skip.when.busy

    설명

    jeus.logging.useAsync가 true일 때에 한해 적용되는 옵션이다. 프로퍼티에 대한 자세한 내용은 JEUS Server 안내서의 개요를 참고한다.

    기본값

    false

  • jeus.logging.gclog.timestamp.on

    설명

    JVM에서는 기본적으로 GC Log가 jvm.log에 다른 로그들과 함께 기록된다. 이때, "-Xloggc:[파일]"을 jvm option으로 제공하여 원하는 [파일]에 GC Log를 redirect하여 기록할 수 있다. JEUS에서는 설정한 [파일]의 이름에 자동으로 timestamp를 추가하도록 되어있다. 이러한 동작은 JEUS가 기동될 때마다 동일한 [파일]에 GC Log를 덮어쓰지 않도록하기 위함이다. 그러나 사용자에 따라 이러한 동작을 원치 않을 수 있다. 이 경우 이 옵션을 해제하면 된다. 이 옵션을 해제할 경우에는 동일한 [파일]에 GC Log를 덮어쓰기 때문에 이전 로그를 잃으므로 주의하여 사용한다.

    기본값

    true

  • jeus.jmx.ping.period

    설명

    JMX 커넥션에서 연결 상태를 체크하기 위해 사용하는 Ping의 주기를 설정한다.

    기본값

    15000 (단위: ms)

  • jeus.jmx.ping.timeout

    설명

    JMX 커넥션에서 연결 상태를 체크하기 위해 사용하는 Ping의 타임아웃을 설정한다.

    Ping을 보낸 후 응답이 타임아웃 시간만큼 오지 않으면 연결에 문제가 있다고 판단하여 IOException을 발생시킨다.

    기본값

    15000 (단위: ms)

    jeus.server.memorymonitor.enabled, jeus.server.memorymonitor.ratio, jeus.server.memorymonitor.interval, jeus.server.memorymonitor.duration, jeus.server.enable.restart.in.memory.shortage 프로퍼티에 대한 자세한 내용은 JEUS Server 안내서의 메모리 사용량에 따른 제어를 참고한다.

  • jeus.config.lock.timeout

    설명

    동적 설정 변경을 위한 Lock을 획득하지 못했을 때 대기할 시간을 지정한다. 0 이하의 값을 지정한 경우에는 대기하지 않는다.

    기본값

    60000 (단위: ms)

  • jeus.jmx.worker.max

    설명

    JMX 요청 메시지를 처리할 스레드를 제공하는 스레드 풀이 가질 수 있는 스레드의 최대치를 지정한다.

    기본값

    20

  • jeus.server.command.threadpool.maxsize

    설명

    MASTER에서 명령을 병렬로 수행할 때 사용할 스레드 풀이 가질 수 있는 스레드의 최대치를 지정한다. 이를 설정할 때 너무 큰 값을 설정할 경우 MASTER의 CPU 점유율이 오를 수 있으므로 주의해야 한다.

    기본값

    10

  • jeus.server.invocation.keepBootOnError

    설명

    서버 기동 중 life cycle invocation 설정 문제로 에러가 발생한 경우 서버를 Standby 상태가 아닌 Running 상태로 기동시킬지 여부를 결정한다.

    기본값

    false

  • jeus.boot.ignorepatchoverlap

    설명

    패치 파일에 중복 클래스가 존재하는 경우, 이를 무시하고 기동을 진행할지 여부를 지정한다.

    기본값

    false

  • jeus.server.enable.auto-deploy

    설명

    기동 시 지정한 위치에 있는 애플리케이션 파일을 자동으로 배포하는 boot-time auto deployment 기능을 사용할지 여부를 설정한다.

    기본값

    true

  • jeus.server.auto-deploy.dir

    설명

    Boot-time auto deployment 수행 시 애플리케이션 파일을 탐색할 경로를 지정한다. 지정하지 않을 경우 내부 기본값으로 DOMAIN_HOME/auto-deploy를 탐색한다.

    기본값

    null

  • jeus.logging.defaultfilehandler.rotationcount

    설명

    JEUS Launcher Logger 등에서 사용하는 기본 파일 핸들러에 대해 rotation count를 지정한다. 서버 기동 스크립트에 설정해야 한다.

    기본값

    0

  • jeus.launcher.jvmlog.rotationcount

    설명

    jvm.log 파일에 대한 rotation count를 지정한다. 서버 기동 스크립트에 설정해야 한다.

    기본값

    0

  • jeus.server.thread.add-jvm-id-and-thread-id

    설명

    JEUS ThreadPool에서 생성하는 Thread의 이름 뒤에 [JVM ID-Thread ID]를 붙일지 여부를 지정한다.

    기본값

    false

  • jeus.server.disable.lock.file

    설명

    기동 시 SERVER_HOME/.workspace/tmp/SERVER_NAME.lck 파일에 대한 락을 사용할지 여부를 지정한다.

    기본값

    false

  • jeus.master.protocol

    설명

    Master 서버 주소의 프로토콜을 지정한다.

    기본값

    http

  • jeus.master.host

    설명

    Master 서버 주소의 host를 지정한다.

    기본값

    localhost

  • jeus.master.port

    설명

    Master 서버 주소의 port를 지정한다.

    기본값

    9736

  • jeus.master.aggregator.context.path

    설명

    jeus 측에서 MasterAggregator spring app을 기동시킬 context path를 지정하여 부팅시킬 수 있다.

    기본값

    /jeus/

  • jeus.master.admin.ui.context.path

    설명

    jeus 측에서 MasterAdminUI spring app을 기동시킬 context path를 지정하여 부팅시킬 수 있다.

    기본값

    /admin/