comando nzreplbackup

Utilice el comando nzreplbackup para realizar una copia de seguridad de los datos de replicación necesarios para recuperar o inicializar una réplica. El archivo de recuperación especificado, que genera el comando nzreplanalyze, indica los datos de los que hay que hacer una copia de seguridad. El comando nzreplbackup, junto con los comandos nzreplanalyze y nzreplrestore, forma parte del conjunto de herramientas de recuperación para la replicación. Para ver ejemplos de tareas que requieren el proceso de análisis, copia de seguridad y restauración, consulte Adición de una base de datos existente a un conjunto de replicación y Resincronización de una base de datos replicada.

Sintaxis

Utilice la siguiente sintaxis de comandos nzreplbackup para mostrar las llamadas a comandos nzbackup, que pueden ayudar en la creación de scripts para una copia de seguridad paralela optimizada:

nzreplbackup -simulate [ -verbose ] -recoveryfile <fileName>
{ -rqm | -dir <dirList> | -dirfile <fileName> | -connector <connName>
[ -connectorArgs <list> ] }

Utilice la siguiente sintaxis de comando desde el primario para realizar una copia de seguridad de los datos de replicación necesarios para recuperar o inicializar una réplica utilizando el archivo de recuperación que generó el comando nzreplanalyze :

nzreplbackup -recoveryfile <fileName> { -rqm | -dir <dirList> |
-dirfile <fileName> | -connector <connName>
[ -connectorArgs <list> ] } [ -u <userName> ] [ -pw <password> ]
[ -orderFile <filename> ] [ -parallelism <max_number_dbs> ][ -streams <number> ]
[ -secret <secret> ] [ -verbose ]

Opciones

El comando nzreplbackup toma las siguientes opciones:

-archivo de recuperación <fileName>

Especifica el nombre y la ubicación del archivo de recuperación creado por el comando nzreplanalyze.

-rqm

Utiliza el software RQM (replication queue manager) para transferir tanto el archivo de recuperación nombrado como todos los archivos de copia de seguridad globales y de base de datos identificados que se encuentran en una subcarpeta del directorio /var/nzrepl/nzreplbackup. La subcarpeta se denomina según el ID del nodo de origen y la hora. Compruebe que dispone de espacio suficiente en los servidores de registro primario y de réplica antes de seleccionar esta opción.

-dir <dirList>

Especifica los directorios de destino de la copia de seguridad donde se almacenarán los datos. Introduzca los nombres completos de las rutas de directorio como una lista separada por espacios. El uso de esta opción requiere la transferencia manual de archivos al gestor de colas de replicación.

-archivo <dirFile>

Especifica un archivo con una lista de directorios de destino de copia de seguridad, uno por línea. El uso de esta opción requiere que transfiera manualmente los archivos al servidor de registro de replicación.

-conector <connName>

Indica el conector al que se envía la copia de seguridad. (Para una copia de seguridad del sistema de archivos, utilice la opción -dir o -dirfile ) Las opciones del conector son las mismas que las disponibles para el comando nzbackup. El uso de esta opción requiere la transferencia manual de archivos al gestor de colas de replicación.

-connectorArgs <argList>

Especifica una lista separada por dos puntos de argumentos de paso para el conector. Debe encerrar la cadena de argumentos entre comillas dobles.

-simulate

Devuelve una vista de alto nivel de las acciones que realizaría la misma orden nzreplbackup sin la opción -simulate. Por ejemplo, al utilizar esta opción se enumeran los nombres de las bases de datos de las que se realizaría una copia de seguridad. Para mostrar el detalle necesario para realizar copias de seguridad manuales de las bases de datos, utilice la opción -simulate con la opción -verbose.

El comando comprueba que el método de transferencia es correcto para el destino, de modo que al utilizar el parámetro correcto se obtiene un resultado correcto. Por ejemplo, si el medio de copia de seguridad es una cinta, al utilizar la opción -rqm en lugar de la opción correcta -connector se produce un error.

- -v [erbose]

Informa detalladamente mientras se realiza la copia de seguridad. El uso de esta opción como extensión de la opción -simulate devuelve una lista de las llamadas al comando nzbackup, con la sintaxis, incorporando los objetos de replicación respaldados.

