배치 디스크립터 보기

배치 디스크립터는 애플리케이션 또는 모듈에 대한 구성 및 컨테이너 옵션을 지정하는 XML(extensible markup language) 파일입니다.

시작하기 전에

이 주제에서는 서버에 애플리케이션 또는 모듈을 설치했으며 배치 디스크립터를 보려는 것으로 가정합니다.

이 태스크 정보

어셈블리 도구에서 J2EE(Java™ 2 Platform, Enterprise Edition) 애플리케이션 또는 모듈을 작성하면, 어셈블리 도구가 애플리케이션 또는 모듈의 배치 디스크립터 파일을 작성합니다. Java EE(Java Platform, Enterprise Edition) 5 이상의 애플리케이션 및 모듈은 배치 디스크립터 대신 어노테이션을 사용할 수도 있습니다.

서버에 애플리케이션이나 모듈이 설치된 후, 관리 콘솔에서 해당 배치 디스크립터를 볼 수 있습니다. Java EE 5 이상의 어노테이션은 볼 수 없습니다.

응응프로그램이 Java EE 5 이상을 지원하지 않는 한, EAR(Enterprise Archive) 파일에 application.xml 파일을 포함해야 합니다. application.xml은 애플리케이션의 각 모듈을 식별합니다. Java EE 5 애플리케이션은 EAR 파일에 application.xml 파일을 제공하지 않아도 됩니다. application.xml 파일이 없는 경우, 제품이 JAR(Java Archive) 파일 컨텐츠를 검사하여 JAR 파일이 엔터프라이즈 Bean(EJB) 모듈 또는 애플리케이션 클라이언트 모듈인지 여부를 판별합니다. JAR 파일은 둘 이상의 배치 디스크립터를 포함해서는 안됩니다. ejb-jar.xml 파일이 JAR 파일에 있는 경우 제품은 해당 파일을 EJB 모듈로 간주합니다. ejb-jar.xml 파일이 없고 application-client.xml은 있는 경우 제품은 JAR 파일을 애플리케이션 클라이언트 모듈로 간주합니다. ejb-jar.xmlapplication-client.xml 파일이 모두 JAR 파일에 있는 경우 제품은 애플리케이션 클라이언트 모듈인 JAR 파일을 EJB 모듈로 간주하거나 EJB 모듈인 JAR 파일을 애플리케이션 클라이언트 모듈로 간주합니다. JAR 파일은 둘 이상의 유형의 배치 디스크립터를 포함하면 안 됩니다.

프로시저

  1. 배치 디스크립터 보기를 액세스하십시오.

    주어진 모듈에 대한 배치 디스크립터를 보려면 콘솔 보기 액세스에 명시된 탐색 옵션을 클릭하십시오.

    표 1. 콘솔에서 배치 디스크립터 보기 페이지 액세스. 콘솔 탐색 트리 및 페이지에서 링크를 클릭하십시오.
    모듈 배치 디스크립터 파일 콘솔 보기 액세스
    엔터프라이즈 애플리케이션 application.xml 애플리케이션 > 애플리케이션 유형 > WebSphere 엔터프라이즈 애플리케이션 > application_name > 배치 디스크립터 보기
    웹 애플리케이션 WEB-INF/web.xml 애플리케이션 > 애플리케이션 유형 > WebSphere 엔터프라이즈 애플리케이션 > application_name > 모듈 관리 > module_name > 배치 디스크립터 보기
    WEB-INF/portlet.xml 애플리케이션 > 애플리케이션 유형 > WebSphere 엔터프라이즈 애플리케이션 > application_name > 모듈 관리 > module_name > 포틀릿 배치 디스크립터 보기
    엔터프라이즈 Bean ejb-jar.xml 애플리케이션 > 애플리케이션 유형 > WebSphere 엔터프라이즈 애플리케이션 > application_name > 모듈 관리 > module_name > 배치 디스크립터 보기
    애플리케이션 클라이언트 application-client.xml 애플리케이션 > 애플리케이션 유형 > WebSphere 엔터프라이즈 애플리케이션 > application_name > 모듈 관리 > module_name > 배치 디스크립터 보기
    웹 서비스 webservices.xml 애플리케이션 > 애플리케이션 유형 > WebSphere 엔터프라이즈 애플리케이션 > application_name > 모듈 관리 > module_name >
    • 웹 서비스 클라이언트 배치 디스크립터 확장자 보기
    • 웹 서비스 서버 배치 디스크립터 보기
    • 웹 서비스 서버 배치 디스크립터 확장자 보기
    보기에 대한 정보는 "관리 콘솔에서 웹 서비스 배치 디스크립터 보기" 주제를 참조하십시오.
    엔터프라이즈 애플리케이션에 임베디드된 자원 어댑터 ra.xml 애플리케이션 > 애플리케이션 유형 > WebSphere 엔터프라이즈 애플리케이션 > application_name > 모듈 관리 > ra_module_name > 배치 디스크립터 보기
    독립형 자원 어댑터 ra.xml 자원 > 자원 어댑터 > 자원 어댑터 > module_name > 배치 디스크립터 보기
  2. 배치 디스크립터 컨텐츠를 보려면 모두 펼치기를 클릭하십시오.

