마이그레이션 문제점 해결

WebSphere® Application Server 의 이전 버전에서 마이그레이션하는 과정에서 문제가 발생할 수 있습니다.

• WebSphere Application Server 의 이전 버전에서 9.0 버전으로 마이그레이션하는 과정에서 문제가 발생하면, 로그 파일과 기타 관련 정보를 확인해 보십시오.
  1. 다음 로그 파일에서 단서를 찾아보십시오.
     • migration_backup_dir/logs/WASPreUpgrade.time_stamp.log
     • migration_backup_dir/logs/WASPostUpgrade.time_stamp.log
     • app_server_root/logs/clientupgrade.time_stamp.log

     이 로그 파일 참조가 syncNode 명령이나 wsadmin 명령과 같은 명령을 추가로 지원하는 경우, 이들 명령에 대한 추가 추적과 로그 파일은 다음 샘플 위치에서 찾을 수 있습니다.

     • migration_backup_dir/logs/backupConfig.log
     • migration_backup_dir/logs/wsadmin/applications/app_a.ear.log
     • migration_backup_dir/logs/wsadmin/applications/app_a.ear.trace

     ‘속성을 통해 마이그레이션 정의하기’ 섹션에 설명된 대로, 마이그레이션 속성 파일에서 이러한 추적 및 로그 파일이 생성될 위치를 지정할 수 있습니다.

     주의: 마이그레이션 과정에서 두 버전에 모두 존재하는 구성 요소의 값은 기존 버전에서 대상 버전으로 이전됩니다. 그러나 이전 버전에서의 값이 대상 버전에서 문제를 발생시키는 것으로 알려진 경우에는 이 문제를 방지하도록 해당 요소 값이 조정됩니다. 작성된 각 값 조정의 경우, 설정이 변경되는 내용 및 마이그레이션 로그로 실행된 이유를 표시하는 메시지입니다.
  2. 찾기MIGR0259I: The migration has successfully completed또는MIGR0271W: The migration completed with warnings로그 파일 중 하나에.
     • migration_backup_dir/logs/WASPreUpgrade.time_stamp.log
     • migration_backup_dir/logs/WASPostUpgrade.time_stamp.log
     • app_server_root/logs/clientupgrade.time_stamp.log

     명령 레벨MIGR0286E: The migration failed to complete가 표시되면 로그 파일에 나타나는 오류 메시지에 따라 문제점을 정정하십시오. 오류를 정정한 후, 제품 설치 루트의 bin 디렉토리에서 명령을 다시 실행하십시오.

  3. 액세스를 시도하는 자원을 호스팅하는 서버의 서비스 로그를 열고 오류 및 경고 메시지를 찾아보십시오.
  4. WebSphere Application Server 가 실행 중일 때, 명령어를 dumpNameSpace 실행하고 출력을 파이프(pipe), 리디렉션(redirect) 또는 more 명령어로 처리하여 쉽게 확인할 수 있도록 하세요.

     이 명령을 실행하면 WebSphere Application Server 네임스페이스 내의 모든 개체가 디렉터리 경로와 개체 이름과 함께 표시됩니다.

  5. 클라이언트가 액세스해야 하는 오브젝트가 나타나지 않는 경우, 관리 콘솔을 사용하여 다음 조건을 확인하십시오.
     • 대상 자원을 호스팅하는 서버가 시작됩니다.
     • 대상 자원을 호스팅하는 웹 모듈이나 엔터프라이즈 bean 컨테이너가 실행 중입니다.
     • 대상 자원의 JNDI 이름이 올바르게 지정되었습니다.
  6. 마이그레이션 도구에서 추적 데이터를 분석하거나 데이터를 분석하기 위한 적절한 조직으로 전달하십시오.
     WASPreUpgrade 명령 또는 WASPostUpgrade 명령을 사용할 때 다음의 추적 매개변수를 지정할 수 있습니다.

     -traceString

     이 매개변수는 선택사항입니다. trace_spec 값은 수집하려는 추적 정보를 지정합니다.

     • "*=all=enabled"(따옴표 포함)를 지정하여 모든 추적 정보를 지정하십시오.

       이 구성은 큰 추적 파일을 생성합니다. 예를 들어, WASPostUpgrade 명령에 대해 1GB를 초과할 수 있습니다.

     • "Migration.*=all"을 지정하여 마이그레이션 정보만 수집합니다.
     • "Migration.Flow=all:Migration.*=finer"를 지정하여 대부분의 마이그레이션 정보를 수집합니다.
     • "Migration.Flow=finer:Migration.*=fine"을 지정하여 지원팀에서 필요한 최소 마이그레이션 데이터를 수집합니다.

       이 구성은 기본값입니다.

     -traceFile

     이 매개변수는 선택사항입니다. file_name 값은 추적 정보의 출력 파일 이름을 지정합니다.

     -traceString 또는 -traceFile 매개변수를 지정하지 않으면 명령이 기본적으로 추적 파일을 작성하여 backup_directory/logs 디렉토리에 둡니다.

  IBM® 지원팀에서 제공하는 알려진 문제 및 해결 방법에 대한 최신 정보는 IBM 지원 페이지를 참조하십시오. IBM 또한 지원 센터에는 이 문제를 해결하는 데 필요한 정보를 수집하는 데 드는 시간을 절약해 줄 수 있는 문서들이 준비되어 있습니다. PMR을 등록하기 전에 IBM 지원 페이지를 읽어보시기 바랍니다.