Puede utilizar la visualización producida por las opciones -simulate y -verbose para ejecutar manualmente el comando nzbackup o nzreplbackup en un archivo de script. En NPS® 7.2 o versiones anteriores, es posible que desee hacer esto, por ejemplo, si el número de bases de datos de las que hay que hacer una copia de seguridad pudiera causar una tensión excesiva en el sistema host. (En NPS 7.2 o posterior, aunque el método manual sigue funcionando, puede utilizar la funcionalidad de recuperación mejorada para realizar copias de seguridad de un subconjunto de bases de datos, minimizando así las operaciones de copia de seguridad paralelas y aliviando la necesidad de scripts) Si utiliza un archivo de script, deberá activar manualmente el primario cuando cada copia de seguridad llegue al punto necesario de su ejecución.

-u <username>

Especifica el nombre de usuario de Netezza® para conectarse a la base de datos. Si no especifica la opción -u , se utiliza el valor de la variable de entorno NZ_ USER, si está establecida. Si no especifica la opción -u y la variable NZ_USER no está establecida, el sistema informa de un error.

-pw <password>

Especifica la contraseña de usuario para la base de datos. Si no especifica la opción -pw, se utilizará el valor de la variable de entorno NZ_PASSWORD. Si no se dispone de una contraseña válida, se genera un error.

-orderFile <filename>

Especifica un archivo de orden que contiene los nombres de las bases de datos de las que se realizará una copia de seguridad en paralelo según el valor de la opción -parallelism. El orden de los nombres de las bases de datos en el archivo determina qué bases de datos se agrupan para la copia de seguridad paralela. Puede ordenar las bases de datos según las que tengan sesiones activas en ese momento u ordenarlas por tamaño. No incluya la base de datos globals en el archivo: esta base de datos siempre se copia primero y por sí sola.

Si una base de datos de usuario está marcada como que requiere copia de seguridad en el archivo de recuperación que genera el comando nzreplanalyze, debe incluir esa base de datos en el archivo de la orden. Especifique una base de datos por línea. Los nombres del archivo distinguen entre mayúsculas y minúsculas.

La opción -orderFile es opcional, pero si la especifica, debe especificar también la opción -parallelism.

-paralelismo <max_number_dbs>

Especifica un valor entero que representa el número máximo de bases de datos de las que hacer copia de seguridad en paralelo. Especificar esta opción ayuda a evitar el uso excesivo de los recursos del sistema Netezza. Los nombres de las bases de datos y su secuencia en el archivo de orden que especifique para la opción -orderFile determinan qué bases de datos se copian en paralelo.

Por ejemplo, suponga que especifica ocho nombres de bases de datos en el archivo de pedido para la opción -orderFile y especifica 3 para la opción -parallelism. La base de datos globals, que no se incluye en el archivo de pedido, se copia primero y por sí sola. A continuación, se realiza una copia de seguridad paralela de las tres primeras bases de datos del archivo de pedidos, seguida de las tres bases de datos siguientes del archivo y de las dos últimas bases de datos del archivo.

La opción -parallelism es opcional, pero si la especifica, debe especificar también la opción -orderFile.

-arroyos <number>

Realiza una copia de seguridad de los datos utilizando el número de secuencias especificado. El número máximo de secuencias es 16. Por defecto, el sistema realiza la restauración con el mismo número de flujos que se utilizaron para la copia de seguridad.

-secreto <secret>

Especifica un valor de cadena necesario para generar una clave simétrica de 256 bits, que se utiliza para cifrar la clave del host en los datos de la copia de seguridad. Debe utilizar el mismo secreto con el comando nzreplrestore para acceder a los datos de la copia de seguridad. Si no se utiliza un secreto para cifrar la clave del host, los datos se cifran con una clave estática.

Uso

El proceso de copia de seguridad realiza una copia de seguridad de cada base de datos marcada por el comando nzreplanalyze. El proceso realiza la copia de seguridad de todas las bases de datos en paralelo, a menos que se especifique el número de bases de datos de las que realizar la copia de seguridad en paralelo mediante la opción -parallelism. Cuando ejecutas el comando nzreplbackup, el comando pone el primario en un estado suspendido (un primario suspendido no acepta transacciones de escritura replicadas). El primario permanece suspendido hasta que cada copia de seguridad ha alcanzado el punto necesario en su ejecución. Este punto se indica mediante un mensaje en la salida del comando que indica que la base de datos cumple los requisitos de activación de nodos. Cuando todas las bases de datos cumplen los requisitos de activación, el comando restaura automáticamente el primario a un estado de replicación activo e informa del cambio de estado en la salida. La salida del comando contiene entonces la sintaxis para restaurar los datos en la réplica utilizando el comando nzreplrestore.

