wsadmin 스크립트를 사용하여 wsadmin 스크립트 클라이언트 시작

wsadmin 도구를 사용하여 애플리케이션 서버, 애플리케이션 배치 및 서버 런타임 조작을 구성 및 관리할 수 있습니다.

이 태스크 정보

wsadmin 도구는 스크립트를 실행하여 사용자 환경에 맞는 구성 태스크 자동화 기능을 제공합니다. 그러나 wsadmin 도구 사용에 대해 다음을 포함한 몇 가지 제한사항이 있습니다.
  • wsadmin 도구는 Jython 및 Jacl 스크립트 언어만 지원합니다.

    WebSphere Application Server 버전 6.1 릴리스에서는 wsadmin 도구와 연관된 Jacl 구문으로 폐기 프로세스의 시작을 표시했습니다. wsadmin 도구에 대한 Jacl 구문은 제품에 계속 남아 최소한 주요 제품의 두 릴리스에서 지원됩니다. Jacl 언어 지원은 그 다음에 wsadmin 도구에서 제거될 것입니다. wsadmin 도구의 Jython 구문은 WebSphere Application Server 관리 자동화 전략 방침입니다. 애플리케이션 서버는 제품 자동화 및 Jython 구문 사용을 지원하는 매우 향상된 관리 기능 및 도구를 제공합니다.

    제거된 기능 제거된 기능: Jacl은 더 이상 사용되지 않으며 Jython이 기본 스크립트 언어입니다.depfeat
    유의: 모든 WebSphere® Application Server 컴포넌트 클래스가 동일한 .jar 파일에 패키지되지는 않습니다. wsadmin 도구를 사용하여 Jython 스크립트를 실행하려면 wsadmin 명령에서 jython.package.path 시스템 특성을 포함하여 모든 필수 JAR 파일이 wsadmin 시작 중에 jython 패키지 경로에 설정되도록 하십시오.
    ./wsadmin.sh -lang jython -javaoption
    "-Djython.package.path=/usr/WebSphere70/AppServer/plugins/com.ibm.ws.wlm.jar"   

    runtime.jaradmin.jar 이외의 .jar 파일에 패키지된 서로 다른 WebSphere Application Server 클래스에서 WebSphere Application Server 함수를 호출하려면 jython.package.path 시스템 특성에 지정된 경로에 여러 jar 파일을 포함하고 세미콜론(;)으로 구분할 수 있습니다.

    ./wsadmin.sh -lang jython -javaoption
    "-Djython.package.path=/usr/WebSphere70/AppServer/plugins/com.ibm.ws.wlm.jar;com.ibm.ws.wccm.jar"  

    ws_ant를 사용하여 jython 스크립트에서 WebSphere Application Server 함수를 호출하려면 .prop 텍스트 파일을 작성하고 이 파일에 다음 행을 포함할 수 있습니다.

    jython.package.path=/usr/WebSphere70/AppServer/plugins/com.ibm.ws.wlm.jar  

    그런 다음 ant 스크립트 xml 파일에 특성 파일을 포함하십시오. 예를 들어, 다음과 같습니다.

    <taskdef name="wsadmin" classname="com.ibm.websphere.ant.tasks.WsAdmin"/>
    		<target name="main">
        <wsadmin conntype="NONE" lang="jython" failonerror="true" properties="/tmp/jython.prop"
                 script="/home/fsgapp/MSTWasBuild/project/scripts/socr/socr/jython/configure.py"> 
        			</wsadmin>
    	</target>
  • wsadmin 도구는 제품과 동일한 버전 또는 그 이상의 버전을 실행하는 애플리케이션 서버, 배치 관리자, 관리 에이전트 및 작업 관리자에 대한 설치, 구성, 배치 및 런타임 조작을 관리합니다. wsadmin 도구는 wsadmin 도구보다 이전 버전인 제품 버전을 실행하는 애플리케이션 서버, 배치 관리자, 관리 에이전트 또는 작업 관리자에는 연결할 수 없습니다. 예를 들어, 버전 7.x wsadmin 클라이언트는 버전 6.x 애플리케이션 서버에 연결할 수 없습니다. 그러나 버전 6.x wsadmin 클라이언트는 버전 7.x 애플리케이션 서버에 연결할 수 있습니다. 이러한 제한사항은 새 기능이 각 제품 릴리스에 있는 wsadmin 도구에 추가되었기 때문입니다. 이전 제품 버전을 실행 중인 애플리케이션 서버에서는 새 명령 기능을 사용할 수 없습니다.
  • wsadmin 도구는 혼합 셀 환경의 배치 관리자 노드 레벨에서 작동합니다. 모든 명령 기능을 사용하려면 wsadmin을 애플리케이션 서버 노드 레벨에서 실행하지 마십시오.

