XWIKI 팁 정리

22 Feb 2022

Reading time ~2 minutes

xwiki TIP 정리

1. 인터넷이 안되는 환경에서는 XIP Package를 이용하세요.

xwiki는 xwiki extension manager를 통해서 많은 확장 기능을 제공합니다. 기능들의 설치는 인터넷 환경에서 쉽게 할 수 있습니다. 만약 인터넷 환경이 안되는 경우, Download XWiki 13.10.3에서 Demo Installation 밑에 있는 Standard Flavor Pre-installed를 다운로드 합니다.

그리고, Production Installation 밑에 있는 XIP Package를 다운로드 합니다.

먼저 Standard Flavor Pre-installed를 설치하려는 곳에 압축을 해제 합니다.

그리고 {압축을 해제한 디렉토리-이하 XWIKI_ROOT}/data/extantion/repository/에 XIP Package의 압축을 해제 합니다.

이후 {XWIKI_ROOT}에서 start_xwiki.sh를 실행하면 인터넷 없는 환경에서 기본적으로 설치된 플러그인들이 함께 설치 됩니다.

2. export PDF 시 한글이 ### 으로 깨질 경우

이건 해결 방법이 쉽습니다.

Administer Wiki -> Content -> Localization 에서 Default Language 를 한국어(korean)로 수정하면 이후 한글이 깨지지 않고 표출 됩니다.

3. 인터넷이 안되는 환경에서 Extensions 을 설치

우선 1번 방식으로 인터넷 환경에서 설치 합니다. 그리고 필요한 Extensions들을 Administer Wiki -> Extensions -> Extensions 를 통해서 설치합니다.

이후 1번의 {XWIKI_ROOT}를 다시 압축해서 인터넷이 안되는 환경으로 가지고 가서 실행하면 됩니다.

추가로 DBMS를 hsql(파일)이 아닌 mysql, 또는 다른 DBMS라면 해당 데이터 베이스도 백업해서 함께 가지고 가야 합니다.

4. Visual Realtime Collaborative Editor

여러 명이 함께 수정하는 기능의 플러그인 설치관련 tip 입니다.

Visual Realtime Collaborative Editor 플러그인만 설치하면 동작하지 않습니다.

Realtime WYSIWYG Editor플러그인의 확장이기 때문에, 먼저 Realtime WYSIWYG Editor를 설치해야 정상 동작합니다. 더 중요한건, 1.4.0 버젼이 아닌 13.9-rc-1 버젼을 설치해야합니다.

해당 기능은 web socket을 통해 동작하기 때문에 8093 port가 오픈되어야 정상 동작합니다.

모두 설치가 되면 아래와 같이 수정이나 등록시 Allow Realtime Collaboration 체크박스가 생겨있으며, 활성시 realtime editor로 이동합니다.

5. LDAP Application 설치 및 설정

XWIKI에서 LDAP 플러그인 설치는 조금 복잡합니다.

LDAP Authenticator 설치

Administer Wiki -> Extensions -> Extensions 에서 LDAP Authenticator를 찾아서 설치 합니다.

LDAP Application 설치

LDAP Application은 extensions에서 검색되지 않음으로 URL을 통해서 다운로드 받아야 합니다.

LDAP Application 플러그인을 다운로드 받습니다.

다운로드 받은 파일(org.xwiki.contrib.ldap_ldap-ui_9.5.7.xar)을 Administer Wiki -> Content -> Import에 업로드 합니다. 이후 Available packages에서 org.xwiki.contrib.ldap_ldap-ui_9.5.7.xar를 선택하고 오른쪽에 import 버튼을 클릭합니다.

xwiki.cfg 수정

{XWIKI_ROOT}/webapps/xwiki/WEB-INF/xwiki.cfg 파일의 가장 아래에 아래 내용을 추가 합니다.

#-# LDAP authentication service
xwiki.authentication.authclass=org.xwiki.contrib.ldap.XWikiLDAPAuthServiceImpl

#-# Turn LDAP authentication on - otherwise only XWiki authentication
#-# - 0: disable
#-# - 1: enable
#-# The default is 0
xwiki.authentication.ldap=1

#-# Enable local accounts in addition to LDAP.
#-# Without this setting you will be unable to log into XWiki with local accounts.
#-# - 0: disable
#-# - 1: enable
#-# The default is 0
xwiki.authentication.ldap.trylocal=1

LDAP 확인

이후 서버를 재기동 하면 Administer Wiki -> Other -> LDAP 메뉴를 확인 할 수 있습니다.

잘못된 설정이 있으면, 상위에 경고창이 뜹니다.

6. DATABASE 변경-Connecting xwiki instance to another database

{XWIKI_ROOT}/webapp/xwiki/WEB-INF/hibernate.xml 의 DB 접속 정보를 수정하여도 xwiki 데이터베이스로 접근을 합니다.

hibernate.xml 내용 예시

...
<property name="connection.url">jdbc:mysql://localhost/xwiki_v2?useSSL=false</property>
...

{XWIKI_ROOT}/webapp/xwiki/WEB-INF/xwiki.cfg 파일에 xwiki.db 값을 추가로 변경 해줘야 정상 동작 합니다.

...
xwiki.db=xwiki_v2
...