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
Вы должны получить следующий результат:
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-1.webp?resize=659%2C386&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-1.webp?resize=659%2C386&ssl=1)
После обновления списков доступных пакетов выполните приведенную ниже команду, чтобы установить все обновления на Ubuntu 20.04:
sudo apt-get upgrade -y
или
sudo apt-get dist-upgrade -y
Вы должны получить следующий результат:
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-2.webp?resize=659%2C386&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-2.webp?resize=659%2C386&ssl=1)
Рекомендуется перезагрузить ваш сервер перед применением любых обновлений ядра, чтобы они вступили в силу должным образом и избежать проблем в дальнейшем при использовании некоторых модулей XWiki, таких как службы преобразования документов, которые сильно зависят от рабочей версии ядра Linux.
sudo reboot now
После этого снова войдите в систему под тем же пользователем sudo и перейдите к следующему шагу.
Установите Java
XWiki написана на Java, поэтому прежде чем продолжить работу, вам необходимо установить Java на Ubuntu 20.04.
Чтобы установить Java на Ubuntu 20.04, выполните следующую команду:
sudo apt install default-jdk -y
Вы должны получить следующий результат:
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-3.webp?resize=659%2C386&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-3.webp?resize=659%2C386&ssl=1)
Вы можете проверить версию Java с помощью следующей команды после ее установки:
java --version
Вы должны получить следующий результат:
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-4.webp?resize=659%2C386&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-4.webp?resize=659%2C386&ssl=1)
Теперь, когда 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, подтверждающее, что ключ был добавлен правильно.
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-5.webp?resize=659%2C386&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-5.webp?resize=659%2C386&ssl=1)
Добавьте репозиторий XWiki в вашу систему с помощью следующей команды:
sudo wget "https://maven.xwiki.org/stable/xwiki-stable.list" -P /etc/apt/sources.list.d/
Приведенная выше команда добавит стабильный репозиторий XWiki на ваш сервер.
Вы должны получить следующий результат:
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-6.webp?resize=659%2C386&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-6.webp?resize=659%2C386&ssl=1)
Для того чтобы apt мог использовать новые добавленные репозитории, необходимо обновить его кэш:
sudo apt-get update -y
На данном этапе Xwiki доступна в ваших репозиториях Ubuntu 20.04, вы можете найти доступные пакеты с помощью следующей команды:
sudo apt-cache search xwiki
Появится список пакетов, в котором можно выбрать пакет, который вы хотите установить.
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-7.webp?resize=659%2C386&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-7.webp?resize=659%2C386&ssl=1)
Для работы XWiki на Ubuntu 20.04 требуется внешний контейнер сервлетов, такой как Apache Tomcat. В этом руководстве мы установим пакет xwiki-platform с tomcat 9 и MariaDB в качестве сервера баз данных:
sudo apt install xwiki-tomcat9-common xwiki-tomcat9-mariadb -y
В процессе установки вам потребуется создать базу данных XWiki, как показано ниже. Выберите «Да» и нажмите Enter, чтобы запустить процесс создания базы данных.
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-8.webp?resize=659%2C386&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-8.webp?resize=659%2C386&ssl=1)
Установите желаемый пароль, выберите Ok и нажмите Enter, когда появится запрос, чтобы завершить установку пароля для базы данных XWiki, как показано ниже. Обязательно подтвердите его после этого.
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-9.webp?resize=659%2C386&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-9.webp?resize=659%2C386&ssl=1)
Когда установка завершена, вы можете проверить службу Tomcat с помощью следующей команды:
sudo systemctl status tomcat9.service
Вы должны увидеть следующий результат:
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-10.webp?resize=659%2C386&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-10.webp?resize=659%2C386&ssl=1)
Как вы можете видеть, служба tomcat активна и запущена.
Обычно Tomcat прослушивает порт 8080. Вы можете проверить, прослушивает ли он порт 8080, используя следующую команду:
ss -antpl | grep 8080
Вы должны увидеть следующий результат:
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-11.webp?resize=659%2C386&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-11.webp?resize=659%2C386&ssl=1)
Настройка Nginx для XWiki
В этой части мы расскажем вам, как настроить Nginx для XWiki. Nginx — это очень популярный и мощный веб-сервер. Он может использоваться для обслуживания статического контента, проксирования запросов и легкой обработки аутентификации, среди прочего.
Чтобы Nginx мог взаимодействовать с приложением XWiki tomcat, его необходимо соответствующим образом настроить.
Чтобы установить веб-сервер Nginx, введите в терминале следующую команду:
sudo apt-get install nginx -y
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-12.webp?resize=659%2C386&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-12.webp?resize=659%2C386&ssl=1)
После установки веб-сервера создайте новый конфигурационный файл 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
Вы увидите окно приветствия, как показано на рисунке.
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-13.webp?resize=776%2C667&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-13.webp?resize=776%2C667&ssl=1)
Нажмите кнопку Продолжить. Вы должны увидеть страницу создания пользователя-администратора.
Теперь вам нужно создать свою первую учетную запись пользователя XWiki, заполнив всю необходимую информацию, как показано ниже:
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-14.webp?resize=785%2C757&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-14.webp?resize=785%2C757&ssl=1)
Укажите свое имя пользователя, пароль и электронную почту, затем нажмите кнопку Регистрация и вход. Вы перейдете на страницу ниже:
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-15.webp?resize=790%2C324&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-15.webp?resize=790%2C324&ssl=1)
Нажмите на кнопку Продолжить. Вы увидите следующую страницу. Выберите аромат, который вы хотите использовать, и нажмите кнопку Установить этот аромат, как показано на рисунке.
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-16.webp?resize=785%2C784&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-16.webp?resize=785%2C784&ssl=1)
После завершения установки вы должны увидеть следующую страницу:
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-17.webp?resize=786%2C797&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-17.webp?resize=786%2C797&ssl=1)
Чтобы применить настройки, нажмите на кнопку Продолжить. После завершения установки вы увидите следующую страницу, на которой показаны папки XWiki по умолчанию. Для завершения установки нажмите кнопку Продолжить.
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-18-1.webp?resize=787%2C841&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-18-1.webp?resize=787%2C841&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-19.webp?resize=783%2C905&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-19.webp?resize=783%2C905&ssl=1)
Наконец, вы должны увидеть приборную панель XWiki по умолчанию, как показано на рисунке:
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-20.webp?resize=1024%2C607&ssl=1)
![](https://i0.wp.com/linuxthebest.net/wp-content/uploads/2023/04/word-image-19900-20.webp?resize=1024%2C607&ssl=1)
Заключение
В этом руководстве вы узнали, как установить Xwiki на Ubuntu 20.04 и настроить для него Nginx. Мы надеемся, что это руководство было полезным для вас.
Для получения дополнительной информации о XWiki, пожалуйста, посетите официальный сайт