설치 가이드 · 5 min read · Dec 21, 2025
우분투 16.04에 XWiki 설치 및 구성 방법
XWiki는 Java로 작성된 무료 오픈 소스 위키 소프트웨어로 Tomcat, JBoss와 같은 서블릿 컨테이너에서 실행됩니다. XWiki는 MySQL 또는 PostgreSQL과 같은 데이터베이스를 사용하여 정보를 저장합니다. XWiki를 사용하면 구조화된 데이터를 저장하고 위키 인터페이스 내에서 서버 스크립트를 실행할 수 있습니다. 여러 블로그를 호스팅하고 XWiki를 사용하여 파일 및 폴더를 관리하거나 볼 수 있습니다.
XWiki는 많은 기능을 제공하며, 그 중 일부는 아래에 나열되어 있습니다:
- 버전 관리 및 ACL 지원.
- 와일드카드를 사용하여 전체 위키 검색 가능.
- 위키 페이지를 PDF, ODT, RTF, XML 및 HTML로 쉽게 내보내기.
- 콘텐츠 조직 및 콘텐츠 가져오기.
- WYSIWYG 편집기를 사용한 페이지 편집.
요구 사항
- 우분투 16.04에서 실행되는 서버.
- sudo 권한이 있는 비루트 사용자.
시스템 업데이트
시작하기 전에 우분투 리포지토리를 최신 버전으로 업데이트해야 합니다. 다음 명령어를 사용하여 수행할 수 있습니다:
sudo apt-get update -y
sudo apt-get upgrade -y리포지토리가 업데이트되면 모든 업데이트를 적용하기 위해 시스템을 재시작합니다.
Java 설치
Xwiki는 Java 기반 애플리케이션이므로 먼저 Java 8을 설치해야 합니다. 기본적으로 Java 8은 우분투 리포지토리에 없습니다. 웹업데이트팀 PPA 리포지토리를 시스템에 추가하여 Java 8을 설치할 수 있습니다.
먼저 다음 명령어를 실행하여 PPA를 추가합니다:
sudo add-apt-repository ppa:webupd8team/java다음으로 다음 명령어로 리포지토리를 업데이트합니다:
sudo apt-get update -y리포지토리가 최신 상태가 되면 다음 명령어를 실행하여 Java 8을 설치할 수 있습니다:
sudo apt-get install oracle-java8-installer -yJava를 설치한 후 다음 명령어로 Java 버전을 확인할 수 있습니다:
java -version다음과 같은 출력이 표시되어야 합니다:
Java version "1.8.0_91"
Java(TM) SE Runtime Environment (build 1.8.0_91-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.91-b14, mixed mode)
Xwiki 다운로드 및 설치
다음으로 XWiki에서 제공하는 설치 파일을 다운로드해야 합니다. 다음 명령어를 사용하여 다운로드할 수 있습니다:
wget http://download.forge.ow2.org/xwiki/xwiki-enterprise-installer-generic-8.1-standard.jar다운로드가 완료되면 아래와 같이 java 명령어를 사용하여 다운로드한 패키지 파일을 설치할 수 있습니다:
sudo java -jar xwiki-enterprise-installer-generic-8.1-standard.jar다음과 같은 출력이 표시되어야 합니다:
28 Jan, 2018 6:57:37 PM INFO: Logging initialized at level 'INFO'
28 Jan, 2018 6:57:37 PM INFO: Commandline arguments:
28 Jan, 2018 6:57:37 PM INFO: Detected platform: ubuntu_linux,version=3.19.0-25-generic,arch=x64,symbolicName=null,javaVersion=1.7.0_151
28 Jan, 2018 6:57:37 PM WARNING: Failed to determine hostname and IP address
Welcome to the installation of XWiki Enterprise 8.1!
The homepage is at: http://xwiki.org/
Press 1 to continue, 2 to quit, 3 to redisplay
이제 설치를 계속하려면 1을 누르세요. 다음과 같은 출력이 표시되어야 합니다:
Please read the following information:
XWiki Enterprise - Readme
XWiki Enterprise Overview
XWiki Enterprise는 두 번째 세대 위키 엔진으로, Wiki, Blog, Comments, User Rights, LDAP 인증, PDF 내보내기 등과 같은 전문 기능을 제공합니다.
XWiki Enterprise는 또한 데이터 기반 인트라넷 애플리케이션을 구축하기 위한 이상적인 개발 환경을 제공하는 고급 양식 및 스크립팅 엔진을 포함합니다. 강력한 확장성 기능을 갖추고 있으며 스크립팅, 확장 기능을 지원하고 매우 모듈화된 아키텍처를 기반으로 합니다. 스크립팅 엔진은 XWiki 리포지토리에 읽기 및 쓰기 모드로 접근할 수 있는 강력한 API에 접근할 수 있게 해줍니다.
XWiki Enterprise는 전 세계 주요 기업에서 사용되며 XWiki의 전문적인 사용을 위한 강력한 지원을 제공합니다.
포인터
설치가 완료된 후 XWiki를 시작하는 데 도움이 되는 몇 가지 포인터입니다:
문서는 XWiki.org 웹사이트에서 찾을 수 있습니다.
문제가 발생하면 문제 추적기에 문제를 제출해 주세요.
XWiki 사용자 또는 개발자와 대화하고 싶다면 우리의
메일링 리스트 및 포럼을 사용해 주세요.
XWiki의
소스 코드에 접근할 수도 있습니다.
상업적 지원이 필요하면
지원 페이지를 방문해 주세요.
Press 1 to continue, 2 to quit, 3 to redisplay
이제 설치를 계속하려면 1을 누르세요. 다음과 같은 출력이 표시되어야 합니다:
See the NOTICE file distributed with this work for additional
information regarding copyright ownership.
This is free software; you can redistribute it and/or modify it
under the terms of the GNU Lesser General Public License as
published by the Free Software Foundation; either version 2.1 of
the License, or (at your option) any later version.
This software is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this software; if not, write to the Free
Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
02110-1301 USA, or see the FSF site: http://www.fsf.org.
Press 1 to accept, 2 to reject, 3 to redisplay
이제 라이센스 계약을 수락하려면 1을 누르세요. 다음과 같은 출력이 표시되어야 합니다:
Select the installation path: [/usr/local/XWiki Enterprise 8.1]
Press 1 to continue, 2 to quit, 3 to redisplay
이제 Enter를 누르고 기본 설치 경로를 선택하려면 1을 누르세요. 다음과 같은 출력이 표시되어야 합니다:
[x] Pack 'Core' required
???????????????????????????????????????????????????????????????????????????????
[x] Include optional pack 'Default Wiki'
???????????????????????????????????????????????????????????????????????????????
Enter Y for Yes, N for No:
Y
Press 1 to continue, 2 to quit, 3 to redisplay
이제 Y를 누르고 1을 눌러 설치를 계속하세요. 다음과 같은 출력이 표시되어야 합니다:
[ Starting to unpack ]
[ Processing package: Core (1/2) ]
[ Processing package: Default Wiki (2/2) ]
[ Unpacking finished ]
이제 사용자에 대한 바로 가기를 생성하라는 메시지가 표시됩니다. ‘ Y‘를 눌러 추가할 수 있습니다. 다음으로 자동 설치 스크립트를 생성하라는 메시지가 표시됩니다. 기본값을 선택하려면 Enter를 누르세요. 설치가 완료되면 다음과 같은 출력이 표시되어야 합니다:
???????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????
Generate an automatic installation script
???????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????
Enter Y for Yes, N for No:
Y
Select the installation script (path must be absolute)[/usr/local/XWiki Enterprise 8.1/auto-install.xml]
Installation was successful
application installed on /usr/local/XWiki Enterprise 8.1
[ Writing the uninstaller data ... ]
[ Console installation done ]
이제 XWiki가 시스템에 설치되었습니다. 아래와 같이 XWiki 시작 스크립트를 시작할 시간입니다:
cd /usr/local/XWiki Enterprise 8.1
sudo bash start_xwiki.sh프로세스 시작을 위해 잠시 기다려 주세요. 이제 터미널에 다음과 같은 메시지가 표시되어야 합니다:
start_xwiki.sh: 79: start_xwiki.sh:
Starting Jetty on port 8080, please wait...
2018-01-28 19:12:41.842:INFO::main: Logging initialized @1266ms
2018-01-28 19:12:42.905:INFO:oejs.Server:main: jetty-9.2.13.v20150730
2018-01-28 19:12:42.956:INFO:oejs.AbstractNCSARequestLog:main: Opened /usr/local/XWiki Enterprise 8.1/data/logs/2018_01_28.request.log
2018-01-28 19:12:42.965:INFO:oejdp.ScanningAppProvider:main: Deployment monitor [file:/usr/local/XWiki%20Enterprise%208.1/jetty/contexts/] at interval 0
2018-01-28 19:13:31,485 [main] INFO o.x.s.s.i.EmbeddedSolrInstance - Starting embedded Solr server...
2018-01-28 19:13:31,507 [main] INFO o.x.s.s.i.EmbeddedSolrInstance - Using Solr home directory: [data/solr]
2018-01-28 19:13:43,371 [main] INFO o.x.s.s.i.EmbeddedSolrInstance - Started embedded Solr server.
2018-01-28 19:13:46.556:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@2c9f9fb0{/xwiki,file:/usr/local/XWiki%20Enterprise%208.1/webapps/xwiki/,AVAILABLE}{/xwiki}
2018-01-28 19:13:46.697:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@64c37088{/,file:/usr/local/XWiki%20Enterprise%208.1/webapps/root/,AVAILABLE}{/root}
2018-01-28 19:13:46.776:INFO:oejs.ServerConnector:main: Started ServerConnector@1ffa4bae{HTTP/1.1}{0.0.0.0:8080}
XWiki가 이제 실행 중입니다. XWiki 웹 인터페이스에 접근할 시간입니다.
XWiki 접근
XWiki는 8080 포트에서 실행되므로 방화벽을 통해 8080 포트를 허용해야 합니다. 먼저 다음 명령어로 UFW 방화벽을 활성화합니다:
sudo ufw enable다음으로 다음 명령어로 UFW 방화벽을 통해 8080 포트를 허용합니다:
sudo ufw allow 8080/tcp다음으로 다음 명령어를 실행하여 방화벽 규칙을 다시 로드하여 모든 변경 사항을 적용합니다:
sudo ufw reload다음 명령어로 UFW 방화벽의 상태를 확인할 수 있습니다:
sudo ufw status이제 웹 브라우저를 열고 URL http://your-server-ip:8080을 입력하면 다음과 같이 XWiki 홈페이지로 리디렉션됩니다:
언제든지 터미널에서 Ctrl + C 버튼을 눌러 XWiki 서버를 중지할 수 있습니다.
결론
축하합니다! 우분투 16.04 서버에 XWiki를 성공적으로 설치하고 구성했습니다. 이제 우분투 16.04 서버에서 XWiki를 사용하여 자신의 위키 사이트를 쉽게 호스팅할 수 있기를 바랍니다. 더 많은 정보는 https://www.xwiki.org/xwiki/bin/view/Documentation/에서 XWiki 공식 문서 페이지를 확인하세요. 질문이 있으면 언제든지 댓글을 남겨주세요.
새 게시물을 받은 편지함에서 받기
스팸은 없습니다. 언제든지 구독 해지 가능합니다.