在 Ubuntu 上安装 MongoDB 企业版

本页内容

概述

注意事项
安装 MongoDB 企业版
运行 MongoDB 企业版
卸载 MongoDB
更多信息

概述

使用本教程安装 MongoDB 8.0企业版使用 apt 软件包管理器在 Ubuntu Linux 的 LTS (长期支持) 版本上安装apt

MongoDB 企业版可在一些平台上使用，并包含与安全性和监控相关的多个功能。

MongoDB 版本

本教程安装 MongoDB 8.0 版本。企业版若要安装 MongoDB 的其他版本企业版，请使用页面右上角的版本下拉菜单选择该版本的文档。

注意事项

平台支持

MongoDB 8.0 企业版支持以下64位 Ubuntu LTS (长期支持) 版本在x86_64 架构上

24.04 LTS ("Noble")
22.04 LTS ("Jammy")
20.04 LTS ("Focal")

MongoDB 仅支持这些平台的 64 位版本。要确定您的宿主机正在运行哪个 Ubuntu 版本，请在宿主机的终端运行以下命令：

cat /etc/lsb-release

MongoDB 8.0 企业版在 Ubuntu 上还支持在部分平台上运行 ARM64 架构。

有关更多信息，请参阅平台支持。

对于支持 Ubuntu 16.04 POWER/PPC64LE 的早期 MongoDB 企业版本

由于 Ubuntu 16.04 POWER 上的旧版 glibc 软件包中存在锁消除错误，您必须在运行 MongoDB 之前将 glibc 软件包升级到至少 glibc 2.23-0ubuntu5。使用旧版 glibc 软件包的系统将由于随机内存损坏而导致数据库服务器崩溃和异常行为，不适合 MongoDB 的生产部署。

生产注意事项

在将 MongoDB 部署到生产环境之前，请考虑自管理部署的生产注意事项文档，该文档提供了生产 MongoDB 部署的性能考虑因素和配置建议。

官方 MongoDB 软件包

要安装 MongoDB企业版在您的Ubuntu系统上，以下说明将使用由 MongoDB Inc. 维护和支持的官方 mongodb-enterprise 软件包，该软件包始终包含最新版本的 MongoDB，并可通过其专用仓库获取。

重要

由Ubuntu提供的 mongodb 软件包不是由 MongoDB Inc. 维护的，并且与官方的 mongodb-enterprise 软件包冲突。如果您已经在您的系统上安装了 mongodb 软件包，请参阅以下内容：Ubuntu在继续以下步骤之前，您必须首先卸载 mongodb 软件包。

请参阅MongoDB Enterprise Edition Packages获取官方软件包的完整列表。

安装 MongoDB Enterprise Edition

按照以下步骤安装 MongoDB企业版使用 apt 软件包管理器。

导入公钥

如果尚未安装，请在终端中安装 gnupg 和 curl。

sudo apt-get install gnupg curl

导入 MongoDB 公共 GPG 密钥，请运行以下命令

curl -fsSL https://pgp.mongodb.com/server-8.0.asc | \
   sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg \
   --dearmor

创建列表文件

为您的 Ubuntu 版本创建列表文件 /etc/apt/sources.list.d/mongodb-enterprise-8.0.list。

为 Ubuntu 24.04 (Noble) 创建列表文件

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.com/apt/ubuntu noble/mongodb-enterprise/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise-8.0.list

为 Ubuntu 22.04 (Jammy) 创建列表文件

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.com/apt/ubuntu jammy/mongodb-enterprise/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise-8.0.list

为 Ubuntu 20.04 (Focal) 创建列表文件。

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] http://repo.mongodb.com/apt/ubuntu focal/mongodb-enterprise/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise-8.0.list

重新加载包数据库。

运行以下命令重新加载本地包数据库

sudo apt-get update

安装 MongoDB 企业版服务器。

要安装 MongoDB 企业版服务器的最新发布版，请运行以下命令

sudo apt-get install -y mongodb-enterprise

要安装特定发布版，必须分别指定每个组件包及其版本号，如下例所示

sudo apt-get install -y mongodb-enterprise=8.0.0 mongodb-enterprise-database=8.0.0 mongodb-enterprise-server=8.0.0 mongodb-mongosh mongodb-enterprise-mongos=8.0.0 mongodb-enterprise-tools=8.0.0

如果您仅安装 mongodb-enterprise=8.0.0 而不包含组件包，则将安装每个 MongoDB 包的最新版本，无论您指定了哪个版本。

尽管您可以指定任何可用的 MongoDB 版本，但 apt-get 在有新版本可用时将升级包。要防止意外升级，请锁定包。要将 MongoDB 的当前安装版本锁定为版本，请运行以下命令序列