• 마이그레이션 과정에서 도구 WASPreUpgrade 또는 도구를 WASPostUpgrade 사용하는 중에 문제가 발생할 수 있습니다.
  • 문제점은 WASPreUpgrade 도구를 사용할 때 발생할 수 있습니다.
    • ANot found또는No such file or directory메시지가 반환됩니다.

      app_server_root\bin이 문제는 Version 9.0 디렉터리 이외의 다른 디렉터리에서 해당 WASPreUpgrade 도구를 실행하려고 할 때 발생할 수 있습니다. 스크립트가 WASPreUpgrade Version 9.0app_server_root\bin 디렉터리에 있는지 확인한 후, 해당 위치에서 파일을 실행하십시오.

    • 관리 콘솔의 지원되는 JDBC 공급자 드롭다운 목록에서 DB2® JDBC 드라이버와 Db2 JDBC 드라이버( XA )를 찾을 수 없습니다.

      더 이상 사용되지 않는 JDBC 제공자 이름이 관리 콘솔에 표시되지 않습니다. 관리 콘솔에서 사용되는 새 JDBC 제공자 이름은 더 기술적이며 명확합니다. 새 제공자는 더 이상 사용되지 않는 제공자와 이름만 다릅니다.

      더 이상 사용되지 않은 이름은 마이그레이션 이유로 jdbc-resource-provider-templates.xml 파일에 계속 존재합니다(예를 들어 기존 JACL 스크립트). 그러나 JACL 스크립트에서 새 JDBC 제공자 이름을 사용하도록 권장합니다.

    • 다음 메시지를 수신합니다.

      MIGR0108E: The specified WebSphere directory does not contain a WebSphere version that can be upgraded.

      이 오류에 대해 가능한 이유는 다음과 같습니다.

      • WebSphere Application Server 버전 7.0 이상이 설치된 경우, 버전 9.0 설치 루트 디렉터리의 bin 도구를 WASPreUpgrade 실행하지 않았을 수 있습니다.
        1. 도구가 WASPreUpgrade 실행되면 다음과 같은 메시지가 표시되는지 확인하세요:IBM WebSphere Application Server, Release 6.x.

           이 메시지는 현재 WebSphere Application Server 버전 7.0 이상 Migration Utility 을 실행 중이며, 버전 9.0 Migration Utility 은 실행 중이 아님을 나타냅니다.

        2. 환경 변수 경로를 수정하거나 현재 디렉터리를 변경하여 Version 9.0WASPreUpgrade 도구를 실행할 수 있도록 하십시오.
      • 유효하지 않은 디렉토리가 WASPreUpgrade 도구를 실행할 때 지정되었습니다.
    • WASPreUpgrade 도구는 이전 환경을 백업하지 않고 종료할 수 있습니다.
      도구는 다음 예제와 같이 실행되었을 수 있습니다.

      MIGR0201I: The migration function initialized log file WASPreUpgrade.log. 
      MIGR0300I: The migration function is starting to save the existing Application Server environment.
      MIGR0302I: The existing files are being saved.
      MIGR0303I: The existing Application Server environment is saved.
      MIGR0420I: The first step of migration completed successfully.

      마이그레이션 추적 파일의 다음 예제와 유사한 메시지를 볼 수도 있습니다.

      [10/9/08 18:26:40:363 CDT] 00000000 Save     1  
      Skipped instance dmgr01 because user root /opt/migration_backup/profiles/dmgr01 does not exist.

      이 WASPreUpgrade 도구는 해당 WASPostUpgrade 도구가 사용할 백업 디렉터리에 대한 경로를 포함하는 파일의 profileList.ser 사본을 생성합니다. 그 후 해당 파일이 어떤 이유로 마이그레이션에서 삭제되지 않은 경우, 나중에 마이그레이션에서 WASPreUpgrade 도구를 실행할 때 실제 경로 대신 이전 경로가 사용됩니다. 이 문제점을 해결하려면, 안전하게 profileList.ser 파일을 삭제하고 WASPreUpgrade 도구를 다시 실행하십시오.

    자세한 내용은 ‘ WASPreUpgrade ’ 명령어를 참조하십시오.

    문제 방지: Version 6.1 연동 노드를 Version 9.0 로 마이그레이션할 때 해당 WASPreUpgrade 명령어가 실패할 수 있습니다. 다음 예제와 유사한 오류가 발생할 수 있습니다.

    [07/16/2011 11:07:10:357 CDT] MIGR0344I: Processing configuration file 
    /opt/WAS61fep/profiles/v6109node74_01/config/cells/ndcell/clusters/Station1EJBCluster
    /resources.xml.
    [07/16/2011 11:07:10:436 CDT] org.eclipse.emf.ecore.resource.Resource$IOWrappedExcept
    ion: Unresolved reference 'DataSource_1310769433958'. 
    (file:/opt/WAS61fep/profiles/v6109node74_01/config/cells/ndcell/clusters/Station1EJBC
    luster/resources.xml, 9, 323)
    java.lang.Exception: org.eclipse.emf.ecore.resource.Resource$IOWrappedException: 
    Unresolved reference 'DataSource_1310769433958'. 
    (file:/opt/WAS61fep/profiles/v6109node74_01/config/cells/ndcell/clusters/Station1EJBC
    luster/resources.xml, 9, 323)
    at com.ibm.wsspi.migration.document.wccm.WCCMDocument.setInputStream(WCCMDocument.ja
    va:162)

    IBM JCC Provider Driver를 사용하는 Db2 데이터베이스가 생성된 WebSphere 버전 6.1 노드 WebSphere 버전 9.0 6.1 관리자와 동기화할 때 이 문제가 발생할 수 있습니다. Version 6.1 노드는 Version 7.0 이상 드라이버 버전을 지원하지 않습니다. 노드 동기화 프로세스는 모든 드라이버 정의를 제거하지 못합니다.

    이 문제점을 해결하려면, 수정할 모든 resources.xml 파일을 백업하십시오. 버전 6.1 노드 에이전트 프로세스를 중지하십시오. WebSphere 버전 6.1 노드 resources.xml 파일을 편집하고 WASPreUpgrade 명령을 실행하기 전에 분리된 resources.jdbc:CMPConnectorFactory 항목을 제거하십시오. 배치 관리자 사본을 편집하지 마십시오.

  • 문제점은 WASPostUpgrade 도구를 사용할 때 발생할 수 있습니다.
    • 연합 노드를 마이그레이션한 후 다음 텍스트에서 강조표시된 예외와 유사한 예외를 WASPostUpgrade 로그에서 볼 수 있습니다.

      MIGR0304I: The previous WebSphere environment is being restored.
      MIGR0367I: Backing up the current Application Server environment.
      CEIMI0006I Starting the migration of Common Event Infrastructure.
      MIGR0486I: The Transports setting in file server.xml is deprecated.
      MIGR0486I: The PMIService:initialSpecLevel setting in file server.xml is deprecated.
      MIGR0486I: The PMIService:initialSpecLevel setting in file server.xml is deprecated.
      MIGR0404W: Do not use the node agent in the old configuration. It has been disabled.
      MIGR0351I: The migration function is attempting to synchronize with the deployment 
                 manager using the SOAP protocol.
      MIGR0241I: Output of syncNode.
      ADMU0116I: Tool information is being logged in file
                 /usr/WAS80/profiles/AppSrv01/logs/syncNode.log
      ADMU0128I: Starting tool with the AppSrv01 profile
      ADMU0401I: Begin syncNode operation for node aaixae15aNode01 with Deployment
                 Manager packppc.rtp.raleigh.ibm.com: 8879
      ADMU0016I: Synchronizing configuration between node and cell.
      AWXJR0006E   The file, /usr/WAS80/java/jre/PdPerm.properties, was not found.
      ArchiveUtil.toLocalURLs
      ArchiveUtil.toLocalURLs
      ArchiveUtil.toLocalURLs
      ADMU0402I: The configuration for node aaixae15aNode01 has been synchronized
                 with Deployment Manager packppc.rtp.raleigh.ibm.com: 8879
      MIGR0352I: The synchronization with the deployment manager is successful.
      CEIMI0007I The Common Event Infrastructure migration is complete.
      MIGR0307I: The restoration of the previous Application Server environment is complete.
      MIGR0271W: Migration completed successfully, with one or more warnings.

      이 예외는 syncNode 조작 중 발생하며 오류로 표시되지만 장애가 발생하지 않습니다. 전체 조치가 완료되고 메시지가 다시 발생하지 않습니다. 마이그레이션된 연합 노드의 서버가 시작된 후, 문제가 되는 파일이 다시 생성됩니다. 이 메시지를 무시할 수 있습니다.
    • 다음과 같은 오류 메시지를 수신할 수 있습니다.

      MIGR0484E: No profiles or instances found with name -profileName wasio2651.
      MIGR0272E: The migration function cannot complete the command.

      이전 및 새 프로파일 이름이 일치해야 합니다. MIGR0484E 메시지의 -profileName 뒤에 값으로 지정된 이름과 일치하는 Version 9.0 프로필을 사용하여 명령을 WASPostUpgrade 다시 실행하십시오.

    • 찾을 수 없음 또는 이 파일이나 디렉토리가 없음 메시지가 리턴됩니다.

      app_server_root\bin이 문제는 Version 9.0 디렉터리 이외의 다른 디렉터리에서 해당 WASPostUpgrade 도구를 실행하려고 할 때 발생할 수 있습니다. 스크립트가 WASPostUpgrade Version 9.0app_server_root\bin 디렉터리에 있는지 확인한 후, 해당 위치에서 파일을 실행하십시오.

    • 다음 메시지를 수신합니다.

      MIGR0102E: Invalid Command Line. MIGR0105E: You must specify the primary node name.

      이 오류의 가장 유력한 원인은 WebSphere Application Server 버전 7.0 이상이 설치되어 있음에도 불구하고, 해당 WASPostUpgrade 도구를 버전 9.0 의 설치 루트 디렉터리에서 bin 실행하지 않았기 때문입니다.

      이 문제를 해결하려면 Version 9.0 설치 루트 디렉터리에서 bin 다음 WASPostUpgrade 명령을 실행하십시오.

    • 셀에 있는 연합 노드를 마이그레이션할 때 다음 오류 메시지가 표시됩니다.

      MIGR0304I: The previous WebSphere environment is being restored.
       com.ibm.websphere.management.exception.RepositoryException:
       com.ibm.websphere.management.exception.ConnectorException: ADMC0009E:
         The system failed to make the SOAP RPC call: invoke
      MIGR0286E: The migration failed to complete.

      연합 노드에 대한 WASPostUpgrade 마이그레이션 단계 동안 연합 노드가 배치 관리자에서 구성 업데이트를 검색할 때 연결 제한시간이 발생합니다. 버전 9.0 로 마이그레이션하는 구성에 다음 요소 중 하나라도 포함되어 있는 경우, 전체 구성을 복사하는 데 연결 시간 제한보다 더 오래 걸릴 수 있습니다:

      • 다수의 소형 애플리케이션
      • 소수의 큰 애플리케이션
      • 한 개의 매우 큰 애플리케이션
      최선의 방법은 제한시간 값을 수정한 후에 WASPostUpgrade 명령을 실행하여 연합 노드를 마이그레이션하는 것입니다.

      1. 연동 노드를 마이그레이션하려는 프로필의 Version 9.0 디렉터리에서 다음 경로로 이동하십시오:

         profile_root/properties 

      2. 이 디렉토리에서 soap.client.props 파일을 열고 com.ibm.SOAP.requestTimeout 특성 값을 찾으십시오. 제한시간 값입니다(초 단위). 기본값은 180초입니다.
      3. com.ibm.SOAP.requestTimeout의 값을 구성 마이그레이션에 충분한 값으로 변경하십시오. 예를 들어, 다음과 같이 입력하면 30분의 제한시간 값이 제공됩니다.

         com.ibm.SOAP.requestTimeout=1800

         참고: 필요에 맞는 가장 짧은 타임아웃 값을 선택하십시오. 선택한 제한시간 값의 최소 세 배는 기다려야 합니다(백업 디렉토리로 파일을 다운로드하는 시간, 이주된 파일을 Deployment Manager로 업로드하는 시간 및 Deployment Manager를 이주 Node Agent와 동기화하는 시간 고려).
      4. WASPreUpgrade 명령으로 작성된 백업 디렉토리의 다음 위치로 이동하십시오.

         backupDirectory/profiles/profile_name/properties

      5. 이 디렉토리에서 soap.client.props 파일을 열고 com.ibm.SOAP.requestTimeout 특성 값을 찾으십시오.
      6. ` com.ibm.SOAP.requestTimeout `의 값을 ` Version. 9.0 ` 파일에서 사용한 값과 동일하게 변경하십시오.
      또는, 다음 조건 중 하나 또는 둘 다 해당되는 경우, 배포 관리자를 버전 9.0 으로 마이그레이션할 때 명령어에서 WASPostUpgrade 를 지정하는 -includeApps script 방안을 고려해 볼 수 있습니다:

      • 셀에 있는 모든 노드를 빨리 마이그레이션하려고 합니다. 그러나 전체 셀이 마이그레이션한 후, 배치 관리자 백업 디렉토리에서 모든 애플리케이션에 대해 수동으로 애플리케이션 설치 스크립트를 설치하려고 하며 구성을 마이그레이션된 모든 노드로 동기화합니다.
      • 설치된 애플리케이션 없이 실행할 수 있습니다.
      다음 단계에 따라 이 대체 프로시저를 수행하십시오.

      1. 배포 관리자를 버전 9.0 으로 마이그레이션할 때 명령어에서 WASPostUpgrade 를 지정하십시오 -includeApps script .
      2. 어떤 애플리케이션도 설치하기 전에 셀 전체를 버전 9.0으로 마이그레이션하십시오.
      3. 각 애플리케이션을 설치하려면 wsadmin 명령을 실행하십시오.
         • 정상 운영 중이거나 적절한 유지보수 시간대에 Version 9.0 구성의 애플리케이션을 설치하십시오.
         • -conntype NONE을 지정하십시오. 예를 들어,

           wsadmin -f application_script -conntype NONE

      4. 구성을 모든 마이그레이션된 노드로 동기화하십시오.

      이 대체 절차에 대한 자세한 내용은 “대량의 애플리케이션이 포함된 대규모 WebSphere Application Server Network Deployment 구성 마이그레이션” 문서를 참조하십시오.
    • 임시 파일로 문서를 복사할 수 없음 오류 메시지를 수신합니다. 예를 들면, 다음과 같습니다.

      MIGR0304I: The previous WebSphere environment is being restored.
      com.ibm.websphere.management.exception.DocumentIOException: Unable to copy document to temp file: 
        cells/sunblade1Network/applications/LARGEApp.ear/LARGEApp.ear

      파일 시스템에 여유 공간이 없을 수 있습니다. 파일 시스템에 여유 공간이 없으면 일부 영역을 지우고 WASPostUpgrade 명령을 다시 실행하십시오.

    • 다음 메시지를 수신합니다.

      MIGR0108E: The specified WebSphere directory does not contain WebSphere version that can be upgraded.

      이 오류에 대해 가능한 이유는 다음과 같습니다.

      • WebSphere Application Server 버전 6.1 이 설치된 경우, 버전 9.0 의 설치 루트 디렉터리에서 bin 해당 WASPostUpgrade 도구를 실행하지 않았을 수 있습니다.
        1. 도구가 WASPostUpgrade 실행되면 다음과 같은 메시지가 표시되는지 확인하세요:IBM WebSphere Application Server, Release 6.1.

           이 메시지는 현재 9.0 Migration Utility 버전이 아닌, 이전 릴리스의 Migration Utility 를 실행 중임을 나타냅니다.

        2. 환경 변수 경로를 수정하거나 현재 디렉터리를 변경하여 Version 9.0WASPostUpgrade 도구를 실행할 수 있도록 하십시오.
      • 유효하지 않은 디렉토리는 WASPreUpgrade 도구 또는 WASPostUpgrade를 실행할 때 지정되었습니다.
      • WASPreUpgrade 도구는 실행되지 않았습니다.
    • 다음과 같은 오류 메시지를 수신합니다.

      MIGR0253E: 백업 디렉토리 migration_backup_directory가 없습니다.

      이 오류에 대해 가능한 이유는 다음과 같습니다.

      • WASPreUpgrade 도구는 WASPostUpgrade 도구 이전에 실행되지 않았습니다.
        1. 오류 메시지에 지정된 백업 디렉토리가 존재하는지 확인하려면 확인하십시오.
        2. 그렇지 않으면, WASPreUpgrade 도구를 실행하십시오.

           자세한 내용은 ` WASPreUpgrade ` 명령어를 참조하십시오.

        3. WASPostUpgrade 도구를 다시 시도하십시오.
      • 유효하지 않은 백업 디렉토리가 지정되었을 수 있습니다.

        예를 들어, 해당 디렉터리는 Version 7.0 또는 이후 버전의 트리 내 하위 디렉터리였을 수 있으며, 이 디렉터리는 WASPreUpgrade 도구를 실행하고 이전 버전의 제품을 제거한 후, 도구를 WASPostUpgrade 다시 실행하기 전에 삭제되었을 수 있습니다.

        1. 오류 메시지에 지정된 전체 디렉토리 구조가 존재하는지 여부를 판별하십시오.
        2. 가능한 경우, WASPreUpgrade 도구를 다시 실행하여 올바른 전체 마이그레이션 백업 디렉토리를 지정하십시오.
        3. 백업 디렉토리가 존재하지 않고 이 디렉토리가 비롯된 이전 버전이 설치 제거된 경우, 백업 저장소나 XML 구성 파일에서 이전 버전을 다시 빌드하십시오.
        4. WASPreUpgrade 도구를 다시 실행하십시오.
    • WASPostUpgrade를 이미 실행한 후 WASPreUpgrade를 다시 실행할 필요가 있다고 결정합니다.

      배치 관리자나 연합 노드 마이그레이션 중, WASPostUpgrade는 이전 환경을 사용 안함으로 설정할 것입니다. 실행 WASPostUpgrade 후 기존 설치 환경에서 를 WASPreUpgrade 다시 실행하려면, 기존 app_server_root/bin 디렉터리에 있는 스크립트를 migrationDisablementReversal.jacl 실행해야 합니다. 이 JACL 스크립트를 실행하면 버전 7.0 이상 환경이 다시 정상 상태로 복구되어, 명령어를 실행했을 WASPreUpgrade 때 올바른 결과를 얻을 수 있습니다.

    • 연합 마이그레이션이 MIGR0405E 메시지와 함께 실패합니다.
      연합 마이그레이션 과정 중 배치 관리자에서 작업된 마이그레이션이 실패한 경우입니다. 이 오류가 발생한 더 자세한 원인을 확인하려면, 배포 관리자 노드에 있는 디렉터리 ...DeploymentManagerProfile/temp 아래의 폴더를 your_node_name_migration_temp 열어보세요. 예를 들어,

      /websphere80/appserver/profiles/dm_profile/temp/nodeX_migration_temp

      배치 관리자 노드에서 이 노드에 대한 마이그레이션과 관련된 로그 및 기타 모든 내용이 이 폴더에 있습니다. 이 폴더는 이 시나리오와 관련된 IBM 지원에도 필요합니다.

    • 9.0 버전의 애플리케이션은 마이그레이션 과정에서 손실됩니다.

      연동 마이그레이션 과정에서 버전 9.0 애플리케이션 중 하나라도 설치에 실패하면, 구성 동기화 시 해당 애플리케이션이 손실됩니다. 이러한 경우가 발생하는 이유는 WASPostUpgrade의 최종 단계 중 하나가 syncNode 명령을 실행하는 것이기 때문입니다. 이렇게 하면 배치 관리자 노드에 구성을 다운로드하고 연합 노드에 이 구성을 겹쳐쓰게 됩니다. 애플리케이션이 설치에 실패하면 배치 관리자 노드에 위치한 구성에 없습니다. 이 문제점을 해결하려면 마이그레이션 후 애플리케이션을 수동으로 설치하십시오. 표준 버전 9.0 애플리케이션인 경우, 해당 애플리케이션은 디렉터리에 app_server_root/installableApps 위치합니다.

      마이그레이션 중 유실된 애플리케이션을 수동으로 설치하려면, wsadmin 명령을 사용하여 마이그레이션 도구가 백업 디렉토리에 작성한 install_application_name.jacl 스크립트를 실행하십시오.

      예를 들어, Linux® 환경에서는 다음 매개변수를 사용하십시오:

      ./wsadmin.sh -f migration_backup_directory/install_application_name.jacl -conntype NONE

      다음 매개변수를 사용하십시오.

      app_server_root/bin/wsadmin -f migration_backup_directory/install_application_name.jacl -conntype NONE

    • 9.0 버전의 애플리케이션이 설치되지 않습니다.

      WASPostUpgrade가 완료된 후 wsadmin 명령을 사용하여 애플리케이션을 수동으로 설치하십시오.

      마이그레이션 중 설치에 실패한 애플리케이션을 수동으로 설치하려면 wsadmin 명령을 사용하여 마이그레이션 도구가 백업 디렉토리에 작성한 install_application_name.jacl 스크립트를 실행하십시오.

      예를 들면, Linux 환경에서 다음 매개변수를 사용하십시오.

      ./wsadmin.sh -f migration_backup_directory/install_application_name.jacl -conntype NONE

      다음 매개변수를 사용하십시오.

      app_server_root/bin/wsadmin -f migration_backup_directory/install_application_name.jacl -conntype NONE

    자세한 내용은 ` WASPostUpgrade ` 명령어를 참조하십시오.

  • 추적 파일이 400MB 할당을 초과하지만 WASPostUpgrade는 여전히 실행 중입니다. 추가 디스크 공간을 사용할 수 없는 경우, 마이그레이션이 실패합니다.
    마이그레이션 중 이 문제점이 발생할 수 있다고 생각하는 경우, 다음 조치를 완료하십시오.

    1. WASPostUpgrade 명령을 실행하기 전에 마이그레이션 마법사를 중지하십시오.
    2. 마이그레이션하려는 각 프로파일에 대해 명령행에서 WASPostUpgrade 명령을 실행하십시오.

       WASPostUpgrade 명령을 명령행에서 실행하는 경우는 다음과 같습니다.

       • -oldProfile 및 -profileName 매개변수를 포함하여 마이그레이션할 프로파일을 표시하십시오.
       • com.ibm.ejs.ras.TraceNLS* 매개변수를 추적 문자열에 추가하여 추적 로그의 크기를 줄이십시오. 예를 들면, 다음 추적 설정을 지정할 수 있습니다.

         com.ibm.ejs.ras.TraceNLS*=info

