09. 데이터 이전

마이그레이션 (데이터 이전)^#

마이그레이션(migration) 이란 데이터를 다른 DB로 이전을 하는 것을 말합니다.

XE는 simple XML로 된 문서를 이용하여 마이그레이션을 지원합니다.

제로보드4, zb5beta, XE의 데이터를 제로보드XE로 이전하는 툴은 완성되었습니다.

그 외의 툴에서 XE로 이전하는 것이 필요하다면 데이터의 구조와 테스트할 수 있는 데이터를 알려주시면 만들 수 있습니다.

 

* 2008. 3. 24일 zbXE 1.0.1 이 배포되면서 xml 추출 프로그램과 데이터 이전 모듈의 upgrade가 있었습니다.

 

마이그레이션의 종류^#

마이그레이션은 크게 4가지 동작으로 구성됩니다.

1. 회원 정보의 이전

   1. 회원 기본 정보 + 이미지이름/이미지마크등의 추가정보를 XML 데이터로 만들고 이를 이전합니다.
      

2. 게시물의 이전

   1. 게시판 하나를 하나의 XML 파일로 만들고 이전을 합니다.
   2. 댓글/엮인글/첨부파일등을 모두 포함할 수 있으며 첨부파일을 포함하지 않거나 여러개로 분할하여 xml파일로 만들 수 있습니다.
      (단 첨부파일을 포함하지 않을 경우 원본 첨부파일이 존재해야 합니다)

3. 쪽지(메세지) 데이터의 이전

   1. 보낸 쪽지를 기준으로 데이터를 이전하여 보낸쪽지/ 받은쪽지를 성공적으로 이전시킬 수 있습니다.
      단 쪽지의 주인을 찾기 위한 회원 정보가 미리 이전되어 있어야 합니다.

4. 회원정보와 게시물의 동기화

   1. 회원정보와 게시물을 모두 이전후 동기화를 실행해주어야 각 회원이 작성한 글의 작성자를 각 회원아이디로 지정을 하게 됩니다.
   2. 동기화를 하지 않게 되면 모든 게시물은 주인없는 게시물이 됩니다. :) 

 

마이그레이션의 순서^#

회원정보, 게시물의 경우 순서가 상관없습니다.

하지만 쪽지의 경우는 회원정보가 이전된 후에 시행하여야 합니다.

제일 마지막에 회원정보와 게시물의 동기화를 하면 원래 작성자의 권한이 주어집니다.

 

포인트(점수) 정보^#

회원의 포인트 정보는 포인트 정책이 다르기 때문에 이전되지 않습니다.

하지만 관리자 > 포인트 모듈에서 포인트 초기화 기능을 이용하면 모든 포인트를 재조절할 수 있습니다.

각 게시판(모듈)에 맞는 포인트를 조절하고 재계산을 하면 보다 정확한 포인트를 산출 할 수 있습니다. 

 

XML 파일 만들기^#

마이그레이션(데이터) 이전의 순서는 모두 동일합니다.

zbXE의 데이터 추출을 예제로 하여 설명을 드리겠습니다.

1. 마이그레이션 프로그램의 다운로드 및 업로드

   • 마이그레이션을 원하는 프로그램의 XML파일을 만들어 주는 마이그레이션 프로그램을 다운로드 받으세요.

     • xe xml 추출 프로그램
     • zeroboard4 xml 추출 프로그램
     • zb5beta xml 추출 프로그램
     • wordpress xml 추출 프로그램 (ver 2.0.x 이하)
     • mini board xml 추출 프로그램
     • gnuboard4 xml 추출 프로그램
     • 아이즌 보드(iezn) => XE
     • code shop > XE

   • 압축 풀고 계정에 업로드 하기

     • 다운로드 받은 파일의 압축을 풀고 그 파일을 자신의 계정에 FTP 프로그램을 이용해서 업로드 하세요.

