관리 씬 클라이언트 사용

관리 씬 클라이언트를 사용하여 몇몇 Java™ 아카이브(JAR) 파일만으로 wsadmin 도구나 독립형 관리 Java 프로그램을 실행할 수 있습니다. 그러면 wsadmin 도구를 시작하는 데 걸리는 시간이 줄어들고 성능이 향상됩니다. 이 정보는 JMX 클라이언트 프로그램 설정을 위한 것입니다.

시작하기 전에

IBM® SDK(Software Development Kit)가 관리 씬 클라이언트에 설치되어 있는지 확인하십시오. 관리 씬 클라이언트 환경에서 연결하는 서버와 동일한 IBM SDK를 사용할 것을 권장합니다.
중요사항: 관리 씬 클라이언트는 IBM SDK에 대해 지원됩니다. 또한 다음 경우에 주 버전이 동일한 대응되는 Oracle JDK(Java Development Kit)에 대해서도 지원됩니다.
  • 클라이언트 관리 애플리케이션은 SOAP 커넥터만 사용합니다.
  • 클라이언트 관리 애플리케이션은 com.ibm.websphere.management.AdminClientFactory API를 사용하여 JMX 클라이언트를 가져옵니다.
주의: -conntype NONE 옵션과 함께 씬 관리 클라이언트를 실행할 수 없습니다.

이 태스크 정보

관리 씬 클라이언트를 사용하여 기능팩을 관리할 수 없으며, 기능팩에 한정된 애플리케이션 아티팩트를 배치할 수 없습니다.

관리 씬 클라이언트는 SAR(SIP Application Archive) 파일 설치 또는 외부 JACC(Java Authorization Contract for Containers) 제공자를 사용하는 애플리케이션(예: Tivoli® Access Manager)의 편집을 지원하지 않습니다.

관리 씬 클라이언트는 Kerberos 토큰을 서버에 전달하는 작업을 지원하지 않습니다. 대신, 사용자 ID 및 비밀번호를 전달하는 기본 인증만 지원합니다.

관리 씬 클라이언트는 기타 씬 클라이언트와의 공존을 지원하지 않습니다.

z/OS® 플랫폼의 관리 씬 클라이언트는 localcomm을 사용하지 않습니다.

관리 씬 클라이언트의 추적 및 로깅 정보는 클라이언트 및 독립형 애플리케이션에서 추적 사용 가능을 참조하십시오.

