BOARD 자료·레퍼런스

그누보드4에서 그누보드5로의 데이터베이스 이전 및 구조 업데이트 가이드

페이지 정보

작성자 최고관리자
댓글 0건 조회 14회 작성일 26-10-19 15:00

본문

그누보드4에서 5로 시스템을 업그레이드할 때 필요한 데이터베이스 이전 절차와 구조 불일치 문제를 해결하는 방법을 안내합니다.

그누보드4에서 그누보드5로의 데이터 이전 및 DB 구조 업데이트

그누보드4(G4)에서 그누보드5(G5)로의 마이그레이션은 시스템 구조 차이로 인해 데이터 이전과 DB 스키마 업데이트 과정을 거쳐야 합니다. 다음은 안전한 이전을 위한 단계별 가이드입니다.

1. 사전 준비 및 백업 (필수)

데이터 손실 방지를 위해 반드시 다음을 선행하십시오.

DB 백업: mysqldump 등을 사용하여 기존 G4 데이터베이스 전체를 백업합니다.
소스 백업: G4의 소스 코드 전체를 백업합니다.

2. 데이터베이스 이전 절차

G5에 기본 포함된 이전 프로그램을 활용합니다.

환경 구성: G5를 설치한 후, G4의 config.php 파일을 G5 서버 내 특정 폴더(예: /g4conf/config.php)에 복사합니다.
이전 프로그램 실행: 웹 브라우저에서 http://도메인/g4_import.php에 접속합니다.
경로 설정: 관리자 계정으로 로그인한 뒤, 복사해둔 G4 config.php 파일의 상대 경로를 입력하여 이전을 진행합니다.

3. 첨부파일 및 데이터 동기화

파일 복사: G4의 /data/file/ 폴더 내 모든 내용을 G5의 /data/file/ 폴더로 복사합니다.
에디터 이미지: 에디터를 사용한 게시판이 있다면 /data/cheditor4/ 폴더도 함께 복사해야 합니다.

4. DB 구조 업데이트 및 동기화

이전 프로그램 실행 후, G5 환경에 맞게 DB 구조를 최신화해야 합니다.

관리자 기능 활용: G5 관리자 페이지의 환경설정 > DB 업그레이드 기능을 실행하여 시스템이 요구하는 최신 테이블 및 필드 구조로 동기화합니다.
수동 업데이트: 커스터마이징된 필드나 테이블은 자동 이전되지 않습니다. G5에서 추가된 필드나 테이블이 누락되었다면, SQL ALTER TABLE 또는 CREATE TABLE 쿼리를 사용하여 직접 추가해야 합니다.

주의사항

G4와 G5는 구조가 다르므로, 이전 후 디자인과 스킨은 G5 환경에 맞게 새로 수정하거나 적용해야 합니다.
커스터마이징된 기능이 많을수록 작업량이 증가하므로, 이전 후 게시판별로 데이터가 정상적으로 출력되는지 반드시 확인하십시오.

그누보드4에서 그누보드5로의 DB 이전 및 구조 업데이트

그누보드4(G4)에서 그누보드5(G5)로 데이터를 이전할 때는 시스템 구조 차이로 인해 데이터베이스 스키마 업데이트가 필수적입니다. 작업 전 반드시 DB와 소스 파일 전체를 백업하십시오.

1. 데이터 이전 절차

그누보드5에는 G4 데이터를 가져오는 이전 프로그램이 포함되어 있습니다.

환경 구성: G4와 G5가 동일한 데이터베이스 내에 존재해야 합니다.
이전 실행: G5 설치 경로의 g4_import.php 파일에 접속하여 화면 안내에 따라 G4의 config.php 경로를 입력하고 실행합니다.
주의사항: 게시판 테이블이 G4 설정에 정상적으로 등록되어 있어야 데이터가 올바르게 이전됩니다.

2. DB 구조 업데이트 (필드 및 테이블)

데이터 이전 후에는 G5 버전에서 추가된 필드나 테이블을 동기화해야 합니다. 이를 위해 다음 방법을 순차적으로 활용하십시오.

관리자 페이지 활용: G5 관리자 페이지 내 [환경설정 > DB 업그레이드] 메뉴를 실행하십시오. 이 기능은 버전 업그레이드 시 새로 생성된 테이블이나 추가된 컬럼을 자동으로 반영합니다.
수동 쿼리 실행: 커스터마이징된 필드나 자동 업데이트로 해결되지 않는 누락된 필드는 phpMyAdmin 등에서 직접 SQL 쿼리를 실행하여 추가해야 합니다.

3. 커스터마이징 데이터 처리

