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

macOS에 MongoDB Community Edition 설치

이 페이지의 내용

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

참고

MongoDB Atlas

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

개요

이 튜토리얼을 사용하여 macOS의 MongoDB 5.0 Community Edition을 설치하려면 타사 Homebrew 패키지 관리자를 사용합니다.

MongoDB 4.4.1 부터 시작됩니다. Homebrew를 통해 MongoDB 를 설치하면 MongoDB database 도구 도 설치됩니다. 자세한 내용 은 MongoDB database 도구 사용 을 참조하세요.

MongoDB 버전

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

고려 사항

플랫폼 지원

참고

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 설치

전제 조건

시스템이 아래와 같은 각 사전 조건을 충족하는지 확인합니다. 시스템에서 각 사전 조건 단계를 한 번만 수행하면 됩니다. 이전 MongoDB 설치 과정에서 Homebrew를 사용하여 필수 단계를 이미 수행한 경우 이를 생략하고 설치 절차로 넘어가도 됩니다.

Install Xcode Command-Line Tools

Homebrew를 사용하려면 Apple의 Xcode 명령줄 도구가 필요합니다.

  • macOS 터미널에서 다음 명령을 실행하여 Xcode 명령줄 도구를 설치합니다.

    xcode-select --install

Homebrew 설치

macOS에는 기본적으로 Homebrew brew 패키지가 포함되지 않습니다.

MongoDB 5.0 설치 MongoDB Community Edition

다음 단계에 따라 Homebrew의 brew 패키지 관리자를 사용하여 MongoDB Community Edition을 설치합니다. 위의 설치 사전 조건을 준수했는지 확인한 다음 계속 진행합니다.

  1. macOS 터미널에서 다음 명령을 실행하여 MongoDB Homebrew Tap을 선택하는 방식으로 MongoDB 및 Database Tools에 대한 공식적인 Homebrew 수식을 다운로드합니다.

    brew tap mongodb/brew

    이전 MongoDB 설치에서 이 작업을 수행한 경우 이 단계를 생략할 수 있습니다.

  2. To update Homebrew and all existing formulae:

    brew update

  3. MongoDB를 설치하려면 macOS 터미널 애플리케이션에서 다음 명령을 실행합니다.

    brew install mongodb-community@5.0

팁

또는 원하는 경우 이전 버전의 MongoDB를 지정할 수도 있습니다. 이러한 방식으로 여러 버전의 MongoDB를 함께 유지 관리할 수도 있습니다.

팁

이전 버전의 수식을 설치한 경우 CheckSummisMatchError가 발생할 수 있습니다. 문제를 해결하려면 CheckSummisMatchError 문제 해결을 확인합니다.

설치 과정에 아래와 같은 바이너리가 포함됩니다.

또한 설치 시 Apple 하드웨어에 따라 아래 지정된 위치에 다음과 같은 파일과 디렉토리가 생성됩니다.

Intel 프로세서
Apple M1 프로세서
/usr/local/etc/mongod.conf
/opt/homebrew/etc/mongod.conf
/usr/local/var/log/mongodb
/opt/homebrew/var/log/mongodb
/usr/local/var/mongodb
/opt/homebrew/var/mongodb

Apple 설명서 참조 M 1 프로세서를 사용하는 Apple 하드웨어의 현재 목록을 확인하세요. 다음 명령을 실행하여 brew 에서 이러한 파일과 디렉토리를 설치한 위치를 확인할 수도 있습니다.

brew --prefix

MongoDB 4.4.1부터는 설치에 MongoDB Database Tools가 포함됩니다. 자세한 내용은 MongoDB Database Tools 사용에서 확인 가능합니다.

MongoDB Community Edition 실행

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