echo "mongodb-enterprise hold" | sudo dpkg --set-selections
echo "mongodb-enterprise-server hold" | sudo dpkg --set-selections
echo "mongodb-enterprise-database hold" | sudo dpkg --set-selections
echo "mongodb-mongosh hold" | sudo dpkg --set-selections
echo "mongodb-enterprise-mongos hold" | sudo dpkg --set-selections
echo "mongodb-enterprise-tools hold" | sudo dpkg --set-selections

注意

您还可以安装使用系统 OpenSSL 的 MongoDB Shell。在安装此版本的 MongoDB Shell 之前，您必须在您的系统上已经安装 OpenSSL。

您可以在不先删除 MongoDB Shell 的情况下安装所有 MongoDB 企业版包和使用系统 OpenSSL 的 MongoDB Shell。例如

sudo apt-get install -y mongodb-enterprise mongodb-mongosh-shared-openssl11

以下示例首先删除 MongoDB Shell，然后安装使用系统 OpenSSL 1.1 的 MongoDB Shell

sudo apt-get remove -y mongodb-mongosh && sudo apt-get install -y
mongodb-mongosh-shared-openssl11

以下示例首先删除 MongoDB Shell，然后安装使用系统 OpenSSL 3 的 MongoDB Shell

sudo apt-get remove -y mongodb-mongosh && sudo apt-get install -y
mongodb-mongosh-shared-openssl3

您还可以选择要安装的 MongoDB 包。

以下示例安装 MongoDB 企业版、工具和使用系统 OpenSSL 1.1 的 MongoDB Shell

sudo apt-get install -y mongodb-enterprise-database
mongodb-enterprise-tools mongodb-mongosh-shared-openssl11

以下示例安装 MongoDB 企业版、工具和使用系统 OpenSSL 3 的 MongoDB Shell

sudo apt-get install -y mongodb-enterprise-database
mongodb-enterprise-tools mongodb-mongosh-shared-openssl3

有关在 Ubuntu 上安装 MongoDB 时遇到的错误故障排除的帮助，请参阅我们的故障排除指南。

运行 MongoDB 企业版

默认情况下，MongoDB 实例存储

其数据文件在 /var/lib/mongodb
其日志文件在 /var/log/mongodb

如果您通过软件包管理器安装，这些默认目录将在安装过程中创建。

如果您通过下载 tarball 手动安装，您可以使用 mkdir -p <目录> 或 sudo mkdir -p <目录> 来创建目录，具体取决于将运行 MongoDB 的用户。（有关 mkdir 和 sudo 的信息，请参阅您的 Linux 手册页。）

默认情况下，MongoDB 使用 mongodb 用户账户运行。如果您更改运行 MongoDB 进程的用户，您必须修改 /var/lib/mongodb 和 /var/log/mongodb 目录的权限，以允许此用户访问这些目录。

要指定不同的日志文件目录和数据文件目录，请编辑 /etc/mongod.conf 中的 systemLog.path 和 storage.dbPath 设置。确保运行 MongoDB 的用户可以访问这些目录。

大多数类 Unix 操作系统限制进程可能使用的系统资源。这些限制可能会对 MongoDB 的运行产生负面影响，应进行调整。有关您平台推荐的设置，请参阅自管理部署的 UNIX ulimit 设置。

注意

如果打开文件的 ulimit 值小于 64000，MongoDB 会生成启动警告。

程序

按照以下步骤在您的系统上运行 MongoDB企业版版本。这些说明假定您正在使用官方的 mongodb-enterprise 软件包——不是由提供的不官方的 mongodb 软件包。Ubuntu默认设置。

初始化系统

要运行和管理您的 mongod 进程，您将使用操作系统内置的初始化系统。Linux的最新版本倾向于使用 systemd（使用 systemctl 命令），而较老版本的Linux倾向于使用 System V 初始化（使用 service 命令）。

如果您不确定您的平台使用的是哪个初始化系统，请运行以下命令

ps --no-headers -o comm 1

然后根据结果选择下面的适当选项卡

systemd - 选择下面的 systemd (systemctl) 选项卡。
init - 选择下面的 System V 初始化 (service) 选项卡。

启动 MongoDB.

您可以通过以下命令启动 mongod 进程

sudo systemctl start mongod

当您启动 mongod 时，如果您收到类似于以下错误：

无法启动 mongod.service：未找到 Unit mongod.service。

首先运行以下命令

sudo systemctl daemon-reload

然后再次运行上面的启动命令。

验证 MongoDB 是否已成功启动。

sudo systemctl status mongod

您可以选择运行以下命令以确保系统重启后 MongoDB 将启动。

sudo systemctl enable mongod

停止MongoDB。

根据需要，您可以通过以下命令停止 mongod 进程

sudo systemctl stop mongod

重新启动MongoDB。

您可以通过以下命令重新启动 mongod 进程

sudo systemctl restart mongod

您可以通过查看 /var/log/mongodb/mongod.log 文件中的输出，来跟踪进程状态以查找错误或重要消息。

