Copia de seguridad y restauración de su instalación

Un Workspace de Enterprise Server puede contener una amplia gama de datos valiosos, incluidos usuarios definidos, grupos, tareas de sincronización LDAP, datos de diseño (incluidos proyectos, componentes, modelos y plantillas) y configuraciones para los servicios PLS y NIS (y, por lo general, una variedad de productos y extensiones adquiridos, así como paquetes de implementación definidos para estos últimos). Un requisito clave para garantizar la integridad a largo plazo de estos datos es realizar copias de seguridad. La instalación estándar de Enterprise Server incluye una herramienta de copia de seguridad y restauración, a la que se accede mediante una línea de comandos.

La ubicación predeterminada de la herramienta de copia de seguridad está en la carpeta \Program Files (x86)\Altium\Altium365\Tools\BackupTool.

El nombre de la herramienta de copia de seguridad es avbackup.exe.

Acceso a la herramienta de copia de seguridad

Para usar la herramienta:

1. Inicie una línea de comandos de Windows.

   Debe ejecutar la línea de comandos en modo de administrador para poder utilizar la herramienta de copia de seguridad y restauración. Si no está ejecutando un símbolo del sistema CMD como administrador de Windows, cualquier intento de ejecutar un comando relacionado con la copia de seguridad o restauración de su Enterprise Server dará como resultado el mensaje claro: Access Denied. Administrator permissions are needed to use the selected options. Use an administrator command prompt to complete these tasks.

2. Vaya a la carpeta correcta. Para una instalación predeterminada en la unidad C del equipo host, será: cd C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\

3. Para ejecutar la herramienta y mostrar las opciones disponibles, en el símbolo del sistema escriba: avbackup ?

Acceso a la herramienta de copia de seguridad mediante una línea de comandos (ejecutada como administrador).

Tenga en cuenta ?; al incluirlo se muestra la ayuda sobre las funciones disponibles en la herramienta de copia de seguridad:

• backup – realizar copia de seguridad de los datos en un archivo ZIP.

• restore – restaurar datos desde un archivo ZIP. El punto de restauración se creará automáticamente.

• help – mostrar la pantalla de ayuda (? puede usarse en lugar de la cadena help).

Contenido del archivo Zip

La herramienta realiza una copia de seguridad de todos los datos de Enterprise Server y de los usuarios, incluidos:

• Copia de seguridad completa de la base de datos, incluidos: todos los elementos de datos (modelos, componentes, hojas gestionadas, plantillas, diseños liberados, etc.), usuarios, grupos, instalaciones adquiridas mediante el Network Installation Service y configuraciones de sincronización LDAP.

• Todas las revisiones de lo anterior.

• Repositorios y diseños del Workspace incluidos.

• Índice de búsqueda.

• Configuraciones definidas por el usuario (personalizadas).

Sintaxis y modificadores de copia de seguridad

Los siguientes modificadores están disponibles al usar la función de copia de seguridad de la herramienta:

avbackup backup -z [-t] [-h] [-i] [-m] [-d] [-c] [--split] [--skip-shadow-copy]

• -z – ruta y nombre de archivo del archivo zip de destino que se va a crear. Enciérrelo entre comillas si hay espacios en la cadena. Este modificador es obligatorio.

• -t, --test – si se especifica este modificador, el archivo zip se comprobará después de la copia de seguridad.

• -h, --hash – si se especifica este modificador, se creará un archivo hash MD5 (*.md5).

• -i – ruta completa al archivo LocalVault.ini de Enterprise Server, que proporciona información sobre la ubicación de los datos del Enterprise Server del que se va a realizar la copia de seguridad. La ruta predeterminada de este archivo es C:\Program Files (x86)\Altium\Altium365\LocalVault.ini. Si no se especifica este modificador, la herramienta intentará encontrar el archivo automáticamente basándose en esta ubicación de instalación predeterminada. Enciérrelo entre comillas si hay espacios en la cadena.

• -m – le permite determinar si la operación de copia de seguridad debe ejecutarse silenciosamente (-m silent, que es el modo predeterminado), o si debe aparecer un cuadro de diálogo solicitando reintentar en caso de fallo (-m dialog). Si no se especifica este modificador, se utilizará el modo silencioso.

• -d, --debug – si se especifica este modificador, se utilizará el modo de depuración, lo que permitirá crear más registros con fines de diagnóstico y para compartir con los ingenieros de Altium.