기존 G4 환경에서 직접 추가하거나 수정한 필드(커스텀 필드)는 자동 이전 프로그램으로 반영되지 않습니다. G5 환경에 맞게 ALTER TABLE 쿼리를 사용하여 수동으로 필드를 생성해야 합니다. 작업 후에는 반드시 관리자 페이지에서 해당 게시판이나 회원 정보가 정상적으로 출력되는지 확인하십시오.

커스텀 게시판 및 필드 이전 방법

그누보드4에서 그누보드5로 데이터를 이전할 때, 기본 이전 프로그램은 표준 테이블과 필드만을 처리합니다. 사용자가 직접 추가한 커스텀 필드나 테이블은 자동으로 이전되지 않으므로, 아래 절차에 따라 수동으로 복구해야 합니다.

1. 데이터베이스 백업 및 확인

작업 전 반드시 기존 데이터베이스와 소스 파일 전체를 백업하십시오. 커스텀 필드 구조를 파악하기 위해 그누보드4의 테이블 구조를 확인해 두어야 합니다.

2. 커스텀 필드 수동 추가

이전이 완료된 그누보드5 데이터베이스에 ALTER TABLE 쿼리를 사용하여 누락된 필드를 직접 추가합니다.

실행 방법: phpMyAdmin 또는 MySQL 콘솔에서 쿼리를 실행합니다.

쿼리 예시:

ALTER TABLE `g5_write_게시판명` ADD `필드명` 데이터타입(길이) NOT NULL DEFAULT '기본값' AFTER `기준필드명`;

주의사항: AFTER 옵션을 사용하여 필드 위치를 지정하면 기존 데이터 구조와 일관성을 유지하는 데 도움이 됩니다.

3. PHP 스크립트를 활용한 일괄 업데이트

여러 게시판에 동일한 커스텀 필드를 추가해야 할 경우, sql_query 함수를 포함한 PHP 파일을 작성하여 실행하는 것이 효율적입니다.

<?php
include_once('./_common.php');
// 예시: 게시판 테이블에 필드 추가
sql_query("ALTER TABLE `g5_write_게시판명` ADD `wr_custom` VARCHAR(255) NOT NULL DEFAULT ''", false);
?>

4. 주의사항 및 다음 행동

자동 이전의 한계: 이전 프로그램은 g4_board 테이블에 등록된 게시판만 인식합니다. 커스텀 테이블이 별도로 존재한다면 해당 테이블은 직접 생성(CREATE TABLE)하고 데이터를 마이그레이션해야 합니다.
환경 설정: 커스터마이징된 기능이 있다면 그누보드5의 환경에 맞춰 소스 코드를 다시 개발하거나 수정해야 정상적으로 동작합니다.
검증: 필드 추가 후 관리자 페이지의 게시판 관리에서 해당 게시판의 설정이 정상적으로 불러와지는지, 글쓰기 시 커스텀 필드 값이 DB에 올바르게 저장되는지 확인하십시오.

내 상황	선택 기준	다음 행동
이전 시작 전	데이터 손실 방지	DB 및 소스 파일 전체 백업
데이터 이전 중	G4 데이터 가져오기	G5 설치 후 `g4_import.php` 실행 및 경로 설정
이전 완료 후	시스템 구조 동기화	관리자 페이지 [환경설정 > DB 업그레이드] 실행
커스텀 필드 누락 시	수동 스키마 업데이트	`ALTER TABLE` 쿼리 또는 PHP 스크립트로 필드 추가

Q: 관리자 페이지의 'DB 업그레이드' 기능은 언제 사용하나요? A: 버전 업그레이드 시 새로 생성된 테이블이나 추가된 컬럼을 자동으로 반영하는 기능입니다. 패치 후 DB 구조 변경이 필요할 때 실행하십시오.

Q: 커스텀 필드나 테이블은 어떻게 이전하나요? A: 기본 이전 프로그램은 표준 테이블만 처리합니다. 사용자가 직접 추가한 필드는 ALTER TABLE 쿼리를, 커스텀 테이블은 CREATE TABLE 쿼리를 사용하여 수동으로 생성해야 합니다.

Q: 이전 프로그램 실행 시 게시판이 보이지 않습니다. A: 이전 프로그램은 g4_board 테이블에 등록된 게시판만 인식합니다. G4에서 게시판 설정이 정상적으로 등록되어 있는지 먼저 확인하십시오.

Q: 이전 후 게시판 스킨이 깨져 보입니다. A: G4와 G5는 스킨 구조가 다르므로, 이전 후에는 G5 환경에 맞는 스킨으로 교체하거나 코드를 수정해야 합니다.

참고자료

기타 참고자료

이전글그누보드4에서 그누보드5로 이전 시 데이터베이스 설정(dbconfig.php) 가이드 26.10.19
다음글그누보드4에서 5로 이전 시 게시판 첨부파일(wrfile) 데이터 구조 갱신 가이드 26.10.18

댓글목록

등록된 댓글이 없습니다.