MongoDB 초기 환경 구축

김민재·2025년 4월 26일

MongoDB를 사용하기 위해서는 Atlas 클라우드 서비스를 이용하는 방법과, 로컬에서 Community Edition을 사용하는 두 가지 방법이 있다. 그 중 Community Edition을 사용할 때 환경 구축 방법이다.

1. MongoDB 공식 사이트에 들어가 Products > Community Edition를 클릭한 후 설치를 진행한다.

  • Package에서 msi는 microsoft installer 파일로서 자동으로 설치를 진행하는 것이고, zip은 압축 파일로 내가 원하는 위치에 직접 압축을 풀어 사용하는 방식이다.

2. 설치 창 하단에 install MongoDB Compass를 체크해주고 계속 설치를 진행한다.

  • MongoDB Compass: MongoDB용 GUI로서, MongoDB는 원래 터미널이나 코드로 명령어를 입력해서 데이터를 관리하는데 Compass를 쓰면 마치 엑셀처럼 데이터베이스 안에 있는 내용을 눈으로 보고, 클릭해서 조작할 수 있다.

3. cmd에서 MongoDB 관련 명령어를 사용할 수 있도록 환경변수 설정을 해준다.

  1. 'MongoDB' 디렉토리 위치 확인(C:\Program Files\MongoDB\Server\8.0\bin)
  2. 시스템>고급 시스템 설정>환경 변수>시스템 변수중 '변수'가 'Path'인 항목 클릭>'편집' 클릭>'새로 만들기' 클릭>경로 입력 후 저장

4. 터미널에 'mongod'를 입력하여 정상 설정 되었는지 확인한다.

  1. 처음 mongod를 입력하면 나오는 무지막지하게 긴 메시지 안에 'NonExistentPath: Data directory \data\db not found.'라는 메시지가 존재한다. 이 에러는 MongoDB가 데이터를 저장할 경로(dbPath)를 찾지 못했다는 의미이다. 따라서 데이터를 저장할 디렉토리를 수동으로 만들어주어야 한다.
  2. C: 드라이브에 data 폴더를 만들고 그 안에 db 폴더를 생성한다. 그런 후에 mongod 명령어를 다시 실행하고, 다음과 같은 메시지가 뜨면 성공한 것이다.
{"t":{"$date":"2025-04-26T18:51:02.273+09:00"},"s":"I", "c":"NETWORK", "id":23016, "ctx":"listener","msg":"Waiting for connections","attr":{"port":27017,"ssl":"off"}}
{"t":{"$date":"2025-04-26T18:51:02.273+09:00"},"s":"I", "c":"CONTROL", "id":8423403, "ctx":"initandlisten","msg":"mongod startup complete","attr":{"Summary of time elapsed":{"Startup from clean shutdown?":true,"Statistics":{"Set up periodic runner":"0 ms","Set up online certificate status protocol manager":"0 ms","Transport layer setup":"0 ms","Run initial syncer crash recovery":"0 ms","Create storage engine lock file in the data directory":"0 ms","Get metadata describing storage engine":"0 ms","Create storage engine":"163 ms","Write current PID to file":"0 ms","Write a new metadata for storage engine":"...
profile
넓이보다 깊이있게

0개의 댓글