메뉴얼:데비안이나 우분투에서 미디어위키 구동하기

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Running MediaWiki on Debian or Ubuntu and the translation is 92% complete.

Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎polski • ‎русский • ‎中文 • ‎日本語 • ‎한국어
설치 가이드
FreeBSD
GNU/Linux
- ALT Linux
- Arch Linux
- Damnsmalllinux
- Debian or Ubuntu
- Fedora
- Gentoo
- Mandriva
- Red Hat Enterprise Linux
- Slackware
Mac OS X
NetWare
Solaris
- Solaris 11 / opensolaris
- Solaris 10
Windows
- Windows Server 2016
on a stick
- Uniform Server
- XAMPP
Sourceforge.net
This page documents how to install MediaWiki using the release tarballs. If you want to use system packages, see User:Legoktm/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-get update && sudo apt-get upgrade


LAMP스택 설치

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

우분투 16.04.2 LTS (지니얼)과 데비안 스트레치는 php7.0을 포함하고 있으며, 많은 패키지들의 이름이 'php5'에서 단순한 'php'로 바뀌었습니다. 또한 일부 php 모듈은 별도의 패키지로 설치해야 합니다. (xml, mbstring 등)
sudo apt-get install apache2 mysql-server php php-mysql libapache2-mod-php php-xml php-mbstring
우분투 트러스티와 데비안 제시, 그리고 라즈비안(제시)는 php5를 포함하고 있으며, 대부분의 페키지에서 (전부는 아닙니다)'php5'를 사용하고 있습니다.
sudo apt-get install apache2 mysql-server php5 php5-mysql libapache2-mod-php5

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

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

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

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

만약 위의 모든 것들을 한번에 설치하고자 한다면 : sudo apt-get install php-apcu php-intl imagemagick inkscape php-gd php-cli php-curl git php-apcu를 설치한다면, 설정 스크립트를 실행할 때 나타나는 경고 메시지를 피하기 위해 아파치의 설정을 다시 로드해야할 것입니다:

sudo service apache2 reload

미디어위키 설치

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

    cd /tmp/
    wget https://releases.wikimedia.org/mediawiki/1.32/mediawiki-1.32.0.tar.gz
  • 당신의 웹 디렉토리에 압축을 풉니다.
tar -xvzf /tmp/mediawiki-*.tar.gz
sudo mkdir /var/lib/mediawiki
sudo mv mediawiki-*/* /var/lib/mediawiki


MySQL 설정

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

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

  • 새로운 mysql유저를 생성하세요 (new_mysql_user):
# sudo mysql -u root -p 그리고 mysql의 루트 사용자 비밀번호를 입력하세요.

(만약 설정해둔 비밀번호가 없을 경우 공백일 것이며, 그대로 돌아가기를 누르십시오)

mysql> CREATE USER 'new_mysql_user'@'localhost' IDENTIFIED BY 'THISpasswordSHOULDbeCHANGED';
mysql> quit;
  • 새로운 mysql 데이터베이스, pi_wiki를 생성하세요:
# sudo mysql -u root
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를 수정하세요. 우분투 트러스티와 데비안 제시의 경우, /etc/php5/apache2/php.ini에 위치해 있습니다.

On Ubuntu Xenial and Debian Stretch (PHP 7), it is located at /etc/php/7.0/apache2/php.ini.

최대 업로드 파일 크기

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

upload_max_filesize = 2M

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

메모리 제한

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

memory_limit = 8M

->

memory_limit = 128M

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

미디어위키 설정

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

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

sudo ln -s /var/lib/mediawiki /var/www/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에서 발견할 수 있습니다. Manual:LocalSettings.php 문서는 유용하게 쓰일 수 있는 자세한 정보들을 담고 있습니다. 다음에 따른 변경은 일반적으로 도움을 줍니다.

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

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

혹은 터미널에서

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


파일 업로드

Manual:Configuring file uploads 참고.

로고 바꾸기

메뉴얼:$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.

관련 항목