====== Установка на Debian Linux Apache2 и вики-движка DokuWiki ======

===== Теория =====

FIXME

===== Практика =====

==== Установка Apache2 ====

После того, как [[..:install_os:install_os|установили debian]], можно приступать к установке web-сервера apache. После установки скачаем последнюю версию [[https://www.dokuwiki.org/dokuwiki|вики-движка DokuWiki]].

Итак, нас ожидает окно приветствия. Вводим имя нашей учетной записи и пароль.

{{:sw:lin:deb:apache2_dokuwiki:12_debianreadyafterinstall.jpg?400|Приветствие}}

После входа проверим наличие обновлений и, если таковые есть, установим их командой:

<code>
sudo apt update && sudo apt upgrade
</code>

{{:sw:lin:deb:apache2_dokuwiki:13_debian_apt_updupg.jpg?400|Обновление ПО}}

Затем зададим имя нашему хосту. Чтобы не было никаких дальнейших проблем (я очень на это надеюсь :-D) зададим имя хосту, полностью соответствующее имена сайта.

<code>
sudo nano /etc/hostname
</code>

После правки нажимаем [CTRL] + X, затем Y и Enter

{{:sw:lin:deb:apache2_dokuwiki:14_debian_hostname1.jpg?400|Hostname}} {{:sw:lin:deb:apache2_dokuwiki:15_debian_hostname2.jpg?400|Hostname}} {{:sw:lin:deb:apache2_dokuwiki:16_debian_hostname3.jpg?400|Hostname}} 

После перезагрузим систему:

<code>
sudo systemctl reboot
</code>

{{:sw:lin:deb:apache2_dokuwiki:17_debian_reboot.jpg?400|Перезагрузка}}

После перезагрузки начнем установку apache командой:

<code>
sudo apt install apache2
</code>

{{:sw:lin:deb:apache2_dokuwiki:19_debian_apacheinstall2.jpg?400|Установка Apache}} 

Установка прошла успешно, проверим работоспособность сервиса:

<code>
sudo systemctl status apache2.service
</code>

{{:sw:lin:deb:apache2_dokuwiki:20_debian_apachecheck.jpg?400|Проверка работоспособности}}

А теперь перейдем в браузере по адресу нашей виртуальной машины, в моем случае:

<code>
http://192.168.11.13
</code>

{{:sw:lin:deb:apache2_dokuwiki:22_debian_apachestartpage.png?400|Окно Apache в браузере}}

Ура! Все работает. Можно приступать к установке DokuWiki.

==== Установка DokuWiki ====

Установим необходимые пакеты для работы DokuWiki:

<code>
sudo apt install php libapache2-mod-php php-xml php-json php-mbstring php-zip php-intl php-gd php-sqlite3
</code>

{{:sw:lin:deb:apache2_dokuwiki:1.jpg?400|Установка необходимого ПО}}

Перезапустим сервис apache:

<code>
sudo systemctl restart apache2.service
</code>

С помощью этой команды скачиваем стабильную на текущий момент версию DokuWiki:

<code>
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
</code>

{{:sw:lin:deb:apache2_dokuwiki:2.jpg?400|Загрузка DokuWiki}}

После успешной загрузки распакуем архив в текущую (домашнюю) директорию:

<code>
tar xzvf dokuwiki-stable.tgz
</code>

Терерь необходимо перенести все файлы вики-движка DokuWiki в директорию /var/www/html. Предварительно нужно удалить все ее содержимое. На текущий момент там находится только файл index.html.

<code>
sudo rm /var/www/html/index.html
</code>

Теперь перемещаем файлы DokuWiki в директорию /var/www/html:

<code>
sudo mv dokuwiki-{DATE}/* /var/www/html
</code>

:!: Вместо {DATE} у Вас должна быть дата сборки актуальной версии.

Теперь зададим права и укажем владельца для директорий и файлов:

<code>
sudo chown -R www-data:www-data /var/www/html
</code>

Теперь перейдем по адресу нашего сайта и установим DokuWiki:

<code>
http://192.168.11.13/
</code>

{{:sw:lin:deb:apache2_dokuwiki:3.png?400|Установка DokuWiki}}

После установки **обязательно** удалите файл install.php

<code>
sudo rm /var/www/html/install.php
</code>

Теперь можно настроить проброс 80го порта, если Ваш сайт за NAT'ом и сайт будет работать по адресу Вашего доменого имени.

==== Дополнительные настройки ====

Вы наверняка заметили, что при установке DokuWiki было предупреждение о том, что не все Ваши данные защищены должным образом (см. предыдущий слайд). Исправим это в фалах 000-default.conf и default-ssl.conf.

<code>
sudo nano /etc/apache2/sites-available/000-default.conf 
</code>

<code>
sudo nano /etc/apache2/sites-available/default-ssl.conf
</code>

В вышеуказанных файлах должны быть соответствующие записи. Смотрим **очень внимательно**!

<code>
DocumentRoot /var/www/html

	<Directory />
                Options FollowSymLinks
                AllowOverride None
        </Directory>
        <Directory /var/www/>
                Options Indexes FollowSymLinks MultiViews
                AllowOverride All
                Order allow,deny
                allow from all
        </Directory>
</code>

Теперь предупреждение должно пропасть. Посмотреть это можно в разделе "Управление". Там не должно быть никаких предупреждений.

==== Примечание ====

Еще не очень приятным для меня моментом было ограничение на размер загружаемых на сайт файлов - 2 мегабайта. Это [[etc:maxuploadsize|можно исправить]].