wsadmin 스크립트를 사용하는 AdminTask 오브젝트에 대한 BLAManagement 명령 그룹

wsadmin 도구를 통해 비즈니스 레벨 애플리케이션을 구성하고 관리하는 데 Jython 스크립트 언어를 사용할 수 있습니다. BLAManagement 그룹의 명령 및 매개변수를 사용하여 구성에 있는 비즈니스 레벨 애플리케이션을 작성, 편집, 내보내기, 삭제 및 조회하십시오.

비즈니스 레벨 애플리케이션을 구성하고 관리하려면 구성자 관리 역할을 사용해야 합니다.

자산은 자산 저장소에 저장된 하나 이상의 애플리케이션 2진 파일을 나타냅니다. 일반적인 자산으로는 엔터프라이즈 아카이브, 라이브러리 파일 및 기타 자원 파일과 같은 애플리케이션 비즈니스 로직이 있습니다. 다음 명령을 사용하여 자산 구성을 관리하십시오.
비즈니스 레벨 애플리케이션은 0개 이상의 컴포지션 단위 또는 기타 비즈니스 레벨 애플리케이션으로 구성된 구성 아티팩트입니다. 비즈니스 레벨 애플리케이션은 애플리케이션을 정의하는 관리 모델이며 엔터프라이즈 아카이브(EAR) 파일, 공유 라이브러리, PHP 애플리케이션 등을 포함할 수 있습니다. 다음 명령을 사용하여 비즈니스 레벨 애플리케이션을 구성 및 관리하십시오.
컴포지션 단위는 비즈니즈 레벨 애플리케이션에 있는 자산을 나타냅니다. 컴포지션 단위는 애플리케이션에 포함된 자산 컨텐츠와 다른 자산과의 상호 작용을 가능하게 하며, 제품 런타임에서 자산 컨텐츠를 로드하고 실행할 수 있게 합니다. 다음 명령을 사용하여 컴포지션 단위 구성을 관리하십시오.

deleteAsset

deleteAsset 명령은 비즈니스 레벨 애플리케이션 구성에서 자산을 제거합니다. 이 명령을 사용하기 전에 관심있는 자산에 연관된 컴포지션 단위가 없는지 확인하십시오. 자산이 컴포지션 단위와 연관되는 경우 명령이 실패합니다.

대상 오브젝트

없음

필수 매개변수

-assetID
삭제할 자산의 구성 ID를 지정합니다. 시스템이 고유 자산에 문자열을 일치시킬 수 있는 경우 명령이 assetID 매개변수의 불완전한 ID를 승인합니다. (문자열, 필수)

선택적 매개변수

-force
기타 자산이 이 자산에 종속되는 경우에도 시스템이 자산을 강제로 삭제하는지 여부를 지정합니다. (부울, 선택적)

리턴값

