MongoDB Community Edition を Windows にインストール
項目一覧
Overview
こちらのチュートリアルに従い、デフォルトのインストール ウィザードを使用して MongoDB 7.0 Community Edition を Windows にインストールします。
MongoDB バージョン
このチュートリアルでは、MongoDB 7.0 Community Edition をインストールします。別のバージョンの MongoDB Community をインストールするには、このページの左上にあるバージョンのドロップダウンメニューを使用して、該当バージョンのドキュメントを選択します。
インストール方法
このチュートリアルでは、デフォルトの MSI インストール ウィザードを使用して Windows に MongoDB をインストールします。代わりに、msiexec.exe
コマンドライン ツールを使用して MongoDB をインストールするには、「msiexec.exe を使用して MongoDB をインストールする」を参照してください。msiexec.exe
ツールは、オートメーションを使用して MongoDB を無人形式で展開したいシステム管理者に役立ちます。
Considerations
MongoDB Shell、 mongosh
MongoDB Shell(mongosh)は MongoDB Serverと一緒にインストールされません。mongosh のインストール手順に従って、mongosh を別途ダウンロードしてインストールする必要があります。
プラットフォーム サポート
MongoDB 7.0 Community Edition は、x86_64 アーキテクチャ上の次の 64 ビット バージョンの Windows をサポートしています。
Windows Server 2022
Windows Server 2019
Windows 11
MongoDB はこれらのプラットフォームの 64 ビット版のみをサポートしています。
詳しくは、「プラットフォーム サポート」を参照してください。
注意
MongoDB は Windows Subsystem for Linux(WSL)ではサポートされていません。Linux 上で MongoDB を実行するには、サポートされている Linux システムを使用してください。
仮想化
Oracle は 実験的なサポートを 提供しています Hyper-V が実行されている Windows ホスト上の Virtual Box 用。ただし、Microsoft は Hyper-V 上の Virtual Box をサポートしていません。
Disable Hyper-V if you want to install MongoDB on Windows using VirtualBox.
プロダクション ノート
MongoDB を本番環境に導入する前に、本番環境の MongoDB導入に関するパフォーマンス上の考慮事項と構成の推奨事項を示す 自己管理型配置のプロダクション ノート を検討してください。
Full Time Diagnostic Data Capture
MongoDB はトラブルシューティングを支援するために診断データをログに記録します。詳細については、「フルタイム診断データキャプチャ」を参照してください。
Windows では、ディスク、CPU、メモリなどのシステム データを収集するために、FTDC に次のグループからの Microsoft アクセス許可が必要です。
パフォーマンス モニター ユーザー
Performance Log Users
mongod
およびmongos
を実行しているユーザーが管理者でない場合は、これらのグループに追加して FTDC データをログに記録します。詳細については、こちらの Microsoftのドキュメントを参照してください。
MongoDB Community Edition のインストール
手順
MongoDB Installer ウィザードを使用して MongoDB Community Edition をインストールするには、次の手順に従います。インストール プロセスでは、MongoDB バイナリとデフォルトの構成ファイル <install
directory>\bin\mongod.cfg
の両方がインストールされます。
MongoDB Community Edition のインストール ウィザードに従います。
ウィザードが、MongoDB および MongoDB Compass のインストール手順を案内します。
- Choose Setup Type
- Complete(ほとんどのユーザーに推奨)またはCustom のいずれかの設定タイプを選択できます。Complete の設定オプションは、MongoDB と MongoDB ツールをデフォルトのロケーションにインストールします。Custom の設定オプションを使用すると、どの実行可能なファイルをどこにインストールするかを指定できます。
- Service Configuration
インストール時に MongoDB を Windows サービスとして設定することも、バイナリのみをインストールすることもできます。
インストール中に MongoDB を Windows サービスとして構成して開始できます。インストールに成功すると MongoDB サービスが開始されます。
Install MongoD as a Service を選択します。
次のいずれかのオプションを選択します。
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 のインストール手順に従って、shell を個別にダウンロードおよびインストールしてください。
MongoDB を Windows サービスとしてインストールした場合
インストールが成功すると、MongoDB サービスが開始されます。
サービスをカスタマイズする場合は、サービスを停止する必要があります。MongoDB インスタンスをカスタマイズするには、<install directory>\bin\mongod.cfg
にある構成ファイルを編集します。
使用可能な構成オプションの詳細については、「自己管理型構成ファイル オプション 」を参照してください。
変更を加えたら、サービスを再度開始します。
MongoDB を Windows サービスとしてインストールしていない場合
実行可能ファイルのみをインストールし、MongoDB を Windows サービスとしてインストールしなかった場合は、MongoDB インスタンスを手動で開始する必要があります。
MongoDB インスタンスの起動手順については、「コマンド インタープリタから MongoDB Community Edition を実行」を参照してください。
MongoDB Community Edition を Windows サービスとして実行
インストール時に MongoDB をWindows Serviceとしてインストールして構成できます。インストールが成功すると、MongoDB サービスが開始されます。構成ファイルの <install directory>\bin\mongod.cfg
を使用して MongoDB インスタンスを構成します。
もしまだ行っていない場合は、mongosh のインストール手順に従って、MongoDB Shell(mongosh)をダウンロードしてインストールします。
インストール中に、mongosh.exe
のバイナリへのパスを PATH
の環境変数に必ず追加してください。
新しい Command Interpreter を開き、mongosh.exe
と入力して MongoDB に接続します。
mongosh.exeを使用してmongod
に接続する方法の詳細(別のホストやポートで実行されている MongoDB インスタンスに接続する場合など)については、配置への接続を参照してください。
CRUD(作成、読み取り、更新、削除)操作の詳細については、以下を参照してください。
Start MongoDB Community Edition as a Windows Service
To start/restart the MongoDB service, use the Services console:
サービス コンソールから、MongoDB サービスを探します。
[MongoDB サービス] を右クリックし、[Start] をクリックします。
Stop MongoDB Community Edition as a Windows Service
MongoDB サービスを停止または一時停止するには、サービス コンソールを使用します。
サービス コンソールから、MongoDB サービスを探します。
[MongoDB サービス] を右クリックし、[Stop](または [Pause])をクリックします。
Windows サービスとしての MongoDB Community Edition を削除
MongoDB サービスを削除するには、まずサービス コンソールを使用してサービスを停止します。次に Windowsのコマンドプロンプト/インタープリター(cmd.exe
)をAdministratorとして開き、次のコマンドを実行します。
sc.exe delete MongoDB
Run MongoDB Community Edition from the Command Interpreter
MongoDB Community Edition は、サービスとしてではなく、Windows コマンド プロンプトやインタプリタ(cmd.exe
)から実行できます。
Windows コマンドプロンプト/インタープリター(cmd.exe
)をAdministratorとして開きます。
重要
コマンド インタプリタを Administrator として開く必要があります。
Create database directory.
Create the data directory where MongoDB stores data. MongoDB's default data directory path is the absolute path \data\db
on the drive from which you start MongoDB.
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"
The --dbpath
option points to your database directory.
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 の詳細については、セキュリティ ドキュメントを参照してください。
Connect to MongoDB.
もしまだ行っていない場合は、mongosh のインストール手順に従って、MongoDB Shell(mongosh)をダウンロードしてインストールします。
インストール中に、mongosh.exe
のバイナリへのパスを PATH
の環境変数に必ず追加してください。
新しい Command Interpreter を開き、mongosh.exe
と入力して MongoDB に接続します。
mongosh.exe を使用してmongod
に接続する方法の詳細(別のホストやポートで実行中の MongoDB インスタンスに接続する場合など)については配置への接続を参照してください。
CRUD(作成、読み取り、更新、削除)操作の詳細については、以下を参照してください。
その他の考慮事項
デフォルトの Localhost バインディング
By default, MongoDB launches with bindIp
set to 127.0.0.1
, which binds to the localhost network interface. This means that the mongod.exe
can only accept connections from clients that are running on the same machine. Remote clients will not be able to connect to the mongod.exe
, and the mongod.exe
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.
この値は、次のいずれかに設定できます。
警告
インスタンスをパブリックにアクセス可能な IP アドレスにバインドする前に、クラスターを不正アクセスから保護する必要があります。 セキュリティ推奨事項の完全なリストについては、「自己管理型配置のセキュリティ チェックリスト」を参照してください。 最低限、認証を有効化し、ネットワーク インフラストラクチャの強化 を検討してください。
bindIp
の構成の詳細については、「自己管理型配置の IP バインディング 」を参照してください。
Point Releases and .msi
MongoDB を Windows インストーラー( .msi
)でインストールした場合、 .msi
はリリース シリーズ内で自動的にアップグレードされます(例: 7.2.1から7.2.2へ)。
フル リリース シリーズへのアップグレード(6.0から7.0へのアップグレードの場合など)には新規インストールが必要です。
Add MongoDB binaries to the System PATH
システムPATH
にC:\Program Files\MongoDB\Server\7.0\bin
を追加すると、MongoDB Server バイナリへの完全なパスを省略できます。まだ行っていない場合は、mongosh へのパスも追加する必要があります。