애플리케이션 전개 문제점

애플리케이션 전개, 설치 또는 승격 시 문제점이 발생할 수 있습니다. 이 주제에서는 문제점을 해결하는 방법을 제안합니다.

발생하는 오류의 종류

먼저 다음 사항을 확인하십시오.
  • 애플리케이션, 엔터프라이즈 Bean 모듈 또는 기타 자원에 대한 콘솔에 나타나도록 지정한 논리 이름이 유효하지 않은 문자(- / \ : * ?)를 포함하지 않는지 확인하십시오. " < > |.
  • wsadmin $AdminApp install 명령에 -local 플래그를 사용하여 애플리케이션을 설치한 경우 서버를 다시 시작하거나 -local 플래그 없이 명령을 다시 실행하십시오.

유사한 문제점이 없거나 제공된 정보로 문제점을 해결할 수 없는 경우, 해당 문제점을 정확하게 파악하고 설명했는지 확인하십시오.

힌트와 팁, 기술 노트 및 수정사항이 포함된 사용 가능한 온라인 지원을 참조하십시오. 문제점을 식별할 수 없으면 IBM의 문제점 해결 도움말의 내용을 참조하십시오.

애플리케이션이 표시되지 않음

wsadmin 도구를 사용하여 애플리케이션이 설치되었지만 이 애플리케이션이 애플리케이션 > 애플리케이션 유형 > WebSphere 엔터프라이즈 애플리케이션 아래 표시되지 않습니다.

애플리케이션이 설치될 수 있지만 구성을 저장하지 않았습니다.
  1. 애플리케이션 하위 디렉토리가 app_server_root/installedApps 디렉토리에 있는지 확인하십시오.
  2. $AdminApp list 명령을 실행하고 애플리케이션이 이 목록에 표시되지 않는지 확인합니다.
    • bin 디렉토리에서 wsadmin.bat 또는 wsadmin.sh 명령을 실행합니다.
    • wsadmin 프롬프트에서 $AdminApp list를 입력하고 문제의 애플리케이션이 이 항목에 표시되지 않는지 확인합니다.
  3. wsadmin 도구를 사용하여 애플리케이션을 다시 설치합니다. 종료하기 전에 wsadmin 도구에서 $AdminConfig save 명령을 실행하십시오.

전개된 애플리케이션을 저장할 수 없습니다.

전개된 애플리케이션을 저장할 수 없으면 열린 파일 수가 너무 많아 운영 체제 한계를 초과하는 문제점이 발생할 수 있습니다.

[Linux]SuSE9 또는 기타 Linux 플랫폼에서는 열 수 있는 파일 개수를 늘려 문제점을 해결하거나, 규정에 따라 파일을 닫도록 애플리케이션을 수정할 수 있습니다. 동시에 열 수 있는 파일의 수를 늘리려면, 여러 개의 파일을 열어야 하는 프로세스를 호출하기 전에 쉘에서 다음 명령을 실행하십시오.
ulimit -n number_of_files

루트만이 각 프로세스의 최대 파일 수를 조정할 권한이 있습니다. 규정에 따라 파일을 닫도록 애플리케이션을 수정하려면 다음 단계를 완료하십시오.

  1. 파일을 연 후 작업을 완료했으면, 파일의 닫기 메소드를 호출하여 파일 핸들을 운영 체제로 다시 해제하십시오.
  2. 예제에서와 같이 java.io.FileInputStream 및 FileOutputStream 클래스를 사용할 경우, 닫기 메소드를 호출하여 스트림에 연관된 모든 시스템 자원을 해제할 수 있습니다.
[Windows]

java.lang.RuntimeException: 어셈블리 도구, 관리 콘솔 또는 wsadmin 도구에서 Failed_saving_bytes_to_wor_ERROR_ 오류