2. 마이그레이션 프로그램의 실행

   1. 마이그레이션 프로그램은 웹프로그램이므로 브라우저에서 호출하여야 합니다.
      자신의 계정 주소가 http://www.test.com 이고 migration 이라는 디렉토리명으로 업로드를 하였다면 다음과 같이 브라우저의 주소창에 url을 입력하세요.
      ex) http://www.test.com/migration/index.php
   2. url이 제대로 입력되었으면 아래와 같은 그림이 나타납니다.
      위의 예는 XE용이며 다른 프로그램도 비슷합니다.
   3. 이전할 대상 프로그램의 위치를 입력해주세요.
      위치는 절대경로나 상대경로를 사용할 수 있지만 같은 서버내의 프로그램만 가능하므로 http://... 와 같은 형식은 지원되지 않습니다.
      
      위와 같이 이전할 대상 프로그램과 마이그레이션 프로그램이 같은 디렉토리에 있다면 ../zbxe 와 같이 입력해주시면 됩니다.
      그리고 [설치 경로 입력] 버튼을 클릭해주세요.
   4. 대상의 위치를 제대로 입력하였다면 아래와 같은 화면이 나타납니다.
      (블로그등과 같은 경우에 따라서는 없을 수도 있습니다)
      

   5. 회원/ 쪽지 또는 원하는 게시판을 선택하고 [추출 대상 선택] 버튼을 클릭하시면 됩니다.
      선택을 하시면 마지막으로 다음과 같은 화면이 나타납니다.
      
      (그림이 작게 보이면 클릭하세요)

      • 3번째 단계는 XML파일 생성을 위한 URL을 만드는 단계입니다.
      • XML파일을 1개 이상으로 나눌 수도 있고 첨부파일을 포함하지 않도록 할 수 있습니다.
      • 분할 수와 첨부파일 미포함 지정/해지를 한 후에 각각의 버튼을 클릭해주시면 XML URL이 바뀝니다.

   6. zbXE로 데이터 이전하기
      여기서는 XML파일을 직접 다운로드 받지 않고 URL을 이용해서 데이터 이전을 하는 방법을 소개합니다.
      (XML파일을 직접 다운로드 받아서 이전하는 것도 동일합니다)

      1. 게시판의 이전이라면 XE에 게시판을 미리 만들어 놓아야 합니다.
      2. XE의 관리자 페이지에서 [제로보드 데이터 이전] 모듈을 선택해주세요.
      3. [XE 데이터 이전] 버튼을 클릭하면 아래와 같은 선택 화면이 나타납니다.
         위 대상중 원하는 XML파일의 종류를 선택하고 [다음] 버튼을 눌러주세요.
      4. 게시물의 경우 대상 게시판을 선택하고 그 외의 경우는 XML파일을 지정하고 입력 단위를 설정하면 됩니다.
         (그림이 작게 보이면 클릭하세요)
         위에서 입력하는 XML파일을 5번에서 생성한 XML파일의 URL을 입력하면 됩니다.
         
         그리고 [다음] 버튼을 클릭하세요.
      5. 데이터 이전
         XML파일이 정상적으로 지정이 되면 데이터 이전 준비를 하고 데이터 이전을 진행하게 됩니다.
         
         위의 단계는 XML파일을 분석해서 개별 item으로 나누는 작업을 하고 있는 중입니다.
         
         XML파일의 분석이 끝나면 이전을 시작합니다.
         이 때 입력 단위별로 진행이 됩니다.
      6. 동기화
         회원정보와 게시글 이전이 끝났으면 [회원정보 동기화]를 해주세요.
         그래야 회원과 게시글 주인의 정보가 연동이 됩니다.

 

마이그레이션시 꼭 알아두어야 할것^#

1. 회원정보 동기화를 하지 않으면 글과 회원의 연동이 되지 않습니다.
2. 글의 순서는 현재는 이전하는 순서입니다.
   최대한 빨리 글의 등록일 순으로 정렬 되도록 할 예정입니다.
3. 회원과 게시글 이전 후 [관리자 - 부가모듈 - 포인트 모듈]에서 포인트 초기화를 하면 글과 댓글, 첨부파일로 각 회원들의 포인트를 재계산합니다.
   하지만 포인트 초기화는 로그인등 기타 포인트 점수를 반영하지 못하니 데이터 이전 후에만 하셔야 합니다.