wsadmin 스크립트 옵션을 사용한 AdminApp 오브젝트 install, installInteractive, edit, editInteractive, update 및 updateInteractive 명령의 옵션

이 주제는 AdminApp 오브젝트의 install, installInteractive, edit, editInteractive, updateupdateInteractive 명령에 대해 사용 가능한 옵션을 나열합니다.

AdminApp 오브젝트에 대한 명령을 사용하여 애플리케이션 구성을 설치, 편집, 업데이트 및 관리할 수 있습니다. 이 주제는 install, installInteractive, edit, editInteractive, updateupdateInteractive 명령과 함께 애플리케이션을 관리하기 위해 사용하는 추가 옵션을 제공합니다. 이 주제에 나열된 옵션은 명시된 경우를 제외하고 이 모든 명령에 적용됩니다.

일괄처리 모드에서 옵션을 사용하여 구성 값을 설정 또는 업데이트할 수 있습니다. 설정 또는 업데이트할 구성 오브젝트를 식별하려면 읽기 전용 필드 값을 사용하여 해당 구성 오브젝트를 찾습니다. 읽기 전용 필드의 값은 모두 기존 구성 오브젝트와 일치해야 하며 그렇지 않은 경우 명령이 실패합니다.

일부 복잡한 옵션에 필요한 값을 제공하는 타스크를 단순화하기 위해 패턴 일치를 사용할 수 있습니다. 패턴 일치는 필수 또는 읽기 전용 필드에만 적용됩니다.

주의: 애플리케이션이 실행 중인 경우, 애플리케이션 설정을 변경하면 애플리케이션이 다시 시작됩니다. 독립형 서버에서 변경사항을 저장하면 애플리케이션이 다시 시작됩니다. 여러 서버 제품에서 변경사항을 저장하면 애플리케이션이 다시 시작되고 애플리케이션이 설치된 노드에서 파일이 동기화됩니다. 여러 서버 제품에서 동기화가 발생하는 시기를 제어하려면 콘솔 환경 설정 페이지에서 노드에서 변경사항 동기화를 선택 취소하십시오.
다음 옵션은 install, installInteractive, edit, editInteractive, updateupdateInteractive 명령에 사용할 수 있습니다.

ActSpecJNDI

ActSpecJNDI 옵션은 J2C(Java™ 2 Connector) 활성화 스펙을 대상 JNDI(Java Naming and Directory Interface) 이름에 바인드합니다. 애플리케이션 또는 모듈의 J2C 활성화 스펙을 대상 JNDI 이름으로 바인드할 수도 있습니다. ActSpecJNDI 옵션의 요소(RARModule, uri, j2cid 및 j2c.jndiName 필드) 각각에 값을 지정할 수 있습니다. 기본 바인딩을 실행한 후 옵션 컨텐츠에는 다음이 포함됩니다.
  • RARModule: <rar module name>
  • uri: <rar name>,META-INF/ra.xml
  • 오브젝트 ID: <messageListenerType>
  • JNDI name: null
이 옵션을 사용하려면 ra.xml 파일에 Destination 속성을 지정하고 Destination 속성의 내성 유형을 javax.jms.Destination으로 설정해야 합니다.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install $embeddedEar {-ActSpecJNDI
 {{"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml javax.jms.MessageListener jndi5}
 {"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml javax.jms.MessageListener2 jndi6}}} 
패턴 일치로 Jacl 사용:
$AdminApp install $embeddedEar {-ActSpecJNDI
 {{.* .*.rar,.* javax.jms.MessageListener jndi5}
 {.*  .*.rar,.*  javax.jms.MessageListener2 jndi6}}}
Jython 사용:
AdminApp.install(embeddedEar, ['-ActSpecJNDI',
 [["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageListener', 'jndi5'],
 ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageListener2', 'jndi6']]]) 
패턴 일치로 Jython 사용:
AdminApp.install(embeddedEar, ['-ActSpecJNDI',
 [['.*', '.*.rar,.*', 'javax.jms.MessageListener', 'jndi5'],
 ['.*', '.*.rar,.*', 'javax.jms.MessageListener2', 'jndi6']]])

allowDispatchRemoteInclude

allowDispatchRemoteInclude 옵션을 사용하면 엔터프라이즈 애플리케이션이 표준 요청 디스패처 메커니즘을 통해 관리 노드 환경에서 다른 JVM(Java Virtual Machine)에 있는 웹 모듈의 자원으로 포함을 디스패치할 수 있습니다.

일괄처리 모드 사용법 예제

Jacl 사용:
set deployments [$AdminConfig getid /Deployment:RRDEnabledAppname/]
set deploymentObject [$AdminConfig showAttribute $deployments deployedObject]
set rrdAttr [list allowDispatchRemoteInclude true]
set attrs [list $rrdLocalAttr]
$AdminConfig modify $deploymentObject $attrs
Jython 사용:
deployments = AdminConfig.getid ('/Deployment:RRDEnabledAppname/')
deploymentObject = AdminConfig.showAttribute (deployments, 'deployedObject')
rrdAttr = ['allowDispatchRemoteInclude', 'true']
attrs = [rrdLocalAttr]
AdminConfig.modify (deploymentObject, attrs)

allowPermInFilterPolicy

allowPermInFilterPolicy 옵션은 애플리케이션에 필터 정책에 있는 정책 사용 권한이 포함되어 있는 경우에도 Application Server가 애플리케이션 배치 프로세스를 계속 수행해야 하는 것으로 지정합니다. 이 옵션에는 값이 필요하지 않습니다.

allowServiceRemoteInclude

allowServiceRemoteInclude 옵션은 allowDispatchRemoteInclude 옵션을 true로 설정하여 엔터프라이즈 애플리케이션의 포함 요청을 서비스하는 엔터프라이즈 애플리케이션을 사용 가능하게 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:
set deployments [$AdminConfig getid /Deployment:RRDEnabledAppname/]
set deploymentObject [$AdminConfig showAttribute $deployments deployedObject]
set rrdAttr [list allowServiceRemoteInclude true]
set attrs [list $rrdAttr]
$AdminConfig modify $deploymentObject $attrs
Jython 사용:
deployments = AdminConfig.getid ('/Deployment:RRDEnabledAppname/')
deploymentObject = AdminConfig.showAttribute ('deployments', 'deployedObject')
rrdAttr = ['allowServiceRemoteInclude', 'true']
attrs = [rrdAttr]
AdminConfig.modify (deploymentObject, attrs)

appname

appname 옵션은 애플리케이션의 이름을 지정합니다. 기본값은 애플리케이션의 표시 이름입니다.

BackendIdSelection

BackendIdSelection 옵션은 CMP(Container Managed Persistence) Bean이 있는 엔터프라이즈 Bean JAR(Java Archive) 모듈의 백엔드 ID를 지정합니다. 엔터프라이즈 Bean JAR 모듈은 애플리케이션 어셈블리 도구를 사용하여 지정된 대로 복수 백엔드 구성을 지원할 수 있습니다.설치 시 백엔드 ID를 변경하려면 이 옵션을 사용하십시오.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install myapp.ear {-BackendIdSelection 
 {{Annuity20EJB Annuity20EJB.jar,META-INF/ejb-jar.xml  DB2UDBNT_V72_1}}}
패턴 일치로 Jacl 사용:
$AdminApp install myapp.ear {-BackendIdSelection 
 {{.* Annuity20EJB.jar,.* DB2UDBNT_V72_1}}}
Jython 사용:
AdminApp.install('myapp.ear', '[-BackendIdSelection 
 [[Annuity20EJB Annuity20EJB.jar,META-INF/ejb-jar.xml  DB2UDBNT_V72_1]]]')
패턴 일치로 Jython 사용:
AdminApp.install('myapp.ear', ['-BackendIdSelection',
 [['.*', 'Annuity20EJB.jar,.*', 'DB2UDBNT_V72_1']]])

BindJndiForEJBBusiness

BindJndiForEJBBusiness 옵션은 비즈니스 인터페이스가 포함된 EJB 모듈을 JNDI 이름에 바인드합니다. 비즈니스 인터페이스가 포함된 각 EJB 모듈이 JNDI 이름에 바인드되어 있는지 확인하십시오.

기본 바인딩 실행 후 옵션의 현재 컨텐츠에는 다음이 포함됩니다.
  • Module: Ejb1
  • Bean: MessageBean
  • URI: sample.jar,META-INF/ejb-jar.xml
  • 비즈니스 인터페이스: com.ibm.sample.business.bnd.LocalTargetOne
  • JNDI 이름: []: ejblocal:ejb/LocalTargetOne

BindJndiForEJBNonMessageBinding 옵션을 사용하여 대상 자원 JNDI 이름을 지정하는 경우 BindJndiForEJBBusiness 옵션에 비즈니스 인터페이스 JNDI 이름을 지정하지 마십시오. 대상 자원 JNDI 이름을 지정하지 않은 경우 비즈니스 인퍼테이스 JNDI 이름을 지정하십시오. 비즈니스 인터페이스 JNDI 이름을 지정하지 않으면 런타임 시에 컨테이너 기본값이 제공됩니다.

인터페이스 없는 보기의 경우 비즈니스 인터페이스 값은 빈 문자열입니다("").

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install $ear {-BindJndiForEJBBusiness {{ ejb_1.jar ejb1 
  ejb_1.jar,META-INF/ejb-jar.xml test.ejb1 jndi1 }}}
패턴 일치로 Jacl 사용:
$AdminApp install $ear {-BindJndiForEJBBusiness {{ .* .* .*.jar,.* test.ejb1 jndi1 }}}
Jython 사용:
AdminApp.install(ear, '[-BindJndiForEJBBusiness [[ejb_1.jar ejb1 
  ejb_1.jar,META-INF/ejb-jar.xml test.ejb1 jndi1 ]]]')
패턴 일치로 Jython 사용:
AdminApp.install(ear, '[-BindJndiForEJBBusiness [[.* .* .*.jar,.* test.ejb1 jndi1]]]')

BindJndiForEJBMessageBinding

BindJndiForEJBMessageBinding 옵션은 메시지 구동 엔터프라이즈 Bean을 리스너 포트 이름 또는 활성화 스펙 JNDI(Java Naming and Directory Interface) 이름에 바인드합니다. 이 옵션을 사용하여 누락된 데이터를 제공하거나 태스크를 업데이트하십시오. 메시지 구동 엔터프라이즈 Bean을 활성화 스펙 JNDI 이름에 바인드하는 경우에는 대상 JNDI 이름 및 인증 별명도 지정할 수 있습니다.

BindJndiForEJBMessageBinding 옵션의 각 요소는 EJBModule, EJB, uri, listenerPort, JNDI, jndi.dest 및 actspec.auth 필드로 구성됩니다. listenerPort, JNDI, jndi.dest 및 actspec.auth 필드에는 값이 지정될 수 있습니다.

기본 바인딩 실행 후 옵션의 현재 컨텐츠에는 다음이 포함됩니다.
  • Module: Ejb1
  • Bean: MessageBean
  • URI: ejb-jar-ic.jar,META-INF/ejb-jar.xml
  • Listener port: [null]:
  • JNDI name: [eis/MessageBean]:
  • Destination JNDI Name: [jms/TopicName]:
  • ActivationSpec Authentication Alias: [null]:

destinationLookup 활성화 구성 특성이 어노테이션으로서 또는 배치 디스크립터에서 제공되지 않고 대상 JNDI 이름이 IBM 바인딩 파일에 있지 않은 경우, 기본 대상 JNDI 이름이 대응하는 메시지 참조로부터 수집됩니다.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install $ear {-BindJndiForEJBMessageBinding {{Ejb1 MessageBean 
 ejb-jar-ic.jar,META-INF/ejb-jar.xml myListenerPort jndi1 jndiDest1 actSpecAuth1}}}
패턴 일치로 Jacl 사용:
$AdminApp install $ear {-BindJndiForEJBMessageBinding {{.*  .*
  .*.jar,.* myListenerPort jndi1 jndiDest1 actSpecAuth1}}}
Jython 사용:
AdminApp.install( ear, ['-BindJndiForEJBMessageBinding',
 [['Ejb1', 'MessageBean', 'ejb-jar-ic.jar,META-INF/ejb-jar.xml', 'myListenerPort',
 'jndi1', 'jndiDest1', 'actSpecAuth1']]]) 
패턴 일치로 Jython 사용:
AdminApp.install( ear, ['-BindJndiForEJBMessageBinding',
 [['.*', '.*', '.*.jar,.*', 'myListenerPort', 'jndi1', 'jndiDest1', 'actSpecAuth1']]])

BindJndiForEJBNonMessageBinding

BindJndiForEJBNonMessageBinding 옵션은 엔터프라이즈 Bean을 JNDI(Java Naming and Directory Interface) 이름에 바인드합니다. 애플리케이션 또는 모듈의 각 메시지 구동 엔터프라이즈 Bean을 JNDI 이름에 바인드해야 합니다. 이 옵션을 사용하여 누락된 데이터를 제공하거나 태스크를 업데이트하십시오.

기본 바인딩 실행 후 옵션의 현재 컨텐츠에는 다음이 포함됩니다.
  • Module: Ejb1
  • Bean: MessageBean
  • URI: ejb-jar-ic.jar,META-INF/ejb-jar.xml
  • 대상 자원 JNDI 이름: [com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC]
  • 로컬 홈 JNDI 이름: [null]
  • 원격 홈 JNDI 이름: [null]

특수 제한조건이 EJB(Enterprise JavaBeans) 3.0 이상 모듈에 존재합니다. 대상 자원 JNDI 이름을 지정할 경우 로컬 홈 또는 원격 홈 JNDI 이름은 지정하지 마십시오. BindJndiForEJBBusiness 옵션의 비즈니스 인터페이스 JNDI 필드도 지정할 수 없습니다. 대상 자원 JNDI 이름을 지정하지 않은 경우 로컬 및 원격 홈 JNDI 이름 필드는 선택적입니다. 로컬 및 원격 JNDI 이름을 지정하지 않은 경우 런타임은 컨테이너 기본값을 제공합니다.

EJB 3.0 모듈을 사용하지 않는 경우 대상 자원 JNDI 이름을 지정해야 합니다.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:

[Windows]
$AdminApp install c:/myapp.ear {-BindJndiForEJBNonMessageBinding {{Ejb1 MessageBean 
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC ""  ""}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install /myapp.ear {-BindJndiForEJBNonMessageBinding {{Ejb1 MessageBean 
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC ""  ""}}}
패턴 일치로 Jacl 사용:
$AdminApp install app_server_rootapps/myapps/installableApps/JobbankTargetEJBApp.ear
 {-BindJndiForEJBNonMessageBinding {{.* .* ResumeBankAppEJB.jar,META-INF/ejb-jar.xml
 ejb/com/app/ResumeBank/ResumeBank "" "" }}}

Jython 사용:

[Windows]
AdminApp.install('C:/myapp.ear', '[-BindJndiForEJBNonMessageBinding [[Ejb1 MessageBean
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC "" ""]]]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', '[-BindJndiForEJBNonMessageBinding [[Ejb1 MessageBean 
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC "" ""]]]')
패턴 일치로 Jython 사용:
AdminApp.install('app_server_root/apps/myapps/installableApps/JobbankTargetEJBApp.ear',
 '[ -BindJndiForEJBNonMessageBinding [[ .* .* ResumeBankAppEJB.jar,META-INF/ejb-jar.xml
 ejb/com/app/ResumeBank/ResumeBank "" "" ]] ]' )

blaname

blaname 옵션은 시스템이 Java EE 애플리케이션을 작성하는 비즈니스 레벨 애플리케이션의 이름을 지정하는 데 사용됩니다. 이 옵션은 선택적입니다. 값을 지정하지 않은 경우 시스템에서는 이름을 Java EE 애플리케이션 이름으로 설정합니다. 이 옵션은 설치 명령에만 사용할 수 있습니다.

buildVersion

buildVersion 옵션은 애플리케이션 EAR 파일의 빌드 버전을 표시합니다. 이 옵션은 읽기 전용이므로 수정할 수 없습니다. MANIFEST.MF 애플리케이션 EAR 파일에 빌드 버전이 지정된 경우, 이 옵션은 애플리케이션 EAR에 대한 빌드 버전 정보를 리턴합니다.

cell

cell 옵션은 전체 애플리케이션을 설치 또는 업데이트할 셀 이름이나 새 모듈을 추가하기 위해 애플리케이션을 업데이트할 셀 이름을 지정합니다. 전체 애플리케이션을 업데이트하려면 설치된 애플리케이션에 존재하지 않는 새 모듈이 애플리케이션에 포함된 경우에만 이 옵션이 적용됩니다.

일괄처리 모드 사용법 예제

Jacl 사용:

[Windows]
$AdminApp install "C:/apps/myapps/installableApps/JobbankTargetEJBApp.ear" {-cell cellName}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install "/apps/myapps/installableApps/JobbankTargetEJBApp.ear" {-cell cellName}

Jython 사용:

[Windows]
AdminApp.install('C:/apps/myapps/installableApps/JobbankTargetEJBApp.ear', '[-cell cellName]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('/apps/myapps/installableApps/JobbankTargetEJBApp.ear', '[-cell cellName]')

clientMode

clientMode 옵션은 분리된 배치 대상(isolated), 배치 관리자의 연합된 노드(federated) 또는 애플리케이션 서버(server_deployed)에 클라이언트 모듈을 배치할지 여부를 지정합니다. 이 옵션을 지정하는 경우에는 버전 8.0 이상 배치 대상에만 클라이언트 모듈을 설치하십시오.

기본값은 isolated입니다.

클라이언트 배치 모드의 선택사항이 java: 검색 처리 방법에 영향을 미칩니다. 모든 Java URL 네임스페이스(글로벌, 애플리케이션, 모듈 및 컴포넌트)은 분리된 클라이언트 프로세스에서 로컬 항목입니다. 네임스페이스는 연합된 클라이언트 프로세스와 서버 배치된 클라이언트 프로세스의 서버에 있습니다. 클라이언트 모듈의 대상으로 선택된 서버 또는 클러스터에 따라 해당 네임스페이스가 작성되는 위치가 결정됩니다. 연합 또는 서버 배치된 클라이언트 모듈의 모든 java: 검색은 대상 서버 또는 클러스터로 전달됩니다. 클라이언트 모듈은 실제로 대상 서버 또는 클러스터에서 실행되지 않습니다. 동일한 클라이언트 모듈의 여러 인스턴스가 연합된 모드 및 서버 배치된 모드에서 컴포넌트 네임스페이스를 공유합니다. 연합 모드를 선택하는 것은 JNLP(Java Network Launching Protocol)를 사용하여 클라이언트 모듈을 실행하기 위한 단순한 선언이지만, 연합 모드 및 서버 배치 모드의 JNDI(Java Naming and Directory Interface) 메커니즘을 동일합니다.

클러스터

cluster 옵션은 전체 애플리케이션을 설치 또는 업데이트할 클러스터 이름이나 새 모듈을 추가하기 위해 애플리케이션을 업데이트할 클러스터 이름을 지정합니다. 이 옵션은 WebSphere® Application Server, Network Deployment 환경에만 적용됩니다. 전체 애플리케이션을 업데이트하려면 설치된 애플리케이션에 존재하지 않는 새 모듈이 애플리케이션에 포함된 경우에만 이 옵션이 적용됩니다. -cluster 및 -server 옵션을 함께 사용할 수 없습니다.

배치 중에 생성된 plugin-cfg.xml 파일에 애플리케이션이 나타날 수 있도록 애플리케이션을 배치하고 HTTP 서버를 지정하려면, 먼저 -cluster 대상을 사용하여 애플리케이션을 설치해야 합니다. 애플리케이션을 설치한 후 저장하기 전에 AdminApp 오브젝트의 편집 명령을 사용하여 웹 서버에 맵핑을 더 추가하십시오.

일괄처리 모드 사용법 예제

Jacl 사용:

[Windows]
$AdminApp install "C:/myapp.ear" {-cluster clusterName}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install "myapp.ear" {-cluster clusterName}

Jython 사용:

[Windows]
AdminApp.install('C:/myapp/myapp.ear', '[-cluster clusterName]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('/myapp/myapp.ear', '[-cluster clusterName]')

목차

contents 옵션은 업데이트할 컨텐츠를 포함하는 파일을 지정합니다. 예를 들어, 파일은 내용 유형에 따라 EAR 파일, 모듈, 부분 zip 또는 단일 파일이 될 수 있습니다. 파일의 경로는 스크립트 클라이언트에 대해 로컬이어야 합니다. delete 옵션을 지정하지 않은 경우에는 반드시 contents 옵션을 지정해야 합니다.

contenturi

contenturi 옵션은 애플리케이션에서 추가, 업데이트 또는 추가하는 파일의 URI를 지정합니다. 이 옵션은 업데이트 명령에만 적용됩니다. contenturi 옵션은 내용 유형이 file 또는 modulefile인 경우에 필수입니다. 이 옵션은 기타 내용 유형이 무시됩니다.

contextroot

contextroot 옵션은 독립형 WAR(Web Application Archive) 파일 설치 시 사용하는 컨텍스트 루트를 지정합니다.

CorrectOracleIsolationLevel

CorrectOracleIsolationLevel 옵션은 Oracle 유형 제공자에 대한 분리 레벨을 지정합니다. 누락된 데이터를 제공하거나 태스크를 업데이트하려면 이 옵션을 사용하십시오. 각 항목의 마지막 필드에서는 분리 레벨을 지정합니다. 유효한 분리 레벨 값은 2 또는 4입니다.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에만 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install myapp.ear {-CorrectOracleIsolationLevel 
 {{AsyncSender jms/MyQueueConnectionFactory jms/Resource1 2}}
패턴 일치로 Jacl 사용:
$AdminApp install myapp.ear {-CorrectOracleIsolationLevel 
  {{.*  jms/MyQueueConnectionFactory jms/Resource1 2}}
Jython 사용:
AdminApp.install('myapp.ear', '[-CorrectOracleIsolationLevel 
 [[AsyncSender jms/MyQueueConnectionFactory jms/Resource1 2]]]')
패턴 일치로 Jython 사용:
AdminApp.install('myapp.ear', ['-CorrectOracleIsolationLevel',
 [['.*', 'jms/MyQueueConnectionFactory', 'jms/Resource1', 2]]])

CorrectUseSystemIdentity

CorrectUseSystemIdentity 옵션은 RunAs 시스템을 RunAs 역할로 바꿉니다. 설치하는 엔터프라이즈 Bean에는 RunAs 시스템 ID가 들어 있습니다. 선택적으로 이 ID를 RunAs 역할로 변경할 수 있습니다. 이 옵션을 사용하여 누락된 데이터를 제공하거나 태스크를 업데이트하십시오.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install myapp.ear {-CorrectUseSystemIdentity {{Inc "Increment Bean Jar" 
 Increment.jar,META-INF/ejb-jar.xml getValue() RunAsUser2 user2 password2} 
 {Inc "Increment Bean Jar" Increment.jar,META-INF/ejb-jar.xml Increment()
 RunAsUser2 user2 password2}}}
패턴 일치로 Jacl 사용:
$AdminApp install myapp.ear {-CorrectUseSystemIdentity 
 {{.*  .*  .*  getValue() RunAsUser2 user2 password2} 
 {.*  .*  .*  Increment() RunAsUser2 user2 password2}}}
Jython 사용:
AdminApp.install('myapp.ear', '[-CorrectUseSystemIdentity [[Inc "Increment Bean Jar" Increment.jar,META-INF/ejb-jar.xml getValue() RunAsUser2 user2 password2] [Inc "Increment Bean Jar" Increment.jar,META-INF/ejb-jar.xml Increment() RunAsUser2 user2 password2]]]')
패턴 일치로 Jython 사용:
AdminApp.install('myapp.ear', ['-CorrectUseSystemIdentity', [['.*', '.*', '.*', 'getValue()', 'RunAsUser2', 'user2', 'password2'], 
 ['.*', '.*', '.*', 'Increment()', 'RunAsUser2', 'user2', 'password2']]])

createMBeansForResources

createMBeansForResources 옵션은 배치 대상에서 애플리케이션이 시작할 때 애플리케이션에 정의되는 모든 자원(예: 서블릿, JSP(JavaServer Pages) 파일 및 엔터프라이즈 Bean)에 MBean이 작성되도록 지정합니다. 이 옵션에는 값이 필요하지 않습니다. 기본 설정은 nocreateMBeansForResources 옵션입니다.

CtxRootForWebMod

CtxRootForWebMod 옵션은 웹 모듈의 컨텍스트 루트를 편집합니다. 이 옵션을 사용하여 application.xml 파일에 정의된 컨텍스트 루트를 편집할 수 있습니다. 기본 바인딩 실행 후 이 옵션의 현재 내용은 다음과 같습니다.
  • 웹 모듈: xxx
  • URI: xxx
  • ContextRoot: <context root>
웹 모듈이 서블릿 2.5인 경우 이 옵션의 컨텐츠는 XML 배치 디스크립터에서만 채워집니다. 이 옵션으로 어노테이션에서 배치 정보를 가져올 수 없습니다.

일괄처리 모드 사용법 예제

Jacl 사용:

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname ivtApp -CtxRootForWebMod
 {{"IVT Application" ivt_app.war,WEB-INF/web.xml /mycontextroot}}}
패턴 일치로 Jacl 사용:
$AdminApp install myapp.ear {-appname MyApp -CtxRootForWebMod {{.* .* /mycontextroot}}}

Jython 사용:

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'ivtApp ', '-CtxRootForWebMod',
 [["IVT Application", 'ivt_app.war,WEB-INF/web.xml', '/mycontextroot']]])
패턴 일치로 Jython 사용:
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-CtxRootForWebMod',
 [['.*', '.*', '/mycontextroot']]])

custom

custom 옵션은 name=value 형식을 사용하여 이름-값 쌍을 지정합니다. 애플리케이션 배치 확장에 옵션을 전달하려면 custom 옵션을 사용하십시오. 사용 가능한 사용자 정의 옵션에 대해서는 애플리케이션 배치 확장 문서를 참조하십시오.

CustomActivationPlan

CustomActivationPlan 옵션은 애플리케이션을 실행하는 데 사용되는 기본 런타임 컴포넌트에서 제거하거나 추가할 런타임 컴포넌트를 지정합니다. 애플리케이션 서버가 애플리케이션을 검사하여 필요한 모든 런타임 컴포넌트를 가져올 수 없는 경우에만 이 옵션을 사용하십시오.

일괄처리 모드 사용법 예제

Jython 사용:
AdminApp.install('Increment.jar','[-CustomActivationPlan [["Increment Enterprise Java Bean"
 Increment.jar,META-INF/ejb-jar.xml WebSphere:specname=WS_ComponentToAdd ""]]')
패턴 일치로 Jython 사용:
AdminApp.install('Increment.jar','[-CustomActivationPlan [[.*
 Increment.jar,META-INF/ejb-jar.xml WebSphere:specname=WS_ComponentToAdd ""]]')
표 1. 추가할 CustomActivationPlan 컴포넌트. 명령에 WS_ComponentToAdd 값을 지정하십시오.
컴포넌트 WS_ComponentToAdd 값
EJB 컨테이너 WS_EJBContainer
포틀릿 컨테이너 WS_PortletContainer
JSF(JavaServer Faces) WS_JSF
SIP 컨테이너 WS_SipContainer
보상 범위 서비스 WS_Compensation
애플리케이션 프로파일 WS_AppProfile
활동 세션 WS_ActivitySession
글로벌 WS_I18N
시작 Bean WS_StartupService

DataSourceFor10CMPBeans

DataSourceFor10CMPBeans 옵션은 개별 1.x CMP(Container Managed Persistence) Bean에 대한 선택적 데이터 소스를 지정합니다. 누락된 데이터를 제공하거나 태스크를 업데이트하려면 이 옵션을 사용하십시오.

특정 데이터 소스를 CMP Bean에 맵핑하면 엔터프라이즈 Bean이 들어 있는 모듈의 기본 데이터 소스를 대체하게 됩니다. DataSourceFor10CMPBeans 옵션의 각 요소는 EJBModule, EJB, uri, JNDI, userName, password, login.config.name, auth.props 필드로 구성됩니다. 이 필드들 중 JNDI, userName, password, login.config.name, auth.props 필드에는 값을 지정할 수 있습니다.

기본 바인딩 실행 후 옵션의 현재 컨텐츠에는 다음이 포함됩니다.
  • Module: Increment CMP 1.1 EJB
  • Bean: IncCMP11
  • URI: IncCMP11.jar,META-INF/ejb-jar.xml
  • Target Resource JNDI name: [DefaultDatasource]:
  • User name: [null]:
  • Password: [null]:
  • Login configuration name: [null]: 사용자 정의 로그인 구성을 작성하려면 이 옵션을 사용하십시오. 클라이언트는 JAAS를 사용하여 로그인 디자인을 작성합니다.
  • 특성: [null]: 사용자 정의 로그인 구성을 작성하려면 이 옵션을 사용하십시오. 클라이언트는 JAAS를 사용하여 로그인 디자인을 작성합니다.

login.config.name을 DefaultPrincipalMapping으로 설정하면 이름이 com.ibm.mapping.authDataAlias인 특성이 작성됩니다. 특성의 값은 auth.props에 의해 설정됩니다. login.config 이름을 DefaultPrincipalMapping으로 설정하지 않는 경우 auth.props가 여러 특성을 지정할 수 있습니다. 문자열 형식은 websphere:name= <name1>,value=<value1>,description=<desc1>입니다. 더하기 부호(+)를 사용하여 여러 특성을 지정하십시오.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:

[Windows]
$AdminApp install C:/app1.ear {-DataSourceFor10CMPBeans {{"Increment CMP 1.1 EJB"
 IncCMP11 IncCMP11.jar,META-INF/ejb-jar.xml myJNDI user1 password1 loginName1 authProps1}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-DataSourceFor10CMPBeans {{"Increment CMP 1.1 EJB" IncCMP11
 IncCMP11.jar,META-INF/ejb-jar.xml myJNDI user1 password1 loginName1 authProps1}}} 

패턴 일치로 Jacl 사용:

[Windows]
$AdminApp install C:/myapp.ear {-DataSourceFor10CMPBeans {{.*  .*  
 IncCMP11.jar,.* myJNDI user1 password1 loginName1 authProps1}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-DataSourceFor10CMPBeans {{.*  .*  IncCMP11.jar,.*
 myJNDI user1 password1 loginName1 authProps1}}}

Jython 사용:

[Windows]
AdminApp.install('C:/app1.ear', ['-DataSourceFor10CMPBeans', [["Increment CMP 1.1 EJB",
 'IncCMP11', 'IncCMP11.jar,META-INF/ejb-jar.xml', 'myJNDI', 'user1', 'password1',
 'loginName1', 'authProps1']]]) 
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', ['-DataSourceFor10CMPBeans', [["Increment CMP 1.1 EJB",
 'IncCMP11', 'IncCMP11.jar,META-INF/ejb-jar.xml', 'myJNDI', 'user1',
 'password1', 'loginName1', 'authProps1']]])