You can run MongoDB as a macOS service using brew, or you can run MongoDB manually as a background process. It is recommended to run MongoDB as a macOS service, as doing so sets the correct system ulimit values automatically (see ulimit settings for more information).

  • MongoDB(즉, mongod 프로세스)를 macOS 서비스로 실행하려면 다음을 실행합니다.

    brew services start mongodb-community@5.0

    macOS 서비스로 실행 중인 mongod를 중지하려면 필요에 따라 다음 명령을 사용합니다.

    brew services stop mongodb-community@5.0

  • 구성 파일 을 사용하여 배경 프로세스 로 를 수동으로 mongod 실행 하려면 다음을 수행합니다.

    • 배포서버 에서 TLS 연결을 사용하지 않는 경우 --fork 옵션을 사용합니다.

      • Intel 프로세서에서 실행 macOS의 경우 다음을 실행.

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

      • Apple Silicon 프로세서에서 실행 macOS의 경우 다음을 실행.

        mongod --config /opt/homebrew/etc/mongod.conf --fork

      • 배포서버 서버에서 TLS 연결을 사용하는 경우 GNU 화면을 사용합니다.

        • Intel 프로세서에서 실행 되는 macOS의 경우:

          1

          화면을 시작합니다.

          screen -S <name-of-screen>
          2

          mongod시작.

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

          화면에서 분리합니다.

          Ctrl+a 을 입력한 다음 d 을 클릭하여 화면에서 분리합니다.

          4

          모든 활성 화면을 봅니다.

          screen -ls

        • Apple Silicon 프로세서에서 실행되는 macOS의 경우:

          1

          화면을 시작합니다.

          screen -S <name-of-screen>
          2

          mongod시작.

          mongod --config /opt/homebrew/etc/mongod.conf
          3

          화면에서 분리합니다.

          Ctrl+a 을 입력한 다음 d 을 클릭하여 화면에서 분리합니다.

          4

          모든 활성 화면을 봅니다.

          screen -ls

  • 명령줄에 --dbpath 및 --logpath를 지정하여 mongod를 수동으로 백그라운드 프로세스로 실행하려면 다음을 실행합니다.

    mongod --dbpath /path/to/dbdir --logpath /path/to/mongodb.log --fork

    백그라운드 프로세스로 실행 중인 mongod를 중지하려면 mongosh를 사용해 mongod에 연결하고 필요에 따라 shutdown 명령을 실행합니다.

두 방법 모두 설치 중에 생성된 mongod.conf 파일을 사용합니다. 이 파일에 사용자만의 MongoDB 구성 옵션을 추가할 수도 있습니다.

참고

macOS에서 mongod이 열리지 않는 경우

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

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

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

  • macOS 버전에 따라 Open Anyway 또는 Allow Anyway 라벨로 표시된 mongod 관련 메시지 오른쪽 버튼을 일반 탭 아래에서 클릭합니다.

To verify that MongoDB is running, perform one of the following:

  • MongoDB를 macOS 서비스로 시작한 경우,

    brew services list

    started로 나열된 mongodb-community 서비스가 표시되어야 합니다.

  • MongoDB를 백그라운드 프로세스로서 수동으로 시작한 경우,

    ps aux | grep -v grep | grep mongod

    출력에서 mongod 프로세스를 확인할 수 있습니다.

아래와 같이 로그 파일에서 mongod 프로세스의 현재 상태를 확인할 수도 있습니다. /usr/local/var/log/mongodb/mongo.log.

Connect and Use MongoDB

MongoDB 사용을 시작하려면 mongosh를 실행 중인 인스턴스에 연결합니다. 새 터미널에서 다음을 실행합니다.

mongosh

For information on CRUD (Create,Read,Update,Delete) operations, see:

MongoDB Database Tools 사용

MongoDB 4.4.1부터 brew 를 통해 MongoDB를 설치하면 MongoDB Database Tools도 설치됩니다.

MongoDB Database Tools 는 mongoimport 및 mongodump와 같은 데이터 백업 및 가져오기/내보내기 도구와 mongotop과 같은 모니터링 도구가 포함된 MongoDB 배포 작업을 위한 명령줄 유틸리티 컬렉션입니다.

위 단계에 따라 MongoDB Server를 설치한 후에는 macOS 터미널 애플리케이션의 명령줄에서 바로 Database Tools를 사용할 수 있습니다. 예를 들어 macOS 터미널에서 다음과 같이 호출하여 실행 중인 MongoDB 인스턴스에 mongotop을 실행할 수 있습니다.

mongotop

시작되어 실행 중인 mongod에 연결되고 사용 통계 보고가 시작됩니다.

각 Database Tools에 대한 사용 정보는 MongoDB Database Tools 문서에서 확인 가능합니다.

추가 정보

기본 로컬 호스트 바인딩

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 바인딩을 참조하세요.

ChecksumMismatchError 문제 해결

이전 버전의 공식을 이미 설치한 경우 다음과 유사한 ChecksumMismatchError가 나타날 수 있습니다.

Error: An exception occurred within a child process:
  ChecksumMismatchError: SHA256 mismatch
Expected: c7214ee7bda3cf9566e8776a8978706d9827c1b09017e17b66a5a4e0c0731e1f
  Actual: 6aa2e0c348e8abeec7931dced1f85d4bb161ef209c6af317fe530ea11bbac8f0
 Archive: /Users/kay/Library/Caches/Homebrew/downloads/a6696157a9852f392ec6323b4bb697b86312f0c345d390111bd51bb1cbd7e219--mongodb-macos-x86_64-4.2.0.tgz
To retry an incomplete download, remove the file above.

수정 방법:

  1. Remove the downloaded .tgz archive.

  2. Retap the formula.

    brew untap mongodb/brew && brew tap mongodb/brew

  3. 설치를 다시 시도합니다.

    brew install mongodb-community@5.0

돌아가기

.tgz 타볼을 사용하여 설치

다음

.tgz 타볼을 사용하여 설치