명령은 삭제된 자산의 구성 ID를 다음 예제와 같이 리턴합니다.
WebSphere:assetname=asset2.zip

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.deleteAsset('-assetID asset2.zip -force true')
  • Jython 목록 사용:
    AdminTask.deleteAsset(['-assetID', 'asset2.zip', '-force', 'true'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.deleteAsset('-interactive')

editAsset

editAsset 명령은 추가 자산 구성 옵션을 수정합니다. 이 명령을 사용하여 설명, 대상 URL, 자산 관계, 파일 사용 권한 및 유효성 검증 설정을 수정할 수 있습니다.

대상 오브젝트

없음

필수 매개변수

-assetID
편집할 자산의 구성 ID를 지정합니다. 시스템이 고유 자산 ID에 문자열을 일치시킬 수 있는 경우 이 매개변수가 불완전한 구성 ID를 승인합니다. (문자열, 필수)

선택적 단계

선택적 단계로, .* 문자를 지정하면 명령 구문에 읽기 전용 인수가 지정되고, "" 문자로 빈 문자열을 지정하면 기존 인수 값이 보존됩니다. 쓰기 가능한 인수에 대해 값이나 빈 문자열을 지정하지 않으면 명령이 인수를 널값으로 재설정합니다.
-AssetOptions
AssetOptions 단계 및 다음 인수를 사용하여 자산의 추가 특성을 설정하십시오.
inputAsset(읽기 전용)
자산의 소스 패키지를 지정합니다.
name(읽기 전용)
자산의 이름을 지정합니다. 이 인수의 기본값은 소스 패키지의 파일 이름입니다.
defaultBindingProps(읽기 전용)
자산에 대한 기본 바인딩 특성을 지정합니다. 이 인수는 엔터프라이즈 자산에만 적용됩니다. 엔터프라이즈 자산이 아닌 자산의 경우 패턴 일치에 사용하도록 별표 문자(*)를 지정하십시오. 엔터프라이즈 자산의 경우 .* 값을 지정하여 인수를 비어 있지 않은 값으로 설정하십시오.
설명
자산에 대한 설명을 지정합니다.
destinationUrl
배치할 자산 2진의 URL을 지정합니다.
typeAspect
자산 유형 측면을 지정합니다.
relationship
자산 관계를 지정합니다. 더하기 부호 문자(+)를 사용하여 기존 관계에 추가 자산을 추가하십시오. 번호 부호 문자(#)를 사용하여 관계에서 기존 자산을 삭제하십시오. 기존 관계를 대체하려면 importAsset 명령에서와 동일한 구문을 지정하십시오. 추가 또는 업데이트용으로 관계에 지정된 자산이 없으면 명령이 예외를 리턴합니다.
filePermission
파일 사용 권한 구성을 지정합니다.
validate
자산의 유효성 검증 여부를 지정합니다. 기본값은 false입니다. 제품이 validate에 지정된 값을 저장하지 않습니다. 따라서 지금 자산의 유효성을 검증하고(true) 나중에 자산을 편집하도록 선택할 경우 자산을 편집할 때 제품에 대해 이 설정을 다시 사용 가능하게 설정하여 업데이트된 파일의 유효성을 검증해야 합니다.
-UpdateAppContentVersions
EBA 자산의 경우 이 단계와 다음 인수를 사용하여 자산의 번들 버전을 선택하십시오.
전이 사용자용 전이 사용자용: WebSphere® Application Server 버전 7 Feature Pack for OSGi Applications 및 Java™ Persistence API 2.0에서 자산에 대한 번들 변경사항은 비즈니스 레벨 애플리케이션을 다시 시작하여 적용합니다. 버전 8.x에서 이러한 변경사항이 컴포지션 단위를 업데이트하여 적용됩니다. 버전 8.x의 새 접근방식은 많은 번들 변경사항이 실행 중인 비즈니스 레벨 애플리케이션을 다시 시작하지 않고 적절하게 적용될 수 있다는 것을 의미합니다. 이 새 방법을 사용하도록 UpdateAppContentVersionsStep 매개변수를 UpdateAppContentVersions 매개변수로 대체하고 비즈니스 레벨 애플리케이션을 다시 시작하는 대신 editCompUnit 명령을 CompUnitStatusStep 매개변수와 함께 실행합니다. trns
bundle_name
번들의 이름을 지정합니다.
current_version
애플리케이션 Manifest에 선언되어 있지만 런타임 환경이 배치하지 않은 공유 번들(즉, 사용 번들)의 번들 버전 번호(예: 1.0.0 또는 NOT_DEPLOYED)를 지정합니다. 이 인수는 번들의 현재 구성에 대해 설명하고 구성을 변경하는 데 사용하지 않습니다.
update_preference
새 번들 버전 환경 설정을 지정합니다. 공유 번들의 번들 버전 번호(예: 1.0.0 또는 NOT_DEPLOYED) 또는 시스템이 번들 버전을 선택하도록 하려는 경우 NO_PREF입니다. 주어진 번들의 버전을 업데이트하지 않으려면 이 속성을 current_version 속성에 사용하는 값과 동일하게 설정하십시오.
애플리케이션 컨텐츠 헤더와 사용 번들 헤더 사이의 애플리케이션 Manifest에 나열된 각 번들의 항목(즉, bundle_name current_versionupdate_preference)을 포함하십시오. 번들 버전을 업데이트하는지 여부에 상관없이 모든 번들을 포함하십시오.
다음과 같이 구문을 지정하십시오.
AdminTask.editAsset('[
  -assetID asset_name 
  -UpdateAppContentVersions [
    [bundle_1_name current_version update_preference]
    [bundle_2_name current_version update_preference]
    [bundle_3_name current_version update_preference]
    [bundle_4_name current_version update_preference]
    [bundle_5_name current_version update_preference]
  ]]')

리턴값

명령은 원하는 자산의 구성 ID를 리턴합니다.

일괄처리 모드 사용법 예제

다음 예제를 사용하여 비엔터프라이즈 자산을 편집하십시오.
  • Jython 문자열 사용:
    AdminTask.editAsset('-assetID asset3.zip – AssetOptions [[.* asset3.zip * "asset for testing"
       c:/installedAssets/asset3.zip/BASE/asset3.zip "" assetname=a.jar "" false]]')
  • Jython 목록 사용:
    AdminTask.editAsset(['-assetID', 'asset3.zip', '–AssetOptions', '[[.* asset3.zip * "asset for testing"
       c:/installedAssets/asset3.zip/BASE/asset3.zip "" assetname=a.jar "" false]]'])
다음 예제를 사용하여 엔터프라이즈 자산을 편집하십시오.
  • Jython 문자열 사용:
    AdminTask.editAsset('-assetID defaultapp.ear – AssetOptions 
      [[.* defaultapp.ear .* "asset for testing" "" "" "" "" false]]')
  • Jython 목록 사용:
    AdminTask.editAsset(['-assetID', 'defaultapp.ear', '–AssetOptions', 
       '[[.* defaultapp.ear .* "asset for testing" "" "" "" "" false]]'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.editAsset('-interactive')

exportAsset

exportAsset 명령은 자산 구성을 파일로 내보냅니다.

대상 오브젝트

없음

필수 매개변수

-assetID
내보낼 자산의 구성 ID를 지정합니다. ID가 고유 자산과 일치하는 경우 이 매개변수가 불완전한 구성 ID를 승인합니다. (문자열, 필수).
-filename
시스템에서 자산 구성을 내보낼 파일 이름을 지정합니다. (DownloadFile, 필수)

리턴값

명령은 출력을 리턴하지 않습니다.

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.exportAsset('-assetID asset2.zip – filename c:/temp/a2.zip')
  • Jython 목록 사용:
    AdminTask.exportAsset(['-assetID', 'asset2.zip', '–filename', 'c:/temp/a2.zip'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.exportAsset('-interactive')

importAsset

importAsset 명령은 자산 구성을 자산 저장소로 가져옵니다. 자산을 가져온 후에는 자산을 컴포지션 단위로 비즈니스 레벨 애플리케이션에 추가할 수 있습니다.

대상 오브젝트

없음

필수 매개변수

-source
가져올 소스 파일의 이름을 지정합니다. (UploadFile, 필수)

선택적 매개변수

-storageType
시스템이 자산 저장소에 자산을 저장하는 방식을 지정합니다. 기본 자산 저장소는 전체 2진 또는 2진 메타데이터를 저장하거나 2진을 저장하지 않습니다. 전체 2진을 저장하려면 FULL을 지정하십시오. 2진의 메타데이터 부분을 저장하려면 METADATA를 지정하십시오. 자산 저장소에 2진을 저장하지 않으려면 NONE을 지정하십시오. 기본값은 FULL입니다. (문자열, 선택적)

선택적 단계

선택적 단계로, .* 문자를 지정하면 명령 구문에 읽기 전용 인수가 지정되고, "" 문자로 빈 문자열을 지정하면 기존 인수 값이 보존됩니다. 쓰기 가능한 인수에 대해 값이나 빈 문자열을 지정하지 않으면 명령이 인수를 널값으로 재설정합니다.
-AssetOptions
AssetOptions 단계 및 다음 인수를 사용하여 자산의 추가 특성을 설정하십시오.
inputAsset(읽기 전용)
자산의 소스 패키지를 지정합니다.
이름
자산의 이름을 지정합니다. 자산의 확장 파일 이름은 소스 패키지의 확장 파일 이름과 일치해야 합니다. 이 인수의 기본값은 소스 패키지의 파일 이름입니다.
defaultBindingProps(읽기 전용)
자산에 대한 기본 바인딩 특성을 지정합니다. 이 인수는 엔터프라이즈 자산에만 적용됩니다. 엔터프라이즈 자산이 아닌 자산의 경우 패턴 일치에 사용하도록 별표 문자(*)를 지정하십시오. 엔터프라이즈 자산의 경우 .* 값을 지정하여 인수를 비어 있지 않은 값으로 설정하십시오.
설명
자산에 대한 설명을 지정합니다.
destinationUrl
배치할 자산 2진의 URL을 지정합니다.
typeAspect
자산 유형 측면을 지정합니다. 다음 구문과 같이 오브젝트 이름 형식으로 typeAspect 옵션을 지정하십시오. spec=xxx
relationship
자산 관계를 지정합니다. 더하기 부호 문자(+)를 사용하여 여러 자산 관계를 지정하십시오. 존재하지 않는 관계에 자산을 지정하는 경우 명령이 예외를 리턴합니다.
filePermission
파일 사용 권한 구성을 지정합니다.

OSGi 애플리케이션에서는 filePermission 값을 사용하지 않습니다.

validate
자산의 유효성 검증 여부를 지정합니다. 기본값은 false입니다. 제품이 validate에 지정된 값을 저장하지 않습니다. 따라서 지금 자산의 유효성을 검증하고(true) 나중에 자산을 편집하도록 선택할 경우 자산을 편집할 때 제품에 대해 이 설정을 다시 사용 가능하게 설정하여 업데이트된 파일의 유효성을 검증해야 합니다.

OSGi 애플리케이션에서는 validate 값을 사용하지 않습니다.

리턴값

명령은 시스템에서 작성한 자산의 구성 ID를 다음 예제와 같이 리턴합니다.
WebSphere:assetname=asset2.zip

일괄처리 모드 사용법 예제

다음 예제를 사용하여 비엔터프라이즈 자산을 가져오십시오.
  • Jython 문자열 사용:
    AdminTask.importAsset('-source c:\ears\asset1.zip -storageType NONE')
  • Jython 목록 사용:
    AdminTask.importAsset(['-source', 'c:\ears\asset1.zip', '-storageType', 'NONE'])
다음 예제를 사용하여 비엔터프라이즈 자산을 가져오고 asset2.zip을 자산 이름으로 설정하며 메타데이터 2진을 자산 저장소에 저장하고 배치할 2진 대상 디렉토리를 설정하십시오.
  • Jython 문자열 사용:
    AdminTask.importAsset('-source c:\ears\asset1.zip -storageType METADATA – AssetOptions 
      [[.* asset2.zip .* "asset for testing" c:/installedAssets/asset2.zip/BASE/asset2.zip "" "" "" "" false]]')
  • Jython 목록 사용:
    AdminTask.importAsset(['-source', 'c:\ears\asset1.zip', '-storageType', 'METADATA', '–AssetOptions',
       '[[.* asset2.zip .* "asset for testing" c:/installedAssets/asset2.zip/BASE/asset2.zip "" "" "" "" false]]')
다음 예제를 사용하여 비엔터프라이즈 자산을 가져오고 a.jarb.jar 자산으로 자산 관계를 지정하십시오.
  • Jython 문자열 사용:
    AdminTask.importAsset('[-source c:\ears\asset3.zip -storageType FULL – AssetOptions
       [[.* asset3.zip .* "asset for testing" "" spec=zip assetname=a.jar+assetname=b.jar "" false]]]')
  • Jython 목록 사용:
    AdminTask.importAsset(['-source', 'c:\ears\asset3.zip', '-storageType', 'FULL', '–AssetOptions', 
      '[[.* asset3.zip .* "asset for testing" "" spec=zip assetname=a.jar+assetname=b.jar "" false]]'])
다음 예제를 사용하여 엔터프라이즈 자산을 가져오십시오.
  • Jython 문자열 사용:
    AdminTask.importAsset('-source c:\ears\defaultapplication.ear – storageType FULL – AssetOptions
       [[.* defaultapp.ear .* "desc" "" "" "" false]]')
  • Jython 목록 사용:
    AdminTask.importAsset(['-source', 'c:\ears\defaultapplication.ear', '–storageType', 
      'FULL', '–AssetOptions', '[[.* defaultapp.ear .* "desc" "" "" "" false]]'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.importAsset('-interactive')

listAssets

listAssets 명령은 셀에 있는 각 자산의 구성 ID를 표시합니다.

대상 오브젝트

없음

선택적 매개변수

-assetID
원하는 자산의 구성 ID를 지정합니다. ID가 고유 자산과 일치하는 경우 이 매개변수가 불완전한 구성 ID를 승인합니다. (문자열, 선택적)
-includeDescription
명령이 리턴하는 각 자산의 설명을 포함하는지 여부를 지정합니다. 자산 설명을 표시하려면 true를 지정하십시오. (문자열, 선택적)
-includeDeplUnit
명령이 리턴하는 각 자산의 배치 가능한 단위를 표시하는지 여부를 지정합니다. 배치 가능 단위를 표시하려면 true를 지정하십시오. (문자열, 선택적)

리턴값

명령은 원하는 자산의 구성 ID 목록을 리턴합니다. 지정된 매개변수 값에 따라 다음 예제가 표시하는 대로 명령이 각 자산의 설명 및 배치 가능한 컴포지션 단위를 표시할 수 있습니다.
WebSphere:assetname=asset1.zip
"asset for testing"

WebSphere:assetname=asset2.zip
"second asset for testing"
a.jar

WebSphere:aasetname=asset3.zip
"third asset for testing"
a1.jar+a2.jar

WebSphere:assetname=a.jar0
"a.jar for sharedlib"

WebSphere:assetname=b.jar
"b.jar for sharedlib"

WebSphere:assetname=defaultapp.ear
"default app"

일괄처리 모드 사용법 예제

다음 예를 사용하여 셀의 각 자산을 나열하십시오.
  • Jython 사용:
    AdminTask.listAssets()
다음 예를 사용하여 셀의 각 자산을 나열하십시오.
  • Jython 문자열 사용:
    AdminTask.listAssets('-assetID asset1.zip')
  • Jython 목록 사용:
    AdminTask.listAssets(['-assetID asset1.zip'])
다음 예를 사용하여 셀의 각 자산, 자산 설명 및 배치 가능한 컴포지션 단위를 나열하십시오.
  • Jython 문자열 사용:
    AdminTask.listAssets('-includeDescription true – includeDeplUnit true')
  • Jython 목록 사용:
    AdminTask.listAssets(['-includeDescription', 'true', '–includeDeplUnit', 'true')

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.listAssets('-interactive')

updateAsset

updateAsset 명령은 자산의 하나 이상의 파일 또는 모듈 파일을 수정합니다. 명령은 자산 2진 파일을 업데이트하지만 자산에 보조 오브젝트로 배치된 컴포지션 단위는 업데이트하지 않습니다.

대상 오브젝트

없음

필수 매개변수

-assetID
업데이트할 자산의 구성 ID를 지정합니다. ID가 고유 자산과 일치하는 경우 이 매개변수가 불완전한 구성 ID를 승인합니다. (문자열, 필수).
-operation
원하는 자산에서 호출할 조작을 지정합니다. (문자열, 필수).
다음 테이블은 자산에서 호출할 수 있는 각 조작을 표시합니다.
표 1. updateAsset 지원 조작. 조작 중 하나를 지정하십시오.
조작 설명
replace replace 조작은 관심있는 자산의 컨텐츠를 바꿉니다.
merge merge 조작은 자산의 여러 파일을 업데이트하지만 모든 파일을 업데이트하지는 않습니다.
add add 조작은 새 파일 또는 모듈 파일을 추가합니다.
addupdate addupdate 조작은 하나의 파일 또는 모듈 파일을 추가하거나 업데이트합니다. 파일이 없으면 컨텐츠를 추가합니다. 파일이 있으면 파일을 업데이트합니다.
update update 조작은 하나의 파일 또는 모듈 파일을 업데이트합니다.
삭제 delete 조작은 하나의 파일 또는 모듈 파일을 삭제합니다.
-contents
추가하거나 업데이트할 컨텐츠가 포함된 파일을 지정합니다. 이 매개변수는 delete 조작에 필요하지 않습니다. (UploadFile, 선택적)

선택적 매개변수

-contenturi
자산에 추가하거나 업데이트하거나 또는 자산에서 제거할 파일의 URI(Uniform Resource Identifier)를 지정합니다. 이 매개변수는 merge 또는 replace 조작에 필요하지 않습니다. (문자열, 선택적)

선택적 단계

선택적 단계로, .* 문자를 지정하면 명령 구문에 읽기 전용 인수가 지정되고, "" 문자로 빈 문자열을 지정하면 기존 인수 값이 보존됩니다. 쓰기 가능한 인수에 대해 값이나 빈 문자열을 지정하지 않으면 명령이 인수를 널값으로 재설정합니다.
-AssetOptions
AssetOptions 단계 및 다음 인수를 사용하여 자산의 추가 특성을 설정하십시오.
name(읽기 전용)
자산의 이름을 지정합니다. 이 인수의 기본값은 소스 패키지의 파일 이름입니다.
defaultBindingProps(읽기 전용)
자산에 대한 기본 바인딩 특성을 지정합니다. 이 인수는 엔터프라이즈 자산에만 적용됩니다. 엔터프라이즈 자산이 아닌 자산의 경우 패턴 일치에 사용하도록 별표 문자(*)를 지정하십시오. 엔터프라이즈 자산의 경우 .* 값을 지정하여 인수를 비어 있지 않은 값으로 설정하십시오.
설명
자산에 대한 설명을 지정합니다.
destinationUrl
배치할 자산 2진의 URL을 지정합니다.
typeAspect
자산 유형 측면을 지정합니다.
relationship
자산 관계를 지정합니다. 더하기 부호 문자(+)를 사용하여 기존 관계에 추가 자산을 추가하십시오. 번호 부호 문자(#)를 사용하여 관계에서 기존 자산을 삭제하십시오. 기존 관계를 대체하려면 importAsset 명령에서와 동일한 구문을 지정하십시오. 추가 또는 업데이트용으로 관계에 지정된 자산이 없으면 명령이 예외를 리턴합니다.
filePermission
파일 사용 권한 구성을 지정합니다.
validate
자산의 유효성 검증 여부를 지정합니다. 기본값은 false입니다. 제품이 validate에 지정된 값을 저장하지 않습니다. 따라서 지금 자산의 유효성을 검증하고(true) 나중에 자산을 편집하도록 선택할 경우 자산을 편집할 때 제품에 대해 이 설정을 다시 사용 가능하게 설정하여 업데이트된 파일의 유효성을 검증해야 합니다.
updateAssociatedCUs
엔터프라이즈(Java EE) 자산과 연관된 컴포지션 단위를 업데이트할지 지정합니다. 이 인수는 엔터프라이즈 자산에만 적용됩니다. 기본값은 none입니다. 엔터프라이즈 자산과 연관된 모든 컴포지션 단위를 업데이트하려면 all을 지정하십시오.

replace 조작의 경우 AssetOptions name, defaultBindingProps, description, destinationUrl, typeAspect, relationship, filePermission, validate 및 updateAssociatedCUs 인수의 값을 지정하십시오. replace 이외의 조작의 경우 AssetOptions 이름 및 updateAssociatedCUs 인수의 값을 지정하십시오.

리턴값

명령은 원하는 자산의 구성 ID를 리턴합니다.

일괄처리 모드 사용법 예제

다음 예제에서는 비엔터프라이즈 자산의 컨텐츠를 바꿉니다.
  • Jython 문자열 사용:
    AdminTask.updateAsset('-assetID asset1.zip -operation replace -contents c:/temp/a.zip')
  • Jython 목록 사용:
    AdminTask.updateAsset(['-assetID', 'asset1.zip', '-operation', 'replace', '-contents', 'c:/temp/a.zip'])
다음 예제에서는 비엔터프라이즈 자산의 파일을 부분적으로 업데이트합니다.
  • Jython 문자열 사용:
    AdminTask.updateAsset('-assetID asset1.zip – operation merge – contents c:/temp/p.zip')
  • Jython 목록 사용:
    AdminTask.updateAsset(['-assetID', 'asset1.zip', '–operation', 'merge', '–contents', 'c:/temp/p.zip'])
다음 예제에서는 엔터프라이즈 자산을 EJB(Enterprise JavaBeans) 모듈 파일로 업데이트합니다.
  • Jython 문자열 사용:
    AdminTask.updateAsset('-assetID defaultapp.ear – operation add – contents 
      c:/temp/filename.jar – contenturi filename.jar')
  • Jython 목록 사용:
    AdminTask.updateAsset(['-assetID', 'defaultapp.ear', '–operation', 'add', '–contents', 
      'c:/temp/filename.jar', '–contenturi', 'filename.jar'])
다음 예는 replace 조작을 사용하여 엔터프라이즈 자산 및 연관된 컴포지션 단위를 바꿉니다.
  • Jython 문자열 사용:
    AdminTask.updateAsset('-assetID defaultapp.ear –operation replace –contents 
      c:/temp/newapp.ear – AssetOptions [[defaultapp.ear .* newdesc "" "" "" "" false all]]')
  • Jython 목록 사용:
    AdminTask.updateAsset(['-assetID', 'defaultapp.ear', '–operation', 'replace', '–contents',
      'c:/temp/newapp.ear', '–AssetOptions [[defaultapp.ear .* newdesc "" "" "" "" false all]]'])
다음 예는 merge 조작을 사용하여 엔터프라이즈 자산 및 연관된 컴포지션 단위를 업데이트합니다.
  • Jython 문자열 사용:
    AdminTask.updateAsset('-assetID defaultapp.ear –operation merge –contents 
      c:/temp/newapp.ear – AssetOptions [[defaultapp.ear all]]')
  • Jython 목록 사용:
    AdminTask.updateAsset(['-assetID', 'defaultapp.ear', '–operation', 'merge', '–contents',
      'c:/temp/newapp.ear', '–AssetOptions [[defaultapp.ear all]]'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.updateAsset('-interactive')

viewAsset

viewAsset 명령은 추가 자산 구성 옵션 및 구성된 값을 표시합니다.

대상 오브젝트

없음

필수 매개변수

-assetID
원하는 자산의 구성 ID를 지정합니다. ID가 고유 자산과 일치하는 경우 이 매개변수가 불완전한 구성 ID를 승인합니다. (문자열, 필수).

선택적 매개변수

없음

리턴값

명령은 원하는 자산의 구성 데이터를 다음 예제와 같이 리턴합니다.
Specify Asset options (AssetOptions)

Specify options for Asset.

*Asset Name (name): [defaultapp.ear]
Default Binding Properties (defaultBindingProps): 
 [defaultbinding.ejbjndi.prefix#defaultbinding.datasource.jndi#defaultbinding.datasource.username
#defaultbinding.datasource.password#defaultbinding.cf.jndi
#defaultbinding.cf.resauth#defaultbinding.virtual.host#defaultbinding.force]
Asset Description (description): []
Asset Binaries Destination Url (destination): [${USER_INSTALL_ROOT}/installedAssets/defaultapp.ear/BASE/defaultapp.ear]
Asset Type Aspects (typeAspect): [WebSphere:spec=j2ee_ear]
Asset Relationships (relationship): []File Permission (filePermission): [.*\\.dll=755#.*\\.so=755#.*\\.a=755#.*\\.sl=755]
Validate asset (validate): [false]

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.viewAsset('-assetID asset3.zip')
  • Jython 목록 사용:
    AdminTask.viewAsset(['-assetID', 'asset3.zip'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.viewAsset('-interactive')

addCompUnit

addCompUnit 명령은 컴포지션 단위를 특정 비즈니스 레벨 애플리케이션에 추가합니다. 컴포지션 단위는 비즈니스 레벨 애플리케이션에 있는 자산을 나타내고 애플리케이션에 있는 자산 컨텐츠와 다른 자산과의 상호작용을 가능하게 하며, 제품 런타임에서 자산 컨텐츠를 로드하고 실행할 수 있게 합니다.

대상 오브젝트

없음

필수 매개변수

-blaID
원하는 비즈니스 레벨 애플리케이션의 구성 ID를 지정합니다. (문자열, 필수)
-cuSourceID
추가할 컴포지션 단위에 대한 소스 구성 ID를 지정합니다. 자산 ID 또는 비즈니스 레벨 애플리케이션 ID를 지정할 수 있습니다. (문자열, 필수).

선택적 매개변수

-deplUnits
자산에 배치할 배치 가능 단위를 지정합니다. 배치 가능한 단위의 서브세트 또는 배치 가능한 모든 단위를 지정하거나 기본값을 공유 라이브러리로 사용할 수 있습니다. 이 매개변수를 지정하지 않는 경우 각 배치 가능 단위를 배치합니다. (문자열, 선택적)
Java EE 자산의 경우 시스템이 이 -deplUnits 매개변수를 무시하며 지정된 값에 상관없이 이 명령의 일부로 Java EE 자산을 추가할 수 있습니다.
-cuConfigStrategyFile
사용자 정의 기본 바인딩 특성에 대한 완전한 파일 경로를 지정합니다. 이 매개변수는 엔터프라이즈 자산에만 적용됩니다. (문자열, 선택적)
-defaultBindingOptions
엔터프라이즈 자산에 대한 선택적 JNDI(Java Naming and Directory Interface) 바인딩 특성을 지정합니다. 사용 가능한 바인딩 특성은 엔터프라이즈 자산의 유형에 따라 다릅니다. property=value 형식을 사용하여 기본 바인딩 특성을 지정하십시오. 둘 이상의 특성을 지정하려면 각 property=value문을 # 구분 기호로 구분하십시오.
자산을 작성할 때 또는 이후에 자산을 컴포지션 단위로 비즈니스 레벨 애플리케이션에 추가할 때 바인딩 특성을 지정할 수 있습니다. 나중에 바인딩 특성을 지정하는 경우 자산을 비즈니스 레벨 애플리케이션에 추가할 때 전략 파일을 사용하여 바인딩 특성을 지정할 수 있습니다. (문자열, 선택적)
defaultBindingOptions 매개변수와 함께 다음 옵션을 사용하십시오.
표 2. addCompUnit -defaultBindingOptions 지원 바인딩 특성. 자산 유형에 지원되는 바인딩 특성을 지정하십시오.
엔터프라이즈 자산 유형 지원되는 바인딩 특성
EJB(Enterprise Bean)

defaultbinding.ejbjndi.prefix

defaultbinding.force

데이터 소스

defaultbinding.datasource.jndi

defaultbinding.datasource.username

defaultbinding.datasource.password

defaultbinding.force

연결 팩토리

defaultbinding.cf.jndi

defaultbinding.cf.resauth

defaultbinding.force

가상 호스트

defaultbinding.virtual.host

defaultbinding.force

선택적 단계

선택적 단계의 값을 지정하여 새 컴포지션 단위의 추가 특성도 설정할 수 있습니다. 엔터프라이즈 자산에는 이 단계가 적용되지 않습니다. 선택적 단계로, .* 문자를 지정하면 명령 구문에 읽기 전용 인수가 지정되고, "" 문자로 빈 문자열을 지정하면 기존 인수 값이 보존됩니다. 쓰기 가능한 인수에 대해 값이나 빈 문자열을 지정하지 않으면 명령이 인수를 널값으로 재설정합니다.
-CUOptions
컴포지션 단위에 대한 추가 특성을 지정합니다. CUOptions 단계에서 다음 옵션을 지정하십시오.
parentBLA(읽기 전용)
새 컴포지션 단위에 대한 상위 비즈니스 레벨 애플리케이션을 지정합니다.
backingID(읽기 전용)
컴포지션 단위 소스 ID를 지정합니다.
이름
컴포지션 단위의 이름을 지정합니다.
설명
컴포지션 단위에 대한 설명을 지정합니다.
startingWeight
컴포지션 단위의 시작 가중치를 지정합니다. 지원되는 값은 1 - 2147483647(최대 정수값)입니다.
startedOnDistributed
변경사항을 대상 노드에 분배한 후 컴포지션 단위를 시작할지 여부를 지정합니다. 기본값은 false입니다.
restartBehaviorOnUpdate
컴포지션 단위를 편집한 후 다시 시작할 노드를 지정합니다. 각 대상 노드를 다시 시작하려면 ALL을 지정하십시오. 동기화 플러그인에 의해 제어되는 노드를 다시 시작하려면 DEFAULT를 지정하십시오. 시스템이 노드를 다시 시작하지 않도록 NONE을 지정하십시오.
예를 들어, 이 단계의 구문을 -CUOptions [[.* .* cu4 "cu4 desc" 0 false DEFAULT]]로 지정하십시오.
-MapTargets
컴포지션 단위 대상 맵핑에 대한 추가 특성을 지정합니다. MapTargets 단계에서 다음 옵션을 지정하십시오.
deplUnit(읽기 전용)
배치 가능 단위 URI(Uniform Resource Identifier)를 지정합니다.
EBA(Enterprise Bundle Archive) 자산의 경우 이 URI는 ebaDeploymentUnit입니다.
서버
컴포지션 단위를 배치할 대상을 지정합니다. 기본값은 server1 서버입니다. 더하기 부호 문자( + )를 사용하여 여러 대상을 지정하십시오. 더하기 부호 문자( + )를 접두어로 사용하여 추가 대상을 추가하십시오. WebSphere Application Server 서버가 아닌 각 서버의 전체 오브젝트 이름 형식을 지정하십시오.
예를 들어 이 단계의 구문을 -MapTargets [[a1.jar cluster1+cluster2] [a2.jar +server2]]로 지정하십시오.
-ActivationPlanOptions
컴포지션 단위 활성화 계획에 대한 추가 특성을 지정합니다. ActivationPlanOptions 단계에서 다음 옵션을 지정하십시오.
deplUnit(읽기 전용)
배치 가능 단위 URI(Uniform Resource Identifier)를 지정합니다.
activationPlan
활성화 계획으로 런타임 컴포넌트 목록을 지정합니다. specName=xxx,specVersion=yyy 형식으로 각 활성화 계획을 지정하십시오. 여기서 specName은 스펙의 이름을 표시하며 필수입니다. 더하기 부호 문자( + )를 사용하여 여러 활성화 계획을 지정하십시오.
예를 들어 이 단계의 구문을 -ActivationPlanOptions [[a1.jar specname=actplan0+specname=actplan1] [a2.jar specname=actplan1+specname=actplan2]]로 지정하십시오.
EBA 자산의 경우 다음 기본값을 사용하십시오. -ActivationPlanOptions [[default ""]]
-CreateAuxCUOptions
보조 컴포지션 단위에 대한 추가 특성을 지정합니다. 컴포지션 단위 소스가 비즈니스 레벨 애플리케이션에 일치하는 컴포지션 단위가 없는 자산에 해당하는 자산인 경우 이 단계를 사용하십시오. CreateAuxCUOptions 단계에서 다음 옵션을 지정하십시오.
deplUnit(읽기 전용)
배치 가능 단위 URI(Uniform Resource Identifier)를 지정합니다.
inputAsset(읽기 전용)
컴포지션 단위 소스 ID를 지정합니다.
cuID
시스템이 자산에 대해 작성하는 컴포지션 단위 ID를 지정합니다. 새 컴포지션 단위를 작성하지 않으려면 이 인수를 지정하지 마십시오.
matchTarget
종속성 보조 컴포지션 단위 대상을 새 컴포지션 단위의 대상과 일치시키는지 여부를 지정합니다. 기본값은 true입니다.
제품이 matchTarget에 지정된 값을 저장하지 않습니다. 따라서 지금 대상을 일치시키지 않고(false) 나중에 컴포지션 단위를 편집하도록 선택하는 경우 컴포지션 단위를 편집할 때 대상을 일치시키지 않도록 제품에 대해 이 설정을 다시 사용 불가능하게 설정해야 합니다.
예를 들어 이 단계의 구문을 –CreateAuxCUOptions [[a1.jar a.jar auxCU true] [a2.jar a.jar defaultCU false]]로 지정하십시오.
-RelationshipOptions
자산, 컴포지션 단위 및 비즈니스 레벨 애플리케이션 사이의 관계에 대한 추가 특성을 지정합니다. 컴포지션 단위의 소스 ID가 비즈니스 레벨 애플리케이션에 일치하는 컴포지션 단위가 있는 자산인 경우 이 단계를 사용하십시오. RelationshipOptions 단계에서 다음 옵션을 지정하십시오.
deplUnit(읽기 전용)
배치 가능 단위 URI(Uniform Resource Identifier)를 지정합니다.
relationship
컴포지션 단위 관계를 정의합니다. cuName=xxx 형식으로 컴포지션 단위 오브젝트 이름을 지정하십시오. 더하기 부호 문자(+)를 사용하여 관계에 여러 컴포지션 단위 오브젝트 이름을 지정하십시오. 관계에 지정된 컴포지션 단위가 동일한 비즈니스 레벨 애플리케이션에 없는 경우 시스템이 오류를 리턴합니다.
matchTarget
컴포지션 단위 관계 대상을 새 컴포지션 단위 대상과 일치시키는지 여부를 지정합니다. 기본값은 true입니다.
제품이 matchTarget에 지정된 값을 저장하지 않습니다. 따라서 지금 대상을 일치시키지 않고(false) 나중에 컴포지션 단위를 편집하도록 선택하는 경우 컴포지션 단위를 편집할 때 대상을 일치시키지 않도록 제품에 대해 이 설정을 다시 사용 불가능하게 설정해야 합니다.
예를 들어 이 단계의 구문을 –RelationshipOptions [[a1.jar a.jar auxCU true] [a2.jar a.jar defaultCU false]]로 지정하십시오.
-ContextRootStep
EBA 자산의 경우 컨텍스트 루트가 런타임 시 특정 웹 애플리케이션 번들(WAB)의 웹 페이지가 발견된 위치를 판별합니다.
여기서 지정한 컨텍스트 루트는 정의된 서버 맵핑과 결합되어, 사용자가 WAB 페이지에 액세스하기 위해 입력하는 전체 URI를 구성합니다. 예를 들어 애플리케이션 서버 기본 호스트가 www.example.com:8080이고 WAB의 컨텍스트 루트가 /sample인 경우 www.example.com:8080/sample에서 웹 페이지를 사용할 수 있습니다.
OSGi 애플리케이션에 포함된 모든 WAB 모듈의 컨텍스트 루트를 나열해야 합니다.
이 단계의 구문을 다음과 같이 지정하십시오.
  -ContextRootStep [
    [bundle_symbolic_name_1 bundle_version_1 context_root_1]
    [bundle_symbolic_name_2 bundle_version_2 context_root_2]]
예를 들어 두 개의 WAB(버전 1.0.0에서는 com.ibm.ws.eba.helloWorldService.web/hello/web에 맵핑되며 버전 0.9.0에서는 com.ibm.ws.eba.helloWorldService.withContextRoot/hello/service에 맵핑됨)를 포함하는 EBA 파일의 경우 명령은 다음과 같습니다.
  -ContextRootStep [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 "/hello/web"] 
    [com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0 "/hello/service"]]
-VirtualHostMappingStep
EBA 자산의 경우 가상 호스트를 사용하여 고유 포트를 모듈 또는 애플리케이션과 연관시킵니다. 가상 호스트의 별명은 해당 가상 호스트에 정의된 포트 번호를 식별합니다. 가상 호스트 별명에 지정된 포트 번호는 웹 모듈에서 서블릿 및 JSP(JavaServer Page) 파일과 같은 아티팩트에 액세스하는 데 사용되는 URL에서 사용됩니다. 예를 들어, 별명 myhost:8080은 URL http://myhost:8080/samplehost_name:port_number 부분입니다.
배치된 자산에 포함된 각 WAB는 가상 호스트에 맵핑해야 합니다. WAB는 동일한 가상 호스트에 설치되거나 여러 가상 호스트 간에 분산될 수 있습니다.
주어진 WAB의 ibm-web-bnd.xml 또는 .xmi 파일에 기존의 가상 호스트를 지정하면 기본값으로 지정된 가상 호스트가 설정됩니다. 그렇지 않으면 기본 가상 호스트 설정은 별명을 통해 여러 포트 번호를 제공하는 default_host입니다.
80
포트 번호를 지정하지 않을 때 사용되는 내부의 비보안 포트
9080
내부 포트
9443
외부 보안 포트
동일한 노드(물리적 시스템)의 다른 WAB 또는 자원에서 WAB를 분리시키려는 경우를 제외하고, default_host는 적합한 가상 호스트입니다. default_host 이외에, WebSphere Application Server는 관리 콘솔 시스템 애플리케이션의 가상 호스트인 admin_host를 제공합니다. admin_host는 포트 9060에 있습니다. 보안 포트는 9043입니다. WAB가 시스템 관리에 관련된 경우 이외에는 admin_host를 선택하지 마십시오.
이 단계의 구문을 다음과 같이 지정하십시오.
-VirtualHostMappingStep [
    [bundle_symbolic_name_1 bundle_version_1 
    web_module_name_1 virtual_host_1]
    [bundle_symbolic_name_2 bundle_version_2 
     web_module_name_2 virtual_host_2]]
예를 들어 두 개의 WAB(버전 1.0.0에서는 com.ibm.ws.eba.helloWorldService.webdefault_host에 맵핑되며 버전 0.9.0에서는 com.ibm.ws.eba.helloWorldService.withContextRoottest_host에 맵핑됨)를 포함하는 EBA 파일의 경우 명령은 다음과 같습니다.
-VirtualHostMappingStep [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 "HelloWorld service" default_host]
    [com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0 "HelloWorld second service" test_host]]
-MapRolesToUsersStep
EBA 자산의 경우 이 단계를 사용하여 사용자 또는 그룹에 보안 역할을 맵핑하십시오.
이 단계의 구문을 다음과 같이 지정하십시오.
-MapRolesToUsersStep [
    [role_name everyone? 
    all_authenticated_in_realm? 
    usernames groups]]
키 :
  • role_name은 애플리케이션에 정의된 역할 이름입니다.
  • 모든 사용자가 역할에 있는지 여부를 지정하도록 everyone?Yes 또는 No로 설정됩니다.
  • all_authenticated_in_realm?이 인증된 모든 사용자가 애플리케이션 영역에 액세스할 수 있는지 여부를 지정하도록 Yes 또는 No로 설정됩니다.
  • usernames는 WebSphere Application Server 사용자 이름의 목록이고, 이는 "|" 문자로 구분됩니다.
  • groups은 WebSphere Application Server 그룹의 목록이고, 이는 "|" 문자로 구분됩니다.
참고: usernamesgroups의 경우, 비어 있는 문자열 ""는 "기본값 또는 기존 값 사용"을 의미합니다. 일반적으로 기본값은 사용자 또는 그룹이 역할에 바인드되지 않습니다. 그러나 애플리케이션에 ibm-application-bnd.xmi 파일이 포함된 경우 usernames의 기본값은 이 파일에서 얻습니다. ibm-application-bnd.xmi 파일을 포함하는 애플리케이션을 배치하고 바인드된 사용자를 제거하려는 경우, "|" 문자(여러 사용자 이름에 대한 구분 기호)를 지정하십시오. 이는 명시적으로 "사용자 없음"을 지정하고 역할에 바인드된 사용자가 없다는 것을 보장합니다.
예를 들어, 다음과 같습니다.
-MapRolesToUsersStep [
    [ROLE1 No Yes "" ""] 
    [ROLE2 No No WABTestUser1 ""] 
    [ROLE3 No No "" WABTestGroup1] 
    [ROLE4 Yes No "" ""]]
-BlueprintResourceRefBindingStep
EBA 자산의 경우 Blueprint 컴포넌트가 WebSphere Application Server 자산 참조에 액세스할 수 있습니다. 각 참조는 Blueprint XML 파일에 선언되어 있으며 JCA(Java Platform, Enterprise Edition(Java EE) Connector Architecture) 인증 별명을 사용하여 보안을 제공합니다. OSGi 애플리케이션의 각 번들은 여러 Blueprint XML 파일에 임의의 수의 자원 참조 선언을 포함할 수 있습니다.
자원 참조를 보호할 때 해당 자원 참조는 OSGi 애플리케이션이 배치된 모든 서버 또는 클러스터에 있는 JCA 인증 별명에만 바인드할 수 있습니다. OSGi 애플리케이션은 동일한 보안 도메인에 있는 여러 서버와 클러스터에 배치될 수 있습니다. 그러므로 각 JCA 인증 별명은 대상 서버 및 클러스터의 보안 도메인 또는 글로벌 보안 도메인에 있어야 합니다.
이 단계의 구문을 다음과 같이 지정하십시오.
-BlueprintResourceRefBindingStep [
    [
    bundle_symbolic_name 
    bundle_version 
    blueprint_resource_reference_id 
    interface_name 
    jndi_name 
    authentication_type 
    sharing_setting 
    authentication_alias_name
    ]]
참고: jndi_name의 값은 Blueprint XML 파일에서 자원 참조 요소의 filter 속성에 선언한 jndi 이름과 일치해야 합니다.
예를 들어 버전 1.0.0에서 인증 별명 alias1에 바인드되는 번들 com.ibm.ws.eba.helloWorldService.properties.bundle.jar을 포함하는 EBA 파일의 경우 명령은 다음과 같습니다.
-BlueprintResourceRefBindingStep[
    [com.ibm.ws.eba.helloWorldService.properties.bundle 1.0.0 resourceRef
    javax.sql.DataSource jdbc/Account Container Shareable alias1]]
-WebModuleMsgDestRefs
EBA 자산의 경우 자원 참조를 바인드하면 웹 애플리케이션의 자원 종속성이 서버 런타임 환경에서 사용 가능한 실제 자원에 맵핑됩니다. 런타임 환경에서 자원이 알려진 JNDI 이름을 지정하는 맵핑을 사용하여 이 작업을 수행할 수 있습니다. 기본적으로 JNDI 이름은 웹 애플리케이션 번들(WAB) 개발 중에 web.xml 파일에 지정한 자원 ID입니다. 이 옵션을 사용하여 Java 스펙 JSR-250: Java 플랫폼용 공통 어노테이션에 정의된 대로 message-destination-ref(메시지 대상 참조) 또는 resource-env-ref(자원 환경 참조) 유형의 자원을 바인드하십시오.
이 단계의 구문을 다음과 같이 지정하십시오.
-WebModuleMsgDestRefs [
    [
    bundle_symbolic_name
    bundle_version
    resource_reference_id
    resource_type
    target_jndi_name
	   ]]
예를 들어, 다음과 같습니다.
-WebModuleMsgDestRefs [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 
    jms/myQ javax.jms.Queue jms/workQ] 
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 
    jms/myT javax.jms.Topic jms/notificationTopic]]
-WebModuleResourceRefs
EBA 자산의 경우 자원 참조를 바인드하면 웹 애플리케이션의 자원 종속성이 서버 런타임 환경에서 사용 가능한 실제 자원에 맵핑됩니다. 런타임 환경에서 자원이 알려진 JNDI 이름을 지정하는 맵핑을 사용하여 이 작업을 수행할 수 있습니다. 기본적으로 JNDI 이름은 웹 애플리케이션 번들(WAB) 개발 중에 web.xml 파일에 지정한 자원 ID입니다. 이 옵션을 사용하여 Java 스펙 JSR-250: Java 플랫폼용 공통 어노테이션에 정의된 대로 resource-ref(자원 참조) 유형의 자원을 바인드하십시오.
이 단계의 구문을 다음과 같이 지정하십시오.
-WebModuleResourceRefs [
    [
    bundle_symbolic_name
    bundle_version
    resource_reference_id
    resource_type
    target_jndi_name
    login_configuration
    login_properties
    extended_properties
	   ]]
예를 들어, 다음과 같습니다.
-WebModuleResourceRefs [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/jtaDs javax.sql.DataSource
    jdbc/helloDs "" "" ""]
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/nonJtaDs javax.sql.DataSource
    jdbc/helloDsNonJta "" "" "extprop1=extval1"]]
참고: 확장된 여러 특성을 사용하는 경우, jython 구문은 "extprop1=extval1,extprop2=extval2"입니다.

리턴값

명령은 다음 예가 표시하는 대로 자산 관계의 자산에 대해 작성된 새 컴포지션 단위와 컴포지션 단위의 구성 ID를 리턴합니다.
WebSphere:cuname=cu4
WebSphere:cuname=cua
WebSphere:cuname=cud

일괄처리 모드 사용법 예제

다음 예제를 사용하여 비엔터프라이즈 자산을 추가하십시오.
  • Jython 문자열 사용:
    AdminTask.addCompUnit('-blaID myBLA – cuSourceID assetname=asset1.zip -CUOptions 
      [[.* .* cu1 "cu1 desc1" 0 false DEFAULT]] -MapTargets [[.* server1]] –ActivationPlanOptions 
      [.* specname=actplan0+specname=actplan1]')
  • Jython 목록 사용:
    AdminTask.addCompUnit(['-blaID', 'myBLA', '–cuSourceID', 'assetname=asset1.zip', '-CUOptions', 
      '[[.* .* cu1 "cu1 desc1" 0 false DEFAULT]]', '-MapTargets', '[[.* server1]]', '–ActivationPlanOptions',
       '[.* specname=actplan0+specname=actplan1]'])
다음 예제를 사용하여 비즈니스 레벨 애플리케이션 컴포지션 단위를 추가하십시오.
  • Jython 문자열 사용:
    AdminTask.addCompUnit('-blaID myBLA -cuSourceID yourBLA -CUOptions [[.* .* cu3 "cu3 desc3" 0 false DEFAULT]]')
  • Jython 목록 사용:
    AdminTask.addCompUnit(['-blaID', 'myBLA', '-cuSourceID', 'yourBLA', '-CUOptions', 
      '[[.* .* cu3 "cu3 desc3" 0 false DEFAULT]]'])
다음 예제를 사용하여 EBA 컴포지션 단위를 작성하고 이 단위를 비즈니스 레벨 애플리케이션에 추가하십시오.
AdminTask.addCompUnit('[
  -blaID WebSphere:blaname=helloWorldService 
  -cuSourceID WebSphere:assetname=com.ibm.ws.eba.helloWorldService.eba
  -CUOptions [
    [WebSphere:blaname=helloWorldService.eba 
    WebSphere:assetname=com.ibm.ws.eba.helloWorldService.eba 
    com.ibm.ws.eba.helloWorldService_0001.eba "" 1 false DEFAULT]] 
  -MapTargets [[ebaDeploymentUnit WebSphere:node=node01,server=server1]] 
  -ActivationPlanOptions [[default ""]]  
  -ContextRootStep [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 "/hello/web"] 
    [com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0 "/hello/service"]]
  -VirtualHostMappingStep [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 
    "HelloWorld service" default_host]
    [com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0 
    "HelloWorld second service" test_host]]
  -MapRolesToUsersStep [
    [ROLE1 No Yes "" ""] 
    [ROLE2 No No WABTestUser1 ""] 
    [ROLE3 No No "" WABTestGroup1] 
    [ROLE4 Yes No "" ""]]
  -BlueprintResourceRefBindingStep[
    [com.ibm.ws.eba.helloWorldService.properties.bundle 1.0.0 resourceRef
    javax.sql.DataSource jdbc/Account Container Shareable alias1]]
  -WebModuleMsgDestRefs [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 
    jms/myQ javax.jms.Queue jms/workQ] 
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 
    jms/myT javax.jms.Topic jms/notificationTopic]]
  -WebModuleResourceRefs [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/jtaDs javax.sql.DataSource
    jdbc/helloDs "" "" ""]
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/nonJtaDs javax.sql.DataSource
    jdbc/helloDsNonJta "" "" "extprop1=extval1"]]
]')
다음 예제를 사용하여 비엔터프라이즈 자산에 대한 컴포지션 단위를 추가하고 컴포지션 단위를 여러 대상에 배치하십시오.
  • Jython 문자열 사용:
    AdminTask.addCompUnit('-blaID theirBLA – cuSourceID asset2.zip – CUOptions 
      [[.* .* cu2 "cu2 desc" 0 false DEFAULT]] -MapTargets [[.* server1+server2]]')
  • Jython 목록 사용:
    AdminTask.addCompUnit(['-blaID', 'theirBLA', '–cuSourceID', 'asset2.zip', '–CUOptions', 
      '[[.* .* cu2 "cu2 desc" 0 false DEFAULT]]', '-MapTargets', '[[.* server1+server2]]'])
다음 예를 사용하여 배치 가능한 단위가 있는 비엔터프라이즈 자산인 컴포지션 단위를 추가하십시오.
  • Jython 문자열 사용:
    AdminTask.addCompUnit('-blaID yourBLA – cuSourceID asset2.zip – deplUnits a.jar – CUOptions 
      [[.* .* cu3 "cu3 desc" 0 false DEFAULT]] –MapTargets [[a.jar server1]] –ActivationPlanOptions 
      [[a.jar specname=actplan1]]')
  • Jython 목록 사용:
    AdminTask.addCompUnit(['-blaID', 'yourBLA', '–cuSourceID', 'asset2.zip', '–deplUnits', 'a.jar', '–CUOptions', 
      '[[.* .* cu3 "cu3 desc" 0 false DEFAULT]]', '–MapTargets', '[[a.jar server1]]', '–ActivationPlanOptions',
       '[[a.jar specname=actplan1]]'])
다음 예제를 사용하여 비엔터프라이즈 자산에 대한 컴포지션 단위를 공유 라이브러리로서 추가하십시오.
  • Jython 문자열 사용:
    AdminTask.addCompUnit('-blaID ourBLA – cuSourceID b.jar – deplUnits default – CUOptions 
      [[.* .* cub "cub desc" 0 false DEFAULT]] –MapTargets [[default server1]]')
  • Jython 목록 사용:
    AdminTask.addCompUnit(['-blaID', 'ourBLA', '–cuSourceID', 'b.jar', '–deplUnits', 'default', '–CUOptions', 
      '[[.* .* cub "cub desc" 0 false DEFAULT]]', '–MapTargets', '[[default server1]]'])
다음 예를 사용하여 종속성이 있는 비엔터프라이즈 자산의 컴포지션 단위를 추가하십시오. 이 예의 경우 cub 컴포지션 단위는 ourBLA 비즈니스 레벨 애플리케이션의 공유 라이브러리로 존재합니다.
  • Jython 문자열 사용:
    AdminTask.addCompUnit('-blaID ourBLA – cuSourceID asset3.zip – deplUnits a1.jar – CUOptions 
      [[.* .* cu4 "cu4 desc" 0 false DEFAULT]] –MapTargets [[a1.jar cluster1+cluster2]] –CreateAuxCUOptions 
      [[a1.jar a.jar cua true]] –RelationshipOptions [[a1.jar cuname=cub true]]')
  • Jython 목록 사용:
    AdminTask.addCompUnit(['-blaID', 'ourBLA', '–cuSourceID', 'asset3.zip', '–deplUnits', 'a1.jar', '–CUOptions',
     '[[.* .* cu4 "cu4 desc" 0 false DEFAULT]]', '–MapTargets', '[[a1.jar cluster1+cluster2]]', '–CreateAuxCUOptions', 
      '[[a1.jar a.jar cua true]]', '–RelationshipOptions', '[[a1.jar cuname=cub true]]'])
다음 예제를 사용하여 엔터프라이즈 자산을 추가하십시오.
  • Jython 문자열 사용:
    AdminTask.addCompUnit('[-blaID yourBLA – cuSourceID defaultapp.ear – defaultBindingOptions
      defaultbinding.ejbjndi.prefix=ejb# defaultbinding.virtual.host=default_host#
      defaultbinding.force=yes – AppDeploymentOptions [-appname defaultapp -installed.ear.destination
      application_root/myCell/defaultapp.ear] –MapModulesToServers 
      [[defaultapp.war .* WebSphere:cell=cellName,node=nodeName,server=server1]
      [Increment.jar .* Websphere:cell=cellName,node=nodeName,server=server2]] -CtxRootForWebMod
      [[defaultapp.war .* myctx/]]]')
  • Jython 목록 사용:
    AdminTask.addCompUnit(['-blaID', 'yourBLA', '–cuSourceID', 'defaultapp.ear', '–defaultBindingOptions',
       'defaultbinding.ejbjndi.prefix=ejb# defaultbinding.virtual.host=default_host# defaultbinding.force=yes', 
       '–AppDeploymentOptions', '[-appname defaultapp -installed.ear.destination application_root/myCell/defaultapp.ear]',
       '–MapModulesToServers', '[[defaultapp.war .* WebSphere:cell=cellName,node=nodeName,server=server1]
       [Increment.jar .* Websphere:cell=cellName,node=nodeName,server=server2]]', '-CtxRootForWebMod', 
       '[[defaultapp.war .* myctx/]]'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.addCompUnit('-interactive')

deleteCompUnit

deleteCompUnit 명령은 컴포지션 단위를 제거합니다. 시스템이 고유 ID에 문자열을 일치시킬 수 있는 경우 두 매개변수 모두 불완전한 구성 ID를 승인합니다.

대상 오브젝트

없음

필수 매개변수

-blaID
원하는 비즈니스 레벨 애플리케이션의 구성 ID를 지정합니다. (문자열, 필수)
-cuID
삭제할 컴포지션 단위의 구성 ID를 지정합니다. (문자열, 필수).

선택적 매개변수

-force
기타 자산이 이 컴포지션 단위에 종속되는 경우에도 시스템이 컴포지션 단위를 강제로 삭제하는지 여부를 지정합니다. (부울, 선택적)

리턴값

명령은 시스템에서 삭제한 컴포지션 단위의 구성 ID를 다음 예제와 같이 리턴합니다.
WebSphere:cuname=cu1

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.deleteCompUnit('-blaID myBLA – cuID cu1 -force true')
  • Jython 목록 사용:
    AdminTask.deleteCompUnit(['-blaID', 'myBLA', '–cuID', 'cu1', '-force', 'true'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.deleteCompUnit('-interactive')

editCompUnit

editCompUnit 명령은 추가 컴포지션 단위 옵션을 수정합니다. 이 명령을 사용하여 컴포지션 단위의 시작 가중치, 배치 대상, 활성화 계획 옵션 및 관계 설정을 수정할 수 있습니다.

대상 오브젝트

없음

필수 매개변수

-blaID
원하는 비즈니스 레벨 애플리케이션의 구성 ID를 지정합니다. (문자열, 필수)
-cuID
편집할 컴포지션 단위의 구성 ID를 지정합니다. (문자열, 필수).

선택적 단계

선택적 단계의 값을 지정하여 컴포지션 단위의 특성도 편집할 수 있습니다. 엔터프라이즈 자산에는 이 단계가 적용되지 않습니다. 선택적 단계로, .* 문자를 지정하면 명령 구문에 읽기 전용 인수가 지정되고, "" 문자로 빈 문자열을 지정하면 기존 인수 값이 보존됩니다. 쓰기 가능한 인수에 대해 값이나 빈 문자열을 지정하지 않으면 명령이 인수를 널값으로 재설정합니다.
-CUOptions
컴포지션 단위에 대한 추가 특성을 지정합니다. CUOptions 단계에서 다음 옵션을 지정하십시오.
parentBLA(읽기 전용)
컴포지션 단위에 대한 상위 비즈니스 레벨 애플리케이션을 지정합니다.
backingID(읽기 전용)
컴포지션 단위 소스 ID를 지정합니다.
name(읽기 전용)
컴포지션 단위의 이름을 지정합니다.
설명
컴포지션 단위에 대한 설명을 지정합니다.
startingWeight
컴포지션 단위의 시작 가중치를 지정합니다. 지원되는 값은 1 - 2147483647(최대 정수값)입니다.
startedOnDistributed
변경사항을 대상 노드에 분배한 후 컴포지션 단위를 시작할지 여부를 지정합니다. 기본값은 false입니다.
restartBehaviorOnUpdate
컴포지션 단위를 편집한 후 다시 시작할 노드를 지정합니다. 각 대상 노드를 다시 시작하려면 ALL을 지정하십시오. 동기화 플러그인에 의해 제어되는 노드를 다시 시작하려면 DEFAULT를 지정하십시오. 시스템이 노드를 다시 시작하지 않도록 NONE을 지정하십시오.
예를 들어, 이 단계의 구문을 -CUOptions [[.* .* cu4 "cu4 description" 0 false DEFAULT]]로 지정하십시오.
-MapTargets
컴포지션 단위 대상 맵핑에 대한 추가 특성을 지정합니다. MapTargets 단계에서 다음 옵션을 지정하십시오.
deplUnit(읽기 전용)
배치 가능 단위 URI(Uniform Resource Identifier)를 지정합니다.
EBA(Enterprise Bundle Archive) 자산의 경우 이 URI는 ebaDeploymentUnit입니다.
서버
컴포지션 단위를 배치할 대상을 지정합니다. 기본값은 server1 서버입니다. 더하기 부호 문자( + )를 사용하여 여러 대상을 지정하십시오. 더하기 부호 문자( + )를 접두어로 사용하여 추가 대상을 추가하십시오. WebSphere Application Server 서버가 아닌 각 서버의 전체 오브젝트 이름 형식을 지정하십시오.
예를 들어 이 단계의 구문을 -MapTargets [[a1.jar cluster1+cluster2] [a2.jar server1+server2]]로 지정하십시오.
-ActivationPlanOptions
컴포지션 단위 활성화 계획에 대한 추가 특성을 지정합니다. ActivationPlanOptions 단계에서 다음 옵션을 지정하십시오.
deplUnit(읽기 전용)
배치 가능 단위 URI(Uniform Resource Identifier)를 지정합니다.
activationPlan
활성화 계획으로 런타임 컴포넌트 목록을 지정합니다. specName=xxx,specVersion=yyy 형식으로 각 활성화 계획을 지정하십시오. 여기서 specName은 스펙의 이름을 표시하며 필수입니다. 더하기 부호 문자( + )를 사용하여 여러 활성화 계획을 지정하십시오.
예를 들어 이 단계의 구문을 -ActivationPlanOptions [[a1.jar specname=actplan0+actplan1] [a2.jar specname=actplan1+specname=actplan2]]로 지정하십시오.
EBA 자산의 경우 활성화 계획을 수정하지 마십시오. 컴포지션 단위가 추가될 때 설정된 기본값 -ActivationPlanOptions [[default ""]]를 유지하십시오.
-RelationshipOptions
자산, 컴포지션 단위 및 비즈니스 레벨 애플리케이션 사이의 관계에 대한 추가 특성을 지정합니다. 컴포지션 단위의 소스 ID가 비즈니스 레벨 애플리케이션에 일치하는 컴포지션 단위가 있는 자산인 경우 이 단계를 사용하십시오. RelationshipOptions 단계에서 다음 옵션을 지정하십시오.
deplUnit(읽기 전용)
배치 가능 단위 URI(Uniform Resource Identifier)를 지정합니다.
relationship
컴포지션 단위 관계를 정의합니다. cuName=xxx 형식으로 컴포지션 단위 오브젝트 이름을 지정하십시오. 더하기 부호 문자(+)를 사용하여 관계에 여러 컴포지션 단위 오브젝트 이름을 지정하십시오. 관계에 지정된 컴포지션 단위가 동일한 비즈니스 레벨 애플리케이션에 없는 경우 시스템이 오류를 리턴합니다.
matchTarget
컴포지션 단위 관계 대상을 새 컴포지션 단위 대상과 일치시키는지 여부를 지정합니다. 기본값은 true입니다.
제품이 matchTarget에 지정된 값을 저장하지 않습니다. 따라서 지금 대상을 일치시키지 않고(false) 나중에 컴포지션 단위를 편집하도록 선택하는 경우 컴포지션 단위를 편집할 때 대상을 일치시키지 않도록 제품에 대해 이 설정을 다시 사용 불가능하게 설정해야 합니다.
예를 들어 이 단계의 구문을 –RelationshipOptions [[a1.jar a.jar auxCU true] [a2.jar a.jar defaultCU false]]로 지정하십시오.
-ContextRootStep
EBA 자산의 경우 컨텍스트 루트가 런타임 시 특정 웹 애플리케이션 번들(WAB)의 웹 페이지가 발견된 위치를 판별합니다.
여기서 지정한 컨텍스트 루트는 정의된 서버 맵핑과 결합되어, 사용자가 WAB 페이지에 액세스하기 위해 입력하는 전체 URI를 구성합니다. 예를 들어 애플리케이션 서버 기본 호스트가 www.example.com:8080이고 WAB의 컨텍스트 루트가 /sample인 경우 www.example.com:8080/sample에서 웹 페이지를 사용할 수 있습니다.
OSGi 애플리케이션에 포함된 모든 WAB 모듈의 컨텍스트 루트를 나열해야 합니다.
이 단계의 구문을 다음과 같이 지정하십시오.
  -ContextRootStep [
    [bundle_symbolic_name_1 bundle_version_1 context_root_1]
    [bundle_symbolic_name_2 bundle_version_2 context_root_2]]
예를 들어 두 개의 WAB(버전 1.0.0에서는 com.ibm.ws.eba.helloWorldService.web/hello/web에 맵핑되며 버전 0.9.0에서는 com.ibm.ws.eba.helloWorldService.withContextRoot/hello/service에 맵핑됨)를 포함하는 EBA 파일의 경우 명령은 다음과 같습니다.
  -ContextRootStep [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 "/hello/web"] 
    [com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0 "/hello/service"]]
-VirtualHostMappingStep
EBA 자산의 경우 가상 호스트를 사용하여 고유 포트를 모듈 또는 애플리케이션과 연관시킵니다. 가상 호스트의 별명은 해당 가상 호스트에 정의된 포트 번호를 식별합니다. 가상 호스트 별명에 지정된 포트 번호는 웹 모듈에서 서블릿 및 JSP(JavaServer Page) 파일과 같은 아티팩트에 액세스하는 데 사용되는 URL에서 사용됩니다. 예를 들어, 별명 myhost:8080은 URL http://myhost:8080/samplehost_name:port_number 부분입니다.
배치된 자산에 포함된 각 WAB는 가상 호스트에 맵핑해야 합니다. WAB는 동일한 가상 호스트에 설치되거나 여러 가상 호스트 간에 분산될 수 있습니다.
주어진 WAB의 ibm-web-bnd.xml 또는 .xmi 파일에 기존의 가상 호스트를 지정하면 기본값으로 지정된 가상 호스트가 설정됩니다. 그렇지 않으면 기본 가상 호스트 설정은 별명을 통해 여러 포트 번호를 제공하는 default_host입니다.
80
포트 번호를 지정하지 않을 때 사용되는 내부의 비보안 포트
9080
내부 포트
9443
외부 보안 포트
동일한 노드(물리적 시스템)의 다른 WAB 또는 자원에서 WAB를 분리시키려는 경우를 제외하고, default_host는 적합한 가상 호스트입니다. default_host 이외에, WebSphere Application Server는 관리 콘솔 시스템 애플리케이션의 가상 호스트인 admin_host를 제공합니다. admin_host는 포트 9060에 있습니다. 보안 포트는 9043입니다. WAB가 시스템 관리에 관련된 경우 이외에는 admin_host를 선택하지 마십시오.
이 단계의 구문을 다음과 같이 지정하십시오.
-VirtualHostMappingStep [
    [bundle_symbolic_name_1 bundle_version_1 
    web_module_name_1 virtual_host_1]
    [bundle_symbolic_name_2 bundle_version_2 
     web_module_name_2 virtual_host_2]]
예를 들어 두 개의 WAB(버전 1.0.0에서는 com.ibm.ws.eba.helloWorldService.webdefault_host에 맵핑되며 버전 0.9.0에서는 com.ibm.ws.eba.helloWorldService.withContextRoottest_host에 맵핑됨)를 포함하는 EBA 파일의 경우 명령은 다음과 같습니다.
-VirtualHostMappingStep [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 "HelloWorld service" default_host]
    [com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0 "HelloWorld second service" test_host]]
-MapRolesToUsersStep
EBA 자산의 경우 이 단계를 사용하여 사용자 또는 그룹에 보안 역할을 맵핑하십시오.
이 단계의 구문을 다음과 같이 지정하십시오.
-MapRolesToUsersStep [
    [role_name everyone? 
    all_authenticated_in_realm? 
    usernames groups]]
키 :
  • role_name은 애플리케이션에 정의된 역할 이름입니다.
  • 모든 사용자가 역할에 있는지 여부를 지정하도록 everyone?Yes 또는 No로 설정됩니다.
  • all_authenticated_in_realm?이 인증된 모든 사용자가 애플리케이션 영역에 액세스할 수 있는지 여부를 지정하도록 Yes 또는 No로 설정됩니다.
  • usernames는 WebSphere Application Server 사용자 이름의 목록이고, 이는 "|" 문자로 구분됩니다.
  • groups은 WebSphere Application Server 그룹의 목록이고, 이는 "|" 문자로 구분됩니다.
참고: usernamesgroups의 경우, 비어 있는 문자열 ""는 "기본값 또는 기존 값 사용"을 의미합니다. 일반적으로 기본값은 사용자 또는 그룹이 역할에 바인드되지 않습니다. 그러나 애플리케이션에 ibm-application-bnd.xmi 파일이 포함된 경우 usernames의 기본값은 이 파일에서 얻습니다. ibm-application-bnd.xmi 파일을 포함하는 애플리케이션을 배치하고 바인드된 사용자를 제거하려는 경우, "|" 문자(여러 사용자 이름에 대한 구분 기호)를 지정하십시오. 이는 명시적으로 "사용자 없음"을 지정하고 역할에 바인드된 사용자가 없다는 것을 보장합니다.
예를 들어, 다음과 같습니다.
-MapRolesToUsersStep [
    [ROLE1 No Yes "" ""] 
    [ROLE2 No No WABTestUser1 ""] 
    [ROLE3 No No "" WABTestGroup1] 
    [ROLE4 Yes No "" ""]]
-BlueprintResourceRefPostDeployStep
EBA 자산의 경우 Blueprint 컴포넌트가 WebSphere Application Server 자산 참조에 액세스할 수 있습니다. 각 참조는 Blueprint XML 파일에 선언되어 있으며 JCA(Java Platform, Enterprise Edition(Java EE) Connector Architecture) 인증 별명을 사용하여 보안을 제공합니다. OSGi 애플리케이션의 각 번들은 여러 Blueprint XML 파일에 임의의 수의 자원 참조 선언을 포함할 수 있습니다.
자원 참조를 보호할 때 해당 자원 참조는 OSGi 애플리케이션이 배치된 모든 서버 또는 클러스터에 있는 JCA 인증 별명에만 바인드할 수 있습니다. OSGi 애플리케이션은 동일한 보안 도메인에 있는 여러 서버와 클러스터에 배치될 수 있습니다. 그러므로 각 JCA 인증 별명은 대상 서버 및 클러스터의 보안 도메인 또는 글로벌 보안 도메인에 있어야 합니다.
이 단계의 구문을 다음과 같이 지정하십시오.
-BlueprintResourceRefPostDeployStep [
    [
    bundle_symbolic_name 
    bundle_version 
    blueprint_resource_reference_id 
    interface_name 
    jndi_name 
    authentication_type 
    sharing_setting 
    authentication_alias_name
    ]]
참고: jndi_name의 값은 Blueprint XML 파일에서 자원 참조 요소의 filter 속성에 선언한 jndi 이름과 일치해야 합니다.
예를 들어 버전 1.0.0에서 인증 별명 alias1에 바인드되는 번들 com.ibm.ws.eba.helloWorldService.properties.bundle.jar을 포함하는 EBA 파일의 경우 명령은 다음과 같습니다.
-BlueprintResourceRefPostDeployStep[
    [com.ibm.ws.eba.helloWorldService.properties.bundle 1.0.0 resourceRef
    javax.sql.DataSource jdbc/Account Container Shareable alias1]]
-WebModuleResourceRefs
EBA 자산의 경우 자원 참조를 바인드하면 웹 모듈의 자원 종속성이 서버 런타임 환경에서 사용 가능한 실제 자원에 맵핑됩니다. 런타임 환경에서 자원이 알려진 JNDI 이름을 지정하는 맵핑을 사용하여 이 작업을 수행할 수 있습니다. 기본적으로 JNDI 이름은 웹 애플리케이션 번들(WAB) 개발 중에 web.xml 파일에 지정한 자원 ID입니다.
이 단계의 구문을 다음과 같이 지정하십시오.
-WebModuleResourceRefs [
    [
    bundle_symbolic_name
    bundle_version
    resource_reference_id
    resource_type
    target_jndi_name
    login_configuration
    login_properties
    extended_properties
	   ]]
예를 들어, 다음과 같습니다.
-WebModuleResourceRefs [
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/jtaDs javax.sql.DataSource
    jdbc/helloDs "" "" ""]
    [com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/nonJtaDs javax.sql.DataSource
    jdbc/helloDsNonJta "" "" "extprop1=extval1"]]
참고: 확장된 여러 특성을 사용하는 경우, jython 구문은 "extprop1=extval1,extprop2=extval2"입니다.

리턴값

명령은 시스템에서 편집한 컴포지션 단위의 구성 ID를 리턴합니다.

일괄처리 모드 사용법 예제

다음 예를 사용하여 자산의 컴포지션 단위를 편집하고 기존 대상에서 대상을 바꾸십시오.
  • Jython 문자열 사용:
    AdminTask.editCompUnit('-blaID myBLA – cuID cu1 – CUOptions [[.* .* cu1 cudesc 1 false DEFAULT]] -MapTargets 
      [[.* server2]] -ActivationPlanOptions [.* #specname=actplan0+specname=actplan2]')
  • Jython 목록 사용:
    AdminTask.editCompUnit(['-blaID', 'myBLA', '–cuID', 'cu1', '–CUOptions', 
      '[[.* .* cu1 cudesc 1 false DEFAULT]]', '-MapTargets', '
      [[.* server2]]', '-ActivationPlanOptions', '[.* #specname=actplan0+specname=actplan2]'])
다음 예제를 사용하여 자산의 컴포지션 단위 및 관계를 편집하십시오.
  • Jython 문자열 사용:
    AdminTask.editCompUnit('-blaID ourBLA – cuID cu4 – CUOptions [[.* .* cu4 "new cu desc" 1 false DEFAULT]]
       –MapTargets [[a1.jar server1+server2]] –RelationshipOptions [[a1.jar cuname=cub true]]')
  • Jython 목록 사용:
    AdminTask.editCompUnit(['-blaID', 'ourBLA', '–cuID', 'cu4', '–CUOptions', '
      [[.* .* cu4 "new cu desc" 1 false DEFAULT]]', '–MapTargets', '[[a1.jar server1+server2]]', '–RelationshipOptions', 
      '[[a1.jar cuname=cub true]]'])
기존 관계에 새 관계를 추가하여 컴포지션 단위를 편집하려면 다음 예를 사용하십시오.
  • Jython 문자열 사용:
    AdminTask.editCompUnit('[-blaID ourBLA – cuID cu4 – CUOptions [[.* .* cu4 "new cu desc" 1 false DEFAULT]]
       –MapTargets [[a1.jar server1+server2]] –RelationshipOptions [[a1.jar +cuname=cuc true]] -ActivationPlanOptions 
      [a1.jar +specname=actplan2#specname=actplan1]]')
  • Jython 목록 사용:
    AdminTask.editCompUnit(['-blaID', 'ourBLA', '–cuID', 'cu4', '–CUOptions', '
      [[.* .* cu4 "new cu desc" 1 false DEFAULT]]', '–MapTargets', '[[a1.jar server1+server2]]', '–RelationshipOptions',
       '[[a1.jar +cuname=cuc true]]', '-ActivationPlanOptions', '[a1.jar +specname=actplan2#specname=actplan1]'])
다음 예제를 사용하여 엔터프라이즈 컴포지션 단위 구성을 편집하십시오.
  • Jython 문자열 사용:
    AdminTask.editCompUnit('-blaID yourBLA – cuID defaultapp – MapModulesToServers 
      [[defaultapp.war .* WebSphere:cluster=cluster1][Increment.jar .* Websphere:cluster=cluster2]]
       –CtxRootForWebMod [[defaultapp.war .* /]] –MapWebModToVH [[defaultapp.war .* vh1]]')
  • Jython 목록 사용:
    AdminTask.editCompUnit(['-blaID', 'yourBLA', '–cuID', 'defaultapp', '–MapModulesToServers', 
     '[[defaultapp.war .* WebSphere:cluster=cluster1][Increment.jar .* Websphere:cluster=cluster2]]', '–CtxRootForWebMod', 
     '[[defaultapp.war .* /]]', '–MapWebModToVH', '[[defaultapp.war .* vh1]]'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.editCompUnit('-interactive')

listCompUnits

listCompUnits 명령은 특정 비즈니스 레벨 애플리케이션과 연관된 각 컴포지션 단위를 표시합니다.

대상 오브젝트

없음

필수 매개변수

-blaID
원하는 비즈니스 레벨 애플리케이션의 구성 ID를 지정합니다. (문자열, 필수)

선택적 매개변수

-includeDescription
명령이 리턴하는 각 자산의 설명을 포함하는지 여부를 지정합니다. (문자열, 선택적)
-includeType
명령이 리턴하는 각 자산의 유형을 포함하는지 여부를 지정합니다. (문자열, 선택적)

리턴값

명령은 각 컴포지션 단위에 대한 유형 및 구성 ID 목록을 다음 예제와 같이 리턴합니다.
Websphere:cuname=cu1
asset
"description for cu1"
Websphere:cuname=cu4
bla
"description for cu4"
WebSphere:cuname=defaultapp
Java EE"description for defaultapp"

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.listCompUnits('-blaID blaname=theirBLA')
  • Jython 목록 사용:
    AdminTask.listCompUnits(['-blaID', 'blaname=theirBLA'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.listCompUnits('-interactive')

setCompUnitTargetAutoStart

setCompUnitTargetAutoStart 명령은 컴포지션 단위의 자동 시작을 사용하거나 사용 안하도록 설정합니다. 이 옵션을 사용하는 경우 컴포지션 단위 대상이 시작되면 시스템이 자동으로 컴포지션 단위를 시작합니다.

대상 오브젝트

없음

필수 매개변수

-blaID
원하는 비즈니스 레벨 애플리케이션의 구성 ID를 지정합니다. 시스템이 고유 비즈니스 레벨 애플리케이션 ID와 일치시키는 경우 명령이 불완전한 구성 ID를 승인합니다. (문자열, 필수).
-cuID
원하는 컴포지션 단위를 지정합니다. 시스템이 고유 컴포지션 단위 ID와 일치시키는 경우 명령이 불완전한 구성 ID를 승인합니다. (문자열, 필수).
-targetID
원하는 대상 이름을 지정합니다. 예를 들어 서버 이름을 지정하여 대상을 특정 서버로 설정하십시오. (문자열, 필수).
-enable
지정된 대상이 시작할 때 관심있는 컴포지션 단위를 자동으로 시작하는지 여부를 지정합니다. 컴포지션 단위를 자동으로 시작하려면 true를 지정하십시오. true를 지정하지 않으면 대상이 시작할 때 시스템이 컴포지션 단위를 시작하지 않습니다. 기본값은 true입니다. (문자열, 필수).

리턴값

명령은 출력을 리턴하지 않습니다.

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.setCompUnitTargetAutoStart('-blaID bla1 – cuID cu1 – targetID server1 – enable true')
  • Jython 목록 사용:
    AdminTask.setCompUnitTargetAutoStart(['-blaID', 'bla1', '–cuID', 'cu1', '–targetID',
       'server1', '–enable', 'true'])

대화식 모드 예제 사용법

  • Jython 문자열 사용:
    AdminTask.setCompUnitTargetAutoStart('-interactive')

viewCompUnit

viewCompUnit 명령은 특정 비즈니스 레벨 애플리케이션에 속한 컴포지션 단위의 구성 정보를 표시합니다.

대상 오브젝트

없음

필수 매개변수

-blaID
원하는 비즈니스 레벨 애플리케이션의 구성 ID를 지정합니다. 시스템이 고유 비즈니스 레벨 애플리케이션 ID와 일치시키는 경우 이 매개변수가 불완전환 구성 ID를 승인합니다. (문자열, 필수).
-cuID
원하는 컴포지션 단위의 구성 ID를 지정합니다. 시스템이 고유 컴포지션 단위 ID와 일치시키는 경우 이 매개변수가 불완전한 구성 ID를 승인합니다. (문자열, 필수)

선택적 매개변수

없음

리턴값

명령은 원하는 컴포지션 단위에 대한 구성 정보를 다음 예제와 같이 리턴합니다.
Specify Composition Unit options (CUOptions)

Specify name, description options for Composition Unit.

Parent BLA (parentBLA): [WebSphere:blaname=myBLA]
Backing Id (backingId): [WebSphere:assetname=asset1.zip]
Name (name): [cu1]
Description (description): [cuDesc]
Starting Weight (startingWeight): [0]
Started on distributed (startedOnDistributed): [false]
Restart behavior on update (restartBehaviorOnUpdate): [DEFAULT]

Specify servers (MapTargets)

Specify targets such as application servers or clusters of application servers where you want to deploy the cu contained in the application.

Deployable Unit (deplUnit): [default]
*Servers (server): [WebSphere:node=myNode,server=server1]

Specify Composition Unit activation plan options (ActivationPlanOptions)

Specify CU activation plan optionsDeployableUnit Name (deplUnit): [default]
Activation Plan (activationPlan): [WebSphere:specname=actplan0+WebSphere:specname=actplan1] 
컴포지션 단위에 EBA(Enterprise Bundle Archive) 자산이 포함된 경우, 컴포지션 단위 상태도 표시됩니다. 이 상태의 값은 다음 중 하나입니다.
  • 최신 OSGi 애플리케이션 배치 사용
  • 여전히 다운로드 중인 번들이 필요하므로 새 OSGi 애플리케이션 배치는 아직 사용 가능하지 않습니다.
  • 새 OSGi 애플리케이션 배치가 사용 가능합니다.
  • 번들 다운로드에 실패하여 새 OSGi 애플리케이션 배치를 적용할 수 없습니다.

일괄처리 모드 사용법 예제

다음 예제에서는 비엔터프라이즈 자산에 대한 구성 정보를 표시합니다.
  • Jython 문자열 사용:
    AdminTask.viewCompUnit('-blaID myBLA -cuID myCompUnit')
  • Jython 목록 사용:
    AdminTask.viewCompUnit(['-blaID', 'myBLA', '-cuID', 'myCompUnit'])
다음 예제에서는 엔터프라이즈 자산에 대한 구성 정보를 표시합니다.
  • Jython 문자열 사용:
    AdminTask.viewCompUnit('-blaID myBLA -cuID defaultApplication')
  • Jython 목록 사용:
    AdminTask.viewCompUnit(['-blaID', 'myBLA', '-cuID', 'defaultApplication'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.viewCompUnit('-interactive')

createEmptyBLA

createEmptyBLA 명령은 비어 있는 비즈니스 레벨 애플리케이션을 작성합니다. 비즈니스 레벨 애플리케이션을 작성한 후에는 자산 또는 다른 비즈니스 레벨 애플리케이션을 애플리케이션에 컴포지션 단위로 추가할 수 있습니다.

대상 오브젝트

없음

필수 매개변수

-name
새 비즈니스 레벨 애플리케이션에 대한 고유 이름을 지정합니다. (문자열, 필수).

선택적 매개변수

-description
새 비즈니스 레벨 애플리케이션에 대한 설명을 지정합니다. (문자열, 선택적)

리턴값

명령은 새 비즈니스 레벨 애플리케이션의 구성 ID를 다음 예제와 같이 리턴합니다.
WebSphere:blaname=myBLA

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.createEmptyBLA('-name myBLA -description "my description for BLA"')
  • Jython 목록 사용:
    AdminTask.createEmptyBLA(['-name', 'myBLA', '-description', '"my description for BLA"'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.createEmptyBLA('-interactive')

deleteBLA

deleteBLA 명령은 구성에서 비즈니스 레벨 애플리케이션을 제거합니다. 비즈니스 레벨 애플리케이션을 삭제하려면 deleteCompUnit 명령을 사용하여 비즈니스 레벨 애플리케이션과 연관되는 각 컴포지션 단위를 제거하십시오. 기타 비즈니스 레벨 애플리케이션이 삭제할 비즈니스 레벨 애플리케이션을 참조하지 않는지도 확인하십시오.

대상 오브젝트

없음

필수 매개변수

-blaID
원하는 비즈니스 레벨 애플리케이션의 구성 ID를 지정합니다. 시스템이 문자열을 고유 ID에 일치시킬 수 있는 경우 명령이 blaID 매개변수의 불완전한 ID를 승인합니다. 예를 들어 myBLA 부분 ID를 지정하여 WebSphere:blaname=myBLA 구성 ID를 식별할 수 있습니다. (문자열, 필수).

선택적 매개변수

없음

리턴값

명령은 삭제된 비즈니스 레벨 애플리케이션의 구성 ID를 다음 예제와 같이 리턴합니다.
WebSphere:blaname=myBLA

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.deleteBLA('-blaID myBLA')
  • Jython 목록 사용:
    AdminTask.deleteBLA(['-blaID', 'myBLA'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.deleteBLA('-interactive')

editBLA

editBLA 명령은 비즈니스 레벨 애플리케이션에 대한 설명을 수정합니다.

대상 오브젝트

없음

필수 매개변수

-blaID
원하는 비즈니스 레벨 애플리케이션의 구성 ID를 지정합니다. (문자열, 필수)

선택적 단계

선택적 단계로, .* 문자를 지정하면 명령 구문에 읽기 전용 인수가 지정되고, "" 문자로 빈 문자열을 지정하면 기존 인수 값이 보존됩니다. 쓰기 가능한 인수에 대해 값이나 빈 문자열을 지정하지 않으면 명령이 인수를 널값으로 재설정합니다.
-BLAOptions
BLAOptions 단계를 사용하여 관심있는 비즈니스 레벨 애플리케이션의 새 설명을 지정하십시오.
name(읽기 전용)
비즈니스 레벨 애플리케이션 이름을 지정합니다.
설명
비즈니스 레벨 애플리케이션에 대한 설명을 지정합니다.

리턴값

명령은 출력을 리턴하지 않습니다.

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.editBLA('-blaID DefaultApplication – BLAOptions [[.* "my new description"]]')
  • Jython 목록 사용:
    AdminTask.editBLA(['-blaID', 'DefaultApplication', '–BLAOptions', '[[.* "my new description"]]'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.editBLA('-interactive')

getBLAStatus

getBLAStatus 명령은 비즈니스 레벨 애플리케이션 또는 컴포지션 단위가 실행 중인지 아니면 중지되었는지 여부를 표시합니다.

대상 오브젝트

없음

필수 매개변수

-blaID
원하는 비즈니스 레벨 애플리케이션의 구성 ID를 지정합니다. listBLAs 명령을 사용하여 비즈니스 레벨 애플리케이션 구성 ID 목록을 표시하십시오. (문자열, 필수).

선택적 매개변수

-cuID
원하는 컴포지션 단위의 구성 ID를 지정합니다. listCompUnits 명령을 사용하여 컴포지션 단위 구성 ID 목록을 표시하십시오. (문자열, 선택적)

리턴값

명령은 원하는 컴포지션 단위 또는 비즈니스 레벨 애플리케이션의 상태를 리턴합니다.

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.getBLAStatus('-blaID WebSphere:blaname=myBLA -cuID Websphere:cuname=cu1')
  • Jython 목록 사용:
    AdminTask.getBLAStatus(['-blaID', 'WebSphere:blaname=myBLA', '-cuID', 'Websphere:cuname=cu1'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.getBLAStatus('-interactive')

listBLAs

listBLAs 명령은 구성의 비즈니스 레벨 애플리케이션을 표시합니다.

대상 오브젝트

없음

선택적 매개변수

-blaID
원하는 비즈니스 레벨 애플리케이션의 구성 ID를 지정합니다. (문자열, 선택적)
-includeDescription
명령이 리턴하는 각 비즈니스 레벨 애플리케이션의 설명을 포함하는지 여부를 지정합니다. 비즈니스 레벨 애플리케이션 설명을 표시하려면 true를 지정하십시오. (문자열, 선택적)

리턴값

명령은 다음 예가 표시하는 대로 구성의 각 비즈니스 레벨 애플리케이션에 대한 구성 ID 목록을 리턴합니다.
WebSphere:blaname=myBLAWebSphere:blaname=yourBLA

일괄처리 모드 사용법 예제

다음 예는 구성의 각 비즈니스 레벨 애플리케이션을 나열합니다.
  • Jython 사용:
    AdminTask.listBLAs()
다음 예를 사용하여 구성의 각 비즈니스 레벨 애플리케이션을 나열하십시오.
  • Jython 문자열 사용:
    AdminTask.listBLAs('-blaID myBLA')
  • Jython 목록 사용:
    AdminTask.listBLAs(['-blaID', 'myBLA'])
다음 예를 사용하여 각 비즈니스 레벨 애플리케이션 및 해당 설명을 나열하십시오.
  • Jython 문자열 사용:
    AdminTask.listBLAs('-includeDescription true')
  • Jython 목록 사용:
    AdminTask.listBLAs(['-includeDescription', 'true'])

대화식 모드 예제 사용법

  • Jython 문자열 사용:
    AdminTask.listBLAs('-interactive')

listControlOps

listControlOps 명령은 비즈니스 레벨 애플리케이션과 해당 컴포지션 단위의 제어 조작을 표시합니다.

대상 오브젝트

없음

필수 매개변수

-blaID
원하는 비즈니스 레벨 애플리케이션의 구성 ID를 지정합니다. (문자열, 필수)

선택적 매개변수

-cuID
원하는 컴포지션 단위를 지정합니다. (문자열, 선택적)
-opName
원하는 조작 이름을 지정합니다. (문자열, 선택적)
-long
명령 출력에 추가 구성 정보를 포함하는지 여부를 지정합니다. (문자열, 선택적)

리턴값

명령은 다음 예가 표시하는 대로 조회 범위의 매개변수 설명, 조작 설명 및 조작 목록을 리턴합니다.
"Operation: start"
   "Description: Start operation"
   "Operation handler ID: com.mycompany.myasset.ControlOpHandler" 
   "Operation handler data URI: None"
"Operation: stop"
   "Description: Stop operation"
   "Operation handler ID: com.mycompany.myasset.ControlOpHandler"
   "Operation handler data URI: None"
"Operation: clearCache"
   "Description: Clears specified cache or all caches"
   "Operation handler ID: com.mycompany.myasset.ControlOpHandler"
   "Operation handler data URI: None"
   "Parameter: cacheName"
      "Description: Name of cache to clear.  If not specified, all caches are cleared."

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.listControlOps('-blaID myBLA – cuID myservice.jar – long true')
  • Jython 목록 사용:
    AdminTask.listControlOps(['-blaID', 'myBLA', '–cuID', 'myservice.jar', '–long true'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.listControlOps('-interactive')

startBLA

startBLA 명령은 원하는 비즈니스 레벨 애플리케이션을 시작합니다.

대상 오브젝트

없음

필수 매개변수

-blaID
시작할 비즈니스 레벨 애플리케이션의 구성 ID를 지정합니다. 시스템이 문자열을 구성의 고유 ID와 일치시키는 경우 명령이 불완전한 구성 ID를 승인합니다. (문자열, 필수).

리턴값

비즈니스 레벨 애플리케이션이 시작하는 경우 명령이 상태 메시지를 리턴합니다. 비즈니스 레벨 애플리케이션이 시작되지 않으면 명령은 출력을 리턴하지 않습니다. 다음 예제에서는 상태 메시지 출력을 표시합니다.
BLA ID of started BLA if the BLA was not already running.  

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.startBLA('-blaID myBLA')
  • Jython 목록 사용:
    AdminTask.startBLA(['-blaID', 'myBLA'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.startBLA('-interactive')

stopBLA

stopBLA 명령은 원하는 비즈니스 레벨 애플리케이션을 중지합니다.

대상 오브젝트

없음

필수 매개변수

-blaID
중지할 비즈니스 레벨 애플리케이션의 구성 ID를 지정합니다. 시스템이 문자열을 구성의 고유 ID와 일치시키는 경우 명령이 불완전한 구성 ID를 승인합니다. (문자열, 필수).

리턴값

비즈니스 레벨 애플리케이션이 중지되면 명령이 상태 메시지를 리턴합니다. 비즈니스 레벨 애플리케이션이 중지하지 않으면 명령은 출력을 리턴하지 않습니다. 다음 예제에서는 상태 메시지 출력을 표시합니다.
BLA ID of stopped BLA if the BLA was not already stopped. 

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.stopBLA('-blaID myBLA')
  • Jython 목록 사용:
    AdminTask.stopBLA(['-blaID', 'myBLA'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.stopBLA('-interactive')

viewBLA

viewBLA 명령은 원하는 비즈니스 레벨 애플리케이션의 이름 및 설명을 표시합니다.

대상 오브젝트

없음

필수 매개변수

-blaID
원하는 비즈니스 레벨 애플리케이션의 구성 ID를 지정합니다. 시스템이 문자열을 고유 비즈니스 레벨 애플리케이션과 일치시키는 경우 명령이 불완전한 구성 ID를 승인합니다. (문자열, 필수).

선택적 매개변수

없음

리턴값

명령은 원하는 비즈니스 레벨 애플리케이션에 대한 구성 정보를 다음 예제와 같이 리턴합니다.
Specify BLA options (BLAOptions)

Specify options for BLA

*BLA Name (name): [DefaultApplication]
BLA Description (description): []

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.viewBLA('-blaID DefaultApplication')
  • Jython 목록 사용:
    AdminTask.viewBLA(['-blaID', 'DefaultApplication'])

대화식 모드 예제 사용법

  • Jython 사용:
    AdminTask.viewBLA('-interactive')

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



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