blah blah

XWiki Setting

standalone 다운 받아서 잠시 써오다 팀 공용 PC 로 이전하면서 tomcat, MySQL 로 변경 작업을 했다.

일단 WAR 파일을 이용한 기본 설치 방법은 XWiki 공식 설치 문서를 참고하면 된다.

다음으로 MySQL 설정은 이 문서 ( http://platform.xwiki.org/xwiki/bin/view/AdminGuide/InstallationMySQL ) 보고 작업해주면 되는데 이 부분에서 의외로 발목 잡혀서 그 내용을 집중 정리해본다.
MySQL 이용하기 위해서는 우선 /WEB-INF/hibernate.cfg.xml 에서 hsqldb 로 설정 활성화되어 있던 부분을 코멘트 처리하고 MySQL 설정 부분을 활성화 시켜주어야 한다.
이것만 해주면 될 줄 알았다.  브라우져에서 접속해보니
javax.servlet.ServletException: Error number 3 in 0: Could not initialize main XWiki context
Wrapped Exception: Error number 3001 in 3: Cannot load class com.xpn.xwiki.store.migration.hibernate.XWikiHibernateMigrationManager from param xwiki.store.migration.manager.class

500 에러만 나고 실행되지 않는다.

복잡하게 이것 저것 고민했는데 당연하다고 여긴 것 부터 의심했어야 했다.

MySQL jdbc 드라이버가 배포 WAR 에는 들어 있지 않다. ( 위 MySQL 문서에도 언급되어 있는데 놓쳤다 ㅜㅠ )

/WEB-INF/lib 디렉토리에  jdbc 드라이버 파일을 집어 넣고 다시 실행해봤다.

이것만 해주면 정말 될 줄 알았다… 또 500 에러. DB 풀 생성 못했다며 hibernate.cfg.xml 설정 이상 없는지 점검해보라는데 아무리 봐도 이상없다.

이 에러 때문에 정말 한참 고생하다가 /WEB-INF/xwiki.cfg 파일에서 아래 부분 활성화해 주었다.

xwiki.store.hibernate.path=/WEB-INF/hibernate.cfg.xml

혹시 몰라서 이것도 활성화

xwiki.store.migration.manager.class=com.xpn.xwiki.store.migration.hibernate.XWikiHibernateMigrationManager

여전히 에러 …
hibernate.cfg.xml 에서 connection.url 기본 설정값을 인자없이 설정해보았다.

기본 : jdbc:mysql://localhost/xwiki?useServerPrepStmts=false&useUnicode=true&characterEncoding=UTF-8&sessionVariables=sql_mode=”
변경 : jdbc:mysql://localhost/xwiki

다시 실행. 드디어 텅빈 메인 화면이 뜬다.

기본 위키 문서 등이 포함되어 있는 xwiki-enterprise-wiki-**.xar 을 import 기능을 이용해서 설치하니 ( 기본 설치 시 처음에는 Admin 계정으로 로긴 안해도 이 기능 사용하게 되어 있다 ) 이제야 Xwiki 기본 꼴은 갖추고 표시된다.

  • 주 : import 하려고 xar 파일 선택해서 upload 버튼 눌러도 파일 선택하라는 메시지만 표시되고 아무 변화 없다면 위에 링크해 둔 MySQL 설정 문서에서 “max_allowed_packet” 부분 참고해서 패킷 크기를 늘여주어야 한다.

자, 이제 후속 작업.

기존 standalone 에 작성했던 컨텐츠들을 이전해와야 하는데 Xwiki 의 안내 문서에 따르면 “Administrater Wiki > Content > Export” 에서 xar 파일로 내보낸 뒤 import 하면 된다고 나와 있던데 …

아뿔싸! standalone 에 추가로 뭘 설정(치)해야 되는지 Export 화면이 텅 비어 있어서 아무 것도 할 수 없었다 ㅜㅠ

작성한 컨텐츠도 얼마 안되고 해서 단순 무식한 방법을 선택했다. 각 페이지 마다에서 제공하는 “Export as XAR” 기능 이용해서 페이지 단위로 export 한 후 “Administrater Wiki > Content > Import” 로 이전.

그럭저럭 등록사용자/그룹 정보 외에는 이전 완료.

기타

  • 기본 관리자 계정은 Admin/admin (대소문자 구분하니 주의)
  • Admin 로긴 정보를 잊어 먹거나 했을 때는 xwiki.cfg  에서 “xwiki.superadminpassword=” 부분을 활성화 시킨 후 superadmin 계정으로 로긴해서 처리하면 된다.
Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s