Manual:Running MediaWiki on Debian or Ubuntu/ko

이 페이지는 우분투에 미디어위키를 어떻게 설치하는지 설명합니다. 이 설명은 데비안용이지만, 별도의 경고가 없는 경우 우분투와 라즈비안에서도 적용 가능합니다.

도입
이 설치 과정은 터미널에서 명령 실행(예: 응용 프로그램 설치)이나 텍스트 편집기 (GUI: gedit, kate; TEXT: nano, emacs, vi)사용에 대한 지식을 요구합니다.

텍스트 편집이 필요한 경우에는 GUI 환경에서 Alt-F2를 누른 후 다음과 같이 입력합니다.

gksudo gedit 파일명

또는 터미널에서 편집이 가능합니다.

sudo nano 파일명

물론, gedit대신 kate를 사용하거나 nano대신 vi 를 사용 해도 됩니다.

우분투 업데이트 확인
아래의 두 명령어를 사용하여 우분투의 최신 버전 여부를 확인합니다.

or in one line

LAMP스택 설치
우분투 서버 에디션은 설치 과정중 LAMP (Apache, PHP, 그리고 MySQL)의 설치를 가능하게 합니다. 설치 과정중, 반드시 LAMP의 설치를 고르세요. 또는, 다음의 명령어를 사용하여 일반 우분투에서 이러한 모든 패키지를 설치할 수 있습니다.

선택사항. 유용한 패키지들
이 패키지들은 필수는 아니나 설치에 따라 유용할 수 있습니다.

위의 페키지들은 다음의 명령어로도 설치가 가능합니다.

만약 위의 모든 것들을 한번에 설치하고자 한다면 :

php-apcu를 설치한다면, 설정 스크립트를 실행할 때 나타나는 경고 메시지를 피하기 위해 아파치의 설정을 다시 로드해야할 것입니다:

미디어위키 설치

 * 공식 TAR파일 다운로드

다운로드는 브라우저를 이용 하거나, 아래의 명령어를 이용할 수 있습니다.


 * 당신의 웹 디렉토리에 압축을 풉니다.

MySQL 설정
미디어위키 설치 과정을 진행하기에 앞서, 몇가지 먼저 해야할 것들이 있습니다!

On Raspbian, if this is a new installation of mariadb you will also need to run:

아래의 모든 것을 진행해야합니다:


 * 새로운 mysql유저를 생성하세요 (new_mysql_user):

# sudo mysql -u root -p 비밀번호 입력 : mysql 루트 사용자의 비밀번호를 입력합니다 (비밀번호를 구성하지 않은 경우 비어 있으므로 Enter를 누르십시오) mysql> CREATE USER 'new_mysql_user'@'localhost' IDENTIFIED BY 'THISpasswordSHOULDbeCHANGED'; mysql> quit;


 * 새로운 mysql 데이터베이스, my_wiki를 생성하세요:

# sudo mysql -u root -p mysql> CREATE DATABASE my_wiki; mysql> use my_wiki; Database changed


 * GRANT the NEW mysql user access to the NEW created mysql database my_wiki:

mysql> GRANT ALL ON my_wiki.* TO 'new_mysql_user'@'localhost'; Query OK, 0 rows affected (0.01 sec) mysql> quit;

선택 사항: PHP 설정
당신의 PHP설정파일, php.ini를 수정하세요. It is located at, depending on exact version of PHP.

최대 업로드 파일 크기
위키에 다양한 종류의 파일을 업로드하고자 한다면, 최대 파일 업로드 제한 용량을 조절해야 합니다. 대략 스크롤의 절반쯤에 파일 업로드 섹션이 위치합니다. 수정:

에서 최소 20M으로. 더 큰 업로드를 원할 경우, 나중에 다시 조정할 수 있습니다.

메모리 제한
어떤 PHP 스크립트는 작동을 위해 상당한 메모리를 요구합니다. 스크립트가 한번에 사용할 수 있는 용량을 늘리기 위해, 페이지를 약 21% 가량 스크롤 해 다음 내용을 찾아 수정합니다.

->

