이 페이지에는 MoniWiki 설치에 대한 설명이 있습니다. TeX 을 리눅스에 설치하는 방법은 LinuxInstall 에, 윈도에 설치하는 방법은 InstallTL2014Windows 에 있습니다.
1. 설치 전 필요환경 ¶
윈도우 고급사용자가 아니라면 Apache와 rcs/diff 등등이 미리 배포에 포함되어 있는 MicroApache를 사용하시기 바랍니다.
아파치 웹서버 / PHP 등등을 직접 설치하고 자유자재로 세팅할 수 있는 고급사용자 혹은 APM(apache + php + mysql) 배포등을 이미 설치했고 자신이 직접 세팅 가능한 고급사용자의 경우는 다음을 참고하세요.
아래 설명은 대개 유닉스를 기준으로 설명하기때문에 윈도우 고급사용자의 경우 이점을 유의하셔야 하며, 윈도우 고급사용자가 아니라면 설치하기 편리한 MicroApache 사용을 권장합니다.
- 아파치 웹서버, PHP 4.2.3 이상
- rcs / diff
rcs
가 설치되었는지 확인한다. /usr/bin/rlog /usr/bin/ci /usr/bin/co
등등의 실행파일이 있어야 한다. /usr/bin/merge
도 필요하다. PHP gettext 모듈이 필요하다. See also MoniWikiRcs
3. 압축을 적절한 곳에 푼다 ¶
$ tar --same-permissions -xzvf moniwiki-1.1.x.tgz
압축을 풀면 moniwiki라는 디렉토리 밑에 화일들이 있는 것을 볼 수 있다.
디렉토리 이름을 원하는 것으로 바꿀 수도 있다. 예를 들어
/wiki
라고 바꿀 수 있으며
기본 값은 /moniwiki
이다.
4. monisetup.sh를 실행한다 ¶
monisetup.sh를 실행하여 디렉토리의 쓰기권한을 조정한다. (기본값은 2777) 이렇게 하여야 MoniSetup.php를 실행시킬 수 있게 된다.
( 실행명령어는 프롬포트상에서
sh monisetup.sh
)
윈도우즈 환경에서는 곧바로 monisetup.php를 실행하시면 됩니다. (구버전의 모니위키에서는 monisetup.bat를 실행해야 합니다).
5. MoniSetup ¶
처음 설치할 경우 MoniSetup을 이용해서 config.php를 만들게 된다.
여기서 가장 중요한 것은
$url_prefix
를 고치는 것이다. 이 값은 초기에 자동으로 설정되며,
이 값을 제대로 지정하면 MoniSetup에서 다음과 같은 로고 그림을 볼 수 있다.
- 처음 실행하면
monisetup.php
가 자동으로 뜨며 자신의 환경에 맞는 config.php를 가 만들어진다. - 다시 monisetup.php를 열면 필요한 몇몇 디렉토리가 만들어진다.
- MoniWiki를 처음 설치할 경우는 WikiSeed를 심을것인지를 선택한다.
씨앗을 심는 경우는 불필요한 페이지가 들어갈 수 있는데, 어느정도 익숙해졌다고 생각되면 지워도 되며, 아예 처음부터 설치하지 않아도 된다.
그러나 초보사용자라면 SystemPages는 반드시 설치하는 것을 권장한다.
$admin_passwd
를 반드시 설정해 주세요
6. secure.sh를 실행한다 ¶
secure.sh
를 실행해서 다른 사람들이 자신의 Wiki 설정을 볼 수 없게,고칠 수 없게 한다.
설치가 끝났습니다. 이제 위키위키를 즐기세요 !!
윈도우즈 환경에서는
secure.sh
를 실행하실 필요가 없습니다.
7. 설정하기 ¶
모니위키 설치가 끝났지만 사용자의 입맛에 맞게 설정하고자 한다면 다음을 참고하세요.
- MoniWikiOptions 모니위키의 다양한 옵션을 조정한다.
- 그밖의 질문은 http://kldp.net/projects/moniwiki/forum (모니위키 프로젝트 홈페이지의 게시판)
9. 기타 주의사항 ¶
- MoniSetup을 실행시킬 때,
$admin_passwd
를 설정하면 자신만 DeletePage할 수 있다. 이 값을 설정하면, 차후에 MoniSetup을 할 때 이 값을 알아야 고칠 수 있으며, config.php에 이 값이 들어가므로 수동으로 고칠 수 있다. See also AdminPassword $rcs_user
의 기본 값은 "root"이나, 위키를 처음 설치할 경우는 이 값을 조절할 수 있다. 한번 결정한 후에는 이 값을 계속해서 써야한다.- 윈도우즈에서 설치할 때에 이 값이 바뀔 수 있다. 업그레이드를 하여 데이타를 옮겼을 경우에 이 값을 계속 유지하도록 해주어야 한다.
-
$rcs_user
값이 변경되면 버전관리를 쓸 수 없으므로 유의해야 한다.
10. 관리 ¶
업그레이드를 편리하게 하려면, 플러그인을 새로 추가할 경우는 원 파일을 고치는 것보다는 새롭게 플러그인을 만들어 준다. 이렇게 하면 tar파일을 덮어쓰는 것만으로 간단히 업그레이드 할 수 있다.
11. 업그레이드 ¶
모니위키 1.1.3 이후 최신 버전부터는 UpgradeScript를 제공하여 보다 편리하게 업그레이드/다운그레이드를 할 수 있다.
특별한 경우가 아니라면, 덮어쓰는 것만으로 업그레이드 할 수 있다. 원 파일을 수정하였을 경우라면 덮어쓰는 것을 선택적으로 해주어야 할 것이다.
- 기존의 data디렉토리는 전혀 덮어씌여지지 않는다. 그러나 만약의 실수를 대비하기 위해서 업그레이드 하기 전에는 data/text 디렉토리의 내용을 백업해 두는 것이 좋을 것이다.
12. 백업 ¶
root사용자라면 tar를 이용해서 간단히 백업할 수 있겠고, 호스팅을 하는 일반 사용자의 경우라면 backup restore를 액션을 이용할 수 있다.
- backup :
?action=backup
해 보라. 백업은 data 디렉토리의 user와 text를 및 기타 몇몇 설정을 보존한다. pds/ 디렉토리를 보존하지는 않는다. 백업된 파일은 pds/ (혹은 $upload_dir로 정의된 위치) 하위에 저장된다. - restore :
?action=restore
한다. 백업된 tar 파일 목록이 나오고 tar 파일을 선택하면 관리 비번을 물어본다. - 윈도우즈 사용자라면 퍼미션이 문제가 되지 않으므로 간단히
data
디렉토리를 통채로 복사해서 보존하면 될것이다.