Manual:Running MediaWiki on Debian or Ubuntu/ko

이 페이지는 릴리스 타르볼을 사용하여 미디어위키를 설치하는 방법을 설명합니다. 시스템 패키지를 사용하고 Raspbian에 설치하지 않는 경우 Debian packages을 참조하십시오.

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

도입

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

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

gksudo gedit 파일명

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

sudo nano 파일명

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

단계별 설치법

우분투 업데이트 확인

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

sudo apt update
sudo apt upgrade

or in one line

sudo apt update && sudo apt upgrade

LAMP스택 설치

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

sudo apt-get install apache2 mariadb-server php php-mysql libapache2-mod-php php-xml php-mbstring

또는 mysql을 사용합니다(Raspberry Pi OS는 더 이상 mysql을 지원하지 않음).

sudo apt-get install apache2 mysql-server php php-mysql libapache2-mod-php php-xml php-mbstring

선택사항. 유용한 패키지들

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

이름	페키지	설명
대체 PHP 캐시	php-apcu	최신 미디어위키 버전은 이것이 자동적으로 설치되어 당신에게 향상된 기능으로 이점을 제공할 것입니다.
PHP 유니코드 통일화.	php-intl	사용 불가할 경우 미디어위키는 PHP동작이 느려질 것입니다.
ImageMagick	imagemagick	이미지 썸네일 관리.
Inkscape	inkscape	SVG썸네일의 ImageMagick대체제. 일부 경우에 대해 Inkscape에서 원래 생성된 경우 SVG를 더욱 빠르게 렌더링 해낼것입니다.
PHP GD 보관함	php-gd	섬네일 이미지 ImageMagick의 대안.
PHP command-line	php-cli	유지, 보수 스크립트 작성과 디버깅에 유용한 커맨드 라인의 PHP명령을 실행시킬 도구.
PHP cURL	php-curl	확장기능:Math 과 같은 일부 확장에 필요합니다. See Manual:cURL
git source control version	git	If not present config script will tell you that it is not installed
Basic Calculator	php-bcmath	In order to make the visualeditor work on 32bit machines, like a raspi

위의 페키지들은 다음의 명령어로도 설치가 가능합니다. sudo apt-get install packagename

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

sudo apt-get install php-apcu php-intl imagemagick inkscape php-gd php-cli php-curl php-bcmath git

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

sudo systemctl reload apache2

미디어위키 설치

공식 TAR파일 다운로드

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

cd /tmp/ wget https://releases.wikimedia.org/mediawiki/1.41/mediawiki-1.41.1.tar.gz

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

tar -xvzf /tmp/mediawiki-*.tar.gz
sudo mkdir /var/lib/mediawiki
sudo mv mediawiki-*/* /var/lib/mediawiki

MySQL 설정

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

On Raspbian, if this is a new installation of mariadb you will also need to run: sudo mysqld_safe --skip-grant-tables --skip-networking &

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

새로운 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> commit;
mysql> quit;

선택 사항: PHP 설정

이 작업은 선택 사항이며, 설치 후에도 가능합니다. 미디어위키는 이러한 변화 없이도 여전히 작동할 것입니다.

당신의 PHP설정파일, php.ini를 수정하세요. It is located at /etc/php/7.*/apache2/php.ini, depending on exact version of PHP.

최대 업로드 파일 크기

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

upload_max_filesize = 2M

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

메모리 제한

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

memory_limit = 8M

->

memory_limit = 128M

만약 이미 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파일로 구성되어있습니다. 이 파일은 주로 /var/lib/mediawiki에서 발견할 수 있습니다. 매뉴얼:LocalSettings.php 문서는 유용하게 쓰일 수 있는 자세한 정보들을 담고 있습니다. 다음에 따른 변경은 일반적으로 도움을 줍니다.

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

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

혹은 터미널에서

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

파일 업로드

Manual:파일 업로드 설정하기 참고.

로고 바꾸기

메뉴얼:$wgLogo 참고.

미디어위키 확장기능

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

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

URL 간단화

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