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, normalmente, 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. Abra una ventana del símbolo del sistema de Windows.

   Debe ejecutar el símbolo del sistema en modo de administrador para poder usar la herramienta de copia de seguridad y restauración. Si no está ejecutando una ventana CMD como administrador de Windows, al intentar ejecutar un comando relacionado con la copia de seguridad o la restauración de su Enterprise Server aparecerá el siguiente 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 a través de una ventana del símbolo del sistema (ejecutada como administrador).

Tenga en cuenta ?, ya que al incluir esto 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 todo Enterprise Server y de los datos del usuario, incluidos:

• Copia de seguridad completa de la base de datos, que incluye: 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. Escríbalo entre comillas si la cadena contiene espacios. 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. Escríbalo entre comillas si la cadena contiene espacios.

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

• -d, --debug – si se especifica este modificador, se usará 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. Use 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 sombra. Tenga en cuenta que el tiempo de inactividad del servidor (el período entre detener e iniciar los servicios) aumenta cuando se utiliza este modificador.

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

Modificadores disponibles al usar 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 que se va a restaurar. Escríbalo entre comillas si la cadena contiene espacios. 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 la restauración de datos falla, no será posible revertirla.

• -i – ruta completa al archivo LocalVault.ini de Enterprise Server, que proporciona información sobre las ubicaciones en las que restaurar 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. Escríbalo entre comillas si la cadena contiene espacios.

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

• -d, --debug – si se especifica este modificador, se usará 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). Use 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, 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 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 detener e iniciar 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 el Enterprise Server (si no se ha usado --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 ZIP se nombra con el formato: Backup_<Date>_<Time>.zip.

Errores durante la copia de seguridad o la restauración

Los errores que se produzcan durante una copia de seguridad o restauración se muestran directamente en la ventana de CMD, junto con la información completa de la ruta al registro de errores:

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

Al realizar una copia de seguridad o restaurar su Enterprise Server, los detalles de cualquier error, así como la ruta completa al archivo errors.log, se muestran directamente en la ventana de CMD.