the tree/설치 방법

• the tree는 기존 상용 위키 엔진과 다르게 설치 방법이 많이 복잡한 편이다.
• 그렇기 때문에 많은 사람들이 해당 엔진을 보다 쉽게 접근할 수 있게 가이드라인을 작성하는 문서가 이 문서이다.
• 설치법이라는 것은 운영체제에 따라 많이 다를 수 있고, 프로그램 버전에 따라 달라질 수 있기 때문에 중간에 막힌다고 개발자나 타 위키 운영자에게 무작정 문의하지 말고 일단 찾아보고 help할 것.

• the tree는 서버 자원을 꽤 먹는 프로그램이다. 그렇기 때문에 권장 사양은 다음과 같다.
  • 램 4GB 이상일 것.
    • 검색 서버와 DB가 idle 상태[1] 기준 각각 500MB 언저리임. 당연히 위키 엔진이나 운영 체제까지 돌리려면 아무리 못해도 2GB는 넘어야 한다.
  • CPU 성능은 좋으면 좋을 수록 좋음.
    • DB에서 문서를 불러오는 속도, 검색 성능에 영향을 미침.
• 본 문서에서 작성하는 설치 방법은 다음 환경과 같다.
  • Ubuntu 24.04.1 LTS
  • x86

• 시작하기 전에 apt 업데이트

sudo apt update
sudo apt upgrade -y

• nvm 설치.
• https://github.com/nvm-sh/nvm?tab=readme-ov-file

• nvm으로 20 버전 설치.

nvm install 20

• node.js 버전 관리 n도 있으니 참고.

• 위키 엔진 재시작 기능을 사용하기 위한 pm2 설치

npm install pm2 -g

• 위키 엔진의 DB 설치
• apt는 업데이트가 느리기 때문에 apt로 설치하는 것은 추천하지 않음.
• MongoDB 메뉴얼은 한국어로 친절히 작성되어 있고, 명령어가 바뀔 수도 있기 때문에 공식 문서를 참고할 것.
  • Ubuntu 기준
  • Ubuntu가 아닐 경우

sudo systemctl status mongod
# ^ MongoDB 실행 중인지 확인
mongosh
# ^ MongoDB 접속

• DB 생성하고 DB에 접속할 user 만들기

use test123 //test123 DB 생성 및 접속
db.createUser({ user: "test01", pwd: "mypassword", roles: [ "readWrite" ]}) //test01 계정으로 mypassword 비밀번호로 readWrite 권한으로 계정 생성
db.getUsers(); //생성된 User 확인

• 만약 계정 생성이 되지 않는다면,

vi /etc/mongod.conf //MongoDB 설정 파일 vi로 열기
security: //주석 제거후

authorization: enabled //추가

• 그래도 DB 접근 불가 오류가 발생한다면,

mongosh //MongoDB 접속
use admin //admin DB 접속
db.createUser({ user: "test01", pwd: "mypassword", roles: [ "readWrite" ]}) //test01 계정으로 mypassword 비밀번호로 readWrite 권한으로 계정 생성

• 설치하기
• systemctl에 추가해서 실행 편하게 하기

• 초기 설정 및 첫 실행은 다음 문서를 참고하자.
• the tree/위키 구축