3.13 Upgrade Troubleshooting

3.13 Upgrade Troubleshooting

• MySQL 9.4 인스턴스에서 테이블의 .frm 파일과 InnoDB 데이터 딕셔너리 간에 스키마 불일치가 있는 경우, MySQL 9.5로의 업그레이드가 실패할 수 있습니다. 이러한 불일치는 .frm 파일 손상 때문에 발생할 수 있습니다. 이 문제를 해결하려면, 업그레이드를 다시 시도하기 전에 영향을 받는 테이블을 덤프 및 복원하십시오.

• 새로운 mysqld 서버가 시작되지 않는 등의 문제가 발생하는 경우, 이전 설치에서 사용하던 오래된 my.cnf 파일이 남아 있지 않은지 확인하십시오. 이는 --print-defaults 옵션(예: mysqld --print-defaults)으로 확인할 수 있습니다. 이 명령이 프로그램 이름 이외의 내용을 표시한다면, 서버 또는 클라이언트 동작에 영향을 주는 활성 my.cnf 파일이 있는 것입니다.

• 업그레이드 후에 Commands out of sync 또는 예상치 못한 코어 덤프와 같은 컴파일된 클라이언트 프로그램 관련 문제가 발생하는 경우, 프로그램을 컴파일할 때 오래된 헤더 또는 라이브러리 파일을 사용했을 가능성이 높습니다. 이 경우, mysql.h 파일과 libmysqlclient.a 라이브러리의 날짜를 확인하여 새 MySQL 배포판에 속한 것인지 검증하십시오.

그렇지 않다면, 새 헤더와 라이브러리로 프로그램을 다시 컴파일하십시오. 공유 클라이언트 라이브러리에 대해 컴파일된 프로그램의 경우에도, 라이브러리 메이저 버전 번호가 변경된 경우(예: libmysqlclient.so.20에서 libmysqlclient.so.21로 변경)에는 재컴파일이 필요할 수 있습니다.

• 특정 이름으로 로더블 함수(loadable function)를 생성한 뒤, 동일한 이름을 갖는 새로운 내장 함수(built-in function)를 구현한 버전으로 MySQL을 업그레이드하면, 해당 로더블 함수는 접근할 수 없게 됩니다. 이를 수정하려면, DROP FUNCTION을 사용하여 로더블 함수를 드롭한 다음, CREATE FUNCTION을 사용하여 충돌이 발생하지 않는 다른 이름으로 로더블 함수를 다시 생성하십시오.

새로운 MySQL 버전이 기존 저장 함수(stored function)와 동일한 이름을 갖는 내장 함수를 구현하는 경우에도 마찬가지입니다. 서버가 서로 다른 종류의 함수에 대한 참조를 어떻게 해석하는지에 대한 규칙은 Section 11.2.5, “Function Name Parsing and Resolution”을 참조하십시오.

• Section 3.6, “Preparing Your Installation for Upgrade”에 요약된 문제 중 하나로 인해 MySQL 9.5로의 업그레이드가 실패하면, 서버는 데이터 디렉터리에 대한 모든 변경 사항을 되돌립니다. 이 경우, 모든 리두 로그 파일을 제거하고 기존 데이터 디렉터리에서 MySQL 9.4 서버를 다시 시작하여 오류를 해결하십시오.

리두 로그 파일(ib_logfile*)은 기본적으로 MySQL 데이터 디렉터리에 위치합니다. 오류를 수정한 후에는, 업그레이드를 다시 시도하기 전에 innodb_fast_shutdown=0을 설정하여 느린 셧다운(slow shutdown)을 수행하십시오.