Docs Menu
Docs Home
/
MongoDB 매뉴얼
/
자체 관리 배포서버
/
설치
/
커뮤니티 에디션
/
macOS에 설치

Tarball 를 사용하여 macOS에 MongoDB Community 설치 .tgz

이 페이지의 내용

  • 개요
  • 고려 사항
  • MongoDB Community Edition 설치
  • MongoDB Community Edition 실행
  • 추가 정보

참고

MongoDB Atlas

MongoDB Atlas 는 클라우드에서 호스팅되는 MongoDB 서비스 옵션으로, 설치 오버헤드가 필요하지 않으며 프리 티어을 제공하여 바로 시작할 수 있습니다.

개요

이 튜토리얼을 통해 다운로드한 .tgz tarball을 사용하여 macOS에 MongoDB MongoDB Community Edition을 수동으로 설치합니다.

MongoDB 버전

이 튜토리얼에서는 MongoDB 5.0 MongoDB Community Edition을 설치합니다. 다른 버전의 MongoDB Community를 설치하려면 페이지 왼쪽 상단의 버전 드롭다운 메뉴에서 해당 버전에 대한 문서를 선택하세요.

설치 방법

이 문서의 설명대로 다운로드한 .tgz tarball을 통해 MongoDB를 수동으로 설치할 수 있지만 가능하면 시스템의 brew 패키지 관리자를 사용하여 MongoDB를 설치하는 것이 좋습니다. 패키지 관리자를 사용하면 필요한 모든 종속 프로그램이 자동으로 설치되고, 시작에 도움이 되는 예시 mongod.conf 파일이 제공되며, 향후 업그레이드 및 유지 관리 작업이 간소화됩니다.

➤ brew 패키지 관리자를 사용하여 MongoDB 설치하기 섹션을 참조하세요.

고려 사항

MongoDB Shell mongosh

.tgz 패키지를 사용하여 서버를 설치하는 경우 mongosh 설치 지침에 따라 mongosh를 별도로 다운로드하여 설치해야 합니다.

플랫폼 지원

참고

EOL Notice

  • MongoDB 5.0 MongoDB Community Edition은 macOS 10.13에 대한 지원을 제거합니다.

MongoDB 5.0 MongoDB Community Edition은 macOS 10.14 이상을 지원합니다.

자세한 정보는 플랫폼 지원에서 확인할 수 있습니다.

프로덕션 정보

프로덕션 MongoDB 배포에 대한 성능 고려 사항 및 구성 권장 사항을 제공하는 자체 관리형 배포를 위한 프로덕션 노트 문서를 검토한 이후에 프로덕션 환경에 MongoDB를 배포합니다.

MongoDB Community Edition 설치

다음 단계에 따라 .tgz에서 MongoDB Community Edition을 수동으로 설치합니다.

1

타르볼을 다운로드합니다.

아래 링크에서 MongoDB Community tgz tarball 파일을 다운로드합니다:

➤ MongoDB 다운로드 센터

  1. Version 드롭다운 메뉴에서 다운로드하려는 MongoDB 버전을 선택합니다.

  2. Platform 드롭다운 메뉴에서 macOS를 선택합니다.

  3. Package 드롭다운 메뉴에서 tgz를 선택합니다.

  4. Download를 클릭합니다.

2

다운로드한 아카이브에서 파일을 추출합니다.

tar -zxvf mongodb-macos-x86_64-5.0.tgz

웹 브라우저가 다운로드의 일부로 파일의 압축을 자동으로 풀면 파일은 대신 .tar(으)로 끝납니다.

3

바이너리가 PATH 환경 변수에 나열된 디렉토리에 있는지 확인하세요.

