Jak zainstalować XWiki 9.11.x na Ubuntu 16.04 LTS

• Wymagania wstępne
• Skonfiguruj repozytorium XWiki LTS APT
• Zainstaluj wszystko w jednym pakiecie XWiki (w tym XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 i więcej.)
• Zainicjuj XWiki w interfejsie internetowym „Distribution Wizard”
• (Opcjonalnie) Skróć adres URL witryny XWiki
• (Opcjonalnie) Skonfiguruj zwrotny serwer proxy Nginx

XWiki to popularna platforma wiki typu open source dla przedsiębiorstw napisana w Javie. Dzięki rozszerzalności i łatwości użytkowania XWiki jest wdrażane w różnych firmach jako repozytorium wiedzy, portal publiczny i wiele innych.

W tym artykule poprowadzę Cię przez proces instalacji XWiki 9.11.2 na instancji serwera Ubuntu 16.04 LTS. OpenJDK 8, Tomcat 8 i MySQL 5.7 zostaną automatycznie zainstalowane jako zależności podczas procesu instalacji.

Wymagania wstępne

• Świeża instancja serwera Vultr Ubuntu 16.04 LTS x64 z co najmniej 2 GB pamięci, zalecane 4 GB lub więcej. Powiedz, że jego adres IP to 203.0.113.1.
• Użytkownik sudo .
• Instancja serwera została zaktualizowana do najnowszej stabilnej wersji za pomocą apt.

Skonfiguruj repozytorium XWiki LTS APT

Zaloguj się jako użytkownik sudo, a następnie pobierz i skonfiguruj repozytorium APT XWiki LTS (Long Term Support) na instancji serwera:

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

Uwaga: jeśli chcesz wypróbować najnowszą stabilną wersję XWiki (ale NIE LTS), możesz zamiast tego pobrać poniższe repozytorium 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

Zainstaluj wszystko w jednym pakiecie XWiki (w tym XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 i więcej.)

Podczas wdrażania w środowisku produkcyjnym XWiki musi współpracować z kontenerem Java Servlet i oprogramowaniem bazy danych. Jako elastyczna platforma wiki, XWiki oficjalnie udostępnia różne opcje integracji. Możesz użyć następującego polecenia, aby wyświetlić wszystkie dostępne opcje w repozytorium APT XWiki LTS:

apt search xwiki

Wynik wyszukiwania będzie podobny do następującego:

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

Jeśli chcesz używać XWiki z najczęstszymi zależnościami, możesz zainstalować wszystkie wymagane komponenty w jednym poleceniu w następujący sposób:

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

Podczas procesu instalacji zostaniesz kilkakrotnie poproszony o ustawienie nowego hasła dla użytkownika root MySQL. Po prostu pozostaw pole hasła puste i naciśnij, Enteraby na razie pominąć ten krok. Rozwiążemy ten problem później, zabezpieczając instalację MySQL.

Na pytanie, czy chcesz Configure database for xwiki with dbconfig-common?, wybierz, <Yes>a następnie naciśnij ENTER.

Gdy zostaniesz poproszony o podanie a MySQL application password for xwiki, możesz albo wprowadzić określone hasło aplikacji MySQL, albo pozostawić pole hasła puste. Ten ostatni powie XWiki, aby używał losowego hasła aplikacji MySQL.

Po zainstalowaniu XWiki i wszystkich wymaganych zależności zabezpieczyć instalację MySQL:

sudo /usr/bin/mysql_secure_installation

Podczas tego procesu program zadaje kilka pytań. Odpowiedz na nie, jak poniżej:

• Czy chcesz skonfigurować wtyczkę VALIDATE PASSWORD? Y
• Wpisz 0 = NISKI, 1 = ŚREDNI, a 2 = MOCNY: 2
• Nowe hasło: a-strong-MySQL-root-password
• Wprowadź ponownie nowe hasło: a-strong-MySQL-root-password
• Czy chcesz kontynuować z podanym hasłem? Y
• Usunąć anonimowych użytkowników? Y
• Zezwolić na logowanie roota zdalnie? Y
• Usunąć testową bazę danych i uzyskać do niej dostęp? Y
• Przeładować tabele uprawnień teraz? Y

Zwiększ bezpieczeństwo XWiki, modyfikując plik konfiguracyjny XWiki.

Użyj edytora vi, aby otworzyć plik konfiguracyjny XWiki:

sudo vi /etc/xwiki/xwiki.cfg

Znajdź dwie linie pokazane poniżej:

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

Zamień wartości obu parametrów na dwa różne losowe ciągi i upewnij się, że długość każdego ciągu jest taka sama jak drugiego, na przykład:

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

Zapisz i wyjdź:

:wq!

Domyślny limit pamięci jest zbyt niski, aby można było w nim uruchomić Tomcat 8 i XWiki. Aby poprawnie uruchomić instancję XWiki w Tomcat 8, musisz zwiększyć domyślny przydział pamięci w następujący sposób.

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

Znajdź linię:

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

Zmodyfikuj linię, jak pokazano poniżej:

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

Uwaga: 1024 mln pamięci to tylko minimalny limit na prowadzenie małej lub średniej witryny XWiki. Konieczne może być dostosowanie tej linii zgodnie ze swoimi konkretnymi wymaganiami.

Zapisz i wyjdź:

