Importante
MongoDB 8.2 es la última versión menor. A partir de MongoDB 8.2, hay versiones menores disponibles para implementaciones locales (MongoDB Community y Enterprise) para casos de uso específicos. Para más información, consulte Control de versiones de MongoDB.
Para instalar la última versión de MongoDB compatible para uso on-premises, consulta las instrucciones de instalación.
Overview
Utilice este tutorial para instalar MongoDB 8.2 Enterprise Edition en versiones LTS (soporte a largo plazo) de Ubuntu Linux mediante el
apt gestor de paquetes
MongoDB Enterprise Edition está disponible en plataformas seleccionadas e incluye soporte para varias características relacionadas con la seguridad y la supervisión.
Versión de MongoDB
Este tutorial instala MongoDB 8.2 Enterprise Edition. Para instalar una versión diferente de MongoDB Enterprise, utilice el menú desplegable de versiones en Self-Managed Deployments en el lado izquierdo de esta página para seleccionar la documentación para esa versión.
Considerations
Soporte de plataforma
MongoDB 8.2 Enterprise Edition admite lo siguiente Versiones de Ubuntu LTS (soporte a largo plazo) de64bit en86la arquitectura x64 _:
24.04 LTS ("Noble")
22.04 LTS ("Jammy")
20.04 LTS ("Focal")
MongoDB solo ofrece soporte para las versiones de 64 bits de estas plataformas. Para determinar qué versión de Ubuntu está ejecutando el host, se debe ejecutar el siguiente comando en el terminal del host:
cat /etc/lsb-release
MongoDB 8.2 Enterprise Edition en Ubuntu también admite la arquitectura ARM64 en plataformas seleccionadas.
Consulte Soporte de plataforma para obtener más información.
Para versiones anteriores de MongoDB Enterprise que admiten Ubuntu 16.04 POWER/PPC64LE:
Debido a un error de elisión de bloqueo presente en versiones anteriores del paquete glibc en Ubuntu 16.04 para POWER, debe actualizar el paquete glibc al menos a glibc 2.23-0ubuntu5 antes de ejecutar MongoDB. Los sistemas con versiones anteriores del paquete glibc experimentarán fallos en el servidor de base de datos y un comportamiento incorrecto debido a la corrupción aleatoria de memoria, y no son adecuados para implementaciones de producción de MongoDB.
Notas de producción
Antes de implementar MongoDB en un entorno de producción, considera el documento Notas de Producción para Implementaciones Autogestionadas, que ofrece consideraciones de rendimiento y recomendaciones de configuración para implementaciones de MongoDB en producción.
Paquetes oficiales de MongoDB
Para instalar MongoDB Enterprise en tu sistema Ubuntu, estas instrucciones utilizarán el paquete oficial mongodb-enterprise, que está mantenido y respaldado por MongoDB Inc. El paquete oficial mongodb-enterprise siempre contiene la última versión de MongoDB y está disponible desde su propio repositorio dedicado.
Importante
El paquete mongodb proporcionado por Ubuntu no es mantenido por MongoDB Inc. y entra en conflicto con el paquete oficial mongodb-enterprise. Si ya se instaló el paquete mongodb en el sistema Ubuntu, primero se debe desinstalar el paquete mongodb antes de continuar con estas instrucciones.
Consulte Paquetes de MongoDB Enterprise Edition para obtener la lista completa de paquetes oficiales.
Instale MongoDB Enterprise Edition
Sigue estos pasos para instalar MongoDB Enterprise Edition usando el gestor de paquetes apt.
Importe la llave pública.
Desde un terminal, instale gnupg y curl si no están ya disponibles:
sudo apt-get install gnupg curl
Para importar la clave GPG pública de MongoDB, ejecute el siguiente comando:
curl -fsSL https://pgp.mongodb.com/server-8.0.asc | \ sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg \ --dearmor
Crea el archivo de lista.
Crea el archivo de lista /etc/apt/sources.list.d/mongodb-org-8.2.list para su versión de Ubuntu.
Cree el archivo de lista para 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.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise-8.2.list
Se debe crear el archivo de lista para 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.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise-8.2.list
Cree el archivo de lista para 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.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise-8.2.list
Instala MongoDB Enterprise servidor.
Para instalar la última versión de MongoDB Enterprise Server, ejecute el siguiente comando:
sudo apt-get install mongodb-enterprise
Para instalar una versión específica, debe especificar cada paquete de componente individualmente junto con el número de versión, como en el siguiente ejemplo:
sudo apt-get install -y mongodb-enterprise=8.2.0 mongodb-enterprise-database=8.2.0 mongodb-enterprise-server=8.2.0 mongodb-mongosh mongodb-enterprise-mongos=8.2.0 mongodb-enterprise-tools=8.2.0
Si solo instala mongodb-enterprise=8.2.0 y no incluye los paquetes de componentes, se instalará la última versión de cada paquete de MongoDB independientemente de la versión que haya especificado.
Aunque puede especificar cualquier versión disponible de MongoDB, apt-get actualiza los paquetes cuando hay una versión más reciente disponible. Para evitar actualizaciones no deseadas, fije el paquete. Para fijar la versión de MongoDB a la versión instalada actualmente, ejecute la siguiente secuencia de comandos:
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
Nota
También se puede instalar el MongoDB Shell que utiliza el OpenSSL del sistema. Se debe haber instalado OpenSSL en el sistema antes de instalar esta versión de MongoDB Shell.
Puedes instalar todos los paquetes de MongoDB Enterprise y el MongoDB Shell que utiliza el OpenSSL del sistema sin remover primero el MongoDB Shell. Por ejemplo:
sudo apt-get install -y mongodb-enterprise mongodb-mongosh-shared-openssl11
El siguiente ejemplo remueve el MongoDB Shell y luego instala el MongoDB Shell que utiliza el OpenSSL 1.1 del sistema:
sudo apt-get remove -y mongodb-mongosh && sudo apt-get install -y mongodb-mongosh-shared-openssl11
El siguiente ejemplo remueve el MongoDB Shell y luego instala el MongoDB Shell que utiliza el OpenSSL 3 del sistema:
sudo apt-get remove -y mongodb-mongosh && sudo apt-get install -y mongodb-mongosh-shared-openssl3
También puedes elegir los paquetes de MongoDB que deseas instalar.
En el siguiente ejemplo se instalan MongoDB Enterprise y las herramientas, así como el MongoDB Shell que utiliza OpenSSL 1.1 del sistema:
sudo apt-get install -y mongodb-enterprise-database mongodb-enterprise-tools mongodb-mongosh-shared-openssl11
En el siguiente ejemplo se instalan MongoDB Enterprise y las herramientas, así como el MongoDB Shell que utiliza OpenSSL 3 del sistema:
sudo apt-get install -y mongodb-enterprise-database mongodb-enterprise-tools mongodb-mongosh-shared-openssl3
Para obtener ayuda con la solución de errores encontrados al instalar MongoDB en Ubuntu, consulta nuestra guía de solución de problemas.
Ejecute MongoDB Enterprise Edition
Por defecto, una instancia de MongoDB almacena:
sus archivos de datos en
/var/lib/mongodbsus archivos de registro en
/var/log/mongodb
Si se instalaron a través del administrador de paquetes, estos directorios por defecto se crean durante la instalación.
Si se realizó la instalación manual descargando los tarballs, se pueden crear los directorios utilizando mkdir -p <directory> o sudo mkdir -p
<directory> dependiendo del usuario que ejecutará MongoDB. (Consultar las páginas del manual de Linux para obtener información sobre mkdir y sudo.)
Por defecto, MongoDB se ejecuta utilizando la cuenta de usuario mongodb. Si cambia el usuario que ejecuta el proceso de MongoDB, también debe modificar los permisos de los directorios /var/lib/mongodb y /var/log/mongodb para dar a este usuario acceso a estos directorios.
Para especificar un directorio de entrada de registro y un directorio de archivo de datos diferentes, edite las configuraciones systemLog.path y storage.dbPath en el /etc/mongod.conf. Asegúrese de que el usuario que ejecuta MongoDB tenga acceso a estos directorios.
La mayoría de los sistemas operativos similares a Unix limitan los recursos del sistema que un proceso puede utilizar. Estos límites pueden tener un impacto negativo en la operación de MongoDB y deben ajustarse. Se debe consultar Configuraciones de UNIX ulimit para implementaciones autogestionadas y conocer las configuraciones recomendadas para la plataforma.
Nota
Si el valor ulimit para el número de archivos abiertos es inferior a 64000, MongoDB genera una advertencia de inicio.
Procedimiento
Se deben seguir estos pasos para ejecutar MongoDB Enterprise Edition en el sistema. Estas instrucciones asumen que se está utilizando el paquete mongodb-enterprise oficial, no el paquete mongodb no oficial proporcionado por Ubuntu, y que se está utilizando la configuración por defecto.
Sistema de inicialización
Para ejecutar y gestionar el proceso de mongod, se usará el sistema de inicialización incorporado del sistema operativo. Las versiones recientes de Linux tienden a usar systemd (que utiliza el comando systemctl), mientras que las versiones más antiguas de Linux tienden a usar System V init (que utiliza el comando service).
Si no está seguro de qué sistema de inicialización utiliza su plataforma, ejecute el siguiente comando:
ps --no-headers -o comm 1
Luego, seleccione la pestaña adecuada a continuación según el resultado:
systemd- selecciona la pestaña systemd (systemctl) a continuacióninit- selecciona la pestaña System V Init (service) a continuación.
Inicia MongoDB.
Puedes iniciar el proceso mongod emitiendo el siguiente comando:
sudo systemctl start mongod
Si recibe un error similar al siguiente al iniciar mongod:
Failed to start mongod.service: Unit mongod.service not found.
Ejecute primero el siguiente comando:
sudo systemctl daemon-reload
Luego ejecuta de nuevo el comando de inicio mencionado arriba.
Detenga MongoDB.
Según sea necesario, puedes detener el proceso mongod ejecutando el siguiente comando:
sudo systemctl stop mongod
Reinicia MongoDB.
Puedes reiniciar el proceso mongod emitiendo el siguiente comando:
sudo systemctl restart mongod
Puedes seguir el estado del proceso para detectar errores o mensajes importantes observando la salida en el archivo /var/log/mongodb/mongod.log.
Comienza a utilizar MongoDB.
Inicia una sesiónmongosh en la misma máquina host que el mongod. Puedes ejecutar mongosh sin opciones de línea de comandos para conectarse a un mongod que se ejecuta en su localhost con el puerto por defecto 27017.
mongosh
Para obtener más información sobre cómo conectarse usando mongosh, por ejemplo, para conectarse a una instancia mongod que se ejecuta en un host y/o puerto diferente, consulta la documentación de mongosh.
Para ayudarle a empezar a usar MongoDB, MongoDB provee Guías para comenzar para varias ediciones de controladores. Para la documentación del controlador, consulte Comience a desarrollar con MongoDB.
Inicia MongoDB.
Emite el siguiente comando para iniciar mongod:
sudo service mongod start
Verifica que MongoDB haya iniciado correctamente
Verifica que el proceso mongod haya comenzado correctamente:
sudo service mongod status
También puedes consultar la entrada de registro para conocer el estado actual del proceso mongod, ubicado en: /var/log/mongodb/mongod.log por defecto. Una instancia en ejecución de mongod indicará que está lista para conexiones con la siguiente línea:
[initandlisten] waiting for connections on port 27017
Detenga MongoDB.
Según sea necesario, puedes detener el proceso mongod ejecutando el siguiente comando:
sudo service mongod stop
Reinicia MongoDB.
Emite el siguiente comando para reiniciar mongod:
sudo service mongod restart
Comienza a utilizar MongoDB.
Inicia una sesiónmongosh en la misma máquina host que el mongod. Puedes ejecutar mongosh sin opciones de línea de comandos para conectarse a un mongod que se ejecuta en su localhost con el puerto por defecto 27017.
mongosh
Para obtener más información sobre cómo conectarse usando mongosh, por ejemplo, para conectarse a una instancia mongod que se ejecuta en un host y/o puerto diferente, consulta la documentación de mongosh.
Para ayudarle a empezar a usar MongoDB, MongoDB provee Guías para comenzar para varias ediciones de controladores. Para la documentación del controlador, consulte Comience a desarrollar con MongoDB.
Desinstale MongoDB
Para remover completamente MongoDB de un sistema, debe remover las aplicaciones de MongoDB, los archivos de configuración y cualquier directorio que contenga datos y registros. La siguiente sección le presenta una guía a través de los pasos necesarios.
Advertencia
Este proceso completamente removerá MongoDB, su configuración y todas las bases de datos. Este proceso no es reversible, así que asegúrese de que toda su configuración y datos estén respaldados antes de continuar.
Detenga MongoDB.
Detenga el proceso de mongod emitiendo el siguiente comando:
sudo service mongod stop
Información Adicional
Actualización de MongoDB Enterprise Edition
Al actualizar MongoDB Enterprise Edition, asegúrese de usar los paquetes oficiales. Especifique la misma versión para cada componente, como en este ejemplo:
VERSION=${VERSION} sudo apt-get install -y \ mongodb-enterprise=${VERSION} \ mongodb-enterprise-server=${VERSION} \ mongodb-enterprise-mongos=${VERSION} \ mongodb-enterprise-tools=${VERSION} \ --allow-downgrades --allow-change-held-packages
Vinculación a localhost por defecto
Por defecto, MongoDB se inicia con bindIp establecido en 127.0.0.1, que se vincula a la interfaz de red localhost. Esto significa que mongod solo puede aceptar conexiones de clientes que se ejecutan en el mismo equipo. Los clientes remotos no podrán conectarse a mongod, y mongod no podrá inicializar un set de réplicas a menos que este valor se establezca en una interfaz de red válida.
Este valor se puede configurar:
en el archivo de configuración de MongoDB con
bindIp, omediante el argumento de la línea de comandos
--bind_ip
Advertencia
Antes de vincular la instancia a una dirección IP de acceso público, se debe asegurar el clúster contra accesos no autorizados. Para obtener una lista completa de recomendaciones de seguridad, se debe consultar Checklist de seguridad para implementaciones autogestionadas. Como mínimo, se debe considerar habilitar la autenticación y reforzar la infraestructura de red.
Para obtener más información sobre cómo configurar bindIp, consulta Vinculación de IP en Implementaciones Autogestionadas.
Paquetes de MongoDB Enterprise Edition
MongoDB Enterprise Edition está disponible en su propio repositorio dedicado, y contiene los siguientes paquetes oficialmente soportados:
Nombre del paquete | Descripción | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| Un | ||||||||
| Un
| ||||||||
| Contiene el MongoDB Shell ( | ||||||||
| Contiene el MongoDB Shell que utiliza la versión de OpenSSL ya instalada en su ordenador ( | ||||||||
| Un
|