EDRSPIHCRSSRSS

Help On Installation

<!> 이 페이지에는 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
  • <!> rcs가 없어도 사용할 수 있으나 백업본이 저장되지 않습니다.
  • 최신 모니위키는 PHP로 만들어진 RcsLite를 제공하며, rcs를 사용할 수 없는 환경에서 rcs 대용으로 사용할 수 있습니다.
  • 윈도우즈 사용자의 경우 MicroApache 웹서버가 포함된 배포를 받으실 수 있습니다.
  • 윈도우즈에서 모니위키를 설치하는 방법은 ApacheMoniwikiInstaller을 참고 하십시오.

2. 다운로드 받는다


최신 스냅샷은 SnapShot 페이지에서 받으실 수 있습니다.

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에서 다음과 같은 로고 그림을 볼 수 있다.


  1. 처음 실행하면 monisetup.php가 자동으로 뜨며 자신의 환경에 맞는 config.php를 가 만들어진다.
  2. 다시 monisetup.php를 열면 필요한 몇몇 디렉토리가 만들어진다.
  3. MoniWiki를 처음 설치할 경우는 WikiSeed를 심을것인지를 선택한다. 씨앗을 심는 경우는 불필요한 페이지가 들어갈 수 있는데, 어느정도 익숙해졌다고 생각되면 지워도 되며, 아예 처음부터 설치하지 않아도 된다.
    그러나 초보사용자라면 SystemPages는 반드시 설치하는 것을 권장한다.

/!\ 처음 설치할 때 관리 비밀번호 $admin_passwd를 반드시 설정해 주세요 /!\

6. secure.sh를 실행한다

secure.sh를 실행해서 다른 사람들이 자신의 Wiki 설정을 볼 수 없게,고칠 수 없게 한다.

설치가 끝났습니다. 이제 위키위키를 즐기세요 !!

/!\ 윈도우즈 환경에서는 secure.sh를 실행하실 필요가 없습니다.

7. 설정하기

모니위키 설치가 끝났지만 사용자의 입맛에 맞게 설정하고자 한다면 다음을 참고하세요.

8. 동설치

9. 기타 주의사항

  1. MoniSetup을 실행시킬 때, $admin_passwd를 설정하면 자신만 DeletePage할 수 있다. 이 값을 설정하면, 차후에 MoniSetup을 할 때 이 값을 알아야 고칠 수 있으며, config.php에 이 값이 들어가므로 수동으로 고칠 수 있다. See also AdminPassword
  2. $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디렉토리를 통채로 복사해서 보존하면 될것이다.

13. 윈도우즈

  • 모니위키 1.1.3.1부터는 MicroApache와 함께 배포되고 있다. MicroApache는 아파치를 작게 줄인 윈도우즈용 배포판이며, 모니위키를 보다 손쉽게 맛볼 수 있게 해준다.
  • 특히 모니위키 1.2.0부터는 MicroApache 배포가 개선되어서 USB에도 설치하여 사용할 수 있다.

14. 그밖의 참고 사이트

  • 윈도우판 설치법 : http://parkpd.egloos.com/3285386 -- rigmania 2010-05-19 23:03:49
    • VimProcessor 페이지에 윈도우즈에 관련된 설명을 추가했습니다.
    • 위의 링크 설명으로 가보니 모니위키 1.1.2의 문제점은 이미 해결되었고, vim관련 옵션은 VimProcessor를 살펴보세요.