launchClient 도구

WebSphere® Application Server에 대해 launchClient 도구에 대해 Java™ Platform, Enterprise Edition(Java EE ) 명령행 구문을 사용할 수 있습니다.

WebSphere Application Server Network Deployment 환경의 노드에서 launchClient 명령을 사용할 수 있습니다. 그러나 배치 관리자에서 launchClient 명령을 사용하려고 시도하지 마십시오.

중요: 특정 프로파일에서 명령을 실행하는 모든 사용자는 동일한 프로파일을 사용하는 다른 사용자가 작성한 파일을 수정할 수 있는 권한이 있어야 합니다. 그렇지 않으면, 로그 파일에 권한 거부 오류가 표시될 수 있습니다. 이 문제를 피하려면 다음 정책 중 하나를 고려하십시오.
  • [AIX Solaris HP-UX Linux Windows][IBM i]고유 사용자 권한에 대해 특정 프로파일 사용
  • [z/OS]개별 사용자 권한에 별도의 설치 사용
  • 주어진 프로파일에서 실행되는 모든 명령에 항상 동일한 사용자 사용
  • 특정 프로파일의 모든 사용자가 동일한 그룹에 속하는지 확인하십시오. 또한 그룹의 각 사용자가 동일한 프로파일의 다른 멤버가 작성한 파일에 대한 읽기 및 쓰기 권한을 갖는지 확인하십시오.

다음 예제는 the launchClient 도구의 명령행 호출 구문을 보여줍니다.

launchClient [-profileName pName | -JVMOptions options | -help | -?] userapp [-CCname=value] [app args]
여기서,
  • userapp은 애플리케이션 클라이언트를 포함한 EAR 파일의 이름 및 경로입니다.
  • -CCname=value는 클라이언트 컨테이너 이름-값 쌍 매개변수입니다. 지원되는 이름-값 쌍 인수에 대해서는 클라이언트 컨테이너 매개변수 섹션을 참조하십시오.
  • app args는 애플리케이션 클라이언트에 전달하는 인수입니다.
  • -profileName은 다중 프로파일 설치에서 Application Server 프로세스의 프로파일을 정의합니다. 단일 프로파일 환경이나 Application Clients 설치에서 실행하기 위해서는 -profileName 옵션이 필요하지 않습니다.

    [AIX Solaris HP-UX Linux Windows][z/OS]기본값은 default_profile입니다.

  • -JVMOptions는 -cp 또는 -classpath를 제외한 유효한 Java 표준 또는 비표준 옵션 문자열입니다. 문자열을 따옴표로 묶으십시오.
  • -help, -?는 사용 정보를 인쇄합니다.

첫 번째 매개변수는 -help, -?이거나, 매개변수가 포함되면 안됩니다. -profileName pName 및 -JVMOptions 옵션은 선택적 매개변수입니다. 사용되는 경우, <userapp> 매개변수 앞에 표시되어야 합니다. 다른 모든 매개변수는 선택적이며, userapp 매개변수 뒤에 원하는 순서대로 사용할 수 있습니다. Java EE 응용프로그램 클라이언트 런타임은 -CC 접두부로 시작하지 않고 해당 매개변수를 응용프로그램 클라이언트로 전달하는 선택적 매개변수를 무시합니다.

클라이언트 컨테이너 매개변수

지원되는 인수는 다음과 같습니다.

-CCadminConnectorHost
구성 정보가 검색되는 서버의 호스트 이름을 지정합니다.

[AIX Solaris HP-UX Linux Windows][z/OS]The default is the value of the -CCBootstrapHost parameter or the value, 로컬 호스트, if the -CCBootstrapHost parameter is not specified.

[IBM i]기본값은 -CCBootstrapHost 매개변수의 값 또는 -CCBootstrapHost 매개변수가 지정되지 않은 경우 your.server.name값입니다.

