프로그래밍을 사용하여 설치를 위한 애플리케이션 준비

제품 애플리케이션 관리 아키텍처는 애플리케이션 개발자가 WebSphere® Application Server 특정 배치 정보(이후부터 바인딩 정보라 함)를 수집하여 애플리케이션 EAR 파일에 저장할 수 있는 클래스 세트를 제공합니다. 그리고 이러한 EAR 파일은 프로그래밍을 통한 애플리케이션 설치 주제에 설명된 애플리케이션 관리 인터페이스를 사용하여 WebSphere Application Server 구성에 설치될 수 있습니다. 이 주제에는 EAR 파일을 바인딩 정보로 채울 수 있는 방법을 설명하는 프로그래밍 예제가 사용됩니다.

시작하기 전에

이 태스크에서는 WebSphere Application Server 프로그래밍 인터페이스 및 MBean 프로그래밍에 대한 기본 사항을 알고 있는 것으로 가정합니다. API(Application Programming Interface) 문서에서 WebSphere Application Server 프로그래밍 인터페이스와 MBean 프로그래밍에 대한 내용을 참조하십시오.

이 태스크 정보

프로그래밍을 통한 설치를 위해 애플리케이션을 준비하는 다음 태스크를 완료하십시오.

프로시저

  1. AppDeploymentController를 작성하십시오.
    AppDeploymentController는 EAR 파일을 인수로 취하여 AppDeploymentTask 오브젝트(이후부터 태스크라함)로 표현되는 일련의 단계를 작성합니다. 일반적으로 태스크는 바인딩 정보를 수집하는 배치자에게 제공되며 프로그래밍 방식으로 조작됩니다. 다음 인용 코드는 AppDeploymentController 인스턴스를 작성하는 방법을 보여 줍니다.
    // create preferences to pass in the locale information 
    Hashtable prefs = new Hashtable();
    prefs.put(AppConstants.APPDEPL_LOCALE, Locale.getDefault());
    
    
    // create a controller instance for EAR file 
    // specified by a fully-qualified path in earName 
    AppDeploymentController flowController =
    AppManagementFactory.readArchive (earName, prefs); 
  2. AppDeploymentTask 인스턴스를 얻으십시오. AppDeploymentController를 작성하고 나면 이를 작성한 태스크 오브젝트를 반복할 수 있습니다. 각 태스크는 애플리케이션의 다양한 모듈이나 애플리케이션 자체에 대한 특정 종류의 바인딩 정보를 수집합니다. 태스크에는 다음 속성 및 대응되는 Getter/Setter가 있습니다. 해당 속성에 대한 자세한 정보는 AppDeploymentTask API의 Javadoc을 참조하십시오.
    표 1. 태스크 속성. 다음 표는 AppDeploymentController 태스크에 있을 수 있는 속성을 설명합니다.
    Name 설명
    appController 태스크를 관리하는 제어기 인스턴스 AppDeploymentController
    colNames 태스크 열 이름 java.lang.String[]
    hasHiddenColumns 태스크에 숨겨진 열이 있는지 여부를 지정합니다. boolean
    HiddenColumns 일반 사용자에게 태스크를 표시하는 도구가 이 열을 표시하지 않아야 한다는 것을 나타내는 부울 배열. boolean[]
    HIGHEST_VERSION Public static final java.lang.String HIGHEST_VERSION static java.lang.String
    isSufficientlyDone 태스크에 지정되지 않은 필수 데이터가 있는지 여부를 지정합니다. boolean
    isTaskDisabled 태스크를 표시 또는 변경해야 하는지 여부를 지정합니다. boolean
    isTaskEmpty 태스크에 데이터가 있는지 여부를 지정합니다. boolean
    isValidationEnabled 태스크의 유효성을 검증해야 하는지 여부를 지정합니다. boolean
    mutables 애플리케이션을 배치 중인 사용자가 특정 열 색인의 태스크 데이터를 변경할 수 있는지 여부를 표시하는 부울 배열. boolean[]
    이름 고유 태스크 이름 java.lang.String
    requiredColumns 태스크 열에 널이 아닌 값이 있어야 하는지 여부를 표시하는 부울 배열. boolean[]
    taskData 문자열의 2차원 배열(테이블). 테이블의 첫 행에는 태스크의 열 표제(예: 모듈 이름, 모듈 URI, JNDI 이름 등)가 포함됩니다. 나머지 행은 애플리케이션 특정 정보를 나타냅니다. java.lang.String[]
    taskValidateErrorMessages 태스크 유효성 검증 시 생성된 오류 메시지 java.lang.String[]
    VERSION_HIGHEST public static final int VERSION_HIGHEST static int

    다음 표는 J2EE 1.2, J2EE 1.3 또는 Java™ EE 5 이상 애플리케이션의 AppDeploymentController에서 일반적으로 작성되는 다양한 태스크 이름을 설명합니다. 애플리케이션에 WebSphere Application Server 엔터프라이즈 확장기능이 포함된 경우에는 더 많은 태스크가 있을 수 있습니다.

    표 2. J2EE 1.2, J2EE 1.3 또는 Java EE 5 이상 애플리케이션의 AppDeploymentController에서 일반적으로 작성된 태스크 이름. 다음 표는 J2EE 1.2, J2EE 1.3 또는 Java EE 5 이상 애플리케이션의 AppDeploymentController에서 일반적으로 작성되는 태스크 이름을 제공합니다. 또한 각 태스크에 대한 설명과 태스크 열 이름을 제공합니다.
    AppDeploymentTask 이름 설명 태스크 열 이름
    MapRolesToUsers 보안 역할에 대한 사용자 또는 그룹을 작성할 수 있습니다. 애플리케이션 또는 묘듈에 정의되어 있는 각 역할을 도메인 사용자 레지스트리의 사용자 또는 그룹에 맵핑해야 합니다. 태스크 데이터의 각 행은 단일 보안 역할을 나타냅니다. 하나의 역할에 여러 사용자 또는 그룹을 따옴표(")로 구분하여 지정할 수 있습니다.
    • role - 사용자에게 제공된 특정 기능을 나열합니다. 역할 특권은 사용자 및 그룹에 지정된 대로 실행할 수 있는 권한을 제공합니다.예를 들어, 사용자 Joe를 관리자 역할에 맵핑하여 사용자 Joe가 관리자 역할과 연관된 모든 태스크를 수행할 수 있도록 합니다. 권한 정책은 글로벌 보안이 사용 가능할 때만 강제 실행됩니다.
    • everyone - 모든 사용자를 지정된 역할에 맵핑할지 여부를 지정합니다.
    • allAuthenticatedUsers - 범주와 관계없이 인증된 모든 사용자를 지정된 역할에 맵핑할지 여부를 지정합니다.
    • mappedUsers - 이 애플리케이션에서 지정된 역할에 맵핑된 사용자를 나열합니다.
    • mappedGroups - 이 애플리케이션에서 지정된 역할에 맵핑된 그룹을 나열합니다.
    • AllAuthenticatedInTrustedRealms - 신뢰 범주에 있는 모든 사용자를 지정된 역할에 맵핑할지 여부를 지정합니다.
    • userAccessIds - WebSphere Application Server 기본 권한 엔진 사용 시 Java Platform, Enterprise Edition 권한에 사용된 사용자 정보를 지정합니다. userAccessIds의 형식은 user:realm/uniqueUserID입니다.
    • groupAccessIds - 그룹 정보를 지정합니다. 그룹 accessId의 형식은 group:realm/uniqueGroupID입니다.
    • 맵핑된 사용자 액세스 ID - 맵핑된 사용자 액세스 ID를 표시합니다.
    • 맵핑된 그룹 액세스 ID - 맵핑된 그룹 액세스 ID를 표시합니다.
    MapRunAsRolesToUsers run-as 역할의 신임 정보를 지정할 수 있습니다. 설치 중인 엔터프라이즈 Bean에는 사전 정의된 RunAs 역할이 포함되어 있습니다. 다른 엔터프라이즈 Bean과 대화하는 동안 인식을 위해 특정 역할로서 실행해야 하는 엔터프라이즈 Bean이 RunAs 역할을 사용합니다. 태스크 데이터의 각 행은 단일 run-as 역할을 나타냅니다.
    • role - 특정 성능을 사용자에게 맵핑합니다. 권한 정책은 글로벌 보안이 사용 가능할 때만 강제 실행됩니다.
    • userName - RunAs 역할 사용자의 사용자 이름을 지정합니다. 이 사용자는 MapRolesToUsers 태스크에 지정된 역할에 이미 맵핑되어 있습니다. 사용자를 해당 역할에 직접 맵핑하거나 사용자가 들어 있는 그룹을 해당 역할에 맵핑함으로써 적절한 역할에 사용자를 맵핑할 수 있습니다.
    • password - RunAs 사용자의 비밀번호를 지정합니다.
    BindJndiForEJBNonMessageBinding EJB(Enterprise Java Bean)에 대한 JNDI 이름을 지정할 수 있습니다. 이 JNDI 이름을 사용하여 클라이언트 프로그램에서 EJB 홈을 찾습니다. 한 행의 태스크 데이터는 하나의 JNDI 이름을 제공할 수 있는 단일 EJB를 지정합니다.
    • EJBModule - JNDI 이름에 바인드하는 엔터프라이즈 Bean이 포함된 EJB 모듈을 지정합니다.
    • EJB - 모듈에 포함되는 엔터프라이즈 Bean의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • JNDI - EJB 모듈에 엔터프라이즈 Bean과 연관된 JNDI 이름을 지정합니다.
    BindJndiForEJBMessageBinding 메시지 구동 Bean(MDB)에 대한 활성화 스펙의 리스너 포트 이름 또는 JNDI를 지정할 수 있습니다. 애플리케이션 또는 모듈의 각 MDB가 활성화 스펙의 리스너 포트 이름 또는 JNDI에 바인드되어 있는지 확인하십시오. 태스크 데이터의 각 행은 단일 메시지 구동 Bean을 나타냅니다.
    • EJBModule - 엔터프라이즈 Bean이 포함된 Enterprise JavaBeans 모듈을 지정합니다.
    • EJB - 애플리케이션에서 MDB의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • listenerPort - MDB의 리스너 포트 이름을 지정합니다.
    • actSpecJNDI - MDB의 활성화 스펙 JNDI 이름을 지정합니다. MDB를 활성화 스펙 JNDI 이름에 바인드하는 경우에는 대상 JNDI 이름 및 인증 별명도 지정할 수 있습니다.
    • actSpecDestinationJNDI - 활성화 스펙의 대상 JNDI 이름을 지정합니다.
    • actSpecAuth - 구성된 J2C 활성화 스펙에 설정된 사용자 이름 및 비밀번호에 액세스하는 데 사용되는 인증 별명을 지정합니다.
    BindJndiForEJBBusiness EJB 모듈의 비즈니스 인터페이스로 각 엔터프라이즈 Bean에 JNDI 이름 바인딩을 지정할 수 있습니다. EJB 모듈의 비즈니스 인터페이스가 포함된 각 엔터프라이즈 Bean을 JNDI 이름에 바인드해야 합니다. 한 행의 태스크 데이터는 하나의 JNDI 이름을 제공할 수 있는 단일한 엔터프라이즈 Bean을 지정합니다.
    • EJBModule - JNDI 이름에 바인드하는 엔터프라이즈 Bean이 포함된 EJB 모듈을 지정합니다.
    • EJB - JNDI 이름에 바인드하는 엔터프라이즈 Bean의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • businessInterface - EJB 모듈에 엔터프라이즈 Bean 비즈니스 인터페이스를 지정합니다.
    • JNDI - EJB 모듈에 엔터프라이즈 Bean 비즈니스 인터페이스와 연관된 JNDI 이름을 지정합니다.
    MapEJBRefToEJB ejb-ref에 바인드된 EJB의 JNDI 이름을 지정할 수 있습니다. 태스크 데이터의 각 행은 모듈에 정의된 단일 ejb-ref를 나타냅니다.

    EJB 3.0 모듈은 컨테이너 관리 또는 Bean 관리 지속 엔티티 Bean을 포함할 수 없습니다. 컨테이너 관리 또는 Bean 관리 지속 엔티티 Bean이 Java EE 애플리케이션의 EJB 3.0 모듈에 패키지된 경우, 설치에 실패합니다. 컨테이너 관리 또는 Bean 관리 지속을 EJB 2.1 또는 이전 모듈에서만 패키지할 수 있습니다.

    IEJB 3.0, 웹 2.4 또는 웹 2.5 모듈의 EJB 참조인 경우 JNDI 이름은 선택사항입니다. EJB 참조 대상이 자동으로 해석하도록 허용 옵션이 사용 가능한 경우, JNDI 이름은 모든 모듈에 대해 선택적입니다. 바인딩이 제공되지 않으면 런타임에서 컨테이너 기본값을 제공하거나, EJB 참조를 자동으로 해석합니다.

    • EJB - 모듈에 포함되는 엔터프라이즈 Bean의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • referenceBinding - 엔터프라이즈 Bean에서 사용되는 EJB 참조의 이름을 지정합니다.
    • class - 이 엔터프라이즈 Bean과 연관된 Java 클래스의 이름을 지정합니다.
    • JNDI - EJB 모듈에 엔터프라이즈 Bean과 연과된 JNDI 이름을 지정합니다.
    MapResRefToEJB resource-ref에 바인드되는 WebSphere Application Server 구성에 정의된 자원의 JNDI 이름을 지정할 수 있습니다. 태스크 데이터의 각 행은 모듈에 정의된 단일 resource-ref를 나타냅니다.
    • AppVersion - 애플리케이션의 버전을 지정합니다.
    • ModuleVersion - 모듈의 버전을 지정합니다.
    • Module - 애플리케이션에서 모듈의 이름을 지정합니다.
    • EJB - 자원 참조가 포함된 엔터프라이즈 Bean의 이름을 지정합니다(EJB 모듈에만 적용).
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • referenceBinding - 모듈에 포함되는 자원 참조의 이름을 지정합니다.
    • targetResourceJNDI - 자원 참조의 맵핑 대상인 자원의 JNDI 이름을 지정합니다.
    • 로그인 구성 - 이 열은 데이터 소스 및 연결 팩토리에만 적용되며, 자원 보안을 위한 인증 메소드를 나타냅니다.

      J2C(Java 2 Connector)는 DefaultPrincipalMapping 로그인 구성을 사용하여 J2C 인증 데이터 항목에 정의되는 프린시펄에 사용자를 맵핑합니다. login.config.name을 DefaultPrincipalMapping으로 설정하면 이름이 com.ibm.mapping.authDataAlias인 특성이 작성됩니다. 특성의 값은 authentication.props로 설정됩니다. login.config 이름을 DefaultPrincipalMapping으로 설정하지 않는 경우 authentication.props가 여러 특성을 지정할 수 있습니다.

    • 인증 특성 - 로그인 구성에 사용되는 특성을 지정합니다. 문자열 형식은 다음과 같습니다.
      websphere:name= <name1>,value=
      <value1>,description=<desc1>

      더하기 부호(+)를 사용하여 여러 특성을 지정할 수 있습니다.

    • 자원 권한 - 자원 보안을 위한 권한 유형을 지정합니다.
    • 확장 데이터 소스 특성 - DB2 데이터베이스에 대한 확장 데이터 소스 특성을 지정합니다. 이 특성을 사용하여 애플리케이션이 데이터 소스의 사용자 정의 특성을 확장하거나 해당 데이터 소스에 대해 이미 존재하는 비코어 특성을 대체할 수 있습니다.
    MapResEnvRefToRes resource-env-ref에 바인드되는 WebSphere Application Server 구성에 정의된 자원의 JNDI 이름을 지정할 수 있습니다. 태스크 데이터의 각 행은 모듈에 정의된 단일 resource-env-ref를 나타냅니다.
    • Module - 애플리케이션에서 모듈의 이름을 지정합니다.
    • EJB - 자원 환경 참조가 포함된 엔터프라이즈 Bean의 이름을 지정합니다(EJB 모듈에만 적용).
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • referenceBinding - 자원 환경 참조의 이름을 지정합니다. 참조는 Application Server의 JNDI 네임스페이스로의 자원 환경 항목으로 바인드되는 자원에 해당합니다.
    • resEnvRef.type - 자원 환경 참조와 연관된 유형을 지정합니다.
    • JNDI - 자원 환경 참조의 맵핑 대상인 자원 환경 항목의 JNDI 이름을 지정합니다.
    MapSharedLibForMod 정의된 공유 라이브러리를 애플리케이션 또는 웹 모듈과 연관시킬 수 있습니다. 공유 라이브러리는 하나 이상의 애플리케이션이 사용하는 외부 JAR(Java Archive) 파일입니다. 공유 라이브러리를 사용하면 서버에 배치된 여러 애플리케이션이 같은 라이브러리의 여러 사본을 사용하는 대신 단일 라이브러리를 사용할 수 있습니다. 공유 라이브러리를 애플리케이션 또는 모듈과 연관시키면 애플리케이션 또는 모듈 클래스 로더는 공유 라이브러리에 의해 표시되는 클래스를 로드하여 이러한 클래스를 애플리케이션 또는 모듈에서 사용 가능하게 합니다.태스크 데이터의 각 행은 단일 애플리케이션 또는 웹 모듈을 나타냅니다.
    • application - 설치 중인 애플리케이션의 이름을 지정합니다.
    • module - 공유 라이브러리와 연관된 모듈의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • sharedLibraries - 애플리케이션 또는 모듈과 연관된 공유 라이브러리 파일의 이름을 지정합니다.
    SharedLibRelationship 엔터프라이즈 애플리케이션 참조의 모듈인 공유 라이브러리에 대해 관계 ID 및 컴포지션 단위 이름을 지정할 수 있습니다. 엔터프라이즈 애플리케이션을 설치하는 경우, 제품은 사용자가 지정한 비즈니스 레벨 애플리케이션에 있는 각 공유 라이브러리 관계의 컴포지션 단위를 작성합니다. 태스크 데이터의 각 행은 단일 애플리케이션 또는 웹 모듈을 나타냅니다.
    • module - 공유 라이브러리와 연관된 모듈의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • relationshipIdentifiers - 모듈 공유 라이브러리 관계에 대한 공유 라이브러리 자산 또는 컴포지션 단위 ID를 지정합니다. 문자열 형식은 다음과 같습니다.
      assetname=<assetName> or cuname=<cuName>

      더하기 부호(+)를 사용하여 여러 관계를 지정할 수 있습니다.

    • compositionUnit - 공유 라이브러리 관계의 컴포지션 단위 이름을 지정합니다. 제품은 이 값을 사용하여 비즈니스 레벨 애플리케이션의 공유 라이브러리 관계에 대해 작성하는 컴포지션 단위의 이름을 지정합니다. 컴포지션 단위 이름은 위치적으로 관계 필드에 지정된 자산 이름이나 컴포지션 단위 ID와 일치합니다.
    • matchTarget - 제품에서 공유 라이브러리 관계의 컴포지션 단위를 비즈니스 레벨 애플리케이션과 동일한 배치 대상으로 맵핑할지 여부를 지정합니다. 이 컬럼에는 다음 값이 유효합니다.
      • AppConstants.YES_KEY - 제품에서 공유 라이브러리 관계의 컴포지션 단위를 비즈니스 레벨 애플리케이션과 동일한 배치 대상으로 맵핑함을 표시합니다.
      • AppConstants.NO_KEY - 제품에서 공유 라이브러리 관계의 컴포지션 단위를 비즈니스 레벨 애플리케이션과 동일한 배치 대상으로 맵핑하지 않음을 표시합니다.
    CtxRootForWebMod 애플리케이션을 WebSphere Application Server 배치 대상에 설치하는 동안 또는 설치한 후 웹 모듈의 컨텍스트 루트를 지정할 수 있습니다. 태스크 데이터의 각 행은 단일 웹 모듈을 나타냅니다.
    • webModule - 설치 중이거나 설치 후 보고 있는 애플리케이션의 웹 모듈 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • contextRoot - 웹 애플리케이션(WAR)의 컨텍스트 루트를 지정합니다. 각 웹 모듈의 컨텍스트 루트는 애플리케이션 어셈블리 도중 애플리케이션 배치 디스크립터에 정의됩니다. 컨텍스트 루트는 정의된 Servlet 맵핑(WAR 파일에서)과 결합되어, 사용자가 Servlet에 액세스하기 위해 입력하는 전체 URI를 구성합니다. 예를 들어, 컨텍스트 루트가 /gettingstarted이고 Servlet 맵핑이 MySession인 경우, URL은 http://host:port/gettingstarted/MySession입니다.
    MapInitParamForServlet 애플리케이션을 WebSphere Application Server 배치 대상에 설치하는 동안 또는 설치한 후 웹 모듈의 서블릿에 대한 초기 매개변수 값을 지정할 수 있습니다. 웹 모듈의 web.xml 파일에 있는 <init-param> 문에 지정된 <param-value> 값이 기본값으로 사용됩니다. 태스크 데이터의 각 행은 단일 서블릿을 나타냅니다.
    • module - 설치 중이거나 설치 후 보고 있는 애플리케이션의 웹 모듈 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • servlet - 애플리케이션 내 서블릿의 고유 이름을 지정합니다. WAR(Web Archive) 파일 또는 웹 모듈의 Servlet을 패키지화하여 Application Server에 배치해야 합니다. Servlet은 애플릿이 브라우저에서 실행되고 브라우저 성능을 확장하는 방법과 유사한 방법으로 Java 사용 가능 웹 서버에서 실행되며 웹 서버의 성능을 확장합니다.
    • name - 웹 모듈 서블릿 필터의 init 메소드로 전달되는 초기 매개변수의 이름을 지정합니다. web.xml 파일의 다음 예제 서블릿 필터 명령문은 속성의 초기 매개변수 이름을 지정합니다.
      <init-param>
         <param-name>attribute</param-name>
         <param-value>tests.Filter.
      DoFilter_Filter.SERVLET_MAPPED
      </param-value>
      </init-param>
    • value - 웹 모듈 서블릿 필터의 init 메소드로 전달되는 초기 매개변수에 지정된 값을 지정합니다. web.xml 파일의 다음 예제 서블릿 필터 명령문은 초기 매개변수 attribute에 대한 tests.Filter.DoFilter_Filter.SERVLET_MAPPED의 초기 매개변수 값을 지정합니다.
      <init-param>
         <param-name>attribute</param-name>
         <param-value>tests.Filter.
      DoFilter_Filter.SERVLET_MAPPED
      </param-value>
      </init-param>
    • description - 초기 매개변수에 대한 정보를 지정합니다.
    MapEnvEntryForEJBMod 엔티티, 세션 또는 메시지 구동 Bean과 같은 EJB(Enterprise JavaBeans™) 모듈의 환경 항목을 구성할 수 있습니다. 태스크 데이터의 각 행은 EJB 모듈의 단일 환경 항목을 나타냅니다.
    • module - EJB 모듈의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • EJB - 모듈에 포함되는 엔터프라이즈 Bean의 이름을 지정합니다.
    • name - 편집하거나 보고 있는 환경 항목의 이름을 지정합니다. 환경 항목은 EJB 모듈의 env-entry 특성입니다.
    • type - EJB 모듈의 env-entry 특성으로 정의된 환경 항목에 대한 데이터 유형을 지정합니다.
    • description - 환경 항목에 대한 정보를 지정합니다.
    • value - EJB 모듈의 env-entry 특성으로 정의된 환경 항목에 대한 편집 가능한 값을 지정합니다.
    MapEnvEntryForWebMod 서블릿 및 JSP(JavaServer Pages) 파일과 같은 웹 모듈의 환경 항목을 구성할 수 있습니다. 태스크 데이터의 각 행은 웹 모듈의 단일 환경 항목을 나타냅니다.
    • module - 웹 모듈의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • name - 편집하거나 보고 있는 환경 항목의 이름을 지정합니다. 환경 항목은 웹 모듈의 env-entry 특성입니다.
    • type - 웹 모듈의 env-entry 특성으로 정의된 환경 항목에 대한 데이터 유형을 지정합니다.
    • description - 환경 항목에 대한 정보를 지정합니다.
    • value - 웹 모듈의 env-entry 특성으로 정의된 환경 항목에 대한 편집 가능한 값을 지정합니다.
    MapMessageDestinationRefToEJB J2C 관리 오브젝트의 JNDI 이름을 지정하여 메시지 대상 참조를 메시지 구동 Bean에 바인드할 수 있습니다. 태스크 데이터의 각 행은 모듈의 단일 메시지 대상 참조를 나타냅니다.
    • module - EJB 모듈의 이름을 지정합니다.
    • EJB - 모듈에 포함되는 메시지 구동 Bean(MDB)의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • messageDestinationObject - 대상 링크가 제공된 경우 메시지 대상 링크 또는 메시지 대상 참조의 이름을 지정합니다.
    • JNDI - 참조된 메시지 대상 Bean의 대상 JNDI를 지정합니다. 메시지 대상 링크가 제공된 경우, 이 필드는 메시지 대상 링크가 참조하는 메시지 구동 Bean의 대상 JNDI를 기본값으로 사용합니다.
    DataSourceFor10EJBModules EJB1.x Bean이 포함된 EJB 모듈에 사용되는 기본 데이터 소스의 JNDI 이름을 지정할 수 있습니다. 태스크 데이터의 각 행은 단일 EJB 모듈을 나타냅니다.
    • EJBModule - 1.x 엔터프라이즈 Bean이 포함된 모듈의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • JNDI - EJB 모듈에 대한 기본 데이터 소스의 JNDI 이름을 지정합니다.
    • userName - 데이터 소스 보안을 위한 인증 별명을 구성하는 구성된 사용자 이름을 비밀번호와 함께 지정합니다.
    • password- 데이터 소스 보안을 위한 인증 별명을 구성하는 비밀번호를 사용자 이름과 함께 지정합니다.
    • 로그인 구성 - 데이터 소스 보안을 위한 인증 메소드를 지정합니다.
    • 인증 특성 - 로그인 구성에 사용되는 특성을 지정합니다. 문자열 형식은 다음과 같습니다.
      websphere:name= <name1>,value=<value1>,
      description=<desc1>

      더하기 부호(+)를 사용하여 여러 특성을 지정할 수 있습니다.

    DataSourceFor20EJBModules EJB2.x Bean이 포함된 EJB 모듈에 사용되는 기본 연결 팩토리의 JNDI 이름을 지정할 수 있습니다. 태스크 데이터의 각 행은 단일 EJB 모듈을 나타냅니다.
    • EJBModule - 1.x 엔터프라이즈 Bean이 포함된 모듈의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • JNDI - EJB 모듈에 대한 기본 데이터 소스의 JNDI 이름을 지정합니다.
    • 자원 권한 - 자원 보안을 위한 권한 유형을 지정합니다. 올바른 값은 다음과 같습니다.
      AppConstants.APPDEPL_CMPBINDING_
      RESAUTHTYPE_CONTAINER
      AppConstants.APPDEPL_CMPBINDING_
      RESAUTHTYPE_PER_CONNECTION_FACTORY
      .
    • 로그인 구성 - 데이터 소스 보안을 위한 인증 메소드를 지정합니다.
    • 인증 특성 - 로그인 구성에 사용되는 특성을 지정합니다. 문자열 형식은 다음과 같습니다.
      websphere:name= <name1>,value=<value1>,
      description=<desc1>

      더하기 부호(+)를 사용하여 여러 특성을 지정할 수 있습니다.

    • 확장 데이터 소스 특성 - DB2 데이터베이스에 대한 확장 데이터 소스 특성을 지정합니다.

      이 특성을 사용하여 애플리케이션이 데이터 소스의 사용자 정의 특성을 확장하거나 해당 데이터 소스에 대해 이미 존재하는 비코어 특성을 대체할 수 있습니다.

    DataSourceFor10CMPBeans CMP와 연관된 EJB1.x Bean에 사용할 데이터 소스의 JNDI 이름을 지정할 수 있습니다. 태스크 데이터의 각 행은 단일 EJB를 나타냅니다.
    • EJBModule - 1.x 엔터프라이즈 Bean이 포함된 모듈의 이름을 지정합니다.
    • EJB - 모듈에 포함되는 엔터프라이즈 Bean의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • JNDI - EJB 모듈에 대한 기본 데이터 소스의 JNDI 이름을 지정합니다.
    • userName - 데이터 소스 보안을 위한 인증 별명을 구성하는 구성된 사용자 이름을 비밀번호와 함께 지정합니다.
    • password- 데이터 소스 보안을 위한 인증 별명을 구성하는 비밀번호를 사용자 이름과 함께 지정합니다.
    • 로그인 구성 - 데이터 소스 보안을 위한 인증 메소드를 지정합니다.
    • 인증 특성 - 로그인 구성에 사용되는 특성을 지정합니다. 문자열 형식은 다음과 같습니다.
      websphere:name= <name1>,value=<value1>,
      description=<desc1>

      더하기 부호(+)를 사용하여 여러 특성을 지정할 수 있습니다.

    DataSourceFor20CMPBeans CMP와 연관된 EJB2.x Bean에 사용할 연결 팩토리의 JNDI 이름을 지정할 수 있습니다. 태스크 데이터의 각 행은 단일 EJB를 나타냅니다.
    • EJBModule - 1.x 엔터프라이즈 Bean이 포함된 모듈의 이름을 지정합니다.
    • EJB - 모듈에 포함되는 엔터프라이즈 Bean의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • JNDI - EJB 모듈에 대한 기본 데이터 소스의 JNDI 이름을 지정합니다.
    • 자원 권한 - 자원 보안을 위한 권한 유형을 지정합니다. 올바른 값은 다음과 같습니다.
      AppConstants.APPDEPL_CMPBINDING_
      RESAUTHTYPE_CONTAINER
      AppConstants.APPDEPL_CMPBINDING_
      RESAUTHTYPE_PER_CONNECTION_FACTORY
      .
    • 로그인 구성 - 데이터 소스 보안을 위한 인증 메소드를 지정합니다.
    • 인증 특성 - 로그인 구성에 사용되는 특성을 지정합니다. 문자열 형식은 다음과 같습니다.
      websphere:name= <name1>,value=<value1>,
      description=<desc1>

      더하기 부호(+)를 사용하여 여러 특성을 지정할 수 있습니다.

    • 확장 데이터 소스 특성 - DB2 데이터베이스에 대한 확장 데이터 소스 특성을 지정합니다.

      이 특성을 사용하여 애플리케이션이 데이터 소스의 사용자 정의 특성을 확장하거나 해당 데이터 소스에 대해 이미 존재하는 비코어 특성을 대체할 수 있습니다.

    MapWebModToVH 웹 모듈에 대한 가상 호스트를 지정할 수 있습니다. 태스크 데이터의 각 행은 가상 호스트 정보를 수집할 애플리케이션의 웹 모듈을 나타냅니다. 웹 모듈은 동일한 가상 호스트에 설치되거나 여러 가상 호스트 간에 분산될 수 있습니다. 태스크 데이터의 각 행은 단일 웹 모듈을 나타냅니다.
    • webModule - 설치 중이거나 설치 후 보고 있는 애플리케이션의 웹 모듈 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • virtualHost - 웹 모듈이 현재 맵핑되는 가상 호스트의 이름을 지정합니다.

      웹 모듈이 다른 애플리케이션에 포함된 경우라도, 컨텍스트 루트가 동일하고 같은 노드에 속한 대상으로 배치된 서로 다른 웹 모듈에 같은 가상 호스트를 지정하지 마십시오. 같은 가상 호스트를 지정하면 유효성 검증 오류가 발생합니다.

    EnsureMethodProtectionFor10EJB 보호되지 않은 EJB1.x 모듈의 모든 메소드에 대한 액세스를 허용하지 않아야 하는지 여부를 지정할 수 있습니다. 각 태스크 행은 단일 EJB1.x 모듈을 나타냅니다.
    • EJBModule - EJB2.x Bean이 포함된 모듈의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • method.denyAllAccessPermission - 다음 액세스 권한 중 하나를 지정합니다.
      • AAppConstants.YES_KEY - 액세스 권한에 관계없이 사용자가 이 EJB 모듈에 액세스할 수 없도록 해당 EJB 모듈을 보호함을 표시합니다.
      • AppConstants.NO_KEY - 적절한 액세스 권한이 있는 사용자가 이 EJB 모듈에 액세스함을 표시합니다.
    EnsureMethodProtectionFor20EJB EJB 모듈에서 보호되지 않은 EJB2.x Bean 메소드의 보호 레벨을 지정할 수 있습니다. 태스크 데이터의 각 행은 EJB 모듈당 메소드 보호를 지정합니다.
    • EJBModule - EJB2.x Bean이 포함된 모듈의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • method.protectionType - 다음 보호 메소드 중 하나를 지정합니다.
      • AppConstants.APPDEPL_METHOD_PROTECTION_UNCHECK - 애플리케이션 서버가 EJB 모듈에 대한 액세스 권한을 확인하지 않음을 표시합니다. 모든 사용자가 EJB 모듈에 액세스할 수 있습니다.
      • AppConstants.APPDEPL_METHOD_PROTECTION_EXCLUDE - 액세스 권한에 관계없이 사용자가 이 EJB 모듈에 액세스할 수 없도록 해당 EJB 모듈을 보호함을 표시합니다.
    AppDeploymentOptions 다양한 배치 특정 옵션을 지정할 수 있습니다. 이 태스크에는 2행만 있습니다. 첫째 행은 옵션 이름을 지정하고 둘째 행은 해당하는 옵션 값을 지정합니다. 다음 값은 이러한 옵션의 유효한 값입니다(옵션 설명에서 달리 표시한 경우는 제외).
    • AppConstants.YES_KEY - 이 배치 옵션을 사용함을 표시합니다.
    • AppConstants.NO_KEY - 이 배치 옵션을 사용하지 않음을 표시합니다.
    지정할 수 없는 옵션 이름은 다음과 같습니다.
    • preCompileJSPs - JavaServer Pages 파일이 사전에 컴파일되는지 여부를 표시합니다.
    • installed.ear.destination - EAR(Enterprise Archive) 파일을 설치할 디렉토리를 지정합니다. 이 옵션의 값은 완전한 디렉토리 경로(예: profile_root/installedApps/mycell/myapp.ear)입니다.
    • distributeApp - 애플리케이션 관리 컴포넌트가 애플리케이션 2진을 분배하는지 여부를 표시합니다.
    • useMetaDataFromBinary - 런타임 시 사용되는 메타데이터(예: 배치 디스크립터, 바인딩, 확장)가 EAR 파일에 있는지 여부를 표시합니다.
    • deployejb - 설치 중에 EJBDeploy 도구를 실행할지 여부를 지정합니다.
    • appname - 이러한 옵션으로 배치 중인 애플리케이션의 이름을 지정합니다.
    • createMBeansForResources - 배치 대상에서 애플리케이션이 시작할 때 애플리케이션에 정의되는 모든 자원(예: 서블릿, JSP(JavaServer Pages) 파일, 엔터프라이즈 Bean)에 MBean이 작성되는지 여부를 표시합니다.
    • reloadEnabled - 변경사항을 자동으로 로드할 수 있도록 업데이트된 파일에 대해 애플리케이션의 파일 시스템이 스캔되는지 여부를 표시합니다.
    • reloadInterval - 업데이트된 파일에 대해 애플리케이션의 파일 시스템을 스캔할 시간(초)을 지정합니다. 이 옵션에 지정된 값은 0보다 큰 정수입니다.
    • eployws - 배치 중에 wsdeploy 도구를 실행할지 여부를 지정합니다.
    • validateinput - 제품에서 애플리케이션 설치 또는 업데이트 중에 지정된 애플리케이션 참조를 조사하는지 여부를 지정하며, 유효성 검증이 사용 가능한 경우 사용자에게 잘못된 참조를 경고하거나 조작이 실패합니다. 올바른 값은 AppConstants.APPDEPL_VALIDATE_INSTALL_OFF, AppConstants.APPDEPL_VALIDATE_INSTALL_WARMAppConstants.APPDEPL_VALIDATE_INSTALL_FAIL입니다.
    • processEmbeddedConfig - 임베디드 구성을 처리해야 하는지 여부를 지정합니다. 임베디드 구성은 파일(예: resource.xml 및 variables.xml)로 구성됩니다.
    • filepermission - 지정된 디렉토리로 확장되는 설치된 애플리케이션의 애플리케이션 2진에 대한 액세스 권한을 지정합니다.
    • blaname - 제품에서 사용자가 설치 중인 엔터프라이즈 애플리케이션과 함께 새 비즈니스 레벨 애플리케이션을 작성하는지 또는 엔터프라이즈 애플리케이션을 기존 비즈니스 레벨 애플리케이션의 컴포지션 단위로 작성하는지 여부를 지정합니다.
    • autolink - 제품에서 불완전한 EJB 참조 대상의 기본 JNDI 값을 지정하는지 또는 불완전한 EJB 참조 대상을 자동으로 해결하는지 여부를 지정합니다.
    JSPReloadForWebMod JSP(JavaServer Pages) 파일과 같은 웹 모듈의 클래스 다시 로드를 구성하고 이 애플리케이션에 사용할 JSF 구현을 선택할 수 있습니다. 태스크 데이터의 각 행은 단일 웹 모듈을 나타냅니다.
    • webModule - 설치 중이거나 설치 후 보고 있는 애플리케이션의 웹 모듈 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • enableJSPClassReloading - JSP 파일이 업데이트될 때 클래스 다시 로드 사용 가능 여부를 지정합니다.
    • JSPReloadInterval - 제품에서 업데이트된 JSP 파일을 검사하기 위해 애플리케이션의 파일 시스템을 스캔하는 간격(초)을 지정합니다.
    EJBDeployOptions 엔터프라이즈 Bean(EJB) 배치 도구에 대한 옵션을 지정할 수 있습니다. 이 도구는 엔터프라이즈 Bean 파일을 실행하는 데 필요한 코드를 생성합니다. EJB 배치 도구를 실행하는 동안 사용할 추가 클래스 경로, 원격 메소드 호출 컴파일러(RMIC) 옵션, 데이터베이스 유형 및 데이터베이스 스키마 이름을 지정할 수 있습니다.
    • deployejb.classpath - 설치 중인 JAR 또는 EAR 파일에 따라 하나 이상의 zip 파일 또는 JAR(Java Archive) 파일의 클래스 경로를 지정합니다.
    • deployejb.rmic - EJB 배치 도구가 RMIC 옵션을 원격 메소드 호출 컴파일러로 전달하는지 여부를 지정합니다. 옵션에 대한 정보는 RMI 도구 문서를 참조하십시오.이 컬럼에는 다음 값이 유효합니다.
      • EJB 배치 도구가 RMIC 옵션을 원격 메소드 호출 컴파일러로 전달할 수 있는 AAppConstants.YES_KEY.
      • EJB 배치 도구가 RMIC 옵션을 원격 메소드 호출 컴파일러로 전달할 수 없도록 하는 AppConstants.NO_KEY.
    • deployejb.dbtype - 데이터베이스 열 유형, 맵핑 정보, Table.sql 및 기타 정보를 결정하는 데 사용되는 데이터베이스 벤더의 이름을 지정합니다. 데이터베이스 유형을 지정한 경우, 선택한 데이터베이스 유형이 모든 EJB 모듈에 대해 이전에 정의된 백엔드 ID를 겹쳐씁니다. 개별 EJB 모듈에 대한 백엔드 ID를 사용 가능하게 하려면 이 열의 값을 지정하지 마십시오.
    • deployejb.dbschema - 작성할 스키마의 이름을 지정합니다. EJB 배치 도구는 옵션을 다시 지정할 필요가 없음을 의미하는 JAR 또는 EAR 파일로 된 스키마 문서에 데이터베이스 정보를 저장합니다. 또한 JAR 또는 EAR를 생성할 때 나중에 변경할 수 없으므로 올바른 데이터베이스를 해당 위치에 정의해야 합니다.스키마 이름에 공백이 있는 경우에는 전체 이름을 큰따옴표로 묶어야 합니다. 예를 들어, 다음과 같습니다.
      "my schema"
    • deployejb.dbaccesstype - SQLJ(Java)를 지원하는 DB2® 데이터베이스의 데이터베이스 액세스 유형을 지정합니다. SQLJ를 사용하여 DB2 데이터베이스에 연결하는 데이터 액세스 애플리케이션을 개발하십시오. SQLJ는 SQL(Structured Query Language) 데이터베이스 요청을 제공하는 명령문을 임베디드하기 위해 Java 프로그래밍 언어 사용을 지원하는 프로그램밍 확장 세트입니다.
    • deployejb.SQLJclasspath - DB2 SQLJ 도구 sqlj.zip 파일의 클래스 경로를 지정합니다. 제품에서는 이 클래스 경로를 사용하여 애플리케이션 설치 중에 DB2 SQLJ 도구를 실행하고 SQLJ 프로파일(.ser 파일)을 생성합니다.
    • deployejb.JDKcompliancelevel - 컴파일러에 애플리케이션 소스 파일을 포함하는 경우, Java 개발자 킷 컴파일러 준수 레벨을 지정합니다.
    JSPCompileOptions JSP(JavaServer Pages) 컴파일러에서 사용할 다양한 옵션을 지정할 수 있습니다.
    • webModule - 애플리케이션에서 웹 모듈의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • JSPclasspath - 애플리케이션 설치 중에 JSP 파일을 컴파일할 때 사용할 JSP 컴파일러에 대한 임시 클래스 경로를 지정합니다. 이 클래스 경로는 애플리케이션 설치가 완료될 때 저장되지 않고 애플리케이션을 실행할 때 사용되지 않습니다. 이 클래스 경로는 JSP 컴파일에 필요하고 애플리케이션 설치 후 다른 방법(예: 공유 라이브러리)으로 식별되는 애플리케이션 외부 자원을 식별하는 데만 사용됩니다.

      Network Deployment 구성에서 이 클래스 경로는 배치 관리자 시스템에 고유합니다.

    • useFullPackageNames - JSP 엔진이 전체 패키지 이름을 사용하여 JSP 클래스를 생성하고 로드하는지 여부를 지정합니다. 전체 패키지 이름이 사용되면, jsp-file 속성을 사용할 필요없이 사전 컴파일된 JSP 클래스 파일을 web.xml 파일에 서블릿으로 구성할 수 있습니다. 전체 패키지 이름이 사용되지 않으면 모든 JSP 클래스가 동일한 패키지에 생성되므로 소형 파일 시스템 경로의 이점이 감소합니다.
    • JDKSourceLevel - Java 컴파일러가 JSP Java 소스를 컴파일하는 소스 레벨을 지정합니다. 이 열의 값을 지정하는 경우 레벨 번호에서 소수점을 생략하십시오. 예를 들어, JDK 레벨 1.5에 대해 15를 지정하십시오.
    • disableJSPRuntimeCompilation - .class 파일이 없는 경우에도 런타임 시에 JSP 파일이 변환되거나 컴파일되면 안 되는지 여부를 지정합니다. 이 컬럼에는 다음 값이 유효합니다.
      • AAppConstants.YES_KEY - JSP 런타임 컴파일을 사용 불가능하게 함을 의미합니다.
      • AppConstants.NO_KEY - JSP 런타임 컴파일을 사용 불가능하게 하지 않음을 의미합니다.
    MapModulesToServers 애플리케이션의 모듈에 대한 대상 서버 또는 클러스터를 지정할 수 있습니다. 태스크 데이터의 각 행은 애플리케이션에 있는 하나의 행을 나타냅니다. 서버 대상은 WebSphere:cell=cellName,node=nodeName,server=serveName으로 지정되고, 클러스터 대상은 WebSphere:cell=cellName,cluster=clusterName로 지정됩니다. 제공된 모듈에서 "+"로 구분하여 여러 대상을 지정할 수 있습니다. 태스크 데이터의 각 행은 EJB 모듈을 나타냅니다.
    • Module - 애플리케이션에서 모듈의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • server- 이 모듈의 대상 서버 또는 클러스터를 지정합니다.
    CorrectUseSystemIdentity 애플리케이션에서 EJB(Enterprise JavaBeans™) 메소드에 대한 시스템 ID 특성을 관리할 수 있습니다.
    • role - EJB 메소드에 사용되는 RunAs 역할을 지정합니다.
    • userName - RunAs 역할 사용자의 사용자 이름을 지정합니다. 사용자 이름은 역할에 대해 선택한 RunAs 역할과 함께 사용됩니다.
    • password - 사용자 레지스트리에 있는 사용자 이름과 연관된 비밀번호를 지정합니다.
    CorrectOracleIsolationLevel 백엔드 처리를 수행 중인 Oracle 데이터베이스를 사용하는 자원에 맵핑된 자원 참조에 대한 Oracle 유형의 격리 레벨을 지정할 수 있습니다. 각 행은 하나의 Oracle 데이터베이스 자원에 맵핑된 하나의 자원 참조를 나타냅니다.
    • Module - 애플리케이션에서 모듈의 이름을 지정합니다.
    • resourceRef - 자원 참조의 이름을 지정합니다.
    • JNDI - 자원 참조의 맵핑 대상인 자원의 JNDI 이름을 지정합니다.
    • isolationLevel - Oracle 유형 제공자에 사용할 분리 레벨을 지정합니다. 이 열에 대해 다음 두 개의 값을 지정할 수 있습니다.
      • rc - JDBC Read Committed 분리 레벨을 표시합니다.
      • s - JDBC Serializable 분리 레벨을 표시합니다.
    ActSpecJNDI 임베디드 자원 어댑터 모듈의 JCA 오브젝트에 대한 JNDI 이름을 제공할 수 있습니다.
    • Module - 애플리케이션에서 모듈의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • JCA object - J2C 연결 팩토리, 관리 대상 오브젝트 또는 활성화 스펙에 대한 JCA 오브젝트의 이름을 지정합니다.
    • JNDI - JCA 오브젝트에 대한 JNDI 이름을 지정합니다.
    BackendIdSelection CMP(Container-Managed Persistence) Bean이 있는 엔터프라이즈 Bean JAR(Java Archive) 모듈의 백엔드 ID를 지정할 수 있습니다. 엔터프라이즈 Bean JAR 모듈은 애플리케이션 어셈블리 도구를 사용하여 지정된 대로 복수 백엔드 구성을 지원할 수 있습니다.이 태스크는 애플리케이션에 어셈블리 도구를 사용하여 다중 백엔드 데이터베이스용의 배치 코드를 생생한 EJB 모듈이 있는 경우에 유용합니다.
    • Module - 애플리케이션에서 EJB의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • ID - 백엔드 데이터베이스를 나타내는 기존 백엔드 ID입니다.
    • currentID - 사용할 백엔드 데이터베이스를 나타내는 새 백엔드 ID를 지정합니다.
    MetadataCompleteForModules 각 EJB 3.0 모듈 또는 Web 2.5 모듈이 어노테이션의 배치 정보를 포함하여 전체 배치 디스크립터를 작성할 수 있습니다. 그런 다음, 시스템은 모듈의 배치 디스크립터를 완료된 것으로 표시합니다. 태스크 데이터의 각 행은 EJB 모듈을 나타냅니다.
    • module - EJB 3.0 또는 Web 2.5 모듈의 이름을 지정합니다.
    • uri - URI(Uniform Resource Identifier)는 애플리케이션 EAR의 루트와 관련된 모듈 아카이브의 위치를 지정합니다.
    • metadataComplete - 어노테이션의 배치 정보를 포함하여 전체 모듈 배치 디스크립터를 XML 형식으로 작성할지 여부를 지정합니다. 모듈의 metadataComplete가 true로 설정되면 WebSphere가 어노테이션의 배치 정보를 포함하여 전체 배치 디스크립터를 작성합니다. 이 컬럼에는 다음 값이 유효합니다.
      • AppConstants.YES_KEY - EJB 3.0 모듈 또는 Web 2.5 모듈이 어노테이션의 배치 정보를 포함하여 전체 배치 디스크립터를 작성할 수 있음을 표시합니다.
      • AppConstants.NO_KEY - EJB 3.0 모듈 또는 Web 2.5 모듈이 어노테이션의 배치 정보를 포함하여 전체 배치 디스크립터를 작성할 수 없음을 표시합니다.

    다양한 태스크의 URI 열은 관련 값으로 형식을 사용하여 애플리케이션의 모듈을 고유하게 식별합니다. 여기서, moduleURI는 애플리케이션의 배치 디스크립터에 정의된 모듈 파일 이름이며 ddURI는 (표준 배치 디스크립터의 경우) 모듈 내 배치 디스크립터의 URI 또는 애플리케이션의 배치 디스크립터에 정의된 대로 모듈에 대한 대체 배치 디스크립터의 URI입니다. 예를 들어, 애플리케이션에서 MyWeb.war에 웹 모듈이 있고 해당 모듈이 표준 배치 디스크립터를 사용하는 경우, 이 모듈에 대한 다양한 태스크의 URI 열 값은 MyWeb.war,WEB-INF/web.xml입니다. 그러므로 URI 열 값은 항상 모듈의 고유한 식별을 보장합니다.

    다음 인용 코드는 AppDeploymentController에서 태스크를 얻는 방법을 보여 줍니다.

    AppDeploymentTask task =flowController.getFirstTask(); 
    while (task != null)
    {
    // manipulate task data as necessary
    task = flowController.getNextTask();
    } 
  3. 태스크 데이터 조작

    해당하는 열이 변경 가능한 것으로 표시된 경우 바인딩 정보를 제공할 태스크 이름, 태스크 열 이름 및 J2EE 아티팩트를 사용하여 태스크 데이터를 수정할 수 있습니다. 다음 샘플 코드는 특정 태스크에 대한 바인딩 정보를 제공하는 방법을 보여 줍니다. 이 예에서는 보안 역할의 사용자를 지정합니다. 애플리케이션에는 Role1이라는 보안 역할이 있고 해당 역할에 사용자 User1 및 User2를 지정한다고 가정합니다.

    if (task.getName().equals ("MapRolesToUsers") && !task. isTaskDisabled()) 
    { 
    // find out column index for role and user column 
    // refer to the table to find the column names 
    int roleColumn = -1;
    int userColumn = -1;
    String[] colNames = task.getColumnNames();
    for (int i=0; i < colNames.length; i++)
    { 
    if (colNames[i].equals ("role"))
    	roleColumn = i;
    else if (colNames[i].equals ("role.user"))
    userColumn = i; 
    } 
    
    // iterate over task data starting at row 1 as row0 is
    // column names
    String[][] data = task.getTaskData();
    for (int i=1; i < data.length; i++)
    {
    if (data[i][roleColumn].equals ("Role1")) 
    {
    	data[i][userColumn]="User1|User2";
              break;
    }
    } 
    
    // now that the task data is changed, save it back
    task.setTaskData (data);
    } 
    

    유사한 로직을 사용하여 다양한 태스크에서 EJB의 JNDI 이름, 웹 모듈의 가상 호스트 이름 등 바인딩 정보의 기타 모든 유형을 지정할 수 있습니다. 태스크 정보와 샘플 코드로는 애플리케이션 클라이언트 모듈의 바인딩 정보를 수집할 수 없습니다. 애플리케이션 클라이언트를 구성하려면 WebSphere Application Server와 함께 제공된 클라이언트 구성 도구를 사용해야 합니다.

  4. EAR 파일을 저장한 후 설치 옵션을 얻으십시오.

    다양한 태스크에서 필요한 모든 바인딩 정보를 제공한 후, 채워진 EAR 파일을 WebSphere Application Server 구성에 설치할 수 있도록 태스크 데이터를 EAR 파일에 다시 저장해야 합니다. EAR 파일에 저장된 바인딩 정보와 함께, 태스크에서 수집된 몇 가지 다른 배치 옵션(예: AppDeploymentOptions, EJBDeployOptions, MapModulesToServers)이 있습니다. 이들 옵션은 EAR 파일에 저장되지 않지만 WebSphere Application Server 구성에 애플리케이션 설치 시 전달해야 합니다. 필요에 맞게 태스크 데이터를 조작하여 EAR 파일을 저장하고 나면 AppDeploymentController에서 해시 테이블로 이들 옵션을 가져올 수 있습니다. 또는 애플리케이션 설치 절과 com.ibm.websphere.management.application.AppManagement 인터페이스의 installApplication API에 대한 Javadoc에서 설명한 대로 애플리케이션 설치 동안 이들 옵션을 직접 전달할 수 있습니다.

    다음 코드는 태스크 데이터를 EAR 파일에 저장하고 생성된 설치 옵션을 가져오는 방법을 보여 줍니다.

    // the following line of code saves the task data
    // in the EAR file specified as earName in step 1
    flowController.saveAndClose();
    
    
    // get the installation options
    Hashtable options = flowController.getAppDeploymentSavedResults();

다음에 수행할 작업

프로그래밍을 사용하여 애플리케이션을 설치하십시오.


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



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