Ubuntu 16.04 LTS에 XWiki 9.11.x를 설치하는 방법

• 전제 조건
• XWiki LTS APT 저장소 설정
• 하나의 XWiki 번들 (XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 등 포함)에 모두 설치하십시오.
• "배포 마법사"웹 인터페이스에서 XWiki 초기화
• (선택 사항) XWiki 사이트 URL 단축
• (선택 사항) Nginx 리버스 프록시 설정

XWiki는 Java로 작성된 인기있는 엔터프라이즈 급 오픈 소스 위키 플랫폼입니다. 확장 성과 사용 편의성을 갖춘 XWiki는 다양한 회사에 지식 저장소, 공개 포털 등으로 배포되고 있습니다.

이 기사에서는 Ubuntu 16.04 LTS 서버 인스턴스에 XWiki 9.11.2를 설치하는 과정을 안내합니다. OpenJDK 8, Tomcat 8 및 MySQL 5.7은 설치 과정에서 종속성으로 자동 설치됩니다.

전제 조건

• 최소 2GB의 메모리, 4GB 이상이 권장되는 새로운 Vultr Ubuntu 16.04 LTS x64 서버 인스턴스. 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 릴리스 (그러나 시도 할 경우 NOT LTS)를, 당신은 아래 XWiki APT의 repo를 대신 다운로드 할 수 있습니다 :

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 서블릿 컨테이너 및 데이터베이스 소프트웨어와 함께 작동해야합니다. 유연한 위키 플랫폼 인 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

설치 과정에서 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 = LOW, 1 = MEDIUM 및 2 = STRONG을 입력하십시오 : 2
• 새 비밀번호: a-strong-MySQL-root-password
• 새 비밀번호를 다시 입력하십시오 : a-strong-MySQL-root-password
• 제공된 비밀번호를 계속 사용 하시겠습니까? Y
• 익명 사용자를 제거 하시겠습니까? Y
• 원격으로 루트 로그인을 허용하지 않습니까? 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를 실행하기에 기본 메모리 할당량이 너무 낮습니다. Tomcat 8에서 XWiki 인스턴스를 올바르게 시작하기 전에 다음과 같이 기본 메모리 할당량을 늘려야합니다.

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

" Distribution Wizard"웹 인터페이스 에서 XWiki를 초기화하십시오

이제 기능적이지만 비어있는 XWiki 사이트를 설정했습니다. 컨텐츠를 작성하려면 " Distribution Wizard"(이) 라는 초기 XWiki 웹 인터페이스에서 관리자 작성 및이 위키에 대한 플레이버 및 필수 확장 설치를 포함하여 몇 가지 후속 작업을 완료해야합니다 .

즐겨 찾는 웹 브라우저를 가리키면 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 대시 보드가 나타납니다.

(선택 사항) XWiki 사이트 URL 단축

기본적으로 Tomcat은 동시에 여러 응용 프로그램을 제공 할 수 있으므로 URL에서 XWiki 사이트에 액세스해야합니다 http://203.0.113.1:8080/xwiki. 그러나 XWiki가 Tomcat에서 실행되는 유일한 응용 프로그램이고 /xwiki접미사 를 제거하여 XWiki 사이트의 URL을 줄이려면 다음과 같이 세 개의 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

이제부터는 http://203.0.113.1:8080/직접 XWiki 사이트를 방문하게 됩니다.

(선택 사항) Nginx 리버스 프록시 설정

기본적으로 Tomcat 8은 port 8080에서 작동 하며 동일한 포트에서만 XWiki 사이트를 방문 할 수 있습니다. 포트 번호 부분을 제거하여 방문자의 액세스를 용이하게하려면 XWiki와 방문자 간의 역방향 프록시로 Nginx를 설치할 수 있습니다.

먼저 apt를 사용하여 Nginx를 설치하십시오.

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/.