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

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

이 페이지의 내용

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

개요

이 튜토리얼을 사용하여 MongoDB 8.0 을 수동으로 설치합니다. MongoDB Community Edition Debian Linux 다운로드한 .tgz tarball을 사용하는 에서 .

MongoDB 버전

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

설치 방법

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

➤ 지침은 적절한 패키지 관리자 를 사용하여 MongoDB 설치 를 참조하세요.

고려 사항

MongoDB Shell mongosh

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

플랫폼 지원

MongoDB 8.0 MongoDB Community Edition 은 64 Debian x86_64 아키텍처에서 다음 비트 릴리스를 지원합니다.

  • Debian 12 'Bookworm'

MongoDB는 이러한 플랫폼의 64비트 버전만 지원합니다.

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

프로덕션 정보

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

MongoDB Community Edition 설치

전제 조건

아래 명령을 사용하여 MongoDB Community .tgz tarball에 필요한 종속성을 설치합니다.

sudo apt-get install libcurl4 libgssapi-krb5-2 libldap-common libwrap0 libsasl2-2 libsasl2-modules libsasl2-modules-gssapi-mit openssl liblzma5

절차

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

1

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

필수 사전 패키지를 설치한 후 다음 링크에서 MongoDB Community tgz tarball을 다운로드합니다.

➤ MongoDB 다운로드 센터

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

  2. Platform 드롭다운 메뉴에서 운영 체제 버전 및 아키텍처를 선택합니다.

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

  4. Download를 클릭합니다.

2

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

예를 들어 시스템 셸에서 tar 명령어을 사용하여 추출할 수 있습니다.

tar -zxvf mongodb-linux-*-8.0.4.tgz
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/
4

MongoDB Shell(mongosh)를 설치합니다.

설치 mongosh 그 다음 MongoDB Shell을 사용하여 배포서버에 연결합니다.

MongoDB 다운로드 센터에서 필요한 mongosh 버전 패키지를 다운로드하고 압축을 해제합니다.

MongoDB Community Edition 실행

ulimit 고려 사항

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

참고

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

디렉토리

기본적으로 MongoDB 인스턴스는 다음을 저장합니다.

  • 데이터 파일: /var/lib/mongodb

  • 로그 파일: /var/log/mongodb

패키지 관리자를 통해 설치한 경우 설치 중에 이러한 기본 디렉터리가 생성됩니다.

타르볼을 다운로드하여 수동으로 설치한 경우, MongoDB를 실행할 사용자에 따라 mkdir -p <directory> 또는 sudo mkdir -p <directory>를 사용하여 디렉터리를 만들 수 있습니다. (mkdir 및 sudo에 대한 자세한 내용은 Linux 매뉴얼 페이지를 참조하세요.)

기본적으로 MongoDB는 mongodb 사용자 계정을 사용하여 실행됩니다. MongoDB 프로세스를 실행하는 사용자를 변경하는 경우 /var/lib/mongodb 및 /var/log/mongodb 디렉토리에 대한 권한도 수정하여 사용자에게 이러한 디렉토리에 대한 액세스 권한을 반드시 부여해야 합니다.

다른 로그 파일 디렉토리와 데이터 파일 디렉토리를 지정하려면 /etc/mongod.conf에서 systemLog.path 및 storage.dbPath 설정을 편집합니다. MongoDB를 실행하는 사용자에게 이 디렉토리에 대한 액세스 권한이 있는지 확인하세요.

절차

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

1

데이터 및 로그 디렉터리를 생성합니다.

MongoDB 인스턴스가 데이터를 저장하는 디렉토리를 생성합니다. 예시:

sudo mkdir -p /var/lib/mongo

MongoDB 인스턴스가 로그를 저장하는 디렉터리를 만듭니다. 예시:

sudo mkdir -p /var/log/mongodb

MongoDB 프로세스를 시작하는 사용자는 이러한 디렉토리에 대한 읽기 및 쓰기 권한을 반드시 보유해야 합니다. 예를 들어 MongoDB를 직접 실행하려면 다음이 필요합니다.

sudo chown `whoami` /var/lib/mongo     # Or substitute another user
sudo chown `whoami` /var/log/mongodb   # Or substitute another user
2

MongoDB를 실행합니다.

MongoDB를 실행하려면 시스템 프롬프트에서 mongod 프로세스를 실행합니다.

mongod --dbpath /var/lib/mongo --logpath /var/log/mongodb/mongod.log --fork

명령줄 옵션 --dbpath 및 --logpath에 대한 자세한 내용은 옵션에서 확인 가능합니다.

3

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

로그 파일 /var/log/mongodb/mongod.log에서 다음 줄에 대한 프로세스 출력을 확인하여 MongoDB가 성공적으로 시작되었는지 확인합니다.

[initandlisten] waiting for connections on port 27017

프로세스 출력에 중요하지 않은 경고가 표시될 수 있습니다. 위의 로그 줄이 표시되어 있다면 MongoDB를 처음 평가하는 동안에는 이러한 경고를 무시해도 됩니다.

4

MongoDB 사용을 시작합니다.

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

mongosh

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

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

추가 정보

기본 로컬 호스트 바인딩

MongoDB는 bindIp가 로컬 호스트 네트워크 인터페이스에 바인딩되는 127.0.0.1로 설정되어 실행되도록 기본 설정되어 있습니다. 이는 mongod가 동일한 시스템에서 실행 중인 클라이언트의 연결만 허용할 수 있음을 의미합니다. 원격 클라이언트는 mongod에 연결할 수 없으며, 이 값이 유효한 네트워크 인터페이스로 설정되어 있지 않으면 mongod는 복제본 세트를 초기화할 수 없습니다.

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

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

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

경고

인스턴스를 공개적으로 접근 가능한 IP 주소에 바인딩하기 전에 무단 접근으로부터 클러스터를 보호해야 합니다. 보안 권장 사항의 전체 목록은 자체 관리 배포서버에 대한 보안 검사 목록을 참조하세요. 최소한 인증을 활성화하고 네트워크 인프라를 강화하는 것을 고려합니다.

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

돌아가기

Debian에 설치

다음

SUSE에 설치