결과

애플리케이션 또는 모듈에 대한 배치 디스크립터가 표시됩니다.

제품 DefaultApplication에 대한 배치 디스크립터는 다음과 같습니다.

<application id="Application_ID" >
  <display-name> DefaultApplication.ear</display-name>
  <description> This is the IBM WebSphere Application Server Default Application.</<description>
  <module id="WebModule_1" >
    <web>
      <web-uri> DefaultWebApplication.war</web-uri>
      <context-root> /</context-root>
    </web>
  </module>
  <module id="EjbModule_1" >
    <ejb> Increment.jar</ejb>
  </module>
  <security-role id="SecurityRole_1204342979281" >
    <description> All Authenticated users role.</description>
    <role-name> All Role</role-name>
  </security-role>
</application>

다음에 수행할 작업

콘솔 페이지에 배치 디스크립터가 표시되면, 다음을 수행하십시오.

  1. 애플리케이션 바인딩, 보안 역할, 다른 자원에 대한 참조 또는 JNDI(Java Naming and Directory Interface) 이름에 대해 갖는 모든 구성을 포함하여 배치 디스크립터 컨텐츠를 검사하십시오.

    예를 들어 Java EE 5 이상 모듈의 JAR 파일을 검사하여 각 JAR 파일이 둘 이상 유형의 배치 디스크립터를 포함하지 않는지 확인하십시오. JAR 파일에 둘 이상 유형의 배치 디스크립터가 포함된 경우, 다음 단계로 진행한 후 불필요한 배치 디스크립터를 제거하십시오. 따라서 JAR 파일에 ejb-jar.xmlapplication-client.xml 파일이 모두 있는 경우, 모듈이 필요하지 않은 배치 디스크립터를 제거하십시오.

  2. 필요에 따라 배치 디스크립터를 변경하십시오.

    배치 디스크립터 파일은 수동으로 편집할 수 있습니다. 그러나 배치 디스크립터에 유효한 특성이 있고 해당 참조에 적당한 값이 포함되어 있는지를 확인하기 위해 콘솔 또는 어셈블리 도구 배치 디스크립터 편집기를 사용하여 배치 디스크립터를 편집하는 것이 좋습니다.

Java EE 5 이상의 모듈에 metadata-complete 속성이 없거나 metadata-complete 속성이 false로 설정된 경우 어노테이션의 배치 정보를 포함하여 전체 모듈 배치 디스크립터를 XML 형식으로 작성하도록 제품에 지시할 수 있습니다. 모듈의 메타데이터 페이지에서 메타데이터 완료 속성을 선택하십시오.

문제점 방지 문제점 방지: Java EE 5 이상의 애플리케이션이 어노테이션 및 공유 라이브러리를 사용하는 경우, 메타데이터 완료 속성을 선택하지 마십시오. 애플리케이션에서 어노테이션 및 공유 라이브러리를 사용하는 경우 metadata-complete 속성을 true로 설정하면 제품에서 배치 디스크립터의 @EJB 어노테이션이 <ejb-local-ref>가 아니라 <ejb-ref>로 잘못 표시됩니다. 웹 모듈의 경우, metadata-complete 속성을 true로 설정하면 InjectionException 오류가 발생할 수 있습니다. metadata-complete 속성을 true로 설정해야 하는 경우 공유 라이브러리를 사용하지 않거나, 공유 라이브러리를 Application Server의 classes 또는 lib 디렉토리에 두거나, 배치 디스크립터에 메타데이터를 완전히 지정하여 오류가 발생하지 않도록 하십시오.gotcha

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



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