Restauración de un clúster autogestionado

Restaure los archivos de datos primarios del CSRS mongod.

Selecciona la pestaña que corresponda a tu método de copia de seguridad preferido:

Elimina la base de datos local.

Utilice db.dropDatabase() para descartar la base de datos local:

use local
db.dropDatabase()

Inserte la lista filtrada de archivos en la base de datos local.

Este paso solo es necesario si estás restaurando desde una instantánea filtrada por namespace.

Para cada partición, localice la lista de archivos filtrados con el siguiente formato de nombre: <shardRsID>-filteredFileList.txt. Este archivo contiene una lista de objetos JSON con el siguiente formato:

{
   "filename":"file1",
   "ns":"sampleDb1.sampleCollection1",
   "uuid": "3b241101-e2bb-4255-8caf-4136c566a962"
}

Agrega cada objeto JSON de cada archivo de partición a una nueva colección db.systems.collections_to_restore en tu base de datos local. Puede ignorar las entradas con campos vacíos ns o uuid. Al insertar entradas, el campo uuid debe ser insertado como tipo UUID().

Ejecuta el comando de restauración de archivos filtrados.

Este paso solo es necesario si estás restaurando desde una instantánea filtrada por namespace.

Después de insertar todas las entradas, ejecuta los siguientes comandos:

use admin
db.runCommand({"_configsvrRunRestore":1})

Para cualquier cambio planificado o completado de nombre de host de partición o nombre del set de réplicas, actualizar los metadatos en config.shards.

Puedes omitir este paso si todas las siguientes afirmaciones son verdaderas:

• Ningún hostname de máquina host de nodo de partición ha cambiado ni cambiará durante este procedimiento.

• Ningún nombre de set de réplicas de partición ha cambiado o cambiará durante este procedimiento.

Emite el siguiente método find() en la colección shards en la base de datos de configuración. Reemplace <shardName> con el nombre de la partición. Por defecto, el nombre de la partición es el nombre de su conjunto de réplicas. Si añadiste la partición usando el comando addShard y especificaste un name personalizado, debes especificar esa name en <shardName>.

use config
db.shards.find( { "_id" : "<shardName>" } )

Esta operación devuelve un documento que se asemeja al siguiente:

{
   "_id" : "shard1",
   "host" : "myShardName/alpha.example.net:27018,beta.example.net:27018,charlie.example.net:27018",
   "state" : 1
}

Utilice el método updateOne() para actualizar la cadena hosts y reflejar el nombre del set de réplicas previsto y la lista de nombres de host para la partición. Por ejemplo, la siguiente operación actualiza la cadena de conexión host para la partición con "_id" : "shard1":

db.shards.updateOne(
  { "_id" : "shard1" },
  { $set : { "host" : "myNewShardName/repl1.example.net:27018,repl2.example.net:27018,repl3.example.net:27018" } }
)

Repita este proceso hasta que todos los metadatos de partición reflejen con precisión el nombre previsto del set de réplicas y la lista de hostnames para cada partición en el clúster.

use config
db.shards.find({})

Reinicie el mongod como un nuevo set de réplicas de un solo nodo.

Apaga el mongod. Descomente o agregue las siguientes opciones del archivo de configuración:

replication:
  replSetName: myNewCSRSName
sharding:
  clusterRole: configsvr

Si desea cambiar el nombre del set de réplicas, debe actualizar el campo replSetName con el nuevo nombre antes de proceder.

Inicia el mongod con el archivo de configuración actualizado:

mongod --config /path/to/mongodb/mongod.conf

Si tienes mongod configurado para ejecutarse como un servicio del sistema, inícialo usando el proceso recomendado para el administrador de servicios del sistema.

Después de que mongod inicie, conéctate a él usando el shell mongo.

Iniciar el nuevo set de réplicas.

Inicia el set de réplicas usando rs.initiate() con la configuración por defecto.

rs.initiate()

Una vez que la operación se complete, utilice rs.status() para comprobar que el nodo se convirtió en el primario.