• -c – le permite especificar el nivel de compresión del archivo zip de destino. Utilice un número de 0 a 9. También puede usar los siguientes valores:

  • Default – equivale al nivel de compresión 6 (se usa si no se especifica este modificador)

  • None – equivale al nivel de compresión 0

  • BestSpeed – equivale al nivel de compresión 1

  • BestCompression – equivale al nivel de compresión 9.

• --split – si se especifica este modificador, se crearán archivos zip separados para los repositorios y las revisiones (sin compresión), además del archivo zip para los demás datos.

• --skip-shadow-copy – si se especifica este modificador, no se creará una copia de sombra. Tenga en cuenta que el tiempo de inactividad del servidor (el período entre la detención y el inicio de los servicios) aumenta cuando se utiliza este modificador.

Si escribe solo avbackup backup, estos modificadores se mostrarán como ayuda.

Modificadores disponibles al utilizar la herramienta en modo de copia de seguridad.

Sintaxis y modificadores de restauración

Los siguientes modificadores están disponibles al usar la función de restauración de la herramienta:

avbackup restore -z [--skip-backup] [-i] [-m] [-d] [-c] [--split] [--skip-shadow-copy]

• -z – ruta y nombre de archivo del archivo zip de copia de seguridad desde el cual restaurar. Enciérrelo entre comillas si hay espacios en la cadena. Este modificador es obligatorio.

• --skip-backup – le permite omitir la creación de un punto de restauración antes de comenzar a restaurar el Enterprise Server. Úselo con cuidado, ya que si falla la restauración de los datos, no será posible revertirla.

• -i – ruta completa al archivo LocalVault.ini de Enterprise Server, que proporciona información sobre las ubicaciones en las que se restaurarán los datos de Enterprise Server. La ruta predeterminada de este archivo es C:\Program Files (x86)\Altium\Altium365\LocalVault.ini. Si no se especifica este modificador, la herramienta intentará encontrar el archivo automáticamente basándose en esta ubicación de instalación predeterminada. Enciérrelo entre comillas si hay espacios en la cadena.

• -m – le permite determinar si la operación de restauración debe ejecutarse silenciosamente (-m silent, que es el modo predeterminado), o si debe aparecer un cuadro de diálogo solicitando reintentar en caso de fallo (-m dialog). Si no se especifica este modificador, se utilizará el modo silencioso.

• -d, --debug – si se especifica este modificador, se utilizará el modo de depuración, lo que permitirá crear más registros con fines de diagnóstico y para compartir con los ingenieros de Altium.

• -c – le permite especificar el nivel de compresión del archivo zip de destino para el punto de restauración (una copia de seguridad de la instalación actual de Enterprise Server). Utilice un número de 0 a 9. También puede usar los siguientes valores:

  • Default – equivale al nivel de compresión 6 (se usa si no se especifica este modificador)

  • None – equivale al nivel de compresión 0

  • BestSpeed – equivale al nivel de compresión 1

  • BestCompression – equivale al nivel de compresión 9.

• --split – si se especifica este modificador, se crearán archivos zip separados para repositorios y revisiones (sin compresión), además del archivo zip para los demás datos, para el punto de restauración (una copia de seguridad de la instalación actual de Enterprise Server).

• --skip-shadow-copy–  si se especifica este modificador, no se creará una copia de sombra para el punto de restauración (una copia de seguridad de la instalación actual de Enterprise Server). Tenga en cuenta que el tiempo de inactividad del servidor (el período entre la detención y el inicio de los servicios) aumenta cuando se utiliza este modificador.

Al escribir solo avbackup restore, estos modificadores se mostrarán como ayuda útil.

Modificadores disponibles al usar la herramienta en modo de restauración.

Punto de restauración

La herramienta de copia de seguridad crea automáticamente un punto de restauración antes de comenzar a restaurar Enterprise Server (si no se ha utilizado --skip-backup para la restauración). Para ello, la herramienta de copia de seguridad realiza una copia de seguridad del Enterprise Server existente y copia el ZIP de restauración en la siguiente ubicación:

C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\Backups\

El archivo ZIP se nombra con el formato: Backup_<Date>_<Time>.zip.

Registro de copia de seguridad y restauración

La información sobre los eventos durante una copia de seguridad o restauración se presenta directamente en la ventana de CMD y también puede encontrarse en el archivo de registro:

C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\avbackup.log

Si se produce un error durante una copia de seguridad o restauración, también puede encontrarse información completa al respecto en el archivo de registro ().