어셈블리 도구에서 배치된 코드를 생성하거나 관리 콘솔에서 애플리케이션 또는 모듈을 설치하거나 wsadmin 도구를 사용하여 애플리케이션 또는 모듈을 설치하려고 할 때 이 오류가 나타나는 경우, 임시 시스템 파일의 파일 경로 길이를 초과했을 수 있습니다.

이 문제점을 확인하려면 시스템에서 TEMPTMP 환경 변수를 확인하십시오. 긴 환경 변수는 EJB 배치 도구로 액세스된 파일 이름에 경로 길이를 추가합니다.

문제점을 해결하려면 다음을 수행하십시오.
  1. WebSphere Application Server 프로세스를 모두 중지하고 DOS 프롬프트를 모두 닫으십시오.
  2. TEMPTMP 환경 변수를 짧은 것으로(예: C:\TMPC:\TEMP) 설정하십시오.
  3. 애플리케이션을 다시 설치하십시오.
그렇지 않으면 애플리케이션을 재부팅 및 재전개 또는 재설치해 보십시오.

WASX7015E 명령 $AdminApp installInteractive 또는 $AdminApp install 실행 중 오류

이 문제점의 가능한 원인은 두 가지입니다.

  • 전체 오류 텍스트가 다음과 유사한 경우:
    [AIX][HP-UX][Linux][Solaris][Windows][IBM i]
    WASX7015E: Exception running command: 
    "$AdminApp installInteractive C:/Documents and Settings/
      myUserName/Desktop/MyApp/myapp.ear";
    exception information:  
    com.ibm.bsf.BSFException: error while 
    evaluating Jacl expression: can't find method "installInteractive" 
    with 3 argument(s) for class 
    "com.ibm.ws.scripting.AdminAppClient" 
    [z/OS]
    WASX7015E: Exception running command: 
    "$AdminApp installInteractive Documents and Settings/
      myUserName/Desktop/MyApp/myapp.ear"; exception information:  
    com.ibm.bsf.BSFException: error while 
    evaluating Jacl expression: can't find method "installInteractive" 
    with 3 argument(s) for class 
    "com.ibm.ws.scripting.AdminAppClient" 
    파일 및 경로 이름이 올바르지 않게 지정되었습니다. 이 경우 경로에 공백이 들어 있으므로 경로가 wsadmin 프로그램에 의해 다중 매개변수로 해석되었습니다.

    .ear 파일 경로를 올바르게 입력하십시오. 이 경우, 큰따옴표로 닫으십시오.

    [AIX Solaris HP-UX Linux Windows][IBM i]
    $AdminApp installInteractive "C:\Documents 
    and Settings\myUserName\Desktop\MyApps\myapp.ear"
    [z/OS]
    $AdminApp installInteractive 
    "Documents and Settings/myUserName/Desktop/MyApps/myapp.ear"
  • 전체 오류 텍스트가 다음과 유사한 경우:
    [AIX Solaris HP-UX Linux Windows][IBM i]
    WASX7015E: Exception running command: "$AdminApp installInteractive c:\MyApps\myapp.ear "; 
    exception information: com.ibm.ws.scripting.ScriptingException:  WASX7115E: 
    Cannot read input file 
    "c:\WebSphere\AppServer\bin\MyAppsmyapp.ear"
    [z/OS]
    WASX7015E: Exception running command: "$AdminApp installInteractive 
    MyApps\myapp.ear "; 
    exception information: com.ibm.ws.scripting.ScriptingException:  WASX7115E: 
    Cannot read input file 
    "WebSphere\AppServer\bin\MyAppsmyapp.ear"
    애플리케이션 경로가 올바르지 않게 지정되었습니다. 이 경우, 경로에 "정방향 슬래시"(/) 분리자를 사용해야 합니다.

EJB 3.0 모듈의 CMP 또는 BMP 엔티티 Bean을 설치할 수 없음

CMP(Container-Managed Persistence) 및 BMP(Bean-Managed Persistence) 엔티티 Bean이 포함된 EJB 3.0 모듈을 설치하면 설치가 실패합니다.

