MongoDB 설치와 환경설정 세팅 후 MongoDB Compoas를 설치하여 로컬 MongoDB에 접속하는 과정에 대해 정리한 글입니다.
MongoDB 설치 파일 다운로드
MongoDB 서버는 홈페이지에서 다운로드할 수 있습니다. 링크를 통해 자신의 OS와 사용하려는 버전을 설정하고 설치 파일을 다운로드합니다.
MongoDB & MongoDB Compass 설치
설치 파일을 실행하면 다음과 같이 Setup창이 열릴 것입니다.
라이선스에 대한 내용은 agree 하고 다음으로 넘어갑니다. Setup타입에 대하여 Complete과 Custom을 선택할 수 있는데 Custome으로 선택한 경우 설치경로에 대하여 직접 정해줄 수 있습니다. Complete을 사용할 경우 C:\Program Files 하위에 MongoDB 디렉터리를 생성하며 설치가 진행됩니다.
저는 디스크 C 하위에 MongoDB 디렉터리를 만들어 하위에 설치하기 위해 custom으로 진행하였습니다.
계속해서 [Next]로 진행하다 보면 MongoDB Compass 설치 여부를 물어봅니다. 설치를 위해 Install MongoDB Compass 체크박스를 확인하고 다음으로 넘어가 Install 해줍니다. MongoDB Compass는 MySQL의 Workbench처럼 GUI 환경을 통하여 MongoDB를 컨트롤하도록 도와줍니다. 단지 DB 데이터를 시각화하는 것 이상으로 다양한 기능들을 제공하고 있으니 함께 다운로드하여 사용하는 것을 추천드립니다.
다운로드가 완료되면 Setup을 마치게 됩니다.
MongoDB 실행과 환경설정
MongoDB를 실행시키기 위해 다운로드한 경로의 bin 디렉터리로 이동합니다.
- complete를 통해 설치했을 시 - C:\Program Files\MongoDB\Server\{DownloadVersion}\bin
- custom을 통해 설치했을 시 - {지정했던 설치경로}\bin
mongod 명령어를 통해 mongodb를 실행시켜줍시다.
{"error":"NonExistentPath: Data directory C:\\data\\db\\ not found. Create the missing directory or specify another path using (1) the --dbpath command line option, or (2) by adding the 'storage.dbPath' option in the configuration file."}}
위와 같은 에러가 발생한 것을 확인할 수 있는데 로컬 디스크 C 하위에 data/db 폴더를 만들어주거나 --dbpath 옵션과 argument로 Data directory 경로를 직접 지정해 주면 해결이 가능합니다.
저는 설치한 MongoDB 디렉터리 하위에 data/db 폴더를 만들고 인자를 통해 다시 mongod를 실행시켜 보겠습니다.
두근두근 실행...
Waiting for connections라는 문구가 나오면 mongoDB가 잘 뜬것입니다. 또한, 로그를 통해 확인할 수 있는 것은 address=127.0.0.1(localhost), port=27017 인 것입니다.
매번 bin 디렉터리까지 와서 실행하는 것이 번거로우니 환경변수로 지정하여 어디에서든 실행할 수 있게 만들어줍시다.
[시스템] > [고급 시스템 설정] > [고급] > [환경 변수]에서 사용자 변수 Path에 대하여 경로(MongoDB설치경로\bin)를 추가해줍니다.
MongoDB Compass를 통한 MongoDB 접속
MongoDB 설치 과정에서 MongoDB Compass를 설치하였다면 설치 후 자동으로 Compass가 실행되어 아래와 같은 화면이 보일 것입니다. File in connection fields individually 버튼을 클릭하여 방금 설치한 MongoDB와 연결해보겠습니다.
기본 설정으로 Hostname이 localhost, Port가 27017로 되어있습니다. connect 버튼을 클릭하여 연결해줍시다. 연결이 되었다면 기본적으로 mongoDB에 들어있는 admin, config, local Collections이 확인된다면 정상적으로 연결된 것입니다.