• 마이그레이션 과정에서 버전 7.0 이상 구성에 포함된 엔터프라이즈 애플리케이션을 새로운 버전 9.0 구성에 설치하도록 옵션을 선택한 경우, 마이그레이션의 애플리케이션 설치 단계에서 오류 메시지가 표시될 수 있습니다.

  7.0 버전 이상 환경에서 실행되는 애플리케이션에는 잘못된 배포 정보가 포함되어 있을 수 있습니다. 일반적으로 이는 이전 버전의 WebSphere Application Server 런타임에서 충분히 유효성 검증을 거치지 않은 잘못된 XML 문서 때문입니다. 현재 런타임에는 향상된 애플리케이션 설치 유효성 검증 프로세스가 있으므로 이러한 잘못된 형식의 EAR 파일을 설치할 수 없게 됩니다. 이렇게 되면 WASPostUpgrade의 애플리케이션 설치 단계 중 실패하여 E 오류 메시지를 생성합니다. 이는 복구 불가능한 마이그레이션 오류입니다.

  이러한 방식으로 애플리케이션 설치 중에 마이그레이션이 실패하는 경우 다음 중 하나를 수행할 수 있습니다.

  • 7.0 버전 이상 애플리케이션의 문제를 해결한 후 다시 마이그레이션하십시오.
  • 마이그레이션을 계속 수행하고 이 오류를 무시하십시오.

    오류를 무시하면 마이그레이션 프로세스는 실패한 애플리케이션을 설치하지 못하지만 나머지 다른 마이그레이션 단계는 완료합니다.

    나중에 애플리케이션의 문제를 해결한 후, 관리 콘솔이나 설치 스크립트를 사용하여 새 버전 9.0 구성에 수동으로 설치할 수 있습니다.

