그누보드 4 쪽지 업그레이드 시 DB 오류 해결 방법

• 목록
• 스크랩

그누보드 4 쪽지 업그레이드 시 DB 오류 해결 방법

그누보드 4에서 쪽지 시스템을 업그레이드할 때 발생하는 MySQL 버전 관련 오류를 해결하고, config.php 파일에 필요한 테이블 정의를 추가하여 정상적으로 기능을 복구하는 방법을 안내합니다.

그누보드4에서 adm/db_memo_memo4_upgrade.php를 통해 쪽지 기능을 업그레이드할 때 발생하는 DB 오류는 주로 테이블 정의 불일치로 인해 발생합니다. 특히 g4_memo_recv 테이블과 관련된 MySQL 버전 호환성 문제나 설정 누락이 주요 원인입니다.

해결 방법: config.php 설정 수정

업그레이드 과정에서 오류가 발생한다면, config.php 파일에 쪽지 관련 테이블 정의를 명시적으로 추가하여 해결할 수 있습니다.

1. 기존 설정 변경:기존에 정의된 $g4['memo_table']을 아래와 같이 수정합니다.

   $g4['memo_table'] = $g4['table_prefix']. "memo_recv"; // 메모 테이블 (쪽지2/쪽지4)

2. 추가 테이블 정의:위 설정으로도 문제가 해결되지 않을 경우, config.php 하단에 다음의 테이블 정의를 추가합니다.

   $g4['memo_recv_table'] = $g4['table_prefix']. "memo_recv"; // 메모 테이블 (수신)
   $g4['memo_send_table'] = $g4['table_prefix']. "memo_send"; // 메모 테이블 (발신)
   $g4['memo_save_table'] = $g4['table_prefix']. "memo_save"; // 메모 테이블 (저장)
   $g4['memo_spam_table'] = $g4['table_prefix']. "memo_spam"; // 메모 테이블 (스팸)
   $g4['memo_notice_table'] = $g4['table_prefix']. "memo_notice"; // 메모 테이블 (공지)
   $g4['memo_group_table'] = $g4['table_prefix']. "memo_group"; // 메모 테이블 (그룹)
   $g4['memo_group_member_table'] = $g4['table_prefix']. "memo_group_member"; // 메모 테이블 (그룹멤버)
   $g4['friend_table'] = $g4['table_prefix']. "friend"; // 친구 테이블

주의사항

• DB 백업 필수: 설정 파일을 수정하기 전, 반드시 현재 DB를 백업하여 데이터 손실에 대비하십시오.
• 원본 복구: 문제가 해결되지 않거나 사이트 접속에 오류가 발생할 경우, 수정 전의 config.php 원본 파일로 즉시 복구하십시오.

그누보드 4 쪽지 업그레이드 시 테이블 정의 추가 방법

그누보드 4에서 쪽지 기능을 쪽지 4로 업그레이드하는 과정 중 g4_memo_recv 관련 MySQL 버전 오류로 중단되는 경우, config.php 파일에 쪽지 관련 테이블 정의를 명시적으로 추가하여 해결할 수 있습니다.

1. 기본 테이블 정의 수정

config.php 파일 내 기존 $g4['memo_table'] 설정을 아래와 같이 변경합니다.

• 기존: $g4['memo_table'] = $g4['table_prefix']. "memo";
• 변경: $g4['memo_table'] = $g4['table_prefix']. "memo_recv"; // 메모 테이블 (쪽지2/쪽지4)

2. 추가 테이블 정의 설정

위 설정 후에도 문제가 지속된다면, config.php 파일 하단에 아래의 테이블 정의 코드를 추가하십시오.

$g4['memo_recv_table'] = $g4['table_prefix']. "memo_recv"; // 메모 테이블 (수신)
$g4['memo_send_table'] = $g4['table_prefix']. "memo_send"; // 메모 테이블 (발신)
$g4['memo_save_table'] = $g4['table_prefix']. "memo_save"; // 메모 테이블 (저장)
$g4['memo_spam_table'] = $g4['table_prefix']. "memo_spam"; // 메모 테이블 (스팸)
$g4['memo_notice_table'] = $g4['table_prefix']. "memo_notice"; // 메모 테이블 (공지)
$g4['memo_group_table'] = $g4['table_prefix']. "memo_group"; // 메모 테이블 (그룹)
$g4['memo_group_member_table'] = $g4['table_prefix']. "memo_group_member"; // 메모 테이블 (그룹멤버)
$g4['friend_table'] = $g4['table_prefix']. "friend"; // 친구 테이블

3. DB 테이블 존재 확인 방법

설정 변경 전, 데이터베이스에 해당 테이블들이 실제로 존재하는지 확인해야 합니다. phpMyAdmin 등 DB 관리 도구의 SQL 쿼리 창에서 다음 명령어를 실행하여 테이블 구조를 확인할 수 있습니다.

SHOW TABLES LIKE 'g4_memo_recv';

주의사항

• DB 백업: 설정 변경 전 반드시 데이터베이스를 전체 백업하십시오.
• 복구: 문제가 해결되지 않거나 오류가 발생할 경우, 수정했던 config.php를 즉시 원본으로 복구하십시오.

데이터베이스에 특정 테이블이 실제로 존재하는지 확인하려면 호스팅 환경에서 제공하는 phpMyAdmin과 같은 데이터베이스 관리 도구를 사용하는 것이 가장 일반적입니다.

확인 절차

