Overview
Utiliza este tutorial para instalar MongoDB 9.0 Enterprise Edition en Red Hat Enterprise Linux, CentOS Linux o Oracle Linux [1] usando el gestor de paquetes YUM.
MongoDB Enterprise Edition está disponible en plataformas seleccionadas y contiene soporte para características relacionadas con seguridad y supervisión.
Versión de MongoDB
Este tutorial instala MongoDB 9.0 Edición para empresas. Para instalar una versión diferente de MongoDB Enterprise, utilice el menú desplegable de la versión en la barra lateral y seleccione la documentación para esa versión.
Considerations
Soporte de plataforma
MongoDB 9.0 La edición Enterprise ofrece soporte para las siguientes versiones de 64-bit de Red Hat Enterprise Linux (RHEL), CentOS Linux, Oracle Linux [1], Rocky Linux y AlmaLinux [2] en la arquitectura x86_64:
RHEL / CentOS Stream / Oracle / Rocky / AlmaLinux 10
RHEL / CentOS Stream / Oracle / Rocky / AlmaLinux 9
RHEL / CentOS Stream / Oracle / Rocky / AlmaLinux 8
MongoDB solo soporta las versiones de 64 bits de estas plataformas.
MongoDB 9.0 Enterprise Edition en RHEL / CentOS / Oracle / Rocky / Alma Linux también admite la arquitectura ARM64 en plataformas seleccionadas.
Consulte Soporte de plataforma para obtener más información.
| [1] | (1, 2) MongoDB solo es compatible con Oracle Linux que ejecuta Red Hat Compatible Kernel (RHCK). MongoDB no es compatible con el Unbreakable Enterprise Kernel (UEK). |
| [2] | Los productos on-premises de MongoDB lanzados para la versión 8.0+ de RHEL son compatibles y están soportados en Rocky Linux versión 8.0+ y AlmaLinux versión 8.0+, siempre que esas distribuciones cumplan con su obligación de ofrecer compatibilidad total con RHEL. |
Notas de producción
Antes de implementar MongoDB en un entorno de producción, consulta el documento Notas de producción para implementaciones autogestionadas para obtener consideraciones de rendimiento y recomendaciones de configuración.
Instale MongoDB Enterprise Edition
Sigue estos pasos para instalar MongoDB Enterprise Edition usando el gestor de paquetes YUM.
Configura el repositorio.
Cree un archivo /etc/yum.repos.d/mongodb-enterprise-9.0.repo para que pueda instalar MongoDB Enterprise directamente usando yum:
[mongodb-enterprise-9.0]name=MongoDB Enterprise Repositorybaseurl=https://repo.mongodb.com/yum/redhat/10/mongodb-enterprise/9.0/$basearch/gpgcheck=1enabled=1gpgkey=https://pgp.mongodb.com/server-9.asc[mongodb-enterprise-9.0]name=MongoDB Enterprise Repositorybaseurl=https://repo.mongodb.com/yum/redhat/9/mongodb-enterprise/9.0/$basearch/gpgcheck=1enabled=1gpgkey=https://pgp.mongodb.com/server-9.asc[mongodb-enterprise-9.0]name=MongoDB Enterprise Repositorybaseurl=https://repo.mongodb.com/yum/redhat/8/mongodb-enterprise/9.0/$basearch/gpgcheck=1enabled=1gpgkey=https://pgp.mongodb.com/server-9.ascNota
Si tienes un archivo mongodb-enterprise.repo en este directorio de una instalación anterior de MongoDB, debes removerlo. Utiliza el archivo mongodb-enterprise-9.0.repo de arriba para instalar MongoDB 9.0.
También se pueden descargar los archivos de .rpm directamente del repositorio de MongoDB. Las descargas están organizadas por versión de Red Hat / CentOS (por ejemplo, 9), luego la versión de lanzamiento de MongoDB (p. ej., 9.0), luego arquitectura (p. ej., x86_64).
Instala MongoDB Enterprise servidor.
Para instalar la última versión estable de MongoDB Enterprise 9.0, emita el siguiente comando:
sudo yum install -y mongodb-enterprisePara 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 yum install -y mongodb-enterprise-9.0.4 mongodb-enterprise-database-9.0.4 mongodb-enterprise-server-9.0.4 mongodb-mongosh mongodb-enterprise-mongos-9.0.4 mongodb-enterprise-tools-9.0.4Nota
Aunque se puede especificar cualquier versión disponible de MongoDB Enterprise, yum actualiza los paquetes cuando hay una versión más nueva disponible. Para evitar actualizaciones no deseadas, fijar el paquete añadiendo la siguiente directiva de exclude a su archivo de /etc/yum.conf:
exclude=mongodb-enterprise,mongodb-enterprise-database,mongodb-enterprise-server,mongodb-enterprise-shell,mongodb-enterprise-mongos,mongodb-enterprise-toolsNota
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 yum install -y mongodb-enterprise mongodb-mongosh-shared-openssl11El siguiente ejemplo remueve el MongoDB Shell y luego instala el MongoDB Shell que utiliza el OpenSSL 1.1 del sistema:
sudo yum remove -y mongodb-mongosh && sudo yum install -ymongodb-mongosh-shared-openssl11El siguiente ejemplo remueve el MongoDB Shell y luego instala el MongoDB Shell que utiliza el OpenSSL 3 del sistema:
sudo yum remove -y mongodb-mongosh && sudo yum install -ymongodb-mongosh-shared-openssl3Si MongoDB Shell no se inicia con el siguiente error, instale el paquete mongodb-mongosh-shared-openssl3 mediante los comandos anteriores:
mongosh: OpenSSL configuration error: ...:error:030000A9:digitalenvelope routines:alg_module_init:unknownoption:../deps/openssl/openssl/crypto/evp/evp_cnf.c:61:name=rh-allow-sha1-signatures,value=yesEl error afecta a RHEL 9+ y a sus derivados, como Amazon Linux 2023.
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 yum install -y mongodb-enterprise-databasemongodb-enterprise-tools mongodb-mongosh-shared-openssl11En el siguiente ejemplo se instalan MongoDB Enterprise y las herramientas, así como el MongoDB Shell que utiliza OpenSSL 3 del sistema:
sudo yum install -y mongodb-enterprise-databasemongodb-enterprise-tools mongodb-mongosh-shared-openssl3Ejecute MongoDB Enterprise Edition
ulimit
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.
Rutas de directorio
Para usar directorios por defecto
Por defecto, MongoDB se ejecuta utilizando la cuenta de usuario mongod y emplea los siguientes directorios por defecto:
/var/lib/mongo(el directorio de datos)/var/log/mongodb(el directorio de registros)
El administrador de paquetes crea los directorios por defecto durante la instalación. El propietario y el nombre del grupo son mongod.
Para usar directorios no por defecto
Para utilizar un directorio de datos o un directorio de registros diferentes a los directorios por defecto:
Cree el nuevo directorio o directorios.
Edite el archivo de configuración
/etc/mongod.confy modifique los siguientes campos en consecuencia:storage.dbPathpara especificar una nueva ruta de directorio de datos, como/some/data/directorysystemLog.pathpara especificar una nueva ruta de entrada de registro, como/some/log/directory/mongod.log
Asegúrese de que el usuario que ejecuta MongoDB tenga acceso al directorio o a los directorios:
sudo chown -R mongod:mongod <directory>Si cambia el usuario que ejecuta el proceso de MongoDB, debe conceder al nuevo usuario acceso a estos directorios.
Configura SELinux si está en modo enforce. Consulta Configurar la política de SELinux de MongoDB.
Procedimiento
Se deben seguir estos pasos para ejecutar MongoDB Enterprise Edition en el sistema. Estas instrucciones asumen que se está utilizando la configuración por defecto.
Sistema de inicialización
Para ejecutar y gestionar su proceso mongod, utilice el sistema de inicialización integrado de su sistema operativo. Las versiones más recientes de Linux usan systemd, que utiliza el comando systemctl, mientras que las versiones más antiguas de Linux usan 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 1Luego, 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 mongodSi 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-reloadLuego ejecuta de nuevo el comando de inicio mencionado arriba.
Verifica que MongoDB se haya iniciado correctamente.
Puedes verificar que el proceso mongod ha comenzado correctamente emitiendo el siguiente comando:
sudo systemctl status mongodPuedes asegurarte opcionalmente de que MongoDB se inicie después de un reinicio del sistema emitiendo el siguiente comando:
sudo systemctl enable mongodDetenga MongoDB.
Según sea necesario, puedes detener el proceso mongod ejecutando el siguiente comando:
sudo systemctl stop mongodReinicia MongoDB.
Puedes reiniciar el proceso mongod emitiendo el siguiente comando:
sudo systemctl restart mongodPuedes 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.
mongoshPara 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.
Puedes iniciar el proceso mongod emitiendo el siguiente comando:
sudo service mongod startVerifica que MongoDB haya iniciado correctamente
Puedes verificar que el proceso mongod se ha iniciado correctamente comprobando el contenido de la entrada de registro en /var/log/mongodb/mongod.log para una lectura de línea
[initandlisten] waiting for connections on port <port>donde <port> es el puerto configurado en /etc/mongod.conf, 27017 por defecto.
Puedes asegurarte opcionalmente de que MongoDB se inicie después de un reinicio del sistema emitiendo el siguiente comando:
sudo chkconfig mongod onDetenga MongoDB.
Según sea necesario, puedes detener el proceso mongod ejecutando el siguiente comando:
sudo service mongod stopReinicia MongoDB.
Puedes reiniciar el proceso mongod emitiendo el siguiente comando:
sudo service mongod restartPuedes 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.
mongoshPara 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.
Información Adicional
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 la instancia mongod solo acepta conexiones de clientes que se ejecutan en la misma máquina. Para permitir que los clientes remotos accedan a la instancia mongod o para inicializar un set de réplicas en la instancia, debe vincular mongod a una interfaz de red accesible públicamente.
Para vincular la interfaz de red, utilice el ajuste bindIp en el archivo de configuración o inicie mongod con la opción de 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
|