:wq!

Zrestartuj Tomcat 8, aby zastosować wszystkie swoje modyfikacje:

sudo systemctl restart tomcat8.service

Zmodyfikuj reguły zapory UFW, aby umożliwić dostęp do sieci na porcie 8080:

sudo ufw allow 8080
sudo ufw enable

Zainicjuj XWiki w Distribution Wizardinterfejsie internetowym

W tym momencie masz skonfigurowaną funkcjonalną, ale pustą stronę XWiki. Aby wypełnić zawartość, musisz ukończyć kilka kolejnych zadań, w tym utworzyć użytkownika administratora i zainstalować smak i wymagane rozszerzenia dla tej wiki w początkowym interfejsie internetowym XWiki o nazwie „ Distribution Wizard”.

Wskaż swoją ulubioną przeglądarkę http://203.0.113.1:8080/xwiki, a zostaniesz automatycznie przeniesiony do Distribution Wizardinterfejsu sieciowego. Kliknij przycisk „ Continue”, aby uruchomić kreatora.

Na stronie „ Step 1 - Admin user” musisz wprowadzić dane uwierzytelniające administratora, na przykład:

FIRST NAME: `John`
LAST NAME: `Doe`
USERNAME (Required): `johndoe`
PASSWORD (Required): `yourpassword`
CONFIRM PASSWORD (Required): `yourpassword`
EMAIL ADDRESS: `[email protected]`

Po wypełnieniu wszystkich wymaganych pól kliknij przycisk „ Register and login”, aby przejść dalej.

Na następnej stronie, która pokazuje „ You are connected with user John Doe.”, kliknij przycisk „ Continue”, aby utworzyć użytkownika administratora, John Doektórego nazwa użytkownika to, johndoei przejść dalej.

Na stronie „ Step 2 - Flavor” kliknij obszar „ XWiki Standard Flavor 9.11.2”, aby podświetlić ten smak, a następnie kliknij przycisk „ Install this flavor”, aby przejść dalej.

Na następnej stronie opisującej „ XWiki Standard Flavor 9.11.2” kliknij przycisk „ Install”, aby przeprowadzić instalację.

Po zainstalowaniu smaku wszystkie wymagane rozszerzenia zostaną wyświetlone na stronie, kliknij przycisk „ Continue”, aby je wszystkie zainstalować.

Po zainstalowaniu smaku i zainstalowaniu wszystkich wymaganych rozszerzeń kliknij przycisk „ Continue” w prawym dolnym rogu, aby przejść dalej.

Na stronie „ Step 4 - Report” możesz przejrzeć wszystkie utworzone strony.

W razie potrzeby możesz usunąć niepopularne strony, klikając odpowiedni czerwony Xprzycisk.

Na koniec kliknij przycisk „ Continue”, aby zakończyć „ Distribution Wizard”. Zostaniesz przeniesiony do pulpitu nawigacyjnego XWiki jako administrator, którego wcześniej skonfigurowałeś.

(Opcjonalnie) Skróć adres URL witryny XWiki

Domyślnie, ponieważ Tomcat może obsługiwać więcej niż jedną aplikację w tym samym czasie, musisz uzyskać dostęp do swojej witryny XWiki pod adresem URL http://203.0.113.1:8080/xwiki. Jeśli jednak XWiki jest jedyną aplikacją działającą w Tomcat i chcesz skrócić adres URL witryny XWiki poprzez usunięcie /xwikiprzyrostka, zmodyfikuj trzy pliki konfiguracyjne XWiki w następujący sposób.

Modyfikacja pliku 1:

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

Modyfikacja pliku 2:

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

Znajdź linię:

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

Zmodyfikuj wartość parametru ścieżki:

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

Zapisz i wyjdź:

:wq!

Modyfikacja pliku 3:

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

Znajdź linię:

# xwiki.webapppath=

Odkomentuj to:

xwiki.webapppath=

Zapisz i wyjdź:

:wq!

Na koniec uruchom ponownie Tomcat 8, aby zastosować wszystkie modyfikacje:

sudo systemctl restart tomcat8.service

Od teraz będziesz odwiedzać swoją stronę XWiki http://203.0.113.1:8080/bezpośrednio.

(Opcjonalnie) Skonfiguruj zwrotny serwer proxy Nginx

Domyślnie Tomcat 8 działa na porcie 8080i można odwiedzać witrynę XWiki tylko z tego samego portu. Jeśli chcesz ułatwić odwiedzającym dostęp poprzez usunięcie części numeru portu, możesz zainstalować Nginx jako odwrotne proxy między XWiki a gośćmi.

Najpierw zainstaluj Nginx za pomocą apt:

sudo apt install nginx -y

Następnie skonfiguruj Nginx jako zwrotny serwer proxy, modyfikując jego domyślne konfiguracje witryny:

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

Wpisz do pliku następujące informacje:

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;
}
}

Zapisz i wyjdź:

:wq!

Uruchom usługę Nginx i ustaw ją tak, aby uruchamiała się automatycznie podczas uruchamiania systemu:

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

Na koniec zmodyfikuj odpowiednio reguły zapory UFW:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Odtąd odwiedzający twoją stronę XWiki nie muszą już podawać numeru portu. Powinni odwiedzić bezpośrednio http://203.0.113.1/.