애플리케이션의 CMP 또는 BMP 엔티티 Bean이 EJB 3.0 모듈에 패키징된 경우 애플리케이션 설치가 지원되지 않습니다. CMP 또는 BMP 엔티티 Bean은 EJB 2.1 이하의 모듈에 패키징해야 합니다.

이러한 문제점을 해결하려면 다음을 수행하십시오.
  1. CMP 또는 BMP 엔티티 Bean을 EJB 2.1 이하의 모듈에 패키징하십시오.
  2. EJB 2.1 이하 모듈에 포함된 애플리케이션을 설치해 보십시오.

어셈블리 도구에 의해 생성된 데이터 정의 언어(DDL)가 대상 플랫폼에서 SQL 오류를 일으킵니다.

어셈블리 도구에서 생성한 DDL(데이터 정의 언어) 문을 다른 플랫폼에서 실행하려고 할 때(예를 들어, Windows에서 설계된 CMP(Container-Managed Persistence) 엔터프라이즈 Bean을 UNIX 운영 체제 서버에 배치할 때) SQL 오류가 수신되면, 다음 조치를 수행해 보십시오.
  • 특정 사용자 ID와 비밀번호의 종속성에 대한 DDL 문을 찾아보고 필요에 따라 정정하십시오.
  • 특정 서버 이름의 종속성에 대한 DDL 문을 찾아보고 필요에 따라 정정하십시오.
  • 특정 SQL 오류에 관한 원인과 제안된 조치에 대해서는 벤더의 메시지 참조사항을 참조하십시오. IBM DB2®에서 온라인으로 메시지 참조를 볼 수 있습니다.
Windows, AIX® 또는 Linux 등의 운영 체제에서 작성된 DDL 파일을 실행한 후에 다음과 같은 오류가 수신되는 경우, 파일 형식이 달라서 문제가 발생한 것일 수 있습니다.
SQL0104N  An unexpected token "CREATE TABLE AGENT  (COMM DOUBLE,  PERCENT  DOUBLE,  P" 
was found following "        ". Expected tokens may include:  " ".
SQLSTATE=42601
이러한 문제점을 해결하려면 다음을 수행하십시오.
  • [AIX][HP-UX][Solaris][Windows][z/OS]vi 편집기에서 DDL을 편집하여 각 행의 시작부분에서 Ctl-M 문자를 제거하십시오.
  • [Linux]Linux 플랫폼에서 애플리케이션 EAR 파일에 대한 배치 코드를 재생성하십시오.
  • [IBM i]EDTF를 사용하여 파일을 편집하십시오.

ADMA0004E: 유효성 검증에 실패함

관리 콘솔 또는 wsadmin 명령 프롬프트를 통해 애플리케이션을 설치하려 할 때, 다음 오류가 있는 경우
AppDeploymentException: [ADMA0014E: Validation failed.
ADMA0004E: Validation error in task Specifying the Default Datasource for 
EJB Modules  JNDI name is not 
specified for module beannameBean Jar with URI filename.jar,META-INF/ejb-jar.xml. You have not specified the 
data source for each CMP bean belonging to this module. 
Either specify the data 
source for each CMP beans or 
specify the default data source for the entire module.] 
한 가지 가능한 원인은 WebSphere Application Server 버전 4.0에서는 각 JAR에 포함된 모든 CMP Bean의 데이터 소스를 정의하는 것이 필수였지만, 버전 5.0 이상에서는 CMP(Container-Managed Persistence) Bean에 대한 데이터 소스를 지정하거나, JAR 파일의 모든 CMP Bean에 대해 기본 데이터 소스를 지정할 수 있기 때문일 수 있습니다. 따라서 설치 상호작용 중에(예: 관리 콘솔의 설치 마법사) 데이터 소스 필드는 선택사항이지만 하나 이상의 데이터 소스가 지정되었는지 확인하기 위한 유효성 검증이 설치 점검 끝에 수행되었습니다.

