Як встановити XWiki 9.11.x на Ubuntu 16.04 LTS

XWiki — це популярна вікі-платформа з відкритим вихідним кодом корпоративного рівня, написана на Java. Завдяки розширюваності та простоті використання XWiki розгортається в різних компаніях як сховище знань, публічний портал тощо.

У цій статті я розповім вам про процес встановлення XWiki 9.11.2 на екземпляр сервера Ubuntu 16.04 LTS. OpenJDK 8, Tomcat 8 і MySQL 5.7 будуть автоматично встановлені як залежності під час процесу встановлення.

Передумови

• Свіжий екземпляр сервера Vultr Ubuntu 16.04 LTS x64 з принаймні 2 ГБ пам’яті, рекомендовано 4 ГБ або більше. Скажімо, його IP-адреса 203.0.113.1.
• Користувач sudo .
• Примірник сервера оновлено до останнього стабільного стану за допомогою apt.

Налаштуйте репозиторію XWiki LTS APT

Увійдіть як користувач sudo, а потім завантажте та налаштуйте репозиторію APT XWiki LTS (Довгострокова підтримка) на вашому сервері:

cd
wget -q "https://maven.xwiki.org/public.gpg" -O- | sudo apt-key add -
sudo wget "https://maven.xwiki.org/lts/xwiki-lts.list" -P /etc/apt/sources.list.d/
sudo apt update

Примітка. Якщо ви хочете випробувати останню стабільну версію XWiki (але НЕ LTS), ви можете замість цього завантажити наведене нижче репо XWiki APT:

cd
wget -q "https://maven.xwiki.org/public.gpg" -O- | sudo apt-key add -
sudo wget "https://maven.xwiki.org/stable/xwiki-stable.list" -P /etc/apt/sources.list.d/
sudo apt update

Встановіть пакет XWiki «все в одному» (включаючи XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 тощо).

Під час розгортання у виробництві XWiki має працювати з контейнером Java Servlet і програмним забезпеченням для баз даних. Як гнучка вікі-платформа, XWiki офіційно надає різні варіанти інтеграції. Ви можете використовувати таку команду, щоб показати всі доступні параметри в репозиторії XWiki LTS APT:

apt search xwiki

Результат пошуку буде виглядати так:

xwiki-common/lts 9.11.2 all
xwiki-mysql-common/lts 9.11.2 all
xwiki-pgsql-common/lts 9.11.2 all
xwiki-solr-data/lts 9.11.2 all
xwiki-tomcat7-common/lts 9.11.2 all
xwiki-tomcat7-mysql/lts 9.11.2 all
xwiki-tomcat7-pgsql/lts 9.11.2 all
xwiki-tomcat8-common/lts 9.11.2 all
xwiki-tomcat8-mysql/lts 9.11.2 all
xwiki-tomcat8-pgsql/lts 9.11.2 all

Якщо ви хочете використовувати XWiki з найпоширенішими залежностями, ви можете встановити всі необхідні компоненти однією командою наступним чином:

sudo apt install xwiki-tomcat8-mysql/lts -y

Під час процесу інсталяції вам кілька разів буде запропоновано встановити новий пароль для користувача root MySQL. Просто залиште поле пароля порожнім і натисніть, Enterщоб наразі пропустити цей крок. Ми розглянемо цю проблему пізніше, під час забезпечення встановлення MySQL.

Коли з'явиться запит, чи хочете ви Configure database for xwiki with dbconfig-common?, виберіть <Yes>і натисніть ENTER.

Коли вас попросять надати MySQL application password for xwiki, ви можете ввести певний пароль програми MySQL або залишити поле пароля порожнім. Останній скаже XWiki використовувати випадковий пароль програми MySQL.

Встановивши XWiki та всі необхідні залежності, захистіть встановлення MySQL:

sudo /usr/bin/mysql_secure_installation

Під час процесу програма задасть вам кілька запитань. Відповідайте на них, як показано нижче:

