읽기 전용 파일 시스템에서 제품 2진 파일과 공유 자원의 배치를 지원할 수 있도록 특정 변수를 사용하여
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가 서버 명령에서 디버그 모드로 실행될 때는
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 and later]](../ng_v16004plus.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를 사용하여 서버를 시작하는 경우,
유일하게 사용 가능한 환경 변수는 해당 시스템에서 실행 중인 원격 명령에 사용 가능한 해당 변수입니다.