패턴 일치로 Jython 사용:

[Windows]
AdminApp.install('C:/myapp.ear', ['-DataSourceFor10CMPBeans', [['.*', '.*', 
 'IncCMP11.jar,.*', 'myJNDI', 'user1', 'password1', 'loginName1', 'authProps1']]])
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', ['-DataSourceFor10CMPBeans', [['.*', '.*',
 'IncCMP11.jar,.*', 'myJNDI', 'user1', 'password1', 'loginName1', 'authProps1']]])

DataSourceFor20CMPBeans

DataSourceFor20CMPBeans 옵션은 개별 2.x CMP(Container Managed Persistence) Bean에 대한 선택적 데이터 소스를 지정합니다. 누락된 데이터를 제공하거나 태스크를 업데이트하려면 이 옵션을 사용하십시오.

특정 데이터 소스를 CMP Bean에 맵핑하면 엔터프라이즈 Bean이 들어 있는 모듈의 기본 데이터 소스를 대체하게 됩니다. DataSourceFor20CMPBeans 옵션의 각 요소는 EJBModule, EJB, uri, JNDI, resAuth, login.config.name, auth.props 필드로 구성됩니다. 이 필드들 중 JNDI, resAuth, login.config.name, auth.props 필드에는 값을 지정할 수 있습니다.

기본 바인딩 실행 후 옵션의 현재 내용에는 다음이 포함됩니다.
  • Module: Increment enterprise bean
  • Bean: Increment
  • URI: Increment.jar,META-INF/ejb-jar.xml
  • Target Resource JNDI name: [null]:
  • Resource authorization: [Per application]:
  • Login configuration name: [null]: 사용자 정의 로그인 구성을 작성하려면 이 옵션을 사용하십시오. 클라이언트는 JAAS를 사용하여 로그인 디자인을 작성합니다.
  • 특성: []: 사용자 정의 로그인 구성을 작성하려면 이 옵션을 사용하십시오. 클라이언트는 JAAS를 사용하여 로그인 디자인을 작성합니다.

login.config.name을 DefaultPrincipalMapping으로 설정하면 이름이 com.ibm.mapping.authDataAlias인 특성이 작성됩니다. 특성의 값은 auth.props에 의해 설정됩니다. login.config 이름을 DefaultPrincipalMapping으로 설정하지 않는 경우 auth.props가 여러 특성을 지정할 수 있습니다. 문자열 형식은 websphere:name= <name1>,value=<value1>,description=<desc1>입니다. 더하기 부호(+)를 사용하여 여러 특성을 지정하십시오.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오.정보가 누락되었거나 업데이트가 필요한 항목 또는 행에만 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install Increment.jar {-DataSourceFor20CMPBeans
 {{"Increment Enterprise Java Bean" Increment
 Increment.jar,META-INF/ejb-jar.xml jndi1 container "" ""}}} 
패턴 일치로 Jacl 사용:
$AdminApp install Increment.jar {-DataSourceFor20CMPBeans {{.*  .*
 Increment.jar,.*  jndi1 container "" ""}}}
