98..Etc/jspwiki2010. 11. 30. 16:08
반응형
프로젝트에서 의사소통 및 문서정리를 위해서 wiki를 하나 설치하기로 했다. Trac같이 이슈트랙킹과 wiki가 같이 제공하는 것도 좋지만 이슈 트랙킹은 다른 것으로 하기에 간단한 걸 하나 구하기로 했다.
내가 쓰는 언어가 Java이니 문제 발생할 경우 그래도 복구가 가능한 java 기반의 JSPWiki를 선택했다.

1. Requirements
다음과 같은 시스템 요구사항을 가진다. 일반적인 것이기 때문에 다음 소프트웨어의 설치는 생략한다.

  • Java 1.4 이상
  • tomcat 5.5 이상


2. 다운로드
다음 URL에서 JSPWiki를 다운받는다.
http://www.jspwiki.org/wiki/JSPWikiDownload
여기서 설치할 버전은 2.6.4를 기준으로 한다.

3. 설치
Zip 파일을 풀면 JSPWiki.war 파일이 있다. tomcat을 구동하고 webapps 밑에 복사한다.
여기 경우는 context root를 단순히 wiki로 하기 위해 wiki.war로 이름을 바꾸어서 webapps 밑에 넣었다.
tomcat 이 war를 풀면서 다음과 같은 에러가 발생한다. 일단 무시하고 tomcat을 내린다.

java.lang.NullPointerException
        at com.ecyrd.jspwiki.util.WatchDog.enterState(WatchDog.java:231)
        at com.ecyrd.jspwiki.search.LuceneSearchProvider$LuceneUpdater.backgroundTask(LuceneSearchProvider.java:711)
        at com.ecyrd.jspwiki.util.WikiBackgroundThread.run(WikiBackgroundThread.java:135)

이제 war가 풀린 디렉토리에서 작업할 것이다. webapps/wiki.war는 삭제하고 풀린 webapps/wiki 만 남긴다. 주의할 점은 tomcat이 기동된 상태에서 wiki.war를 삭제하면 wiki 디렉토리도 삭제된다는 점이다.

4. WEB-INF/jspwiki.properties 수정
각종 wiki 데이터가 생성될 디렉토리가 필요하다. 여기서는 /home/wikidata 디렉토리 생성했다.

그리고 tomcat의 webapps/wiki 디렉토리 밑의 WEB-INF/jspwiki.properties 중 다음 내용을 수정한다.

...
jspwiki.fileSystemProvider.pageDir = /home/wikidata/
...
jspwiki.basicAttachmentProvider.storageDir = /home/wikidata/
...
log4j.appender.FileLog.File = /home/wikidata/jspwiki.log
...

그리고 다시 tomcat 시작...

5. 설치확인
다음 URL로 접속하여 설치사항을 확인한다. 물론 ip와 port는 자신의 환경에 맞게...
URL: http://localhost:8080/wiki/Install.jsp
처음에는 관리계정이 없다. 각각 설정을 확인하고 "Configure" 버튼을 클릭한다. 그러면 설치가 되고 admin 계정이 생성되고 임의적으로 생성된 Password를 알려준다.
생성된 admin 암호는 "Configure" 클릭한 다음 화면에 나타나니 화면이동 말고 잘 적어둔다.

6. 접속
다음 URL에 접속하고 admin으로 로그인해서 이것 저것 살펴본다. ^^
http://localhost:8080/wiki/

출처 : http://greatkim91.tistory.com/entry/JSPWiki-%EC%84%A4%EC%B9%98%ED%95%98%EA%B8%B0

Posted by 1010