XWiki — это вики-программа, которая позволяет любому человеку создавать, организовывать и обмениваться информацией с любого устройства с доступом в интернет, используя веб-браузер, настольный компьютер или мобильный телефон.
Это полноценная служба вики-хостинга сообщества с правами пользователей, ролями и группами. В нем есть как публичные, так и частные вики. Для хранения информации используется база данных, например, MySQL. Для работы используются контейнеры сервлетов (например, Tomcat, Jetty); поддерживаются XHTML, WYSIWYM, XSL-FO, MathML, SVG и RSS.
XWiki — это следующее поколение Wiki, единственная вики на рынке, предлагающая так много функций в одном пакете.
XWiki предлагает расширенный режим, который может быть включен в любой вики, позволяя более детально контролировать рендеринг содержимого с помощью правил преобразования на основе XSLT. Он поставляется с набором таблиц стилей по умолчанию, предварительно настроенных для работы из коробки. Тем не менее, это поведение можно легко настроить с помощью пользовательских XSLT-файлов, что дает полную свободу в создании внешнего вида вики без необходимости писать какой-либо код.
В этом руководстве вы узнаете, как установить XWiki на Ubuntu 20.04 и получить пользователей, разрешения и основные функции. Хотя это руководство основано на Ubuntu 20.04, инструкции могут быть применены к любому дистрибутиву на базе Debian.
Необходимые условия
- Сервер под управлением Ubuntu 20.04 с оперативной памятью не менее 1024 МБ и жестким диском не менее 20 ГБ.
- Доменное имя для доступа к вики из интернета (необязательно).
- Базовые знания Linux и веб-серверов в целом.
- Root доступ к серверу или привилегии пользователя sudo для установки приложений и управления файлами и каталогами на вашем сервере.
Обновление системы
Чтобы убедиться, что требования к системе выполнены, сначала необходимо обновить ее. Обновите список пакетов вашего дистрибутива, выполнив команду:
sudo apt-get update
Вы должны получить следующий результат:
После обновления списков доступных пакетов выполните приведенную ниже команду, чтобы установить все обновления на Ubuntu 20.04:
sudo apt-get upgrade -y
или
sudo apt-get dist-upgrade -y
Вы должны получить следующий результат:
Рекомендуется перезагрузить ваш сервер перед применением любых обновлений ядра, чтобы они вступили в силу должным образом и избежать проблем в дальнейшем при использовании некоторых модулей XWiki, таких как службы преобразования документов, которые сильно зависят от рабочей версии ядра Linux.
sudo reboot now
После этого снова войдите в систему под тем же пользователем sudo и перейдите к следующему шагу.
Установите Java
XWiki написана на Java, поэтому прежде чем продолжить работу, вам необходимо установить Java на Ubuntu 20.04.
Чтобы установить Java на Ubuntu 20.04, выполните следующую команду:
sudo apt install default-jdk -y
Вы должны получить следующий результат:
Вы можете проверить версию Java с помощью следующей команды после ее установки:
java --version
Вы должны получить следующий результат:
Теперь, когда Java правильно установлена, вы можете приступить к следующему шагу.
Установка XWiki на Ubuntu 20.04
По умолчанию XWiki недоступен в репозиториях Ubuntu 20.04, поэтому вам придется скачать пакет с сайта XWiki и установить его вручную на свой сервер.
Прежде всего, убедитесь, что wget и curl установлены:
sudo apt-get -y install wget curl
Добавьте ключ GPG в apt с помощью следующей команды:
wget -q "https://maven.xwiki.org/public.gpg" -O- | apt-key add -
Вы должны увидеть сообщение OK, подтверждающее, что ключ был добавлен правильно.
Добавьте репозиторий XWiki в вашу систему с помощью следующей команды:
sudo wget "https://maven.xwiki.org/stable/xwiki-stable.list" -P /etc/apt/sources.list.d/
Приведенная выше команда добавит стабильный репозиторий XWiki на ваш сервер.
Вы должны получить следующий результат:
Для того чтобы apt мог использовать новые добавленные репозитории, необходимо обновить его кэш:
sudo apt-get update -y
На данном этапе Xwiki доступна в ваших репозиториях Ubuntu 20.04, вы можете найти доступные пакеты с помощью следующей команды:
sudo apt-cache search xwiki
Появится список пакетов, в котором можно выбрать пакет, который вы хотите установить.
Для работы XWiki на Ubuntu 20.04 требуется внешний контейнер сервлетов, такой как Apache Tomcat. В этом руководстве мы установим пакет xwiki-platform с tomcat 9 и MariaDB в качестве сервера баз данных:
sudo apt install xwiki-tomcat9-common xwiki-tomcat9-mariadb -y
В процессе установки вам потребуется создать базу данных XWiki, как показано ниже. Выберите «Да» и нажмите Enter, чтобы запустить процесс создания базы данных.
Установите желаемый пароль, выберите Ok и нажмите Enter, когда появится запрос, чтобы завершить установку пароля для базы данных XWiki, как показано ниже. Обязательно подтвердите его после этого.
Когда установка завершена, вы можете проверить службу Tomcat с помощью следующей команды:
sudo systemctl status tomcat9.service
Вы должны увидеть следующий результат:
Как вы можете видеть, служба tomcat активна и запущена.
Обычно Tomcat прослушивает порт 8080. Вы можете проверить, прослушивает ли он порт 8080, используя следующую команду:
ss -antpl | grep 8080
Вы должны увидеть следующий результат:
Настройка Nginx для XWiki
В этой части мы расскажем вам, как настроить Nginx для XWiki. Nginx — это очень популярный и мощный веб-сервер. Он может использоваться для обслуживания статического контента, проксирования запросов и легкой обработки аутентификации, среди прочего.
Чтобы Nginx мог взаимодействовать с приложением XWiki tomcat, его необходимо соответствующим образом настроить.
Чтобы установить веб-сервер Nginx, введите в терминале следующую команду:
sudo apt-get install nginx -y
После установки веб-сервера создайте новый конфигурационный файл Nginx следующей командой под названием xwiki.conf. xwiki.conf — это конфигурационный файл, который должен быть обновлен вашими собственными настройками, и он будет сохранен в папке etc.
sudo nano /etc/nginx/sites-available/xwiki.conf
Перед вами должен открыться пустой файл, готовый к редактированию.
Заполните файл следующим содержимым:
server {
listen 80;
server_name xwiki.example.com;
access_log /var/log/nginx/xwiki-access.log;
error_log /var/log/nginx/xwiki-error.log;
location / {
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Host $host;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection ‘upgrade’;
proxy_cache_bypass $http_upgrade;
proxy_pass http://127.0.0.1:8080;
}
}
Сохраните файл после завершения работы, затем активируйте новую конфигурацию Nginx с помощью следующей команды:
sudo ln -s /etc/nginx/sites-available/xwiki.conf /etc/nginx/sites-enabled/
Перезапустите Nginx, чтобы изменения вступили в силу, с помощью следующей команды:
sudo systemctl restart nginx
Доступ к веб-интерфейсу XWiki
Теперь, когда вы установили и настроили XWiki, пришло время получить доступ к веб-интерфейсу. Для этого введите IP-адрес вашего сервера или имя домена, а затем /xwiki. Например:
- http://xwiki.example.com/xwiki
- http://server-ip-address/xwiki
Вы увидите окно приветствия, как показано на рисунке.
Нажмите кнопку Продолжить. Вы должны увидеть страницу создания пользователя-администратора.
Теперь вам нужно создать свою первую учетную запись пользователя XWiki, заполнив всю необходимую информацию, как показано ниже:
Укажите свое имя пользователя, пароль и электронную почту, затем нажмите кнопку Регистрация и вход. Вы перейдете на страницу ниже:
Нажмите на кнопку Продолжить. Вы увидите следующую страницу. Выберите аромат, который вы хотите использовать, и нажмите кнопку Установить этот аромат, как показано на рисунке.
После завершения установки вы должны увидеть следующую страницу:
Чтобы применить настройки, нажмите на кнопку Продолжить. После завершения установки вы увидите следующую страницу, на которой показаны папки XWiki по умолчанию. Для завершения установки нажмите кнопку Продолжить.
Наконец, вы должны увидеть приборную панель XWiki по умолчанию, как показано на рисунке:
Заключение
В этом руководстве вы узнали, как установить Xwiki на Ubuntu 20.04 и настроить для него Nginx. Мы надеемся, что это руководство было полезным для вас.
Для получения дополнительной информации о XWiki, пожалуйста, посетите официальный сайт