-CCadminConnectorPort
관리 클라이언트 기능이 사용할 포트 번호를 표시합니다. 기본값은 SOAP 연결의 경우 8880이고 RMI(Remote Method Invocation) 연결의 경우 2809입니다.
-CCadminConnectorType
관리 클라이언트가 서버에 연결할 방법을 지정합니다. RMI 연결 유형을 사용하려면 RMI를 지정하고 SOAP 연결 유형을 사용하려면 SOAP를 지정하십시오. 기본값은 SOAP입니다.
-CCadminConnectorUser
관리 클라이언트는 서버가 인증을 필요로 할 때 이 사용자 이름을 사용합니다. 연결 유형이 SOAP이고 서버에서 보안이 사용 가능한 경우, 이 매개변수가 필수입니다.
-CCadminConnectorPassword
-CCadminConnectorUser 매개변수가 지정하는 사용자 이름에 대한 비밀번호입니다.
-CCaltDD
대체 배치 디스크립터 파일의 이름입니다. 이 매개변수는 사용할 배치 디스크립터를 지정하는 데 -CCjar 매개변수와 함께 사용됩니다. 클라이언트 JAR 파일이 둘 이상의 배치 디스크립터를 사용하여 구성될 때 이 인수를 사용하십시오. 클라이언트 JAR 파일 표준 배치 디스크립터를 사용하려면 이 값을 null로 설정하십시오.
-CCBootstrapHost
처음에 연결하려는 호스트 서버 이름. 형식은 your_server_of_choice.com 입니다.
-CCBootstrapPort
서버 포트 번호. 이 인수를 지정하지 않으면 WebSphere Application Server 기본값이 사용됩니다.
-CCclassLoaderMode
클래스 로더 모드를 지정합니다. PARENT_LAST를 지정하면 클래스 로더는 클래스 로드를 상위로 위임하기 전에 로컬 클래스 경로에서 클래스를 로드합니다. 다음 요소를 위해 로드된 클래스가 영향을 받습니다.
  • Java EE 응용프로그램 클라이언트에 대해 정의된 클래스
  • Java EE 애플리케이션에 정의된 자원
  • Java EE 클라이언트 JAR 파일의 Manifest에 지정된 클래스
  • -CCclasspath 옵션을 사용하여 지정된 클래스