Jython 사용:
AdminApp.install('Increment.jar', ['-DataSourceFor20CMPBeans',
 [["Increment Enterprise Java Bean", 'Increment',
 'Increment.jar,META-INF/ejb-jar.xml', 'jndi1', 'container', '', '']]])
패턴 일치로 Jython 사용:
AdminApp.install('Increment.jar', ['-DataSourceFor20CMPBeans', [['.*', '.*',
 'Increment', 'Increment.jar,.*', 'jndi1', 'container', '', '']]])

DataSourceFor10EJBModules

DataSourceFor10EJBModules 옵션은 1.x CMP(Container Managed Persistence) Bean을 포함하는 엔터프라이즈 Bean 모듈에 대한 기본 데이터 소스를 지정합니다. 이 옵션을 사용하여 누락된 데이터를 제공하거나 태스크를 업데이트하십시오.

DataSourceFor10EJBModules 옵션의 각 요소는 EJBModule, EJB, uri, JNDI, userName, password, login.config.name, auth.props 필드로 구성됩니다. 이 필드들 중 JNDI, userName, password, login.config.name, auth.props 필드에는 값을 지정할 수 있습니다.

기본 바인딩 실행 후 옵션의 현재 컨텐츠에는 다음이 포함됩니다.
  • Module: Increment CMP 1.1 enterprise bean
  • uri: IncCMP11.jar,META-INF/ejb-jar.xml
  • Target Resource JNDI name: [DefaultDatasource]:
  • User name: [null]:
  • Password: [null]:
  • Login configuration name: [null]: 사용자 정의 로그인 구성을 작성하려면 이 옵션을 사용하십시오. 클라이언트는 JAAS를 사용하여 로그인 디자인을 작성합니다.
  • 특성: [null]: 사용자 정의 로그인 구성을 작성하려면 이 옵션을 사용하십시오. 클라이언트는 JAAS를 사용하여 로그인 디자인을 작성합니다.

login.config.name을 DefaultPrincipalMapping으로 설정하면 이름이 com.ibm.mapping.authDataAlias인 특성이 작성됩니다. 특성의 값은 auth.props에 의해 설정됩니다. login.config 이름을 DefaultPrincipalMapping으로 설정하지 않는 경우 auth.props가 여러 특성을 지정할 수 있습니다. 문자열 형식은 websphere:name= <name1>,value=<value1>,description=<desc1>입니다. 더하기 부호(+)를 사용하여 여러 특성을 지정하십시오.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install myapp.ear {-DataSourceFor10EJBModules {{"Increment CMP 1.1 EJB" IncCMP11.jar,META-INF/ejb-jar.xml yourJNDI user2 password2 loginName authProps}}}
패턴 일치로 Jacl 사용:
$AdminApp install myapp.ear {-DataSourceFor10EJBModules
 {{.*  IncCMP11.jar,.*  yourJNDI user2 password2 loginName authProps}}}
Jython 사용:
AdminApp.install('myapp.ear', ['-DataSourceFor10EJBModules', [["Increment CMP 1.1 EJB",
 'IncCMP11.jar,META-INF/ejb-jar.xml', 'yourJNDI', 'user2', 'password2', 
 'loginName', 'authProps']]])
패턴 일치로 Jython 사용:
AdminApp.install('myapp.ear', ['-DataSourceFor10EJBModules', 
 [['.*', 'IncCMP11.jar,.*', 'yourJNDI', 'user2', 'password2', 'loginName', 'authProps']]])

DataSourceFor20EJBModules

DataSourceFor20EJBModules 옵션은 2.x CMP(Container Managed Persistence) Bean을 포함하는 엔터프라이즈 Bean 2.x 모듈에 대한 기본 데이터 소스를 지정합니다. 이 옵션을 사용하여 누락된 데이터를 제공하거나 태스크를 업데이트하십시오.

DataSourceFor20EJBModules 옵션의 각 요소는 EJBModule, EJB, uri, JNDI, resAuth, login.config.name, auth.props 필드로 구성됩니다. 이들 필드 중 JNDI, resAuth, login.config.name, auth.props 및 확장 데이터 소스 특성 필드에는 값을 지정할 수 있습니다.

기본 바인딩 실행 후 옵션의 현재 컨텐츠에는 다음이 포함됩니다.
  • Module: Increment enterprise bean
  • URI: Increment.jar,META-INF/ejb-jar.xml
  • Target Resource JNDI name: [DefaultDatasource]:
  • Resource authorization: [Per application]:
  • Login configuration name: [null]: 사용자 정의 로그인 구성을 작성하려면 이 옵션을 사용하십시오. 클라이언트는 JAAS를 사용하여 로그인 디자인을 작성합니다.
  • 특성: []: 사용자 정의 로그인 구성을 작성하려면 이 옵션을 사용하십시오. 클라이언트는 JAAS를 사용하여 로그인 디자인을 작성합니다.
  • 확장 데이터 소스 특성: []: 이 옵션을 사용하면 이기종 풀링을 사용하는 데이터 소스가 DB2® 데이터베이스에 연결할 수 있습니다. 해당 특성의 패턴은 property1=value1+property2=value2입니다.

이 태스크 중 각 항목의 마지막 필드에서는 자원 권한의 값을 지정합니다. 자원 권한의 유효한 값은 per connection factory 또는 container입니다.

login.config.name을 DefaultPrincipalMapping으로 설정하면 이름이 com.ibm.mapping.authDataAlias인 특성이 작성됩니다. 특성의 값은 auth.props에 의해 설정됩니다. login.config 이름을 DefaultPrincipalMapping으로 설정하지 않는 경우 auth.props가 여러 특성을 지정할 수 있습니다. 문자열 형식은 websphere:name= <name1>,value=<value1>,description=<desc1>입니다. 더하기 부호(+)를 사용하여 여러 특성을 지정하십시오.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install Increment.jar {-DataSourceFor20EJBModules
 {{"Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 jndi2 container "" "" ""}}} 
패턴 일치로 Jacl 사용:
$AdminApp install Increment.jar {-DataSourceFor20EJBModules {{.*
 Increment.jar,.* jndi2 container "" "" ""}}}
참고: 확장된 데이터 소스 특성에 여러 값을 사용하는 경우, 변수에 값을 지정하고 특성 값에 해당 변수를 사용해야 합니다. 예를 들면, 다음과 같습니다.
set s \"value1,value2\"
명령 대체에서 다음 예제에 표시된 변수를 참조하십시오.
"clientApplicationInformation=value1,value2" with "clientapplication=$s"
Jython 사용:
AdminApp.install('Increment.jar', ['-DataSourceFor20EJBModules',
 [["Increment Enterprise Java Bean", 'Increment.jar,META-INF/ejb-jar.xml',
 'jndi2', 'container', '', '', '']]])
패턴 일치로 Jython 사용:
AdminApp.install('Increment.jar', ['-DataSourceFor20EJBModules',
 [['.*', 'Increment.jar,.*', 'jndi2', 'container', '', '', '']]])
참고: 확장된 데이터 소스 특성에 여러 값을 사용하는 경우, 큰따옴표를 사용하여 두 값을 묶으십시오. 예를 들면, 다음과 같습니다.
'property1="value1,value2"+property2="value3,value4"'

defaultbinding.cf.jndi

defaultbinding.cf.jndi 옵션은 기본 연결 팩토리의 JNDI(Java Naming and Directory Interface) 이름을 지정합니다.

defaultbinding.cf.resauth

defaultbinding.cf.resauth 옵션은 연결 팩토리의 RESAUTH를 지정합니다.

defaultbinding.datasource.jndi

defaultbinding.datasource.jndi 옵션은 기본 데이터 소스의 JNDI(Java Naming and Directory Interface) 이름을 지정합니다.

defaultbinding.datasource.password

defaultbinding.datasource.password 옵션은 기본 데이터 소스의 비밀번호를 지정합니다.

defaultbinding.datasource.username

defaultbinding.datasource.username 옵션은 기본 데이터 소스의 사용자 이름을 지정합니다.

defaultbinding.ee.defaults

새 기능 새 기능:
newfeat
defaultbinding.ee.defaults 옵션은 Java EE에 대해 사전 구성된 기본 자원 옵션을 사용하도록 지정합니다.

defaultbinding.ejbjndi.prefix

defaultbinding.ejbjndi.prefix 옵션은 엔터프라이즈 Bean JNDI(Java Naming and Directory Interface) 이름의 접두부를 지정합니다.

[z/OS] z/OS® 클랫폼에서 defaultbinding.ejbjndi.prefix 옵션을 사용하려면 usedefaultbindings 옵션도 지정해야 합니다. usedefaultbindings 옵션 사용을 지정하지 않으면, 기본값인 nousedefaultbindings 옵션이 사용됩니다.

defaultbinding.force

defaultbinding.force 옵션은 기본 바인딩이 현재 바인딩을 대체함을 지정합니다.

defaultbinding.strategy.file

defaultbinding.strategy.file 옵션은 사용자 정의 기본 바인딩 전략 파일을 지정합니다.

defaultbinding.virtual.host

defaultbinding.virtual.host 옵션은 가상 호스트의 기본 이름을 지정합니다.

depl.extension.reg (사용하지 않음)

제거된 기능 제거된 기능: depl.extension.reg 옵션은 더 이상 사용되지 않습니다. 복제 옵션을 사용할 수 없습니다.depfeat

deployejb

deployejb 옵션은 설치 중에 EJBDeploy 도구를 실행하도록 지정합니다. 이 옵션에는 값이 필요하지 않습니다. EJB 1.x 또는 2.x 모듈 설치 중에 EJBDeploy가 실행됩니다. EJB 3.x 모듈 설치 중에는 EJB 배치 도구가 실행되지 않습니다.

이 옵션은 설치 또는 업데이트될 EAR 또는 모듈이 Java EE(Java Platform, Enterprise Edition) 7 애플리케이션 배치 디스크립터, EJB 3.2 모듈 배치 디스크립터 또는 웹 3.1 모듈 배치 디스크립터를 포함할 때 무시됩니다.

EJBDeploy 도구를 사용하여 애플리케이션 EAR(Enterprise Archive) 파일을 미리 배치했으면 기본값은 nodeployejb입니다. 그렇지 않다면, 기본값은 deployejb입니다.

다음 상황에서는 이 deployejb 옵션을 사용해야 합니다.
  • Rational® Application Developer와 같은 어셈블리 도구를 사용하여 EAR 파일을 어셈블하거나 어셈블리 동안 EJBDeploy 도구가 실행되지 않았습니다.
  • EAR 파일은 Rational Application Developer와 같은 어셈블리 도구를 사용하여 어셈블리되지 않았습니다.
  • EAR 파일은 버전 5.0 이전의 애플리케이션 어셈블리 도구(AAT) 버전을 사용하여 어셈블리되었습니다.

EJB 모듈이 WAR(웹 아카이브)에 패키지된 경우 이 deployejb 옵션을 사용할 필요가 없습니다.

이 옵션의 경우 버전 9.0 배치 대상에만 설치하십시오.

deployejb.classpath

deployejb.classpath 옵션은 EJBDeploy 도구의 기타 클래스 경로를 지정합니다.

deployejb.complianceLevel

deployejb.complianceLevel 옵션은 EJBDeploy 도구의 JDK 준수 레벨을 지정합니다.

가능한 값은 다음과 같습니다.
1.4(기본값) 5.0 6.0

현재 지원되는 JDK 준수 레벨의 목록을 보려면 ejbdeploy -? 명령을 실행하십시오.

deployejb.dbschema

deployejb.dbschema 옵션은 EJBDeploy 도구의 데이터베이스 스키마를 지정합니다.

deployejb.dbtype

deployejb.dbtype 옵션은 EJBDeploy 도구의 데이터베이스 유형을 지정합니다.

가능한 값은 다음과 같습니다.
DB2UDB_V81 DB2UDB_V82 DB2UDB_V91 DB2UDB_V95 DB2UDBOS390_V8 DB2UDBOS390_NEWFN_V8 DB2UDBOS390_V9 
 DB2UDBISERIES_V53 DB2UDBISERIES_V54 DB2UDBISERIES_V61  DERBY_V10 DERBY_V101 INFORMIX_V100 INFORMIX_V111 INFORMIX_V115 
 MSSQLSERVER_2005 ORACLE_V10G ORACLE_V11G SYBASE_V15 SYBASE_V125
SQLJ(Structured Query Language in Java)를 지원하는 데이터베이스는 DB2UDB_V82, DB2UDB_V81, DB2UDBOS390_V7 및 DB2UDBOS390_V8입니다.

지원되는 데이터베이스 벤더 유형의 목록을 보려면 ejbdeploy -? 명령을 실행하십시오.

deployejb.dbaccesstype

deployejb.dbaccesstype 옵션은 EJBDeploy 도구에 데이터베이스 액세스 유형을 지정합니다. 올바른 값은 SQLjJDBC입니다. 기본값은 JDBC입니다.

deployejb.rmic

deployejb.rmic 옵션은 EJBDeploy 도구에 사용할 기타 RMIC 옵션을 지정합니다.

deployejb.sqljclasspath

deployejb.sqljclasspath 옵션은 SQLJ 변환기 클래스의 위치를 지정합니다.

deployws

deployws 옵션은 설치 중에 웹 서비스를 배치하도록 지정합니다. 이 옵션에는 값이 필요하지 않습니다.

기본값은 nodeployws입니다.

deployws.classpath

deployws.classpath 옵션은 웹 서비스 배치 시 사용할 기타 클래스 경로를 지정합니다.

여러 항목의 클래스 경로를 지정하려면 CLASSPATH 환경 변수에 사용되는 것과 동일한 분리자로 항목을 구분하십시오.

[Windows]세미콜론(;)을 사용하여 항목을 구분하십시오.

[AIX][HP-UX][Linux][Solaris][z/OS]콜론(:)을 사용하여 항목을 구분하십시오.

deployws.jardirs

deployws.jardirs 옵션은 웹 서비스 배치 시 사용할 기타 확장 디렉토리를 지정합니다.

distributeApp

distributeApp 옵션은 애플리케이션 관리 컴포넌트가 애플리케이션 2진을 분배하도록 지정합니다. 이 옵션에는 값이 필요하지 않습니다. 이 설정이 기본값입니다.

EmbeddedRar

EmbeddedRar 옵션은 Java 2 Connector 오브젝트를 JNDI 이름으로 바인드합니다. J2C 연결 팩토리, J2C 활성화 스펙 및 J2C 관리 오브젝트와 같이 애플리케이션이나 모듈의 각 Java 2 Connector 오브젝트를 JNDI 이름으로 바인드해야 합니다. EmbeddedRar 옵션의 각 요소는 RARModule, uri, j2cid, j2c.name, j2c.jndiName 필드를 포함합니다. j2c.name, j2c.jndiName 필드에 다음 값을 지정할 수 있습니다.

기본 바인딩 실행 후 옵션의 현재 컨텐츠에는 다음이 포함됩니다.
Connector module: <rar module name>
URI: <rar name>,META-INF/ra.xml 
Object identifier: <identifier of the J2C object>
name: j2cid
JNDI name: eis/j2cid
여기서 j2cid는 다음과 같습니다.
J2C connection factory: connectionFactoryInterface
J2C admin object :adminObjectInterface
J2C activation specification : message listener type

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

ID가 ra.xml 파일에서 고유하지 않은 경우 -<number>가 추가됩니다. (예: javax.sql.DataSource-2).

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install $embeddedEar {-EmbeddedRar {{"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml 
 javax.sql.DataSource javax.sql.DataSource1 eis/javax.sql.javax.sql.DataSSource1} {"FVT Resource Adapter" 
 jca15cmd.rar,META-INF/ra.xml javax.sql.DataSource2 javax.sql.DataSource2 eis/javax.sql.DataSource2} {"FVT Resource Adapter" 
 jca15cmd.rar,META-INF/ra.xml javax.jms.MessageListener javax.jms.MessageListener1 eis/javax.jms.MessageListener1} {"FVT Resource 
 Adapter" jca15cmd.rar,META-INF/ra.xml javax.jms.MessageLListener2 javax.jms.MessageListener2 eis/javax.jms.MessageListener2} 
 {"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml fvt.adapter.message.FVTMessageProvider 
 fvt.adapter.message.FVTMessageProvider1 eis/fvt.adapter.message.FVTMessageProvider1} {"FVT Resource Adapter" 
 jca15cmd.rar,META-INF/ra.xml fvt.adapter.message.FVTMessageProvider2 fvt.adapter.message.FVTMessageProvider2 
 eis/fvt.adapter.message.FVTMessageProvider2}}}
패턴 일치로 Jacl 사용:
$AdminApp install $embeddedEar {-EmbeddedRar {{.*  .*  .*  javax.sql.DataSource1  
 eis/javax.sql.javax.sql.DataSSource1} {.*  .*  .*  javax.sql.DataSource2  eis/javax.sql.DataSource2} {.*  .*  .*  
 javax.jms.MessageListener1  eis/javax.jms.MessageListener1} {.*  .*  .*  javax.jms.MessageListener2  
 eis/javax.jms.MessageListener2} {.*  .*  .*  fvt.adapter.message.FVTMessageProvider1  
 eis/fvt.adapter.message.FVTMessageProvider1} {.*  .*  .*  fvt.adapter.message.FVTMessageProvider2  
 eis/fvt.adapter.message.FVTMessageProvider2}}}
Jython 사용:
AdminApp.install(embeddedEar, ['-EmbeddedRar', [["FVT Resource Adapter", 
 'jca15cmd.rar,META-INF/ra.xml', 'javax.sql.DataSource', 'javax.sql.DataSource1', 'eis/javax.sql.javax.sql.DataSSource1'], ["FVT 
 Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml javax.sql.DataSource2', 'javax.sql.DataSource2', 'eis/javax.sql.DataSource2'], 
 ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageListener', 'javax.jms.MessageListener1', 
 'eis/javax.jms.MessageListener1'], ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageLListener2', 
 'javax.jms.MessageListener2', 'eis/javax.jms.MessageListener2'], ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml 
 fvt.adapter.message.FVTMessageProvider', 'fvt.adapter.message.FVTMessageProvider1', 
 'eis/fvt.adapter.message.FVTMessageProvider1'], ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 
 'fvt.adapter.message.FVTMessageProvider2', 'fvt.adapter.message.FVTMessageProvider2', 
 'eis/fvt.adapter.message.FVTMessageProvider2']]])
패턴 일치로 Jython 사용:
AdminApp.install(embeddedEar, ['-EmbeddedRar', [['.*', '.*', '.*', 'javax.sql.DataSource1', 
 'eis/javax.sql.javax.sql.DataSSource1'], ['.*', '.*', '.*', 'javax.sql.DataSource2', 'eis/javax.sql.DataSource2'], ['.*', '.*', 
 '.*', 'javax.jms.MessageListener1', 'eis/javax.jms.MessageListener1'], ['.*', '.*', '.*', 'javax.jms.MessageListener2', 
 'eis/javax.jms.MessageListener2'], ['.*', '.*', '.*', 'fvt.adapter.message.FVTMessageProvider1', 
 'eis/fvt.adapter.message.FVTMessageProvider1'], ['.*', '.*', '.*', 'fvt.adapter.message.FVTMessageProvider2', 
 'eis/fvt.adapter.message.FVTMessageProvider2']]])

enableClientModule

enableClientModule 옵션은 클라이언트 모듈을 배치하도록 지정합니다. 패치할 파일에 배치할 클라이언트 모듈이 하나 이상 있는 경우 이 옵션을 선택하십시오. 이 옵션을 선택하는 경우 버전 8.0 이상 배치 대상에만 클라이언트 모듈을 설치하십시오.

이 옵션에는 값이 필요하지 않습니다. 기본값은 noenableClientModule입니다. 기본적으로 배치 및 클라이언트 모듈이 배치되지 않은 중에는 enableClientModule 옵션이 무시됩니다.

EnsureMethodProtectionFor10EJB

EnsureMethodProtectionFor10EJB 옵션은 1.x 엔터프라이즈 Bean의 보호되지 않은 메소드에 대한 메소드 보호를 선택합니다. 메소드를 보호되지 않은 채로 두거나 모든 액세스를 거부하는 보호를 지정합니다. 누락된 데이터를 제공하거나 태스크를 업데이트하려면 이 옵션을 사용하십시오.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install Increment.jar {-EnsureMethodProtectionFor10EJB
 {{"Increment EJB Module" IncrementEJBBean.jar,META-INF/ejb-jar.xml ""}
 {"Timeout EJB Module" TimeoutEJBBean.jar,META-INF/ejb-jar.xml
 methodProtection.denyAllPermission}}}
패턴 일치로 Jacl 사용:
$AdminApp install myapp.ear {-EnsureMethodProtectionFor10EJB 
 {{.*  IncrementEJBBean.jar,.*  ""} {.*  TimeoutEJBBean.jar,.*  
 methodProtection.denyAllPermission}}}
Jython 사용:
AdminApp.install('Increment.jar', '[-EnsureMethodProtectionFor10EJB
 [["Increment EJB Module" IncrementEJBBean.jar,META-INF/ejb-jar.xml ""]
 ["Timeout EJB Module" TimeoutEJBBean.jar,META-INF/ejb-jar.xml
 methodProtection.denyAllPermission]]]')
패턴 일치로 Jython 사용:
AdminApp.install('myapp.ear', ['-EnsureMethodProtectionFor10EJB', 
 [['.*', 'IncrementEJBBean.jar,.*', ""], ['.*', 'TimeoutEJBBean.jar,.*', 
 'methodProtection.denyAllPermission']]])

이 태스크 중 각 항목의 마지막 필드에서는 보호값을 지정합니다. 유효한 보호값에는 methodProtection.denyAllPermission이 포함됩니다. 메소드를 비보호 상태로 두려면 값을 공백으로 하면 됩니다.

EnsureMethodProtectionFor20EJB

EnsureMethodProtectionFor20EJB 옵션은 2.x 엔터프라이즈 Bean의 보호되지 않은 메소드에 대한 메소드 보호를 선택합니다. 보호되지 않은 메소드에 보안 역할을 지정하거나 제외 목록에 메소드를 추가하거나 메소드를 지운 것으로 표시하도록 지정합니다. 역할 이름을 쉼표로 구분하여 메소드에 여러 역할을 지정할 수 있습니다. 누락된 데이터를 제공하거나 태스크를 업데이트하려면 이 옵션을 사용하십시오.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 기존 데이터 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:

$AdminApp install myapp.ear {-EnsureMethodProtectionFor20EJB
 {{CustmerEjbJar customerEjb.jar,META-INF/ejb-jar.xml methodProtection.uncheck}
 {SupplierEjbJar supplierEjb.jar,META-INF/ejb-jar.xml methodProtection.exclude}}}

패턴 일치로 Jacl 사용:

$AdminApp install myapp.ear {-EnsureMethodProtectionFor20EJB
 {{.* customerEjb.jar,.* methodProtection.uncheck}
 {.* supplierEjb.jar,.* methodProtection.exclude}}}
Jython 사용:
AdminApp.install('myapp.ear', '[-EnsureMethodProtectionFor20EJB [[CustmerEjbJar customerEjb.jar,META-INF/ejb-jar.xml methodProtection.uncheck] [SupplierEjbJar supplierEjb.jar,META-INF/ejb-jar.xml methodProtection.exclude]]]')
패턴 일치로 Jython 사용:
AdminApp.install('myapp.ear', ['-EnsureMethodProtectionFor20EJB',
 [['.*', 'customerEjb.jar,.*', 'methodProtection.uncheck'], 
 ['.*', 'supplierEjb.jar,.*', 'methodProtection.exclude']]])

이 태스크 중 각 항목의 마지막 필드에서는 보호값을 지정합니다. 유효한 보호 값은 methodProtection.uncheck, methodProtection.exclude, 또는 쉼표로 구분되는 보안 역할 목록입니다.

filepermission

filepermission 옵션을 사용하면 설치 디렉토리에 있는 애플리케이션 파일에 적절한 파일 사용 권한을 설정할 수 있습니다. 애플리케이션 레벨에서 지정한 파일 사용 권한은 지정할 수 있는 가장 느슨한 사용 권한을 정의하는 노드 레벨 파일 사용 권한의 서브세트이어야 합니다. 그렇지 않으면 노드 레벨 권한 값은 설치 대상에 파일 사용 권한을 설정하는 데 사용됩니다. 파일 이름 패턴은 일반 표현식입니다. 기본값은 다음과 같습니다.
.*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname MyApp -cell myCell -node myNode -server server1
 -filepermission .*\\.jsp=777#.*\\.xml=755}
Jython 사용:
AdminApp.install("app_server_root/installableApps/DynaCacheEsi.ear",
 ["-appname", "MyApp", "-cell", "myCell", "-node", "myNode", "-server", "server1",
 "-filepermission", ".*\\.jsp=777#.*\\.xml=755"])

installdir(사용하지 않음)

제거된 기능 제거된 기능: installdir 옵션은 사용하지 않습니다. 이 옵션은 installed.ear.destination 옵션으로 대체되었습니다.depfeat

installed.ear.destination

installed.ear.destination 옵션은 애플리케이션 2진을 배치할 디렉토리를 지정합니다.

JSPCompileOptions

JSPCompileOptions 옵션은 웹 모듈의 JSP(Java ServerPages) 컴파일 옵션을 지정합니다. 이 옵션은 preCompileJSPs 옵션을 사용할 경우에만 유효합니다. 기본 바인딩 실행 후 이 옵션의 현재 내용은 다음과 같습니다.
  • 웹 모듈: xxx
  • URI: xxx
  • JSP 클래스 경로: <jsp class path>
  • 전체 패키지 이름 사용: Yes | No
  • JDK 소스 레벨: xx
  • JSP 런타임 컴파일 사용 불가능: Yes | No

전체 패키지 이름 사용 및 JSP 런타임 컴파일 사용 안함에 대해 해당 로케일 특정 언어로 Yes 또는 No 값을 지정하십시오. 제품은 YesNo 대신 AppDeploymentOption.YesAppDeploymentOption.No 값을 지원합니다. 그러나 해당 로케일 언어로 Yes 또는 No를 지정하는 것이 좋습니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -preCompileJSPs -JSPCompileOptions {{"IVT Application"
 ivt_app.war,WEB-INF/web.xml jspcp Yes 15 No}}}
