Upgrading WordPress
From 워드프레스(WORDPRESS) 한국어 위키
현재 최신 버전인 WordPress Version 2.1 "Ella" 가 2007년 1월 22일에 공개 되었다. 2.1의 새로운 기능들은 Version 2.1 페이지에서 확인 할 수 있으며 500개에 달하는 오류들이 수정되었다. 1.5.X 또는 2.0.X로부터 업그레이드 할 때 자세한 업그레이드 설명 또는 5분만에 업그레이드 하기 를 참고하기 바란다.
주의: 워드프레스 2.1은 PHP 4.2 또는 그 이상, MySQL 4.0 또는 그 이상을 필요로 함. 사용중인 서버가 그 사양 을 만족하지 못할 경우 업그레이드 할 수 없음!
How to Upgrade in Five Steps
좀 더 자세한 설명이 필요하다면 자세한 업그레이드 설명 을 참고한다.
워드프레스 업그레이드는 조금 까다롭긴 하지만 두려워할 정도는 아니다. 아래 설명은 빠르고 간편한 워드프레스 업그레이드에 도움을 줄 것이다. 자칫 잘못하여 사용중인 블로그를 망가트릴 수 있는 요인들을 피해가는 방법 또한 포함되어 있다.
먼저, 워드프레스 자체가 업그레이드 하기 쉬운 프로그램임을 인지하기 바란다. 기본 프로그램에 추가된 플러그인들이나 수정한 기본 파일들을 유지하기 위해서 3단계 대신 5단계가 된 것이다. 일반적인 경우 5분정도가 소요되지만, DB를 백업하고 직접 수정했던 파일들을 백업하는데 있어서의 시간 차이를 가만 할 때 조금 더 많은 시간이 걸릴 수도 있다.
우선 사용중인 블로그의 주소를 http://example.com/wordpress/ 라고 가정한다.
올바른 업그레이드를 위한 과정은 아래와 같다:
Step 1: Backup Database Tables and Files including .htaccess
우선, 워드프레스 관련 DB와, 직접 수정했던 워드프레스 파일들을 백업한다. (.htaccess 포함)
Step 1a: Save Data
phpMyAdmin 이나 호스팅 업체에서 제공하는 프로그램을 이용하여 워드프레스 관련 데이터베이스 테이블을 백업하여 저장한다.
Step 1b: Save Customizations
기본적으로, 워드프레스 기본 설치 이후 추가하였거나 수정한 파일들을 백업 한다. 서버에서 워드프레스를 설치한 폴더에서 FTP 프로그램 을 사용하여 .htaccess 파일을 포함하여 wp-config.php파일, 현재 사용중인 테마(wp-content/themes/), 직접 수정했던 혹은 덮어씌웠던 워드프레스 파일, 필요한 경우 업로드 했던 각종 파일들(wp-content/uploads)을 내려받아 저장해 놓는다.
Step 2: Deactivate Plugins
몇몇 플러그인이 새로 업그레이드된 워드프레스에서 작동하지 않거나 심각한 문제를 일으킬 수 있으므로, 플러그인 관리 화면 (http://example.com/wordpress/wp-admin/plugins.php)에서 모든 플러그인을 비활성화(Deactivate) 시킨다. 이 과정을 지나칠 경우 업그레이드 후 블로그가 제대로 출력되지 않는 문제가 발생할 수 있다.
Step 3: Overwrite Files
워드프레스 최신버전을 내려받아 현재 워드프레스가 설치된 곳에 업로드하여 wp-config.php파일, wp-content폴더를 제외하고 나머지 파일, 폴더들을 모두 덮어씌운다. 중요!!!: 새로운 워드프레스 버전에서 이름이 바뀐 파일들도 더러 존재하므로 예전 파일들을 삭제 한 뒤 새로운 워드프레스 파일을 업로드 할 것을 권장한다. 직접 추가,수정했던 파일들을 이미 백업해 놓았다면 예전 파일들을 삭제한다고 해도 문제가 될 것은 없다.
Step 4: Run the upgrade script
웹브라우저를 통해 업그레이드 페이지( http://example.com/wordpress/wp-admin/upgrade.php )로 이동한 뒤 설명에 따라 업그레이드 과정을 진행한다.
Step 5: Reactivate Plugins one by one
플러그인 관리 화면 으로 이동하여 플러그인을 하나 하나 활성화(Activate)시켜가며 각 플러그인이 제대로 동작하는지를 확인한다. 플러그인이 제대로 동작하고 있는것인지 알기 어렵다면, 이 페이지에 접속하여 어떤 플러그인이 워드프레스 2.1 에서 제대로 작동하는지를 확인 해 보는 방법도 있다. 만약 해당 플러그인이 제대로 작동하지 않는다면 다시 비활성화(Deactivate) 시킨 뒤 해당 플러그인 제작자에게 플러그인을 업그레이드 해 줄 것을 요청하도록 한다. There, that does it.
모든 과정을 진행 한 뒤 예상치 못한 문제가 발생한다면, 백업해 놓았던 데이터베이스와 파일들을 복구시킨 뒤 자세한 업그레이드 설명 을 참고하여 다시한번 과정을 진행한다.
Detailed Instructions
Before You Start
- 데이터베이스를 백업한다.
- .htaccess 파일을 포함한 워드프레스의 모든 파일을 백업한다.
- 백업된 파일들이 정상적으로 사용 가능한지 검사한다.
- 플러그인을 모두 비활성화시킨다.
중요 사항: 위 단계를 거치지 않았다면 업그레이드를 하지 않는다.
Overview of the Upgrade Process
- 데이터베이스를 백업한다. 자세한 설명은 데이타베이스 백업하기를 참고한다.
- 워드프레스의 모든 파일을 백업한다. .htaccess 파일 역시 백업해야 한다.
- 백업 파일의 유효성 확인을 한다. 즉, 백업 파일이 존재하는지, 문제는 없는지 압축을 풀어보는 등의 간단한 테스트를 한다.
- 모든 플러그인을 비활성화한다.
- 앞의 네 과정이 문제없이 끝났음을 확인한다. 앞의 네 과정은 꼭 거쳐야할 단계이다.
- 워드프레스 패키지를 다운로드 받고 압축을 푼다.
- 기존의 워드프레스 파일들을 삭제한다. 하지만 다음의 파일은 절대 삭제하지 않는다.
wp-config.php파일;wp-content폴더; 단!!:wp-content/cache폴더가 존재한다면 삭제해야만 함.wp-images폴더;wp-includes/languages/폴더--한글판 또는 한글 언어파일을 사용중이라면 해당 폴더를 삭제하면 안됨;.htaccess파일--.htaccess파일에 따로 추가한 내용이 있다면 파일을 지우면 안됨;robots.txt파일--robots.txt파일을 사용해서 검색엔진 접속을 관리하고 있다면 해당 파일을 보존;
- 압축을 풀어둔 새로운 파일과 폴더를 현재 워드프레스가 설치된 곳에 업로드 한다.
- 워드프레스 업그레이드 프로그램을 실행하고 화면에 지시하는 대로 업그레이드를 진행 한다.
- 고정주소 설정과 .htaccess 를 업데이트 한다. 고정주소(Permalinks)설정을 업데이트 하고, 이전에 .htaccess파일에 추가한 내용이 있다면 해당 내용이 유지되었는지 확인하고 삭제되었다면 다시 추가한다.
- 업데이트된 플러그인과 테마를 설치한다. 새로운 워드프레스에서 지원하는 플러그인 목록 을 확인하고, 현재 사용중인 테마의 제작자 페이지를 확인해서 새로운 워드프레스 버전을 지원하는지도 확인한다.
- 비활성화시켰던 플러그인들을 다시 활성화(Activate) 시킨다.
- 새로운 워드프레서 변경된 내용을 확인한다.
위 내용은 업그레이드 과정을 간략하게 설명 한 것이다. 자세한 업그레이드 과정을 확인하기 위해 아래 내용을 계속해서 읽어내려가길 바란다.
주목!) 업그레이드 과정 중 문제가 발생한다면 아래내용을 자세히 읽어 확인 하고, 그 과정에서 빠트리거나 잘못 적용 한 부분이 있는지 확인하고, 문제해결: 워드프레스 설치문제 페이지를 확인한다면, 문제의 원인과 해결책을 찾을 수 있을 것이다.
Detailed Upgrade Instructions for 1.5.x and 2.0.x to 2.1
아래 내용은 위에 언급한 업그레이드 진행 과정을 자세히 설명해 놓은 것이다. 우선의 위의 전체적인 과정을 인지 한 뒤 아래의 내용을 읽어보길 바란다.
Step 1: Back up your database
데이터 베이스를 백업한다. Users, Posts, Pages, Links, and Categories 등의 모든 워드프레스 정보는 MySQL 데이터베이스에 저장되어 있다. 데이터베이스 백업하기 페이지를 참고하면 도움이 될 것이다. 업그레이드 전에 데이터베이스를 백업하는것은 아주 중요한 과정이다. 어떠한 이유에서든 업그레이드 후 다시 이전 버전으로 되돌리려면 미리 백업해둔 이전 데이터베이스의 내용이 꼭 필요하게 된다.
Step 2: Back up ALL your WordPress files
FTP 프로그램을 이용하여 현재 설치된 워드프레스 폴더 전체와 .htaccess파일을 백업한다. Telnet 이나 SSH등의 Shell 접속프로그램에 익숙한 사용자라면, 해당 폴더 전체를 압축하여 백업하는 방법이 좀 더 쉽고 빠를 수 있다.
워드프레스 사이트 백업하기 문서에서 더 자세한 내용을 확인 할 수 있다.
워드프레스 원본 파일을 수정했거나, 플러그인이나 테마를 수정했었다면 해당 파일들도 필히 백업해 두어야 한다. 이전 버전의 파일과 폴더들을 백업해 두는 것은 아주 중요한 과정이다. 어떤 이유에서든 다시 이전 버전으로 돌아가려면 백업해 둔 파일들을 다시 업로드 해야 한다. 백업해 두지 않은 상태에서 다시 사용중이던 상태로 되돌리는건 아주 힘든 일이거나 불가능 할 수도 있다.
Step 3: Verify the backups
위 과정에서 백업 해 둔 파일과 폴더들이 사용 가능한지를 확인한다. 이 과정이 업그레이드 과정에서 가장 중요한 부분이라고 해도 과언이 아니다!
확인하는 과정은 간단하다. 백업해둔 폴더안에 확실히 파일들이 존재하는 지와 텍스트 에디터로 파일을 열었을 때 오류없이 파일이 제대로 열리는지를 확인하면 된다. 루트폴더 뿐 아니라 서브폴더 안에도 백업한 파일들이 존재하는지 확인하길 바란다.
만약 압축된 상태로 백업했다면 압축 파일이 제대로 열리는지를 확인하면 된다.
Step 4: Deactivate ALL your Plugins
관리자 화면의 Plugin(플러그인) 패널에 접속하여 활성화된 모든 플러그인들을 비활성화 시킨다. 워드프레스의 새로운 기능으로 인해서 플러그인이 블로그에 치명적인 문제를 안길 수 있으며, 업그레이드 과정에 안좋은 영향을 미칠 수도 있다.
Step 5: Ensure first four steps are completed
위 네가지 과정 중 빠트린 과정이 있다면 업그레이드 진행을 멈추길 바란다. 위 네가지 과정중 하나라도 빠트린 상태에서 업그레이드를 진행하는 것은 아주 위험한 일이다.
위 네가지 과정을 진행 한 뒤에도 문제가 발생한다면 공식 워드프레스 포럼이나 비공식 한국 워드프레스 포럼을 통해 문제 해결을 도모할 수 있다.
Step 6: Download and extract the WordPress package
워드프레스 공식 다운로드 페이지 또는 세이님의 워드프레스 한글판 다운로드 페이지를 통해 새로운 워드프레스 (압축)파일을 다운 받는다.
- 호스팅 서버에 파일과 폴더를 업로드 하는 방식으로 업그레이드를 진행한다면(거의 모든 일반 사용자의 경우), 사용하는 웹브라우저를 이용하여 위 페이지에 접속하여 해당 파일을 다운받은 뒤 적당한 곳에 압축을 푼다.
- shell 접속이 가능한 환경이며, 콘솔 프로그램과 명령어에 익숙한 사용자라면, 워드프레스 패키지 파일을 호스팅 웹 서버에 바로 다운로드 할 수도 있다. 그 방법으로서 wget, lynx 와 같이 FTP 사용을 꺼려하는 사용자들이 자주 사용하는 콘솔 웹 브라우저를 사용하는 방법이 있다. 압축 파일을 현재 워드프레스가 설치된 폴더가 있는곳에 위치시킨 뒤(보통 웹 사이트 루트폴더), gunzip -c wordpress-2.1.tar.gz | tar -xf - 또는 tar -xzvf latest.tar.gz 명령어를 이용해서 압축을 푼다. 압축이 풀린 새로운 파일들은 wordpress라는 폴더에 위치하게 된다. 다른이름의 폴더에 워드프레스를 설치해서 사용중이라면 새로운 파일들을 현재 설치폴더로 옮겨주어야 한다.
- shell접속을 이용한 또다른 방법은 FTP사용을 함께 하는 방법이 있다.
- 다운 받은 파일의 압축을 풀어 wordpress라는 폴더 안의 모든 내용을 적당한 이름(예: wordpress.zip)으로 한번에 zip 형식으로 압축한다.
- 새로 압축한 파일을 FTP 프로그램을 이용하여 현재 워드프레스가 설치된 폴더 안에(wp-config.php 파일이 존재하는 폴더) 업로드 한다.
Step 7: Delete the old WordPress files
왜 기존 파일들을 삭제하지? :: 삭제하지 않고 그냥 덮어 씌우는 경우 덮어씌우는 과정에서 파일에 오류가 발생 할 수도 있으며, 더이상 필요하지 않은 파일들이 계속 유지되어 예상치 못한 문제를 일으키는 경우가 있다.
삭제해서는 안되는 파일과 폴더들:
wp-config.php파일;wp-content폴더;wp-images폴더;wp-includes/languages/폴더--if you are using a language file, do not delete this folder;..htaccessfile--if you have added custom rules to your.htaccess, do not delete it;- 워드프레스 원본 파일을 수정했거나, 플러그인이나 테마를 수정했었다면 해당 파일들도 미리 백업 해 둔 뒤 삭제해야 한다.
삭제할 파일과 폴더들:
- 위에서 언급한 파일 폴더를 제외한
wp- 로시작하는 모든 파일들, readme.html, wp.php, xmlrpc.php, 그리고 license.txt;파일; 워드프레스 루트 폴더에 위치한 파일들이다. 다시 언급하지만,wp-config.php파일은 지워서는 안된다! wp-admin폴더;wp-includes폴더; 한글 언어팩을 사용중이라면wp-includes/languages폴더는 지우면 안된다.wp-content/cache폴더; 해당 폴더가 존재하지 않을 수도 있다.
어떻게 지우지? 파일과 폴더를 삭제하는 데는 몇가지 방법이 있다. FTP 프로그램을 이용하는 방법이 있고, Telnet이나 Shell 접속프로그램을 이용해서 삭제 할 수도 있다.
- FTP 프로그램을 이용해서 삭제하기
- 파일을 업로드 할 때 사용한 FTP 프로그램을 사용해서 파일과 폴더를 삭제하면 된다. 삭제 과정중 "비어있지 않은 폴더(non-empty folder)를 삭제 할 수 없다"는 식의 오류를 내며 삭제에 실패한다면, FTP 프로그램의 설정 화면을 찾아보면 관련 내용을 확인 할 수 있을 것이다. 비어있지 않은 폴더를 삭제할 수 있도록 설정을 바꾼뒤, 삭제할 파일, 폴더들을 삭제하고서 다시 설정을 원래대로 돌리면 된다.
- Telnet 이나 SSH 이용하기
- telnet 또는 ssh 를 통해 사이트에 로그인 할 수 있고, 아래 설명된 명령어들을 실행 할 권한을 가지고 있다면 몇가지 명령어를 통해 쉽게 파일들을 백업하고 삭제 할 수 있다. 아래 포함된 파일들 외에도 직접 수정해서 사용중인 파일들이 있다면 (예: index.php) 아래 과정에 포함시켜서 같이 백업한다:
-
mkdir backup -
cp wp-config.php .htaccess backup -
cp -R wp-content backup -
rm wp*.php .htaccess license.txt readme.html xmlrpc.php -
rm -rf wp-admin wp-includes -
cp backup/wp-config.php . - 나중에 업그레이드 과정이 끝난 뒤에, 이 과정에서 백업해 두었던 파일들을 다시 되돌릴 수 있다. 예를 들어 백업해둔 index.php 파일을 다시 되돌리려면 '
cp backup/index.php .' 명령을 이용하면 된다.
-
- Alternatively, using SSH, you could copy
wp-config.php, .htaccess, and any content files you've added or altered into the new wordpress directory. Then, rename the old one (to archive it), and move the new one into its place.
Step 8: Upload the new files
다운로드 과정 에서 따른 방법에 따라 몇가지 방법이 나뉘어 진다.
- FTP 프로그램 이용: 처음 설치했을 때와 마찬가지로 FTP프로그램을 이용하여 압축을 풀어놓은 파일과 폴더들을 업로드 한다. FileZilla 사용하기 와 웹 서버에 워드프레스 업로드하기 문서를 참고하면 도움이 될 것이다.
- Shell 프로그램을 이용했을 경우: 압축을 풀어놓았던 폴더(wordpress) 에서 현재 워드프레스가 설치된 폴더로 파일과 폴더들을 옮기면 된다.
- Shell 과 FTP를 같이 이용한 경우: 워드프레스가 설치된 폴더에 업로드 해 둔 압축파일(wordpress.zip)의 압축을 'unzip -o wordpress.zip' 명령을 이용하여 풀어주면 된다.
주의: wp-content 폴더를 삭제하지 않았었다면, 업로드 과정에서 덮어씌울지를 물어보는 확인창을 보게 될 것이다.
- 새로 업로드하는
wp-content폴더에는 기본 테마, 클래식 테마, 워드프레스 기본 플러그인 들만이 포함되어 있으므로 덮어씌운다고 해도 문제 될 것이 없이, 기본 테마들과 플러그인들만이 새로운 파일로 교체되어 업데이트 될 것이다. 그러므로 안심하고 "덮어씌우기" 해도 된다. 단!! 기본테마를 수정해서 사용하고 있었다면, 위의 백업과정에서 기본테마 폴더를 백업해 두었어야 한다.(위의 처음 4가지 과정을 따랐다면 문제 없을 것이다.) 업그레이드 진행 이후 새로운 기본테마에서 변경된 내용을 확인 한 뒤 직접 수정했던 내용들을 적용하면 된다.
Step 9: Run the WordPress upgrade program
wp-admin/upgrade.php에 웹브라우저를 통해 접속하는 방법으로 업그레이드 프로그램을 실행한다. 자신에게 맞는 접속 주소는 아래 내용을 참고한다.
- 웹사이트 루트에 워드프레스를 설치했을 경우 : http://example.com/wp-admin/upgrade.php
- 'blog' 와 같은 특정 폴더에 워드프레스를 설치한 경우 : http://example.com/blog/wp-admin/upgrade.php
Step 10: Update Permalinks and .htaccess
관리자화면의 Options->Permalinks 패널에서 고정주소(Permalink Structure) 설정을 업데이트하고, 필요하다면 .htaccess 파일에 새로운 내용을 추가한다. 고정주소(Permalinks)와 .htaccess에 대한 자세한 사항은 Using Permalinks 페이지를 참고한다.
Step 11: Install updated Plugins and Themes
우선 2.0에서 작동하는 플러그인 목록을 확인한다. 새로운 버전의 테마나 플러그인을 설치해야만 하는 경우가 있다. 이 경우 플러그인 또는 테마의 제작자 홈페이지를 방문하여 새로운 버전이 있는지를 확인하고, 새로운 버전이 없을 경우 최근 버전의 워드프레스에서 플러그인이나 테마가 잘 작동하는지를 문의해 본다.
Step 12: Reactivate Plugins
관리자화면의 Plugins 패널에 접속하여 비활성화(de-activate)시켰던 플러그인들을 다시 활성화(activate) 시킨다.
만약 새로 추가된 'Wordpress Database Backup Plugin'을 사용한다면 wp-content폴더의 권한을 쓸 수 있도록 바꾸어 줘야만 한다(mode 666 혹은 777). 권한 변경에 대해서는 파일 권한 변경 페이지를 참고.
Step 13: Review what has changed in WordPress
아래의 페이지를 확인하여 최신 워드프레스의 새로운 점들을 확인함:
Troubleshooting
- 레이아웃 깨짐, 오류문구
- 업그레이드 후 블로그의 레이아웃이 깨져버리거나 오류문구가 출력된다면, 이전에 사용하던 플러그인이 최신 워드프레스에서 문제를 일으키는 것이다. 워드프레스 관리자 패널에서 워드프레스에 기본 탑재된 플러그인을 제외한 모든 플러그인을 비활성화(deactivate) 시킨 뒤 하나 하나 활성화(activate)시켜 가면서 어떤 플러그인에서 문제를 일으키는지 확인한다.
- 직접 수정한 워드프레스 파일들
- 여러가지 문제 해결 또는 편의를 위하여 워드프레스 기본 파일을 직접 수정했을 경우, 그 수정 내용을 잘 숙지하고 있어야 한다. 매번 새로운 워드프레스 버전으로 업그레이드 할 때마다 새로운 파일에 그 내용을 적용시켜줘야 한다.
- 이전 버전의 템플릿 함수
- 새로운 버전에서는 최신의 최적화된 코드를 포함하고 있다. 이전 버전에 적용된 코드 또는 함수를 계속 사용 할 경우 대부분 오류를 발생시키거나 또 다른 문제를 일으키게 된다. 물론, 이전 코드 또는 함수를 사용하여도 겉으로 문제가 없이 유지 될 수도 있지만, 추후 오류가 발생할 확률이 그만큼 높아지게 되는 것이며 이에 대한 원인을 찾기도 난감해 질 수 있다.
- 이전 버전으로 돌아가기
- 심각한 문제가 발생하였거나 여타 다른 이유로 이전 버전으로 다시 돌아 갈 수 있지만 그다지 권장하고 싶지는 않다. 그 이유로서 가장 큰 것은 최신 버전에는 보안문제의 패치를 포함하고 있는 경우가 많아서 이전 버전을 계속 사용 할 경우 사이트가 보안상의 위험에 노출 될 가능성이 높기 때문이다. 만약 업그레이드 전에 워드프레스 파일들과 DB 테이블들을 백업해 놓지 않았다면, 이전 버전으로 안전하게 복귀하는 것은 거의 불가능한 것이라고 봐야한다. 백업된 DB파일 없이 워드프레스 파일들만을 되돌리게 된다면, 업그레이드 과정에서 변경된 DB구조나 설정값들 때문에 블로그 자체가 망가져 버릴지도 모른다. 업그레이드 할 때와 마찬가지로 wp-config.php 와 기타 유지해야 할 파일들을 제외하고 모든 파일들을 삭제한다. 백업해 두었던 이전 워드프레스 파일들을 업로드하고, 백업해 두었던 워드프레스 DB를 복원하면 된다. 백업하는 과정에서 백업된 파일들이 잘못 된 것들이 아닌지 확인 해 보지 않았었다면, 복원 후에 이전의 모습 그대로가 되지는 않을 수도 있다. 백업 후에는 꼭 파일 확인을 하자.
- 다른 오류 대처법
- 업그레이드 과정을 진행하는 동안 어떠한 오류가 발생하였다면, 오류대처: 일반적인 설치과정의 문제, 일반적인 오류대처 그리고, 설치에 관련된 문서들을 참고하기 바란다. 위 문서들에서 해결법을 찾지 못했다면, 워드프레스 공식포럼(영문) 또는 비공식 한국 워드프레스 포럼에 질문을 등록해서 다른 사용자들에게 도움을 요청 할 수 도 있다.
Old Upgrade Information
워드프레스 1.2 버전에서 2.0 이후의 버전으로 업그레이드 하려면, 우선 1.2에서 1.5로 업그레이드 페이지의 설명에 따라 1.5 버전으로 업그레이드 한 뒤, 2.0 이후의 버전으로 업그레이드 하면 된다.

