在 Ubuntu 上安装 MongoDB 社区版

笔记

MongoDB atlas

MongoDB atlas 是云中托管的 MongoDB 服务选项,无需安装开销,并提供免费套餐以供入门。

概述

使用本教程使用apt包管理器在 Ubuntu Linux 的 LTS(长期支持)版本上 安装 MongoDB 7.0 Community Edition。

MongoDB 版本

本教程安装 MongoDB 7.0 Community Edition。要安装不同版本的 MongoDB Community ,请使用此页面左上角的版本下拉菜单选择该版本的文档。

注意事项

平台支持

MongoDB 7.0 社区版支持 x86_64 架构上的以下 64 位 Ubuntu LTS(长期支持)版本:

  • 22.04 LTS ("Jammy")
  • 20.04 LTS ("Focal")

MongoDB 仅支持这些平台的 64 位版本。

Ubuntu 上的 MongoDB 7.0 社区版还支持特定平台上的 ARM64 架构。

有关详细信息,请参阅平台支持

制作说明

在生产环境中部署 MongoDB 之前,请考虑 生产说明文档,其中提供了生产 MongoDB 部署的性能注意事项和配置建议。

官方 MongoDB 包

要在您的Ubuntu系统上安装 MongoDB Community ,这些说明将使用由 MongoDB Inc 维护和支持的官方包。官方 包始终包含最新版本的 MongoDB,并且可以从其自己的专用存储库中获得。mongodb-org``mongodb-org

重要

Ubuntu提供的mongodb包不是 MongoDB Inc.维护的,与官方 mongodb-org有冲突。如果您已经在Ubuntu系统 上安装了mongodb软件包,则必须先卸载mongodb软件包,然后才能继续执行这些说明。

MongoDB 社区版包官方软件包的完整列表

安装 MongoDB 社区版

按照以下步骤使用apt包管理器安装 MongoDB Community Edition 。

导入包管理系统使用的公钥。

从终端发出以下命令以从中导入 MongoDB 公共 GPG 密钥 https://www.mongodb.org/static/pgp/server-7.0.asc

wget -qO - https://www.mongodb.org/static/pgp/server-7.0.asc | sudo apt-key add -

该操作应以OK.

但是,如果您收到指示gnupg未安装的错误消息,您可以:

  1. 使用以下命令安装gnupg及其所需的库:

    sudo apt-get install gnupg
    
  1. 安装后,重试导入密钥:

    wget -qO - https://www.mongodb.org/static/pgp/server-7.0.asc | sudo apt-key add -
    

为 MongoDB 创建一个列表文件。

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

单击适合您的 Ubuntu 版本的选项卡。如果您不确定主机运行的是哪个 Ubuntu 版本,请在主机上打开终端或 shell 并执行lsb_release -dc.

以下说明适用于Ubuntu 22.04 (Jammy)

/etc/apt/sources.list.d/mongodb-org-7.0.list 为 Ubuntu 22.04 (Jammy)创建 文件:

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

以下说明适用于Ubuntu 20.04 (Focal)

/etc/apt/sources.list.d/mongodb-org-7.0.list 为 Ubuntu 20.04 (Focal)创建 文件:

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

重新加载本地包数据库。

发出以下命令以重新加载本地包数据库:

sudo apt-get update

安装 MongoDB 包。

您可以安装最新稳定版本的 MongoDB 或特定版本的 MongoDB。

安装最新稳定版本的 MongoDB

要安装最新的稳定版本,请发出以下命令

sudo apt-get install -y mongodb-org

特定版本的 MongoDB

要安装特定版本,您必须单独指定每个组件包以及版本号,如下例所示:

sudo apt-get install -y mongodb-org=7.0 mongodb-org-database=7.0 mongodb-org-server=7.0 mongodb-mongosh=7.0 mongodb-org-mongos=7.0 mongodb-org-tools=7.0

如果您只安装mongodb-org=7.0而不包含组件包,则无论您指定哪个版本,都将安装每个 MongoDB 包的最新版本。

可选的。虽然您可以指定任何可用的 MongoDB 版本,但 apt-get会在更新版本可用时升级包。为防止意外升级,您可以将软件包固定在当前安装的版本上:

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

如需帮助解决在 Ubuntu 上安装 MongoDB 时遇到的错误,请参阅我们的 故障排除指南。

运行 MongoDB 社区版

  • ulimit 注意事项

    大多数类 Unix 操作系统限制进程可能使用的系统资源。这些限制可能会对 MongoDB 操作产生负面影响,应该进行调整。有关为您的平台推荐的设置,请参阅UNIXulimit设置。笔记ulimit从 MongoDB 4.4 开始,如果打开文件数的值小于 ,则会生成启动错误 64000

  • 目录

    如果您是通过包管理器安装的,数据目录 /var/lib/mongodb和日志目录/var/log/mongodb是在安装过程中创建的。默认情况下,MongoDB 使用mongodb用户帐户运行。如果更改运行 MongoDB 进程的用户,则还必须修改对数据和日志目录的权限,以授予该用户访问这些目录的权限。

  • 配置文件

    官方 MongoDB 包中包含一个配置文件( /etc/mongod.conf)。这些设置(例如数据目录和日志目录规范)在启动时生效。也就是说,如果在MongoDB实例运行时更改配置文件,必须重启实例才能使更改生效。

