Manual:Running MediaWiki on Debian or Ubuntu

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 38% 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
スティック (USB メモリなど)
- 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.

このページでは、Debian や Ubuntu の GNU/Linux サーバー上で MediaWiki をインストールする方法を説明します。 The instructions below refer to Debian, but unless otherwise noted also apply to Ubuntu and Raspbian.

Introduction

インストールでは、端末からコマンドを実行してアプリケーションをインストールする方法や、テキストエディタ(GUI:geditやkate、CUI:nanoやemacs、vi)の使い方の知識が必要です。

テキストの編集が必要とされる場合には、GUI環境ではAlt-F2をおした後に次のように入力します。

    gksudo gedit ファイル名

あるいは、Terminalから編集が可能です。

    sudo nano ファイル名

勿論、エディターは、geditの代わりにkateでもいいし、nanoの代わりにviでも良いです。

ステップバイステップ

Ensure Debian is up-to-date

次の2つのコマンドを実行しDebianの更新を確認します:

sudo apt-get update
sudo apt-get upgrade

or in one line

sudo apt-get update && sudo apt-get upgrade


LAMP スタックのインストール

Ubuntu Server Edition makes LAMP (Apache, PHP, and MySQL) available for installation during the install process. During the installation step, make sure you choose to install a LAMP server. Alternately, you can install all of these packages from a standard installation using these commands:

Ubuntu 16.04.2 LTS (Xenial) and Debian Stretch include PHP 7.0, and renamed many packages from "php5" to plain "php". In addition, some PHP modules are now in separate packages (xml, mbstring).
sudo apt-get install apache2 mysql-server php php-mysql libapache2-mod-php php-xml php-mbstring
Ubuntu Trusty, Debian Jessie and Raspbian (Jessie) include PHP 5, and use "php5" in most (but not all) packages.
sudo apt-get install apache2 mysql-server php5 php5-mysql libapache2-mod-php5

Optional useful packages

These packages are not necessary but may be useful, depending on the installation:

名前 パッケージ 説明
Alternative PHP Cache php-apcu or php5-apcu Modern MediaWiki versions will automatically take advantage of this being installed for improved performance.
PHP Unicode normalization php-intl or php5-intl MediaWiki will fallback to a slower PHP implementation if not available.
ImageMagick imagemagick Image thumbnailing.
Inkscape inkscape Alternative means of SVG thumbnailing, than ImageMagick. Sometimes it will render SVGs better if originally created in Inkscape.
PHP GD library php-gd or php5-gd Alternative to ImageMagick for image thumbnailing.
PHP command-line php-cli or php5-cli Ability to run PHP commands from the command line, which is useful for debugging and running maintenance scripts.
PHP cURL php-curl or php5-curl Required by some extensions such as Extension:Math. See Manual:cURL
git source control version git If not present config script will tell you that it is not installed

You can install any of the above with sudo apt-get install packagename.

If you want to install all of them: sudo apt-get install php-apcu php-intl imagemagick inkscape php-gd php-cli php-curl git If you install php-apcu you will have to reload your apache configuration in order to avoid a warning message when running configuration script:

sudo service apache2 reload

MediaWiki のインストール

This can be done from a browser or by command line

    cd /tmp/
    wget https://releases.wikimedia.org/mediawiki/1.31/mediawiki-1.31.1.tar.gz
  • extract in your Web directory
tar -xvzf /tmp/mediawiki-*.tar.gz
sudo mkdir /var/lib/mediawiki
sudo mv mediawiki-*/* /var/lib/mediawiki


Configuration mysql

But before proceeding with the initial MediaWiki installation, there are certain steps you need to do first!

You will have to:

  • create a NEW mysql user (new_mysql_user):
# sudo mysql -u root -p and enter password of mysql root user (if you have no configured password it will be empty, so just press return)
mysql> CREATE USER 'new_mysql_user'@'localhost' IDENTIFIED BY 'THISpasswordSHOULDbeCHANGED';
mysql> quit;
  • create a NEW mysql database pi_wiki:
# sudo mysql -u root
mysql> CREATE DATABASE pi_wiki;
mysql> use pi_wiki;
Database changed
  • GRANT the NEW mysql user access to the NEW created mysql database pi_wiki:
mysql> GRANT ALL ON pi_wiki.* TO 'new_mysql_user'@'localhost';
Query OK, 0 rows affected (0.01 sec)
mysql>quit;

PHPを設定する

これらのステップはシンプルに経験に基づいたものです。 このステップをすべてスキップできます(もしくは後でも十分で行うことができます)

次に、設定ファイルを設定する必要があります... On Ubuntu Trusty and Debian Jessie, it is located at /etc/php5/apache2/php.ini.

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

アップロード可能なファイルサイズの上限

様々なファイルがWikiにコンテンツとしてアップロードされることを想定すると、アップロード可能なファイルサイズの上限を調整しなければなりません。 このセクションの後半の半分はファイルのアップロードに関することを取り扱います。 変更

upload_max_filesize = 2M

少なくとも20Mです。 将来再びこの値を変更しなければならないことがあります。

メモリの制限

Some PHP scripts require a lot of memory to run. To increase the maximum amount of memory a script can use, page down to about 21%, and change the following entry, if found, from

memory_limit = 8M

to

memory_limit = 128M

If it is already set to 128M or more, leave it as is.

MediaWikiを設定する

Navigate your browser to http://localhost/mediawiki (for certain installations it may be http://localhost/mediawiki/config or http://wiki.hostname.com/config instead) and following the procedure given.

If this gives a 404 error then working a symbolic link should solve it:

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

MediaWikiのインストールスクリプトで"Checking environment..."を注目して下さい。 MediaWikiのインストール作業を成功させるためにこの情報によって多くの問題を解決できます。

It may complain that php extensions like mbstring and xml are missing even you have installed them. Please manually activate them by using:

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

設定フォームを記入して続けて下さい。

You will have to use your username and password provided in the mysql configuration section:

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

Under Database Config, you may change the database name and DB username to new values, but you must turn on "Use superuser account", name:

debian-sys-maint

giving the mysql root password you configured earlier.

The configuration process will prompt you to download a LocalSettings.php that must be saved to the parent directory of the new wiki. The configuration page will give the exact directory/filename that must be moved:

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

And navigate your browser to http://localhost/mediawiki (or http://server_ip_address/mediawiki or http://server_ip_address/mediawiki/index.php) to see your new wiki.

やりました! 稼働しているwikiを手に入れました!!

wikiの追加設定

全般的の情報

ウィキは /var/lib/mediawiki にある LocalSettings.php ファイルで設定変更できます。 LocalSettings.phpで役に立つかもしれない詳細な情報があります。 次は一般的に役立つと思われる変更です。

LocalSettings.php を編集するには以下を使用します

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

or from a terminal

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


ファイルのアップロード

See Manual:ファイルのアップロードの設定 .

ロゴを変更する

See Manual:$wgLogo .

MediaWiki 拡張機能

The current tarball for Mediawiki comes with a package of 15 or so of the most popular extensions, but there are literally hundreds more.

Instructions on how to enable extensions can be found at Manual:Extensions#Installing an extension .

Pretty URLs

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.

関連項目