패턴 일치로 Jacl 사용:
$AdminApp install ivtApp.ear {-appname MyApp -preCompileJSPs -JSPCompileOptions
 {{.* .* jspcp Yes 15 No}}}
Jython 사용:
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-preCompileJSPs', '-JSPCompileOptions',
 [["IVT Application", 'ivt_app.war,WEB-INF/web.xml', 'jspcp',
 'Yes', 15, 'No']]])
패턴 일치로 Jython 사용:
AdminApp.install('ivtApp.ear', ['-appname', 'MyApp', '-preCompileJSPs',
 '-JSPCompileOptions', [['.*', '.*', 'jspcp', 'Yes', 15, 'No']]])

JSPReloadForWebMod

JSPReloadForWebMod 옵션은 웹 모듈의 JSP 다시 로드 속성을 편집합니다. 각 모듈에 대해 서블릿 및 JSP의 다시 로드 속성을 지정할 수 있습니다. 기본 바인딩 실행 후 옵션의 현재 내용은 다음과 같습니다.
  • 웹 모듈: xxx
  • URI: xxx
  • JSP 사용 클래스 다시 로드: <Yes | No>
  • JSP 다시 로드 간격(초): <jsp reload internal number>

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오.

JSP 클래스 다시 로드 사용 가능에 대해 해당 로케일 특정 언어로 Yes 또는 No 값을 지정하십시오. 제품은 YesNo 대신 AppDeploymentOption.YesAppDeploymentOption.No 값을 지원합니다. 그러나 해당 로케일 언어로 Yes 또는 No를 지정하는 것이 좋습니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -JSPReloadForWebMod {{"IVT Application"
 ivt_app.war,WEB-INF/web.xml Yes 5}}}
패턴 일치로 Jacl 사용:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -JSPReloadForWebMod {{.* .* Yes 5}}}
Jython 사용:
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-JSPReloadForWebMod [["IVT Application"
 ivt_app.war,WEB-INF/web.xml Yes 5 ]]'])
패턴 일치로 Jython 사용:
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-JSPReloadForWebMod', [['.*', '.*', 'Yes', ‘5']]])
지원된 구성 지원된 구성: IBM® 확장 및 바인딩 파일의 경우 .xmi 또는 .xml 파일 이름 확장자는 Java EE 5 이전 애플리케이션이나 모듈을 사용하는지 또는 Java EE 5 이상 애플리케이션이나 모듈을 사용하는지 여부에 따라 달라집니다. IBM 확장 또는 바인딩 파일 이름은 ibm-*-ext.xmi 또는 ibm-*-bnd.xmi입니다. 여기서, *는 확장 또는 바인딩 파일의 유형입니다(예: app, application, ejb-jar 또는 web). 다음 조건이 적용됩니다.
  • 버전 5 이전의 Java EE 버전을 사용하는 애플리케이션 또는 모듈의 경우, 파일 확장자는 .xmi여야 합니다.
  • Java EE 5 이상을 사용하는 애플리케이션 또는 모듈의 경우, 파일 확장자는 .xml이어야 합니다. .xmi 파일이 애플리케이션 또는 모듈에 포함된 경우 제품에서 .xmi 파일을 무시합니다.

그러나 Java EE 5 이상 모듈은 Java EE 5 이전 파일이 포함되어 있고 .xmi 파일 이름 확장자가 사용된 애플리케이션에 있을 수 있습니다.

ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi, ibm-portlet-ext.xmi 파일은 .xmi 파일 확장자를 계속 사용합니다.

sptcfg

MapEJBRefToEJB

MapEJBRefToEJB 옵션은 엔터프라이즈 Bean으로 엔터프라이즈 Java 참조를 맵핑합니다. 애플리케이션에 정의되어 있는 각 엔터프라이즈 Bean 참조를 엔터프라이즈 Bean에 맵핑해야 합니다. 이 옵션을 사용하여 누락된 데이터를 제공하거나 태스크를 업데이트하십시오.

EJB 참조가 EJB 3.x, Web 2.4 또는 Web 2.5 모듈에 속하면 JNDI 이름은 선택적입니다. useAutoLink 옵션을 지정하는 경우 JNDI 이름은 선택적입니다. 런타임은 컨테이너 기본값을 제공합니다. EJB 3.0 이상 모듈에는 컨테이너 관리 또는 BMP(Bean-Managed Persistence) 엔티티 Bean이 포함될 수 없습니다. 컨테이너 관리 또는 BMP(Bean-Managed Persistence) 엔티티 Bean이 Java EE 애플리케이션의 EJB 3.x 모듈에 패키지된 경우 설치에 실패합니다. 컨테이너 관리 또는 BMP(Bean-Managed Persistence) Bean은 EJB 2.1 이전 모듈에만 패키지될 수 있습니다.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오.정보가 누락되었거나 기존 데이터를 업데이트하려는 항목이나 행에만 데이터를 제공하면 됩니다.

일괄처리 모드 사용법 예제

Jacl 사용:

$AdminApp install techapp.ear {-MapEJBRefToEJB {{"JAASLogin" "" JAASLoginWeb.war,
WEB-INF/web.xml WSsamples/JAASLogin jaasloginejb.SampleBean TechApp/JAASLogin}}
-MapWebModToVH {{"Web Application" Tech.war,WEB-INF/web.xml default_host}}}

패턴 일치로 Jacl 사용:

[Windows]
$AdminApp install C:/myapp.ear {-MapEJBRefToEJB {{.* .* .* .* .* MyBean}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-MapEJBRefToEJB {{.* .* .* .* .* MyBean}}}
Jython 사용:
AdminApp.install('techapp.ear','[
-MapEJBRefToEJB [["JAASLogin" "" JAASLoginWeb.war,WEB-INF/web.xml WSsamples/JAASLogin]]
-MapWebModToVH [["Web Application" tech.war,WEB-INF/web.xml default_host]]]')

패턴 일치로 Jython 사용:

[Windows]
AdminApp.install('C:/myapp.ear', ['-MapEJBRefToEJB',
 [['.*', '.*', '.*', '.*', '.*', 'MyBean']]])
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', ['-MapEJBRefToEJB', 
 [['.*', '.*', '.*', '.*', '.*', 'MyBean']]])

MapEnvEntryForApp

MapEnvEntryForApp 옵션은 애플리케이션의 env-entry 값을 편집합니다. 이 옵션을 사용하여 application.xml 파일의 env-entry 값을 편집할 수 있습니다.

기본 바인딩 실행 후 이 옵션의 현재 내용은 다음과 같습니다.
  • Name: xxx
  • 유형: xxx
  • 설명: xxx
    문제점 방지 문제점 방지: 기본 바인딩 실행 후 값이 null 값인 경우 이 태스크를 실행하기 전에 해당 값을 .*로 변경해야 합니다. .* 값은 모든 설명이 일치하도록 할 수 있는 와일드카드 값입니다. 값을 null로 유지하는 경우, MapEnvEntryForApp 태스크를 실행하면 예외가 발생합니다.gotcha
  • 값: <env-entry value>

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -MapEnvEntryForApp {{MyApp/appEnvEntry String null newEnvEntry}}}
패턴 일치로 Jacl 사용:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp2 -MapEnvEntryForApp {{.* .* .* newEnvEntry}}}
Jython 사용:
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp3', '-MapEnvEntryForApp', [['MyApp/appEnvEntry', 'String', 'null', 'newEnvEntry']]])
패턴 일치로 Jython 사용:
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp4', '-MapEnvEntryForApp', [['.*', '.*', '.*', 'newEnvEntry']]])

설명에 줄바꾸기 문자가 있는 경우 다음 구문을 사용하십시오.

패턴 일치로 Jacl 사용:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp5 -MapEnvEntryForApp {{.* .* (?s).* newEnvEntry}}}
패턴 일치로 Jython 사용:
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp6', '-MapEnvEntryForApp',
 [['.*', '.*', '(?s).*', 'newEnvEntry']]])

MapEnvEntryForClientMod

MapEnvEntryForClientMod 옵션은 클라이언트 모듈의 env-entry 값을 편집합니다. 이 옵션을 사용하여 클라이언트 모듈, application-client.xml 파일의 환경 항목 값을 편집할 수 있습니다.

