launchClient 도구
WebSphere® Application Server 용 launchClient 도구를 위해 Java™ EE(Java Platform, Enterprise Edition) 명령행 구문을 사용할 수 있습니다.
WebSphere Application Server, Network Deployment 환경의 노드에서 launchClient 명령을 사용할 수 있습니다. 그러나 배치 관리자에서 launchClient 명령을 사용하려고 시도하지 마십시오.
개별 사용자 권한에 특정 프로파일 사용
개별 사용자 권한에 별도의 설치 사용
- 주어진 프로파일에서 실행되는 모든 명령에 항상 동일한 사용자 사용
- 특정 프로파일의 모든 사용자가 동일한 그룹에 속하는지 확인하십시오. 또한 그룹의 각 사용자가 동일한 프로파일의 다른 멤버가 작성한 파일에 대한 읽기 및 쓰기 권한을 갖는지 확인하십시오.
다음 예제는 launchClient 도구에 대한 명령행 호출 구문을 설명합니다.
launchClient [-profileName pName | -JVMOptions options | -help | -?] userapp [-CCname=value] [app args]
- userapp은 애플리케이션 클라이언트를 포함한 EAR 파일의 이름 및 경로입니다.
- -CCname=value는 클라이언트 컨테이너 이름-값 쌍 매개변수입니다. 지원되는 이름-값 쌍 인수에 대해서는 클라이언트 컨테이너 매개변수 섹션을 참조하십시오.
- app args는 애플리케이션 클라이언트에 전달하는 인수입니다.
- -profileName은 다중 프로파일 설치에서 Application
Server 프로세스의 프로파일을 정의합니다. 단일 프로파일
환경 또는 애플리케이션 클라이언트 설치에서 실행하기 위해
-profileName 옵션은 필요하지 않습니다.
기본값은 default_profile입니다.
- -JVMOptions은 -cp 또는 -classpath를 제외한 유효한 Java 표준 또는 비표준 옵션 문자열입니다. 문자열을 따옴표로 묶으십시오.
- -help, -?는 사용법 정보를 인쇄합니다.
첫 번째 매개변수가 -help, -?여야 하거나 매개변수를 전혀 포함되면 안됩니다. -profileName pName 및 -JVMOptions 옵션은 선택적 매개변수입니다. 사용하는 경우, <userapp> 매개변수 앞에 있어야 합니다. 다른 모든 매개변수는 선택적이며, userapp 매개변수 뒤에 원하는 순서대로 사용할 수 있습니다. Java EE 애플리케이션 클라이언트 런타임은 -CC 접두부로 시작하지 않는 모든 선택적 매개변수를 무시하며, 이들 매개변수를 애플리케이션 클라이언트에 전달합니다.
클라이언트 컨테이너 매개변수
지원되는 인수는 다음과 같습니다.
- -CCadminConnectorHost
- 구성 정보가 검색되는 서버의 호스트 이름을
지정합니다.
기본값은 -CCBootstrapHost 매개변수의 값이거나 -CCBootstrapHost 매개변수가 지정되지 않는 경우 값 localhost입니다.
기본값은 -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 옵션을 사용하여 지정된 클래스
- -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 특성이 들어 있는 특성 파일의 이름을 표시합니다. 이 파일에서 securityManager, securityMgrClass 및 securityMgrPolicy 특성을 제외하고 -CC 접두부 없이 특성을 지정하십시오. 다음 예를 참조하십시오. verbose=true.
- -CCproviderURL
- 초기 컨텍스트 팩토리에서 초기 컨텍스트를 확보하는 데
사용할 수 있는 부트스트랩 서버 정보를 제공합니다. WebSphere Application Server 초기 컨텍스트 팩토리는 CORBA(Common Object
Request Broker Architecture) 오브젝트 URL 또는 IIOP(Internet
Inter-ORB Protocol) URL을 사용할 수 있습니다. CORBA
오브젝트 URL은 IIOP URL보다 융통성이 있고 사용하도록 권장되는
URL 형식입니다. 이 값에는 부트스트랩 서버 주소가 두 개 이상
포함될 수 있습니다. 이 기능은 서버 클러스터로부터 초기 컨텍스트를
확보하려고 시도할 때 사용할 수 있습니다. 클러스터에 있는 모든
서버의 부트스트랩 서버 주소는 URL로 지정할 수 있습니다. 이
조작은 최소한 하나 이상의 서버가 실행 중인 경우, 단일 장애 지점을
제거하여 성공합니다. 주소 목록은 특정 순서로 처리되지
않습니다. 이름 지정 조작의 경우, 이 값은 -CCBootstrapHost
및 -CCBootstrapPort 매개변수를 대체합니다.
여러 시스템을 지정하는 CORBA 오브젝트 URL은 다음 예에 설명되어
있습니다.
이 값은 java.naming.provider.url 시스템 특성으로 맵핑됩니다.-CCproviderURL=corbaloc:iiop:myserver.mycompany.com:9810,:mybackupserver.mycompany.com:2809
- -CCsecurityManager
- 보안 관리자를 갖는 WebSphere Application Server를 사용으로 설정하고 실행합니다. 기본값은 disable입니다.
- -CCsecurityMgrClass
- 보안 관리자를 구현하는 클래스의 완전한 이름을 표시합니다. -CCsecurityManager 매개변수가 사용 가능으로 설정된 경우에만 이 인수를 사용하십시오. 기본값은 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입니다. 기본 추적 형식은
보다 압축적인 추적 양식입니다.
기본 및 고급 추적 형식화에 대한 자세한 정보는 추적 출력 해석 주제를 참조하십시오.
- -CCverbose
- 이 옵션은 추가 정보 메시지를 표시합니다. 기본값은 false입니다.
보안이 설정된 EJB 클라이언트 애플리케이션을 사용하는 경우 profile_root/properties 디렉토리에 있는 sas.client.props 파일을 편집하십시오. 파일 내에서, com.ibm.CORBA.loginSource 값을 none으로 변경하십시오.
sas.client.props 유틸리티에 대한 자세한 정보는 특성 파일에서 수동으로 비밀번호 인코딩 및 PropFilePasswordEncoder 명령 참조 주제를 참조하십시오.
- 보안을 사용한 RMI 연결. EJB 및 관리 클라이언트 애플리케이션과 함께 사용됩니다.
- Jacl 사용:
wsadmin -conntype RMI -port rmiportnumber -user userid -password password
wsadmin.sh -conntype RMI -port rmiportnumber -user userid -password password
Jython 사용:
wsadmin -lang jython -conntype RMI -port rmiportnumber -user userid -password password
wsadmin.sh -lang jython -conntype RMI -port rmiportnumber -user userid -password password
연결에 대한 rmiportnumber가 관리 콘솔에 BOOTSTRAP_ADDRESS로 표시됩니다.
주의: AIX®, HP-UX, Linux, IBM i, Solaris 및 z/OS® 운영 체제에서, -password 옵션을 사용하면 비밀번호 정보가 ps 명령 같은 시스템 상태 프로그램에 보일 수 있게 되므로 보안 노출이 발생할 수 있습니다. ps 명령은 다른 사용자가 실행 중인 모든 프로세스를 표시하기 위해 호출할 수 있습니다. 보안 문제가 염려되면 이 옵션을 사용하지 마십시오. 대신 soap.client.props 파일(SOAP 커넥터의 경우) 또는 sas.client.props 파일(RMI 커넥터의 경우)에 사용자 및 비밀번호 정보를 지정하십시오. soap.client.props 및 sas.client.props 파일은 WebSphere Application Server 프로파일의 properties 디렉토리에 위치합니다.Kerberos(KRB5)가 관리 인증에 사용 가능한 경우, 인증 대상은 BasicAuth 및 KRB5를 지원합니다. KRB5를 사용하려면 커넥터 유형에 따라서 sas.client.props, soap.client.props, ipc.client.props 파일을 업데이트하십사오.
주의: Kerberos 인증을 사용할 때 사용자 비밀번호가 연결을 통해 전송되지 않습니다. 비밀번호의 단방향 해시가 클라이언트를 식별하는 데 사용됩니다.
다음 예제는 올바른 구문을 보여 줍니다.
![[Windows]](../images/windows.gif)
launchClient c:\earfiles\myapp.ear -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2
![[AIX HP-UX Solaris]](../images/unix.gif)
![[z/OS]](../images/ngzos.gif)
./launchClient.sh /usr/earfiles/myapp.ear -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2
![[IBM i]](../images/iseries.gif)
/QIBM/ProdData/WebSphere/AppServer/V61/Base/bin/launchClient /home/earfiles/myapp.ear
-profileName myprofile -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2