MongoDB 바이너리는 tarball의 bin/ 디렉터리에 있습니다. 다음 방법 중 하나를 선택할 수 있습니다.

  • 바이너리를 PATH 변수에 나열된 디렉토리(예: /usr/local/bin)에 복사합니다. /path/to/the/mongodb-directory/을(를) 설치 디렉토리로 바꿉니다.

    sudo cp /path/to/the/mongodb-directory/bin/* /usr/local/bin/

  • PATH 변수에 나열된 디렉토리(예: /usr/local/bin)에서 바이너리로 연결되는 기호 링크를 생성합니다. /path/to/the/mongodb-directory/을(를) 설치 디렉토리로 바꿉니다.

    sudo ln -s  /path/to/the/mongodb-directory/bin/* /usr/local/bin/
1

타르볼을 다운로드합니다.

아래 링크에서 MongoDB Community tgz tarball 파일을 다운로드합니다:

➤ MongoDB 다운로드 센터

  1. Version 드롭다운 메뉴에서 다운로드하려는 MongoDB 버전을 선택합니다.

  2. Platform 드롭다운 메뉴에서 macOS ARM 64를 선택합니다.

  3. Package 드롭다운 메뉴에서 tgz를 선택합니다.

  4. Download를 클릭합니다.

2

다운로드한 아카이브에서 파일을 추출합니다.

tar -zxvf mongodb-macos-arm64-5.0.tgz

웹 브라우저가 다운로드의 일부로 파일의 압축을 자동으로 풀면 파일은 대신 .tar(으)로 끝납니다.

3

바이너리가 PATH 환경 변수에 나열된 디렉토리에 있는지 확인하세요.

MongoDB 바이너리는 tarball의 bin/ 디렉터리에 있습니다. 다음 방법 중 하나를 선택할 수 있습니다.

  • 바이너리를 PATH 변수에 나열된 디렉토리(예: /usr/local/bin)에 복사합니다. /path/to/the/mongodb-directory/을(를) 설치 디렉토리로 바꿉니다.

    sudo cp /path/to/the/mongodb-directory/bin/* /usr/local/bin/

  • PATH 변수에 나열된 디렉토리(예: /usr/local/bin)에서 바이너리로 연결되는 기호 링크를 생성합니다. /path/to/the/mongodb-directory/을(를) 설치 디렉토리로 바꿉니다.

    sudo ln -s  /path/to/the/mongodb-directory/bin/* /usr/local/bin/

MongoDB Community Edition 실행

ulimit 고려 사항
대부분의 Unix 계열 운영 체제는 프로세스 가 사용할 수 있는 시스템 리소스를 제한합니다. 이러한 제한은 MongoDB 작업에 부정적인 영향 수 있으므로 조정해야 합니다. 플랫폼에 권장 되는 설정은 자체 관리 배포서버를 위한 UNIX ulimit 설정을 참조하세요.

참고

열려 있는 파일 수의 ulimit 값이 64000 미만인 경우 MongoDB가 시작 경고를 생성합니다.

절차

다음 단계에 따라 MongoDB Community Edition을 실행합니다. 이 지침에서는 기본 설정을 사용한다고 가정합니다.

1

데이터 디렉토리를 만듭니다.

MongoDB를 처음 시작하기 전에 mongod 프로세스가 데이터를 기록할 디렉토리를 만들어야 합니다.

예를 들어 ~/data/db 디렉토리를 생성하려면 다음을 수행하세요.

sudo mkdir -p ~/data/db
2

로그 디렉터리를 만듭니다.

또한 mongod 프로세스가 로그 파일을 기록할 디렉토리를 다음과 같이 만들어야 합니다.

예를 들어 ~/data/log/mongodb 디렉토리를 생성하려면 다음을 수행하세요.

sudo mkdir -p ~/data/log/mongodb
3

데이터 및 로그 디렉토리에 대한 권한을 설정합니다.

mongod 를 실행하는 사용자 계정에 이 두 디렉토리에 대한 읽기 및 쓰기 권한이 있는지 확인합니다. 자신의 사용자 계정으로 mongod 를 실행하고 있고 방금 위의 두 디렉토리를 생성하였다면, 해당 디렉토리는 이미 사용자가 액세스할 수 있어야 합니다. 그렇지 않으면 chown 을 사용하여 적절한 사용자 를 대체하여 소유권을 설정할 수 있습니다.

sudo chown <user> ~/data/db
sudo chown <user> ~/data/log/mongodb
4

MongoDB를 실행합니다.

MongoDB를 실행하려면 시스템 프롬프트에서 mongod 프로세스를 실행하고, 위에서 제공된 두 매개변수 dbpath와 logpath, 그리고 fork 매개 변수를 입력하여 백그라운드에서 mongod을 실행합니다. 또는 dbpath, logpath, fork 및 기타 여러 매개변수에 대한 값을 구성 파일에 저장할 수도 있습니다.

mongod 명령줄 매개 변수를 사용하여 실행

시스템 프롬프트에서 mongod 프로세스를 실행하고 필요한 세 가지 매개 변수를 명령줄에 직접 입력합니다.

mongod --dbpath ~/data/db --logpath ~/data/log/mongodb/mongo.log --fork
mongod 구성 파일 로 실행

시스템 프롬프트에서 config 매개변수와 함께 구성파일의 경로를 지정해 mongod프로세스를 실행하세요.

mongod --config /usr/local/etc/mongod.conf

설치 후 macOS가 mongod 실행을 차단할 수 있습니다. mongod을 시작할 때 개발자를 식별하거나 확인할 수 없다는 보안 오류를 수신한 경우 다음을 실행하여 mongod에 액세스 권한을 부여합니다.

  • 시스템 환경설정을 실행합니다

  • 보안 및 개인 정보 창을 선택합니다

  • 일반 탭에서 macOS 버전에 따라 Open Anyway 또는 Allow Anyway로 레이블된 mongod에 대한 메시지의 오른쪽에 있는 버튼을 클릭합니다.

5

MongoDB가 성공적으로 시작되었는지 확인합니다.

MongoDB가 성공적으로 시작되었는지 확인합니다.

ps aux | grep -v grep | grep mongod

실행 중인 mongod 프로세스가 보이지 않는다면 로그 파일에서 오류 메시지가 있는지 확인하세요.

6

MongoDB 사용을 시작합니다.

mongod와 동일한 호스트 머신에서 mongosh 세션을 시작합니다. 명령줄 옵션 없이 mongosh를 실행하여 localhost의 기본 포트 27017에서 실행 중인 mongod에 연결할 수 있습니다.

mongosh

다른 호스트 및/또는 포트에서 실행하는 mongod 인스턴스에 연결하는 등 mongosh(을)를 사용하여 연결하는 방법에 대한 자세한 내용은 mongosh 문서를 참조하세요.

MongoDB는 사용을 시작하는 데 도움이 되도록 다양한 드라이버 에디션에 대해 시작 가이드를 제공합니다. 사용 가능한 에디션은 MongoDB 시작하기를 참조하세요.

추가 정보

기본 로컬 호스트 바인딩

By default, MongoDB launches with bindIp set to 127.0.0.1, which binds to the localhost network interface. This means that the mongod can only accept connections from clients that are running on the same machine. Remote clients will not be able to connect to the mongod, and the mongod will not be able to initialize a replica set unless this value is set to a valid network interface which is accessible from the remote clients.

이 값은 다음 중 한 가지 방법으로 구성할 수 있습니다.

  • MongoDB 구성 파일에서 bindIp를 통해

  • 명령줄 인수를 통해 --bind_ip

경고

로컬 호스트가 아닌 에 바인딩하기 전에(예: 공개적으로 액세스할 수 있는) IP 주소 인 경우 무단 액세스 로부터 클러스터 를 보호했는지 확인합니다. 보안 권장 사항의 전체 목록은 자체 관리 배포서버를 위한 보안 체크리스트를 참조하세요. 최소한 인증 을 활성화 하고 네트워크 인프라를 강화하는 것을 고려하세요.

bindIp 구성에 대한 자세한 내용 은 자체 관리 배포서버의 IP 바인딩을 참조하세요.

돌아가기

macOS에 설치

다음

Windows에 설치