[AIX Solaris HP-UX Linux Windows]wsadmin 실행기는 몇몇 스크립트 오브젝트(AdminConfig, AdminControl, AdminApp, AdminTask 및 Help 오브젝트 포함)를 지원합니다. 스크립트는 애플리케이션 관리, 구성, 조작 제어와 제품 프로세스를 실행하는 MBean과의 통신을 위해 이러한 오브젝트를 사용합니다. 스크립트를 사용하여 다른 태스크를 수행하기 전에 wsadmin 스크립트 클라이언트를 시작해야 합니다.

[z/OS]보안이 사용 가능한 wsadmin 도구를 시작하기 전에 WebSphere Application Sever 관리자의 SSL(Secure Socket Layer) 고려사항 주제와 클라이언트 및 서버의 SSL 보안 정의 주제를 검토하십시오.

유연한 관리 환경에서는 wsadmin 도구를 기본 애플리케이션 서버, 배치 관리자, 관리 에이전트 또는 작업 관리자 프로세스에 연결할 수 있습니다. 작업 관리자에 지정된 프로파일 이름이나 기본 애플리케이션 서버의 포트를 지정하지 않은 경우 wsadmin 도구가 자동으로 관리 에이전트에 연결합니다.

유의: 애플리케이션 관리 디자인을 사용하여 EE 스펙 레벨 EAR 또는 클라이언트보다 높은 레벨의 모듈을 설치할 수 없습니다. wsadmin에서 실행되는 클라이언트 코드는 EAR 파일을 읽어 컨텐츠 자체 검사를 사용하여 해당 애플리케이션에 적용 가능한 배치 구성 옵션을 생성합니다. 클라이언트 측 코드는 클라이언트가 지원하는 레벨보다 높은 스펙 레벨을 처리할 수 없습니다.

