Migration
Help
목차 |
태터툴즈 업데이트
태터툴즈 1.1.x 에서 텍스트큐브 1.7 로의 업데이트
태터툴즈에서 바로 덮어 씌우는 방식으로 업그레이드 후 블로그 화면이 정상적으로 보이지 않고 기본 스킨이 보이는 등의 문제가 있을 수 있습니다. checkup을 하지 않은 경우 정상적인 상황이므로 당황하지 마시고 블로그 주소 끝에 /checkup을 입력하여 강제 checkup을 실행해 주시기 바랍니다. 테이블 구조 변경 후 정상적인 화면이 나타날 것입니다.
텍스트큐브 1.7의 경우 태터툴즈 1.1 버전과 외양은 비슷하지만 코드와 데이터베이스 구조부터 동작 방법까지 내부적으로 굉장히 많은 변화가 있었습니다. 따라서 꼭 이 점을 유의해 주세요. 데이터베이스의 구조를 상당히 많이 바꾸기 때문에 텍스트큐브로 업그레이드 한 후 태터툴즈 1.1.3으로 돌아가는 것은 불가능합니다. 태터툴즈 0.9x, 클래식 사용자 분들은 이 문서 하단의 도움말을 참고하셔서 텍스트큐브 1.7 설치후 마이그레이션 데이터를 복원하시면 됩니다.
- 텍스트큐브 업그레이드 시 주의 사항을 확인합니다.
- 태터툴즈 관리자, 환경 설정 - 데이터 관리 메뉴에서 "데이터 교정" 후 "데이터를 백업합니다" 를 통해서 태터툴즈의 데이터를 백업해둡니다.
- 태터툴즈 관리자, 플러그인 - 플러그인 목록 메뉴에서 사용중인 모든 플러그인을 비활성화 합니다.
- 텍스트큐브 1.7 를 태터툴즈가 설치된 폴더에 덮어씁니다. (텍스트큐브를 덮어쓰기 이전에 태터툴즈가 설치된 경로의 blog, component, image, language, lib, script, style 폴더를 삭제하셔도 됩니다.)
- 업그레이드 후 변경된 자바스크립트 파일 및 스타일 시트로 갱신하기 위하여 웹브라우저의 캐시를 삭제합니다.
- 텍스트큐브로 업데이트한 블로그, http://블로그주소/checkup 으로 접속하여, DB 구조 업데이트 과정을 진행합니다.
- 텍스트큐브로의 업데이트 과정이 완료되었습니다.
- 텍스트큐브 관리자로 접속하여, 환경 설정 - 데이터 관리 메뉴에서 "데이터 교정", "데이터베이스 최적화" 과정을 진행합니다.
- 플러그인 - 플러그인 목록에서 사용중이었던 플러그인을 활성화 합니다.
참고 사항
- 서버에 따라 mod_url에서 한글url을 처리하는 경우 충돌이 일어날 수 있다. 다음의 세 줄을 .htaccess의 가장 앞 줄에 추가한다.
<IfModule mod_url.c>
CheckURL Off
</IfModule>
이 경우 mod_url을 사용하지만 CheckURL 명령이 없거나 권한이 주어지지 않은 특이한 서버에서는 에러가 발생하는 것이 보고되어 있다.
갈아타기에 앞서 읽어보세요
본 갈아타기 부분은, 태터툴즈 1.0 이하의 사용자 분들께 다양한 스킨과 기능 그리고 지속적인 추가 지원을 받을수 있게끔 1.0으로 업그레이드를 안내하는 부분입니다. '본 갈아타기 부분은 태터툴즈 1.0이 배포되는 시점에서 작성된 글입니다. 이에 갈아타기를 도와주는 변환파일역시 해당 시점에서 제작되었습니다.' 이에 최신버전으로 바로 갈아타기를 작업시 예기치 못한 오류가 발생할 수 있으므로 다소 불편하시더라도 안내하는 버전을 거쳐 갈아타기를 진행하시길 권장합니다.
버전별 다운로드
다운로드란을 통해서 다운받을 수 있습니다.
태터툴즈의 백업, 복원 방식
다소 복잡한 내용일 수 있으니 넘어가셔도 됩니다. :D
- 태터툴즈의 백업방식.
- 태터툴즈 1.0 부터는 더이상 sql dump 방식을 사용하지 않고 XML 문서의 형태로 백업을 합니다. 태터툴즈가 가지고 있는 모든 정보가 XML 의 형태로 백업되게 되며, 괄목할만한 개선점으로는 [첨부파일]까지도 백업이 된다는 것입니다. 이제 첨부파일과 DB 를 따로따로 백업을 하실 필요가 없습니다. 태터백업 하나면 한번에 모든 백업을 끝내실 수 있습니다.
- 태터툴즈 백업파일의 XML 문서양식은 당연히 구조가 완전히 공개되어 있습니다. 다른 블로깅툴이나 보드, CMS 등에서 이전을 원하시는 경우, 태터툴즈 백업XML 양식에 맞게 migrate 를 하시면 ( 물론 개발이 필요합니다ㅠ.ㅠ ) 어디서든 태터툴즈로의 이전을 편하게 하실 수 있습니다. 아울러, 거꾸로의 절차로 간단합니다. 원하시는 어떠한 형태로도 migrate 가 가능해지기 때문에, 용이한 백업과 더불어, 별도의 블로깅툴, CMS 로의 이전이 자유롭습니다. 추후 플러그인의 형태로 이러한 변환툴들이 개발되어질 것이라 예상됩니다. ( 물론 태터&컴퍼니가 할수 있는 범위의 일은 아닙니다. )
- 태터툴즈의 복원 방식.
- 태터툴즈 백업 XML 파일을 불러오시기만 하면 됩니다. 그럼 태터툴즈가 알아서 복원을 끝냅니다. 여러개의 0.96 블로그를 하나 다중사용자 1.0으로 통합하고 싶으신 경우에도 전혀 문제가 없습니다. 백업을 하신후에, 사용자별로 적절하게 import 하시기만 하면 모든 절차가 완료됩니다. 아울러, 1.0 들끼리도 자유로운 이전을 가능하게 합니다. 단일사용자/다중사용자 다양하게 환경을 바꾸시고, 호스팅을 이사다니시더라도 백업기능 하나로 간단한 이사를 가능하게 합니다. 또한 마이그레이션 과정중에 SYNC 되어있던 글까지, 다시 eolin 으로 싱크를 자동 복원합니다.
0.96RC이하 사용자를 위한 준비과정
안내
0.96RC 이하의 DB는 지원하지 않으므로, 0.96이나 클래식버전으로 갈아타신 후 진행
0.9, 0.91, 0.92, 0.93, 0.94, 0.95, 0.951, 0.96RC 버전에서 클래식(0.97)로 갈아타기
태터 툴즈 클래식 파일을 모두 덮고 사이트에 접속하면 로그인 화면이 나옵니다. 그 화면에서 패스워드를 입력하면 클래식 업데이트 화면이 나오고 그대로 실행하시면 자동으로 진행됩니다. 만약 클래식 업데이트 화면이 뜨지 않는다면 직접 http://자신의블로그설치주소/admin/migration.php 를 실행해 주세요. 만약 업데이트에 실패한다면 0.9*대 버전을 다시 덮어씌우기만하면 간편하게 원복이 됩니다.
클래식(0.97) RC1,2 버전에서 클래식(0.97)로 갈아타기
백업을 먼저 실행해 주십시오. 그 다음 태터 툴즈 클래식 오피셜 릴리즈 파일을 모두 덮으면 자동으로 업그레이드됩니다. 만약 업데이트에 실패한다면 다른 경로로 새로 설치해 보시고 백업 파일을 써서 원상복구해 보시기 바랍니다.
클래식(0.97) RC 3 버전에서 클래식(0.97)로 갈아타기
태터 툴즈 오피셜 릴리즈 파일을 그대로 덮어 주세요. 데이터 변환 작업이 없기 때문에 그 관련의 오류는 생기지 않습니다
0.96, 클래식(0.971) 사용자 갈아타기 방법
안내
서론의 설명처럼 태터툴즈 최신버전으로 바로 갈아타기시 예기치 못한 오류가 발생할 수 있으니 우선 1.0.2로 갈아타기를 권장합니다. 그후 최신버전인 1.0.6.1('06-08-23일 현재)로 덮어씌우시면 최신버전으로 업그레이드가 가능합니다.
0.96x, 0.97.1(클래식)에서 1.0.2로 갈아타기
우선 migrator.php를 다운 받으세요. 다운로드
- 진행방법
- 1. 위의 migrator.php 다운로드
- 2. 0.96x 나 클래식이 설치되어있는 계정의 admin폴더 아래에 설치후 실행 (ex. http://blog_주소/admin/migrator.php) migrator 가 지시하는데로 따라하시면, Tattertools-Migration-20060318.xml 과 같은 백업파일을 다운로드 하실 수 있습니다.
- 3. 이전버전의 태터툴즈가 설치되어있는 폴더에 덮어씌우지 마시고 새로운 폴더를 만들어 1.0을 업로드후 설치과정을 거칩니다.(복구완료후 1.0의 폴더명을 이전버전의 폴더명으로 변경할수 있습니다. 1.0으로 이전중에 발생할수 있는 오류로 인하여 불가피하게 이전버전을 복구해야할 상황에 대처하기 위함입니다. 이런 상황에 대처할수 있으시다면 직접 덮어씌우셔도 되나 불필요한 파일이 잔재가 남을수 있으니 그리 권장하진 않습니다.
- 4. 백업 파일을 1.0.2 의 환경설정->데이터를 관리합니다.->Import 메뉴에서 불러오시면 됩니다. 호스팅에서 제공하는 용량제한 때문에, 업로드가 불가능하신 분들은 URL 불러오기를 통해서 불러오시는 방법을 사용하시기 바랍니다.
이 계정의 업로드 허용용량은 20M 입니다. 는 계정마다 다를수 있습니다. 허용용량을 초과할경우 수동으로 FTP를 이용하여 직접 파일을 올린 후 진행하셔야합니다.
0.96RC 이하에서 1.0.2로 갈아타기
우선 migrator.php를 다운 받으세요. 다운로드
- 진행방법
- 1. 0.96RC 이하의 DB는 지원하지 않으므로, 0.96이나 클래식버전으로 갈아타신 후 진행(갈아타는 방법과 다운로드는 윗 부분 참고)
- 2. 위의 migrator.php 다운로드
- 3. '0.96x, 0.97.1(클래식)에서 1.0.2로 갈아타기' 와 동일한 절차
갈아타기에서 발생하는 잦은 오류 알림
알려진 오류 목록
복구파일은 태터툴즈1.0이 설치된폴더/cache/migrator/ 폴더안에 1.xml의 형태로 저장이 된후 해당 파일을 읽어들여 복구를 진행하게 됩니다. 따라서, 계정의 잔량이 부족하거나, 혹은 업로드 방식으로 진행할 경우 '허용업로드용량'을 초과할 때 복구가 진행되지 않는 경우도 있으니 계정의 잔량이나 허용업로드용량을 확인하여주시기 바랍니다.
- 주의사항
- 1. 마이그레이터 PHP 파일의 이름이 migrator.php임에 주의하십시오.
- 2. 마이그레이터 자체의 실행은 0.96x 와 클래식의 원본데이터에 전혀 변화를 가하지 않습니다.
- 3. 마이그레이션이 완료된 후에 0.96x와 클래식과 관련된 DB 와 설치파일들을 삭제하시기 바랍니다. 이 과정에 대한 확실한 이해가 없으시다면, 그대로 놔두셔도 무방합니다
- 4. migrator.php를 이용하여 백업파일 생성후 이전 버전의 태터툴즈 설치폴더에 1.0 파일을 덮어씌우시지 마시고 새로운 폴더를 만들어 1.0 파일을 업로드후 설치를 권장합니다. 정상적으로 1.0에서 복구가 완료된 후에 원하는 폴더명으로 변경할 수 있습니다.
- 태터툴즈 클래식(0.9x)폴더에 1.0 파일을 덮어씌워버렸어요. 어떡해야하죠?
- 1. 이의 진행방법은 불가피 하게 이전버전을 다시 복구해야하는 목적을 중시하므로 덮어씌워지는 과정에 있어서 불필요한 파일의 잔재가 남을수 있습니다.
- 2. 특별히 DB를 따로 건들이지 않았다면 태터툴즈 파일만 다시 설치하시면 이전의 DB를 불러올수 있습니다. (첨부파일까지 복구가 가능하지만 예기치 못한 오류로 복구가 되지 않을수 있습니다.)
- 3. 덮어씌운 그 상태 그대로 이전 버전의 태터툴즈를 다시 한번 덮어씌웁니다.
- 4. setup.php를 진행하여 새롭게 설치를 합니다. 정상적으로 태터툴즈의 DB를 건들이지 않았다면 이과정에서 이전에 사용하는 DB식별자로는 설치가 불가능해야 정상입니다. 다른 DB식별자를 넣어 설치합니다.
- 5. 설치 완료후 태터툴즈의 폴더안에 config.php를 열어 아래 부분을 원래의 복구할 DB식별자로 변경해줍니다.
<? $host = "localhost"; $db = "db명"; $user = "db_id"; $pass = "db_pass"; $dbid = "tts"; //이 부분을 복구할 dB식별자로 변경해줍니다. ?>
1.0이 설치된 폴더,도메인 변경 방법
- 태터툴즈1.0이 설치된 폴더 안에 config.php를 열어,
$service['domain'] = 'blog.2pink.net'; //태터툴즈가 설치된 도메인 $service['path'] = '/kiss'; //태터툴즈가 설치된 폴더
이 부분에서
$service['path'] = '/kiss'; 를 원하는 폴더로 변경하시면 됩니다.
폴더를 만들지 않고 루트 ./ 에 설치한 경우에는..
$service['domain'] = 'blog.2pink.net'; $service['path'] = ;
와 같이 설정하시면 됩니다.
- 이후.. .htaccess 파일을 열어 (.htaccess은 숨겨진 파일입니다. FTP옵션에서 숨김파일 보기 옵션을 on 하셔야 보입니다.)
RewriteEngine On RewriteBase /blog/
RewriteBase /태터툴즈가 설치된 폴더/ 를 RewriteBase /변경할 폴더/ 로 변경해주세요
- 2차 도메인의 루트 ./ 에 설치된 상태에서 2차도메인명이 변경될경우.
http://abc.2pink.net 에서 http://efg.2pink.net 으로 변경될경우
RewriteEngine On RewriteBase /
는 수정하지 않아도 됩니다.
- 도메인 변경시엔
$service['domain'] = 'blog.2pink.net';
를 변경하시면 됩니다.
