특정 변수로 Liberty 프로파일 환경을 사용자 정의하여
읽기 전용 파일 시스템에서 제품 바이너리 파일 및 공유 자원의
배치를 지원할 수 있습니다.
이 태스크 정보
Liberty 환경을 사용자 정의하기 위해 다음 목록에 있는 Liberty 특정 환경 변수를
server.env 파일에서 구성할 수 있습니다. ${wlp.install.dir} 구성 변수는
시작 스크립트가 포함된 디렉토리의 상위로 항상 설정되는 추론된 위치를
가지고 있습니다.
- WLP_USER_DIR
이 환경 변수는 ${wlp.user.dir}의
대체 위치를 지정하는 데 사용할 수 있습니다.
이 변수는 절대 경로여야 합니다. 이 변수가 지정된 경우, 런타임 환경은 지정된
디렉토리에서 공유 자원 및 서버 정의를 찾습니다. ${server.config.dir}은 ${wlp.user.dir}/servers/serverName과 같습니다.이 환경 변수가 지정되지 않으면
${wlp.user.dir}이 ${wlp.install.dir}/usr로 설정됩니다.
- WLP_OUTPUT_DIR
이 환경 변수를 사용하여 서버 생성 출력(예: 로그,
workarea 디렉토리, 생성된 파일)의 대체 위치를 지정할 수 있습니다.
logs 디렉토리에 있는 파일에는 console.log,
messages.log 및 생성되는 FFDC 파일이 포함될 수 있습니다.
생성되는 파일에는 server dump 또는 server javadump
명령을 사용하여 작성되는 서버 덤프가 포함될 수 있습니다.
이 변수는 절대 경로여야 합니다. 이 환경 변수가 지정된 경우
${server.output.dir}은
WLP_OUTPUT_DIR/serverName과 같이 설정됩니다.
환경 변수를 지정하지 않은 경우, ${server.output.dir}은 ${server.config.dir}과
동일합니다.
서버 명령이 사용될 때, 서버 프로세스는 현재 작업 디렉토리로
출력 디렉토리를 사용합니다.
- WLP_DEBUG_ADDRESS
이 환경 변수는
디버그 모드에서 서버를 실행할 때 대체 포트를 지정하는 데 사용할 수 있습니다.
기본값은 7777입니다. Liberty가 server 명령에서 디버그 모드로 실행될 때는 값 JAVA_DEBUG="-Dwas.debug.mode=true -Dcom.ibm.websphere.ras.inject.at.transform=true
-agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=${WLP_DEBUG_ADDRESS}"가 설정됩니다.
하지만 임베디드 Liberty 서버 SPI 또는 ws-server.jar 실행 가능 JAR 파일에서
Liberty를 실행하는 경우에는 동일한 설정을 사용하여 Liberty에 대해 디버그 모드를
사용으로 설정해야 합니다.
server.env 파일에서 WLP_OUTPUT_DIR, WLP_USER_DIR 및 WLP_DEBUG_ADDRESS
환경 변수를 지정할 수 있습니다. jvm.options 파일에 JVM 옵션을 지정할 수도 있습니다. 서버 관리 스크립트를 사용할 때만
server.env 파일과 jvm.options 파일이 모두 작동합니다. ws-server.jar 실행 가능
JAR 파일을 사용하여 서버를 시작하는 경우 이러한 파일은 지원되지 않습니다.
프로시저
- server.env 파일을 사용하여 환경 변수를 지정하십시오.
설치 레벨과 서버 레벨에서
server.env 파일을 사용하여
환경 변수(예:
JAVA_HOME,
WLP_USER_DIR,
WLP_OUTPUT_DIR)를 지정할 수 있습니다.
예:
# 특정의 Java 바이너리를 사용하십시오.
JAVA_HOME=/opt/ibm/java-i386-60/jre# JAVA_HOME=c:\Java
참고: - server.env 파일은 key=value 쌍만 지원합니다.
- 비어 있는 행과 # 문자로 시작하는 행은 무시됩니다.
- 이스케이프 문자가 없습니다. 모든 문자가 리터럴입니다(백슬래시와 선행 및 후미 공백 포함).
- "=" 부호 주위에 공백이 있으면 안 됩니다.
- 쉘 및 변수 확장기능은 지원되지 않습니다.
- WLP_USER_DIR 변수는 잔여 구성의 위치를 지정하는 것이 목적이므로
${wlp.install.dir}/etc/server.env 파일에서만 이 변수를 지정할 수 있습니다.
일단 잔여 구성을 찾아 병합하였으면 다른 위치의 추가 구성은 필요하지 않거나
지원되지 않습니다.
서버 관리 스크립트는 ${wlp.install.dir}/etc/server.env 및
${server.config.dir}/server.env 두 위치에서
server.env 파일을 검색합니다.
두 파일 모두 존재하는 경우 두 파일의 컨텐츠는 병합됩니다. (서버 레벨 파일의 값이
런타임 레벨 파일의 값보다 우선합니다.)
쉘 환경에서 이 환경 변수를 지정할 수 있지만 server.env 파일이 이 변수에 우선합니다.
- jvm.options 파일을 사용하여 JVM 옵션을 사용자 정의하십시오.
런타임 및 서버 레벨에서
jvm.options 파일을 사용하여
더 많은 서버 시작 옵션을 지정할 수 있습니다(예:
-X 인수).
서버 관리 스크립트를 통해 시작, 실행 및 디버그 조치를 시작할 때 옵션이 적용됩니다.
한 행에 하나의 옵션만 지정하십시오. 예:
# 최대 힙 크기를 1024m로 설정하십시오.
-Xmx1024m
# 시스템 특성을 설정하십시오.
-Dcom.ibm.example.system.property=ExampleValue
# 클래스 로딩에 상세(verbose) 출력을 사용하십시오.
-verbose:class
# Enable verbose garbage collection.
-verbose:gc
# Specify an alternate verbose garbage collection log on IBM Java Virtual Machines only.
-Xverbosegclog:verbosegc.log
# Specify additional verbose garbage collection options on HotSpot Java Virtual Machines only.
-Xloggc:verbosegc.log
-XX:+PrintGCDetails
-XX:+PrintGCTimeStamps
-XX:+PrintHeapAtGC
![[16.0.0.4 이상]](../ng_v16004.gif)
다음 위치에서 다중
jvm.options 파일을 작성할 수 있습니다.
- ${wlp.install.dir}/usr/shared/jvm.options
- ${server.config.dir}/configDropins/defaults/jvm.options
- ${server.config.dir}/jvm.options
- ${server.config.dir}/configDropins/overrides/jvm.options
이러한 파일은 서버 시작 전에
맨 위에서 맨 아래까지 순서대로 병합되고 서버의 JVM 옵션으로 사용됩니다. 해당 파일이 존재하지 않으면
${wlp.install.dir}/etc/jvm.options를 읽습니다.
참고: - 특성 값을 인용 부호 안에 넣지 마십시오.
- 비어 있는 행과 # 문자로 시작하는 행은 무시됩니다.
- 이스케이프 문자가 없습니다. 모든 문자가 리터럴입니다(백슬래시와 선행 및 후미 공백 포함).
- "=" 부호 주위에 공백이 있으면 안 됩니다.
- 쉘 및 변수 확장기능은 지원되지 않습니다.
다음에 수행할 작업
서버 스크립트를 사용하여 Liberty 서버를 시작하는 경우에는 현재 세션의 모든 운영 체제 환경 변수가 사용 가능합니다.
MBean 또는 Admin Center를 사용하여 서버를 시작하는 경우에는 해당 시스템에서 실행 중인 원격 명령에 사용 가능한 환경 변수만 사용할 수 있습니다.