MySQL 문제 해결하기

다음은 Google Workspace Migrate 설정에서 Oracle MySQL을 사용할 때 발생할 수 있는 문제를 해결하는 방법입니다.

네트워크 연결 오류  |  전체 디스크  |  비밀번호 문제  |  노드 오프라인

네트워크 연결 오류

Google Workspace 지원팀에서는 네트워크 설정과 관련된 문제의 해결을 도와드릴 수 없습니다.

노드 또는 플랫폼 서비스 호스트 로그에 MySQL이 언급된 오류(예: '연결 시간 초과')는 전체 MySQL 디스크 또는 네트워크 연결 문제가 있음을 의미할 수도 있습니다. 오류가 간헐적으로 발생하는지 여부에 따라 취할 수 있는 조치가 달라집니다.

섹션 열기  |  모두 접고 상단으로 이동하기

오류가 간헐적으로 발생함

전체 MySQL 디스크와 관련이 있는 오류일 수 있습니다.

1. 시스템 요구사항을 따랐으며 MySQL 서버 하드웨어, 특히 RAM, CPU, 스토리지가 최소한 설명된 대로 설정되어 있는지 확인합니다.
2. MySQL 서버의 경우 다음을 확인하세요.
   1. Google에서 제공하는 설치 프로그램을 사용하여 MySQL을 설치했습니다. 
   2. 서버에 다른 MySQL 인스턴스가 없습니다.
   3. 바이러스 백신 또는 멀웨어 백신 소프트웨어가 설치되어 있지 않습니다.
   4. 방화벽을 설치한 경우 포트 3306에서 인그레스 트래픽을 허용합니다. 

전체 디스크에서 공간을 확보하는 방법에 대한 자세한 내용은 전체 MySQL 디스크 문제 해결하기에서 확인하세요.

오류가 지속적으로 발생함

다음과 같은 오류는 네트워크 문제를 나타낼 수 있습니다.

1. 다음을 확인하세요.
   • MySQL 서버가 시스템 요구사항을 충족합니다.

     자세한 내용은 하드웨어 요구사항을 참고하세요.

   • Google에서 제공하는 설치 프로그램을 사용하여 MySQL 소프트웨어를 설치했습니다.

     자세한 내용은 설치 프로그램 다운로드하기를 참고하세요.

   • 데이터베이스 설정 구성하기의 모든 단계를 완료했습니다.
   • Google Workspace Migrate 클러스터의 모든 서버는 방화벽 또는 필터가 없는 네트워크에 있습니다.
   • MySQL에서 사용하는 Windows Server에 다른 소프트웨어가 설치되어 있지 않습니다.
   • 기본 Windows 방화벽 설정을 수정하지 않았습니다.
2. MySQL 서버에 연결할 수 없는 서버에 원격으로 연결하고 관리자 권한으로 PowerShell 창을 엽니다.
3. Telnet 클라이언트를 설치하려면 다음 명령어를 입력합니다.

   Install-WindowsFeature -name Telnet-Client

4. MySQL 서버와 연결할 수 없는 서버를 재부팅하고 다시 시도합니다. 문제가 계속되면 6단계로 진행합니다.
5. Telnet 테스트를 실행하려면 다음 명령어를 입력합니다.

   telnet MySQL-server-ip-address 3306

6. telnet 테스트 결과를 평가합니다. 다음 사항에 따라 다르게 조치합니다.
   • 오류가 표시되지 않거나 몇 초 후에 호스트 연결 끊김 메시지가 표시된다면 네트워크 문제가 없는 것일 수도 있습니다. Google Workspace Migrate 플랫폼을 열고 이전에 실패한 작업을 반복하여 오류를 다시 재현해 봅니다.
   • telnet을 사용하여 연결할 수 있지만 Google Workspace Migrate(동일한 노드 또는 플랫폼)를 사용하여 연결할 수 없는 경우 로컬 방화벽에서 발신 연결을 차단하고 있을 수 있으므로 로컬 서버의 방화벽 설정을 확인합니다.
   • 호스트에 연결할 수 없음, 포트 3306에서 연결 실패와 같은 오류가 표시되는 경우 다음 표에 설명된 단계에 따라 문제를 해결하세요.

telnet MySQL-server-ip-address 3306 입력	결과 및 해결 단계
다른 노드 서버 또는 플랫폼 서버	명령어가 다른 서버에서 성공한 경우 MySQL 서버 문제일 가능성이 낮습니다. 실패한 telnet 명령어를 실행한 서버의 네트워크 설정을 확인합니다.
여러 서버	오류가 발생하는 경우 네트워크 전체 문제나 MySQL 서버 관련 문제입니다. 다음 단계를 시도해 보세요. 원격 데스크톱을 사용하여 MySQL 서버에 연결합니다. PowerShell 창에서 다음 명령어를 입력하여 Telnet 테스트를 실행합니다. telnet MySQL-server-ip-address 3306 MySQL 서버에서 명령어를 입력할 때 오류가 표시되는 경우 전체 MySQL 디스크 문제 해결하기(아래)로 진행합니다. MySQL 서버에서 명령어를 입력할 때 오류가 표시되지 않는 경우 네트워크 문제로 인해 문제가 발생했을 가능성이 높습니다. 서버 간에 방화벽이 없고 서버가 동일한 VLAN에 있는지 확인합니다.
MySQL 서버	오류가 발생한 경우 MySQL 서버에 문제가 있는 것입니다. PowerShell 창에서 다음 명령어를 입력하여 localhost에 연결합니다. telnet localhost 3306 오류가 발생하지 않는다면 다음을 확인하세요. Google에서 제공하는 설치 프로그램을 사용하여 MySQL을 설치했습니다. 구성을 수정하지 않았습니다. 문제가 있는 경우 이를 수정하고 서버를 다시 시작합니다.