• 배포 관리자를 버전 5.1 에서 마이그레이션된 버전 6.1 구성에서 IBM 버전 9.0 으로 마이그레이션하는 경우, syncNode 해당 명령은 셀 내의 버전 5.1 연합 노드에서 실패할 수 있습니다.
  예를 들어, 버전 5.1 노드에서 syncNode 명령을 실행하면 다음과 유사한 메시지를 볼 수 있습니다.

  bash-3.00# ./syncNode.sh  dmgrhostname 8879 -username 
  MyAdminUser -password MyAdminPassword
  

  ADMU0116I: Tool information is being logged in file
             /usr/WebSphere/AppServer/logs/syncNode.log
  ADMU0401I: Begin syncNode operation for node My511Node 
             with Deployment Manager dmgrhostname: 8879
  ADMU0111E: Program exiting with error:
             com.ibm.websphere.management.exception.
             AdminException: 
  ADMU2092E: The node and Deployment Manager must have 
             the same product extensions, but they do 
             not match.  The node product extension is
             BASE and the Deployment Manager product 
             extension is PME.
  ADMU0211I: Error details may be seen in the file:
             /usr/WebSphere/AppServer/logs/syncNode.log
  ADMU1211I: To obtain a full trace of the failure, use 
            the -trace option. 

