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, будь ласка, відвідайте офіційний сайт
