이 주제에서는 온라인 이름 바꾸기 중의
문제점 해결 및 오류 복구 프로시저에 대해 설명합니다.
서버 이름 바꾸기 상태 UI는 애플리케이션을 폴하여 각 이름 바꾸기
상태를 확인합니다. 임의의 애플리케이션 이름 바꾸기가 실패하면 전체 서버
이름 바꾸기가 완료되지 않습니다. 실패가 표시되면
먼저 Jazz™ Team Server 및
애플리케이션 로그에서 문제를 확인해야 합니다. 다음은 일반 오류
목록과 해당 오류의 수정 방법입니다.
이름 바꾸기가 시작되지 않았음이 UI에 표시됨
importURLMappings를
실행한 다음 /serverRenameStatus를 보면
서버 이름 바꾸기가 시작되지 않았음이 표시되어 있습니다.
이름 바꾸기 후에 serverRenameStatus 페이지로
경로가 재지정되지 않음
이름 바꾸기가 이미 완료되었으면
올바른 동작입니다. 확인하려면 https://jts.example.org:9443/jts/serverRenameStatus로 이동하여
모두 100%이며 녹색인지 검사하십시오.
애플리케이션 이름 바꾸기 실패
- 애플리케이션이 실행 중이며 Jazz Team Server에서
ping을 실행할 수 있는지 확인하십시오.
- 브라우저에서 각 애플리케이션 rootservices에 연결할 수 있는지
확인하십시오. CCM에서 https://ccm.example.org:9443/ccm/rootservices를 확인하십시오.
다른 애플리케이션에 대해 반복하십시오.
- 애플리케이션이 실행 중이지 않으면 애플리케이션을 시작하십시오. Jazz Team Server를
다시 시작하지 않아도 됩니다.
상태를 확인하기 위해 계속 애플리케이션을 폴합니다. 애플리케이션이
다시 온라인이 되면 UI에 상태가 업데이트됩니다.
- 애플리케이션이 실행 중이면 해당 애플리케이션(예:
https://ccm.example.org:9443/ccm/appServerRenameStatus의 CCM)에 접속할 수 있는지 확인하십시오.
404 오류가 발생하면 애플리케이션이 4.0 애플리케이션이
아님을 표시합니다. 서버 이름 바꾸기를 지원하려면 애플리케이션의 버전이
4.0 이상이어야 합니다. 서버 이름 바꾸기를 수행하기 전에
업그레이드를 수행할 수 있습니다. 자세한 정보는 roadmap_clm_upgrade.html의 내용을 참조하십시오.
- 자세한 오류 메시지는 Jazz Team Server 및
애플리케이션 로그를 확인하십시오.
- 모든 애플리케이션의 server/conf/ 디렉토리에
.mappingEvent 파일이 있는지 확인하십시오.
이름 바꾸기가 완료되었지만 오류가 있음이
UI에 표시됨
이 경우 이름 바꾸기가
완료되었지만 애플리케이션에 대해 조치를 수행할 때 오류가
있음이 UI에 표시됩니다. 즉, 이름 바꾸기가 완료되지 않았음을 표시합니다.
- 전체 이름 바꾸기가 완료되었는지 판별하려면 애플리케이션 로그를
확인하십시오.
- 애플리케이션을 중지하십시오.
- 애플리케이션 war 파일을 열고 WEB/web.xml로 이동하십시오.
XML로 된 다음 요소를 찾으십시오.
<filter>
<filter-name>bridgefilter</filter-name>
<filter-class>com.ibm.team.repository.server.servletbridge.BridgeFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>bridgefilter</filter-name>
<servlet-name>equinoxbridgeservlet</servlet-name>
</filter-mapping>
- 이 항목이 없으면 애플리케이션이 전체 이름 바꾸기가
완료되었는지를 알 수 없습니다. 항목을 추가하고 war 파일을
다시 배치하십시오. 애플리케이션 서버를 다시 시작하고
애플리케이션이 시작되도록 트리거할 페이지를 브라우저에서 여십시오. 예를 들어, CCM 애플리케이션의 경우 https://ccm.example.org:9443/ccm/admin으로
이동하십시오.
- 다른 애플리케이션 war 파일에 항목이 포함되어 있는지 확인하고
항목이 없는 경우 동일한 단계 세트를 수행하십시오.
서버 이름 바꾸기 완료 실패
모든 애플리케이션 이름 바꾸기가 완료된 다음
Jazz Team Server에서
여러 사항이 발생합니다.
- Jazz Team Server 로그를 확인하여
실패한 완료 단계를 판별하십시오.
- 데이터 웨어하우스를 업데이트하는 중에 오류가 있을 가능성이 있습니다.
데이터 웨어하우스 구성이 올바르며 데이터베이스 서버가 사용 가능한지
확인하십시오.
- 문제점을 식별한 후 일반 복구 프로시저를 따르십시오.
완료 단계를 재시도할 수 없습니다.
맵핑 이벤트 파일이 누락됨
사용자
환경이 분산 환경인 경우 맵핑 이벤트 파일이 애플리케이션
구성 디렉토리에 복사되지 않았을 가능성이 있습니다. 실패한
애플리케이션의 server/conf/ 디렉토리에
.mappingEvent 파일이 있는지 확인하십시오. .mappingEvent
파일이 없으면 다음을 수행하십시오.
- 애플리케이션을 중지하십시오.
- .mappingEvent 파일을 애플리케이션의 server/conf/jts 디렉토리에서
server/conf 디렉토리로 복사하십시오.
참고: 지정된
JTS 토폴로지의 모든 .mappingEvent 파일이
동일합니다.
- 애플리케이션 서버를 다시 시작하십시오. Jazz Team Server를
다시 시작하지 않아도 됩니다. 상태를 확인하기 위해 애플리케이션을 계속 폴합니다. 애플리케이션이
다시 온라인이 되면 UI에 상태가 업데이트됩니다.