프로시저

  1. wsadmin 스크립트 클라이언트를 시작하는 명령을 찾으십시오.

    [z/OS]스크립트 프로세스를 호출하기 위한 명령은 app_server_root/bin 디렉토리에 있습니다. wsadmin.sh 파일을 사용하십시오.

    [AIX Solaris HP-UX Linux Windows][IBM i]다음 중 하나를 선택하십시오.
    • 특정 프로파일을 사용하여 스크립트 프로세스를 호출하십시오. 스크립트 프로세스를 호출하기 위한 QShell 명령은 profile_root/bin 디렉토리에 있습니다. QShell 스크립트의 이름은 wsadmin입니다. 이 옵션을 사용하는 경우 -profileName profile_name 매개변수를 지정할 필요가 없습니다.
    • 기본 프로파일을 사용하여 스크립트 프로세스를 호출하십시오. wsadmin Qshell 명령은 app_server_root/bin 디렉토리에 있습니다. 기본 프로파일에 연결하지 않으려면 -profileName profile_name 매개변수를 지정하여 사용할 프로파일을 표시해야 합니다.
  2. 유연한 관리 환경에서, 기본 애플리케이션 서버, 관리 에이전트 또는 작업 관리자 프로세스에 연결할지 여부를 판별하십시오.
    • 관리 에이전트 프로세스에 연결하십시오.
      wsadmin 도구를 서버를 구성, 관리 및 관리할 관리 에이전트에 연결하십시오. 연결 옵션을 지정하지 않으면 wsadmin 도구가 자동으로 관리 에이전트 프로세스에 연결합니다. 다음 명령을 사용하여 관리 에이전트에 연결하십시오.
      wsadmin -lang jython
    • 기본 애플리케이션 서버 프로세스에 연결하십시오.
      wsadmin 도구를 원하는 특정 서버의 설정을 관리할 기본 애플리케이션 서버에 연결하십시오. 한 서버가 포함되어 있으며 관리 에이전트에 등록된 노드에 연결할 때 이 연결 유형을 사용하십시오. 다음과 같은 명령을 사용하여 기본 애플리케이션 서버에 연결하십시오.
      wsadmin -conntype SOAP [-port 4213] -lang jython
    • 작업 관리자 프로세스에 연결하십시오.
      wsadmin 도구를 작업 관리자에 연결하여 관리 작업을 제출, 모니터 및 관리하십시오. 다음과 같은 명령을 사용하여 작업 관리자에 연결하십시오.
      wsadmin -profileName JobMgr01 -lang jython
  3. wsadmin 도구에 대한 추가 연결 옵션을 검토하십시오.
    몇 가지 다른 방식으로 wsadmin 스크립트 클라이언트를 시작할 수 있습니다. 스크립트 실행을 위한 방법을 지정하려면, 다음 wsadmin 도구 옵션 중 하나를 수행하십시오.
    스크립트 명령을 대화식으로 실행합니다.

    -f 또는 -c가 아닌 다른 옵션을 사용하거나 옵션 없이 wsadmin를 실행합니다. wsadmin 도구는 wsadmin 프롬프트와의 대화식 쉘을 시작하고 표시합니다. wsadmin 프롬프트에서, 임의의 Jacl 또는 Jython 명령을 입력하십시오. 또한 AdminControl, AdminApp, AdminConfig, AdminTask 또는 Help wsadmin 오브젝트를 사용하여 명령을 호출할 수도 있습니다.대화식 스크립트 세션을 남기려면 종료 또는 종료 명령을 사용하십시오. 이 명령은 인수를 취하지 않습니다.

    다음 예제는 wsadmin 도구를 실행합니다.
    • Jython을 사용하여 wsadmin 도구 실행:
      [AIX][HP-UX][Linux][Solaris][z/OS]
      wsadmin.sh -lang jython
      [IBM i]
      wsadmin -lang jython
      [Windows]
      wsadmin.bat -lang jython
    • 보안이 사용 가능한 경우, Jython을 사용하여 wsadmin 도구 실행:
      [AIX][HP-UX][Linux][Solaris][z/OS]
      wsadmin.sh -lang jython -user user_name -password password
      [IBM i]
      wsadmin -lang jython -user user_name -password password
      [Windows]
      wsadmin.bat -lang jython -user user_name -password password
    • 옵션 없이 Jacl을 사용하여 wsadmin 도구 실행:
      [AIX][HP-UX][Linux][Solaris][z/OS]
      wsadmin.sh -lang jacl
      [IBM i]
      wsadmin -lang jacl
      [Windows]
      wsadmin.bat -lang jacl
    스크립트 명령을 개별 명령을 실행하십시오.

    -c 옵션과 함께 wsadmin 도구를 실행하십시오.

    [AIX][HP-UX][Linux][Solaris][z/OS]wsadmin -c 옵션을 사용하여 달러 기호 문자($)를 포함하는 명령을 호출하는 경우 명령행은 변수를 대체하려고 합니다. 이러한 문제점을 방지하려면 달러 기호를 백슬래시(\)로 이스케이프하십시오(예: wsadmin -c "\$AdminApp install ...")..

    다음 예제는 명령을 개별적으로 실행합니다.
    • Jython을 사용하여 AdminApp 오브젝트에 대한 list 명령 실행:
      [AIX][HP-UX][Linux][Solaris][z/OS]
      wsadmin.sh -lang jython -c 'AdminApp.list()'
      [IBM i]
      wsadmin -lang jython -c "AdminApp.list()"
      [Windows]
      wsadmin -lang jython -c "AdminApp.list()"
    • Jacl을 사용하여 AdminApp 오브젝트에 대한 list 명령 실행:
      [AIX][HP-UX][Linux][Solaris][z/OS]
      wsadmin.sh -c "\$AdminApp list"
      또는
      wsadmin.sh -c '$AdminApp list'
      [IBM i]
      wsadmin -c "$AdminApp list"
      [Windows]
      wsadmin -c "$AdminApp list"
    스크립트 명령을 스크립트에서 실행하십시오.

    -f 옵션을 갖는 wsadmin 도구를 실행하고 실행하려는 명령을 파일에 넣으십시오.

    [z/OS]WebSphere Application Server for z/OS®는 Jacl 및 Jython 명령 파일을 다중 인코딩하는 과정을 지원합니다. 명령 파일의 기본 인코딩은 ASCII입니다. EBCDIC로 인코딩된 파일을 실행하려면 -javaoption 플래그를 통해 다음 JVM(Java Virtual Machine) 인수를 wsadmin.sh 파일에 추가하십시오.
    -Dscript.encoding=Cp1047
    예를 들어 다음과 같습니다.
    wsadmin.sh -javaoption -Dprofile.encoding=Cp1047
    또는 wsadmin.sh 파일의 두 가지 버전이 있습니다. 하나는 파일의 ASCII 버전을 참조하고 나머지는 파일의 EBCDIC 버전을 참조합니다. 예를 들어 wsadmin.sh 파일을 wsadminE.sh로 복사하십시오. 그런 다음, -Dscript.encoding=Cp1047wsadminE.sh 파일에 추가하십시오.
    다음 예제는 스크립트를 실행합니다.
    • Jython을 사용하여 a1.py 스크립트 실행:
      [AIX][HP-UX][Linux][Solaris][z/OS]
      wsadmin.sh -lang jython -f  al.py
      [IBM i]
      wsadmin -lang jython -f  al.py
      [Windows]
      wsadmin -lang jython -f  al.py

      여기서 a1.py 파일에는 다음 명령이 들어 있습니다.

      apps = AdminApp.list()
      print apps
    스크립트 명령을 프로파일 스크립트에서 실행하십시오.

    프로파일 스크립트는 기본 스크립트 전 또는 대화식 모드에 진입하기 전에 실행하는 스크립트입니다. 프로파일 스크립트를 사용하여 사용자 또는 설치를 위해 사용자 정의된 스크립트 환경을 설정할 수 있습니다.

    [z/OS]WebSphere Application Server for z/OS는 Jacl 및 Jython 프로파일 스크립트를 다중 인코딩하는 과정을 지원합니다. 프로파일 파일의 기본 인코딩은 ASCII입니다. EBCDIC로 인코딩된 프로파일 스크립트 파일을 실행하려면, 다음 JVM(Java Virtual Machine) 인수를 wsadmin.sh 파일에 추가하십시오.
    -Dprofile.encoding=Cp1047
    예를 들어 다음과 같습니다.
    wsadmin.sh -javaoption -Dprofile.encoding=Cp1047
    또는 wsadmin.sh 파일의 두 가지 버전이 있습니다. 하나는 파일의 ASCII 버전을 참조하고 나머지는 파일의 EBCDIC 버전을 참조합니다. 예를 들어 wsadmin.sh 파일을 wsadminE.sh로 복사하십시오. 그런 다음 -Dprofile.encoding=Cp1047wsadminE.sh 파일에 추가하십시오.
    기본적으로 다음 프로파일 스크립트 파일은 app_server_root/properties/wsadmin.properties 파일의 com.ibm.ws.scripting.profiles 프로파일 특성용으로 구성될 수 있습니다.
    • app_server_root/bin/securityProcs.jacl
    • app_server_root/bin/LTPA_LDAPSecurityProcs.jacl

    기본적으로 이 파일은 ASCII로 되어 있습니다. EBCDIC 인코딩된 프로파일 스크립트 파일을 실행하기 위해 profile.encoding 옵션을 사용하는 경우, 파일의 인코딩을 EBCDIC으로 변경하십시오.

    프로파일 스크립트에서 스크립트 명령을 실행하려면 -profile 옵션이 있는 wsadmin 도구를 실행하여 프로파일 스크립트에 실행하려는 명령을 포함시키십시오.

    스크립트 환경을 사용자 정의하려면 실행하려는 하나 이상의 프로파일 스크립트를 지정하십시오.

    프로파일을 작성할 때 노드 이름에 괄호를 사용하지 마십시오.

    다음 예제는 프로파일 스크립트를 실행합니다.
    • Jython을 사용하여 a1prof.py 스크립트 실행:
      [AIX][HP-UX][Linux][Solaris][z/OS]
      wsadmin.sh -lang jython -profile alprof.py
      [IBM i]
      wsadmin -lang jython -profile alprof.py
      [Windows]
      wsadmin.bat -lang jython -profile alprof.py

      여기서 a1prof.py 파일에는 다음 명령이 들어 있습니다.

      apps = AdminApp.list()
      print "Applications currently installed:\n " + apps
    • Jacl을 사용하여 a1prof.py 스크립트 실행:
      [AIX][HP-UX][Linux][Solaris][z/OS]
      wsadmin.sh -profile alprof.jacl
      [IBM i]
      wsadmin -profile alprof.jacl
      [Windows]
      wsadmin.bat -profile alprof.jacl

      여기서 a1prof.py 파일에는 다음 명령이 들어 있습니다.

      set apps [$AdminApp list]
      puts "Applications currently installed:\n$apps"