기본 바인딩 실행 후 이 옵션의 현재 내용은 다음과 같습니다.
  • client module: : xxx
  • URI: xxx
  • Name: xxx
  • 유형: xxx
  • 설명: xxx
  • 값: <env-entry value>

클라이언트 모듈에 필요한 데이터에 대한 정보를 얻으려면 AdminApp 오브젝트의 taskInfo 명령을 사용하십시오.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install app_server_root/installableApps/myapp.ear
 {-appname MyApp -MapEnvEntryForClientMod {{"Client Module" client.jar,META-INF/application-client.xml
  clientObject String null newValue}}}
패턴 일치로 Jacl 사용:
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForClientMod {{.*  .*  .*
  .* .* newValue}}} 
Jython 사용:
AdminApp.install('app_server_root/installableApps/myapp.ear',
 ['-appname', 'MyApp', '-MapEnvEntryForClientMod', [["Client Module",
 'client.jar,META-INF/application-client.xml', 'clientObject',
 'String', 'null', 'newValue']]])
패턴 일치로 Jython 사용:
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForClientMod',
 [['.*', '.*', '.*', '.*', '.*', 'newValue']]]) 

설명에 줄바꾸기 문자가 있는 경우 다음 구문을 사용하십시오.

패턴 일치로 Jacl 사용:
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForClientMod {{.*  .*  .*
 (?s).* newValue}}}
패턴 일치로 Jython 사용:
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForClientMod',
 [['.*', '.*', '.*', '(?s).*', '*', '*' 'newValue']]])

MapEnvEntryForEJBMod

MapEnvEntryForEJBMod 옵션은 EJB 모듈의 env-entry 값을 편집합니다. 이 옵션을 사용하여 EJB 모듈, ejb-jar.xml의 환경 항목 값을 편집할 수 있습니다.

기본 바인딩 실행 후 이 옵션의 현재 내용은 다음과 같습니다.
  • 모듈: xxx
  • URI: xxx
  • Bean: xxx
  • Name: xxx
  • 유형: xxx
  • 설명: xxx
    문제점 방지 문제점 방지: 기본 바인딩 실행 후 값이 null 값인 경우 이 태스크를 실행하기 전에 해당 값을 .*로 변경해야 합니다. .* 값은 모든 설명이 일치하도록 할 수 있는 와일드카드 값입니다. 값을 null로 유지하는 경우 MapEnvEntryForEJBMod 태스크를 실행하면 WASX7017E 및 WASX7111E 예외가 발생합니다. gotcha
  • 값: <env-entry value>

EJB 모듈이 EJB 3.0 이상을 사용하는 경우, 이 옵션의 컨텐츠는 XML 배치 디스크립터에서만 채워집니다. 이 옵션으로 어노테이션에서 배치 정보를 가져올 수 없습니다.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -MapEnvEntryForEJBMod {{"IVT EJB Module" ivtEJB.jar,META-INF/ejb-jar.xml
  ivtEJBObject ejb/ivtEJBObject String null newValue}}}
패턴 일치로 Jacl 사용:
$AdminApp install myapp.jar {-appname MyApp -MapEnvEntryForEJBMod {{.*  .*  .*
  .* .* .* newValue}}} 
Jython 사용:
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-MapEnvEntryForEJBMod', [["IVT EJB Module",
 'ivtEJB.jar,META-INF/ejb-jar.xml', 'ivtEJBObject', 'ejb/ivtEJBObject',
 'String', 'null', 'newValue']]])
패턴 일치로 Jython 사용:
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForEJBMod',
 [['.*', '.*', '.*', '.*', '.*', '.*', 'newValue']]]) 

설명에 줄바꾸기 문자가 있는 경우 다음 구문을 사용하십시오.

패턴 일치로 Jacl 사용:
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForEJBMod {{.* .* .*
 (?s).* newValue}}}
패턴 일치로 Jython 사용:
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForEJBMod',
 [['.*', '.*', '.*', '(?s).*', '*', '*' 'newValue']]])

MapEnvEntryForWebMod

MapEnvEntryForWebMod 옵션은 웹 모듈의 env-entry 값을 편집합니다. 이 옵션을 사용하여 web.xml 파일의 env-entry 값을 편집할 수 있습니다.

기본 바인딩 실행 후 이 옵션의 현재 내용은 다음과 같습니다.
  • 웹 모듈: xxx
  • URI: xxx
  • Name: xxx
  • 유형: xxx
  • 설명: xxx
    문제점 방지 문제점 방지: 기본 바인딩 실행 후 값이 null 값인 경우 이 태스크를 실행하기 전에 해당 값을 .*로 변경해야 합니다. .* 값은 모든 설명이 일치하도록 할 수 있는 와일드카드 값입니다. 값을 null로 유지하는 경우 MapEnvEntryForWebMod 태스크를 실행하면 WASX7017E 및 WASX7111E 예외가 발생합니다. gotcha
  • 값: <env-entry value>

웹 모듈이 서블릿 2.5를 사용하는 경우, 이 옵션의 컨텐츠는 XML 배치 디스크립터에서만 채워집니다. 이 옵션으로 어노테이션에서 배치 정보를 가져올 수 없습니다.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -MapEnvEntryForWebMod {{"IVT Application" ivt_app.war,
 WEB-INF/web.xml ivt/ivtEJBObject String null newEnvEntry}}}
패턴 일치로 Jacl 사용:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp2 -MapEnvEntryForWebMod {{.* .* .* .* newEnvEntry}}}
Jython 사용:
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp3', '-MapEnvEntryForWebMod', [["IVT Application",
 'ivt_app.war,WEB-INF/web.xml', 'ivt/ivtEJBObject', 'String', 'null', 'newEnvEntry']]])
패턴 일치로 Jython 사용:
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp4', '-MapEnvEntryForWebMod', [['.*', '.*', '.*', '.*', 'newEnvEntry']]])

설명에 줄바꾸기 문자가 있는 경우 다음 구문을 사용하십시오.

패턴 일치로 Jacl 사용:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp5 -MapEnvEntryForWebMod {{.* .* .* (?s).* newEnvEntry}}}
패턴 일치로 Jython 사용:
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp6', '-MapEnvEntryForWebMod',
 [['.*', '.*', '.*', '(?s).*', 'newEnvEntry']]])

MapInitParamForServlet

MapInitParamForServlet 옵션은 웹 모듈의 초기 매개변수를 편집합니다. 이 옵션을 사용하여 web.xml 파일에 있는 서블릿의 초기 매개변수를 편집할 수 있습니다. 기본 바인딩 실행 후 이 옵션의 현재 내용은 다음과 같습니다.
  • 웹 모듈: xxx
  • URI: xxx
  • 서블릿: xxx
  • Name: xxx
  • 설명: null
  • 값: <initial parameter value>
웹 모듈이 서블릿 2.5 이상을 사용하는 경우, 이 옵션의 컨텐츠는 XML 배치 디스크립터에서만 채워집니다. 이 옵션으로 어노테이션에서 배치 정보를 가져올 수 없습니다.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -MapInitParamForServlet {{"IVT Application"
 ivt_app.war,WEB-INF/web.xml ivtservlet pName1 null MyInitParamValue}}} 
패턴 일치로 Jacl 사용:
$AdminApp install myapp.ear {-appname MyApp -MapInitParamForServlet
 {{.*  .*  .*  .*  .*  MyInitParamValue}}}
Jython 사용:
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-MapInitParamForServlet', [["IVT Application",
 'ivt_app.war,WEB-INF/web.xml', 'ivtservlet', 'pName1', 'null', 'MyInitParamValue']]])
패턴 일치로 Jython 사용:
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapInitParamForServlet',
 [['.*', '.*', '.*', '.*', '.*', 'MyInitParamValue']]])

MapJaspiProvider

MapJaspiProvider 옵션은 글로벌 또는 도메인 보안 구성에서 JASPI(Java Authentication SPI) 설정을 대체하려는 웹 애플리케이션 또는 웹 모듈을 지정합니다. 이 옵션의 컨텐츠는 다음과 같습니다.
  • 모듈: xxx
  • URI: xxx
  • JASPI 사용: | 아니오 | 상속
  • JASPI 제공자 이름: xxx

JASPI 사용에 대해 해당 로케일 특정 언어로 Yes, No 또는 Inherit 값을 지정하십시오.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install myapp.ear {-MapJaspiProvider {{myapp META-INF/application.xml Yes Provider1} }}
Jython 사용:
AdminApp.install('myapp.ear', '[-appname myapp
 -MapJaspiProvider [[myapp META-INF/application.xml Yes Provider1] ]]')

MapMessageDestinationRefToEJB

MapMessageDestinationRefToEJB 옵션은 메시지 대상 참조를 설치된 자원 어댑터에서 관리 오브젝트의 JNDI(Java Naming and Directory Interface) 이름으로 맵핑합니다. 애플리케이션에 정의되어 있는 각 메시지 대상 참조를 관리 오브젝트에 맵핑해야 합니다. 누락된 데이터를 제공하거나 태스크를 업데이트하려면 이 옵션을 사용하십시오.

기본 바인딩 실행 후 옵션의 현재 컨텐츠에는 다음이 포함됩니다.
  • 모듈: ejb-jar-ic.jar
  • Bean: MessageBean
  • URI: ejb-jar-ic.jar,META-INF/ejb-jar.xml
  • 메시지 대상 오브젝트: jms/GSShippingQueue
  • 대상 자원 JNDI 이름: [jms/GSShippingQueue]:
메시지 대상 참조가 EJB 3.0 이상 모듈에 속하면 JNDI 이름이 선택사항이며 런타임에서 컨테이너 기본값을 제공합니다.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install BankFull.ear {-MapMessageDestinationRefToEJB {{BankCMRQLEJB
 Sender BankCMRQLEJB.jar,META-INF/ejb-jar.xml BankJSQueue BankJSQueue} }}  
패턴 일치로 Jacl 사용:
$AdminApp install $earfile {-MapMessageDestinationRefToEJB {{.*  .*  .*  MyConnection
 jndi2} {.* .*  .*  PhysicalTopic jndi3} {.*  .*  .*  jms/ABC jndi4}}} 
Jython 사용:
AdminApp.install('BankFull.ear', '[ -MapMessageDestinationRefToEJB [[ BankCMRQLEJB
 Sender BankCMRQLEJB.jar,META-INF/ejb-jar.xml BankJSQueue BankJSQueue ]]]' )
패턴 일치로 Jython 사용:
AdminApp.install(ear1, ['-MapMessageDestinationRefToEJB', [['.*', '.*', '.*', 'MyConnection', 
 'jndi2'], ['.*', '.*', '.*', 'PhysicalTopic', 'jndi3'], ['.*', '.*', '.*', 'jms/ABC', 'jndi4']]])

MapModulesToServers

MapModulesToServers 옵션은 애플리케이션에 들어 있는 모듈을 설치할 Application Server를 지정합니다. 동일한 서버에 모듈을 설치하거나 여러 서버에 분산시킬 수 있습니다. 이 옵션을 사용하여 누락된 데이터를 제공하거나 태스크를 업데이트하십시오.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

다음 예제에서는 서버에 Increment.jar을 설치합니다.

