Windows에 MongoDB 커뮤니티 에디션 설치
이 페이지의 내용
참고
MongoDB 아틀라스
MongoDB Atlas 는 클라우드에서 호스팅되는 MongoDB 서비스 옵션으로, 설치 오버헤드가 필요하지 않으며 무료 계층을 제공하여 시작할 수 있습니다.
개요
이 튜토리얼에 따라 기본 설치 마법사를 사용하여 Windows에 MongoDB 7.0 Community 에디션을 설치할 수 있습니다.
MongoDB 버전
이 튜토리얼에서는 MongoDB 7.0 Community 에디션을 설치합니다. 다른 버전의 MongoDB Community를 설치하려면 페이지 왼쪽 상단의 버전 드롭다운 메뉴에서 해당 버전에 대한 문서를 선택할 수 있습니다.
설치 방법
이 튜토리얼에서는 기본 MSI 설치 마법사를 사용하여 Windows에 MongoDB를 설치합니다. 대신 msiexec.exe 명령줄 도구를 사용하여 MongoDB를 설치하려면 msiexec.exe를 사용하여 MongoDB 설치 를 참조하세요. msiexec.exe 도구는 자동화를 사용하여 MongoDB를 자동 방식으로 배포하려는 시스템 관리자에게 유용합니다.
고려 사항
MongoDB Shell mongosh
MongoDB Shell(mongosh)은 MongoDB Server로 설치되지 않습니다. mongosh를 별도로 다운로드하여 설치하려면 mongosh 설치 안내에 따라야 합니다.
플랫폼 지원
MongoDB 7.0 Community 에디션은 x86_64 아키텍처에서 아래의 64비트 Windows 버전을 지원합니다:
Windows Server 2022
Windows Server 2019
Windows 11
MongoDB는 이러한 플랫폼의 64비트 버전만 지원합니다.
자세한 내용은 플랫폼 지원에서 확인 가능합니다.
참고
Linux용 Windows 하위 시스템(WSL)은 MongoDB를 지원하지 않습니다. Linux에서 MongoDB를 실행하려면 지원되는 Linux 시스템을 사용해야 합니다.
가상화
Oracle은 Hyper-V를 실행 중인 Windows 호스트의 VirtualBox에 실험적 지원을 제공합니다. 그러나 Microsoft는 Hyper-V에서 VirtualBox를 지원하지 않습니다.
VirtualBox를 사용하여 Windows에 MongoDB를 설치하려면 Hyper-V를 비활성화합니다.
프로덕션 정보
프로덕션 환경에 MongoDB를 배포하기 전에, 프로덕션 MongoDB 배포에 대한 성능 고려 사항 및 구성 권장 사항을 제공하는 자체 관리 배포서버에 대한 프로덕션 노트 문서를 고려하세요.
풀타임 진단 데이터 캡처
MongoDB는 문제 해결을 지원하기 위해 진단 데이터를 기록합니다. 자세한 내용은 풀타임 진단 데이터 캡처에서 확인 가능합니다.
Windows에서 디스크, CPU, 메모리 등의 시스템 데이터를 수집하려면 FTDC가 다음 그룹의 Microsoft 액세스 권한을 요구합니다.
성능 모니터 사용자
성능 로그 사용자
mongod 및 mongos를 실행하는 사용자가 관리자가 아닌 경우 이 그룹에 추가하여 FTDC 데이터를 기록합니다. 자세한 내용은 여기에서 Microsoft 설명서를 참조하세요.
MongoDB 커뮤니티 에디션 설치
절차
이러한 단계에 따라 MongoDB 설치 마법사를 사용하여 MongoDB Community 에디션을 설치합니다. 설치 프로세스는 MongoDB 바이너리와 기본 구성 파일<install
directory>\bin\mongod.cfg를 모두 설치합니다.
MongoDB 커뮤니티 에디션 설치 마법사에 따라 진행합니다.
설치 마법사가 MongoDB와 MongoDB Compass 설치 과정을 단계별로 안내합니다.
- Choose Setup Type
- Complete(대부분의 사용자에게 권장) 또는 Custom 설정 유형 중 하나를 선택할 수 있습니다. Complete 설치 옵션은 기본 위치에 MongoDB 및 MongoDB 도구를 설치합니다. Custom 설정 옵션을 사용하면 설치할 실행 파일과 그 위치를 지정할 수 있습니다.
- Service Configuration
설치하는 동안 MongoDB를 Windows 서비스로 설정하거나 바이너리를 설치할 수 있습니다.
설치하는 동안 Windows 서비스로 MongoDB를 구성하고 시작할 수 있으며, 설치가 완료되면 MongoDB 서비스가 시작됩니다.
Install MongoD as a Service0}을 선택합니다.
다음 옵션 중 하나를 선택합니다.
Run the service as Network Service user (기본값)
이는 Windows에 기본 제공되는 Windows 사용자 계정입니다.
Run the service as a local or domain user
기존 로컬 사용자 계정의 경우 Account Domain 에 마침표(
.)를 지정하고 사용자에 대해 Account Name 및 Account Password 를 지정합니다.기존 도메인 사용자의 경우 해당 사용자에 대해 Account Domain, Account Name 및 Account Password 를 지정합니다.
Service Name. 서비스 이름을 지정합니다. 기본 이름은
MongoDB입니다. 지정된 이름의 서비스가 이미 있는 경우 다른 이름을 선택해야 합니다.Data Directory.
--dbpath에 해당하는 데이터 디렉토리를 지정합니다. 디렉토리가 존재하지 않는 경우 설치 프로그램은 디렉토리를 생성하고 서비스 사용자에 대한 디렉토리 액세스를 설정합니다.Log Directory.
--logpath에 해당하는 로그 디렉토리를 지정합니다. 디렉토리가 존재하지 않는 경우 설치 프로그램은 디렉토리를 생성하고 서비스 사용자에 대한 디렉토리 액세스를 설정합니다.
MongoDB를 Windows 서비스로 구성하지 않기로 선택한 경우 Install MongoD as a Service 선택을 취소하세요.
- Install MongoDB Compass
- 선택 사항입니다. 마법사로 MongoDB Compass를 설치하려면 Install MongoDB Compass(기본값)를 선택합니다.
준비가 완료되면 Install을 클릭합니다.
설치 mongosh
.msi 설치 프로그램에는 mongosh가 포함되지 않습니다. mongosh 설치 안내에 따라 셸을 별도로 다운로드하여 설치합니다.
MongoDB를 Windows 서비스로 설치한 경우
설치가 문제 없이 완료되면 MongoDB 서비스가 시작됩니다.
서비스를 사용자 정의에 따라 구성하려면 서비스를 중지해야 합니다. <install directory>\bin\mongod.cfg에서 구성 파일을 편집하여 MongoDB 인스턴스를 사용자 정의에 따라 설정합니다.
사용 가능한 구성 옵션에 대한 자세한 내용은 자체 관리형 구성 파일 옵션을 참조하세요.
변경 후 서비스를 다시 시작합니다.
MongoDB를 Windows 서비스로 설치하지 않은 경우
실행 파일만 설치하고 MongoDB를 Windows 서비스로 설치하지 않은 경우, MongoDB 인스턴스를 수동으로 시작해야 합니다.
MongoDB 인스턴스를 시작하는 방법은 명령 인터프리터에서 MongoDB Community Edition 실행하기를 참조하세요.
MongoDB 커뮤니티 에디션을 Windows 서비스로 실행
설치 중에 MongoDB를 Windows Service 으)로 설치하고 구성할 수 있습니다. 설치가 완료되면 MongoDB 서비스가 시작됩니다. 구성 파일 <install directory>\bin\mongod.cfg 을 사용하여 MongoDB 인스턴스를 구성합니다.
아직 설치하지 않았다면 mongosh 설치 지침 에 따라 MongoDB Shell(mongosh)을 다운로드하여 설치합니다.
설치 과저에서 PATH 환경 변수에 mongosh.exe 바이너리 경로를 추가해야 합니다.
새 Command Interpreter를 열고 mongosh.exe 입력하여 MongoDB에 연결합니다.
mongod에 연결할 때 mongosh.exe (예: 다른 호스트 및 포트에서 실행되는 MongoDB 인스턴스에 연결)에 연결하는 방법은 배포서버에 연결을 참조하세요.
CRUD(생성, 읽기, 업데이트, 삭제) 작업에 대한 자세한 내용은 아래에서 확인할 수 있습니다.
MongoDB Community Edition을 Windows 서비스로 시작
MongoDB 서비스를 시작/재시작하려면 서비스 콘솔을 사용합니다.
서비스 콘솔에서 MongoDB 서비스를 찾습니다.
MongoDB 서비스를 마우스 오른쪽 버튼으로 클릭하고 Start를 선택합니다.
MongoDB Community Edition을 Windows 서비스로 중지
MongoDB 서비스를 중지/일시 중지하려면 서비스 콘솔을 사용합니다.
서비스 콘솔에서 MongoDB 서비스를 찾습니다.
MongoDB 서비스를 마우스 오른쪽 버튼으로 클릭하고 Stop(또는 Pause)를 선택합니다.
Windows 서비스인 MongoDB 커뮤니티 에디션 제거하기
MongoDB 서비스를 제거하려면 먼저 서비스 콘솔을 사용하여 서비스를 중지합니다. 그런 다음 려면 Administrator로 Windows 명령 프롬프트/인터프리터(cmd.exe)를 열고 다음 명령을 실행합니다.
sc.exe delete MongoDB
명령 인터프리터에서 MongoDB Community Edition 실행
서비스 대신 Windows 명령 프롬프트/인터프리터(cmd.exe)에서 MongoDB Community 을 에디션실행할 수 있습니다.
Windows 명령 프롬프트/인터프리터(cmd.exe)를 Administrator로 엽니다.
중요
명령 인터프리터를 Administrator로 열어야 합니다.
데이터베이스 디렉토리를 생성합니다.
MongoDB가 데이터를 저장하는 데이터 디렉토리 를 생성합니다. MongoDB의 기본 데이터 디렉토리 경로는 MongoDB를 시작하는 드라이브의 절대 경로 \data\db 입니다.
Command Interpreter에서 데이터 디렉토리를 만듭니다.
cd C:\ md "\data\db"
MongoDB 데이터베이스를 시작합니다.
MongoDB를 시작하려면 mongod.exe를 실행합니다.
"C:\Program Files\MongoDB\Server\7.0\bin\mongod.exe" --dbpath="c:\data\db"
--dbpath 옵션은 데이터베이스 디렉토리를 가리킵니다.
MongoDB 데이터베이스 서버가 올바르게 실행되고 있는 경우 Command Interpreter 메시지가 표시됩니다.
[initandlisten] waiting for connections
중요
Windows 호스트의 Windows Defender 방화벽 설정에 따라 Windows가 C:\Program Files\MongoDB\Server\7.0\bin\mongod.exe '일부 기능'의 네트워크 통신을 차단한다는 Security Alert 대화 상자가 표시될 수 있습니다. 이 문제를 해결하려면 다음을 수행합니다.
Private Networks, such as my home or work network를 클릭합니다.
Allow access를 클릭합니다.
보안과 MongoDB에 대한 자세한 정보는 보안 문서에서 확인 가능합니다.
MongoDB에 연결합니다.
아직 설치하지 않았다면 mongosh 설치 지침 에 따라 MongoDB Shell(mongosh)을 다운로드하여 설치합니다.
설치 과저에서 PATH 환경 변수에 mongosh.exe 바이너리 경로를 추가해야 합니다.
새 Command Interpreter를 열고 mongosh.exe 입력하여 MongoDB에 연결합니다.
다른 호스트 및/또는 포트에서 실행되는 MongoDB 인스턴스에 연결하는 것과 같이 mongosh.exe를 사용하여 mongod에 연결하는 방법에 대한 자세한 내용은 배포 서버에 연결을 참조하세요.
CRUD(생성, 읽기, 업데이트, 삭제) 작업에 대한 자세한 내용은 아래에서 확인할 수 있습니다.
추가 고려 사항
기본 로컬 호스트 바인딩
기본적으로 MongoDB는 bindIp 를 로컬 호스트 네트워크 인터페이스에 바인딩하는 127.0.0.1 로 설정하여 실행됩니다. 즉, mongod.exe 는 동일한 시스템에서 실행 중인 클라이언트의 연결만 허용할 수 있습니다. 원격 클라이언트는 mongod.exe 에 연결할 수 없으며, 이 값이 원격 클라이언트가 액세스할 수 있는 유효한 네트워크 인터페이스로 설정되어 있지 않으면 mongod.exe 는 복제본 세트 를 초기화할 수 없습니다.
이 값은 다음 중 한 가지 방법으로 구성할 수 있습니다.
경고
공개적으로 액세스할 수 있는 IP 주소에 인스턴스를 바인딩하기 전에 무단 액세스로부터 클러스터를 보호해야 합니다. 보안 권장 사항의 전체 목록은 자체 관리 배포서버를 위한 보안 체크리스트를 참조하세요. 최소한 인증을 활성화 하고 네트워크 인프라를 강화하는 것을 고려하세요.
bindIp 구성에 대한 자세한 내용 은 자체 관리 배포서버의 IP 바인딩을 참조하세요.
포인트 릴리스 및 .msi
Windows 설치 프로그램(.msi)으로 MongoDB를 설치한 경우 .msi는 릴리스 시리즈에서 자동으로 업그레이드됩니다(예: 7.2.1~7.2.2).
정식 출시 시리즈를 업그레이드하려면(예 6.0에서 7.0) 새로 설치해야 합니다.
시스템 경로에 MongoDB 바이너리 추가
시스템 PATH에 C:\Program Files\MongoDB\Server\7.0\bin (을)를 추가하는 경우 MongoDB Server 바이너리에 대한 전체 경로를 생략할 수 있습니다. 아직 추가하지 않았다면 mongosh 경로도 추가해야 합니다.