• Бажаєте налаштувати плагін VALIDATE PASSWORD? Y
• Будь ласка, введіть 0 = НИЗЬКИЙ, 1 = СЕРЕДНІЙ і 2 = СИЛЬНИЙ: 2
• Новий пароль: a-strong-MySQL-root-password
• Повторно введіть новий пароль: a-strong-MySQL-root-password
• Бажаєте продовжити з наданим паролем? Y
• Видалити анонімних користувачів? Y
• Віддалено заборонити вхід root? Y
• Видалити тестову базу даних і отримати доступ до неї? Y
• Перезавантажити таблиці привілеїв зараз? Y

Підвищте безпеку XWiki, змінивши файл конфігурації XWiki.

Використовуйте редактор vi, щоб відкрити файл конфігурації XWiki:

sudo vi /etc/xwiki/xwiki.cfg

Знайдіть два рядки, показані нижче:

xwiki.authentication.validationKey=totototototototototototototototo
xwiki.authentication.encryptionKey=titititititititititititititititi

Замініть значення обох параметрів двома різними випадковими рядками і просто переконайтеся, що довжина кожного рядка така ж, як і іншого, наприклад:

xwiki.authentication.validationKey=f0130dfa6fc841e920d5e1056184c03e
xwiki.authentication.encryptionKey=z84kf92ko073tgjdnvkdfmms91qa0ke4

Збережіть і вийдіть:

:wq!

Квота пам’яті за замовчуванням занадто низька для запуску Tomcat 8 і XWiki всередині. Вам потрібно збільшити квоту пам’яті за замовчуванням наступним чином, перш ніж ви зможете правильно запустити екземпляр XWiki в Tomcat 8.

sudo cp /etc/default/tomcat8 /etc/default/tomcat8.bak
sudo vi /etc/default/tomcat8

Знайдіть рядок:

JAVA_OPTS="-Djava.awt.headless=true -Xmx128m -XX:+UseConcMarkSweepGC"

Змініть рядок, як показано нижче:

JAVA_OPTS="-Djava.awt.headless=true -Xmx1024m"

Примітка: 1024 МП — це лише мінімальна квота для запуску невеликого або середнього сайту XWiki. Можливо, вам доведеться внести корективи в цю лінію відповідно до ваших конкретних вимог.

Збережіть і вийдіть:

:wq!

Перезапустіть Tomcat 8, щоб усі ваші зміни запрацювали:

sudo systemctl restart tomcat8.service

Змініть правила брандмауера UFW, щоб дозволити веб-доступ через порт 8080:

sudo ufw allow 8080
sudo ufw enable

Ініціалізуйте XWiki у Distribution Wizardвеб-інтерфейсі " "

На цьому етапі ви налаштували функціональний, але порожній сайт XWiki. Щоб заповнити вміст, вам потрібно виконати кілька наступних завдань, включаючи створення користувача адміністратора та встановлення ароматизатора та необхідних розширень для цієї вікі на початковому веб-інтерфейсі XWiki під назвою " Distribution Wizard".

Наведіть свій улюблений веб-браузер на http://203.0.113.1:8080/xwiki, і ви автоматично перейдете до Distribution Wizardвеб-інтерфейсу. Натисніть кнопку " Continue", щоб почати роботу майстра.

На сторінці " Step 1 - Admin user" потрібно ввести облікові дані користувача адміністратора, наприклад:

FIRST NAME: `John`
LAST NAME: `Doe`
USERNAME (Required): `johndoe`
PASSWORD (Required): `yourpassword`
CONFIRM PASSWORD (Required): `yourpassword`
EMAIL ADDRESS: `johndoe@example.com`

Заповнивши всі необхідні поля, натисніть кнопку « Register and login«, щоб перейти далі.

На наступній сторінці, яка відображає " You are connected with user John Doe.", натисніть кнопку " Continue", щоб створити користувача адміністратора, John Doeчиє ім'я користувача, johndoeі рухайтеся далі.

На сторінці " Step 2 - Flavor" клацніть область " XWiki Standard Flavor 9.11.2", щоб виділити цей смак, а потім натисніть кнопку " Install this flavor", щоб перейти далі.