결과

wsadmin은 서버 프로세스에 연결되면 다음 출력을 리턴합니다.

Jython 출력 예제:
Applications currently installed:
 DefaultApplication
ivtApp
query
WASX70311: For help, enter: "print Help.help()"
wsadmin>
Jacl 출력 예제:
Applications currently installed:
 DefaultApplication
ivtApp
query
WASX70311: For help, enter: "$Help help"
wsadmin>
[z/OS]다음 메시지가 수신되면
[ Unable to allocate an initial java heap of 268435456 bytes. ]
[ **Out of memory, aborting** ]
[ *** panic: JVMST016: Cannot allocate memory for initial java heap ]
CEE5207E The signal SIGABRT was received.
로그인의 영역 크기가 wsadmin이 시작할 때 작성되는 JVM(Java Virtual Machine)에 지정된 최소 힙 크기(-Xms)를 할당할 정도로 크지 않아서 wsadmin 스크립트 클라이언트를 시작할 수 없는 것입니다. wsadmin.sh 파일문 PERF_JVM_OPTIONS="-Xms256m -Xmx256m에 지정된 -Xms 옵션의 기본값은 256MB입니다. 이 문제를 정정하려면 TSO에서 로그아웃한 후 다시 TSO에 로그인할 때 로그인 화면의 Size 매개변수 값을 늘려 보십시오. 로그인 화면에서 Size 매개변수의 값을 늘릴 수 없는 경우에는 이 매개변수의 값을 늘리지 못하게 하는 IEFUSI가 존재하는지 확인하십시오.

[z/OS]Telnet에 의해 OMVS에 로그인 중인 경우 로그인 시 수신하는 주소 공간 크기를 판별하는 데 사용된 값이 BPXPRMxx parmlib 멤버에 지정됩니다. BPXPRMxx는 z/OS UNIX의 완전한 환경을 제어합니다. 따라서 MAXASSIZE 매개변수에 설정된 값이 주소 공간의 크기를 판별합니다. 그러나 RACF를 사용 중이면 개별 사용자에 대해 각 RACF OMVS 세그먼트에 주소 크기가 설정될 수도 있습니다. 이 경우에는 ASSIZEMAX 매개변수에 지정된 값(바이트)이 해당 사용자의 주소 공간 크기 한계를 나타냅니다. 예를 들어 ASSIZEMAX=0268435456 설정은 사용자에게 할당된 주소 공간이 256MB임을 나타냅니다.


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



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