XWiki è una popolare piattaforma wiki open source a livello aziendale scritta in Java. Con estensibilità e facilità d'uso, XWiki viene distribuito in varie aziende come repository di conoscenza, portale pubblico e altro ancora.
In questo articolo, ti guiderò attraverso il processo di installazione di XWiki 9.11.2 su un'istanza del server Ubuntu 16.04 LTS. OpenJDK 8, Tomcat 8 e MySQL 5.7 verranno installati automaticamente come dipendenze durante il processo di installazione.
Prerequisiti
- Una nuova istanza del server x64 LTS di Vultr Ubuntu 16.04 con almeno 2 GB di memoria, almeno 4 GB. Di 'che il suo indirizzo IP è
203.0.113.1
.
- Un utente sudo .
- L'istanza del server è stata aggiornata all'ultimo stato stabile usando
apt
.
Imposta il repository APT XWiki LTS
Accedi come utente sudo, quindi scarica e configura il repository APT XWiki LTS (supporto a lungo termine) sull'istanza del tuo server:
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
Nota: se vuoi provare l'ultima versione stabile di XWiki (ma NON LTS), puoi invece scaricare il repository APT XWiki di seguito:
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
Installa il tutto in un unico pacchetto XWiki (inclusi XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 e altro.)
Quando distribuito in produzione, XWiki deve funzionare con un contenitore di servlet Java e un software di database. Come piattaforma wiki flessibile, XWiki offre ufficialmente varie opzioni di integrazione. Puoi usare il comando seguente per mostrare tutte le opzioni disponibili nel repository APT XWiki LTS:
apt search xwiki
Il risultato della ricerca sarà simile al seguente:
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
Se si desidera utilizzare XWiki con le dipendenze più comuni, è possibile installare tutti i componenti richiesti in un comando come segue:
sudo apt install xwiki-tomcat8-mysql/lts -y
Durante il processo di installazione, ti verrà chiesto di impostare più volte una nuova password per l'utente root di MySQL. Lascia vuoto il campo della password e premi Enter
per saltare questo passaggio per ora. Affronteremo questo problema in seguito assicurando l'installazione di MySQL.
Quando ti viene chiesto se vuoi Configure database for xwiki with dbconfig-common?
, scegli <Yes>
e poi premi ENTER.
Quando ti viene chiesto di fornire un MySQL application password for xwiki
, puoi inserire una specifica password dell'applicazione MySQL o lasciare vuoto il campo della password. Quest'ultimo dirà a XWiki di utilizzare una password dell'applicazione MySQL casuale.
Con XWiki e tutte le dipendenze richieste installate, assicurati l'installazione di MySQL:
sudo /usr/bin/mysql_secure_installation
Durante il processo, il programma ti farà alcune domande. Rispondi a loro come di seguito:
- Desideri installare il plug-in VALIDATE PASSWORD? Y
- Inserisci 0 = BASSO, 1 = MEDIO e 2 = FORTE: 2
- Nuova password:
a-strong-MySQL-root-password
- Reinserire la nuova password:
a-strong-MySQL-root-password
- Desideri continuare con la password fornita? Y
- Rimuovere utenti anonimi? Y
- Non consentire l'accesso root da remoto? Y
- Rimuovere il database di prova e accedervi? Y
- Ricarica le tabelle dei privilegi ora? Y
Migliora la sicurezza di XWiki modificando il file di configurazione di XWiki.
Utilizzare l'editor vi per aprire un file di configurazione di XWiki:
sudo vi /etc/xwiki/xwiki.cfg
Trova le due righe mostrate di seguito:
xwiki.authentication.validationKey=totototototototototototototototo
xwiki.authentication.encryptionKey=titititititititititititititititi
Sostituisci i valori di entrambi i parametri con due diverse stringhe casuali e assicurati solo che la lunghezza di ciascuna stringa sia la stessa dell'altra, ad esempio:
xwiki.authentication.validationKey=f0130dfa6fc841e920d5e1056184c03e
xwiki.authentication.encryptionKey=z84kf92ko073tgjdnvkdfmms91qa0ke4
Salva ed esci:
:wq!
La quota di memoria predefinita è troppo bassa per l'esecuzione di Tomcat 8 e XWiki all'interno. È necessario aumentare la quota di memoria predefinita come segue prima di poter avviare correttamente un'istanza XWiki in Tomcat 8.
sudo cp /etc/default/tomcat8 /etc/default/tomcat8.bak
sudo vi /etc/default/tomcat8
Trova la linea:
JAVA_OPTS="-Djava.awt.headless=true -Xmx128m -XX:+UseConcMarkSweepGC"
Modifica la linea come mostrato di seguito:
JAVA_OPTS="-Djava.awt.headless=true -Xmx1024m"
Nota: 1024 M di memoria rappresentano solo la quota minima per l'esecuzione di un sito XWiki di piccole o medie dimensioni. Potrebbe essere necessario apportare modifiche a questa linea in base alle proprie esigenze specifiche.
Salva ed esci:
:wq!
Riavvia Tomcat 8 per rendere effettive tutte le modifiche:
sudo systemctl restart tomcat8.service
Modifica le regole del firewall UFW per consentire l'accesso Web sulla porta 8080
:
sudo ufw allow 8080
sudo ufw enable
Inizializza XWiki sull'interfaccia Distribution Wizard
web " "
A questo punto, hai impostato un sito XWiki funzionale ma vuoto. Per compilare il contenuto, è necessario completare diverse attività di follow-up, tra cui la creazione di un utente amministratore e l'installazione di un sapore e le estensioni richieste per questo wiki, sull'interfaccia Web iniziale di XWiki denominata " Distribution Wizard
".
Punta il tuo browser Web preferito su http://203.0.113.1:8080/xwiki
e verrai portato automaticamente all'interfaccia " Distribution Wizard
". Fare clic sul Continue
pulsante " " per iniziare la procedura guidata.
Nella Step 1 - Admin user
pagina " ", è necessario inserire le credenziali dell'utente amministratore, ad esempio:
FIRST NAME: `John`
LAST NAME: `Doe`
USERNAME (Required): `johndoe`
PASSWORD (Required): `yourpassword`
CONFIRM PASSWORD (Required): `yourpassword`
EMAIL ADDRESS: `[email protected]`
Dopo aver compilato tutti i campi richiesti, fai clic sul Register and login
pulsante " " per proseguire.
Nella pagina successiva che mostra " You are connected with user John Doe.
", fai clic sul pulsante " Continue
" per creare l'utente amministratore il John Doe
cui nome utente è johndoe
e andare avanti.
Nella Step 2 - Flavor
pagina " ", fai clic sull'area " XWiki Standard Flavor 9.11.2
" per evidenziare questo sapore, quindi fai clic sul pulsante " Install this flavor
" per andare avanti.
Nella pagina successiva in cui è indicato " XWiki Standard Flavor 9.11.2
", fare clic sul pulsante " Install
" per eseguire l'installazione.
Dopo aver installato il sapore, tutte le estensioni richieste saranno elencate nella pagina, fare clic sul pulsante " Continue
" per installarle tutte.
Avendo installato il sapore e tutte le estensioni richieste, fai clic sul pulsante " Continue
" nell'angolo in basso a destra per andare avanti.
Nella Step 4 - Report
pagina " ", puoi rivedere tutte le pagine create.
Se necessario, è possibile eliminare qualsiasi pagina impopolare facendo clic sul X
pulsante rosso corrispondente .
Infine, fai clic sul pulsante " Continue
" per terminare " Distribution Wizard
". Verrai portato nella dashboard di XWiki come utente amministratore che hai configurato in precedenza.
(Facoltativo) Riduci l'URL del sito XWiki
Per impostazione predefinita, poiché Tomcat può servire più di un'applicazione contemporaneamente, è necessario accedere al sito XWiki all'URL http://203.0.113.1:8080/xwiki
. Tuttavia, se XWiki è l'unica applicazione in esecuzione in Tomcat e si desidera abbreviare l'URL del sito XWiki rimuovendo il /xwiki
suffisso, è necessario modificare tre file di configurazione XWiki come segue.
Modifica file 1:
cd /etc/tomcat8/Catalina/localhost/
sudo cp xwiki.xml ROOT.xml
sudo mv xwiki.xml xwiki.xml.bak
Modifica file 2:
cd /etc/xwiki
sudo cp xwiki-tomcat8.xml xwiki-tomcat8.xml.bak
sudo vi xwiki-tomcat8.xml
Trova la linea:
<Context path="/xwiki" docBase="/usr/lib/xwiki" privileged="true" crossContext="true">
Modifica il valore del parametro path:
<Context path="/" docBase="/usr/lib/xwiki" privileged="true" crossContext="true">
Salva ed esci:
:wq!
Modifica file 3:
cd /etc/xwiki
sudo cp xwiki.cfg xwiki.cfg.bak
sudo vi xwiki.cfg
Trova la linea:
# xwiki.webapppath=
Uncomment it:
xwiki.webapppath=
Salva ed esci:
:wq!
Infine, riavvia Tomcat 8 per applicare tutte le modifiche:
sudo systemctl restart tomcat8.service
D'ora in poi, visiterai direttamente il tuo sito XWiki http://203.0.113.1:8080/
.
(Facoltativo) Imposta un proxy inverso Nginx
Per impostazione predefinita, Tomcat 8 funziona sulla porta 8080
e puoi visitare il tuo sito XWiki solo dalla stessa porta. Se si desidera facilitare l'accesso dei visitatori rimuovendo la parte del numero di porta, è possibile installare Nginx come proxy inverso tra XWiki e visitatori.
Innanzitutto, installa Nginx usando apt:
sudo apt install nginx -y
Successivamente, imposta Nginx come proxy inverso modificando le configurazioni predefinite del sito:
cd /etc/nginx/sites-available
sudo mv default default.bak
sudo vi default
Compila il file con il seguente:
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;
}
}
Salva ed esci:
:wq!
Avviare il servizio Nginx e impostarlo per l'avvio automatico all'avvio del sistema:
sudo systemctl restart nginx.service
sudo systemctl enable nginx.service
Infine, modifica le regole del firewall UFW di conseguenza:
sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload
D'ora in poi, i visitatori del tuo sito XWiki non dovranno più specificare il numero di porta. Dovrebbero visitare direttamente http://203.0.113.1/
.