Tema anterior: Revisión de los requisitos previos de automatizaciónTema siguiente: Gestión de scripts anteriores/posteriores para la automatización


Funcionamiento de las utilidades de generación de scripts

El Agente de Arcserve UDP (Linux) proporciona algunas utilidades de generación de scripts para ayudar a crear el script de automatización. Estas utilidades solo se utilizan para la generación de scripts de modo que el resultado sea una generación de scripts descriptiva. Las utilidades se utilizan para gestionar nodos, tareas, replicar destinos de la copia de seguridad, así como gestionar registros de actividad.

Todas las utilidades se encuentran en la carpeta bin en la siguiente ubicación:

/opt/CA/d2dserver/bin

La utilidad d2dutil --encrypt cifra la contraseña y proporciona una contraseña cifrada. Se debe utilizar esta utilidad para cifrar todas las contraseñas. Si se utiliza el parámetro --pwdfile=pwdfilepath, se deberá cifrar la contraseña. Se puede utilizar la utilidad de acuerdo con los métodos siguientes:

Método 1

echo "string" | d2dutil --encrypt

string es la contraseña que se especifica.

Método 2

Escriba el comando "d2dutil –encrypt" y, a continuación, especifique la contraseña. Pulse Intro y verá el resultado en su pantalla. Si se elige este método, la contraseña introducida no se registra en la pantalla.