이 문제점을 정정하려면, 설치 단계를 다시 수행하고 기본 데이터 소스 또는 각 CMP 유형 엔터프라이즈 Bean에 대한 데이터 소스를 지정하십시오.

wsadmin 도구를 사용 중인 경우 $AdminApp installInteractive filename 명령을 사용하여 설치 중 데이터 소스에 대한 프롬프트를 수신하거나 응답 파일에 제공하십시오.

[AIX Solaris HP-UX Linux Windows][IBM i]$AdminApp install 명령에 대한 옵션으로 데이터 소스를 지정하십시오.

구문에 대한 세부사항은 wsadmin 스크립트를 사용하여 엔터프라이즈 애플리케이션 설치의 내용을 참조하십시오.

아카이브 파일의 자원 WEB-INF/ibm-web-bnd.xmi를 로드할 수 없음

WebSphere Application Server 버전 5.0 및 5.1 버전에서는 웹 애플리케이션 tmp.war을 설치할 수 있지만, WebSphere Application Server 버전 6.0 이상의 서버에서는 설치에 실패합니다. WEB-INF/ibm-web-bnd.xmi 파일에 기본 WCCM 모델이 더 이상 인식하지 못하는 xmi 태그가 포함되어 있기 때문에 애플리케이션 설치에 실패합니다.

다음 오류 메시지가 표시됩니다.

IWAE0007E Could not load resource "WEB-INF/ibm-web-bnd.xmi" in archive "tmp.war"
[2/24/05 14:53:10:297 CST] 000000bc SystemErr     R
AppDeploymentException:
com.ibm.etools.j2ee.commonarchivecore.exception.ResourceLoadException:
IWAE0007E Could not load resource "WEB-INF/ibm-web-bnd.xmi" in archive "tmp.war"
[2/24/05 14:53:10:297 CST] 000000bc SystemErr     R
com.ibm.etools.j2ee.commonarchivecore.exception.ResourceLoadException:
IWAE0007E Could not load resource "WEB-INF/ibm-web-bnd.xmi" in archive "tmp.war"
!Stack_trace_of_nested_exce!
com.ibm.etools.j2ee.exception.WrappedRuntimeException: Exception occurred loading
WEB-INF/ibm-web-bnd.xmi
!Stack_trace_of_nested_exce!

이러한 문제점을 해결하려면 ibm-web-bnd.xmi 파일에서 xmi:type=EJBLocalRef 태그를 제거하십시오. 이전에 상호 문서 참조 유형을 일치시킬 때 태그를 사용했기 때문에 태그를 제거해도 애플리케이션에는 영향을 미치지 않습니다. 이제 애플리케이션이 WebSphere Application Server 5.1 이상 버전에서도 작동합니다.

지원된 구성 지원된 구성: 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

설치 시 module_name 모듈에 대한 ObjectName anObject에서 유효한 대상이 지정되지 않음

이 오류는 애플리케이션을 설치할 대상 셀, 노드, 서버 또는 클러스터를 올바르게 지정하지 않은 경우 클러스터 환경에서 발생할 수 있습니다. 예를 들어, 대상 철자가 틀린 경우 발생할 수 있습니다.

이 문제점을 정정하려면 실제 WebSphere Application Server 토폴로지에 대한 대상 이름을 확인하고 올바르게 입력하십시오.

addNode -includeapps 옵션이 모든 애플리케이션을 배치 관리자로 업로드하도록 표시되지 않았습니다.

이 오류는 대상 노드의 모든 애플리케이션이 이미 배치 관리자로 업로드된 경우 발생할 수 있습니다. addNode 프로그램이 이미 설치되었고 다시 업로드하지 않은 애플리케이션을 발견합니다.

관리 콘솔을 사용하여 배치 관리자 구성을 찾아보고 이미 설치된 애플리케이션을 점검하십시오.