Añadir miembros adicionales al set de réplicas.

Para cada miembro del conjunto de réplicas en el CSRS, inicia el mongod en su máquina host. Una vez que hayas puesto en marcha con éxito todos los nodos restantes del clúster, conecta un shell mongo al nodo primario del set de réplicas. Desde el primario, utilice el método rs.add() para añadir cada nodo del set de réplicas. Incluye el nombre del conjunto de réplicas como prefijo, seguido del hostname y puerto del mongod de los nodos:

rs.add("config2.example.net:27019")
rs.add("config3.example.net:27019")

Si desea agregar el nodo con una configuración específica de la réplica member, puede pasar un documento a rs.add() que defina el nombre de host del nodo y la configuración de members que requiera su implementación.

rs.add(
 {
   "host" : "config2.example.net:27019",
   priority: <int>,
   votes: <int>,
   tags: <int>
 }
)

Cada nuevo nodo realiza una sincronización inicial para ponerse al día con el primario. Dependiendo de factores como la cantidad de datos a sincronizar, la topología y salud de la red, y la potencia de cada máquina host, la sincronización inicial puede requerir un período prolongado de tiempo para completarse.

El set de réplicas puede elegir un nuevo primario mientras agregas nodos adicionales. Utiliza rs.status() para identificar qué nodo es el primario actual. Solo puedes ejecutar rs.add() desde la primaria.

Configura los ajustes adicionales necesarios para la replicación.

El método rs.reconfig() actualiza la configuración del set de réplicas basándose en un documento de configuración que se pasa como parámetro. Debe ejecutar reconfig() contra el miembro primario del set de réplicas.

Consulta la salida del archivo de configuración original del set de réplicas como se identificó en el paso A. Review Replica Set Configurations y aplica la configuración según sea necesario.

Restaurar los archivos de datos de la partición primaria mongod.

Selecciona la pestaña que corresponda a tu método de copia de seguridad preferido:

Crea un usuario temporal con el __system rol.

Durante este procedimiento, modificará documentos en la colección admin.system.version. Para los clústeres que hacen cumplir la autenticación, solo el rol __system otorga permiso para modificar esta colección. Puede omitir este paso si el clúster no aplica autenticación.

1. Autenticar como usuario con el rol userAdmin en la base de datos admin o el userAdminAnyDatabase rol:

   use admin
   db.auth("myUserAdmin","mySecurePassword")

2. Crea un usuario con el rol __system:

   db.createUser(
     {
       user: "mySystemUser",
       pwd: "<replaceMeWithAStrongPassword>",
       roles: [ "__system" ]
     }
   )

   Las contraseñas deben ser aleatorias, largas y complejas para garantizar la seguridad del sistema y para prevenir o retrasar el acceso malicioso.

3. Autentícate como el usuario privilegiado:

   db.auth("mySystemUser","<replaceMeWithAStrongPassword>")

Elimina la base de datos local.

Utilice db.dropDatabase() para descartar la base de datos local:

use local
db.dropDatabase()

Remover el documento minOpTimeRecovery de la colección admin.system.versions.

Para actualizar los elementos internos del particionado, emite el siguiente método deleteOne() en la colección system.version de la base de datos admin:

use admin
db.system.version.deleteOne( { _id: "minOpTimeRecovery" } )

Opcional: Para cualquier cambio en el hostname CSRS o en el nombre del set de réplicas, actualiza los metadatos de partición en el documento de identidad de cada partición.

Puedes omitir este paso si todas las siguientes afirmaciones son verdaderas:

• Los nombres de host de cualquier host CSRS no cambiaron durante este procedimiento.

• El nombre del set de réplicas CSRS no cambió durante este procedimiento.

La colección system.version en la base de datos admin contiene metadatos relacionados con la partición, incluido la cadena de conexión CSRS. Si se cambió el nombre o alguno de los nodos de host del CSRS mientras se restauraba el CSRS, debe actualizar esos metadatos.

Emite el siguiente método find() en la colección system.version en la base de datos admin:

use admin
db.system.version.find( {"_id" : "shardIdentity" } )

El método find() devuelve un documento que se asemeja al siguiente:

{
  "_id" : "shardIdentity",
  "clusterId" : ObjectId("2bba123c6eeedcd192b19024"),
  "shardName" : "shard1",
  "configsvrConnectionString" : "myCSRSName/alpha.example.net:27019,beta.example.net:27019,charlie.example.net:27019" }

El siguiente updateOne() método actualiza el documento de modo que el string host representa la cadena de conexión CSRS más actual:

db.system.version.updateOne(
  { "_id" : "shardIdentity" },
  { $set :
    { "configsvrConnectionString" : "myNewCSRSName/config1.example.net:27019,config2.example.net:27019,config3.example.net:27019"}
  }
)

Reinicie el mongod como un nuevo set de réplicas de un solo nodo.

Apaga el mongod. Descomente o agregue las siguientes opciones del archivo de configuración:

replication:
  replSetName: myNewShardName
sharding:
  clusterRole: shardsvr

Si desea cambiar el nombre del set de réplicas, debe actualizar el campo replSetName con el nuevo nombre antes de proceder.

Inicia el mongod con el archivo de configuración actualizado:

mongod --config /path/to/mongodb/mongod.conf

Si tienes mongod configurado para ejecutarse como un servicio del sistema, inícialo usando el proceso recomendado para el administrador de servicios del sistema.

Después de que mongod inicie, conéctate a él usando el shell mongo.

Iniciar el nuevo set de réplicas.

Inicia el set de réplicas usando rs.initiate() con la configuración por defecto.

rs.initiate()

Una vez que la operación se complete, utilice rs.status() para comprobar que el nodo se convirtió en el primario.

Añadir miembros adicionales al set de réplicas.

Para cada miembro del set de réplicas en el set de réplicas de la partición, inicia el mongod en su máquina host. Una vez que haya iniciado con éxito todos los miembros restantes del clúster, conecte un mongo shell al miembro primario del set de réplicas. Desde el primario, utiliza el método rs.add() para añadir cada nodo del set de réplicas. Incluye el nombre del set de réplicas como prefijo, seguido del nombre de host y el puerto del proceso mongod del nodo:

rs.add("repl2.example.net:27018")
rs.add("repl3.example.net:27018")

Si desea agregar el nodo con una configuración específica de la réplica member, puede pasar un documento a rs.add() que defina el nombre de host del nodo y la configuración de members que requiera su implementación.

rs.add(
 {
   "host" : "repl2.example.net:27018",
   priority: <int>,
   votes: <int>,
   tags: <int>
 }
)

Cada nuevo nodo realiza una sincronización inicial para ponerse al día con el primario. Dependiendo de factores como la cantidad de datos a sincronizar, la topología y salud de la red, y la potencia de cada máquina host, la sincronización inicial puede requerir un período prolongado de tiempo para completarse.

El set de réplicas puede elegir un nuevo primario mientras agregas nodos adicionales. Utiliza rs.status() para identificar qué nodo es el primario actual. Solo puedes ejecutar rs.add() desde la primaria.

Configura los ajustes adicionales necesarios para la replicación.

El método rs.reconfig() actualiza la configuración del set de réplicas basándose en un documento de configuración que se pasa como parámetro. Debe ejecutar reconfig() contra el miembro primario del set de réplicas.

Consulta la salida del archivo de configuración original del set de réplicas como se identificó en el paso A. Review Replica Set Configurations y aplica la configuración según sea necesario.

Remueva el usuario temporal con privilegios.

Para los clústeres que aplican la autenticación, se debe remover el usuario privilegiado creado anteriormente en este procedimiento:

1. Autenticar como usuario con el rol userAdmin en la base de datos admin o el userAdminAnyDatabase rol:

   use admin
   db.auth("myUserAdmin","mySecurePassword")

2. Borrar al usuario privilegiado:

   db.removeUser("mySystemUser")