Cambiado en la versión 5.0.
db.shutdownServer()Apaga el proceso actual
mongodomongosde manera limpia y segura. Debe emitir la operacióndb.shutdownServer()en la base de datos admin.db.shutdownServer()tiene esta sintaxis:db.shutdownServer({ force: <boolean>, timeoutSecs: <int> }) El método toma estos campos:
CampoDescripciónopcional. Especifique
truepara forzar lamongodo lamongospara que se apague. El apagado forzoso interrumpe cualquier operación en curso en elmongodo elmongosy puede resultar en un comportamiento inesperado.Puedes pausar y reanudar la creación de índices en curso con
force. Consultedb.shutdownServer()en los nodos del set de réplicas para obtener más información.Opcional.
A partir de MongoDB 5.0,
mongodymongosentran en un período de inactividad para permitir que se completen las operaciones de base de datos en curso antes de apagarse.Si un
mongodprimario recibe una solicitud de apagado, el primario:Intentos de pasar a un secundario.
Si el paso hacia abajo falla y un/una:
Se ejecutó el comando
shutdownodb.shutdownServer(),mongodsolo continúa con los pasos de apagado si el campo forzar es verdadero, o una
Entra en el periodo de "quiesce".
Finaliza cualquier operación de base de datos restante.
Se apaga.
Para una
mongodsolicitud de apagado secundaria omongos, se entra en el período de inactividad después de solicitar el apagado.El periodo de parada se especifica por:
timeoutSecs campo si se ejecutó un
shutdowncomando o undb.shutdownServer(), oshutdownTimeoutMillisForSignaledShutdownparámetro del servidor si se envió una señal deSIGTERMamongod, omongosShutdownTimeoutMillisForSignaledShutdownparámetro de servidor si se envió una señal deSIGTERMamongos.
Los clientes no pueden abrir nuevas conexiones a un
mongodo a unmongosque se está apagando.timeoutSecs especifica un periodo de tiempo en segundos. El valor por defecto es:
15 segundos a partir de MongoDB 5.0.
10 segundos en las versiones de MongoDB anteriores a la 5.0.
mongodusa timeoutSecs de la siguiente manera:Si el nodo actual es el nodo primario de un set de réplicas,
mongodespera un periodo de hasta el número de segundos especificados por el campo timeoutSecs para que un nodo elegible se ponga al día antes de renunciar al nodo primario. Para obtener detalles sobre el tiempo de puesta al día, consulta atraso de la replicación.Si el nodo actual está en el estado
SECONDARYdespués de dejar de ser primario, cualquier tiempo restante especificado en timeoutSecs se usa para un periodo de inactividad, lo que permite que se completen las operaciones existentes. Las nuevas operaciones se envían a otros nodos del set de réplicas.
A partir de MongoDB 5.0,
mongosutiliza timeoutSecs como un período de inactividad, lo que permite que se completen las operaciones existentes. Las nuevas operaciones se envían a otrosmongosnodos. En versiones de MongoDB anteriores a 5.0,mongosse apaga inmediatamente y no utiliza timeoutSecs.
Esta operación ofrece un contenedor alrededor del comando shutdown.
Compatibilidad
Este método está disponible en implementaciones alojadas en los siguientes entornos:
Importante
Este comando no es compatible con los clústeres de MongoDB Atlas. Para obtener información sobre el soporte de Atlas para todos los comandos, consulta Comandos no compatibles.
MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.
Comportamiento
Para una mongod iniciada con Autenticación en implementaciones autogestionadas, debe ejecutar db.shutdownServer() a través de una conexión autenticada. Consulta Control de acceso para obtener más información.
Para una mongod iniciada sin autenticación en implementaciones autogestionadas, debe ejecutar db.shutdownServer() desde un cliente conectado a la interfaz localhost. Por ejemplo, ejecute mongosh con la opción --host "127.0.0.1" en el mismo host que mongod.
db.shutdownServer() en los miembros del set de réplicas
db.shutdownServer() falla si el nodo del set de réplicas mongod está ejecutando ciertas operaciones, como la creación de índices. Puedes especificar force: true para guardar el progreso de la creación de índices en el disco. El mongod recupera la creación de índices cuando se reinicia y continúa desde el punto de control guardado.
Apagando el set de réplicas primario, secundario o mongos
A partir de MongoDB 5.0, mongod y mongos entran en un período de inactividad para permitir que se completen las operaciones de base de datos en curso antes de apagarse.
Si un mongod primario recibe una solicitud de apagado, el primario:
Intentos de pasar a un secundario.
Si el paso hacia abajo falla y un/una:
Se ejecutó el comando
shutdownodb.shutdownServer(),mongodsolo continúa con los pasos de apagado si el campo forzar es verdadero, o una
Entra en el periodo de "quiesce".
Finaliza cualquier operación de base de datos restante.
Se apaga.
Para una mongod solicitud de apagado secundaria o mongos, se entra en el período de inactividad después de solicitar el apagado.
El periodo de parada se especifica por:
timeoutSecs campo si se ejecutó un
shutdowncomando o undb.shutdownServer(), oshutdownTimeoutMillisForSignaledShutdownparámetro del servidor si se envió una señal deSIGTERMamongod, omongosShutdownTimeoutMillisForSignaledShutdownparámetro de servidor si se envió una señal deSIGTERMamongos.
Los clientes no pueden abrir nuevas conexiones a un mongod o a un mongos que se está apagando.
timeoutSecs especifica un periodo de tiempo en segundos. El valor por defecto es:
15 segundos a partir de MongoDB 5.0.
10 segundos en las versiones de MongoDB anteriores a la 5.0.
mongod usa timeoutSecs de la siguiente manera:
Si el nodo actual es el nodo primario de un set de réplicas,
mongodespera un periodo de hasta el número de segundos especificados por el campo timeoutSecs para que un nodo elegible se ponga al día antes de renunciar al nodo primario. Para obtener detalles sobre el tiempo de puesta al día, consulta atraso de la replicación.Si el nodo actual está en el estado
SECONDARYdespués de dejar de ser primario, cualquier tiempo restante especificado en timeoutSecs se usa para un periodo de inactividad, lo que permite que se completen las operaciones existentes. Las nuevas operaciones se envían a otros nodos del set de réplicas.
A partir de MongoDB 5.0, mongos utiliza timeoutSecs como un período de inactividad, lo que permite que se completen las operaciones existentes. Las nuevas operaciones se envían a otros mongos nodos. En versiones de MongoDB anteriores a 5.0, mongos se apaga inmediatamente y no utiliza timeoutSecs.
Advertencia
El cierre forzado del primario puede provocar el rollback de cualquier escritura que aún no se haya replicado en un secundario.
Control de acceso
Para ejecutar db.shutdownServer() en un mongod que aplica la autenticación en implementaciones autogestionadas, el usuario autenticado debe tener el privilegio db.shutdownServer(). Por ejemplo, un usuario con el rol de funcionalidad incorporada hostManager tiene los permisos correspondientes.
Ejemplos
Apagar un mongod
db.getSiblingDB("admin").shutdownServer()
Forzar el apagado de mongod
db.getSiblingDB("admin").shutdownServer({ "force" : true })
Apagar un Primario mongod con tiempo de espera más largo
db.getSiblingDB("admin").shutdownServer({ "timeoutSecs": 60 })