Ubuntu에 MongoDB 설치하기 및 기본 명령어 정리(22.04 버전 추가)

Ubuntu 버전은 높아져가고 MongoDB도 거기에 맞춰서 설치하는 방법도 다시 달라져 설치방법을 찾는 시간을 낭비하지 말자라는 취지로 여기에 설치, 실행, 정지, 삭제등 관련된 모든 내용을 정리합니다. 해당 내용들은 모두 공식 MongoDB사이트에서 참고하였으니 도움이 많이 되시면 좋겠습니다. 설치 과정 이미지는 사용자마다 달라질 수 있어 따로 첨부하지 않았습니다. 궁금한 사항들은 언제든지 댓글 남겨주세요!

 

주요명령어

설치에 익숙하신 분들은 명령어만 필요하시겠죠? 아래 명령어를 참고하시면 됩니다.

#공개키 등록에 필요한 프로그램
sudo apt-get install gnupg curl

#파일 다운로드 및 등록하기 
curl -fsSL https://pgp.mongodb.com/server-6.0.asc | sudo gpg -o /usr/share/keyrings/mongodb-server-6.0.gpg --dearmor

#Ubuntu 22.04, 다른 버전은 아래 참고
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list

# 패키지 업데이트
sudo apt-get update

# MongoDB 설치
sudo apt-get install -y mongodb-org

# MongoDB 실행
sudo service mongod start

# MongoDB 실행 오류 발생시 
# Failed to start mongod.service: Unit mongod.service not found.
sudo service mongod status

# MongoDB 실행 확인
sudo systemctl status mongod

# MongoDB 종료
sudo service mongod restart

# MongoDB 재시작
sudo service mongod restart

# MongoDBsh 세션 실행
mongosh

---

 

기본정보

(2023.07.21 기준) 

여기에서는 MongoDB 6.0 Community Edition을 설치를 하고 설치 전에 알아야할 사항은 다음과 같습니다.

• 해당 버전은 64-Bit에서만 지원합니다.
• ARM64 아키텍처를 지원합니다.
• 지원하는 Ubuntu버전
  • 20.04 LTS ("Jammy")
  • 20.04 LTS ("Focal")
  • 18.04 LTS ("Bionic")
  • 16.04 LTS ("Xenial")

---

설치방법

패키지 관리 시스템에서 사용되는 공개키 등록하기

기본적으로 Ubuntu에서는 MondoDB설치에 필요한 파일 리스트를 가지고 있지 않기 때문에 설치파일 리스트를 등록해야하며 다음 순서로 진행하면 됩니다.
(본 순서는 공식 가이드 내용을 바탕으로 하고 있어 아래 순서대로 진행해주세요.)

 

1. 공개키 등록을 위한 필요 프로그램 설치 및 공개키 등록하기

#공개키 등록에 필요한 프로그램
sudo apt-get install gnupg curl

#파일 다운로드 및 등록하기 
curl -fsSL https://pgp.mongodb.com/server-6.0.asc | sudo gpg -o /usr/share/keyrings/mongodb-server-6.0.gpg    --dearmor

 

2. MongoDB 리스트 파일 생성하기

MongoDB 설치를 위해서 필요한 설치 파일이 정리된 파일이 특정 경로에 포함되어야 합니다. 여기에서는 tee라는 명령어를 이용해서  별도로 사용자가 폴더을 만들고 파일을 만들 필요가 없습니다. 또한 Ubuntu 버전별로 명령어가 다르기 때문에 버전에 맞게 명령어를 입력하여 파일을 생성하면 됩니다. 

 

참고로 Ubuntn 버전을 모르시는 분은 아래 첫 줄에 있는 명령어로 확인할 수 있으며 tee 명령어는 표준 입력(standard input)에서 읽어서 표준 출력(standard output) 과 파일에 쓰는 명령어입니다.

# Ubuntu 버전확인 
lsb_release -dc

#Ubuntu 22.04
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list

# 20.04(Focal)
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list

# 18.04(Bionic)
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list

# 20.04(Xenial)
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg ] https://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list

 

3. local package database 다시 로드하기

MongoDB 설치에 필요한 설정과 파일을 준비하였 때문에 apt-get에 반영될 수 있게 다음 명령어를 실행합니다.

sudo apt-get update

 

4. MongoDB package 설치(최신 또는 특정버전 설치)

이제 MongoDB를 설치해 봅시다. 저는 여기에서 최신버전을 설치하였는데 혹시 특정 버전으로 설치하실 분들은 두 번째 명령어로 설치하면 됩니다. 

# 최신버전설치 할 경우
sudo apt-get install -y mongodb-org

# 특정버전 설치 할 경우
sudo apt-get install -y mongodb-org=6.0.7 mongodb-org-database=6.0.7 mongodb-org-server=6.0.7 mongodb-org-mongos=6.0.7 mongodb-org-tools=6.0.7

---

 

MongoDB Community Edition 실행

설치가 완료되면 이제 MongoDB를 실행해보고 접속해보고 상태를 확인해보고 정지해보고 종료해보고 다 테스트를 진행해봐야겠죠? 

다음은 systemd 버전과, System V init 버전으로 명령어를 정리하였으니 필요한 버전에 맞게 명령어를 실행하시면 됩니다. 

systemd(systemctl) 버전으로 사용할 경우 

# 실행
sudo systemctl start mongod
# 실행 오류 발생시 
# Failed to start mongod.service: Unit mongod.service not found.
sudo systemctl daemon-reload

# 실행 확인
sudo systemctl status mongod

# 종료
sudo systemctl stop mongod

# 재시작
sudo systemctl restart mongod

# MongoDBsh 세션 실행
mongosh

 

System V init(service) 버전으로 사용할 경우 

# 실행
sudo service mongod start

# 실행 오류 발생시 
# Failed to start mongod.service: Unit mongod.service not found.
sudo service mongod status

# 실행 확인
sudo systemctl status mongod

# 종료
sudo service mongod restart

# 재시작
sudo service mongod restart

# MongoDBsh 세션 실행
mongosh

---

 

MongoDB 삭제

MongoDB를 삭제가 필요할 경우 MongoDB 프로그램만 삭제 하는게 아니고 저장한 데이터나 로그파일 등 관련 모든 파일도 삭제가 필요합니다. 다음은 MongoDB를 완전히 삭제하는 방법입니다.

1. MongoDB 정지

sudo service mongod stop

2. Packages 삭제

sudo apt-get purge mongodb-org*

3. 폴더에 데이터 삭제

sudo rm -r /var/log/mongodb
sudo rm -r /var/lib/mongodb

 

참고경로

# 공식 사이트 
https://www.mongodb.com/

# 설치 가이드 
https://www.mongodb.com/docs/manual/installation/