the tree/설치 방법(r3 Blame)
| r3 | ||
|---|---|---|
| r1 (새 문서) | 1 | [[분류:위키 엔진]] |
| 2 | [include(틀:상위 문서, 문서=the tree)] | |
| 3 | [목차] | |
| 4 | ||
| 5 | == 시작하기 전 == | |
| 6 | === 주의 사항 === | |
| 7 | * the tree는 기존 상용 위키 엔진과 다르게 설치 방법이 많이 복잡한 편이다. | |
| 8 | * 그렇기 때문에 많은 사람들이 해당 엔진을 보다 쉽게 접근할 수 있게 가이드라인을 작성하는 문서가 이 문서이다. | |
| 9 | * 설치법이라는 것은 운영체제에 따라 많이 다를 수 있고, 프로그램 버전에 따라 달라질 수 있기 때문에 '''중간에 막힌다고 개발자나 타 위키 운영자에게 무작정 문의하지 말고 __일단 찾아보고__ help할 것'''. | |
| 10 | ||
| 11 | === 환경 === | |
| 12 | * the tree는 서버 자원을 꽤 먹는 프로그램이다. 그렇기 때문에 권장 사양은 다음과 같다. | |
| 13 | * 램 4GB 이상일 것. | |
| 14 | * 검색 서버와 DB가 idle 상태[* 가만히 있을 때를 말함.] 기준 각각 500MB 언저리임. 당연히 위키 엔진이나 운영 체제까지 돌리려면 아무리 못해도 2GB는 넘어야 한다. | |
| 15 | * CPU 성능은 좋으면 좋을 수록 좋음. | |
| 16 | * DB에서 문서를 불러오는 속도, 검색 성능에 영향을 미침. | |
| 17 | * 본 문서에서 작성하는 설치 방법은 다음 환경과 같다. | |
| 18 | * Ubuntu 24.04.1 LTS | |
| 19 | * x86 | |
| 20 | ||
| 21 | == 설치 방법 == | |
| 22 | * 시작하기 전에 apt 업데이트 | |
| 23 | > sudo apt update | |
| 24 | > sudo apt upgrade -y | |
| 25 | ||
| 26 | === node.js === | |
| r3 | 27 | * nvm 설치. |
| r1 (새 문서) | 28 | * [[https://github.com/nvm-sh/nvm?tab=readme-ov-file#installing-and-updating]] |
| 29 | ||
| 30 | * nvm으로 20 버전 설치. | |
| 31 | > nvm install 20 | |
| 32 | * node.js 버전 관리 n도 있으니 참고. [[https://www.npmjs.com/package/n| ]] | |
| 33 | ||
| r2 | 34 | * 위키 엔진 재시작 기능을 사용하기 위한 pm2 설치 |
| 35 | > npm install pm2 -g | |
| r1 (새 문서) | 36 | |
| r2 | 37 | === MongoDB === |
| 38 | * 위키 엔진의 DB 설치 | |
| 39 | * apt는 업데이트가 느리기 때문에 apt로 설치하는 것은 추천하지 않음. | |
| r1 (새 문서) | 40 | * MongoDB 메뉴얼은 한국어로 친절히 작성되어 있고, 명령어가 바뀔 수도 있기 때문에 공식 문서를 참고할 것. |
| 41 | * [[https://www.mongodb.com/ko-kr/docs/manual/tutorial/install-mongodb-on-ubuntu/|Ubuntu 기준]] | |
| 42 | * [[https://www.mongodb.com/ko-kr/docs/manual/installation/|Ubuntu가 아닐 경우]] | |
| 43 | ||
| 44 | * 설치하였다면 계속하기 | |
| 45 | > sudo systemctl status mongod //MongoDB 실행 중인지 확인 | |
| 46 | > mongosh //MongoDB 접속 | |
| 47 | ||
| 48 | * DB 생성하고 DB에 접속할 user 만들기 | |
| 49 | > use test123 //test123 DB 생성 및 접속 | |
| 50 | > db.createUser({ user: "test01", pwd: "mypassword", roles: [ "readWrite" ]}) //test01 계정으로 mypassword 비밀번호로 readWrite 권한으로 계정 생성 | |
| 51 | > db.getUsers(); //생성된 User 확인 | |
| 52 | ||
| 53 | * 만약 계정 생성이 되지 않는다면, | |
| 54 | > vi /etc/mongod.conf //MongoDB 설정 파일 vi로 열기 | |
| 55 | > security: //주석 제거후 | |
| 56 | > authorization: enabled //추가 | |
| 57 | ||
| 58 | === Meilisearch === | |
| 59 | * [[https://www.meilisearch.com/docs/learn/self_hosted/getting_started_with_self_hosted_meilisearch|설치하기]] | |
| 60 | * [[https://www.meilisearch.com/docs/guides/deployment/running_production|systemctl에 추가해서 실행 편하게 하기]] | |
| 61 | ||
| 62 | === 엔진 설치 === | |
| 63 | > git clone https://github.com/wjdgustn/thetree //엔진 git으로 불러오기 | |
| 64 | > npm i // 라이브러리 다운로드하기 | |
| 65 | ||
| 66 | == 마지막 == | |
| 67 | * 초기 설정 및 첫 실행은 다음 문서를 참고하자. | |
| 68 | * [[the tree/위키 구축]] |