PARENT_LAST가 지정되지 않으면, 기본 모드 PARENT_FIRST는 클래스 로더가 해당 로컬 클래스 경로에서 클래스를 로드하기 전에 상위 클래스 로더로 클래스 로딩을 위임하게 합니다.
-CCclasspath
클래스 경로 값. 애플리케이션을 실행할 때 시스템 클래스 경로는 사용됩니다. EAR 파일 또는 시스템 클래스 경로 파트에 없는 클래스에 액세스하려면 여기에 해당 클래스 경로를 지정하십시오. 여러 경로를 연결할 수 있습니다.
-CCD
초기화 중에 WebSphere Application Server 가 지정된 시스템 특성을 설정하도록 하려면 이 옵션을 사용하십시오. 다음과 같은 경우 등호 (=) 문자를 사용하지 마십시오.-CCD예를 들어,-CCDcom.ibm.test.property=testvalue. 여러 개의-CCD매개변수. 이 매개변수의 일반 형식은 다음과 같습니다.-CCD<property key>=<property value>. 예를 들어, -CCDI18NService.enable=true입니다.
-CCdumpJavaNameSpace
실행되는 애플리케이션에 대한 java: 네임스페이스의 생성을 제어하는데, 디버깅 목적으로 사용할 수 있습니다. 값 true는 짧은 형식의 덤프를 생성하며, 각 바인딩에 대한 이름과 오브젝트 유형을 포함합니다. 값 long은 긴 형식의 덤프를 생성하며, 로컬 오브젝트의 로컬 오브젝트 유형 및 문자열 표시 같이 짧은 형식 이상의 각 바인딩에 대한 추가 정보를 포함합니다. 기본값은 false이며, 덤프를 생성하지 않습니다.
-CCexitVM
이 옵션을 사용하여 WebSphere Application Server 가 다음을 호출하도록 하십시오.System.exit()클라이언트 애플리케이션이 완료된 후에 메소드를 호출한다. 기본값은false.
-CCinitonly
클라이언트 애플리케이션을 실행하지 않고 ActiveX 애플리케이션 클라이언트에 대한 애플리케이션 클라이언트 런타임을 초기화하려면 이 옵션을 사용하십시오. 기본값은false.
-CCjar
실행하려는 응용프로그램에 대한 EAR 파일 내에 상주하는 클라이언트 JAR(Java Archive) 파일 이름. EAR 파일에 여러 개의 클라이언트 JAR 파일이 있는 경우 이 인수를 사용하십시오.
-CCpropfile
launchClient 특성이 들어 있는 특성 파일의 이름을 표시합니다. 다음을 수행하지 않고 특성 지정-CCsecurityManager, securityMgr클래스 및 securityMgr정책 특성을 제외하고 파일의 접두부. 다음 예를 참조하십시오.verbose=true.
-CCproviderURL
초기 컨텍스트 팩토리에서 초기 컨텍스트를 확보하는 데 사용할 수 있는 부트스트랩 서버 정보를 제공합니다. WebSphere Application Server 초기 컨텍스트 팩토리는 CORBA (Common Object Request Broker Architecture) 오브젝트 URL 또는 IIOP (Internet Inter-ORB Protocol) 를 사용할 수 있습니다. 우르르. CORBA 오브젝트 URL은 IIOP URL에 비해 유연하고 사용 권장되는 URL 형식입니다. 이 값에는 부트스트랩 서버 주소가 두 개 이상 포함될 수 있습니다. 이 기능은 서버 클러스터로부터 초기 컨텍스트를 확보하려고 시도할 때 사용할 수 있습니다. 클러스터에 있는 모든 서버의 부트스트랩 서버 주소는 URL로 지정할 수 있습니다. 이 조작은 최소한 하나 이상의 서버가 실행 중인 경우, 단일 장애 지점을 제거하여 성공합니다. 주소 목록은 특정 순서로 처리되지 않습니다. 이름 지정 조작의 경우, 이 값은 다음을 대체합니다.-CCBootstrapHost및-CCBootstrapPort매개변수. 여러 시스템을 지정하는 CORBA 오브젝트 URL은 다음 예에 설명되어 있습니다.
-CCproviderURL=corbaloc:iiop:myserver.mycompany.com:9810,:mybackupserver.mycompany.com:2809
이 값은 다음과 같이 맵핑됩니다.java.naming.provider.url시스템 특성입니다.
-CCsecurityManager
WebSphere Application Server 를 보안 관리자와 함께 사용 가능하게 하고 실행합니다. 기본값은disable.
-CCsecurityMgrClass
보안 관리자를 구현하는 클래스의 완전한 이름을 표시합니다. 다음 경우에만 이 인수를 사용하십시오.-CCsecurityManager매개변수는 다음으로 설정됩니다.enable. 디폴트는 다음과 같습니다.java.lang.SecurityManager.
-CCsecurityMgrPolicy
보안 관리자 정책 파일의 이름을 표시합니다. -CCsecurityManager 매개변수가 사용으로 설정된 경우에만 이 인수를 사용하십시오. 이 매개변수를 사용하는 경우,java.security.policy시스템 특성이 설정되어 있습니다. 기본값은 app_server_root/properties/client.policy입니다.
-CCsoapConnectorPort
SOAP(Simple Object Access Protocol) 커넥터 포트입니다. 이 인수를 지정하지 않으면 WebSphere Application Server 기본값이 사용됩니다.
-CCtrace
디버그 추적 정보를 확보하려면 이 옵션을 사용하십시오. IBM® 고객 지원에 문제점을 보고할 때 이 정보가 필요할 수 있습니다. 기본값은false. 자세한 정보는 추적 사용 주제를 읽어보십시오.
-CCtracefile
추적 정보가 기록되는 파일의 이름을 표시합니다. 기본값은 콘솔에 출력을 기록하는 것입니다.
-CCtraceMode
추적에 사용할 추적 형식을 지정합니다. 올바른 값인 basic이 지정되지 않는 경우 기본값은 advanced입니다. 기본 추적 형식은 보다 압축적인 추적 양식입니다.