На наступній сторінці, яка містить відомості про " XWiki Standard Flavor 9.11.2", натисніть кнопку " Install", щоб виконати інсталяцію.

Після встановлення ароматизатора всі необхідні розширення будуть перераховані на сторінці, натисніть кнопку " Continue", щоб встановити їх усі.

Після встановлення аромату та всіх необхідних розширень натисніть кнопку " Continue" у нижньому правому куті, щоб перейти далі.

На сторінці " Step 4 - Report" можна переглянути всі створені сторінки.

При необхідності ви можете видалити будь-які непопулярні сторінки, натиснувши відповідну червону Xкнопку.

Нарешті, натисніть кнопку " Continue", щоб завершити " Distribution Wizard". Ви потрапите на інформаційну панель XWiki як користувач адміністратора, якого ви налаштували раніше.

(Необов’язково) Скоротіть URL-адресу сайту XWiki

За замовчуванням, оскільки Tomcat може обслуговувати більше однієї програми одночасно, вам потрібно отримати доступ до вашого сайту XWiki за URL-адресою http://203.0.113.1:8080/xwiki. Однак, якщо XWiki є єдиною програмою, що працює в Tomcat, і ви хочете скоротити URL-адресу сайту XWiki, видаливши /xwikiсуфікс, вам слід змінити три файли конфігурації XWiki наступним чином.

Зміна файлу 1:

cd /etc/tomcat8/Catalina/localhost/
sudo cp xwiki.xml ROOT.xml
sudo mv xwiki.xml xwiki.xml.bak

Зміна файлу 2:

cd /etc/xwiki
sudo cp xwiki-tomcat8.xml xwiki-tomcat8.xml.bak
sudo vi xwiki-tomcat8.xml

Знайдіть рядок:

<Context path="/xwiki" docBase="/usr/lib/xwiki" privileged="true" crossContext="true">

Змініть значення параметра шляху:

<Context path="/" docBase="/usr/lib/xwiki" privileged="true" crossContext="true">

Збережіть і вийдіть:

:wq!

Модифікація файлу 3:

cd /etc/xwiki
sudo cp xwiki.cfg xwiki.cfg.bak
sudo vi xwiki.cfg

Знайдіть рядок:

# xwiki.webapppath=

Розкоментуйте це:

xwiki.webapppath=

Збережіть і вийдіть:

:wq!

Нарешті, перезапустіть Tomcat 8, щоб застосувати всі ваші зміни:

sudo systemctl restart tomcat8.service

Відтепер ви будете відвідувати свій сайт XWiki http://203.0.113.1:8080/безпосередньо.

(Необов’язково) Налаштуйте зворотний проксі Nginx

За замовчуванням Tomcat 8 працює на порту 8080, і ви можете відвідувати свій сайт XWiki лише з того самого порту. Якщо ви хочете полегшити доступ відвідувачів, видаливши частину номера порту, ви можете встановити Nginx як зворотний проксі між XWiki і відвідувачами.

Спочатку встановіть Nginx за допомогою apt:

sudo apt install nginx -y

Далі налаштуйте Nginx як зворотний проксі, змінивши його конфігурації сайту за замовчуванням:

cd /etc/nginx/sites-available
sudo mv default default.bak
sudo vi default

Заповніть файл наступним чином:

server {
listen 0.0.0.0:80;

proxy_request_buffering off;
proxy_buffering off;

location / {
    proxy_pass http://127.0.0.1:8080;
    proxy_redirect     off;
        proxy_set_header   Host $host;
        proxy_set_header   X-Real-IP $remote_addr;
        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Host $server_name;
}
}

Збережіть і вийдіть:

:wq!

Запустіть службу Nginx і налаштуйте її на автоматичний запуск при запуску системи:

sudo systemctl restart nginx.service
sudo systemctl enable nginx.service

Нарешті, змініть правила брандмауера UFW відповідно:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Відтепер відвідувачам вашого сайту XWiki більше не потрібно вказувати номер порту. Їх слід відвідати безпосередньо http://203.0.113.1/.