관리 콘솔에서 엔터프라이즈 애플리케이션을 설치하려고 시도할 때 "제한시간!!!"오류가 표시됨

이 오류는 배치되지 않은 엔터프라이즈 애플리케이션을 설치하려 하는 경우 발생할 수 있습니다.

이러한 문제점을 정정하려면 다음을 수행하십시오.
  • 어셈블리 도구에서 file_name.ear 파일을 연 후 배치를 클릭하십시오. 이 조치에서 Deployed_file_name.ear이라는 이름의 파일이 작성됩니다.
  • 관리 콘솔에서 배치된 EAR 파일을 설치하십시오.

EJB 모듈을 포함하는 애플리케이션 배치 시 NameNotFoundException 메시지

애플리케이션 설치 도중 EJB 전개 도구가 실행되도록 지정하고 설치가 NameNotFoundException 메시지와 함께 실패한 경우, 입력 JAR 또는 EAR 파일에 소스 파일이 없는지 확인하십시오. 입력 JAR 또는 EAR 파일에 소스 파일이 있을 경우, EJB 전개 도구는 전개 코드를 생성하기 전에 재빌드를 실행합니다.

이러한 문제점을 해결하려면, 소스 파일을 제거하거나 클래스 경로에 모든 독립 클래스 및 소스 파일을 포함시키십시오. 그렇지 않으면, 서버에 애플리케이션을 재빌드하는 동안 소스 파일 또는 자원 파일 및 독립 클래스로의 액세스 권한 부족으로 인해 문제점이 발생합니다.

[Windows]

애플리케이션 설치 중, EJB 전개 호출에서 예외가 발생합니다.

애플리케이션 설치 중 EJB 전개 도구가 실행되도록 지정했는데 명령행이 너무 긴 오류로 설치에 실패할 경우, 문제점은 설치 중 생성된 전개 명령이 Windows 플랫폼에서 명령행에 대한 문자 한계를 초과한 것입니다.

이 문제점을 해결하려면, EAR 파일 이름 길이를 줄이거나, EAR 파일 내에서 JAR 파일 이름 길이를 줄이거나, 전개에 지정한 클래스 경로 또는 기타 옵션을 줄이거나, 경로가 짧아지도록 Windows 시스템의 %TEMP% 위치를 변경하면 됩니다.

버전 5.x 이전에 대해 생성된 EJB JAR 파일 설치 시 컴파일 오류가 나타나고 EJB 배치가 실패합니다.

WebSphere Application Server 버전 5.x 이전에서 실행하기 위해 빌드된 EJB 모듈을 사용하는 이전 애플리케이션을 설치 중일 경우, 컴파일 오류가 나타나고 EJB 배치에 실패합니다. EJB JAR 파일에는 이전에 생성된 코드에 대한 Java 소스가 포함되어 있습니다. 이전의 Java 소스는 버전 5.x 이전 버전에 맞게 생성되었으나, 이 소스를 WebSphere Application Server 버전 6.x 이상 제품에 배치하면 버전 6.0 이상의 런타임 JAR 파일을 사용하여 컴파일됩니다.

이 문제점을 해결하려면 애플리케이션 EAR 파일에서 모든 .java 파일을 제거하십시오. Java 소스 파일이 제거된 후, 서버에 애플리케이션을 전개할 수 있습니다.

문서를 업로드하는 동안 addNode -includeapps가 OutOfMemoryError 예외로 실패

크기가 큰 EAR 파일로 애플리케이션을 설치하는 동안 addNode -includeapps를 사용하는 경우 이 오류가 발생할 수 있습니다. 이러한 문제점을 정정하려면 다음을 수행하십시오.
  • addNode를 사용하여 기본 서버에서 노드를 추가 중인 경우, 다음 매개변수를 포함하도록 addNode 스크립트를 수정하십시오.
    -Xmxsize
  • 관리 콘솔에서 노드를 추가 중인 경우, 배치 관리자의 JVM(Java Virtual Machine) 설정에서 maximumHeapSize를 늘린 후 배치 관리자를 다시 시작하십시오.

    세부사항은 addNode 명령JVM(Java Virtual Machine) 설정의 내용을 참조하십시오.

