
z/OS에서 Liberty 관리
z/OS® 플랫폼에서 MVS™ 운영자 명령을 사용하여 Liberty를 시작, 중지 또는 수정할 수 있습니다.
시작하기 전에
다음 보안 프로파일이 z/OS용 Liberty에서 z/OS 권한 부여 서비스 사용에서 설명된 대로
설정되었는지 확인하십시오.
- 서버 프로세스 및 엔젤 프로세스를 위한 STARTED 프로파일
- 권한 부여된 z/OS 서비스에 대한 액세스 허용을 위한 SERVER 프로파일
![[16.0.0.4 and later]](../ng_v16004plus.gif)
각각의 LPAR에는 하나의 기본 엔젤 프로세스가 있을 수 있습니다. 엔젤이 V16.0.0.4 이상에서 시작된 경우에는 엔젤에 이름을 부여할 수 있습니다. 해당 엔젤은 해당 LPAR에서 추가 엔젤 프로세스가 될 수 있습니다. 엔젤 및 LPAR에 대한 자세한 정보는 이름 지정된 엔젤의 내용을 참조하십시오. 가급적이면, 기본 엔젤 프로세스가 LPAR에서 Liberty의 최신 설치 레벨에서 실행 중인지 확인하십시오. Liberty 서버 인스턴스가 이전 서비스 레벨에서 실행 중인 엔젤에 연결된 경우에는 서버의 일부 기능을 사용하지 못할 수 있습니다.
이 태스크 정보
이 주제에는 MVS 콘솔을 사용하여 Liberty를 시작, 수정 및 중지하는 방법이 설명되어 있습니다. 또한 쉘에서 서버를 시작하고 중지하거나 쉘을 사용하여 서버를 시작 태스크로 시작할 수 있습니다. 명령행에서 서버 시작 및 중지의 내용을 참조하십시오.
시작 태스크는 운영자 START
명령에 응답으로 즉시 실행되는 JCL입니다. 두 JCL 프로시저
템플리트(PROCs)는 wlp/templates/zos/procs 디렉토리에서 사용 가능합니다.
하나의 템플리트는
서버 프로세스를 위해, 또 다른 하나는 엔젤 프로세스를 위한 것입니다.
- Liberty의 bbgzsrv.
- z/OS 플랫폼의 시스템 권한 부여된 서비스에 대한 액세스를 제어하는데 필요한 엔젤 프로세스를 위한 bbgzangl.
참고: 제품 업데이트가 적용될 때
/templates 디렉토리의 파일이 수정될 수 있습니다.
예제 섹션에서
두 PROC 템플리트에 대한 더 자세한 정보를 제공합니다. 연산자 STOP 명령의 대상은 작업 또는 시작 태스크입니다.
JCL 프로시저 템플리트가 사용자 정의된 후, 시스템 프로시저 라이브러리 병합에 배치되어야 합니다. 프로시저 구성원의 이름은 START 명령에 대한 인수가 됩니다.
프로시저
예
다음 예제는 서버 프로세스(bbgzsrv)에 대한 프로시저 템플리트를 보여줍니다. 이 PROC는 z/OS proclib 병합의 데이터 세트에 있습니다.
//BBGZSRV PROC PARMS='defaultServer'
//*------------------------------------------------------------------
//* INSTDIR - the path to the WebSphere Liberty install.
//* This path is used to find the product code and is
//* equivalent to the WLP_INSTALL_DIR environment variable
//* in the Unix shell.
//* USERDIR - the path to the WebSphere Liberty user area.
//* This path is used to store shared and server specific
//* configuration information and is equivalent to the
//* WLP_USER_DIR environment variable in the Unix shell.
//*------------------------------------------------------------------
// SET INSTDIR='/u/MSTONE1/wlp'
// SET USERDIR='/u/MSTONE1/wlp/usr'
//*------------------------------------------------------------------
//* Start the Liberty server
//*
//* WLPUDIR - PATH DD that points to Liberty's "user"
//* directory. If the DD is not allocated, the user
//* directory location defaults to the wlp/usr directory
//* in the install tree.
//* STDOUT - Destination for stdout (System.out)
//* STDERR - Destination for stderr (System.err)
//* MSGLOG - Destination for messages.log (optional)
//* STDENV - Initial Unix environment - read by the system. The
//* installation default and server specific server
//* environment files will be merged into this environment
//* before the JVM is launched.
//*------------------------------------------------------------------
//STEP1 EXEC PGM=BPXBATSL,REGION=0M,
// PARM='PGM &INSTDIR./lib/native/zos/s390x/bbgzsrv &PARMS'
//WLPUDIR DD PATH='&USERDIR.'
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
//*MSGLOG DD SYSOUT=*
//*STDENV DD PATH='/etc/system.env',PATHOPTS=(ORDONLY)
//*STDOUT DD PATH='&ROOT/std.out',
//* PATHOPTS=(OWRONLY,OCREAT,OTRUNC),
//* PATHMODE=SIRWXU
//*STDERR DD PATH='&ROOT/std.err',
//* PATHOPTS=(OWRONLY,OCREAT,OTRUNC),
//* PATHMODE=SIRWXU
참고:
- 실행기는 STDENV DD를 초기 환경으로 사용하지만 이 DD는 선택사항입니다. 프로세스에 대한 초기 환경이 PROC에 정의됩니다. Language Environment®에서 지원하는 임의의 데이터 세트 유형을 지시할 수 있지만 형식은 예상 형식과 호환 가능해야 합니다. 예를 들어 EBCDIC(Extended Binary Coded Decimal Interchange Code)의 경우 확장이 없는 단순 키=값입니다.
- 기존 디렉토리(파일이 아님)를 가리키는 PATH DD가 허용됩니다. 해당 DD가 열리면, 리턴되는 FILE 스트림은 fldata에 유효하므로 DD와 연관된 HFS 경로를 사용할 수 있습니다. PROC 템플리트는 WLP_USER_DIR과 동등함을 표시하는 WLPUDIR PATH DD를 정의합니다.
- WLP_USER_DIR은 다음 로직으로 판별됩니다.
- WLPUDIR DD가 정의되어 있는 경우 연관된 경로가 WLP_USER_DIR로 사용됩니다.
- WLPUDIR이 정의되어 있지 않지만 초기 환경(STDENV의)에 WLP_USER_DIR이 설정되어 있는 경우 이를 사용합니다.
- WLPUDIR이 정의되어 있지 않고 초기 환경에 WLP_USER_DIR이 설정되어 있지 않은 경우 기본값인 $WLP_INSTALL_DIR/usr이 사용됩니다.
- 환경은 다음 로직으로 판별됩니다.
- STDENV DD를 정의하는 경우 언어 환경에서 해당 항목을 초기 환경으로 읽어들입니다.
- $WLP_INSTALL_DIR/etc/server.env가 존재하고 읽기 가능한 경우, key=value 컨텐츠를 읽으며 환경으로 설정합니다. 파일은 ASCII 또는 EBCDIC일 수 있습니다. 주석은 파운드 기호(#)로 시작하며 해당 행의 끝까지입니다. 공백을 포함하는 값을 큰따옴표 안에 배치할 수 있습니다. 이 파일에 지정된 환경 항목이 초기 환경의 항목을 대체합니다.
- $WLP_USER_DIR/servers/{serverName}/server.env가 존재하고 읽기 가능한 경우 해당 key=value 컨텐츠를 읽고 환경에 설정합니다. 이 파일은 ASCII 또는 EBCDIC일 수도 있으며 주석을 지원합니다. 여기서 지정되는 항목은 초기 환경 및 etc/server.env의 항목을 대체합니다.
- 사용자 지정 환경에 상관없이, _BPXK_WLM_PROPAGATE=NO, JAVA_THREAD_MODEL=HEAVY 및 JAVA_PROPAGATE=NO 항목이 명시적으로 설정됩니다. _EDC_PTHREAD_YIELD가 설정되지 않은 경우 -2로 설정됩니다.
- 환경이 설정된 후, JAVA_HOME이 다음 로직에 의해
판별됩니다.
- 환경에 JAVA_HOME이 설정되어 있는 경우 해당 위치가 JAVA_HOME으로 사용됩니다.
- 환경에 JAVA_HOME이 설정되어 있지 않지만 $WLP_INSTALL_DIR/../java64가 존재하는 경우 $WLP_INSTALL_DIR/../java64가 JAVA_HOME으로 사용됩니다.
- 환경에 JAVA_HOME이 설정되어 있지 않고 $WLP_INSTALL_DIR/../java64가 존재하지 않는 경우 $WLP_INSTALL_DIR/../java가 JAVA_HOME으로 사용됩니다.
- JAVA_HOME이 판별된 후 JVM 명령행 옵션은 다음 로직을 사용하여 판별됩니다.
- $WLP_USER_DIR/servers/{serverName}/jvm.options가 존재하고 읽기 가능한 경우 해당 컨텐츠를 읽습니다. 파일은 ASCII 또는 EBCDIC일 수 있으며 파일의 각 행이 단일 java 명령행 인수여야 합니다. 주석은 파운드 기호(#)로 시작하며 해당 행의 끝까지입니다.
- $WLP_USER_DIR/servers/{serverName}/jvm.options가 존재하지 않지만 $WLP_INSTALL_DIR/etc/jvm.options가 존재하고 읽기 가능한 경우 해당 컨텐츠를 읽습니다. 파일이 ASCII 또는 EBCDIC에 있을 수 있으며 행당 하나의 java 명령행 인수가 있어야 합니다. 주석이 지원됩니다.
- jvm.options의 컨텐츠와 관계 없이 -Dfile.encoding=iso8859-1, -javaagent:$WLP_INSTALL_DIR/lib/bootstrap-agent.jar 및 -classpath $WLP_INSTALL_DIR/lib/server-launcher.jar이 명령행에 있습니다.
- JVM에 인수를 전달하려면 Java™ 명령행 인수를 이
DD에서 읽도록 JAVAOPTS DD 명령문을 정의하십시오.
다음 예제는 샘플 입력 파일을 나타냅니다.
-Xmx512m -Xms256m -Daaa.bbb.ccc=something.forsomeone
- z/OS 프로시저를 사용하여 Liberty
서버를 시작하는 경우 서버 프로세스에서 사용하는 umask를 사용자
정의할 수 있습니다. umask를 사용자 정의하려면 다음 방법 중 하나를 사용하여
WLP_SKIP_UMASK 및 _BPX_BATCH_UMASK 환경 변수를 정의하십시오.
- WLP_SKIP_UMASK 환경 변수를 지정하십시오. server.env 파일에서
이 변수를 지정하거나 z/OS 프로시저를 사용하여 서버를 시작하는 경우 STDENDV DD 항목 아래에 변수를 지정할 수 있습니다. z/OS
프로시저의 경우 STDENV DD 항목 아래에 _BPX_BATCH_UMASK
변수를 지정하십시오. server.env 파일에는 _BPX_BATCH_UMASK
변수를 지정할 수 없습니다. 다음 예제는 샘플 umask 값 사용자 정의를 보여줍니다.
//STDENV DD * _BPX_BATCH_UMASK=XXXX WLP_SKIP_UMASK=TRUE /*
- EBCDIC으로 인코딩된 z/OS
UNIX 파일에 _BPX_BATCH_UMASK=XXXX 및 WLP_SKIP_UMASK=TRUE를
모두 지정하십시오. z/OS 프로시저의 경우
STDENV DD 항목 아래에 경로를 정의하십시오. 다음 예제는 샘플 umask 값 사용자 정의를
보여줍니다.
//STDENV DD PATH='u/path/to/env/ebcdic/file',PATHOPTS=ORDONLY
- WLP_SKIP_UMASK 환경 변수를 지정하십시오. server.env 파일에서
이 변수를 지정하거나 z/OS 프로시저를 사용하여 서버를 시작하는 경우 STDENDV DD 항목 아래에 변수를 지정할 수 있습니다. z/OS
프로시저의 경우 STDENV DD 항목 아래에 _BPX_BATCH_UMASK
변수를 지정하십시오. server.env 파일에는 _BPX_BATCH_UMASK
변수를 지정할 수 없습니다. 다음 예제는 샘플 umask 값 사용자 정의를 보여줍니다.
다음 예제는 구성된 "defaultServer"에 대해 샘플 bbgzsrv proc를 사용하여 Liberty를 시작하는 데 사용하는 명령을 표시합니다.
start bbgzsrv,parms='defaultServer'
다음 예제는 엔젤 프로세스(bbgzangl)에 대한 프로시저 템플리트를 보여줍니다. ![[16.0.0.4 and later]](../ng_v16004plus.gif)
![[16.0.0.4 and later]](../ng_v16004plus.gif)
//BBGZANGL PROC PARMS='',COLD=N,NAME=''
//*------------------------------------------------------------------
// SET ROOT='/u/MSTONE1/wlp'
//*------------------------------------------------------------------
//* Start the Liberty angel process
//*------------------------------------------------------------------
//STEP1 EXEC PGM=BPXBATA2,REGION=0M,TIME=NOLIMIT,
// PARM='PGM &ROOT./lib/native/zos/s390x/bbgzangl COLD=&COLD NAME=X
// &NAME &PARMS'
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*