Jacl 사용:
$AdminApp install Increment.jar {-MapModulesToServers
 {{"Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 WebSphere:cell=mycell,node=mynode,server=server1}}}
Jython 사용:
AdminApp.install('Increment.jar', '[-MapModulesToServers
 [["Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 WebSphere:cell=mycell,node=mynode,server=server1] ]]')

다음 예제는 Increment.jar을 설치하고 이를 배치 관리자가 관리하는 두 개의 서버에 맵핑합니다.

Jacl 사용:
$AdminApp install Increment.jar {-MapModulesToServers
 {{ "Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 WebSphere:cell=mycell,node=mynode,server=server1+WebSphere:cell=mycell,node=mynode,server=server2}}}
Jython 사용:
AdminApp.install('Increment.jar', '[-MapModulesToServers
 [[ "Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 WebSphere:cell=mycell,node=mynode,server=server1+WebSphere:cell=mycell,node=mynode,server=server2]]]')

다음 예제에서는 설치되어 있는 애플리케이션에 server2server3을 추가합니다.

Jacl 사용:
$AdminApp install myapp.ear {-MapModulesToServers {{.* .* 
 +WebSphere:cell=mycell,node=mynode,server=server2+WebSphere:cell=mycell,node=mynode,server=server3}}
 -appname myapp -update -update.ignore.old}
Jython 사용:
AdminApp.install('myapp.ear', ['-MapModulesToServers', [['.*', '.*', 
 '+WebSphere:cell=mycell,node=mynode,server=server2+WebSphere:cell=mycell,node=mynode,server=server3']],
 '-appname', 'myapp', '-update', '-update.ignore.old']) 

다음 예제에서는 설치되어 있는 애플리케이션에서 server1을 제거합니다.

Jacl 사용:
$AdminApp edit myapp {-MapModulesToServers
 {{.* .* -WebSphere:cell=mycell,node=mynode,server=server1}}
 -update -update.ignore.old}
Jython 사용:
AdminApp.edit('myapp', ['-MapModulesToServers',
 [['.*', '.*', '-WebSphere:cell=mycell,node=mynode,server=server1']]]) 

MapResEnvRefToRes

MapResEnvRefToRes 옵션은 자원으로 자원 환경 참조를 맵핑합니다. 애플리케이션에 정의되어 있는 각 자원 환경 참조를 자원에 맵핑해야 합니다. 누락된 데이터를 제공하거나 태스크를 업데이트하려면 이 옵션을 사용하십시오.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install app_server_root/installableApps/sibwsjmsepl.ear {
 -BindJndiForEJBMessageBinding {{ SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml lp1 "" "" "" }}
 -MapResEnvRefToRes {{SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml jms/WebServicesReplyQCF
   javax.jms.QueueConnectionFactory jndi1}}}
패턴 일치로 Jacl 사용:
$AdminApp install app_server_root/installableApps/sibwsjmsepl.ear {
 -MapResEnvRefToRes {{.* .* .* .* .* jndi1}}}
Jython 사용:
AdminApp.install('app_server_root/installableApps/sibwsjmsepl.ear', '[
 -BindJndiForEJBMessageBinding [[ SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml lp1 "" "" "" ]]
 -MapResEnvRefToRes [[ SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml jms/WebServicesReplyQCF
   javax.jms.QueueConnectionFactory jndi1 ]]]' ) 
패턴 일치로 Jython 사용:
AdminApp.install('app_server_root/installableApps/sibwsjmsepl.ear',
 ['-MapResEnvRefToRes', [['.*', '.*', '.*', '.*', '.*', 'jndi1']]])

MapResRefToEJB

MapResRefToEJB 옵션은 자원으로 자원 참조를 맵핑합니다. 애플리케이션에 정의되어 있는 각 자원 참조를 자원에 맵핑해야 합니다. 누락된 데이터를 제공하거나 태스크를 업데이트하려면 이 옵션을 사용하십시오.

MapResRefToEJB에 대한 매개변수는 다음과 같습니다.
  • Module: Ejb1
  • Bean: MailEJBObject
  • URI: deplmtest.jar,META-INF/ejb-jar.xml
  • Resource Reference: jms/MyConnectionFactory
  • 자원 유형: javax.jms.ConnectionFactory
  • Target Resource JNDI Name: [jms/MyConnectionFactory]:
  • 로그인 구성 이름: [null]: 사용자 정의 로그인 구성을 작성하려면 이 옵션을 사용하십시오. 클라이언트는 JAAS를 사용하여 로그인 디자인을 작성합니다.
  • 특성: []: 사용자 정의 로그인 구성을 작성하려면 이 옵션을 사용하십시오. 클라이언트는 JAAS를 사용하여 로그인 디자인을 작성합니다.
  • 확장 데이터 소스 특성: []: 이 옵션을 사용하면 이기종 풀링을 사용하는 데이터 소스가 DB2 데이터베이스에 연결할 수 있습니다. 해당 특성의 패턴은 property1=value1+property2=value 2입니다.

DefaultPrincipalMapping 로그인 구성은 J2C(Java 2 Connector)가 J2C 인증 데이터 항목에 정의되는 프린시펄에 사용자를 맵핑하는 데 사용됩니다. login.config.name을 DefaultPrincipalMapping으로 설정하면 이름이 com.ibm.mapping.authDataAlias인 특성이 작성됩니다. 특성의 값은 auth.props에 의해 설정됩니다. login.config 이름을 DefaultPrincipalMapping으로 설정하지 않는 경우 auth.props가 여러 특성을 지정할 수 있습니다. 문자열 형식은 websphere:name= <name1>,value=<value1>,description=<desc1>입니다. 더하기 부호(+)를 사용하여 여러 특성을 지정하십시오.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install myapp.ear {-MapResRefToEJB 
 {{deplmtest.jar MailEJBObject deplmtest.jar,META-INF/ejb-jar.xml mail/MailSession9
 javax.mail.Session jndi1 login1 authProps1 "clientApplicationInformation=new application"}
 {"JavaMail Sample WebApp" "" mtcomps.war,WEB-INF/web.xml mail/MailSession9 
 javax.mail.Session jndi2 login2 authProps2 ""}}} 
패턴 일치로 Jacl 사용:
$AdminApp install myapp.ear {-MapResRefToEJB 
 {{deplmtest.jar .*  .*  .*  .*  jndi1 login1 authProps1
 "clientApplicationInformation=new application"}
 {"JavaMail Sample WebApp" .*  .*  .*  .*  jndi2 login2 authProps2 ""}}}
참고: 확장된 데이터 소스 특성에 여러 값을 사용하는 경우, 변수에 값을 지정하고 특성 값에 해당 변수를 사용해야 합니다. 예를 들면, 다음과 같습니다.
set s \"value1,value2\"
명령 대체에서 다음 예제에 표시된 변수를 참조하십시오.
"clientApplicationInformation=value1,value2" with "clientapplication=$s"
Jython 사용:
AdminApp.install('myapp.ear', ['-MapResRefToEJB', 
 [['deplmtest.jar', 'MailEJBObject', 'deplmtest.jar,META-INF/ejb-jar.xml
 mail/MailSession9', 'javax.mail.Session', 'jndi1', 'login1', 'authProps1',
 'clientApplicationInformation=new application+clientWorkstation=9.10.117.65'],
 ["JavaMail Sample WebApp", "", 'mtcomps.war,WEB-INF/web.xml', 'mail/MailSession9',
 'javax.mail.Session', 'jndi2', 'login2', 'authProps2', '']]]) 
패턴 일치로 Jython 사용:
AdminApp.install('myapp.ear', ['-MapResRefToEJB', 
 [['deplmtest.jar', '.*', '.*', '.*', '.*', 'jndi1', 'login1', 'authProps1',
 'clientApplicationInformation=new application+clientWorkstation=9.10.117.65'],
 ["JavaMail Sample WebApp", '', '.*', '.*', '.*', 'jndi2', 'login2',
 'authProps2', '']]])
참고: 확장된 데이터 소스 특성에 여러 값을 사용하는 경우, 큰따옴표를 사용하여 두 값을 묶으십시오. 예를 들면, 다음과 같습니다.
'property1="value1,value2"+property2="value3,value4"'

MapRolesToUsers

MapRolesToUsers 옵션은 역할로 사용자를 맵핑합니다. 애플리케이션 또는 묘듈에 정의되어 있는 각 역할을 도메인 사용자 레지스트리의 사용자 또는 그룹에 맵핑해야 합니다. 하나의 역할에 여러 사용자 또는 그룹을 파이프(|)로 구분하여 지정할 수 있습니다. 누락된 데이터를 제공하거나 태스크를 업데이트하려면 이 옵션을 사용하십시오.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install myapp.ear {-MapRolesToUsers {{"All Role" No Yes "" ""} 
 {"Every Role" Yes No "" ""} {DenyAllRole No No user1 group1}}}
Jython 사용:
AdminApp.install('myapp.ear', '[-MapRolesToUsers [["All Role" No Yes "" ""] 
 ["Every Role" Yes No "" ""] [DenyAllRole No No user1 group1]]]')

여기서 {{"All Role" No Yes "" ""}는 다음과 같습니다.

표 2. MapRolesToUsers 옵션 설명. 사용자 또는 그룹에 각 역할을 맵핑합니다.
옵션 설명
"All Role" 역할 이름을 나타냅니다.
아니오 모든 사용자에게 액세스를 허용함을 표시합니다(yes/no).
모든 인증 사용자에게 액세스를 허용함을 표시합니다(yes/no).
"" 맵핑된 사용자를 표시합니다.
"" 맵핑된 그룹을 표시합니다.
"AllAuthenticatedInTrustedRealms" 신뢰 영역의 올바른 사용자에게 액세스가 주어짐을 표시합니다.
"Mapped users access ids" 맵핑된 사용자 액세스 ID를 표시합니다.
"Mapped groups access ids" 맵핑된 그룹 액세스 ID를 표시합니다.

MapRunAsRolesToUsers

MapRunAsRolesToUsers 옵션은 사용자로 RunAs 역할을 맵핑합니다. 설치 중인 엔터프라이즈 Bean에는 사전 정의된 RunAs 역할이 포함되어 있습니다. 다른 엔터프라이즈 Bean과 대화하는 동안 인식을 위해 특정 역할로서 실행해야 하는 엔터프라이즈 Bean이 RunAs 역할을 사용합니다. 누락된 데이터를 제공하거나 태스크를 업데이트하려면 이 옵션을 사용하십시오.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:

[Windows]
$AdminApp install C:/myapp.ear {-MapRunAsRolesToUsers {{UserRole user1 
 password1} {AdminRole administrator administrator}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-MapRunAsRolesToUsers {{UserRole user1
 password1} {AdminRole administrator administrator}}}

Jython 사용:

[Windows]
AdminApp.install('C:/myapp.ear', '[-MapRunAsRolesToUsers [[UserRole user1 
 password1] [AdminRole administrator administrator]]]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', '[-MapRunAsRolesToUsers [[UserRole user1
 password1] [AdminRole administrator administrator]]]')

MapSharedLibForMod

MapSharedLibForMod 옵션은 애플리케이션 또는 모든 모듈에 공유 라이브러리를 지정합니다. 복수의 공유 라이브러리를 애플리케이션 및 모듈에 연관시킬 수 있습니다. 기본 바인딩 실행 후 이 옵션의 현재 내용은 다음과 같습니다.
  • 모듈: xxx
  • URI: META-INF/application.xml
  • 공유 라이브러리: <share libraries>

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname DynaCacheEsi -MapSharedLibForMod {{ DynaCacheEsi META-INF/application.xml
 sharedlib1 }{ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml sharedlib2 }}}
패턴 일치로 Jacl 사용:
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname DynaCacheEsi -MapSharedLibForMod {{ .* .* sharedlib1 }
 { .* .* sharedlib2 }}}
Jython 사용:
AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[ -MapSharedLibForMod [[ DynaCacheEsi META-INF/application.xml sharedlib1 ]
 [ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml sharedlib2 ]]]' )
패턴 일치로 Jython 사용:
AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[ -MapSharedLibForMod [[ .* .* sharedlib1 ][ .* .* sharedlib2 ]]]' )

MapWebModToVH

MapWebModToVH 옵션은 웹 모듈의 가상 호스트를 선택합니다. 애플리케이션에 들어 있는 웹 모듈을 설치할 가상 호스트를 지정하십시오. 동일한 가상 호스트에 웹 모듈을 설치하거나 여러 호스트에 분산할 수 있습니다. 누락된 데이터를 제공하거나 태스크를 업데이트하려면 이 옵션을 사용하십시오.

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오. 정보가 누락되었거나 업데이트가 필요한 항목 또는 행에 데이터를 제공해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname DynaCacheEsi
 -MapWebModToVH {{ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml default_host }}}
패턴 일치로 Jacl 사용:
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-MapWebModToVH {{ .* .* default_host }}}
Jython 사용:
AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[-MapWebModToVH [[ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml default_host ]]]') 
패턴 일치로 Jython 사용:
AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 ['-MapWebModToVH', [['.*', '.*', 'default_host']]])

MetadataCompleteForModules

MetadataCompleteForModules 옵션을 사용하면 Java EE 5 이상의 각 모듈이 어노테이션의 배치 정보를 포함하여 전체 배치 디스크립터를 작성할 수 있습니다. 그런 다음, 시스템은 모듈의 배치 디스크립터를 완료된 것으로 표시합니다.

문제점 방지 문제점 방지: Java EE 5 이상의 애플리케이션에서 어노테이션 및 공유 라이브러리를 사용하는 경우 이 옵션을 사용하지 마십시오. 애플리케이션이 어노테이션과 공유 라이브러리를 사용하는 경우, metadata-complete 속성을 true로 설정하면 제품에서 배치 디스크립터의 @EJB 어노테이션을 <ejb-local-ref>가 아닌 <ejb-ref>로 잘못 표시합니다. 웹 모듈의 경우, metadata-complete 속성을 true로 설정하면 InjectionException 오류가 발생할 수 있습니다. metadata-complete 속성을 true로 설정해야 하는 경우 공유 라이브러리를 사용하지 않거나, 공유 라이브러리를 Application Server의 classes 또는 lib 디렉토리에 두거나, 배치 디스크립터에 메타데이터를 완전히 지정하여 오류가 발생하지 않도록 하십시오.gotcha
기본 바인딩 실행 후 이 옵션의 현재 내용은 다음과 같습니다.
  • 모듈: EJBDD_1.jar
  • URI: EJBDD_1.jar,META-INF/ejb-jar.xml
  • 잠금 배치 디스크립터: [false]:
  • 모듈: EJBNoDD_2.jar
  • URI: EJBNoDD_2.jar,META-INF/ejb-jar.xml
  • 잠금 배치 디스크립터: [false]:

AdminApp 오브젝트의 taskInfo 명령을 사용하여 애플리케이션에 필요한 데이터 정보를 확보하십시오.

일괄처리 모드 사용법 예제

Jacl 사용:

[Windows]
$AdminApp install c:/myapp.ear {-MetadataCompleteForModules
 {{EJBDD_1.jar EJBDD_1.jar,META-INF/ejb-jar.xml false}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-MetadataCompleteForModules
 {{EJBDD_1.jar EJBDD_1.jar,META-INF/ejb-jar.xml false}}}

패턴 일치로 Jacl 사용:

[Windows]
$AdminApp install c:/myapp.ear {-MetadataCompleteForModules
 {{.* EJBDD_1.jar,.* false}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear 
 {-MetadataCompleteForModules {{.* EJBDD_1.jar,.* false}}}

Jython 사용:

[Windows]
AdminApp.install('c:/myapp.ear', ['-MetadataCompleteForModules', 
 [['EJBDD_1,jar',  'EJBDD_1.jar,META-INF/ejb-jar.xml', 'false']]])
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', ['-MetadataCompleteForModules',
 [['EJBDD_1,jar',  'EJBDD_1.jar,META-INF/ejb-jar.xml', 'false']]])

패턴 일치로 Jython 사용:

[Windows]
AdminApp.install('c:/myapp.ear', ['-MetadataCompleteForModules', [['.*',
 'EJBDD_1.jar,.*', 'false']]]
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', 
 ['-MetadataCompleteForModules', [['.*', 'EJBDD_1.jar,.*', 'false']]]

ModuleBuildID

ModuleBuildID 옵션은 애플리케이션 EAR 파일에 모듈의 빌드 ID를 표시합니다. 이 옵션은 읽기 전용이므로 수정할 수 없습니다. 애플리케이션 EAR 파일 또는 모듈의 MANIFEST.MF에 빌드 ID가 지정된 경우, 이 옵션은 모듈에 대한 빌드 정보를 리턴합니다. 빌드 정보는 모듈 이름, 모듈 URI 및 빌드 ID로 구성되어 있습니다.

기본 바인딩 실행 후 옵션의 현재 내용은 다음과 유사합니다.
  • 모듈: CacheClient
  • URI: CacheClient.jar,META-INF/application-client.xml
  • 빌드 ID: alpha
  • 모듈: MailConnector
  • URI: Mail.rar,META-INF/ra.xml
  • 빌드 ID: abc
  • 모듈: CacheWeb1
  • URI: CacheWeb1.war,WEB-INF/web.xml
  • 빌드 ID: alpha
  • 모듈: JspWeb1
  • URI: JspWeb1.war,WEB-INF/web.xml
  • 빌드 ID: v1.0
  • 모듈: 서블릿
  • URI: Servlet.war,WEB-INF/web.xml
  • 빌드 ID: 0.5

일괄처리 모드 사용법 예제

Jython 사용:

[Windows]
print AdminApp.taskInfo('c:/temp/Cache2.ear', 'ModuleBuildID')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
print AdminApp.taskInfo('/temp/Cache2.ear', 'ModuleBuildID')

noallowDispatchRemoteInclude

noallowDispatchRemoteInclude 옵션은 표준 요청 디스패처 메커니즘을 통해 관리 노드 환경에서 다른 JVM(Java Virtual Machine)에 있는 웹 모듈의 자원에 포함을 디스패치하는 엔터프라이즈 애플리케이션을 사용 불가능하게 합니다.

noallowPermInFilterPolicy

noallowPermInFilterPolicy 옵션은 애플리케이션에 필터 정책에 있는 정책 사용 권한이 포함되어 있는 경우 애플리케이션 배치 프로세스를 계속 수행하지 않도록 지정합니다. 이 옵션은 기본 설정으로 값이 필요하지 않습니다.

noallowServiceRemoteInclude

noallowServiceRemoteInclude 옵션은 allowDispatchRemoteInclude 옵션을 true로 설정한 엔터프라이즈 애플리케이션의 포함 요청을 서비스하는 엔터프라이즈 애플리케이션을 사용 불가능하게 합니다.

node

node 옵션은 전체 애플리케이션을 설치 또는 업데이트할 노드 이름이나 새 모듈을 추가하기 위해 애플리케이션을 업데이트할 노드 이름을 지정합니다. 전체 애플리케이션을 업데이트하려면 설치된 애플리케이션에 존재하지 않는 새 모듈이 애플리케이션에 포함된 경우에만 이 옵션이 적용됩니다.

일괄처리 모드 사용법 예제

Jacl 사용:

[Windows]
$AdminApp install "C:/myapp.ear" {-node nodeName}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install "/myapp.ear" {-node nodeName}

Jython 사용:

[Windows]
AdminApp.install('C:/myapp/myapp.ear', '[-node nodeName]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('/myapp/myapp.ear', '[-node nodeName]')

nocreateMBeansForResources

nocreateMBeansForResources 옵션은 배치 대상에서 애플리케이션이 시작할 때 애플리케이션에 정의되는 모든 자원(예: 서블릿, JSP(JavaServer Pages) 파일 및 엔터프라이즈 Bean)에 MBean이 작성되지 않도록 지정합니다. 이 옵션은 기본 설정으로 값이 필요하지 않습니다.

nodeployejb

nodeployejb 옵션은 설치 중에 EJBDeploy 도구를 실행하지 않도록 지정합니다. 이 옵션은 기본 설정으로 값이 필요하지 않습니다.

nodeployws

nodeployws 옵션은 설치 중에 웹 서비스를 배치하지 않도록 지정합니다. 이 옵션은 기본 설정으로 값이 필요하지 않습니다.

nodistributeApp

nodistributeApp 옵션은 애플리케이션 관리 컴포넌트가 애플리케이션 2진을 분배하지 않도록 지정합니다. 이 옵션에는 값이 필요하지 않습니다. 기본 설정은 distributeApp 옵션입니다.

noenableClientModule

noenableClientModule 옵션은 클라이언트 모듈을 배치하지 않도록 지정합니다. 이 옵션에는 값이 필요하지 않습니다. 이것은 기본값입니다. 기본값은 클라이언트 모듈을 배치하지 않는 것입니다. enableClientModule 옵션을 사용하여 클라이언트 모듈을 배치하십시오.

noreloadEnabled

noreloadEnabled 옵션은 클래스 다시 로드를 사용 불가능하게 합니다. 이 옵션은 기본 설정으로 값이 필요하지 않습니다. 변경사항이 자동으로 다시 로드되도록 업데이트 파일에 대해 애플리케이션의 파일 시스템을 스캔하도록 지정하려면 reloadEnabled 옵션을 사용하십시오.

nopreCompileJSPs

nopreCompileJSPs 옵션은 JavaServer Pages 파일을 사전 컴파일하지 않도록 지정합니다. 이 옵션은 기본 설정으로 값이 필요하지 않습니다.

noprocessEmbeddedConfig

noprocessEmbeddedConfig 옵션은 시스템이 애플리케이션에 포함된 임베디드 구성 데이터를 무시해야 하는 것으로 지정합니다. 이 옵션에는 값이 필요하지 않습니다. 애플리케이션 EAR(Enterprise Archive) 파일이 임베디드 구성 데이터를 포함하지 않는 경우, noprocessEmbeddedConfig 옵션이 기본 설정입니다. 그렇지 않으면, 기본 설정은 processEmbeddedConfig 옵션입니다.

nouseAutoLink

nouseAutoLink 옵션은 useAutoLink 옵션을 사용하지 않고 EJB 3.0 이전 EJB 모듈 버전 및 버전 2.4 이전 웹 모듈 버전의 EJB(Enterprise JavaBeans) 참조를 자동으로 해석하지 않도록 지정합니다.

nouseMetaDataFromBinary

nouseMetaDataFromBinary 옵션은 런타임에 사용되는 메타데이터(예를 들어, 배치 디스크립터, 바인딩, 확장자 등)가 구성 저장소에 있음을 지정합니다. 이 옵션은 기본 설정으로 값이 필요하지 않습니다. 이 옵션을 사용하여 런타임에 사용되는 메타데이터가 EAR(Enterprise Archive) 파일에 있음을 표시하십시오.

nousedefaultbindings

nousedefaultbindings 옵션은 설치 시 기본 바인딩을 사용하지 않도록 지정합니다. 이 옵션은 기본 설정으로 값이 필요하지 않습니다.

novalidateSchema

novalidateSchema 옵션은 배치 디스크립터를 공개된 Java EE 배치 디스크립터 스키마에 대해 유효성을 검증하지 않도록 지정합니다. 이 옵션에는 값이 필요하지 않습니다. 이것은 기본값입니다. 기본값은 배치 디스크립터의 유효성을 검증하지 않는 것입니다.

operation

operation 옵션은 수행할 조작을 지정합니다. 이 옵션은 update 또는 updateInteractive 명령에만 적용됩니다. 유효한 값은 다음과 같습니다.
  • add - 새 컨텐츠를 추가합니다.
  • addupdate - 애플리케이션에서 컨텐츠 존재 유무에 따라 내용을 추가 또는 업데이트합니다.
  • delete - 컨텐츠를 삭제합니다.
  • update - 기존 컨텐츠를 업데이트합니다.

operation 옵션은 컨텐츠 유형이 file 또는 modulefile인 경우에 필수입니다. 컨텐츠 유형의 값이 app이면 조작 옵션의 값은 update여야 합니다.컨텐츠 유형이 app이면 contenturi 옵션은 무시됩니다.

일괄처리 모드 사용법 예제

다음 예제는 update 명령에 대한 옵션을 사용하여 배치된 전체 엔터프라이즈 애플리케이션을 업데이트하는 방법을 보여줍니다.

Jacl 사용:
$AdminApp update "IVT Application" app {-operation update
 -contents app_server_root/installableApps/ivtApp.ear}
Jython 문자열 사용:
AdminApp.update('IVT Application', 'app', '[ -operation update
 -contents app_server_root/installableApps/ivtApp.ear ]' )

다음 예제는 update 명령에 대한 옵션을 사용하여 배치된 애플리케이션에서 단일 파일을 업데이트하는 방법을 보여줍니다.

Jacl 사용:

[Windows]
$AdminApp update app1 file {-operation update -contents 
 C:/apps/app1/my.xml -contenturi app1.jar/my.xml}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp update app1 file {-operation update 
 -contents /apps/app1/my.xml -contenturi app1.jar/my.xml}

Jython 문자열 사용:

[Windows]
AdminApp.update('app1', 'file', '[-operation update -contents 
 C:/apps/app1/my.xml -contenturi app1.jar/my.xml]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.update('app1', 'file', '[-operation update 
 -contents /apps/app1/my.xml -contenturi app1.jar/my.xml]')

Jython 목록 사용:

[Windows]
AdminApp.update('app1', 'file', ['-operation', 'update', '-contents', 
 'C:/apps/app1/my.xml', '-contenturi', app1.jar/my.xml'])
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.update('app1', 'file', ['-operation',  'update', '-contents',
 '/apps/app1/my.xml', '-contenturi', app1.jar/my.xml'])

여기서 AdminApp는 스크립트 오브젝트, update는 명령, app1은 업데이트할 애플리케이션의 이름, file은 내용 유형, operationupdate 명령의 옵션, updateoperation 옵션의 값, contentsupdate 명령의 옵션, /apps/app1/my.xmlcontents 옵션의 값, contenturiupdate 명령의 옵션, app1.jar/my.xmlcontenturi 옵션의 값입니다.

processEmbeddedConfig

processEmbeddedConfig 옵션은 애플리케이션에 포함된 임베디드 구성 데이터를 처리합니다. 이 옵션에는 값이 필요하지 않습니다. 애플리케이션 EAR(Enterprise Archive) 파일이 임베디드 구성 데이터를 포함하는 경우, 이 옵션이 기본 설정입니다. 그렇지 않으면, 기본 설정은 nonprocessEmbeddedConfig 옵션입니다.

이 설정은 확장 EAR 파일의 설치에 영항을 줍니다. 확장 EAR 파일은 설치된 애플리케이션을 내보낼 때 생성됩니다. 확장 EAR 파일에는 resource.xmlvariables.xml 등과 같은 파일로 이루어진 임베디드 구성이 있습니다. 이 옵션은 임베디드 구성을 EAR 파일에서 애플리케이션 범위로 로드합니다.

현재 셀 이외의 셀에서 애플리케이션을 내보냈으며 애플리케이션을 처음으로 설치할 때 installed.ear.destination 옵션에 $(CELL) 변수를 지정하지 않은 경우, nonprocessEmbeddedConfig 옵션을 사용하여 profile_root/installedApps/current_cell_name 디렉토리에 확장 EAR 파일을 펼치십시오. 그렇지 않은 경우 이 processEmbeddedConfig 옵션을 사용하여 profile_root/installedApps/original_cell_name 디렉토리에 확장 EAR 파일을 펼치십시오. 여기서 original_cell_name은 애플리케이션이 처음에 설치된 셀입니다. 애플리케이션을 처음으로 설치할 때 installed.ear.destination 옵션에 $(CELL) 변수를 지정한 경우에는 설치 중 확장 EAR 파일이 profile_root/installedApps/current_cell_name 디렉토리에 펼쳐집니다.

preCompileJSPs

preCompileJSPs 옵션은 JavaServer Pages 파일을 사전 컴파일하도록 지정합니다. 이 옵션에는 값이 필요하지 않습니다. 기본값은 nopreCompileJSPs입니다. JavaServer Pages 파일을 사전 컴파일하려는 경우 설치 과정의 일부로 지정하십시오. 기본값은 JavaServer Pages 파일을 사전 컴파일하지 않는 것입니다. 배치 중 preCompileJSPs 옵션은 무시되며 JavaServer Pages 파일은 사전 컴파일되지 않습니다. 플래그는 어셈블리 도구를 사용하여 자동으로 설정됩니다.

reloadEnabled

reloadEnabled 옵션은 변경사항이 자동으로 다시 로드되도록 업데이트 파일에 대해 애플리케이션의 파일 시스템을 스캔하는 것으로 지정합니다. 이 옵션이 사용 가능하고 애플리케이션 클래스가 변경될 경우, 애플리케이션이 업데이트된 클래스를 다시 로드하기 위해 중지된 후 다시 시작됩니다. 이 옵션은 기본 설정이 아니며 값이 필요하지 않습니다. 기본 설정은 noreloadEnabled 옵션입니다.

reloadInterval

reloadInterval 옵션은 업데이트 파일에 대해 애플리케이션의 파일 시스템을 스캔할 시간(초)을 지정합니다. 값은 0보다 커야 합니다. 기본값은 3초입니다.

SharedLibRelationship

SharedLibRelationship 옵션은 자산 또는 컴포지션 단위 ID를 각 Java EE 모듈의 공유 라이브러리로 지정합니다.

기본 바인딩 실행 후 옵션의 현재 컨텐츠에는 다음이 포함됩니다.
  • 모듈: EJB3BNDBean.jar
  • URI: EJB3BNDBean.jar,META-INF/ejb-jar.xml
  • 관계 ID: 자산 또는 컴포지션 단위 ID 지정(예: [WebSphere:cuname=sharedLibCU1,cuedition=1.0] 또는 WebSphere:assetname=sharedLibAsset1.jar)
  • 컴포지션 단위 이름: 선택적으로 자산 관계 ID에 대해 컴포지션 단위 이름을 지정합니다. 컴포지션 단위 이름을 지정하지 않으면 시스템에서 자산과 동일한 이름을 사용합니다. []
  • 일치 대상: [예]:
다음 지침에 설명된 대로 관계의 자산 및 컴포지션 단위 ID를 지정할 수 있습니다.
  • 자산을 지정하는 경우 시스템에서 Java EE 애플리케이션이 속한 동일한 비즈니스 레벨 애플리케이션의 자산으로 컴포지션 단위를 작성합니다.
  • 컴포지션 단위 이름 값을 지정하는 경우 시스템 위치는 각 이름을 해당하는 관계 ID 값과 일치시킵니다.
  • 관계 ID가 컴포지션 단위 ID인 경우 시스템은 해당하는 컴포지션 단위 이름을 무시합니다.
  • 관계 ID가 자산 ID인 경우 시스템은 해당하는 컴포지션 단위 이름을 사용하여 컴포지션 단위를 작성합니다.

둘 이상의 자산 또는 컴포지션 단위 ID를 지정하려면 더하기 부호 문자(+)를 사용하여 각 값을 구분하십시오.

Java EE 애플리케이션에 대해 edit 명령을 사용하는 경우 새 컴포지션 단위 관계 ID 세트로 관계를 대체하거나 기존 컴포지션 단위 관계를 추가 또는 제거할 수 있습니다. edit 명령을 사용하는 경우 자산 관계를 지정할 수 없습니다. 관계에 추가하려면 컴포지션 단위 ID의 첫 번째 문자를 더하기 기호 문자(+)로 지정하십시오. 기존 관계에서 컴포지션 단위 ID를 제거하려면 숫자 기호 문자(#)를 지정하십시오. 예를 들어, +cuname=cu2.zip 컴포지션 단위 구문은 cu2 컴포지션 단위를 관계에 추가합니다. #cuname=cu1.zip+cuname=cu2.zip 컴포지션 단위 구문은 cu1cu2 컴포지션 단위를 관계에서 제거합니다.

일괄처리 모드 사용법 예제

Jacl 사용:

$AdminApp install myapp.ear {-SharedLibRelationship {{EJB3BNDBean.jar 
 EJB3BNDBean.jar,META-INF/ejb-jar.xml WebSphere:cuname=sharedLibCU1 "" Yes}}}

패턴 일치로 Jacl 사용:

$AdminApp install myapp.ear {-SharedLibRelationship {{.*
 EJB3BNDBean.jar,.* WebSphere:cuname=sharedLibCU1 "" Yes}}}

Jython 사용:

AdminApp.install('myapp.ear', ['-SharedLibRelationship',
 [['EJB3BNDBean,jar', 'EJB3BNDBean.jar,META-INF/ejb-jar.xml',
 'WebSphere:cuname=sharedLibCU1,' '', 'Yes']]])

패턴 일치로 Jython 사용:

AdminApp.install('myapp.ear', ['-SharedLibRelationship', [['.*',
 'EJB3BNDBean.jar,.*', 'WebSphere:cuname=sharedLibCU1', '', 'Yes']]]

서버

server 옵션은 다음 조치 중 하나를 수행할 서버의 이름을 지정합니다.
  • 새 애플리케이션을 설치하십시오.
  • 기존 애플리케이션을 해당 애플리케이션의 업데이트된 버전으로 바꾸십시오. 이러한 상황에서는 이미 설치된 버전의 애플리케이션에 없는 새 모듈이 업데이트된 버전의 애플리케이션에 포함되어 있는 경우에만 서버 옵션이 의미가 있습니다.
  • 기존 애플리케이션에 새 모듈을 추가하십시오.

-cluster 및 -server 옵션을 함께 사용할 수 없습니다. 배치 중에 생성된 plugin-cfg.xml 파일에 애플리케이션이 나타날 수 있도록 애플리케이션을 배치하고 HTTP 서버를 지정하려면, 먼저 -cluster 대상을 사용하여 애플리케이션을 설치해야 합니다. 애플리케이션을 설치한 후 저장하기 전에 AdminApp 오브젝트의 편집 명령을 사용하여 웹 서버에 맵핑을 더 추가하십시오.

일괄처리 모드 사용법 예제

Jacl 사용:

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-server server1}

Jython 사용:

AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[-server server1]')

대상

target 옵션은 AdminApp 오브젝트의 설치 함수에 대한 대상을 지정합니다. 다음은 대상 옵션에 대한 예제입니다. WebSphere:cell=mycell,node=mynode,server=myserver

대상을 더하기(+) 부호로 분리하여 복수의 대상을 지정할 수 있습니다. 기본값으로, 애플리케이션에 있는 기존의 대상 정의는 애플리케이션을 설치하거나 편집할 때 지정한 대상으로 바뀝니다. 앞에 더하기(+) 또는 빼기(-) 부호를 붙이면 변경되지 않는 대상을 지정하지 않고도 대상을 추가하거나 제거할 수 있습니다.
참고: 다중 도메인이 사용되고 있을 때 전체 대상 맵핑 구문은 MapModulesToServers 옵션과 함께 사용되어야 합니다. 다중 도메인이 사용 중이면 앞에 + 부호를 사용하여 MapModulesToServers 옵션으로 새 대상을 추가할 수 없습니다. 런타임은 배치 대상으로 맵핑되는 도메인을 올바르게 분석할 수 없습니다.

일괄처리 모드 사용법 예제

다음 예제는 server1을 애플리케이션 설치에 대한 대상 서버로 지정합니다.

Jacl 사용:

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname MyApp -target WebSphere:cell=myCell,node=myNode,server=server1}

Jython 사용:

AdminApp.install("app_server_root/installableApps/DynaCacheEsi.ear",
 ["-appname", "MyApp", "-target", "WebSphere:cell=myCell,node=myNode,server=server1"])

다음 예제는 server1server2를 애플리케이션 설치에 대한 대상 서버로 지정합니다.

Jacl 사용:
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname MyApp -target
 WebSphere:cell=myCell,node=Node1,server=server1+WebSphere:cell=Cell1,node=myNode,server=server2}
Jython 사용:
AdminApp.install("app_server_root/installableApps/DynaCacheEsi.ear",
 ["-appname", "MyApp", "-target",
 "WebSphere:cell=myCell,node=Node1,server=server1+WebSphere:cell=Cell1,node=myNode,server=server2"])

다음 예제는 설치되어 있는 애플리케이션에서 server3를 제거합니다.

Jacl 사용:
$AdminApp install
 app_server_root/binaries/DefaultApplication.ear {-appname MyApp
 -target -WebSphere:cell=GooddogCell,node=BaddogNode,server=server3
 -update -update.ignore.old}
Jython 사용:
AdminApp.install("app_server_root/binaries/DefaultApplication.ear",
 ["-appname", "MyApp",
 "-target", "-WebSphere:cell=GooddogCell,node=BaddogNode,server=server3",
 "-update", "-update.ignore.old"])

다음 예제에서는 server4를 설치되어 있는 애플리케이션에 추가합니다.

Jacl 사용:
$AdminApp update app {-appname MyApp
 -target +WebSphere:cell=GooddogCell,node=GooddogNode,server=server4
 -contents app_server_root/binaries/DefaultApplication.ear
 -operation update -update.ignore.old}
Jython 사용:
AdminApp.update("app", ["-appname", "MyApp",
 "-target", "+WebSphere:cell=GooddogCell,node=GooddogNode,server=server4",
 "-contents", "app_server_root/binaries/DefaultApplication.ear",
 "-operation", "update", "-update.ignore.old"]) 

update

update 옵션은 설치된 애플리케이션을 새 버전의 EAR(Enterprise Archive) 파일로 업데이트합니다. 이 옵션에는 값이 필요하지 않습니다.

업데이트할 애플리케이션은 appname 옵션으로 지정되며 WebSphere Application Server 구성에 이미 설치되어 있어야 합니다. 업데이트 조치는 새 버전의 바인딩과 이전 버전의 바인딩을 병합하고 이전 버전을 설치 제거한 뒤 새 버전을 설치합니다. 새 버전의 EAR 파일 또는 모듈에 있는 바인딩 정보가 이전 버전에 있는 해당 바인딩 정보보다 선호됩니다. 새 버전에서 바인딩의 어떤 요소가 누락된 경우 이전 버전의 해당 요소가 사용됩니다.

update.ignore.new

update.ignore.new 옵션은 업데이트 조치 중에 이전 버전의 애플리케이션 또는 모듈에 있는 바인딩 정보가 새 버전에 있는 해당 바인딩 정보보다 선호되도록 지정합니다. 바인딩의 요소가 이전 버전에 존재하지 않으면 새 버전의 요소가 사용됩니다. 즉, 바인딩이 이전 버전에 존재하면 새 버전의 애플리케이션 또는 모듈에 있는 바인딩이 무시됩니다. 그렇지 않은 경우 새 바인딩을 따르며 무시하지 않습니다. 이 옵션에는 값이 필요하지 않습니다.

이 옵션은 다음 항목 중 하나를 지정하는 경우에만 적용됩니다.
  • install 명령의 update 옵션
  • update 명령에 대한 컨텐츠 유형으로 modulefile 또는 app

update.ignore.old

update.ignore.old 옵션은 업데이트 조치 중에 새 버전의 애플리케이션 또는 모듈에 있는 바인딩 정보가 이전 버전에 있는 해당 바인딩 정보보다 선호되도록 지정합니다. 이전 버전의 애플리케이션 또는 모듈에 있는 바인딩이 무시됩니다. 이 옵션에는 값이 필요하지 않습니다. 이 옵션은 다음 항목 중 하나를 지정하는 경우에만 적용됩니다.
  • install 명령의 update 옵션
  • update 명령에 대한 컨텐츠 유형으로 modulefile 또는 app

useAutoLink

EJB 3.0 이전 EJB 모듈 버전 및 버전 2.4 이전 웹 모듈 버전의 EJB(Enterprise JavaBeans) 참조를 자동으로 해석하려면 useAutoLink 옵션을 사용합니다. useAutoLink 옵션을 사용하는 경우 선택적으로 MapEJBRefToEJB 옵션의 JNDI 이름을 지정할 수 있습니다. 자동 링크 지원을 사용하려면 애플리케이션의 각 모듈이 하나의 공통 대상을 공유해야 합니다.

일괄처리 모드 사용법 예제

Jacl 사용:

[Windows]
$AdminApp install C:/myapp.ear {-useAutoLink} 
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install /myapp.ear {-useAutoLink} 

Jython 사용:

[Windows]
AdminApp.install('C:/myapp.ear','[-useAutoLink]') 
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear','[-useAutoLink]') 

usedefaultbindings

usedefaultbindings 옵션은 설치 시 기본 바인딩을 사용하도록 지정합니다. 이 옵션에는 값이 필요하지 않습니다. 기본 설정은 nousedefaultbindings입니다.

새 활성화 스펙을 사용하거나 작성하는 대신 기존 리스너 포트를 사용하려면 EJB JAR 버전이 2.1보다 이전 버전인지 여부를 판별하십시오. 애플리케이션을 배치하는 데 -usedefaultbindings 옵션을 지정하면 시스템이 자동으로 활성화 스펙을 작성하여 사용합니다. 활성화 스펙이 있는 경우, 시스템은 리스너 포트를 무시하고 활성화 스펙을 대신 사용합니다. 새 활성화 스펙 대신 정의된 리스너 포트를 사용하여 2.1 이상의 EJB JAR 버전으로 애플리케이션을 배치하려면, 관심있는 프로파일의 특성 디렉토리에 있는 wsadmin.properties 파일에서 com.ibm.websphere.management.application.dfltbndng.mdb.preferexisting 시스템 특성을 true로 설정하십시오.

useMetaDataFromBinary

useMetaDataFromBinary 옵션은 런타임에 사용되는 메타데이터(예를 들어, 배치 디스크립터, 바인딩, 확장자 등)가 EAR 파일에 있음을 지정합니다. 이 옵션에는 값이 필요하지 않습니다. 기본값은 nouseMetaDataFromBinary이며 런타임에 사용되는 메타데이터가 구성 저장소에 있음을 의미합니다.

validateinstall

validateinstall 옵션은 애플리케이션 설치의 유효성 검증 레벨을 지정합니다. 유효한 옵션은 다음과 같습니다.
  • off - 애플리케이션 배치 유효성 검증을 하지 않음을 지정합니다. 이 값이 기본값입니다.
  • warn - 애플리케이션 배치 유효성 검증을 수행하고 보고된 경고 또는 오류 메시지가 있는 경우에도 애플리케이션 배치 프로세스를 계속합니다.
  • fail - 보고된 경고 또는 오류 메시지가 있는 경우 애플리케이션 배치 유효성 검증을 수행하고 애플리케이션 배치 프로세스를 중단합니다.

validateSchema

validateSchema 옵션은 배치 디스크립터를 공개된 Java EE 배치 디스크립터 스키마에 대해 유효성을 검증하도록 지정합니다. 이 애플리케이션 배치 옵션을 선택한 경우 제품은 각 배치 디스크립터를 분석하여 배치 디스크립터의 Java EE 스펙 버전을 판별하고, 해당하는 스키마를 선택한 다음, Java EE 배치 디스크립터 스키마에 대한 배치 디스크립터를 검사합니다. 유효성 검증 오류가 있으면 오류 메시지가 표시됩니다.

이 옵션에는 값이 필요하지 않습니다. 기본값은 novalidateSchema입니다. 기본적으로 배치 및 제품에서 배치 디스크립터의 유효성을 검증하지 않는 동안 validateSchema 옵션은 무시됩니다.

verbose

verbose 옵션을 선택하면 설치 시 추가 메시지가 표시됩니다. 이 옵션에는 값이 필요하지 않습니다.

WebServicesClientBindDeployedWSDL

WebServicesClientBindDeployedWSDL 옵션은 수정하는 클라이언트 웹 서비스를 식별합니다. 범위 지정 필드로는 모듈, EJB 및 웹 서비스가 있습니다. 이 태스크에 대해 변경되는 하나의 값은 배치된 WSDL 파일 이름입니다. 클라이언트가 사용하는 WSDL(Web Services Description Language)을 표시합니다.

모듈 필드는 애플리케이션에서 엔터프라이즈 또는 웹 애플리케이션을 식별합니다. 모듈이 엔터프라이즈 Bean일 경우, EJB 필드는 모듈에서 특정 엔터프라이즈 Bean을 식별합니다. 웹 서비스 필드는 엔터프라이즈 Bean 또는 웹 애플리케이션 모듈에서 웹 서비스를 식별합니다. 이 ID는 WSDL 파일의 wsdl:service 속성에 해당하며 service/ 접두부가 있습니다(예: service/WSLoggerService2).

배치된 WSDL 속성은 클라이언트 모듈에 대해 WSDL 파일의 이름을 지정합니다. 웹 애플리케이션의 배치된 WSDL 예로는 WEB-INF/wsdl/WSLoggerService가 있습니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindDeployedWSDL {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 META-INF/wsdl/DeployedWsdl1.wsdl}}}
패턴 일치로 Jacl 사용:
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindDeployedWSDL {{.*  .*  .*  
 META-INF/wsdl/DeployedWsdl1.wsdl}}}
다음 예는 BindJndiForEJBNonMessageBinding, Hermaphrodite 및 WebServicesClientBindDeployedWSDL 옵션을 설명합니다.
$AdminApp install WebServicesSamples.ear {
-WebServicesClientBindDeployedWSDL {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 META-INF/wsdl/DeployedWsdl1.wsdl}} 
-BindJndiForEJBNonMessageBinding {{ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml
jndi1 "" "" } { "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" }{ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" }}
-MapWebModToVH {{ "module_name" web_services.war,WEB-INF/web.xml default_host }
 { "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host }
 { "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host }} } 
Jython 사용:
AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindDeployedWSDL 
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 META-INF/wsdl/DeployedWsdl1.wsdl]]]') 
WebServicesSamples.ear 샘플을 설치하려면, WebServicesClientBindDeployedWSDL 옵션뿐만 아니라 BindJndiForEJBNonMessageBinding 및 MapWebModToVH 옵션도 지정해야 합니다.
$AdminApp install WebServicesSamples.ear', '[ 
-WebServicesClientBindDeployedWSDL [[ AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 META-INF/wsdl/DeployedWsdl1.wsdl ]] 
-BindJndiForEJBNonMessageBinding [[ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml
jndi1 "" "" ] [ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" ][ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" ]]
-MapWebModToVH [[ "module_name" web_services.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host ]]]' ) 
패턴 일치로 Jython 사용:
AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindDeployedWSDL',
['.*', '.*', '.*',  'META-INF/wsdl/DeployedWsdl1.wsdl']]])

WebServicesClientBindPortInfo

WebServicesClientBindPortInfo 옵션은 수정하는 클라이언트 웹 서비스의 포트를 식별합니다. 범위 지정 필드로는 모듈, EJB, 웹 서비스 및 포트가 있습니다. 이 태스크의 변경 가능한 값은 동기화 제한시간, BasicAuth ID, BasicAuth 비밀번호, SSL 구성, 대체된 엔드포인트 URI입니다. 기본 인증 및 SSL(Secure Sockets Layer) 필드는 웹 서비스 보안이 아닌 전송 레벨 보안에 영향을 줍니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPortInfo {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS 3000 newHTTP_ID newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}}}
WebServicesSamples.ear 샘플을 설치하려면, WebServicesClientBindPortInfo 옵션뿐만 아니라 BindJndiForEJBNonMessageBinding 및 MapWebModToVH 옵션도 지정해야 합니다.
$AdminApp install WebServicesSamples.ear {
-WebServicesClientBindPortInfo {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 WSLoggerJMS 3000 newHTTP_ID newHTTP_pwd sslAliasConfig
 http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}} 
-BindJndiForEJBNonMessageBinding {{ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml
 jndi1 "" "" }
 { "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" }{ "Address Book Sample
 EJB" com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" }}
-MapWebModToVH {{ "module_name" web_services.war,WEB-INF/web.xml default_host }
 { "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host }
 { "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host }} } 
패턴 일치로 Jacl 사용:
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPortInfo {{.*  .*  .*  .*  3000 
 newHTTP_ID newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}}}
Jython 사용:
AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindPortInfo [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS 3000 newHTTP_ID newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS]]]')
WebServicesSamples.ear 샘플을 설치하려면, WebServicesClientBindPortInfo 옵션뿐만 아니라 BindJndiForEJBNonMessageBinding 및 MapWebModToVH 옵션도 지정해야 합니다.
AdminApp.install('WebServicesSamples.ear', '[ 
-WebServicesClientBindPortInfo [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS
 3000 newHTTP_ID newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS ]] 
-BindJndiForEJBNonMessageBinding [[ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml jndi1 "" "" ]
 [ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" ][ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" ]]
-MapWebModToVH [[ "module_name" web_services.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host ]]]' )
패턴 일치로 Jython 사용:
AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindPortInfo',
 [['.*', '.*', '.*', '.*', '3000', 'newHTTP_ID', 'newHTTP_pwd', 'sslAliasConfig',
 'http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS']]])

WebServicesClientBindPreferredPort

WebServicesClientBindPreferredPort 옵션은 선호 포트(구현)를 클라이언트 웹 서비스의 포트 유형(인터페이스)과 연관시킵니다. 변경되지 않는 값은 수정 중인 클라이언트 웹 서비스의 포트 유형을 식별합니다. 범위 지정 필드로는 모듈, EJB, 웹 서비스 및 포트 유형이 있습니다. 이 태스크에 대해 변경되는 값은 포트입니다.
  • 포트 유형 - WSDL 파일에서 인터페이스를 식별하는 wsdl:portType 속성에 의해 정의된 포트 유형의 QName("{namespace} localname")
  • 포트 - 환경 설정이 있는 구현을 식별하는 WSDL 파일에서 wsdl:service 속성 내의 wsdl:port 속성에 의해 정의된 포트 QName

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPreferredPort 
 {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort}}} 
WebServicesSamples.ear 샘플을 설치하려면, WebServicesClientBindPreferredPort 옵션뿐만 아니라 BindJndiForEJBNonMessageBinding 및 MapWebModToVH 옵션도 지정해야 합니다.
$AdminApp install WebServicesSamples.ear
{-WebServicesClientBindPreferredPort {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 WSLoggerJMS WSLoggerJMSPort}}
-BindJndiForEJBNonMessageBinding {{ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml jndi1 "" "" }
 { "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" }{ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" }}
-MapWebModToVH {{ "module_name" web_services.war,WEB-INF/web.xml default_host }
 { "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host }
 { "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host }} } 
패턴 일치로 Jacl 사용:
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPreferredPort {{.* .* .* .* 
 WSLoggerJMSPort}}}
Jython 사용:
AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindPreferredPort 
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort]]]') 
WebServicesSamples.ear 샘플을 설치하려면, WebServicesClientBindPreferredPort 옵션뿐만 아니라 BindJndiForEJBNonMessageBinding 및 MapWebModToVH 옵션도 지정해야 합니다.
AdminApp.install('WebServicesSamples.ear',
'[ -WebServicesClientBindPreferredPort
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort ]]
-BindJndiForEJBNonMessageBinding [[ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml jndi1 "" "" ]
 [ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" ][ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" ]]
-MapWebModToVH [[ "module_name" web_services.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host ]]]' )
패턴 일치로 Jython 사용:
AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindPreferredPort',
 [['.*', '.*', '.*', '.*', 'WSLoggerJMSPort']]])