가득 찬 MySQL 디스크 문제 해결하기

디스크 용량이 가득 차면 다음과 같은 징후가 발생할 수 있습니다.

• 브리지 또는 파티션이 중단된 것으로 표시됩니다.
• 브리지가 완료되었지만 항목이 하나도 감지되지 않습니다.
• A RelationalDataLocation 또는 (Errcode: 28 - No space left on device) 메시지가 HAR 파일에 있습니다.
• 플랫폼 서비스 호스트 로그에 다음과 같은 오류 또는 유사한 오류가 있습니다.
  • The table 'bridgeexecutionpartitionmappings' is full('bridgeexecutionpartitionmappings' 테이블에 여유 공간이 없습니다)
  • The table 'appbridgeidentity' is full('appbridgeidentity' 테이블에 여유 공간이 없습니다)

  서비스 호스트 로그를 찾으려면 서비스 호스트 로그 확인하기를 참고하세요.

디스크가 가득 찬 경우 다음 방법으로 여유 공간을 확보하세요.

• 더 이상 필요하지 않은 브리지나 프로젝트를 삭제합니다.
• Google Compute Engine을 사용하여 공간을 늘립니다. VM에 영구 디스크 추가하기를 참고하세요.
• MySQL 데이터 파일을 더 큰 용량의 디스크로 이동합니다. MySQL 문서를 참고하세요.
• 바이너리 로그 파일을 삭제합니다. 바이너리 로그 삭제하기를 참고하세요.

비밀번호 문제

섹션 열기  |  모두 접고 상단으로 이동하기

만료된 MySQL 비밀번호 수정하기

플랫폼에 로그인할 때 빈 화면이 표시되고 서비스 호스트 로그에 다음 오류가 표시될 수 있습니다.

[MySqlException; HRESULT -2147467259] : Your password has expired. 로그인하려면 만료된 비밀번호를 지원하는 클라이언트를 사용하여 비밀번호를 변경해야 합니다.

이 오류는 MySQL 비밀번호가 기본적으로 약 1년 후에 만료되므로 발생합니다. 문제를 해결하려면 다음을 시도해 보세요. 

1. MySQL 루트 비밀번호가 없는 경우 이 페이지의 MySQL 루트 비밀번호 재설정하기를 먼저 완료합니다.
2. MySQL 머신에 로그인하여 명령 프롬프트를 엽니다.
3. MySQL에 연결하려면 다음 명령어를 입력합니다.

   C:\MySQL\bin\mysql.exe -h 127.0.0.1 -u root -pRootPassword

   RootPassword 대신 MySQL 루트 비밀번호를 사용하세요. -p와 비밀번호 사이에는 공백이 없습니다.

4. 비밀번호가 만료되지 않도록 설정하려면 다음 명령어를 입력합니다.

   ALTER USER USER() IDENTIFIED BY 'RootPassword';
   ALTER USER 'root'@'127.0.0.1' PASSWORD EXPIRE NEVER;
   ALTER USER 'migrate'@'%' PASSWORD EXPIRE NEVER;
   FLUSH PRIVILEGES;

5. 플랫폼 서버에서 Google Workspace Migrate 서비스를 다시 시작하고 정상적으로 연결합니다.

MySQL 이전 비밀번호 재설정하기

Google Workspace Migrate는 이전 비밀번호를 사용하여 MySQL과 통신합니다. 비밀번호를 재설정해야 하는 경우 아래 단계를 따르세요.

1단계: 비밀번호 재설정하기

1. MySQL 루트 비밀번호가 없는 경우 이 페이지의 MySQL 루트 비밀번호 재설정하기를 먼저 완료합니다.
2. MySQL 머신에 로그인하여 명령 프롬프트를 엽니다.
3. MySQL에 연결하려면 다음 명령어를 입력합니다.

   C:\MySQL\bin\mysql.exe -h 127.0.0.1 -u root -pRootPassword

   RootPassword 대신 MySQL 루트 비밀번호를 사용하세요. -p와 비밀번호 사이에는 공백이 없습니다.

4. 이전 사용자의 비밀번호를 업데이트하려면 다음 명령어를 입력합니다.

   ALTER USER 'migrate'@% IDENTIFIED BY 'NewUserPassword'; FLUSH PRIVILEGES;

   NewUserPassword 대신 새 이전 사용자 비밀번호를 사용하세요.