Importante: Dado que , por defecto, todas las bases de datos de un conjunto de replicación se copian en paralelo, las operaciones de copia de seguridad pueden afectar negativamente al procesamiento de lectura/escritura en el sistema Netezza. En una instancia de NPS con mucho tráfico, tenga cuidado de no sobrecargar los recursos del primario cuando envíe solicitudes de copia de seguridad simultáneas para bases de datos grandes o con un gran número de bases de datos. El número real depende del sistema y de los recursos disponibles. Puede utilizar las opciones -parallelism y -orderFile para identificar cuántas bases de datos se deben respaldar en paralelo y el orden en que se agrupan las bases de datos para el respaldo en paralelo.

El comando nzreplbackup llama al comando estándar nzbackup, utilizando el archivo de recuperación generado para su ejecución. Si está ejecutando una versión anterior a la 7.2, puede utilizar la opción -simulate verbose para mostrar los pasos de la llamada al comando nzbackup. Si su conjunto de replicación contiene más bases de datos de las que su sistema puede procesar sin una penalización inaceptable, utilice la salida de la opción -simulate verbose para crear un archivo de script para la copia de seguridad.

Al ejecutar el comando, se especifica la ubicación de los archivos de copia de seguridad, que dicta un método de transferencia. Por ejemplo, la opción -rqm especifica el directorio de replicación en el gestor de colas de replicación, una subcarpeta del directorio /var/nzrepl/nzreplbackup, como la estructura de carpetas que se utilizará para las copias de seguridad. A continuación, el software RQM transfiere los archivos de recuperación y los archivos de copia de seguridad que encuentra en ese directorio a cada gestor de colas de replicación, incluso si ha especificado la opción -sub. La opción -rqm puede proporcionar el rendimiento óptimo de transferencia con respecto al ancho de banda, la CPU y el espacio de la base de datos, si todos los nodos del conjunto necesitan los archivos. Cuando se utiliza la opción -dir o -dirfile, se especifica (en la línea de comandos o en un archivo) una o varias ubicaciones locales para los archivos de copia de seguridad. A continuación, deberá transferir manualmente los archivos del primario a las réplicas. Utiliza la opción de transferencia manual si, por ejemplo, la copia de seguridad es demasiado grande para almacenarla en el servidor de registro o no tienes ancho de banda para realizar la transferencia. Alternativamente, puede especificar que desea enviar la copia de seguridad a un conector con nombre. Por defecto, el conector es el sistema de archivos.

Consejo: El comando nzreplprunerqm elimina los archivos de registro de replicación que cumplan los requisitos, pero no las copias de seguridad. Debe eliminar manualmente estos conjuntos de copias de seguridad para preservar el espacio en disco del administrador de colas de replicación. Es decir, cuando finalice la restauración, elimine o cambie el nombre y mueva el contenido del directorio /var/nzrepl/nzreplbackup (si ha utilizado la opción -rqm ) o el directorio de copia de seguridad fuera del servidor de registro.

Los archivos de copia de seguridad (archivos que genera el comando nzbackup o nzreplbackup ) se replican además de cualquier archivo de registro de replicación (archivos de repetición de transacciones). Al igual que ocurre con los archivos de registro, los archivos de copia de seguridad se procesan en un orden determinado por un algoritmo que tiene en cuenta tanto el tamaño como los tiempos de modificación. El programa aplica la regla de transferencia de "pequeños y grandes". En primer lugar, replica todos los archivos que tengan un tamaño inferior a 48 KB (archivos de copia de seguridad y de registro juntos). A continuación, copia en la réplica los archivos de carga replicados de mayor tamaño y los archivos de copia de seguridad de mayor tamaño según la prioridad de la marca de tiempo de modificación, primero los más antiguos. Este método utiliza recursos de red, lo que puede aumentar la latencia de la réplica.

La copia de seguridad de bases de datos mediante el comando nzreplbackup requiere permisos para realizar copias de seguridad de datos globales además de las bases de datos del conjunto de replicación. Por defecto, sólo el usuario admin tiene estos permisos. Como usuario administrador, puede permitir que otro usuario ejecute el comando nzreplbackup concediéndole los privilegios necesarios mediante el comando GRANT BACKUP IN ALL.ALL. Este comando da acceso a todas las bases de datos. Si el usuario no debe tener un acceso tan amplio, elimine ("ungrant") los privilegios para cada base de datos específica no replicada de la que deba bloquearse al usuario.

Ejemplos

Para ver un ejemplo completo de copia de seguridad y restauración de la replicación, consulte Ejemplos en el tema del comando nzreplanalyze.