WebServicesServerBindPort

WebServicesServerBindPort 옵션은 웹 서비스 포트의 두 속성을 설정합니다. 변경되지 않는 값은 수정 중인 웹 서비스의 포트를 식별합니다. 범위 지정 필드로는 모듈, 웹 서비스 및 포트가 있습니다. 변경되는 값으로는 WSDL 서비스 이름범위가 있습니다.

범위가 Java Bean을 구현하는 라이프사이클을 판별합니다. 유효한 값으로는 요청(요청마다 새 인스턴스), 애플리케이션(웹 애플리케이션마다 하나의 인스턴스) 및 세션(HTTP 세션마다 새 인스턴스)입니다.

범위 속성은 JMS(Java Message Service)가 전송하는 웹 서비스에 적용되지 않습니다. 범위 속성은 엔터프라이즈 Bean에 적용되지 않습니다.

WSDL 서비스 이름은 동일한 포트 이름을 갖는 둘 이상의 서비스를 식별합니다. WSDL 서비스 이름은 QName 문자열로 표시됩니다(예: {namespace}localname).

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp install WebServicesSamples.ear {-WebServicesServerBindPort 
 {{AddressBookW2JE.jar service/WSLoggerService2 WSLoggerJMS {} Session}}}
패턴 일치로 Jacl 사용:
$AdminApp install WebServicesSamples.ear {-WebServicesServerBindPort 
 {{.*  WSClientTestService WSClientTest Request} {.*  StockQuoteService StockQuote Application}
 {.*  StockQuoteService StockQuote2 Session}}}