2단계: 플랫폼 업데이트하기

다음 옵션 중 하나를 선택합니다.

Google Workspace Migrate 플랫폼에 액세스할 수 있는 경우:

1. Google Workspace Migrate 플랫폼 상단에서 Settings(설정) Database settings(데이터베이스 설정)를 클릭합니다.
2. MySQL 및 Apache CouchDB 소프트웨어의 새 비밀번호를 입력합니다.

   두 비밀번호 모두 필수 항목입니다. CouchDB 비밀번호가 없는 경우 Google Workspace Migrate 플랫폼에 액세스할 수 없는 경우(아래)로 이동합니다.

3. Continue(계속)를 클릭합니다.

Google Workspace Migrate 플랫폼에 액세스할 수 없는 경우:

1. 플랫폼을 실행 중인 머신에 로그인합니다. 
2. 작업 표시줄에서 Google Workspace Migrate 를 마우스 오른쪽 버튼으로 클릭하고 Edit host settings(호스트 설정 수정)를 선택합니다.
3. MySQL settings(MySQL 설정)에서 Password(비밀번호)를 클릭하고 새 비밀번호를 입력합니다.
4. Save & Close(저장 및 닫기)OK(확인)를 클릭합니다.
5. 작업 표시줄에서 Google Workspace Migrate 를 마우스 오른쪽 버튼으로 클릭하고 StopGoogle Workspace Migrate service(Google Workspace Migrate 서비스 중지)를 선택합니다. 그런 다음 서비스를 다시 시작합니다. 

3단계: 노드 다시 연결하기

이 단계를 완료해야 새 데이터베이스 설정을 노드에 적용할 수 있습니다.

1. Google Workspace Migrate 플랫폼 상단에서 Servers(서버)를 클릭합니다.
2. 모든 노드를 선택하고 Delete(삭제) 를 클릭합니다.
3. CSV 파일을 사용하거나 노드를 직접 입력하여 노드를 추가합니다.

   자세한 내용은 노드 서버 추가하기를 참고하세요.

MySQL 루트 비밀번호 재설정하기

아래 단계에서는 NewRootPassword 대신 새 MySQL 루트 비밀번호를 사용하세요.

1. MySQL 머신에 로그인합니다.
2. 관리자 권한 명령 프롬프트를 열고 C:\MySQL\bin으로 이동합니다.
3. MySQL 서비스를 중지하려면 다음 명령어를 입력합니다.

   for /f %a in ('net start ^| find /I "mysql"') do @net stop %a

4. 다음 명령어를 입력하여 새 비밀번호를 설정하는 명령어 파일을 준비합니다.

   echo|set /p="ALTER USER 'root'@'127.0.0.1' IDENTIFIED BY 'NewRootPassword';" > password-reset-init.txt

5. 새 비밀번호를 안전한 위치에 기록합니다.
6. 비밀번호를 재설정하려면 다음 명령어를 입력합니다.

   mysqld --defaults-file="C:\MySQL\my.ini" --init-file="C:\MySQL\bin\password-reset-init.txt" --console

7. 로깅이 중지되면 Ctrl+Pause 또는 Ctrl+Break를 눌러 명령을 종료합니다.
8. 다음 명령어를 입력하여 명령어 파일을 삭제합니다.

   del password-reset-init.txt

9. 다음 명령어를 입력하여 MySQL을 다시 시작합니다.

   for /f %a in ('net start ^| find /I "mysql"') do @net start %a

10. 루트 사용자를 사용하여 데이터베이스에 로그인하고 새 비밀번호를 테스트하려면 다음 명령어를 입력합니다.

    C:\MySQL\bin\mysql.exe -h 127.0.0.1 -u root -p

11. 새 비밀번호를 입력합니다.

    새 비밀번호를 입력할 수 없으면 위 단계를 반복하여 비밀번호를 재설정합니다.

노드가 오프라인 상태이고 시작되지 않음

MySQL 비밀번호가 만료된 후 노드가 시작되지 않으면 다음 단계를 완료하세요.

1. 노드 머신에 로그인합니다.
2. C:\ProgramData\AppBridge\DataSourceSettings.json을 삭제하거나 이름을 바꿉니다.
3. 다음 단계를 완료하여 노드 서버를 다시 연결합니다.
   1. Google Workspace Migrate 플랫폼의 오른쪽 상단에서 Servers(서버)를 클릭합니다.
   2. 모든 노드를 선택하고 Delete(삭제) 를 클릭합니다.
   3. CSV 파일을 사용하거나 노드를 직접 입력하여 노드를 추가합니다.

      자세한 내용은 노드 서버 추가하기를 참고하세요.

관련 주제

• Google Workspace Migrate 문제 해결하기
• Google Workspace Migrate 오류 메시지 해석하기

_{Google, Google Workspace 및 관련 마크와 로고는 Google LLC의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표입니다.}