설치

MongoDB 설치방법입니다.

MongoDB는 기본적으로 Linux, MacOS Windows 환경 전부 지원이 가능하다.

본 절에서는 MongoDB 설치에 대하여 설명하고, Linux 상의 Ubuntu 혹은 Windows 환경에서 설치하는 방법에 대해서 기술한다.

Linux 환경에 설치

리눅스에는 여러가지 배포판들이 존재하지만, 가장 널리 쓰이는 배포판 중 하나인 Ubuntu 기준으로 설명을 한다. 추후 배포판들을 업데이트 예정

Ubuntu 기준

손쉽게 설치하기

Ubuntu는 apt를 이용한 패키지 설치가 가능하다. 기본적인 apt source를 이용한다면 아래와 같은 명령어로 손쉽게 MongoDB를 설치할 수 있다.

$ sudo apt install mongodb

apt를 처음 사용한다면 sudo apt update 와 같이 업데이트 이후 설치 명령어를 입력해야 정상적으로 설치될 것이다.

이와 같은 방법을 이용하여 MongoDB를 설치할 경우 3.6.3 버전 (2019. 08. 25 기준)의 MongoDB 서버와 mongo, mongos, mongoimport 등 다양한 소프트웨어가 함께 설치될 것이다.

최신버전 설치하기

위 절과 같이 단순 apt 명령어를 이용하여 MongoDB를 설치할 경우 다소 옛날 버전이 설치될 수 있다. 현재 (2019. 08. 25 기준) MongoDB 최신 버전은 4.2 로, 이러한 최신 버전의 MongoDB를 설치하려면 아래와 같이 다소 복잡한 작업들이 필요하다.

최신 버전의 MongoDB를 이용하기 위해서는 MongoDB가 제공하는 apt source를 이용해야 한다. 이를 위해서는 MongoDB 의 pgp 키를 등록한 뒤 MongoDB source를 추가하여야 한다.

먼저 아래와 같이 pgp 키를 다운받아 등록한다.

$ wget -qO - https://www.mongodb.org/static/pgp/server-4.2.asc | sudo apt-key add -

이 후 MongoDB 에서 제공하는 apt source를 등록한다. 현재 최신 버전인 MongoDB 4.2부터는 Ubuntu 14.04 에 대한 지원을 끊어 16.04와 18.04 두 버전 상에서 설치할 수 있다.

# 18.04 기준 (bionic)
$ echo "deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/4.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.2.list

# 16.04 기준 (xenial)
$ echo "deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/4.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.2.list

마지막으로 아래와 같이 업데이 및 MongoDB 를 설치하면 된다.

$ sudo apt update
$ sudo apt install mongodb-org

정상 동작 확인

설치를 완료하였다면 정상적으로 설치되었는지, 실행은 되는지 확인을 해야 한다. MongoDB를 설치하면 기본적으로 서비스 형태로 MongoDB 데몬 (mongod)이 작동하게 되는데, service 명령어를 통해 MongoDB 의 상태를 확인할 수 있다.

아래 명령어는 서비스로 동작하고 있는 MongoDB 데몬 (mongod)가 현재 어떤 상태인지를 볼수 있는 명령어이다. 주의할 점은 창이 작을 경우 q를 눌러야 빠져나올수 있다.

$ sudo service mongod status    # check mongod status

아래 두 명령어는 각각 mongod 서비스 시작과 종료 명령어이다. 간혹 mongod를 시작하지 않고 MongoShell로 접근 시도하면 접속할 수 없다는 에러가 발생하는데 당연하게 접근이 되지 않을 것이다. 서버를 켜야 동작을 하는 원리는 모든 시스템에서 동일하게 작동된다는 점을 유념해야 할 것이다.

$ sudo service mongod start   # start mongod
$ sudo service mongod stop    # stop mongod

기타

MongoDB 설치와 관련된 MongoDB 원문 문서는 아래 Link에서 확인이 가능하다.

https://docs.mongodb.com/manual/tutorial/install-mongodb-on-ubuntu/

위 사이트에서 아래의 큰 항목만 보고도 손쉽게 설치가 가능하다.

1. Import the public key used by the package management system.

2. Create a list file for MongoDB.

3. Reload local package database.

4. Install the MongoDB packages.

Windows 환경에 설치

Windows 환경은 강력한 GUI 환경 탓에 아래와 같이 step-by-step 방식으로 기술하였다. 아래와 같은 절차를 따라 설치하고 확인하면 된다.

1. MongoDB 다운로드 센터에 접속

   https://www.mongodb.com/download-center/community

2. 자신이 설치하고 싶은 버전 (Version)과 운영체제 (OS, 64bit 윈도우 상에서 설치하면 Windows 64-bit x64 선택), 그리고 패키지 (Package, 설치파일 형태로 받고 싶다면 MSI)를 선택

3. 다운로드받은 MSI파일 실행 (예를들어, mongodb-win32-x86_64-2008plus-ssl-4.2.0-signed.msi)

4. 아래와 같이 설치를 진행한다. (MongoDB 4.2 버전 설치 기준이며, 버전별 상이할 수 있음)

   • End-User License Agreement: 동의

   • Choose Setup Type: 전체 설치를 하려면 Complete, 사용자의 입맛에 맞게 설치를 하려면 Custom

   • Service Configuration: "Install MongoD as a Service" 항목에 체크를 하면 MongoDB를 서비스 형태로 설치하며, mongod 를 실행하지 않아도 자동으로 실행되도록 편하게 설정할 수 있다. (부연설명 추가예정)

   • Install MongoDB Compass: GUI 환경과 간단한 시각화 도구를 제공하는 Compass를 설치하려면 아래 "Install MongoDB Compass" 를 선택

5. MongoDB 설치 디렉토리 내의 bin 디렉토리 (예를들어, C:\Program Files\MongoDB\Server\x.x\bin, MongoDB 4.2 버전이라면 x.x 에 4.2) mongo.exe (MongoShell)과 mongod.exe (MongDB 서버 데몬) 실행파일이 존재하는지 확인

   • 서비스로 설치한다면 서비스 실행 뒤 MongoDB Server 가 존재하는지 확인

6. [OPTIONAL] 명령 프롬프트 (cmd)나 PowerShell을 이용하여 어느 위치에서는 MongoShell을 실행하고 싶다면, 아래와 같이 PATH를 설정

   • 제어판 > 시스템 > 고급 시스템 설정 > 환경변수 에서 PATH 선택

   • MongoDB 설치 디렉토리 (예를들어, C:\Program Files\MongoDB\Server\4.2\bin) 를 기존 PATH 뒤에 ;를 붙인 뒤 추가

   • 기존의 PATH 값을 지우지 말고 뒤에 세미콜론 (;) 을 반드시 추가한 뒤 작성하지 않으면 기존 프로그램들이 정상동작 하지 않을 수 있음

7. 명령 프롬프트 (cmd)나 PowerShell을 이용하여 MongoDB가 정상 작동중인지 확인

   • 서비스 형태로 MongoDB 설치한 경우: mongo 를 이용하면 로컬로 바로 접속 되어야 함

   • 서비스 아닌 경우: mongod 를 이용하여 MongoDB 서버를 시작한 뒤 mongo 를 이용하여 접속

     • mongod 관련 link 추후 추가 예정