
DX 그누보드 컨버터 상세 사용 설명서
대상 버전: v1.0.1 그누보드5로 운영하던 사이트의 회원·게시글·댓글·첨부파일 등을 DXCMS로 옮겨 주는 플러그인입니다. 컴퓨터를 잘 모르셔도 이 문서의 순서대로만 하면 됩니다. 처음부터 끝까지 한 번 읽고 시작하시길 권합니다.
목차
- 이 플러그인이 하는 일
- 시작하기 전에 꼭 확인할 것
- 1단계 - 그누보드에서 데이터 꺼내기 (SQL 파일 만들기)
- 2단계 - 그누보드의 data 폴더 준비하기 (첨부파일·이미지용, 선택)
- 3단계 - 플러그인 설치하기
- 4단계 - 내 사이트에 파일 올리기
- 5단계 - 변환 화면 열고 변환하기
- 6단계 - 변환이 끝난 뒤 해야 할 일
- 어떤 것이 어떻게 옮겨지나요 (항목별 안내)
- 변환 도중 멈췄을 때 / 다시 하고 싶을 때
- 화면 버튼과 메시지 설명
- 자주 묻는 질문
- 문제가 생겼을 때 (증상별 해결)
- 문의할 때 알려 주세요
1. 이 플러그인이 하는 일
그누보드5 사이트의 데이터를 DXCMS로 옮깁니다. 옮겨지는 것은 아래와 같습니다.
| 옮겨지는 것 | 설명 |
|---|---|
| 회원 | 아이디, 이름(닉네임), 이메일, 전화번호, 포인트, 가입일, 마지막 접속 정보, 메모, 자기소개 |
| 비밀번호 | 그대로 쓸 수 있습니다. 회원이 옛 비밀번호로 로그인하면 자동으로 새 방식으로 바뀝니다. |
| 게시판 그룹 | 그누보드의 그룹 |
| 게시판 | 게시판 이름, 읽기·쓰기·댓글 권한, 첨부파일 개수, 카테고리, 비밀글 사용 여부 |
| 게시글 | 제목, 내용, 작성자, 작성일, 조회수, 추천수, 공지, 비밀글, 링크, 카테고리, 답글 관계 |
| 댓글 | 내용, 작성자, 작성일, 대댓글 관계 |
| 첨부파일 | 파일 정보와 파일 자체(data 폴더를 올렸을 때) |
| 에디터 이미지 | 글 본문에 넣었던 이미지 파일 |
| 포인트 내역 | 포인트 적립·사용 기록 |
| 스크랩 | 회원이 스크랩한 글 |
| 쪽지 | 받은 쪽지 (읽음 여부 포함) |
| 추천 | 글 추천 기록 |
옮겨지지 않는 것
- 회원 프로필 사진(아이콘), 그누보드 쇼핑몰 데이터, 설문조사, 투표, 팝업, 배너 등 위 표에 없는 것
- 그누보드의 디자인(테마, 스킨)
그누보드 원본 사이트와 DB는 전혀 건드리지 않습니다. 파일을 복사해서 읽기만 하므로, 변환이 잘못되어도 원래 사이트는 그대로입니다.
2. 시작하기 전에 꼭 확인할 것
2-1. 준비물 체크
- ☐ DXCMS가 설치되어 있고 관리자 계정으로 로그인할 수 있다.
- ☐ 그누보드 사이트의 관리자(호스팅) 정보로 DB 내보내기(phpMyAdmin 등)를 할 수 있다.
- ☐ FTP 프로그램(파일질라 등)으로 DXCMS 사이트에 파일을 올릴 수 있다.
- ☐ (선택) 첨부파일과 에디터 이미지도 옮기려면 그누보드의
data폴더를 내려받을 수 있다.
2-2. 미리 알아 둘 것
- 연습으로 먼저 해 보세요. 가능하면 새로 설치한 연습용 DXCMS에서 한 번 변환해 보고, 결과가 마음에 들면 실제 사이트에서 하세요.
- DXCMS 사이트를 먼저 백업하세요. 이미 운영 중인 DXCMS에 옮기는 경우, 데이터베이스와 파일을 백업해 두는 것이 안전합니다.
- 이미 있는 것은 덮어쓰지 않습니다. DXCMS에 같은 아이디, 같은 게시판 키, 같은 그룹 키가 이미 있으면 그대로 두고 건너뜁니다. (예: DXCMS의
admin계정은 그대로 유지됩니다.) - 변환 중에는 사이트를 쓰지 않는 편이 좋습니다. 회원이 글을 쓰는 중에 변환하면 번호가 섞일 수 있습니다. 점검 시간대에 하세요.
- 시간이 걸립니다. 참고로 글 3만 개, 댓글 6만 개, 회원 2천 명 규모(SQL 파일 약 17MB)를 시험했을 때 약 3분 30초가 걸렸습니다. 서버 성능에 따라 더 걸릴 수 있습니다.
- 글자 인코딩은 UTF-8이어야 합니다. 아주 오래된 그누보드(EUC-KR 인코딩)는 한글이 깨질 수 있습니다. 3단계에서 UTF-8로 내보내는 방법을 안내합니다.
3. 1단계 - 그누보드에서 데이터 꺼내기 (SQL 파일 만들기)
그누보드의 모든 글과 회원 정보는 데이터베이스에 들어 있습니다. 이것을 .sql 파일 하나로 내보냅니다.
3-1. phpMyAdmin으로 내보내기 (가장 일반적인 방법)
- 그누보드를 쓰던 호스팅 업체의 관리 화면에 로그인합니다. (카페24, 가비아, 닷홈 등)
- 메뉴에서 phpMyAdmin(데이터베이스 관리) 을 엽니다. 업체마다 이름이 조금 다를 수 있습니다.
- 왼쪽 목록에서 그누보드가 쓰는 데이터베이스 이름을 누릅니다.
- 어떤 DB인지 모르겠다면 그누보드 설치 폴더의
data/dbconfig.php파일을 열어G5_MYSQL_DB값을 확인하세요.
- 어떤 DB인지 모르겠다면 그누보드 설치 폴더의
- 위쪽 메뉴에서 내보내기를 누릅니다.
- 내보내기 방법은 빠른 내보내기를 선택하고, 형식은 SQL을 선택합니다.
- 더 세밀하게 하고 싶다면 사용자 정의를 선택하고, 아래 내용을 확인합니다.
- 형식: SQL
- 문자 집합(인코딩): utf-8
- 테이블: 모두 선택 (또는
g5_로 시작하는 것만)
- 더 세밀하게 하고 싶다면 사용자 정의를 선택하고, 아래 내용을 확인합니다.
- 맨 아래의 실행(또는 Go)을 누릅니다.
- 컴퓨터에
.sql파일이 내려받아집니다. 파일 이름은 알아보기 쉽게 영문과 숫자로 바꿔 두세요. 예:gnuboard.sql
파일 이름에 한글이나 공백이 있으면 입력할 때 실수하기 쉽습니다.
gnuboard.sql처럼 간단한 영문 이름을 권합니다.
3-2. 파일이 너무 커서 내보내기가 안 될 때
- 호스팅에서 DB 백업 기능이 있으면 그것으로
.sql또는.sql.gz파일을 받으세요..gz로 압축된 파일은 압축을 풀어서.sql로 만들어 두어야 합니다. - 그래도 안 되면 호스팅 고객센터에 "데이터베이스 전체를 SQL 파일로 백업받고 싶다"고 문의하세요.
3-3. 내려받은 파일 확인
- 파일 이름이
.sql로 끝나는지 확인합니다. - 용량이 0KB가 아닌지 확인합니다.
- (선택) 메모장이나 텍스트 편집기로 열었을 때 한글이 정상으로 보이면 인코딩도 정상입니다. 파일이 아주 크면 열리지 않을 수 있으니, 무리해서 열지 않아도 됩니다.
3-4. 테이블 접두사 확인
그누보드는 기본적으로 테이블 이름 앞에 g5_가 붙습니다. (예: g5_member, g5_board) 설치할 때 다른 접두사를 썼다면 5단계에서 그 값을 입력해야 합니다. 모르겠다면 SQL 파일을 텍스트 편집기로 열어 CREATE TABLE 뒤에 나오는 이름을 보세요. g5_member라면 접두사는 g5_입니다.
4. 2단계 - 그누보드의 data 폴더 준비하기 (첨부파일·이미지용, 선택)
게시글의 첨부파일과 본문에 넣은 이미지는 데이터베이스가 아니라 파일로 저장되어 있습니다. 이것까지 옮기려면 그누보드의 data 폴더가 필요합니다. 글 내용만 옮기면 충분하다면 이 단계는 건너뛰어도 됩니다. (그 경우 첨부파일 목록은 만들어지지만 실제 파일은 없는 상태가 됩니다.)
4-1. data 폴더 내려받기
- FTP 프로그램으로 옛 그누보드 사이트에 접속합니다.
- 그누보드가 설치된 폴더 안의
data폴더를 찾습니다. - 폴더 안에 아래 두 폴더가 있는지 확인합니다.
file: 게시판 첨부파일editor: 에디터로 넣은 이미지
- 이 두 폴더(또는
data폴더 전체)를 내 컴퓨터로 내려받습니다.data폴더 안에는 캐시, 세션 같은 불필요한 파일도 많습니다. 용량이 크면file과editor폴더만 받으세요.
4-2. 폴더 이름 정하기
내려받은 폴더의 이름을 영문으로 간단하게 정합니다. 이 문서에서는 g5data라고 하겠습니다.
반드시 아래 구조가 되어야 합니다.
g5data
├─ file
│ ├─ free (게시판 아이디 이름의 폴더)
│ └─ gallery
└─ editor
├─ 2301 (연월 이름의 폴더)
└─ 2302g5data폴더 바로 아래에file폴더와editor폴더가 있어야 합니다.- 한 겹 더 감싸져서
g5data/data/file처럼 되어 있으면 안 됩니다. 그럴 때는 안쪽data폴더의 이름을 바꿔서 쓰세요.
5. 3단계 - 플러그인 설치하기
5-1. 압축 풀기
- 받은 파일
dx_gnuboard_converter_v1.0.1.zip을 내 컴퓨터에서 압축 풉니다.- 파일을 마우스 오른쪽 버튼으로 누르고 압축 풀기(또는 여기에 압축 풀기)를 선택하세요.
- 압축을 풀면
plugins라는 폴더가 생깁니다. - 그 안으로 들어가면
dx_gnuboard_converter폴더가 보입니다. 이 폴더가 플러그인 본체입니다.
폴더 안은 이렇게 생겼습니다.
plugins
└─ dx_gnuboard_converter
├─ plugin.php
├─ manifest.php
├─ README.txt
├─ lib
├─ views
└─ assets
dx_gnuboard_converter폴더 안에plugin.php파일이 바로 보여야 합니다. 폴더 안에 같은 이름의 폴더가 또 있으면 한 겹 더 들어가서 올리세요.
5-2. 내 사이트의 plugins 폴더 찾기
- FTP 프로그램(파일질라 등)으로 DXCMS를 설치한 사이트에 접속합니다.
- DXCMS가 설치된 폴더(이 문서에서는 루트라고 부릅니다)를 엽니다.
- 루트에는
index.php,admin,core,plugins,themes같은 폴더·파일이 보입니다. - 호스팅에 따라
public_html,www,html같은 폴더 안이 루트입니다.
- 루트에는
- 루트 안의
plugins폴더를 엽니다.
5-3. 플러그인 폴더 올리기
- 내 컴퓨터에서 압축을 푼
dx_gnuboard_converter폴더 전체를 끌어서, FTP 창의plugins폴더 안에 놓습니다. - 올라가는 파일이 모두 끝날 때까지 기다립니다. (파일 수는 10여 개로 적습니다.)
- 다 올라간 뒤 서버 쪽에 아래처럼 보이면 성공입니다.
(루트)
└─ plugins
└─ dx_gnuboard_converter
├─ plugin.php ← 이 파일이 바로 보여야 합니다
└─ ...5-4. 플러그인 켜기 (활성화)
- 웹 브라우저에서 내 DXCMS 사이트에 관리자 계정으로 로그인합니다.
- 관리자 페이지로 들어갑니다.
- 왼쪽 메뉴에서 플러그인을 누릅니다.
- 목록에서 DX 그누보드 컨버터를 찾습니다.
- 목록에 안 보이면 새로고침(Ctrl+F5) 해 보세요. 그래도 없으면 13번 항목을 보세요.
- 오른쪽의 활성화 버튼(또는 스위치)을 눌러 켭니다.
- 상태가 활성으로 바뀌면 설치 끝입니다.
관리자 첫 화면(대시보드)에 "그누보드 컨버터" 카드가 생기고 변환 도구 열기 버튼이 나타납니다.
6. 4단계 - 내 사이트에 파일 올리기
변환을 하려면 1단계에서 만든 SQL 파일(그리고 선택으로 data 폴더)이 내 DXCMS 사이트의 루트에 있어야 합니다.
6-1. SQL 파일 올리기
- FTP 프로그램으로 DXCMS의 루트 폴더를 엽니다. (
index.php,plugins폴더가 보이는 곳) - 내 컴퓨터의
gnuboard.sql파일을 루트로 끌어다 놓습니다. - 올라간 뒤 루트에
gnuboard.sql이 보이면 됩니다.
(루트)
├─ index.php
├─ plugins
├─ gnuboard.sql ← 여기에 올립니다
└─ ...꼭 루트에 올려야 합니다.
plugins안이나 다른 폴더 안에 올리면 찾지 못합니다.
6-2. data 폴더 올리기 (선택)
- 2단계에서 정리한
g5data폴더 전체를 루트로 끌어다 놓습니다. - 파일이 많으면 시간이 오래 걸립니다. 모두 올라갈 때까지 기다리세요.
- 다 올라간 뒤 구조를 확인합니다.
(루트)
├─ gnuboard.sql
└─ g5data
├─ file
└─ editor6-3. 보안 안내
SQL 파일에는 회원 정보(이메일, 암호화된 비밀번호 등)가 들어 있습니다. 변환이 끝나면 반드시 서버에서 지워야 합니다. (6단계에 안내가 있습니다.) 변환하는 동안만 서버에 두세요.
7. 5단계 - 변환 화면 열고 변환하기
7-1. 변환 화면 열기
- 관리자로 로그인한 상태에서 브라우저 주소창에 아래 주소를 입력합니다.
https://내사이트주소/dx-g5-converter
예:https://example.com/dx-g5-converter
또는 관리자 첫 화면의 그누보드 컨버터 카드에서 변환 도구 열기 버튼을 눌러도 됩니다. - "그누보드 → DXCMS 컨버터" 화면이 나오면 정상입니다.
- 관리자가 아니거나 로그인하지 않았다면 열리지 않습니다.
- 플러그인이 활성 상태가 아니어도 열리지 않습니다.
7-2. 입력하기
화면에 입력하는 칸은 세 개입니다.
(1) SQL 파일명 (필수)
- 4단계에서 루트에 올린 파일 이름을 입력합니다. 예:
gnuboard.sql - 루트에 올린
.sql파일이 있으면 입력칸 아래에 파일 이름 버튼(용량 표시)이 나타납니다. 그 버튼을 누르면 자동으로 입력됩니다. - 파일 이름만 쓰세요. 경로(
/home/...)는 쓰지 않습니다. - 파일 이름은
.sql로 끝나야 합니다.
(2) 고급 설정 (필요할 때만 펼치기)
고급 설정이라고 적힌 부분을 누르면 아래 두 칸이 나타납니다.
| 칸 | 입력 방법 |
|---|---|
| 그누보드 테이블 접두사 | 기본값은 g5_ 입니다. 그누보드 설치 때 접두사를 바꾸지 않았다면 그대로 두세요. 바꿨다면 그 값을 쓰세요. 영문, 숫자, 밑줄(_)만 쓸 수 있습니다. |
| 그누보드 data 폴더 | 2단계에서 올린 폴더 이름을 씁니다. 예: g5data. 첨부파일과 에디터 이미지를 옮기지 않을 거라면 비워 두세요. 루트 바로 아래 폴더 이름만 쓸 수 있습니다. |
7-3. 변환 시작
- 변환 시작 버튼을 누릅니다.
- 잠시 뒤 진행률 막대와 단계 목록이 나타납니다.
- 변환은 1초마다 조금씩 처리됩니다. 화면을 그대로 켜 두세요.
- 화면 아래의 로그와 개수 표시가 계속 늘어나면 잘 되고 있는 것입니다.
브라우저 창을 닫거나 다른 페이지로 이동하면 변환이 멈춥니다. (서버가 알아서 계속하지 않고, 이 화면이 1초마다 서버에 일을 시키는 방식입니다.) 완료될 때까지 이 화면을 열어 두세요. 멈춰도 이어서 할 수 있으니 걱정하지 않으셔도 됩니다.
7-4. 변환 순서
화면의 단계 목록은 아래 순서로 진행됩니다.
| 순서 | 단계 | 하는 일 |
|---|---|---|
| 1 | SQL 읽기 | SQL 파일을 읽어서 임시 보관 테이블에 넣습니다. |
| 2 | 정리 | 임시 테이블을 빠르게 찾을 수 있게 정리합니다. |
| 3 | 게시판 그룹 | 그룹을 만듭니다. |
| 4 | 게시판 | 게시판을 만듭니다. (카테고리 포함) |
| 5 | 회원 | 회원을 옮깁니다. |
| 6 | 게시글 | 글을 옮깁니다. (답글 포함) |
| 7 | 댓글 | 댓글을 옮깁니다. (대댓글 포함) |
| 8 | 첨부파일 | 첨부파일 정보를 등록하고, 파일을 복사합니다. |
| 9 | 에디터 이미지 | 본문 이미지 파일을 복사합니다. |
| 10 | 포인트 | 포인트 내역을 옮깁니다. |
| 11 | 스크랩 | 스크랩을 옮깁니다. |
| 12 | 쪽지 | 받은 쪽지를 옮깁니다. |
| 13 | 추천 | 추천 기록을 옮깁니다. |
| 14 | 마무리 | 글마다 댓글 수를 다시 계산합니다. |
단계가 끝날 때마다 로그에 "○○ 완료"라고 한 줄씩 남습니다.
7-5. 끝났는지 확인
- 진행률이 100% 가 되고
- 화면에 "변환이 끝났습니다. 임시 테이블을 삭제하고 SQL 파일을 서버에서 지워 주세요." 라는 초록색 안내가 나오면 끝입니다.
8. 6단계 - 변환이 끝난 뒤 해야 할 일
순서대로 하세요.
8-1. 임시 테이블 삭제
- 변환 화면에서 임시 테이블 삭제 버튼을 누릅니다.
- "임시 테이블을 삭제했습니다." 라고 나오면 됩니다.
- 임시 테이블은 변환할 때 SQL 내용을 잠시 담아 두는 곳입니다. 지워도 변환된 데이터에는 영향이 없습니다.
8-2. 서버에서 파일 지우기
FTP 프로그램으로 루트에 올렸던 아래 파일과 폴더를 지웁니다.
gnuboard.sql(개인정보가 들어 있으니 반드시 삭제)g5data폴더 (복사가 끝났으므로 삭제 가능)
첨부파일과 이미지는
data/uploads/g5_import폴더로 이미 복사되었습니다.g5data폴더를 지워도 사이트에서 이미지와 첨부파일이 보입니다.
8-3. 결과 확인하기
사이트에서 직접 눈으로 확인하세요.
- 게시판 목록: 옮긴 게시판에 들어가 글이 보이는지 확인합니다.
- 글 하나 열기: 본문, 이미지, 첨부파일, 댓글이 정상인지 확인합니다.
- 답글이 있는 글: 답글이 원글 아래에 이어져 있는지 확인합니다.
- 회원 로그인: 옛 아이디와 옛 비밀번호로 로그인해 봅니다. (10번 항목의 "비밀번호" 설명 참고)
- 관리자 > 회원 관리: 회원 수가 맞는지 확인합니다.
- 포인트, 쪽지, 스크랩: 로그인한 뒤 확인합니다.
8-4. 게시판 설정 점검 (권장)
변환된 게시판은 기본 설정으로 만들어지므로, 관리자 화면에서 한 번 점검하세요.
- 관리자 > 게시판 관리에서 옮겨진 게시판의 권한, 스킨을 확인합니다.
- 필요하면 메뉴(네비게이션)에 새 게시판을 추가합니다. 게시판이 만들어졌더라도 메뉴에 자동으로 추가되지는 않습니다.
8-5. 플러그인 끄기 (선택)
변환을 모두 마쳤다면 관리자 > 플러그인에서 DX 그누보드 컨버터를 비활성화해도 됩니다. 다만 회원들이 옛 비밀번호로 처음 로그인할 때 비밀번호를 바꿔 주는 기능이 이 플러그인에 들어 있습니다. 아직 한 번도 로그인하지 않은 회원이 있다면, 그 회원들이 로그인할 때까지는 켜 두어야 합니다. 대부분의 회원이 로그인하고 난 뒤에 끄는 것을 권합니다.
9. 어떤 것이 어떻게 옮겨지나요 (항목별 안내)
9-1. 회원
| 항목 | 옮겨지는 방식 |
|---|---|
| 아이디 | 그대로 |
| 이름 | 닉네임을 사용합니다. 닉네임이 비어 있으면 실명을 사용합니다. |
| 이메일 | 그대로. 이메일이 없거나, 다른 회원과 겹치면 아이디@noemail.invalid 형태의 임시 이메일로 채웁니다. 이후 회원이 직접 바꾸게 하세요. |
| 전화번호 | 휴대폰 번호, 없으면 일반 전화번호 |
| 등급 | 그누보드 레벨 10 → 관리자, 그 외 → 일반 회원. (중간 레벨 구분은 옮기지 않습니다.) |
| 상태 | 탈퇴한 회원, 차단된 회원은 비활성으로 들어갑니다. 로그인할 수 없습니다. |
| 포인트 | 현재 포인트가 그대로 들어갑니다. |
| 가입일, 마지막 접속 | 그대로 |
| 메모, 자기소개, 홈페이지 | 그대로 |
| 이미 DXCMS에 있는 같은 아이디 | 덮어쓰지 않고 건너뜁니다. (예: admin) |
9-2. 비밀번호
- 그누보드의 비밀번호는 DXCMS와 암호화 방식이 달라서 그대로는 쓸 수 없습니다.
- 그래서 옛 비밀번호 정보를 보관해 두었다가, 회원이 옛 비밀번호로 처음 로그인하는 순간 DXCMS 방식으로 자동 교체합니다.
- 회원은 아무것도 할 필요가 없습니다. 평소처럼 로그인하면 됩니다.
- 지원하는 방식: 그누보드 최신 방식(sha256), 구버전 MySQL 방식(
*로 시작하는 값), md5 방식. - 비밀번호를 틀리면 로그인되지 않고, 틀린 시도가 계속되면 일시적으로 제한됩니다.
9-3. 게시판 그룹과 게시판
| 항목 | 옮겨지는 방식 |
|---|---|
| 게시판 키 | 그누보드의 게시판 아이디(bo_table) 그대로. 주소가 /게시판아이디가 됩니다. |
| 게시판 이름 | 그대로 |
| 스킨 | 일반 게시판은 new-basic, 갤러리 게시판은 new-gallary 로 설정됩니다. (그누보드 스킨 이름에 gallery가 들어 있으면 갤러리로 봅니다.) |
| 읽기·쓰기·댓글 권한 | 그누보드 레벨 1 이하 → 전체 허용, 그 이상 → 회원, 10 → 관리자 |
| 한 페이지 글 수 | 그대로 (1~100 사이) |
| 첨부파일 개수 | 그대로 (최대 99개) |
| 카테고리 | 그누보드 카테고리 목록(` |
| 비밀글 사용 | 그대로 |
| 이미 있는 같은 게시판 키 | 덮어쓰지 않고 기존 게시판에 글을 합칩니다. |
9-4. 게시글
| 항목 | 옮겨지는 방식 |
|---|---|
| 제목 | 그대로. 제목이 비어 있으면 "(제목 없음)" |
| 내용 | HTML로 쓴 글은 HTML로(위험한 스크립트는 제거), 일반 글은 줄바꿈이 유지되도록 변환 |
| 작성자 | 회원이면 회원과 연결, 비회원이면 적힌 이름만 |
| 작성일 | 그대로. 날짜가 비어 있으면 변환한 시각 |
| 조회수, 추천수 | 그대로 |
| 공지 | 그누보드의 공지로 지정된 글은 공지로 |
| 비밀글 | 비밀글로 |
| 링크 | 링크1은 글의 링크로, 링크2는 추가 링크로 |
| 카테고리 | 같은 이름으로 연결 |
| 답글 | 원글에 이어진 답글 구조가 유지됩니다. (답글의 답글도 가능) |
| 글 번호(ID) | 새로 부여됩니다. (옛 번호와 주소는 달라집니다.) |
9-5. 댓글
- 내용, 작성자, 작성일, 비밀 댓글 여부가 옮겨집니다.
- 대댓글 구조가 유지됩니다. (최대 10단계까지)
- 원글을 찾을 수 없는 댓글(이미 지워진 글의 댓글 등)은 건너뜁니다.
- 마지막 단계에서 글마다 댓글 수를 다시 계산해 맞춥니다.
9-6. 첨부파일과 본문 이미지
- 첨부파일 정보(원래 이름, 크기, 다운로드 횟수)는 SQL만 있어도 옮겨집니다.
- 첨부파일 실제 파일은
data폴더를 올렸을 때만 복사됩니다. - 복사된 위치: 사이트 루트의
data/uploads/g5_import/file/게시판아이디/파일이름 - 본문 이미지:
data/uploads/g5_import/editor/… - 본문 안의 이미지 주소는 새 위치로 자동으로 고쳐집니다.
- 원본 파일이
data폴더에 없으면 로그의 개수 표시에 "원본 파일 없음" 으로 센 뒤 넘어갑니다. (글과 첨부 정보는 남습니다.) - 에디터 이미지는 jpg, png, gif, webp, bmp만 복사하며 svg는 보안상 복사하지 않습니다.
9-7. 포인트, 스크랩, 쪽지, 추천
| 항목 | 설명 |
|---|---|
| 포인트 내역 | 적립·사용 내용과 변동 후 잔액이 그대로 들어갑니다. 회원이 없으면 건너뜁니다. |
| 스크랩 | 회원과 글이 모두 옮겨진 경우에만 들어갑니다. 중복은 하나로 합칩니다. |
| 쪽지 | 받은 쪽지만 옮깁니다. (보낸 쪽지는 받는 사람의 받은 쪽지와 같은 내용이라 중복을 피합니다.) 읽음 여부도 유지됩니다. |
| 추천 | 추천한 기록만 옮깁니다. (비추천은 제외) |
10. 변환 도중 멈췄을 때 / 다시 하고 싶을 때
10-1. 중간에 멈췄을 때 (창을 닫았거나, 새로고침했거나, 인터넷이 끊겼을 때)
- 변환 화면을 다시 엽니다. (
/dx-g5-converter) - "이전 작업이 있습니다. '이어서 진행'을 누르세요." 라는 안내가 나옵니다.
- 이어서 진행 버튼을 누르면 멈춘 곳부터 계속됩니다.
- 이미 옮긴 것은 중복해서 옮기지 않습니다.
- 시험에서 변환 도중 일부러 새로고침했다가 이어서 진행해 보았을 때, 글과 댓글이 중복되거나 빠지지 않았습니다.
10-2. 일시정지
- 진행 중에 일시정지 버튼을 누르면 멈춥니다. 이어서 진행으로 다시 시작합니다.
10-3. 다시 처음부터 하고 싶을 때
처음부터 다시 버튼은 "진행 상태"만 지웁니다.
- 이미 옮겨진 회원, 글, 댓글 등은 지워지지 않습니다.
- 다시 시작하면 이미 옮긴 항목은 "이미 변환됨" 으로 세고 건너뜁니다. 새로 생긴 것이 없으면 아무것도 늘어나지 않습니다.
- 그러므로 SQL 파일을 새로 바꿔서 다시 시작해도, 이미 옮긴 같은 번호의 글은 다시 만들어지지 않습니다.
10-4. 옮긴 데이터를 모두 지우고 처음부터 다시 하고 싶을 때
이 플러그인에는 옮긴 데이터를 지우는 기능이 없습니다. (실수로 지우는 사고를 막기 위해서입니다.) 연습용 사이트라면 DXCMS를 새로 설치하고 다시 하는 것이 가장 깔끔합니다. 운영 중인 사이트에서 되돌려야 한다면 미리 해 둔 백업으로 복원하세요. 그래서 시작 전 백업을 권합니다.
10-5. 오류가 많아서 중단됐을 때
- 화면에 "오류가 많아 중단했습니다. 로그를 확인하세요." 라고 나오면, 처리 중 오류가 200건을 넘은 것입니다.
- 화면 아래 로그에 어떤 오류인지 나옵니다. 11번 항목과 13번 항목을 보고, 원인을 고친 뒤 이어서 진행을 누르세요.
11. 화면 버튼과 메시지 설명
11-1. 버튼
| 버튼 | 언제 보이나 | 하는 일 |
|---|---|---|
| 변환 시작 | 처음 | 입력한 파일로 변환을 시작합니다. |
| 일시정지 | 진행 중 | 잠시 멈춥니다. |
| 이어서 진행 | 멈췄을 때 | 멈춘 곳부터 다시 합니다. |
| 처음부터 다시 | 진행 기록이 있을 때 | 진행 상태만 지웁니다. (옮긴 데이터는 그대로) |
| 임시 테이블 삭제 | 변환이 끝난 뒤 | 변환 중 쓰던 임시 보관 테이블을 지웁니다. |
11-2. 화면에 나오는 정보
- 진행률 막대와 퍼센트: 전체 진행 정도
- 단계 목록: 어느 단계를 하고 있는지 (끝난 단계는 표시가 바뀝니다)
- 개수 표시: 단계마다 읽은 행 수, 옮긴 개수, 건너뛴 개수
- "(이미 변환됨)": 전에 옮긴 것이라 건너뜀
- "(기존 사용)": DXCMS에 이미 있어서 그것을 사용
- "(회원 없음-건너뜀)", "(원글 없음-건너뜀)": 연결할 대상이 없어서 건너뜀
- "원본 파일 없음": data 폴더에 실제 파일이 없음
- 로그: 시각과 함께 단계별 완료와 오류 내용이 한 줄씩 쌓입니다.
11-3. 안내 메시지
| 메시지 | 뜻과 해결 |
|---|---|
| 루트에서 파일을 찾을 수 없습니다 | SQL 파일이 루트에 없거나 이름이 다릅니다. 올린 위치와 철자를 확인하세요. |
| 파일명은 루트에 올린 .sql 파일 이름만 입력하세요 | 경로를 같이 썼거나 .sql로 끝나지 않습니다. 이름만 쓰세요. |
| 그누보드 테이블 접두사는 영문/숫자/밑줄만 가능합니다 | 접두사에 다른 문자를 썼습니다. 예: g5_ |
| 그누보드 data 폴더는 루트 바로 아래 폴더 이름만 입력하세요 | 폴더가 없거나 이름에 경로가 들어 있습니다. 이름만 쓰고 폴더가 루트에 있는지 확인하세요. |
| 서버 응답이 없습니다. 다시 시도합니다… | 서버가 잠시 바쁩니다. 자동으로 다시 시도합니다. 30번 넘게 안 되면 멈춥니다. |
| 로그인/보안 세션이 만료되었습니다 | 오래 두어 로그인이 풀렸습니다. 페이지를 새로고침한 뒤 이어서 진행을 누르세요. |
| 일시정지했습니다 | 직접 멈춘 상태입니다. |
| 이전 작업이 있습니다 | 진행 기록이 남아 있습니다. 이어서 진행을 누르세요. |
12. 자주 묻는 질문
Q1. 그누보드 원본 사이트는 어떻게 되나요? 전혀 바뀌지 않습니다. SQL 파일로 복사한 것만 읽습니다.
Q2. 회원이 비밀번호를 다시 만들어야 하나요? 아니요. 옛 비밀번호로 그대로 로그인하면 됩니다. 로그인 순간 자동으로 새 방식으로 바뀝니다.
Q3. 글 주소가 달라지나요? 네. DXCMS는 글 번호를 새로 만들기 때문에 옛 주소(/bbs/board.php?bo_table=...&wr_id=...)로는 들어올 수 없습니다. 검색엔진에 노출된 옛 주소가 있다면 연결이 끊깁니다.
Q4. 한 번에 몇 개까지 옮길 수 있나요? 정해진 한도는 없습니다. 글 3만 개, 댓글 6만 개, 회원 2천 명에 약 3분 30초가 걸렸습니다. 양이 많으면 시간만 더 걸립니다. 서버가 느리거나 SQL 파일이 아주 크면 더 오래 걸릴 수 있습니다.
Q5. 변환을 두 번 했는데 글이 중복되나요? 아니요. 같은 글은 한 번만 옮겨집니다. 이미 옮긴 것은 건너뜁니다.
Q6. DXCMS에 이미 글과 회원이 있는데 괜찮나요? 괜찮습니다. 기존 데이터는 지우거나 덮어쓰지 않고, 옮겨 온 데이터가 추가됩니다. 아이디나 게시판 키가 겹치면 기존 것을 그대로 씁니다. 그래도 안전을 위해 백업을 권합니다.
Q7. 게시판 스킨이 이상해요. 변환된 게시판은 일반 게시판은 new-basic, 갤러리는 new-gallary 스킨이 지정됩니다. 다른 스킨을 쓰고 싶으면 관리자 > 게시판 관리에서 바꾸세요.
Q8. 메뉴에 게시판이 안 보여요. 게시판은 만들어지지만 메뉴에는 자동으로 추가되지 않습니다. 관리자 메뉴 설정에서 추가하세요.
Q9. 그누보드 회원 등급(레벨 3, 4 등)이 구분되지 않아요. 레벨 10은 관리자, 그 외는 일반 회원으로 옮깁니다. 중간 레벨은 필요하면 관리자 화면에서 따로 설정하세요.
Q10. 쇼핑몰(영카트) 데이터도 옮겨지나요? 아니요. 게시판과 회원 데이터만 옮깁니다.
Q11. 프로필 사진은요? 옮기지 않습니다. 회원이 다시 등록해야 합니다.
Q12. 변환 중에 컴퓨터가 꺼졌어요. 괜찮습니다. 변환 화면을 다시 열고 이어서 진행을 누르세요.
13. 문제가 생겼을 때 (증상별 해결)
| 증상 | 확인하고 해결하는 방법 |
|---|---|
| 플러그인 목록에 "DX 그누보드 컨버터"가 안 보임 | 폴더를 한 겹 잘못 올렸을 가능성이 가장 큽니다. 서버에 plugins/dx_gnuboard_converter/plugin.php 파일이 있는지 확인하세요. plugins/dx_gnuboard_converter/dx_gnuboard_converter/plugin.php처럼 한 겹 더 들어가 있다면 안쪽 폴더를 바깥으로 옮기세요. |
/dx-g5-converter 주소로 가면 페이지를 찾을 수 없다고 나옴 | 플러그인이 활성인지 확인하세요. 활성인데도 안 되면 관리자에서 한 번 비활성화 후 다시 활성화하세요. |
| 주소로 가면 로그인 화면이 나오거나 접근 불가 | 관리자 계정으로 로그인해야 합니다. 일반 회원 계정으로는 열리지 않습니다. |
| "루트에서 파일을 찾을 수 없습니다" | SQL 파일이 루트(index.php와 같은 위치)에 있는지, 이름 철자가 같은지 확인하세요. 대소문자도 구분됩니다. |
| 변환 시작을 눌러도 진행이 안 됨 | 화면을 새로고침(Ctrl+F5) 하고 다시 해 보세요. 그래도 안 되면 브라우저 개발자 도구가 아니라 화면 아래 로그의 오류 문구를 확인해 문의하세요. |
| 진행이 0%에서 오래 멈춤 | SQL 파일이 아주 큰 경우 읽는 데 시간이 걸립니다. 몇 분 기다려 보세요. 계속 변화가 없으면 서버 오류일 수 있으니 문의하세요. |
| 글자가 깨져 보임 | SQL 파일이 UTF-8이 아닐 수 있습니다. 3단계에서 utf-8로 다시 내보내세요. 이미 일부를 옮겼다면 DXCMS를 새로 설치하고 다시 하는 것이 깔끔합니다. |
| 일부 글이 빠져 있음 | 개수 표시의 "건너뜀" 항목을 확인하세요. "원글 없음", "회원 없음" 때문에 건너뛴 것일 수 있습니다. |
| 첨부파일이 다운로드되지 않음 | data 폴더를 올리지 않았거나 구조가 틀린 경우입니다. 개수 표시에 "원본 파일 없음" 이 많은지 확인하세요. 2단계의 폴더 구조(g5data/file, g5data/editor)를 다시 확인하고, 변환 후 data/uploads/g5_import/file 폴더에 파일이 생겼는지 보세요. |
| 본문 이미지가 안 보임 | editor 폴더를 올리지 않았을 때 생깁니다. 파일을 g5data/editor로 올린 뒤 다시 변환하면 이미지 파일만 추가로 복사됩니다. |
| 옛 비밀번호로 로그인이 안 됨 | 플러그인이 활성 상태인지 확인하세요. (비활성이면 비밀번호 변환이 동작하지 않습니다.) 그래도 안 되면 비밀번호 방식이 특이한 경우일 수 있으니, 그 회원은 비밀번호 찾기를 안내하세요. |
| 게시판은 열리는데 "게시판 스킨 파일 없음"이 나옴 | 관리자 > 게시판 관리에서 그 게시판의 스킨을 사이트에 있는 스킨(예: new-basic)으로 바꾸세요. |
| "오류가 많아 중단했습니다" | 화면 로그에서 오류 내용을 확인하세요. SQL 파일이 중간에 잘렸거나 형식이 다른 경우가 많습니다. 파일을 다시 내보내서 올리고 처음부터 다시를 눌러 시작하세요. (이미 옮긴 것은 건너뜁니다.) |
| "로그인/보안 세션이 만료되었습니다" | 새로고침한 뒤 이어서 진행을 누르세요. |
| 서버가 느려지거나 다른 방문자가 불편해함 | 변환은 1초마다 짧게 처리하지만 서버에 부담이 있습니다. 접속자가 적은 시간에 하세요. 일시정지로 잠시 멈출 수도 있습니다. |
14. 문의할 때 알려 주세요
문의하실 때 아래 내용을 함께 알려 주시면 원인을 훨씬 빨리 찾을 수 있습니다.
- 어느 단계에서 막혔는지 (플러그인 설치 / 변환 화면 열기 / 변환 중 / 변환 후 확인)
- 화면에 나온 안내 메시지(빨간색 글자)와 화면 아래 로그 내용
- 개수 표시 화면 캡처 (옮긴 개수와 건너뛴 개수가 보이게)
- 그누보드 버전, SQL 파일 크기, 테이블 접두사
- 사용 중인 호스팅 종류 (카페24, 시놀로지 NAS 등)
문의하실 때 SQL 파일 자체나 회원 정보가 보이는 화면은 보내지 마세요. 개인정보가 들어 있습니다. 화면을 캡처할 때는 이메일, 이름 부분을 가려 주세요.
부록 - 순서 한눈에 보기
- 그누보드 DB를 SQL 파일로 내보낸다. (UTF-8, 이름은
gnuboard.sql처럼 간단하게) - (선택) 그누보드의
data폴더에서file,editor를 내려받아g5data폴더로 정리한다. - 플러그인 zip 압축을 풀고
dx_gnuboard_converter폴더를 사이트의plugins폴더에 올린다. - 관리자 > 플러그인에서 DX 그누보드 컨버터를 활성화한다.
- SQL 파일과 (선택)
g5data폴더를 사이트 루트에 올린다. - 관리자로 로그인해서
/dx-g5-converter를 열고, 파일명을 입력(필요하면 고급 설정에g5data입력)한 뒤 변환 시작. - 100%가 될 때까지 창을 열어 둔다.
- 임시 테이블 삭제 버튼을 누른다.
- 서버에서 SQL 파일과 g5data 폴더를 지운다.
- 사이트에서 글, 이미지, 로그인, 메뉴를 확인하고 필요하면 게시판 스킨과 메뉴를 정리한다.
Copyright © DesignOneX — designonex.com · All Rights Reserved. DesignOneX License 1.0 — https://designonex.com/notice/view/1787577858493247