Windows 서비스 설정

본 부록에서는 Windows 서비스를 등록할 때 필요한 파일 설정에 대해 설명한다.

다음은 서비스명이 'jeus’인 경우 Windows 서비스 등록 파일에 대한 예이다(서비스명에 따라 파일명이 설정된다).

[jeus]
jeus.home=C:\TmaxSoft\JEUS9
jeus.description=JEUS9 Windows service
java.home=C:\Java\jdk-17
java.vm.type=hotspot
java.vm.option=-server
jeus.nm.classpath= C:\TmaxSoft\JEUS9\lib\system\bootstrap.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jakarta.activation.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jeusapi.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jeus-core-common.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jeus-util-common.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jeus-logger.jar;
                   C:\TmaxSoft\JEUS9\lib\system\utilities.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jeus.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jeusjaxb.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jeus-network.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jeus-launcher.jar;
                   C:\TmaxSoft\JEUS9\lib\system\stax2-api-4.2.1.jar;
                   C:\TmaxSoft\JEUS9\lib\system\commons-cli.jar;
                   C:\TmaxSoft\JEUS9\lib\system\tmaxjce_jdk15x.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jeus-security.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jeus-management.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jeus-config.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jaxb-core.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jaxb-impl.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jaxb-plugins-runtime-3.0.0.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jeus-util.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jmxremote.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jmx-description.jar;
                   C:\TmaxSoft\JEUS9\lib\system\alpn-api-1.1.3.v20160715.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jakarta.xml.bind-api-3.0.1.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jakarta.servlet-api.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jakarta.jms-api.jar;
                   C:\TmaxSoft\JEUS9\lib\system\jakarta.servlet.jsp-api.jar
jeus.nm.boot.param=-domain jeus_domain -server adminServer
jeus.nm.down.param=-stopServer
jeus.windows.service.log.path=C:\TmaxSoft\JEUS9\logs
shutdown.previous.nodemanager=true
-Xmx1024m

다음은 domain-config-template.properties 주요 설정 항목에 대한 설명이다.

항목 설명

jeus.home

JEUS가 설치된 디렉터리 경로이다.

jeus.description

해당 Windows 서비스에 대한 설명이다.

java.home

Java가 설치된 디렉터리 경로이다.

java.vm.type

Java HotSpot JVM 사용 유무에 따른 옵션을 설정한다.

다음 값으로 설정한다.

  • hotspot : Java HotSpot JVM을 사용하는 경우 설정하는 옵션이며, java.vm.option의 -server 옵션으로 동작한다.

  • old : Java HotSpot JVM을 사용하지 않을 경우에 설정하는 옵션이며, vm 옵션이 들어가지 않는다. vm 옵션이 동작하지 않는 장비는 'old’로 설정해야 한다.

java.vm.option

Java HotSpot JVM 사용 유무에 따른 옵션을 설정한다.

다음 값으로 설정한다.

  • hotspot : HotSpot JVM을 사용할 경우 : -server

  • old : HotSpot JVM을 사용하지 않을 경우 : -Djeus.dispatcher.blocking=true

jeus.nm.classpath

노드 매니저를 부팅할 때 필요한 classpath 경로를 설정한다.

jeus.nm.boot.param

Windows 서비스 시작과 함께 노드 매니저가 부팅되는데, 이때 사용할 추가적인 옵션을 설정한다.

현재는 Windows 서비스를 시작과 동시에 JEUS에서 기동할 DAS 서버를 설정할 수 있다. 도메인 이름과 서버 이름을 함께 설정한다. 아무런 설정이 없을 때에는 노드 매니저만 기동된다.

(예: -domain jeus_domain -server adminServer)

jeus.nm.down.param

Windows 서비스를 종료할 때 사용되는 추가적인 옵션을 설정한다.

현재는 Windows 서비스 종료와 함께 JEUS를 종료하는 옵션을 설정 할 수 있다. (예: -stopServer)

jeus.windows.service.log.path

Windows 서비스 log 경로를 설정한다.

shutdown.previous.nodemanager

Windows 서비스를 시작할 때 기존에 실행 되 있던 JEUS를 종료하고 Windows 서비스를 실행할지 여부를 설정한다.

  • false : 이미 JEUS가 실행되고 있는 상태에서 Windows 서비스를 시작할 수 없다.