Jython 사용:
AdminApp.install('WebServicesSamples.ear', '[-WebServicesServerBindPort [[AddressBookW2JE.jar service/WSLoggerService2 WSLoggerJMS "" Session]]]')
패턴 일치로 Jython 사용:
AdminApp.install('WebServicesSamples.ear', ['-WebServicesServerBindPort',
 [['.*', 'WSClientTestService', 'WSClientTest', 'Request'], 
 ['.*', 'StockQuoteService', 'StockQuote', 'Application'],
 ['.*', 'StockQuoteService', 'StockQuote2', 'Session']]])

WebServicesClientCustomProperty

WebServicesClientCustomProperty 옵션은 웹 서비스의 클라이언트 바인드 파일 설명에 대한 이름 값 매개변수의 구성을 지원합니다. 변경되지 않는 값은 수정 중인 웹 서비스의 포트를 식별합니다. 범위 지정 필드로는 모듈, 웹 서비스 및 포트가 있습니다. 변경되는 값으로는 namevalue가 있습니다.

namevalue 값의 형식에는 분리자로 + 문자를 사용하여 여러 개의 이름 및 값 쌍을 표시하는 문자열이 포함됩니다. 예를 들어, 이름 문자열이 "n1+n2+n3", 값 문자열이 "v1+v2+v3"이면 이름/값 쌍은 {{"n1" "v1"}, {"n2" "v2"}, {"n3" " v3"}}입니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp edit WebServicesSamples {-WebServicesClientCustomProperty 
 {{join.jar com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest service/StockQuoteService
 STockQuote propname1 propValue1}
{ejbclientonly.jar Exchange service/STockQuoteService STockQuote propname2 propValue2}}}
패턴 일치로 Jacl 사용:
$AdminApp edit WebServicesSamples {-WebServicesClientCustomProperty 
 {{join.jar com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest .* .* propname1 propValue1}
 {ejbclientonly.jar Exchange .* .* propname2 propValue2}}}
Jython 사용:
AdminApp.edit('WebServicesSamples', ['-WebServicesClientCustomProperty', 
 [['join.jar', 'com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest', 
 'service/StockQuoteService', 'STockQuote', 'propname1', 'propValue1'],
 ['ejbclientonly.jar', 'Exchange', 'service/STockQuoteService', 'STockQuote', 
 'propname2', 'propValue2']]])
패턴 일치로 Jython 사용:
AdminApp.edit('WebServicesSamples', ['-WebServicesClientCustomProperty', 
 [['join.jar', 'com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest', 
 '.*', '.*', 'propname1', 'propValue1'],
 ['ejbclientonly.jar', 'Exchange', '.*', '.*', 'propname2', 'propValue2']]])

WebServicesServerCustomProperty

WebServicesServerCustomProperty 옵션은 웹 서비스의 서버 바인드 파일 설명에 대한 이름 값 매개변수의 구성을 지원합니다. 범위 지정 필드로는 모듈, EJB 및 서비스가 있습니다. 이 태스크에 대해 변경되는 값은 namevalue입니다.

이러한 값의 형식에는 분리자로 더하기(+) 문자를 사용하여 여러 개의 이름 및 값 쌍을 표시하는 문자열이 포함됩니다. 예를 들어, 이름 문자열이 "n1+n2+n3", 값 문자열이 "v1+v2+v3"이면 이름/값 쌍은 {{"n1" "v1"}, {"n2" "v2"}, {"n3" " v3"}}입니다.

일괄처리 모드 사용법 예제

Jacl 사용:
$AdminApp edit WebServicesSamples {-WebServicesServerCustomProperty 
 {{AddressBookW2JE.jar AddressBookService AddressBook 
 com.ibm.websphere.webservices.http.responseContentEncoding deflate}}}
패턴 일치로 Jacl 사용:
$AdminApp edit WebServicesSamples {-WebServicesServerCustomProperty 
 {{.* .* .* com.ibm.websphere.webservices.http.responseContentEncoding deflate}}}
Jython 사용:
AdminApp.edit ( 'WebServicesSamples', '[ -WebServicesServerCustomProperty 
 [[AddressBookW2JE.jar AddressBookService AddressBook 
 com.ibm.websphere.webservices.http.responseContentEncoding deflate]]]')
패턴 일치로 Jython 사용:
AdminApp.edit ( 'WebServicesSamples', ['-WebServicesServerCustomProperty', [['.*', '.*',
 '.*', 'com.ibm.websphere.webservices.http.responseContentEncoding', 'deflate']]])

주제 유형을 표시하는 아이콘 참조 주제



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