Како инсталирати КСВики 9.11.к на Убунту 16.04 ЛТС

КСВики је популарна вики платформа отвореног кода на нивоу предузећа написана на Јави. Уз проширивост и лакоћу коришћења, КСВики се примењује у различитим компанијама као складиште знања, јавни портал и још много тога.

У овом чланку ћу вас водити кроз процес инсталирања КСВики 9.11.2 на Убунту 16.04 ЛТС инстанцу сервера. ОпенЈДК 8, Томцат 8 и МиСКЛ 5.7 ће бити аутоматски инсталирани као зависности током процеса инсталације.

Предуслови

• Нова Вултр Убунту 16.04 ЛТС к64 инстанца сервера са најмање 2 ГБ меморије, препоручује се 4 ГБ или више. Рецимо да је његова ИП адреса 203.0.113.1.
• : Судо корисника .
• Инстанца сервера је ажурирана на најновији стабилни статус помоћу 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

Напомена: Ако желите да испробате најновије стабилно КСВики издање (али НЕ ЛТС), уместо тога можете преузети доњи КСВики АПТ репо:

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

Инсталирајте све у једном КСВики пакету (укључујући КСВики ЛТС 9.11.2, Томцат 8, МиСКЛ 5.7 и више.)

Када се примењује у производњи, КСВики треба да ради са Јава Сервлет контејнером и софтвером базе података. Као флексибилна вики платформа, КСВики званично пружа различите опције интеграције. Можете користити следећу команду да прикажете све доступне опције у КСВики ЛТС АПТ репо:

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

Ако желите да користите КСВики са најчешћим зависностима, можете инсталирати све потребне компоненте у једној команди на следећи начин:

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

Током процеса инсталације, од вас ће бити затражено да поставите нову лозинку за МиСКЛ роот корисника неколико пута. Само оставите поље за лозинку празним и притисните Enterда за сада прескочите овај корак. Касније ћемо се позабавити овим проблемом док обезбеђујемо инсталацију МиСКЛ-а.

Када будете упитани да ли желите Configure database for xwiki with dbconfig-common?, изаберите <Yes>и затим притисните ENTER.

Када се од вас затражи да унесете MySQL application password for xwiki, можете или да унесете одређену лозинку за МиСКЛ апликацију или оставите поље за лозинку празним. Потоњи ће рећи КСВики-ју да користи насумичну МиСКЛ лозинку за апликацију.

Када имате инсталиран КСВики и све потребне зависности, обезбедите инсталацију МиСКЛ-а:

sudo /usr/bin/mysql_secure_installation

Током процеса, програм ће вам поставити неколико питања. Одговорите им на следећи начин:

• Да ли желите да подесите додатак ВАЛИДАТЕ ПАССВОРД? Y
• Унесите 0 = НИСКО, 1 = СРЕДЊЕ и 2 = СНАЖНО: 2
• Нова лозинка: a-strong-MySQL-root-password
• Поново унесите нову лозинку: a-strong-MySQL-root-password
• Да ли желите да наставите са датом лозинком? Y
• Уклонити анонимне кориснике? Y
• Желите ли да забраните роот пријаву на даљину? Y
• Уклонити тестну базу података и приступити њој? Y
• Сада поново учитати табеле привилегија? Y

Повећајте безбедност КСВики-ја тако што ћете модификовати КСВики конфигурациони фајл.

Користите ви едитор да отворите КСВики конфигурациону датотеку:

sudo vi /etc/xwiki/xwiki.cfg

Пронађите две линије приказане испод:

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

Замените вредности оба параметра са два различита насумична низа и само се уверите да је дужина сваког стринга иста као и други, на пример:

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

Сачувај и затвори:

:wq!

Подразумевана квота меморије је прениска за покретање Томцат 8 и КСВики унутар. Морате да повећате подразумевану квоту меморије на следећи начин да бисте могли правилно да покренете КСВики инстанцу у Томцат 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М меморије је само минимална квота за покретање малог или средњег КСВики сајта. Можда ћете морати да прилагодите ову линију у складу са вашим специфичним захтевима.

Сачувај и затвори:

:wq!

Поново покрените Томцат 8 да бисте применили све своје модификације:

sudo systemctl restart tomcat8.service

Измените правила УФВ заштитног зида да бисте омогућили приступ вебу на порту 8080:

sudo ufw allow 8080
sudo ufw enable

Иницијализујте КСВики на Distribution Wizardвеб интерфејсу

У овом тренутку, поставили сте функционалну, али празну КСВики локацију. Да бисте попунили садржај, потребно је да завршите неколико накнадних задатака, укључујући креирање администраторског корисника и инсталирање укуса и потребних екстензија за овај вики, на почетном КСВики веб интерфејсу под називом " 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". Бићете доведени на КСВики контролну таблу као администратор који сте раније подесили.

(Опционално) Скратите УРЛ КСВики сајта

Подразумевано, пошто Томцат може да служи више од једне апликације у исто време, потребно је да приступите свом КСВики сајту на УРЛ адреси http://203.0.113.1:8080/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!

Коначно, поново покрените Томцат 8 да бисте применили све своје измене:

sudo systemctl restart tomcat8.service

Од сада ћете http://203.0.113.1:8080/директно посећивати свој КСВики сајт .

(Опционално) Подесите Нгинк обрнути прокси

Подразумевано, Томцат 8 ради на порту 8080, а своју КСВики локацију можете посетити само са истог порта. Ако желите да олакшате приступ посетиоцима уклањањем дела броја порта, можете да инсталирате Нгинк као обрнути прокси између КСВики-ја и посетилаца.

Прво, инсталирајте Нгинк користећи апт:

sudo apt install nginx -y

Затим подесите Нгинк као обрнути прокси модификујући његове подразумеване конфигурације сајта:

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!

Покрените Нгинк услугу и подесите је да се аутоматски покреће при покретању система:

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

Коначно, измените правила УФВ заштитног зида у складу са тим:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Од сада, посетиоци вашег КСВики сајта више не морају да наводе број порта. Требало би директно да посете http://203.0.113.1/.