I. 서설
XE는 기본적으로 1.1.5 버전인가부터 이전에 사용하던 zbxe 폴더 대신 xe 폴더를 기본 폴더로 하여 설치하도록 되어 있습니다.
그런데, 많은 분들이 http://도메인/xe 의 모습이 거추장스럽다거나 그 외 여러가지 이유로 루트로 설치하고싶어 합니다.
즉, XpressEngine 사이트 처럼, 도메인으로 접속하면 xe 폴더가 아닌 루트에서 바로 사이트가 열리게끔 하고 싶어 한다는 거죠.
저 역시 과거에는 XE가 설치된 폴더의 이름이 xe 인것이 싫어, home 등과 같은 이름으로 변경하여 설치하곤 했었습니다.
그때는 프레임을 두개로 나누어 밑에는 BGM을 깔아 사용하던 때였기 때문에 그 방법이 크게 불편하지는 않았습니다.
그러나 혹시 모를 저작권 문제에 대응하이 위하여 BGM 프레임을 제거하게 되었고, 그렇게 되자 더이상 프레임을 나눌필요도 없었으며, XE폴더를 따로 둘 필요도 없게 되었습니다.
그래서 XE를 루트로 옮기는 시도를 하게 되었습니다.
평소에 많은 분들께서 "XE지식인" 폴더에 질문을 하고, 또 많은 분들께서 "XE팁 공유" 게시판에 그 해답을 올려주시더군요.
그 해결방법의 대부분이 .htaccess 파일을 수정하여, 브라우저상에서 XE 폴더로 직접 이동하게끔 하는 방식이었습니다.
(예컨대, http://www.xpressengine.com/18187820 문서)
그러나, 그 방법 보다는 XE 폴더를 물리적으로 루트로 옮기는 것도 되지 않을까 하여
여러번의 시도 끝에 발생하는 문제점들을 해결하면서 거의 완벽하게 루트로 이동시킬수 있었습니다.
제가 겪었던 문제는 크게 많지는 않으나, 해당 부분은 문서 하단부분에 따로 정리해 두겠으니,
참고하시기 바랍니다.
II. 루트로 이동하기 전, 알아두어야 할 주의 사항
( 해결할 수 있는 문제점들입니다 )
※ 아래의 문제들은 제가 직접 경험했던 부분들입니다. 이 문제들의 해결방법은 본 문서의 IV. 항목에서 다룰것입니다.
1. 폴더들의 권한문제가 발생할 수 있습니다. 특히 files 폴더의 권한이 변경될 수 있습니다.
2. 관리자모드 -> liveXE 에서 "등록된 RSS 글 수집" 버튼을 눌렀을 때, php 오류가 발생할 있습니다.
3. 파일첨부가 되지 않을 수 있습니다.
4. XE와 관련된 폴더 외에, 원래 있었던 다른 폴더 (예컨대, images 등) 들로 접속하면 XE의 기본시작모듈이 뜰 수 있습니다.
5. 리라이트모드가 해제되지 않을 수 있습니다.
6. XE를 루트로 옮겼는데, 관리자모드로 접속하거나 홈페이지의 메뉴들을 클릭하면, 옮기기 전의 주소로 접속될 수 있습니다.
7. FTP 정보를 입력해 두고 쉬운설치를 이용하시던 분들은, 관리자모드 -> settings 에서 FTP 절대경로를 새로 지정해주어야 합니다.
8. 페이지 수정을 눌렀을때, 에러페이지가 뜰 수 있습니다.
9. XE의 주요기능들은 대부분 .htaccess 파일과 관련이 크기 때문에, 이 파일의 변형과 이동, 삭제에 유의하세요.
III. XE 폴더를 루트로 이동시키는 과정
1. XE 폴더를 루트로 이동하기 전, 반드시 계정과 DB들을 백업하세요. [필수]
- 백업을 할 때에는 FTP 로 직접 다운받아두는 것은 도움이 되지 않습니다.
첨부파일과 폴더, 파일의 권한 등이 모두 망가지기 때문입니다. 특히 한글명으로 된 이미지 파일들은
모조리 깨질 수가 있습니다. (이 문제는 리눅스 서버를 이용중일때만 발생합니다)
- 따라서 백업을 할 때에는 SSH 명령어 (tar cvfpz 명령어) 를 통하여 백업하셔야 하며,
- SSH 가 지원되지 않는 환경일 경우, 서버관리자에게 백업을 요청하셔야 합니다.
- 계정의 백업 방법은 http://mylostworld.co.kr/14831 문서를 이용하시거나,
http://elogin.co.kr/eboard/view.php?&bbs_id=faq&page=&doc_num=92 문서를 참고하세요.
1-1 (추가). 기본URL 을 빈칸으로 설정하세요. [필수] (이 과정 이후 10번 과정도 반드시 이행해야 합니다.)
- 기본URL 이 설정되어 있어, 서버이전 후에 관리자모드에 제대로 접속이 되지 않는 등의 문제가 생길 수 있습니다.
- 따라서, 관리자모드 -> settings 에서 "기본URL" 부분이 설정되어 있으면
빈칸으로 두고 저장하세요.
2. 이용량이 많은 사이트라면,
업데이트 도중에 외부의 접속을 막기 위해,
첫화면을 XE 와 관계없는 html 페이지를 임시로 만들어, 최초 접속시 해당 페이지가 나오도록 하세요.
(공사중, 업데이트 중, 등등의 안내 페이지) [필수]
3. xe -> files 폴더 안에 있는 cache 폴더를 전체 삭제 하세요. [필수]
- cache 폴더 안의 내용만 지우지 말고 cache 전체를 지우세요.
- cache 폴더의 삭제가 되지 않는 경우 http://mylostworld.co.kr/12969 문서의 4번을 참고하시기 바랍니다.
- cache 폴더를 삭제하였다 하더라도, 어떤 사람이들 사이트로의 접속을 시도할 경우 바로 cache 폴더가 다시 생성됩니다.
그렇기 때문에 2번 과정을 반드시 이행하셔야 합니다.
4. FTP클라이언트 설정에서 "숨김파일 강제표시" 를 반드시 체크하세요. FTP프로그램은 파일질라를 이용하세요. [필수]
5. 루트 폴더에 만일 .htaccess 파일과 index.php 파일이 존재하고 있다면, 해당 파일을 먼저 컴퓨터에 받아두세요. [필수]
- 만일, 루트에 .htaccess 파일이 있었던 분들은, 그 파일의 내용들을 XE 폴더 안에 있는 .htaccess 파일의 상단에
그대로 입력해 주셔야 합니다. [필수]
6. XE 폴더 안의 파일과 폴더들을 모두 루트로 이동시키세요.
- XE 폴더로 이동한 후, Ctrl+A 를 누르면 전체선택이 됩니다. 그 상태에서 루트로 드래그 하면 이동이 됩니다.
- 아래 참고 이미지컷에서는 html 이라고 되어 있지만, html 외에 각 계정에 따라, www / html / public_html / 등으로 나타날 수 있습니다.
- 루트가 뭔지 모르겠다.. 라고 하시는 분들은, 전체 선택한 후, addons 폴더 위에 " .. " 라고 되어 있는 부분으로 드래그 하면 됩니다.
7. 폴더 권한 변경 [필수] [중요]
files 폴더의 권한을 707 혹은 777 로 설정해 주세요.
폴더 권한을 변경할 때에는 "모든하위폴더와 파일들에 적용" 옵션을 이용하시는게 좋습니다.
SSH나 텔넷에서 이용할 때에는
cd 명령어로 루트까지 이동하신 다음
chmod -R 777 files/
라고 입력해 주면 됩니다.
8. 사이트 접속 확인
2번과정에서 만든 임시페이지를 제거하고 사이트 접속을 시도해보세요. 정상접속이 되는지 확인하세요.
(아마 사이트의 메뉴들은 아직 안뜰겁니다.)
9. 캐쉬파일 재생성
사이트가 정상적으로 작동한다면, 관리자모드 로 접속해서 캐쉬파일 재생성을 눌러주세요.
10. 기본URL 재설정 [필수] [중요]
관리자모드 -> 우측상단 settings 로 들어가, 1-1 과정에서 빈칸으로 해 두었던 기본URL 을
새로 이동한 경로대로 작성해 주십시오.
http://도메인/xe 가 원래 값이었다면, http://도메인/ 으로 바꿔주면 되겠지요.
기본URL 을 재설정 해주어야 게시판 등의 주소들이 새로 바뀐 주소들로 자동으로 바뀌어 적용됩니다.
IV. 폴더 이동 후 발생하는 문제점과 그 대응책
1. 폴더들의 권한문제가 발생할 수 있습니다. 특히 files 폴더의 권한이 변경될 수 있습니다.
- XE와 관련된 폴더들, 특히 files 폴더의 권한을 "하위폴더포함" 옵션을 선택하여 707 또는 777 권한을 부여하세요.
- files 포더는 첨부한 chmod.php 파일을 다운받아 루트에 올린 후,
브라우저에서 http://도메인/chmod.php 를 입력하여 접속하였을때,
OK 가 뜨면 정상적으로 권한이 변경될 것입니다.
2. 관리자모드 -> liveXE 에서 "등록된 RSS 글 수집" 버튼을 눌렀을 때, php 오류가 발생합니다.
- livexe.controller.php 파일이 잘못되었다는 오류문구를 내보낼 수 있습니다.
- 이 때에는, XE폴더를 루트로 옮긴 방법의 반대방법으로 다시 원래대로 xe 폴더로 집어 넣은후,
관리자모드 -> liveXE -> 등록된 RSS 글 수집 버튼을 눌러 정상작동하는 지 확인 한 후,
- 다시 루트로 옮겨 오면 됩니다.
3. 파일첨부가 되지 않습니다.
- 권한의 문제가 가장 큽니다. IV - 1 문항을 참고하여 해결해보세요.
- 그래도 되지 않는다면 http://www.xpressengine.com/18308524 문서의 7번 문항을 참고하세요.
4. XE와 관련된 폴더 외에, 원래 있었던 다른 폴더 (예컨대, images 등) 들로 접속하면
XE의 기본시작모듈로 접속되면서 해당 폴더로 접근할 수 없습니다.
리라이트모드 를 해제하시면 XE를 루트에 설치하고도 일반 폴더로의 접근이 정상으로 됩니다.
만일 관리자모드에서 리라이트모드가 해제되지 않는다면,
루트에 있는 .htaccess 파일을 열어 RewriteEngine On 문구를 RewriteEngine Off 로 변경하면 되구요.
만일, XE는 리라이트모드를 그대로 사용해야겠고,
일반폴더도 사용해야겠으면 다음의 방법을 이용해도 됩니다.
접근하려는 일반폴더의 이름이 만일 images 폴더라 한다면,
해당 폴더에 .htaccess 가 존재하는지 확인하세요.
만일 존재하지 않는다면,
.htaccess 파일을 다운받아 images 폴더에 올리세요.
( 다운받으면 아마 .htaccess[1] 로 저장이 될겁니다. 그대로 FTP를 이용하여 계정에 올린 후, 이름수정을 통해 [1] 을 지워주세요. )
만일 위 파일이 있다면
덮어씌우지 마시고, 그 파일을 열어
RewriteEngine Off
문구를 추가하여 저장하세요.
1.3.1.2 버전 이후로 XE의 리라이트모듈이 바뀌어 일반 폴더로의 접근도 이제는 잘 됩니다.
최신버전의 XE를 이용한다면 위의 과정을 이행할 필요는 없습니다.
5. 리라이트모드를 사용하지 않아 해제하려 하는데 관리자모드 -> settings 에서 해제가 되지 않습니다.
만일 관리자모드에서 리라이트모드가 해제되지 않는다면,
임시 대처방법으로는 루트에 있는 .htaccess 파일을 열어 RewriteEngine On 문구를 RewriteEngine Off 로
변경하면 되구요.
근본적으로는 files > config 폴더 안에 있는 db.config.php 파일의 권한이 707 또는 777 로 되어 있지 않아서
발생하는 문제이니, db.config.php 파일의 권한을 707 또는 777 로 부여하십시오.
(기본값은 644 로 되어 있을 겁니다)
6. XE를 루트로 옮겼는데, 관리자모드로 접속하거나 홈페이지의 메뉴들을 클릭하면, 옮기기 전의 주소로 접속됩니다.
기본 URL의 문제일 가능성이 큽니다.
http://mylostworld.co.kr/12969 문서의 5번 문항을 참고하세요.
메뉴의 경우는 관리자모드 -> 사이트설정 -> 메뉴 -> 해당메뉴의 "수정" 버튼 -> 캐쉬파일재생성
을 눌러주면 새로 반영될 것입니다.
7. 페이지 수정을 눌렀을때, 에러페이지가 뜹니다.
일단, 이 부분은 php 서버 설정에서 메모리값이 너무 적을 때 발생하는 문제입니다.
128M 정도로 설정해 주면 해결됩니다.
만일, 루트로 이동하기 전에는 잘 되다가, 루트로 이동 후에 갑자기 문제가 생긴 경우라면
.htaccess 파일의 문제일 가능성이 큽니다.
XE를 루트로 이동하기 전에, 루트에 이미 .htaccess 파일이 존재하고 있는데,
XE를 루트로 이동하면서 XE폴더에 있던 .htaccess 파일이 루트의 .htaccess 파일을 덮어 씌워버렸기 때문입니다.
루트에 .htaccess 파일이 없어서 III-5 번 과정의 이행 없이 바로 6번으로 이동 과정을 이행하셨다면,
메모리 값을 직접 넣어주시면 됩니다.
<< 아래의 해결책은, 이미 XE를 루트로 이동시킨 후 의 상황으로 가정한 것입니다 >>
1) 계정에 FTP로 접속하세요.
2) html / www public_html 등의 폴더 (루트) 로 이동하세요. (이 폴더가 없는 경우도 있습니다)
3) .htaccess 파일을 컴퓨터로 다운받으세요.
4) editplus 나 메모장 등으로 해당 파일을 여세요
5) 파일의 맨 위에 (보통 RewriteEngine On 위) 아래 문구를 추가하세요.
php_value memory_limit 128M
6) 파일을 저장하세요.
7) 저장한 파일을 FTP 로 덮어씌우세요.