开始使用MongoDB。

在 mongosh 上启动一个与 mongod 相同的主机机器上的会话。您可以在没有任何命令行选项的情况下运行 mongosh，以连接到默认端口 27017 的本地主机上的 mongod。

mongosh

有关使用 mongosh 连接的更多信息，例如连接到运行在不同主机和/或端口的 mongod 实例，请参阅 mongosh 文档。

为了帮助您开始使用 MongoDB，MongoDB 为各种驱动程序版本提供了入门指南。有关驱动程序文档，请参阅使用 MongoDB 开始开发。

启动 MongoDB。

执行以下命令以启动 mongod:

sudo service mongod start

验证 MongoDB 是否已成功启动

验证 mongod 进程是否已成功启动

sudo service mongod status

您还可以检查日志文件以了解 mongod 进程的当前状态，默认位于： /var/log/mongodb/mongod.log。正在运行的 mongod 实例将以下行表示为已准备好连接：

[initandlisten] waiting for connections on port 27017

停止 MongoDB.

根据需要，您可以通过以下命令停止 mongod 进程

sudo service mongod stop

重启 MongoDB.

运行以下命令以重启 mongod:

sudo service mongod restart

开始使用 MongoDB.

mongosh

有关使用 mongosh 连接的更多信息，例如连接到运行在不同主机和/或端口的 mongod 实例，请参阅 mongosh 文档。

为了帮助您开始使用 MongoDB，MongoDB 为各种驱动程序版本提供了入门指南。有关驱动程序文档，请参阅使用 MongoDB 开始开发。

卸载 MongoDB

要完全从系统中删除 MongoDB，您必须删除 MongoDB 应用程序本身、配置文件以及包含数据和日志的任何目录。以下部分将引导您完成必要的步骤。

警告

此过程将完全删除MongoDB、其配置以及所有数据库。此过程不可逆，因此在进行操作之前，请确保已备份所有配置和数据。

停止MongoDB。

通过以下命令停止 mongod 进程

sudo service mongod stop

移除包。

移除您之前安装的所有MongoDB包。

sudo apt-get purge mongodb-enterprise*

移除数据目录。

移除MongoDB数据库和日志文件。

sudo rm -r /var/log/mongodb
sudo rm -r /var/lib/mongodb

附加信息

升级MongoDB企业版

在升级MongoDB时企业版版本，请确保您使用的是官方包。每个组件的版本应与以下示例中指定的一致

VERSION=6.0.7 sudo apt-get install -y \
  mongodb-enterprise=${VERSION} \
  mongodb-enterprise-server=${VERSION} \
  mongodb-enterprise-mongos=${VERSION} \
  mongodb-enterprise-tools=${VERSION}

默认绑定到本机

默认情况下，MongoDB启动时将bindIp设置为127.0.0.1，这绑定到本机网络接口。这意味着mongod只能接受运行在同一台机器上的客户端的连接。远程客户端将无法连接到mongod，除非将此值设置为有效的网络接口，否则mongod将无法初始化一个副本集。

此值可以通过以下方式配置：

在MongoDB配置文件中使用 bindIp，或者
通过命令行参数 --bind_ip

警告

在将实例绑定到公开可访问的IP地址之前，您必须确保集群安全，防止未经授权的访问。有关安全建议的完整列表，请参阅自我管理部署的安全清单。至少，请考虑启用身份验证和加强网络基础设施。

有关配置bindIp的更多信息，请参阅自我管理部署中的IP绑定。

MongoDB企业版软件包

MongoDB企业版软件包可通过其专用仓库获取，并包含以下官方支持的软件包

软件包名称

描述

mongodb-enterprise

一个 metapackage，可以自动安装以下列表中的组件软件包。

mongodb-enterprise-database

一个 metapackage，可以自动安装以下列表中的组件软件包。

软件包名称	描述
`mongodb-enterprise-server`	包含 `mongod` 守护进程以及相关的配置和初始化脚本。
`mongodb-enterprise-mongos`	包含 `mongos` 守护进程。
`mongodb-enterprise-cryptd`	包含 mongocryptd 二进制文件

mongodb-mongosh

包含 MongoDB Shell (mongosh)。

mongodb-shared-openssl*

包含使用您计算机上已安装的 OpenSSL 版本的 MongoDB Shell (mongosh)。

mongodb-enterprise-tools

一个 metapackage，可以自动安装以下列表中的组件软件包

软件包名称	描述
`mongodb-database-tools`	包含以下 MongoDB 数据库工具 `mongodump` `mongorestore` `bsondump` `mongoimport` `mongoexport` `mongostat` `mongotop` `mongofiles`
`mongodb-enterprise-database-tools-extra`	包含以下MongoDB支持工具： `mongoldap` `mongokerberos` `install_compass` 脚本 `mongodecrypt` 二进制文件

使用 .tgz Tarball 安装