• EJB(Enterprise Java™ Beans) 사양( 3.0 )에 ` javax.ejb.Remote ` 어노테이션이 포함됨에 따라, Enterprise Java™ Beans를 작성할 때 ` javax.ejb ` 및 ` java.rmi ` 패키지 전체를 임포트하도록 설정하면 특정 EJB( 2.1 ) 빈의 컴파일이 실패할 수 있습니다.
  다음 예제와 유사한 컴파일 오류가 발생할 수 있습니다.

  ejbModule/com/ibm/websphere/samples/trade/ejb/QuoteHome.java(17): The type Remote is ambiguous

• WebSphere Application Server 버전 6.1 을 설치하고 노드를 버전 9.0 배포 관리자에 연동할 때, 예기치 않은 보안 예외 메시지가 지속적으로 표시될 수 있습니다.
  노드 에이전트의 system.out 로그는 다음 예외를 포함합니다.

  [7/8/08 16:41:31:416 EDT] 0000001c DefaultTokenP E 
  HMGR0149E: An attempt to open a connection to core group 
  DefaultCoreGroup has been rejected. The sending process 
  has a name of wasinst101Cell01\ndrack104Node08\server1 
  and an IP address of /9.42.92.86. Global security in the 
  local process is Enabled. Global security in the sending 
  process is Enabled. The received token starts with 
  x2>W 9 Sv?. The exception is
  com.ibm.websphere.security.auth.WSLoginFailedException: 
  Validation of LTPA token failed due to invalid keys or 
  token type.
  
  at com.ibm.ws.security.ltpa.LTPAServerObject.
  validateToken(LTPAServerObject.java:876)
  at com.ibm.ws.security.token.WSCredentialTokenMapper.
  validateLTPAToken(WSCredentialTokenMapper.java:1178)
  at com.ibm.ws.hamanager.runtime.DefaultTokenProvider.
  authenticateMember(DefaultTokenProvider.java:214)
  at com.ibm.ws.hamanager.coordinator.impl.DCSPluginImpl.
  authenticateMember(DCSPluginImpl.java:723)
  at com.ibm.ws.dcs.vri.transportAdapter.rmmImpl.ptpDiscovery.
  DiscoveryRcv.acceptStream(DiscoveryRcv.java:266)
  at com.ibm.rmm.ptl.tchan.receiver.PacketProcessor.
  fetchStream(PacketProcessor.java:470)
  at com.ibm.rmm.ptl.tchan.receiver.PacketProcessor.
  run(PacketProcessor.java:917)

  배포 관리자는 버전 9.0 을 사용하며, 모든 노드와 별칭 노드는 버전 6.1 을 사용하고 있습니다. 이 문제점을 해결하려면 모든 버전 6.1 노드를 버전 6.1.0.17 이상으로 업그레이드하십시오.

  마이그레이션된 Version 9.0 노드 에이전트에 등록된 새로운 포트에는 다음이 포함됩니다: WC_defaulthost, WC_defaulthost_secure, WC_adminhost, WC_adminhost_secure, SIB_ENDPOINT_ADDRESS, SIB_ENDPOINT_SECURE_ADDRESS, SIB_MQ_ENDPOINT_ADDRESS, SIB_MQ_ENDPOINT_SECURE_ADDRESS. 이 포트는 노드 에이전트에서 필요하지 않으며 안전하게 삭제될 수 있습니다.