만약 이미 128M나 그 이상으로 설정 되 있을 경우, 그대로 저장하시면 됩니다.

미디어위키 설정
당신의 브라우저로 http://localhost (어떤 설치에선 http://localhost/mediawiki/config 나 http://wiki.hostname.com/config 일 수 있습니다)에 접속하세요. 그리고 주어진 절차를 따르세요.

만약 404에러를 출력할 경우, 다음으로 해결이 가능할 것입니다 :

sudo ln -s /var/lib/mediawiki /var/www/html/mediawiki

For Debian based systems running apache2, once you create a symbolic link in the /var/www/html directory you may still run into a 404 error. If this happens, try loading: localhost/html/mediawiki/.


 * 미디어위키 설치 스크립트의 사용 환경 검사부분을 확인하세요. ('미디어위키에 오신 것을 환영합니다!'부분에서 확인 가능)

이것으로 에러를 일으키는 특정한 원인들을 식별하여 많은 문제들을 해결 가능합니다.

당신이 설치를 이미 완료했음에도 mbstring이나 xml같은 php확장기능을 요구할 수 있습니다. 다음을 이용하여 직접 그것들을 활성화 시키세요:

sudo phpenmod mbstring sudo phpenmod xml sudo systemctl restart apache2.service

설정 양식을 체우고, 계속해서 진행을 해 주세요. mysql 설정 부분에서 제공된 사용자 이름과 비밀번호를 사용해야합니다.

mysql> CREATE USER 'new_mysql_user'@'localhost' IDENTIFIED BY 'THISpasswordSHOULDbeCHANGED';

데이터베이스 설정에서, 당신은 데이터베이스 이름이나 DB사용자 이름을 새로운 값으로 바꿀 수 있습니다만, 반드시 "최고 관리자 계정"을 다음과 같이 활성화해야 합니다. :

debian-sys-maint

당신이 전에 설정했던 mysql의 루트 비밀번호를 입력합니다.

설치 과정은 당신에게 새로운 위키의 상위 디렉토리에 저장되어있을 LocalSettings.php를 다운로드 하라 요구할 것입니다. 설정 페이지는 다음의 위치로 옮겨져야 할 정확한 디렉토리와 파일명을 보여줄 것입니다.

sudo mv ~/Downloads/LocalSettings.php /var/lib/mediawiki/

그리고 브라우저를 통해 http://localhost/mediawiki (혹은 http://server_ip_address/mediawiki 혹은 http://server_ip_address/mediawiki/index.php)로 이동하여 당신의 새로운 위키를 볼 수 있을 것입니다.

완성! 이제 당신은 당신만의 위키를 열었습니다.

기본 정보
미디어위키는 LocalSettings.php파일로 구성되어있습니다. 이 파일은 주로 에서 발견할 수 있습니다. 문서는 유용하게 쓰일 수 있는 자세한 정보들을 담고 있습니다. 다음에 따른 변경은 일반적으로 도움을 줍니다.

LocalSettings.php을 편집하기 위해, 다음을 사용합니다.

gksudo gedit /var/lib/mediawiki/LocalSettings.php

혹은 터미널에서

sudo nano /var/lib/mediawiki/LocalSettings.php

파일 업로드
참고.

로고 바꾸기
참고.

미디어위키 확장기능
현재 미디어위키의 TAR파일은 약 15개쯤 되는 가장 널리 쓰이는 확장자를 포함하고 있지만, 세상에는 수백가지도 더 넘게 있습니다.

확장자를 활성화시키는 방법은 을 통해 알 수 있습니다.

URL 간단화
To use /wiki/* instead of /wiki/index.php/* on Debian, follow the recommended short URL guide using  as the script path instead of   and placing the rewrites in /etc/apache2/conf-enabled/mediawiki.conf.

관련 항목

 * 표준 설치방법은 미디어위키와 더 많은 정보를 참고하십시오.
 * 데비안 미디어위키 페이지
 * Ubuntuguide.org은 우분투나 쿠분투에 미디어위키 뿐만 아니라 다양한 위키들과 서브위키의 자세한 설치 방법을 제공합니다.