프로시저

  1. WebSphere® Application Server 환경에서 WebSphere Application Server 외부의 환경으로 com.ibm.ws.admin.clientXXX.jar을 복사하여 관리 씬 클라이언트 JAR 파일을 사용 가능하게 설정하십시오(예: c:\MyThinClient). com.ibm.ws.admin.client_9.0.jarcom.ibm.ws.admin.client.forJython21_9.0.jar 관리 씬 클라이언트 JAR 파일은 다음 위치 중 하나에 있습니다.
    • AppServer/runtimes 디렉토리.
    • AppClient/runtimes 디렉토리. 애플리케이션 클라이언트를 설치할 때 관리 씬 클라이언트를 선택적으로 선택한 경우.

    com.ibm.ws.admin.client_9.0.jar은 jython27에 사용되어야 하고 com.ibm.ws.admin.client.forJython21_9.0.jar은 jython21에 사용되어야 합니다.

    참고: 버전 9에서는 wsadmin이 기본적으로 jython27을 사용합니다. Jython21은 아직 지원되며 jython21을 사용하려면 wsadmin 인수 -usejython21 true를 사용하거나 wsadmin.properties 파일에서 com.ibm.ws.scripting.usejython21=true를 업데이트해야 합니다.
    문제점 방지 문제점 방지: 오류가 표시되고 있고 jython이 로드되지 않는 경우, jython21을 사용 중이지만 클래스 경로를 com.ibm.ws.admin.client_9.0.jar로 설정하거나 jython27을 사용 중이지만 java 클래스 경로를 com.ibm.ws.admin.client.forJython21_9.0.jar로 설정하는 등의 잘못 구성된 것이 있습니다. Java 클래스 경로를 올바른 jar로 설정하고 있는지 확인하십시오. Jython27은 Java7 이하를 지원하지 않습니다. 연결하려고 시도 중인 WebSphere 서버와 동일한 Java 레벨을 사용해야 합니다. gotcha
  2. 관리 클라이언트 프로그램을 컴파일하고 테스트하려면 관리 씬 클라이언트 JAR 파일을 사용하십시오. Java 애플리케이션의 경우 표준 Java 2 플랫폼, Standard Edition 환경 내에서 JAR 파일을 컴파일하고 실행할 수 있습니다. 자세한 정보는 Compiling an administration application using the Thin Administration Client 주제를 참조하십시오.
  3. app_server_root/properties 디렉토리에서 C:\MyThinClient\properties 디렉토리로 메시지 디렉토리를 복사하십시오.
  4. 보안이 설정된 경우에는 다음 파일도 필요합니다.
    • com.ibm.ws.security.crypto.jar 파일을 AppServer/plugins 디렉토리 또는 AppClient/plugins 디렉토리에서 C:\MyThinClient 디렉토리로 복사하십시오.
    • IPC 커넥터를 사용 중인 경우, 선택적으로 ipc.client.props 파일을 AppServer\profiles\profileName/properties 또는 AppClient\properties 디렉토리에서 C:\MyThinClient\properties 디렉토리로 복사하십시오. 또는 ipc.client.props 파일의 특성을 Java 코드에 프로그래밍 방식으로 설정할 수 있습니다.
    • SOAP 커넥터를 사용 중인 경우, 선택적으로 soap.client.props 파일을 AppServer\profiles\profileName\properties 디렉토리에서 C:\MyThinClient\properties 디렉토리로 복사하십시오. 그런 다음, com.ibm.CORBA.securityEnabled 특성을 true로 설정하여 클라이언트 보안을 사용 가능으로 설정하십시오. 또는 soap.client.props 파일의 특성을 Java 코드에 설정할 수 있습니다.
    • RMI 또는 JSR160RMI 커넥터를 사용 중인 경우, sas.client.props 파일을 AppServer/profiles/profileName/properties 디렉토리에서 C:\MyThinClient\properties 디렉토리로 복사하십시오.

      설치에 방화벽이 있고 애플리케이션 클라이언트가 RMI를 사용하여 알림을 수신하는 경우 애플리케이션을 배치하려고 시도한 후에 RemoteException 오류가 발생할 수 있습니다. RMI를 포함하는 알림 리스너는 알림을 청취하는 클라이언트에 리스너 포트가 필요하므로 방화벽에서 작동하지 않습니다. 서버가 클라이언트 포트로 알림을 다시 전송하려고 할 때 이 리스너 포트에는 직접 액세스할 수 없습니다. RMI 대신, 알림에 대해 폴링하는 SOAP 커넥터를 사용하십시오.

    • wsjaas_client.conf 파일을 AppServer\profiles\profileName/properties 디렉토리 또는 AppClient/properties 디렉토리에서 C:\MyThinClient\properties 디렉토리로 복사하십시오.
    • ssl.client.props 파일을 AppServer\profiles\profileName/properties 디렉토리 또는 AppClient/properties 디렉토리에서 복사하거나 생성하여 C:\MyThinClient\properties 디렉토리에 저장하십시오.
      주의: 이 파일은 user.root 특성을 포함합니다. 이 값을 씬 클라이언트 디렉토리로 수정해야 합니다(예: C:\MyThinClient).
    • IBM SDK를 사용하는 경우 AppServer\profiles\profileName\etc 디렉토리에서 key.p12trust.p12 파일을 복사하고 C:\MyThinClient\etc 디렉토리에 배치하십시오. 이 태스크를 완료하려면 파일을 씬 클라이언트 디렉토리에 복사하거나 스크립트를 실행하여 파일을 생성하십시오. 자세한 정보는 다음 주제를 참조하십시오.
      • ssl.client.props 클라이언트 구성 파일
      • 이전 제품 버전과의 상호 운용
      • retrieveSigners 명령
      • SSL의 클라이언트 서명자 검색을 위한 보안 설치
    • Sun JDK를 사용 중인 경우에는 ssl.client.props 파일의 다음 특성을 변경하여 키 및 신뢰 관리자의 JKS 키와 신뢰 저장소 및 Sun Microsystems 구현이 파일에 사용되도록 하십시오.
      com.ibm.ssl.alias=DefaultSSLSettings
      com.ibm.ssl.protocol=SSL
      com.ibm.ssl.securityLevel=HIGH
      com.ibm.ssl.trustManager=SunX509
      com.ibm.ssl.keyManager=SunX509
      com.ibm.ssl.contextProvider=SunJSSE
      com.ibm.ssl.enableSignerExchangePrompt=gui
      
      # Keystore information
      com.ibm.ssl.keyStoreName=ClientDefaultKeyStore
      com.ibm.ssl.keyStore=${user.root}/etc/keystore.jks
      com.ibm.ssl.keyStorePassword=keystore_password
      com.ibm.ssl.keyStoreType=JKS
      com.ibm.ssl.keyStoreProvider=SUN
      com.ibm.ssl.keyStoreFileBased=true
      
      # Truststore information
      com.ibm.ssl.trustStoreName=ClientDefaultTrustStore
      com.ibm.ssl.trustStore=${user.root}/etc/truststore.jks
      com.ibm.ssl.trustStorePassword=truststore_password
      com.ibm.ssl.trustStoreType=JKScom.ibm.ssl.trustStoreProvider=SUN
      com.ibm.ssl.trustStoreFileBased=true
  5. 관리 씬 클라이언트를 실행하거나 Java 2 Platform, Standard Edition 환경에서 wsadmin 도구를 실행하십시오. 관리 애플리케이션을 실행하려면 다음 샘플 실행 스크립트를 사용하십시오.
    참고: Oracle JDK를 사용하는 경우 com.ibm.websphere.thinclient JVM 특성을 true로 설정하십시오.
    [Windows]
    set WAS_HOME=c:\MyThinClient 
    set USER_INSTALL_ROOT=%WAS_HOME% 
    set JAVA_HOME=location_of_the_JRE_file 
    
    REM C_PATH is the class path. Add to it as needed. 
    REM Classpath to use for jython27 (comment this out if using jython21)
    set C_PATH=%WAS_HOME%\com.ibm.ws.admin.client_9.0.jar;%WAS_HOME%\com.ibm.ws.security.crypto.jar 
    
    REM Classpath to use for jython21 (uncomment this to use jython21)
    REM set C_PATH=%WAS_HOME%\com.ibm.ws.admin.client.forJython21_9.0.jar;%WAS_HOME%\com.ibm.ws.security.crypto.jar 
    
    set SOAPURL=-Dcom.ibm.SOAP.ConfigURL=%WAS_HOME%\properties\soap.client.props 
    set TC=-Dcom.ibm.websphere.thinclient=true
    
    if exist %JAVA_HOME%\bin\java.exe ( 
           set JAVA_EXE=%JAVA_HOME%\bin\java 
    ) else ( 
           set JAVA_EXE=%JAVA_HOME%\jre\bin\java 
    ) 
    
    %JAVA_EXE% -classpath "%C_PATH%" %TC% -Duser.install.root=%USER_INSTALL_ROOT% -Dcom.ibm.SSL.ConfigURL=file %WAS_HOME%/properties/ssl.client.props %SOAPURL% your_class_file#
    [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
    !/bin/bash 
    WAS_HOME=/MyThinClient 
    USER_INSTALL_ROOT=${WAS_HOME}
    JAVA_HOME=location_of_the_JRE_file
    
    # C_PATH is the class path.  Add to it as needed. 
    # Classpath to use for jython27 (comment this out if using jython21)
    C_PATH=${WAS_HOME}/com.ibm.ws.admin.client_9.0.jar:${WAS_HOME}/com.ibm.ws.security.crypto.jar 
    
    # Classpath to use for jython27 (comment this out if using jython27)
    C_PATH=${WAS_HOME}/com.ibm.ws.admin.client.forJython21_9.0.jar:${WAS_HOME}/com.ibm.ws.security.crypto.jar 
    
    SOAPURL=-Dcom.ibm.SOAP.ConfigURL=${WAS_HOME}/properties/soap.client.props 
    TC=-Dcom.ibm.websphere.thinclient=true
    
    if [[ -f ${JAVA_HOME}/bin/java ]]; then
           JAVA_EXE="${JAVA_HOME}/bin/java"
    else
           JAVA_EXE="${JAVA_HOME}/jre/bin/java"
    fi
    
    ${JAVA_EXE} -classpath "${C_PATH}" $TC -Duser.install.root=${USER_INSTALL_ROOT} -Dcom.ibm.SSL.ConfigURL=file:${WAS_HOME}/properties/ssl.client.props ${SOAPURL} your_class_file

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



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