메뉴 건너뛰기

XE Migration Tool 사용하기

XE Campus
조회수


XE Migration Tool

XE3으로 데이터를 이전하기 위한 사이트 마이그레이션 도구입니다.

XE 1.x 의 데이터를 XE3에 import 할 수 있는 데이터로 내려받으실 수 있습니다.

XE1 마이그레이션

XE 1.x 버전에서 XE3 으로 데이터 이전을 위해 다음과 같은 순서대로 진행합니다.
 

0. 시작하기

*Example

마이그레이션 사용자의 이해를 돕기 위해 도메인명과, XE 1.x 설치된 경로를 예시로 정하겠습니다.

도메인명 : my.domain.com
XE 1.x 설치 경로 :  ../home/my/
XE 1.x 위치 :  ../home/my/xe1
XE Migration Tool 설치 경로  ../home/my/xe1/xpressengine-migration

 

0-1 설정 파일 확인 

files/config/db.config.php 에 slave_db 내용이 정확히 설정되어 있는지 확인합니다. 

slave_db의 내용은  master_db와 같아야 합니다.

*Example
../home/my/files/config/db.config.php

 

1. 마이그레이션 설정 파일 생성 및 접근 제한 설정

마이그레이션 설정 파일의 저장위치는 XE Migration Tool 설치 경로 입니다

*Example
../home/my/xpressengine-migration/설정파일
 

1-1 UUID 생성

UUID 를 생성합니다. 

이때 UUID는 대문자만 동작하기 때문에 소문자가 포함되었을 경우 꼭 대문자로 변환합니다.

UUID는 uuidgen 명령 또는 https://www.uuidgenerator.net 등에서 생성할 수 있으며 

파일명 생성 및 권한 없는 자의 접근이 가능할 수 없도록 접근 제한 역할도 겸합니다.

1-2 secure-key-UUID 파일 생성

secure-key-로 시작해 UUID를 포함하는 파일명으로 파일을 생성합니다.

*Example 파일명
생성한 UUID 값이 40f2c56a-9b7a-425e-ae25-8959e38e73be 경우 
secure-key-40F2C56A-9B7A-425E-AE25-8959E38E73BE

*예시에 사용된 UUID 값은 권한 없는 자의 접근이 가능할 있으므로 파일명을 사용하지 마시기 바랍니다.



 

1-3 secure-key-UUID 파일의 내용

secure-key-로 시작하는 파일은 아래 코드 내용으로 저장합니다.

[common]
source=xpressengine1
# XE 1.x가 설치된 경로
path=[XE 1.x가 설치된 경로]
# 데이터 업데이트 시 변경. 기본 값 1
revision=1
 
# 회원
[user]
attach=true
limit=100
 
# 게시판
[document]
attach=false
limit=100

 

path는 변경하시려는 유저의 XE 1.x가 설치된 경로를 입력하셔야 합니다.

*Example 
 path=../home/my

 

limit은 추출할 대상의 maximum 개수를 설정합니다. 

*Example 
 limit=100 경우 하나의 .xml파일에 최대 100개의 추출 대상을 내려받을 있습니다.

 

2. secure key 인증

위 설정이 정상적이라면 ’secure key를 입력하세요’ 메시지가 출력되며, 위에서 생성한 UUID 값을 입력하면 됩니다. 

 

 

3. 추출 데이터 선택

'data export tool’ 제목의 페이지가 보이면 추출할 데이터를 선택하실 수 있습니다.
 

3-1 경로입력

step 1.경로입력

설치된 경로는 자동으로 입력됩니다. 


 

3-2 추출 대상 선택

step 2.추출 할 대상을 선택해 주세요

회원 정보, 게시물 (댓글, 첨부파일) 을 선택해 추출할 수 있습니다.

회원

그룹, 확장 필드, 이메일, 이메일 인증 여부, ID, 닉네임, 패스워드, 프로필 이미지 등의 개인 정보를 추출합니다.

게시물

게시판의 카테고리와 확장 필드 설정, 첨부파일을 포함하는 게시물 데이터를 추출합니다.

추출할 대상을 선택하신 후 Submit 버튼을 누르시면 step3 부분이 보입니다.

*게시물이라면 SelectBox 안의 항목 선택 Submit 버튼을 눌러주세요


 

3-3 분할 전송

step 3.전체 개수 확인 및 분할 전송

추출 대상의 전체 개수를 보시고 분할하실 개수를 정하실 수 있습니다.

XE3으로 이전하기 위한 .xml 데이터 파일을 다운로드 받습니다.

*Example 
1-2에서 설정한 limit 값에 따라 분할 최대 개수가 정해집니다 
만약 추출 대상 수가 481개고 limit 값이 100이라면  .xml 파일은 총 5개가 생성되어집니다.

* .xml 파일의 크기가 10mb 넘지 않는 것을 권장합니다

사이즈가 10mb 이상일 경우 import 과정에서 에러가 발생할 수 있습니다.

*대상이 많을 경우 적절한 수로 분할하여 추출하시는 것이 좋습니다. 


 

4. Xe3로 데이터 가져오기 

Importer 플러그인을 통해 XE Migration Tool으로 추출한 데이터를 가져올 수 있습니다.

4-1 파일 전송 방법

[권장파일 다운로드 방식

파일명을 로컬에 다운 받은 후 importer를 통해 들여보낼 수 있습니다.

XE3로 이전할 데이터를 모두 다운로드 받으신 후 Importer 매뉴얼을 참고해 주세요

share