마이그레이션 문제점 해결
이전 버전의 WebSphere® Application Server에서 마이그레이션하는 동안 문제점이 발생할 수 있습니다.
시작하기 전에

이 기사는 프로파일 구성 마이그레이션에 대한 기사입니다. 애플리케이션을 최신 버전으로 마이그레이션하려면 WebSphere Application Server 마이그레이션 툴킷을 사용하십시오. 자세한 정보는 WASdev의 마이그레이션 툴킷을 참조하십시오.
sptcfg프로시저
- 구성을 마이그레이션하기 전에 버전 9.0 마이그레이션 마법사를 사용하여
프로파일을 작성하는 동안, 다음 프로파일 작성 오류 메시지를 볼 수 있습니다.
profileName: profileName cannot be empty profilePath: Insufficient disk space
공백과 같은 유효하지 않은 문자가 포함된 프로파일 이름을 입력하면 이러한 오류 메시지가 표시될 수 있습니다. 마이그레이션 마법사를 다시 실행하여 공백, 따옴표(') 또는 다른 특수 문자 등의 유효하지 않은 문자가 프로파일 이름에 포함되지 않는지 확인하십시오.
- WebSphere Application Server의 이전 버전에서
버전 9.0로 마이그레이션하는 중에
문제점이 발생한 경우, 다음과 같이 로그 파일 및 다른 사용 가능한 정보를 확인하십시오.
- 다음 로그 파일에서 단서를 찾아보십시오.
- migration_backup_dir/logs/WASPreUpgrade.time_stamp.log
- migration_backup_dir/logs/WASPostUpgrade.time_stamp.log
- app_server_root/logs/clientupgrade.time_stamp.log
- 로그 파일 중 하나에서 MIGR0259I: 마이그레이션이 완료되었습니다. 또는 MIGR0271W:
마이그레이션이 완료되었으나 경고가 발생했습니다.를 찾으십시오.
- 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: 마이그레이션이 완료되지 않았습니다가 표시되면 로그 파일에 나타나는 오류 메시지에 따라 문제점을 정정해보십시오. 오류를 정정한 후 제품 설치 루트의 bin 디렉토리에서 명령을 다시 실행하십시오.
- 액세스를 시도하는 자원을 호스트하는 서버의 서비스 로그를 열고 오류 및 경고 메시지를 찾아보십시오.
- WebSphere Application Server를 실행하면서,
dumpNameSpace 명령을 실행하고, 출력을 파이프, 경로 재지정 또는
"추가"하면 쉽게 볼 수 있습니다.
이 명령을 실행하면 디렉토리 경로와 오브젝트 이름을 포함한 WebSphere Application Server의 네임스페이스의 모든 오브젝트를 표시합니다.
- 클라이언트가 액세스해야 하는 오브젝트가 나타나지 않는 경우,
관리 콘솔을 사용하여 다음 조건을 확인하십시오.
- 대상 자원을 호스트하는 서버가 시작되었습니다.
- 대상 자원을 호스트하는 웹 모듈이나 엔터프라이즈 Java™ Bean 컨테이너가 실행 중입니다.
- 대상 자원의 JNDI 이름이 올바르게 지정되었습니다.
- 마이그레이션 도구에서 추적 데이터를 분석하거나
데이터를 분석하기 위한 적절한 조직으로 전달하십시오. WASPreUpgrade 명령 또는 WASPostUpgrade 명령을 사용할 때 다음의 추적 매개변수를 지정할 수 있습니다.
- -traceString
- 선택적 매개변수입니다. trace_spec 값은
수집하려는 추적 정보를 지정합니다.
- "*=all=enabled"(따옴표 포함)를
지정하여 모든 추적 정보를 지정하십시오.
이렇게 하면 대용량의 추적 파일이 생성됩니다. 예를 들어, WASPostUpgrade 명령에 1GB를 초과할 수 있습니다.
- "Migration.*=all"을 지정하여 마이그레이션 정보만 수집합니다.
- "Migration.Flow=all:Migration.*=finer"를 지정하여 대부분의 마이그레이션 정보를 수집합니다.
- "Migration.Flow=finer:Migration.*=fine"을 지정하여
지원팀에서 필요한 최소 마이그레이션 데이터를 수집합니다.
기본값입니다.
- "*=all=enabled"(따옴표 포함)를
지정하여 모든 추적 정보를 지정하십시오.
- -traceFile
- 선택적 매개변수입니다. file_name 값은 추적 정보의 출력 파일 이름을 지정합니다.
-traceString 또는 -traceFile 매개변수를 지정하지 않으면 명령이 기본적으로 추적 파일을 작성하여 backup_directory/logs 디렉토리에 둡니다.
알려진 문제점과 해결 방법에 대해 IBM® 지원에서 사용 가능한 현재 정보는 IBM 지원 페이지를 참조하십시오. IBM 지원에는 또한 이 문제점 해결에 필요한 정보 수집 시간을 줄일 수 있는 문서가 있습니다. PMR을 열기 전에 IBM 지원 페이지를 참조하십시오.
- 다음 로그 파일에서 단서를 찾아보십시오.
- 마이그레이션 프로세스에서
WASPreUpgrade 도구 또는 WASPostUpgrade
도구를 사용할 때 문제점이 발생할 수 있습니다.
- 문제점은 WASPreUpgrade 도구를 사용할 때 발생할 수 있습니다.
- 찾을 수 없음 또는 이 파일이나 디렉토리가 없음 메시지가
리턴됩니다.
버전 9.0 app_server_root\bin과 다른 디렉토리에서 WASPreUpgrade 도구를 실행하려는 경우, 이 문제점이 발생할 수 있습니다. WASPreUpgrade 스크립트가 버전 9.0 app_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 도구를 실행하지 않았을 수 있습니다.
- IBM WebSphere
Application Server, 릴리스 6.x 메시지와 같은 메시지를 찾아 WASPreUpgrade 도구가 실행될 때 표시하십시오.
이 메시지는 버전 9.0 마이그레이션 유틸리티가 아닌 WebSphere Application Server 버전 7.0 이상 마이그레이션 유틸리티를 실행 중임을 표시합니다.
- 환경 경로를 변경하거나 현재 디렉토리를 변경하여 버전 9.0 WASPreUpgrade 도구를 시작할 수 있습니다.
- IBM WebSphere
Application Server, 릴리스 6.x 메시지와 같은 메시지를 찾아 WASPreUpgrade 도구가 실행될 때 표시하십시오.
- 유효하지 않은 디렉토리가 WASPreUpgrade 도구를 실행할 때 지정되었습니다.
- WebSphere Application Server 버전 7.0 이상이
설치된 경우 버전 9.0 설치 루트의 bin 디렉토리에서
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 명령의 내용을 읽어보십시오.
문제점 방지: 버전 6.1 연합 노드를 버전 9.0로 마이그레이션하면, WASPreUpgrade 명령이 실패합니다. 다음 예제와 유사한 오류가 발생할 수 있습니다.
IBM JCC Provider Driver를 사용하여 DB2 데이터베이스를 작성할 때 WebSphere 버전 6.1 노드에 이 문제점이 발생할 수 있으며, WebSphere 버전 6.1 노드는 버전 9.0 배치 관리자와 동기화됩니다. 버전 6.1 노드는 버전 7.0 이상 드라이버 레벨을 지원하지 않습니다. 노드 동기화 프로세스는 모든 드라이버 정의를 제거하지 못합니다.[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)
이 문제점을 해결하려면, 수정할 모든 resources.xml 파일을 백업하십시오. 버전 6.1 노드 에이전트 프로세스를 중지하십시오. WebSphere 버전 6.1 노드 resources.xml 파일을 편집하고 WASPreUpgrade 명령을 실행하기 전에 분리된 resources.jdbc:CMPConnectorFactory 항목을 제거하십시오. 배치 관리자 사본을 편집하지 마십시오.
gotcha - 찾을 수 없음 또는 이 파일이나 디렉토리가 없음 메시지가
리턴됩니다.
- 문제점은 WASPostUpgrade 도구를 사용할 때 발생할 수 있습니다.
- 연합 노드를 마이그레이션한 후 다음 텍스트에서 강조표시된 예외와 유사한 예외를 WASPostUpgrade
로그에서 볼 수 있습니다.
이 예외는 syncNode 조작 중 발생하며 오류로 표시되지만 장애가 발생하지 않습니다. 전체 조치가 완료되고 메시지가 다시 발생하지 않습니다. 마이그레이션된 연합 노드의 서버가 시작된 후, 문제가 되는 파일이 다시 생성됩니다. 이 메시지를 무시해도 됩니다.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.
- "찾을 수 없음" 또는 "이 파일이나 디렉토리가 없음" 메시지가
리턴됩니다.
버전 9.0 app_server_root\bin과 다른 디렉토리에서 WASPostUpgrade 도구를 실행하려는 경우, 이 문제점이 발생할 수 있습니다. WASPostUpgrade 스크립트가 버전 9.0 app_server_root\bin 디렉토리에 있는지 확인하고, 해당 위치에서 파일을 실행하십시오.
- 다음 메시지를 수신합니다.
MIGR0102E: Invalid Command Line. MIGR0105E: You must specify the primary node name.
이 오류의 가장 가능성이 높은 원인은 WebSphere Application Server 버전 7.0 이상이 설치되고 WASPostUpgrade 도구가 버전 9.0 설치 루트의 bin 디렉토리에서 실행되지 않은 경우입니다.
이 문제점을 정정하려면, WASPostUpgrade 명령을 버전 9.0 설치 루트의 bin 디렉토리에서 실행하십시오.
- 셀에 있는 연합 노드를 마이그레이션할 때 다음 오류
메시지가 표시됩니다.
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 명령을 실행하여 연합 노드를 마이그레이션하는 것입니다.- 연합 노드를 마이그레이션하고 있는 프로파일을 찾아보려면 버전 9.0 디렉토리의
다음 위치로 이동하십시오.
profile_root/properties
- 이 디렉토리에서 soap.client.props 파일을 열고 com.ibm.SOAP.requestTimeout 특성 값을 찾으십시오. 제한시간 값입니다(초 단위). 기본값은 180초입니다.
- com.ibm.SOAP.requestTimeout의 값을 구성 마이그레이션에 충분한 값으로
변경하십시오. 예를 들어, 다음과 같이 입력하면
30분의 제한시간 값이 제공됩니다.
com.ibm.SOAP.requestTimeout=1800
참고: 필요한 최소한의 제한시간 값을 선택하십시오. 백업 디렉토리에 파일을 다운로드할 때, 마이그레이션된 파일을 배치 관리자에 업로드할 때, 그리고 배치 관리자를 마이그레이션된 노드 에이전트와 동기화할 때 각각 한 번씩 제한시간 동안 기다려야 하므로 선택한 제한시간의 세 배 이상을 기다릴 준비를 하십시오. - WASPreUpgrade 명령으로 작성된 백업 디렉토리의 다음 위치로 이동하십시오.
backupDirectory/profiles/profile_name/properties
- 이 디렉토리에서 soap.client.props 파일을 열고 com.ibm.SOAP.requestTimeout 특성 값을 찾으십시오.
- com.ibm.SOAP.requestTimeout 값을 버전 9.0 파일에 사용된 값과 동일하게 변경하십시오.
또는, 다음 중 하나 또는 모두가 사용자 상황에 해당되는 경우, 배치 관리자를 버전 9.0로 마이그레이션하면 WASPostUpgrade 명령에서 -includeApps script를 지정하는 솔루션을 고려할 수 있습니다.- 셀에 있는 모든 노드를 빨리 마이그레이션하려고 합니다. 그러나 전체 셀을 마이그레이션한 후에는 배치 관리자 백업 디렉토리의 애플리케이션마다 애플리케이션 설치 스크립트를 수동으로 실행하며 구성을 모든 마이그레이션 노드와 동기화합니다.
- 설치된 애플리케이션 없이 실행할 수 있습니다.
다음 단계에 따라 이 대체 프로시저를 수행하십시오.- 배치 관리자를 버전 9.0로 마이그레이션할 때 WASPostUpgrade 명령에서 -includeApps script를 지정하십시오.
- 애플리케이션을 설치하기 전에 전체 셀을 버전 9.0로 마이그레이션하십시오.
- 각 애플리케이션을 설치하려면 wsadmin 명령을 실행하십시오.
- 일반 조작이나 적용 가능한 유지보수 기간 동안에 버전 9.0 구성에 애플리케이션을 설치하십시오.
- -conntype NONE을 지정하십시오. 예를 들면, 다음과 같습니다.
wsadmin -f application_script -conntype NONE
- 구성을 모든 마이그레이션된 노드로 동기화하십시오.
- "임시 파일로 문서를 복사할 수 없음" 오류 메시지를 수신합니다. 예를 들면, 다음과
같습니다.
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이 설치되는 경우, WASPostUpgrade 도구를 버전 9.0 설치 루트의
bin 디렉토리에서 실행하지 않을 수 있습니다.
- IBM WebSphere Application Server, 릴리스 6.1과 같은
메시지를 찾아 WASPostUpgrade 도구가 실행될 때 표시하십시오.
이 메시지는 버전 9.0 마이그레이션 유틸리티가 아닌 이전 릴리스에서 마이그레이션 유틸리티를 실행 중임을 표시합니다.
- 환경 경로를 변경하거나 현재 디렉토리를 변경하여 버전 9.0 WASPostUpgrade 도구를 시작할 수 있습니다.
- IBM WebSphere Application Server, 릴리스 6.1과 같은
메시지를 찾아 WASPostUpgrade 도구가 실행될 때 표시하십시오.
- 유효하지 않은 디렉토리는 WASPreUpgrade 도구 또는 WASPostUpgrade를 실행할 때 지정되었습니다.
- WASPreUpgrade 도구는 실행되지 않았습니다.
- WebSphere Application Server 버전
6.1이 설치되는 경우, WASPostUpgrade 도구를 버전 9.0 설치 루트의
bin 디렉토리에서 실행하지 않을 수 있습니다.
- 다음과 같은 오류 메시지를 수신합니다.
MIGR0253E: The backup directory migration_backup_directory does not exist.
이 오류에 대해 가능한 이유는 다음과 같습니다.- WASPreUpgrade 도구는 WASPostUpgrade 도구 이전에 실행되지 않았습니다.
- 오류 메시지에 지정된 백업 디렉토리가 존재하는지 확인하십시오.
- 그렇지 않으면, WASPreUpgrade 도구를 실행하십시오.
자세한 정보는 WASPreUpgrade 명령의 내용을 읽어보십시오.
- WASPostUpgrade 도구를 다시 시도하십시오.
- 유효하지 않은 백업 디렉토리가 지정되었을 수 있습니다.
예를 들어, 디렉토리는 WASPreUpgrade 도구가 실행된 후 및 제품의 이전 버전이 설치 제거되었지만 WASPostUpgrade 도구가 실행되기 전에 삭제된 버전 7.0 이상 트리의 서브디렉토리일 수 있습니다.
- 오류 메시지에 지정된 전체 디렉토리 구조가 지정되었는지 여부를 판별하십시오.
- 가능한 경우, WASPreUpgrade 도구를 다시 실행하여 올바른 전체 마이그레이션 백업 디렉토리를 지정하십시오.
- 백업 디렉토리가 존재하지 않고 이 디렉토리가 비롯된 이전 버전이 설치 제거된 경우, 백업 저장소나 XML 구성 파일에서 이전 버전을 다시 빌드하십시오.
- WASPreUpgrade 도구를 다시 실행하십시오.
- WASPreUpgrade 도구는 WASPostUpgrade 도구 이전에 실행되지 않았습니다.
- 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
- 버전 9.0 애플리케이션이
설치에 실패합니다.
WASPostUpgrade가 완료된 후 wsadmin을 사용하여 애플리케이션을 수동으로 설치하십시오.
마이그레이션 중 설치에 실패한 애플리케이션을 수동으로 설치하려면 wsadmin 명령을 사용하여 마이그레이션 도구가 백업 디렉토리에 작성한 install_application_name.jacl 스크립트를 실행하십시오.
예를 들면, Linux 환경에서 다음 매개변수를 사용하십시오../wsadmin.sh -f migration_backup_directory/install_application_name.jacl -conntype NONE
자세한 정보는 WASPostUpgrade 명령의 내용을 읽어보십시오.
- 연합 노드를 마이그레이션한 후 다음 텍스트에서 강조표시된 예외와 유사한 예외를 WASPostUpgrade
로그에서 볼 수 있습니다.
- 추적 파일은 400MB 할당을 초과하지만 WASPostUpgrade는
여전히 실행 중입니다. 추가 디스크 공간을 사용할 수 없는 경우,
마이그레이션이 실패합니다.마이그레이션 중 이 문제점이 발생할 수 있다고 생각하는 경우, 다음 조치를 완료하십시오.
- WASPostUpgrade 명령을 실행하기 전에 마이그레이션 마법사를 중지하십시오.
- 마이그레이션하려는 각 프로파일에 대해 명령행에서 WASPostUpgrade 명령을
실행하십시오.
WASPostUpgrade 명령을 명령행에서 실행하는 경우는 다음과 같습니다.
- -oldProfile 및 -profileName 매개변수를 포함하여 마이그레이션할 프로파일을 표시하십시오.
- com.ibm.ejs.ras.TraceNLS* 매개변수를 추적 문자열에 추가하여
추적 로그의 크기를 줄이십시오. 예를 들어,
다음 추적 설정을 지정할 수 있습니다.
com.ibm.ejs.ras.TraceNLS*=info
- 문제점은 WASPreUpgrade 도구를 사용할 때 발생할 수 있습니다.
마이그레이션 마법사를 사용하여 프로파일을 WebSphere Application Server 버전 6.0.2에서 Solaris x64 프로세서 기반 시스템의 버전 9.0로 마이그레이션하면, WASPostUpgrade 단계 중에 마이그레이션이 실패할 수 있습니다.
migration_backup_dir/logs/WASPostUpgrade.time_stamp.log에서 다음과 유사한 메시지를 볼 수도 있습니다.MIGR0327E: A failure occurred with stopNode. MIGR0272E: The migration function cannot complete the command.
WebSphere Application Server 버전 6.0.2는 32비트 모드의 JVM(Java Virtual Machine)을 사용합니다. 버전 9.0용 마이그레이션 마법사는 WASPostUpgrade.sh 스크립트를 호출하며, 서버가 버전 6.0.2 노드를 중지할 때 64비트 모드로 버전 6.0.2용 JVM을 실행하려 합니다.
다음 조치를 완료하여 불완전 프로파일을 제거하고 WebSphere Application Server를 사용하여 올바르게 버전 6.0.2 프로파일을 마이그레이션하십시오.- 명령행에서 app_server_root/bin 디렉토리로 변경하십시오. 예를 들어, 다음 명령을 입력하십시오.
cd /opt/IBM/WebSphere/AppServer/bin
- WASPostUpgrade.sh 스크립트를 app_server_root/bin 디렉토리에서 찾아서 백업 사본을 만드십시오.
- WASPostUpgrade.sh 스크립트를 편집기에서 열고 다음을 수행하십시오.
- 다음 코드 행을 찾으십시오.
. "$binDir" /setupCmdLine.sh
- 이전 단계에서 식별한 코드 뒤에 다음 코드 행을
삽입하십시오.
JVM_EXTRA_CMD_ARGS=""
- 변경사항을 저장합니다.
- 다음 코드 행을 찾으십시오.
- 다음 명령을 사용하여 마이그레이션 프로세스 중 작성된 불완전 버전 9.0 프로파일을 삭제하십시오.
app_server_root/bin/manageprofiles.sh -delete -profileName profile_name
- 이전 단계에서 제거한 버전 9.0 프로파일의 profile_root 디렉토리를 삭제하십시오.
- 마이그레이션 마법사를 다시 실행하십시오.
- 명령행에서 app_server_root/bin 디렉토리로 변경하십시오.
- 버전 7.0 이상 구성에
있는 엔터프라이즈 애플리케이션을 새 버전 9.0 구성에 설치하도록
마이그레이션 프로세스 옵션을 선택하는 경우 마이그레이션의 애플리케이션
설치 단계 중에 일부 오류 메시지가 발생할 수 있습니다.
버전 7.0 이상 구성에 있는 애플리케이션에 올바르지 않은 배치 정보(일반적으로 이전 WebSphere Application Server 런타임에서 충분히 유효성 검증되지 않은 유효하지 않은 XML 문서)가 있을 수 있습니다. 현재 런타임에는 향상된 애플리케이션 설치 유효성 검증 프로세스가 있으므로 이러한 잘못된 형식의 EAR 파일을 설치할 수 없게 됩니다. 이렇게 되면 WASPostUpgrade의 애플리케이션 설치 단계 중 실패하여 "E" 오류 메시지를 생성합니다. "심각한" 마이그레이션 오류로 간주됩니다.
이러한 방식으로 애플리케이션 설치 중에 마이그레이션이 실패하는 경우 다음 중 하나를 수행할 수 있습니다.- 버전 7.0 이상 애플리케이션에서 문제점을 수정한 다음 다시 마이그레이션하십시오.
- 마이그레이션을 계속 수행하고 이 오류를 무시하십시오.
오류를 무시하면 마이그레이션 프로세스는 실패한 애플리케이션을 설치하지 못하지만 나머지 다른 마이그레이션 단계는 완료합니다.
나중에 해당 애플리케이션에서 문제점을 수정한 다음 관리 콘솔이나 설치 스크립트를 사용하여 새 버전 9.0 구성에 수동으로 설치하십시오.
- 연합 노드를
버전 9.0에 마이그레이션한 후,
애플리케이션 서버가 시작하지 않을 수 있습니다. 애플리케이션 서버를 시작하려고 시도할 때 다음 예제와 비슷한 오류가 표시될 수 있습니다.
[5/11/06 15:41:23:190 CDT] 0000000a SystemErr R com.ibm.ws.exception.RuntimeError: com.ibm.ws.exception.RuntimeError: org.omg.CORBA.INTERNAL: CREATE_LISTENER_FAILED_4 vmcid: 0x49421000 minor code: 56 completed: No [5/11/06 15:41:23:196 CDT] 0000000a SystemErr R at com.ibm.ws.runtime.WsServerImpl.bootServerContainer(WsServerImpl.java:198) [5/11/06 15:41:23:196 CDT] 0000000a SystemErr R at com.ibm.ws.runtime.WsServerImpl.start(WsServerImpl.java:139) [5/11/06 15:41:23:196 CDT] 0000000a SystemErr R at com.ibm.ws.runtime.WsServerImpl.main(WsServerImpl.java:460) [5/11/06 15:41:23:196 CDT] 0000000a SystemErr R at com.ibm.ws.runtime.WsServer.main(WsServer.java:59) [5/11/06 15:41:23:196 CDT] 0000000a SystemErr R at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) [5/11/06 15:41:23:196 CDT] 0000000a SystemErr R at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:64) [5/11/06 15:41:23:197 CDT] 0000000a SystemErr R at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
연합 노드의 애플리케이션 서버가 청취 중인 포트 번호를 변경하십시오. 예를 들면, 배치 관리자가 ORB_LISTENER_ADDRESS의 포트 9101에서 청취 중인 경우, 연합 노드의 애플리케이션 서버는 해당 RB_LISTENER_ADDRESS의 포트 9101에서 청취하지 않아야 합니다. 이 예제에서 이 문제점을 해결하려면 다음 단계를 수행하십시오.- 관리 콘솔에서 애플리케이션 서버 > server_name > 포트 > ORB_LISTENER_ADDRESS를 클릭하십시오.
- ORB_LISTENER_ADDRESS 포트 번호를 사용되지 않는 번호로 변경하십시오.
- 동기화가 실패한 경우 연합 노드를
버전 9.0에 마이그레이션하면,
애플리케이션 서버가 시작하지 않을 수 있습니다. 연합 노드를 버전 9.0로 마이그레이션하면 다음과 유사한 메시지를 수신할 수 있습니다.
이 메시지는 다음을 표시합니다.ADMU0016I: Synchronizing configuration between node and cell. ADMU0111E: Program exiting with error: com.ibm.websphere.management.exception.AdminException: ADMU0005E: Error synchronizing repositories ADMU0211I: Error details may be seen in the file: /opt/WebSphere/80AppServer/profiles/AppSrv02/logs/syncNode.log MIGR0350W: Synchronization with the deployment manager using the SOAP protocol failed. MIGR0307I: The restoration of the previous WebSphere Application Server environment is complete. MIGR0271W: Migration completed successfully, with one or more warnings.
- 배치 관리자는 버전 9.0 구성 레벨에 있습니다.
- 마이그레이션하려는 연합 노드는 배치 관리자의 저장소의 버전 9.0 구성 레벨에 있습니다(애플리케이션 포함).
- syncNode 조작을 완료하지 않았다고 볼 때 연합 노드 자체는 그다지 완전하지 않습니다.
- 관리 노드를 배치 관리자와 동기화하려면 노드에서 syncNode 명령을 다시 실행하십시오.
자세한 정보는 syncNode 명령을 참조하십시오.
- GenPluginCfg 명령을 실행하십시오.
자세한 정보는 GenPluginCfg 명령을 참조하십시오.
- 배치 관리자를
버전 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 3.0 스펙에
javax.ejb.Remote 어노테이션이 포함되기 때문에, Enterprise Java Bean이 전체 javax.ejb 및 java.rmi 패키지를 가져오기 위해 작성된 경우 특정
EJB 2.1 bean이 컴파일에 실패할 수 있습니다. 다음 예제와 유사한 컴파일 오류가 발생할 수 있습니다.
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 이상으로 업그레이드하십시오.
마이그레이션된 버전 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. 이 포트는 노드 에이전트에서 필요하지 않으며 안전하게 삭제될 수 있습니다.
다음에 수행할 작업
표시된 문제점을 찾지 못한 경우, IBM 지원에 문의하십시오.


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=tmig_troubleshoot
파일 이름:tmig_troubleshoot.html