z/OS 플랫폼용

z/OS에서 Liberty 관리

z/OS® 플랫폼에서 MVS™ 운영자 명령을 사용하여 Liberty를 시작하거나 중지하거나 수정할 수 있습니다.

시작하기 전에

다음 보안 프로파일이 z/OS용 Liberty에서 z/OS 권한 부여 서비스 사용 설정에서 설명된 대로 설정되었는지 확인하십시오.
  • 서버 프로세스 및 엔젤 프로세스를 위한 STARTED 프로파일
  • 권한 부여된 z/OS 서비스에 대한 액세스 허용을 위한 SERVER 프로파일
주의: 각각의 LPAR에는 하나의 엔젤 프로세스가 있습니다. 서비스 레벨 8.5.5.2 이상에서 시작된 엔젤은 역시 서비스 레벨 8.5.5.2 이상에서 엔젤을 사용하는 다른 z/OS용 Liberty 서버와 공존할 수 있습니다. 엔젤 프로세스가 필요한 8.5.5.2 전후 서비스 레벨의 동일한 LPAR에서 여러 z/OS용 Liberty 서버가 실행 중인 경우 엔젤 프로세스를 올바르게 수행하려면 8.5.5.2 이상의 엔젤을 먼저 시작해야 합니다.

이 태스크 정보

이 주제는 MVS 콘솔을 사용하여 Liberty를 시작하고, 수정하고 중지하는 방법을 설명합니다. 또한 쉘에서 서버를 시작하고 중지하거나 쉘을 사용하여 서버를 시작된 태스크로 시작할 수 있습니다. 명령행에서 서버 시작 및 중지의 내용을 참조하십시오.

시작된 태스크는 운영자 START 명령에 응답으로 즉시 실행되는 JCL입니다. 두 JCL 프로시저 템플리트(PROCs)는 wlp/templates/zos/procs 디렉토리에서 사용 가능합니다. 하나의 템플리트는 서버 프로세스를 위해, 또 다른 하나는 엔젤 프로세스를 위한 것입니다.
  • Liberty의 bbgzsrv.
  • z/OS 플랫폼의 시스템 권한 부여된 서비스에 대한 액세스를 제어하는데 필요한 엔젤 프로세스를 위한 bbgzangl
관리자는 템플리트를 사용자 위치로 복사한 후, MVS 콘솔로부터 Liberty 서버를 시작하도록 사용자 정의할 수 있습니다.
참고: 제품 업데이트가 적용될 때 /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에 정의됩니다. LE가 지원하는 데이터 세트의 임의의 유형을 가리킬 수 있지만, 형식은 예상대로 호환 가능해야 합니다. (예: EBCDIC, 단순 키=확장 기능이 없는 값)
  • 기존 디렉토리(파일이 아님)를 가리키는 PATH DD가 허용됩니다. 해당 DD가 열리면, 리턴되는 FILE 스트림은 fldata에 유효하므로 DD와 연관된 HFS 경로를 사용할 수 있습니다. PROC 템플리트는 WLP_USER_DIR과 동등함을 표시하는 WLPUDIR PATH DD를 정의합니다.
  • WLP_USER_DIR은 다음 로직으로 판별됩니다.
    • WLPUDIR DD가 정의된 경우, 연관된 경로가 WLP_USER_DIR로 사용됩니다.
    • WLPUDIR이 정의되어 있지 않지만 WLP_USER_DIR이 초기 환경(STDENV로부터)에 설정된 경우 이를 사용합니다.
    • WLPUDIR이 정의되어 있지 않고 WLP_USER_DIR이 초기 환경에서 설정되어 있지 않은 경우에는 기본값인 $WLP_INSTALL_DIR/usr이 사용됩니다.
  • 환경은 다음 로직으로 판별됩니다.
    • STDENV DD가 정의되어 있면 LE가 이를 초기 환경으로 읽습니다. _BPX_BATCH_UMASK 환경 변수를 설정하려면 여기 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
  • Liberty 서버가 proc로부터 시작되는 경우 서버는 umask 000으로 실행되지 않는지 유효성 검증합니다. umask가 000임을 발견하면, 022의 값으로 이를 대체합니다.
다음 예는 구성된 "defaultServer"에 샘플 bbgzsrv proc를 사용해 Liberty를 시작할 때 사용할 명령을 표시합니다.
start bbgzsrv,parms='defaultServer' 
다음 예제는 엔젤 프로세스(bbgzangl)에 대한 프로시저 템플리트를 보여 줍니다.
//BBGZANGL PROC PARMS='',COLD=N                                       
//*------------------------------------------------------------------
//  SET ROOT='/u/MSTONE1/wlp'
//*------------------------------------------------------------------
//* Start the Liberty angel process                                   
//*------------------------------------------------------------------
//STEP1   EXEC PGM=BPXBATA2,REGION=0M,                                
//  PARM='PGM &ROOT./lib/native/zos/s390x/bbgzangl COLD=&COLD &PARMS' 
//STDOUT   DD SYSOUT=*                                                
//STDERR    DD SYSOUT=*                                               

주제의 유형을 표시하는 아이콘 태스크 주제



시간소인 아이콘 마지막 업데이트 날짜: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_admin_zos
파일 이름: twlp_admin_zos.html