Siga estos pasos:

  1. Inicie sesión en el servidor de copia de seguridad como usuario raíz.
  2. Vaya a la carpeta bin mediante el siguiente comando:
    # cd/opt/CA/d2dserver/bin
    
  3. Ejecute los comandos siguientes para gestionar los nodos:
    # ./d2dnode
    

    Muestra una lista de comandos disponibles para facilitar la gestión de todos los nodos de Linux relacionados. Mediante este comando, se pueden agregar, suprimir, modificar e importar nodos. Se pueden agregar también nodos mediante las credenciales no raíz.

    Nota: Se pueden utilizar todos los parámetros del comando d2dnode cuando el servidor de copia de seguridad es un Agente de Linux independiente. Cuando la consola de UDP gestiona el servidor de copia de seguridad, el comando d2dnode le permite realizar solamente los parámetros list, add, modifiy e import. Los parámetros list, add, modify e import actualizarán el nodo en la consola de UDP. Por ejemplo, el comando ./d2dnode --list enumerará todos los nodos de Linux que se han agregado a la consola de UDP.

    # ./d2dnode --list enumera todos los nodos que gestiona el servidor de copia de seguridad.
    
    # ./d2dnode --add=nodename/ip --user=username --password=password --description=”the description of that node” --attach=jobname --force
    

    Agrega al servidor de copia de seguridad el nodo específico. Si se trata de un usuario raíz, utilice este comando para agregar nodos.

    Nota: Si se cambia el número de puerto del nodo, se deberá especificar el número de puerto nuevo en el parámetro --add como se muestra en el ejemplo siguiente.

    Ejemplo: # ./d2dnode -–add=nodename/ip:new_port -–user=username -–password=password -–description=”the description of that node” --attach=jobname --force

    --attach=jobname

    Agrega un nuevo nodo a una tarea de copia de seguridad existente.

    --force

    Agrega el nodo de forma forzosa incluso si otro servidor de copia de seguridad lo gestiona. Si se elimina el parámetro force, entonces no se agregará el nodo a este servidor si lo gestiona otro servidor de copia de seguridad.

    # ./d2dnode --add=nodename --user=username --password=password --rootuser=rootaccount --rootpwd=rootpassword --pwdfile=pwdfilepath --description=description --attach=jobname -force
    

    Agrega al servidor de copia de seguridad el nodo específico. Si se trata de un usuario no raíz, utilice este comando para agregar nodos.

    Nota: Si se cambia el número de puerto del nodo, se deberá especificar el número de puerto nuevo en el parámetro --add como se muestra en el ejemplo siguiente.

    Ejemplo: # ./d2dnode --add=nodename/ip:new_port --user=username --password=password --rootuser=rootaccount --rootpwd=rootpassword --pwdfile=pwdfilepath --description=description --attach=jobname –force

    --user=username

    Especifica el nombre de usuario del usuario no raíz.

    --password=password

    Especifica la contraseña del usuario no raíz. Si se proporciona el parámetro --pwdfile=pwdfilepath, no se tiene que especificar este parámetro.

    --rootuser=rootaccount

    Especifica el nombre de usuario del usuario raíz.

    --rootpwd=rootpassword

    Especifica la contraseña del usuario raíz. Si se proporciona el parámetro --pwdfile=pwdfilepath, no se tiene que especificar este parámetro.

    --pwdfile=pwdfilepath

    (Opcional) Especifica la contraseña del usuario raíz y del usuario no raíz. Este parámetro es opcional y se utiliza si se han almacenado las contraseñas del usuario raíz y los usuarios no raíz en un archivo independiente. El archivo de contraseña incluye los parámetros siguientes: -- password=password y --rootpwd=rootpassword. Para mayor seguridad, la contraseña se deberá cifrar mediante la utilidad -encrypt de d2dutil. Después de cifrar la contraseña, reemplace la contraseña anterior por la contraseña cifrada en el parámetro --pwdfile.

    # ./d2dnode --node=nodename --attach=jobname
    

    Agrega el nodo especificado a una tarea de copia de seguridad existente.

    # ./d2dnode --modify=nodename/ip --user=username --password=newpassword --description=newdescription
    

    Modifica el nombre del usuario, la contraseña o la descripción del nodo agregado. Si se trata de un usuario raíz, utilice este comando para modificar los nodos.

    # ./d2dnode --modify=nodename --user=username --password=newpassword --rootuser=rootaccount --rootpwd=newrootpassword --pwdfile=pwdfilepath --description=newdescription
    

    Modifica el nombre del usuario, la contraseña o la descripción del nodo agregado. Si se trata de un usuario no raíz, utilice este comando para modificar los nodos.

    --user=username

    Especifica el nombre de usuario del usuario no raíz.

    --password=newpassword

    Especifica la nueva contraseña del usuario no raíz.

    --rootuser=rootaccount

    Especifica el nombre de usuario del usuario raíz.

    --rootpwd=newrootpassword

    Especifica la nueva contraseña del usuario raíz.

    --pwdfile=pwdfilepath

    (Opcional) Especifica la contraseña del usuario raíz y del usuario no raíz. Este parámetro es opcional y se utiliza si se han almacenado las contraseñas del usuario raíz y los usuarios no raíz en un archivo independiente. El archivo de contraseña incluye los parámetros siguientes:--password=newpassword and --rootpwd=newrootpassword.

    # ./d2dnode --delete=nodename1,nodename2,nodename3
    

    Suprime los nodos especificados del servidor de copia de seguridad. Para suprimir varios nodos, utilice la coma (,) como delimitador.

    # ./d2dnode --import=network --help
    

    Importa nodos desde la red. Cuando se importan nodos, se obtienen las opciones siguientes para configurarlas:

    --netlist

    Especifica la lista de direcciones IP de IP v4. Para varias entradas, la lista debe estar compuesta por entradas separadas con comas.

    Ejemplo

    192.168.1.100: Importa el nodo que tiene la dirección IP 192.168.1.100.

    192.168.1.100-150: Importa todos los nodos que pertenecen al intervalo entre 192.168.1.100 y 192.168.100.150.

    192.168.1.100-: Importa todos los nodos que pertenecen al intervalo entre 192.168.1.100 y 192.168.1.254. No se debe mencionar el intervalo final.

    192.168.1.100-150,192.168.100.200-250: Importa varios nodos que pertenecen a dos intervalos diferentes. El primer intervalo entre 192.168.1.100 y 192.168.1.150, y el segundo intervalo entre 192.168.100.200 y 192.168.100.250. Un coma separa cada entrada.

    --joblist

    Especifica la lista de nombres de tareas. Un nombre de tarea no debe incluir un coma. Después de importar correctamente un nodo, el nodo se agrega a la tarea. Para varias tareas, la lista debe estar compuesta por entradas separadas por comas.

    Ejemplo: -- joblist=jobA,jobB,jobC

    En este ejemplo, una coma separa cada entrada de tarea.

    Nota: Solo la versión independiente del Agente de Arcserve UDP (Linux) es compatible con esta opción.

    --user

    Especifica el nombre de usuario que se debe importar y agregar los nodos.

    --password

    Especifica la contraseña para importar y agregar nodos.

    --rootuser

    Especifica el nombre de usuario del usuario raíz. Si se agrega un usuario que no es el usuario raíz, utilice este parámetro para especificar las credenciales del usuario raíz.

    --rootpwd

    Especifica la contraseña del usuario raíz. Si se agrega un usuario que no es el usuario raíz, utilice este parámetro para especificar las credenciales del usuario raíz.

    --pwdfile

    (Opcional) Especifica la contraseña del usuario raíz y del usuario no raíz. Este parámetro es opcional y se utiliza si se han almacenado las contraseñas del usuario raíz y los usuarios no raíz en un archivo independiente. El archivo de contraseña incluye los parámetros siguientes:--password=newpassword and --rootpwd=newrootpassword.

    --prefix

    Especifica el prefijo proporcionado a un nombre de host. Utilice este parámetro para filtrar nodos que incluyen el prefijo en el nombre de host.

    --blacklistfile

    Especifica un archivo que incluye una lista de nombres de host de nodos que no se desean agregar al servidor de copia de seguridad. Se debe proporcionar un nodo por línea en el archivo.

    --force

    Agrega el nodo de forma forzosa incluso si otro servidor de copia de seguridad lo gestiona. Si se elimina el parámetro force, entonces no se agregará el nodo a este servidor si lo gestiona otro servidor de copia de seguridad.

    --verbose

    Muestra más información acerca del proceso de importación de nodos. Utilice este parámetro con el fin de generar scripts de depuración o automatización.

    --help

    Muestra la pantalla de ayuda.

    Notas:

  4. Ejecute los comandos siguientes para gestionar las tareas:
    # ./d2djob
    

    Aparece una lista de comandos para facilitar la gestión de tareas. Mediante este comando, se podrán ejecutar, cancelar y suprimir tareas.

    # ./d2djob --delete=jobname
    

    Suprime la tarea especificada de la ficha Estado de la tarea.

    # ./d2djob --run=jobname --jobtype=1 --wait
    

    Ejecuta la tarea especificada. El parámetro --jobtype es opcional. El comando d2djob identifica automáticamente el tipo de trabajo del nombre de tarea que se especifica. Si el comando identifica una tarea de restauración, esta se inicia. Si el comando identifica una tarea de copia de seguridad y no se proporciona ningún valor para el parámetro --jobtype, se iniciará una tarea de copia de seguridad incremental. La copia de seguridad incremental es el tipo de tarea predeterminada.

    Si se desea especificar el tipo de tarea para una tarea de copia de seguridad, los valores son 0, 1 y 2, donde 0 indica una tarea de copia de seguridad completa; 1 indica una tarea de copia de seguridad incremental y 2 indica una tarea de copia de seguridad de verificación.

    # ./d2djob --cancel=jobname --wait
    

    Cancela una tarea que está en curso.

    Si se incluye --wait en el comando, el estado de la tarea aparecerá después de que la tarea se cancele. Si no se incluye --wait en el comando, el mensaje de estado se muestra inmediatamente después de enviar la solicitud de cancelación.

    # ./d2djob --newrestore=restoreJobName --target=macaddress/ipaddress --hostname=hostname --network=dhcp/staticip --staticip=ipaddress --subnet=subnetMask --gateway=gateway --runnow --wait
    

    Ejecuta una tarea de restauración para un nuevo equipo de destino basado en una tarea de restauración existente. Este comando permite utilizar la misma configuración de restauración que la tarea de restauración existente; solamente los detalles del equipo de destino son diferentes. Si se utiliza este comando, no se tienen que crear varias tareas de restauración para equipos de destino diferentes.

    Se debe proporcionar un valor para --newrestore, --target, --hostname y --network.

    Si el valor para --network es staticip, a continuación se debe proporcionar un valor para --staticip, --subnet y --gateway. Si el valor para --network es dhcp, a continuación no se tiene que proporcionar ningún valor para --staticip, --subnet y --gateway.

    Si se incluye --runnow en el comando, la tarea se ejecutará inmediatamente después de que se envíe la tarea, sin tener en cuenta la programación de tareas.

    Si se incluye el parámetro --wait en el comando, el mensaje de estado aparecerá después de que la tarea finalice. Si no se incluye --wait en el comando, el mensaje de estado se muestra inmediatamente después de enviar la tarea.

    # ./d2djob <--export=nombretarea1,nombretarea2,nombretarea3> <--file=rutaarchivo>
    

    Exporta varias tareas del servidor de copia de seguridad a un archivo. Si desea tener configuraciones de copia de seguridad parecidas en varios servidores de copia de seguridad, se pueden exportar las tareas de copia de seguridad a un archivo y, a continuación, importar el archivo a otros servidores de copia de seguridad.

    Nota: Si el servidor de copia de seguridad de Linux se gestiona mediante la consola de Arcserve UDP, la función de exportación no es compatible.

    # ./d2djob <--import=rutaarchivo>
    

    Importa el archivo que contiene la información de la tarea de copia de seguridad a un servidor de copia de seguridad. Se puede importar también el archivo a Arcserve UDP, si Arcserve UDP gestiona el servidor de copia de seguridad.

    Si la tarea de copia de seguridad se importa a un servidor de copia de seguridad, se podrá seleccionar la tarea en el cuadro de diálogo siguiente:

    Agregar nodos a una tarea existente

    Se puede utilizar también la siguiente utilidad de la línea de comandos para agregar nodos a esta tarea:

    ./d2dnode -attach=jobname
    
  5. Ejecute los siguientes comandos para crear o actualizar el archivo de configuración de los puntos de recuperación. El Agente de Arcserve UDP (Linux) utiliza el archivo de configuración para gestionar y mostrar los puntos de recuperación de la IU.
    # ./d2drp
    

    Crea o actualiza los archivos de configuración de los puntos de recuperación en función de los detalles de los puntos de recuperación. Mediante este comando se pueden crear o actualizar los archivos de configuración.

    # ./d2drp --build --storagepath=/backupdestination --node=node_name
    

    Verifica todos los puntos de recuperación que pertenecen a node_name y actualizan todos los archivos de configuración de los puntos de recuperación. Si los archivos de configuración de los puntos de recuperación no están presentes, este comando creará los archivos automáticamente. El parámetro --build crea los archivos de configuración de los puntos de recuperación.

    # ./d2drp --build --storagepath=/backupdestination --node=node_name --rp=recovery_point
    

    Verifica el nombre de la sesión especificado y actualiza todos los archivos de configuración de los puntos de recuperación. Si los archivos de configuración de los puntos de recuperación no están presentes, este comando creará los archivos automáticamente. Especifique la palabra clave "last" para que el parámetro --rp obtenga el punto de recuperación más reciente.

    # ./d2drp  --show --storagepath=path --node=nodeName --rp=recovery_point --user=username --password=password
    

    Muestra información del sistema para el punto de recuperación especificado.

    --rp=recovery_point

    Seleccione el punto de recuperación al cual se desee acceder. Especifique la palabra clave "last" para obtener el punto de recuperación más reciente.

    --user=username

    Especifica el nombre del usuario para acceder a la ubicación de almacenamiento o al destino de la copia de seguridad.

    --password=password

    Especifica la contraseña para acceder a la ubicación de almacenamiento o al destino de la copia de seguridad.

    Nota: d2drp no admite el recurso compartido de NFS o de CIFS para el parámetro --build. Si desea utilizar el recurso compartido de NFS o de CIFS, deberá montar primero el recurso compartido al host local y, a continuación, utilice el punto de montaje como ruta de almacenamiento.

  6. Ejecute el comando siguiente para registrar el servidor de copia de seguridad en Arcserve UDP. Cuando se registra el servidor de copia de seguridad con Arcserve UDP, se puede gestionar el servidor de copia de seguridad desde Arcserve UDP. También se pueden importar a Arcserve UDP nodos y tareas que se gestionaban previamente mediante el servidor de copia de seguridad.
    # ./d2dreg <--reg=nombreservidor> <--user=nombreusuario> <--port=puerto> <--protocol=http/https> [--password=contraseña]
    

    Registra el servidor de copia de seguridad en Arcserve UDP para que el servidor de copia de seguridad se pueda gestionar desde la consola de Arcserve UDP.

    Nota: El comando d2dreg utiliza el nombre de host del servidor de copia de seguridad para identificar el servidor. Si la consola de Arcserve UDP no se puede conectar al servidor de copia de seguridad mediante el nombre de host, cambie el nombre de host en la Dirección IP en el cuadro de diálogo Actualizar nodo.

  7. Ejecute los comandos siguientes para gestionar los registros de actividades:
    # ./d2dlog
    

    Aparece el formato que ayuda a obtener los registros de actividades para el ID de la tarea especificada en el formato determinado.

    # ./d2dlog --show=jobid --format=text/html
    

    Se muestra el registro de actividades de la tarea especificada. El valor de formato es opcional porque el valor predeterminado es texto.

  8. Ejecute los comandos siguientes para gestionar el historial de tareas:
    # ./d2djobhistory
    

    Muestra el historial de tareas en función de los filtros que se especifican. Se puede filtrar el historial de tareas por días, semanas, meses y fecha de inicio y finalización.

    # ./d2djobhistory --day=n --headers=column_name1,column_name2,...column_name_n --width=width_value --format=column/csv/html
    

    Muestra el historial de tareas reciente en función de los días especificados.

    --headers=column_name1,column_name2,...column_name_n

    (Opcional) Especifica las columnas que se desean ver en el historial de tareas. Este parámetro es opcional. Las columnas predeterminadas son ServerName, TargetName, JobName, JobID, JobType, DestinationLocation, EncryptionAlgoName, CompressLevel, ExecuteTime, FinishTime, Throughput, WriteThroughput, WriteData, ProcessedData y Status.

    --width=width_value

    (Opcional) Especifica el número de caracteres que se desean mostrar para cada columna. Este parámetro es opcional. Cada columna tiene su propia anchura predeterminada. Se puede actualizar el valor de anchura para cada columna, donde cada valor de anchura se separa con una coma (,).

    --format=column/csv/html

    Especifica el formato de apariencia del historial de tareas. Los formatos disponibles son columna, csv y html. Se puede especificar solamente un formato a la vez.

    # ./d2djobhistory --week=n --headers=column_name1,column_name2,...column_name_n --width=width_value --format=column/csv/html
    

    Muestra el historial de tareas reciente en función de las semanas especificadas.

    # ./d2djobhistory --month=n --headers=column_name1,column_name2,...column_name_n --width=width_value --format=column/csv/html
    

    Muestra el historial de tareas reciente en función de los meses especificados.

    # ./d2djobhistory --starttime=yyyymmdd --endtime=yyyymmdd --headers=column_name1,column_name2,...column_name_n --width=width_value --format=column/csv/html
    

    Muestra el historial de tareas reciente en función de la fecha de inicio y de finalización especificada.

Las utilidades de generación de scripts se han utilizado para gestionar correctamente nodos, tareas y registros de actividades.