El siguiente ejemplo utiliza la opción -rqm para realizar una copia de seguridad de los datos de replicación en el gestor de colas de replicación. El comando devuelve el mensajedatabase now meets replication node activation requirementspara cada base de datos de la que se está realizando una copia de seguridad y, a continuación, activa la primaria, si estaba suspendida.

[nz@PTS100]$ nzreplbackup -recoveryfile /tmp/my_recoveryfile.xml -rqm
Starting backup: -globals
Starting backup: -db replset
Starting backup: -db cust_data
This database now meets replication node activation requirements.
This database now meets replication node activation requirements.
This database now meets replication node activation requirements.
Backup of global objects completed successfully.
Backup of global objects was moved to /var/nzrepl/nzreplbackup/6988/
1398097573/0.
database global objects now meets replication node activation
requirements.
Backup of database replset to backupset 20140421162614 completed
successfully.
Backup of database replset was moved to /var/nzrepl/nzreplbackup/
6988/1398097573/457965569.
database replset now meets replication node activation requirements.
Backup of database cust_data to backupset 20140421162615 completed
successfully.
Backup of database cust_data was moved to /var/nzrepl/nzreplbackup/
6988/1398097573/457965570.
Activating RS1.G1 completed successfully.
The recovery file was moved to /var/nzrepl/nzreplbackup/6988/
1398097573/rt3.
Completed backups.
The next step must be run on the replica.
Restore the databases on the replica by running:
  nzreplrestore -recoveryfile /var/nzrepl/nzreplbackup/6988/
1398097573/rt3
[nz@PTS100]$

El siguiente ejemplo utiliza la opción -dir para realizar una copia de seguridad de los datos de replicación en un directorio especificado:

[nz@PTS100]$ nzreplbackup -recoveryfile my_recoveryfile.xml -dir
/home/nz/myReplDir
Starting backup: -globals
Starting backup: -db replset
Starting backup: -db cust_data
database global objects now meets replication node activation
requirements.
database replset now meets replication node activation requirements.
database cust_data now meets replication node activation requirements.
Activating myREPLSET.REPL_MASTER completed successfully.
Backup of global objects completed successfully.
Backup of database replset to backupset 20140610194635 completed
successfully.
Backup of database cust_data to backupset 20140610194636 completed
successfully.
Completed backups.
The next step is to transfer the recovery file and the backup files to
the replica.
Restore the databases on the replica by running:
  nzreplrestore -recoveryfile my_recoveryfile.xml
The nzreplrestore command also requires a backup location option, such
as -dir.
Run nzreplrestore -? for more options.
[nz@PTS100]$

El siguiente ejemplo utiliza las opciones -parallelism y -orderFile para indicar cómo realizar copias de seguridad en paralelo. Supongamos que el fichero de pedidos contiene los siguientes nombres de bases de datos:


NDB2
NDB3
NDB1

Con un valor de 2 para la opción -parallelism, primero se realiza la copia de seguridad de la base de datos globals, seguida de las bases de datos NDB2 y NDB3 en paralelo, seguidas de la base de datos NDB1 :


[nz@PTS100]$ nzreplbackup -recoveryfile recovery.xml -rqm -orderFile dbOrder
-parallelism 2
Starting backup: -globals
database global objects now meets replication node activation requirements.
Backup of global objects completed successfully.
Backup of global objects was moved to /var/nzrepl/nzreplbackup/5882/1412958099/0.
Starting backup: -db NDB2
Starting backup: -db NDB3
database NDB2 now meets replication node activation requirements.
database NDB3 now meets replication node activation requirements.
Backup of database NDB2 to backupset 20141010162147 completed successfully.
Backup of database NDB2 was moved to /var/nzrepl/nzreplbackup/5882/1412958099/385482754.
Backup of database NDB3 to backupset 20141010162148 completed successfully.
Backup of database NDB3 was moved to /var/nzrepl/nzreplbackup/5882/1412958099/385482755.
Starting backup: -db NDB1
database NDB1 now meets replication node activation requirements.
Activating REPLSET.REPL_MASTER completed successfully.
Backup of database NDB1 to backupset 20141010162152 completed successfully.
Backup of database NDB1 was moved to /var/nzrepl/nzreplbackup/5882/1412958099/385482753.
The recovery file was moved to /var/nzrepl/nzreplbackup/5882/1412958099/recovery.xml.
Completed backups.
The next step must be run on the replica.
Restore the databases on the replica by running:
nzreplrestore -recoveryfile /var/nzrepl/nzreplbackup/5882/1412958099/recovery.xml
[nz@PTS100]$ nzreplbackup -recoveryfile recovery.xml -rqm -orderFile dbOrder
-parallelism 2 -simulate