1. phpMyAdmin 접속: 호스팅 업체에서 제공하는 관리자 페이지 또는 제어판을 통해 phpMyAdmin에 로그인합니다.
2. 데이터베이스 선택: 왼쪽 목록에서 그누보드 설치 시 사용한 데이터베이스명을 클릭합니다.
3. 테이블 목록 확인: 오른쪽 화면에 나타나는 테이블 목록에서 g4_memo_recv, g4_memo_send 등 필요한 테이블이 생성되어 있는지 직접 확인합니다.
4. SQL 명령어로 확인: 상단 메뉴의 'SQL' 탭을 클릭한 후, 아래와 같은 명령어를 입력하여 실행하면 테이블 구조를 확인할 수 있습니다.

   DESCRIBE 테이블명;

   • 테이블이 존재한다면 해당 테이블의 필드 정보가 출력됩니다.
   • 테이블이 존재하지 않는다면 'Table doesn't exist'와 같은 오류 메시지가 표시됩니다.

주의사항

• 접속 정보 확인: dbconfig.php 파일에 설정된 DB 정보(DB명, 사용자명 등)가 실제 접속하려는 데이터베이스와 일치하는지 먼저 확인하십시오.
• 접근 권한: phpMyAdmin 접속이 어렵다면 호스팅 업체 고객센터에 문의하여 해당 데이터베이스에 접근할 수 있는 계정 정보를 확인해야 합니다.

작업 전 주의사항 및 복구 방법

그누보드 4에서 쪽지 시스템을 업그레이드하거나 config.php 파일을 수정하는 작업은 데이터베이스 구조에 직접적인 영향을 줄 수 있습니다. 안전한 작업을 위해 다음 절차를 권장합니다.

1. 작업 전 필수 조치

• DB 백업: 모든 데이터베이스 작업 전에는 반드시 전체 DB를 백업해야 합니다. 서버 환경에 따라 mysqldump 명령어를 사용하거나 관리자 도구(phpMyAdmin 등)를 통해 전체 데이터를 안전한 곳에 저장하십시오.
• 파일 백업: 수정 대상인 config.php 파일의 원본을 별도의 폴더에 복사해 두십시오. 문제가 발생했을 때 즉시 원본으로 덮어씌워 복구할 수 있습니다.

2. 실패 시 복구 방법

• config.php 복구: 수정 후 사이트 접속이 되지 않거나 오류가 발생하면, 미리 백업해둔 config.php 원본 파일을 다시 업로드하여 이전 상태로 되돌립니다.
• DB 복구: 만약 업그레이드 과정에서 데이터베이스 오류로 인해 데이터가 손실되거나 테이블 구조가 꼬였다면, 백업해둔 SQL 파일을 사용하여 데이터베이스를 복구해야 합니다.

3. 주의사항

• config.php 파일은 그누보드의 기본적인 변수와 테이블 정의를 담고 있는 핵심 파일입니다. 수정 시 오타가 발생하지 않도록 주의하십시오.
• DB 테이블이 실제로 존재하는지 확인하지 않은 상태에서 설정을 변경하면 오류가 지속될 수 있으므로, 수정 전 해당 테이블들이 DB 내에 존재하는지 먼저 확인하십시오.

쪽지 업그레이드 DB 오류 해결 가이드

그누보드 4에서 쪽지 업그레이드 시 발생하는 DB 오류는 주로 테이블 정의 누락이나 불일치로 인해 발생합니다. 아래 순서에 따라 조치하십시오.

내 상황	우선할 판단	다음 행동
업그레이드 중 중단 발생	DB 테이블 정의 확인	config.php에 누락된 테이블 상수 추가
설정 추가 후에도 오류 지속	DB 테이블 실제 존재 여부 확인	phpMyAdmin에서 테이블 생성 여부 검증
작업 전 불안 요소	데이터 손실 방지	전체 데이터베이스 및 config.php 백업

적용 절차

1. 백업: 작업 전 반드시 전체 DB를 백업하고 config.php 원본을 별도 저장합니다.
2. 설정 수정: config.php 파일에서 $g4['memo_table']을 memo_recv로 변경합니다.
3. 상수 추가: 그래도 오류가 발생하면 수신, 발신, 저장, 스팸, 공지, 그룹, 그룹멤버, 친구 테이블 정의를 config.php 하단에 추가합니다.

실전 FAQ

Q: config.php 수정 후에도 업그레이드 오류가 계속됩니다.

• A: 설정 파일 수정 후에도 오류가 발생한다면, 실제 데이터베이스에 해당 테이블(g4_memo_recv 등)이 생성되어 있는지 확인해야 합니다. phpMyAdmin에서 SHOW TABLES LIKE 'g4_memo_recv'; 쿼리를 실행하여 테이블 존재 여부를 먼저 검증하십시오.

Q: DB 테이블이 존재하는지 어떻게 확인하나요?

• A: phpMyAdmin에 접속하여 해당 데이터베이스를 선택한 후, 테이블 목록을 직접 확인하거나 SQL 쿼리 창에 DESCRIBE 테이블명;을 입력하여 구조가 출력되는지 확인합니다.

Q: 작업 중 사이트 접속이 안 되면 어떻게 하나요?

• A: 즉시 백업해둔 config.php 원본 파일을 서버에 다시 업로드하여 설정을 되돌리십시오. DB 구조 변경으로 인한 문제라면 백업해둔 SQL 파일을 통해 복구해야 합니다.

함께 보면 좋은 글

• MySQL 5.x 업그레이드 후 발생하는 그누보드 1364 오류 해결 방법
• 그누보드 5.2에서 5.3 업그레이드 가이드: 주요 변경 사항과 안전한 적용 방법

참고자료

기타 참고자료

• happyjung.com — G4 쪽지 → 쪽지4 업그레이드 오류날때 > 기술자료 | 해피정닷컴
• sir.kr — 그누보드5 매뉴얼
• goodsgoods.tistory.com — mysql phpMyAdmin 에서 테이블의 구조를 볼 수 있는 방법은?