[AIX Solaris HP-UX Linux Windows][IBM i]기본 및 고급 추적 형식화에 대한 자세한 정보는 추적 출력 해석 주제를 참조하십시오.

-CCverbose
이 옵션은 추가 정보 메시지를 표시합니다. 기본값은 false입니다.

보안이 사용 가능한 EJB 클라이언트 애플리케이션을 사용하는 경우 profile_root/properties 디렉토리에 있는 sas.client.props 파일을 편집하십시오. 파일 내에서, com.ibm.CORBA.loginSource 값을 none으로 변경하십시오.

sas.client.props 유틸리티에 대한 자세한 정보는 특성 파일에서 수동으로 비밀번호 인코딩 및 PropFilePasswordEncoder 명령 참조 주제를 참조하십시오.

보안을 사용한 RMI 연결. EJB 및 관리 클라이언트 애플리케이션과 함께 사용됩니다.
Jacl 사용:
[AIX Solaris HP-UX Linux Windows][IBM i]
wsadmin -conntype RMI -port  rmiportnumber -user userid 
-password password
[z/OS]
wsadmin.sh -conntype RMI -port  rmiportnumber -user userid 
-password password

Jython 사용:

[AIX Solaris HP-UX Linux Windows][IBM i]
wsadmin -lang jython -conntype RMI -port  rmiportnumber -user userid 
-password password
[z/OS]
wsadmin.sh -lang jython -conntype RMI -port  rmiportnumber -user userid 
-password password

연결에 대한 rmiportnumber가 관리 콘솔에 BOOTSTRAP_ADDRESS로 표시됩니다.

주의: AIX®, HP-UX, Linux®, IBM i, Solaris및 z/OS® 운영 체제에서, 암호를 사용하면 암호 정보가 시스템 상태 프로그램 (예: ps 명령) 에 표시될 때 보안 노출이 발생할 수 있습니다. 이는 다른 사용자가 실행 중인 모든 프로세스를 표시하도록 호출할 수 있습니다. 보안 문제가 염려되면 이 옵션을 사용하지 마십시오. 대신 soap.client.props 파일(SOAP 커넥터의 경우) 또는 sas.client.props 파일(RMI 커넥터의 경우)에 사용자 및 비밀번호 정보를 지정하십시오. soap.client.props 및 sas.client.props 파일은 WebSphere Application Server 프로파일의 특성 디렉토리에 있습니다.

Kerberos(KRB5)가 관리 인증에 사용 가능한 경우, 인증 대상은 BasicAuth 및 KRB5를 지원합니다. KRB5를 사용하려면 커넥터 유형에 따라서 sas.client.props, soap.client.props, ipc.client.props 파일을 업데이트하십사오.

주의: Kerberos 인증을 사용하는 경우 사용자 암호가 와이어를 통해 흐르지 않습니다. 비밀번호의 단방향 해시가 클라이언트를 식별하는 데 사용됩니다.

다음 예제는 올바른 구문을 보여줍니다.

[Windows]
launchClient c:\earfiles\myapp.ear -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2
[AIX HP-UX Solaris][z/OS]
./launchClient.sh /usr/earfiles/myapp.ear -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2
[IBM i]
/QIBM/ProdData/WebSphere/AppServer/V61/Base/bin/launchClient /home/earfiles/myapp.ear
   -profileName myprofile -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2