Как да инсталирате 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 сървърен екземпляр с поне 2GB памет, 4GB или повече се препоръчва. Кажете, че неговият IP адрес е 203.0.113.1.
• А потребителското Sudo .
• Сървърната инстанция е актуализирана до последното стабилно състояние с помощта на apt.

Настройте репото на XWiki LTS APT

Влезте като потребител на sudo и след това изтеглете и настройте XWiki LTS (Long Term Support) APT репо на вашия сървърен екземпляр:

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"

Забележка: 1024M памет е само минималната квота за стартиране на малък или среден 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: `[email protected]`

След като попълните всички задължителни полета, щракнете върху бутона " 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/.