程序

按照以下步骤在您的系统上运行 MongoDB Community Edition。这些说明假定您使用的是官方包——而不是Ubuntu提供mongodb-org 的非官方mongodb包 ——并且使用的是默认设置。

初始化系统

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

如果您不确定您的平台使用哪个 init 系统,请运行以下命令:

ps --no-headers -o comm 1

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

  • systemd- 选择下面的systemd (systemctl)选项卡。
  • init- 选择下面的System V Init(服务)选项卡。

1、启动 MongoDB。

mongod您可以通过发出以下命令来启动该过程:

sudo systemctl start mongod

如果您在启动时收到类似以下的错误 mongod

Failed to start mongod.service: Unit mongod.service not found.

首先运行以下命令:

sudo systemctl daemon-reload

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

2、验证 MongoDB 是否已成功启动。

sudo systemctl status mongod

您可以选择通过发出以下命令确保 MongoDB 将在系统重启后启动:

sudo systemctl enable mongod

3、停止 MongoDB。

mongod根据需要,您可以通过发出以下命令来停止该过程:

sudo systemctl stop mongod

4、重新启动 MongoDB。

您可以mongod通过发出以下命令来重新启动该过程:

sudo systemctl restart mongod

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

5、开始使用 MongoDB。

开始一个mongoshmongod 在同一台主机上的会话。你可以跑mongosh 没有任何命令行选项来连接到 mongod在默认端口 27017 上运行的本地主机上。

mongosh

System V Init(服务)

1、启动 MongoDB。

发出以下命令来启动mongod

sudo service mongod start

2、验证MongoDB是否启动成功

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

sudo service mongod status

您还可以检查日志文件以了解进程的当前状态 ,默认情况下mongod位于: /var/log/mongodb/mongod.log正在运行的 mongod实例将指示它已准备好使用以下行进行连接:

3、停止 MongoDB。

根据需要,您可以mongod通过发出以下命令来停止该进程:

sudo service mongod stop

4、重新启动 MongoDB

发出以下命令重新启动mongod

sudo service mongod restart

5、开始使用 MongoDB。

开始一个mongosh会话与 mongod. 你可以运行mongosh 没有任何命令行选项来连接到 mongod在本地主机上运行的默认端口 27017。

mongosh

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

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

卸载 MongoDB 社区版

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

警告

此过程将完全删除 MongoDB、其配置和所有 数据库。此过程不可逆,因此请确保在继续之前备份所有配置和数据。

停止 MongoDB。

mongod通过发出以下命令停止进程:

sudo service mongod stop

删除包。

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

sudo apt-get purge mongodb-org*

删除数据目录。

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

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

附加信息

默认绑定本地主机

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

该值可以配置为:

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

WARNING

在绑定到非本地主机(例如可公开访问的)IP 地址之前,请确保您已保护集群免受未经授权的访问。有关安全建议的完整列表,请参阅 安全清单。至少,考虑 启用身份验证强化网络基础设施。

有关配置的详细信息bindIp,请参阅 IP 绑定。

MongoDB 社区版包

MongoDB Community Edition 可从其自己的专用存储库获得,并包含以下官方支持的包:

包裹名字 描述
mongodb-org 一个metapackage自动安装下面列出的组件包的。
mongodb-org-database 一个metapackage自动安装下面列出的组件包的。包裹名字描述mongodb-org-server包含mongod守护程序、关联的初始化脚本和配置文件( /etc/mongod.conf)。您可以使用初始化脚本从mongod 配置文件开始。有关详细信息,请参阅上面的“运行 MongoDB 社区版”部分。mongodb-org-mongos包含mongos守护进程。
mongodb-mongosh 包含 MongoDB shell (mongosh).
mongodb-org-tools 一个metapackage自动安装下面列出的组件包的:包裹名字描述mongodb-database-tools包含以下 MongoDB 数据库工具:mongodumpmongorestorebsondumpmongoimportmongoexportmongostatmongotopmongofilesmongodb-org-database-tools-extra包含install_compass脚本

原文链接 -https://www.mongodb.com/docs/v7.0/tutorial/install-mongodb-on-ubuntu/

译者:韩鹏帅

Copyright © 上海锦木信息技术有限公司 all right reserved,powered by Gitbook文件修订时间: 2023-09-01 17:10:26

results matching ""

    No results matching ""