[Windows]예를 들어, 다음 addNode.bat 파일은 Windows 플랫폼에서 최대 힙 크기를 512MB로 설정합니다.
"%JAVA_HOME%\bin\java" -Xmx512m %DEBUG% %WAS_TRACE% %CONSOLE_ENCODING% 
"%CLIENTSOAP%" "%CLIENTSAS%" "-classpath" "%WAS_CLASSPATH%" 
"-Dws.ext.dirs=%WAS_EXT_DIRS%" %USER_INSTALL_PROP% 
-Dwas.install.root=%WAS_HOME%" "com.ibm.ws.bootstrap.WSLauncher" 
"com.ibm.ws.management.tools.NodeFederationUtility" "%CONFIG_ROOT%" "%WAS_CELL%"
"%WAS_NODE%" %*

배치 관리자에서의 OutOfMemory 예외

대용량 EAR 파일로 애플리케이션을 설치할 때 OutOfMemory 예외를 수신한 경우 배치 관리자의 최대 힙 크기를 증가시키십시오.

관리 콘솔의 JVM(Java Virtual Machine) 페이지에 지정한 옵션을 확인하십시오. 배치 관리자의 JVM(Java Virtual Machine) 설정에서 maximumHeapSize를 늘리십시오. 그런 다음, 배치 관리자를 다시 시작한 후 애플리케이션 설치를 다시 시도하십시오.

애플리케이션을 다른 시스템에 설치한 후 애플리케이션이 실행되지 않음

애플리케이션이 애플리케이션 레벨 자원을 사용하는 경우 애플리케이션이 예상대로 실행되려면 해당 애플리케이션 레벨 노드 정보가 정확해야 합니다.

애플리케이션 레벨 자원을 애플리케이션에 추가하고 해당 애플리케이션을 시스템에 전개할 때 애플리케이션 레벨 노드 정보가 정확한지 확인하십시오. 그렇지 않은 경우 애플리케이션을 다른 시스템에 설치하면 애플리케이션이 잘못된 위치에 설치되어 예상대로 실행되지 않습니다.

어셈블리 도구를 사용하여 애플리케이션 레벨 노드 정보를 업데이트할 수 있습니다. ibmconfig에 있는 deployment.xml 파일의 deploymentTargets에서 nodeName을 업데이트하십시오. 또한 deployment.xml 파일의 deployedObject에서 binariesURL의 경로가 정확한지 확인하십시오.

애플리케이션 업데이트 중에 단일 파일이 애플리케이션 파일을 모두 바꿈

애플리케이션 업데이트 마법사의 단일 파일 바꾸기 또는 추가 옵션을 선택하고 현재 배치된 애플리케이션의 여러 파일로 구성된 경우, 바꾸기 또는 추가할 파일에 설치된 애플리케이션 아카이브 파일로 시작하는 경로 지정에 바꾸기 또는 추가할 파일의 전체 경로 이름을 지정하십시오.

전체 경로 이름의 구조는 일반적으로 directory_path/file_name이며 다음과 같습니다.

PriceChangeSession.jar/priceChangeSession/priceChangeSessionBean.class

바꾸기 또는 추가될 파일에 설치된 애플리케이션 아카이브 파일로 시작하는 경로 지정에 지정하는 경로 이름을 전체 경로 이름보다 짧게 지정하지 마십시오. 예를 들어, 다음과 같이 디렉토리 경로만 지정하지 마십시오.

PriceChangeSession.jar/priceChangeSession

전체 경로 이름보다 짧게 지정하는 경우 현재 배치된 애플리케이션의 디렉토리에 있는 모든 파일이 파일 경로 지정에 지정된 새 단일 파일로 대체될 수 있습니다.


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



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