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 una copia de seguridad de ellos. La instalación estándar de Enterprise Server incluye una herramienta de copia de seguridad y restauración, a la que se accede mediante un símbolo del sistema.
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.
-
Si la herramienta avbackup.exe no está ubicada en la ruta predeterminada, \Program Files (x86)\Altium\Altium365\Tools\BackupTool, pueden producirse errores/excepciones durante una restauración.
-
La herramienta independiente Health Monitor tool (avhealth.exe) debe estar cerrada al usar la herramienta de copia de seguridad (ya sea en modo de copia de seguridad o de restauración), ya que ambas herramientas requieren acceso al archivo de base de datos de Enterprise Server.
-
Se recomienda encarecidamente que los usuarios no estén conectados ni utilizando el Workspace durante los procesos de copia de seguridad y restauración, ya que estos requieren acceso a la base de datos del Workspace. Como administrador del Workspace, puede cerrar forzosamente la sesión de los usuarios si es necesario eliminando su sesión actual del Workspace a través de la página Sessions de la interfaz del navegador (Admin – Sessions). Consulte la página Sessions para obtener más información.
-
Restaurar una copia de seguridad solo es posible en la misma versión de Enterprise Server desde la que se creó esa copia de seguridad. En este sentido, puede ser una buena idea conservar el instalador de ese Enterprise Server y los archivos de licencia correspondientes junto con el archivo Zip de la copia de seguridad.
El proceso de copia de seguridad/restauración también restablece el recuento de transacciones de la base de datos. El estado actual del recuento de transacciones del servidor puede comprobarse con la Health Monitor tool (consulte la entrada Transaction count en la región DATABASE de la ventana de la herramienta).
La herramienta de copia de seguridad usa el Volume Shadow Copy Service (VSS) para crear una copia de sombra del volumen donde se encuentran los datos del servidor (también se admite una configuración en la que las revisiones se almacenan en un volumen separado). Con VSS, la herramienta de copia de seguridad detiene los servicios, crea una copia de sombra, inicia los servicios y luego realiza la copia de seguridad de los datos usando la copia de sombra creada. Este enfoque minimiza el tiempo de inactividad del servidor (el período entre detener e iniciar los servicios) y se utiliza de forma predeterminada. En caso de error al crear una copia de sombra, la herramienta de copia de seguridad utilizará un enfoque sin crear una copia de sombra (que también puede habilitarse explícitamente usando el modificador --skip-shadow-copy).
Acceso a la herramienta de copia de seguridad
Para usar la herramienta:
-
Abra un símbolo del sistema de Windows.
Debe ejecutar el símbolo del sistema en modo administrador para poder usar la herramienta de copia de seguridad y restauración. Si no está ejecutando una ventana de CMD como administrador de Windows, al intentar ejecutar un comando relacionado con la copia de seguridad o 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.
-
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\
-
Para ejecutar la herramienta y mostrar las opciones disponibles, en el símbolo del sistema escriba: avbackup ?
En algunas versiones de Windows, no es posible pegar en un símbolo del sistema usando Ctrl+V, pero puede pegar mediante el menú contextual del botón derecho. Copie primero las cadenas necesarias y luego péguelas usando esta técnica para ahorrar tiempo y evitar errores.
Acceso a la herramienta de copia de seguridad mediante un símbolo del sistema (ejecutado como administrador).
Tenga en cuenta ?; al incluirlo, se muestra la ayuda sobre las funciones disponibles en la herramienta de copia de seguridad:
-
backup – realizar una 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, 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 la configuración 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 la 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 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 solicitando reintentar en caso de fallo (-m dialog). Si no se especifica este modificador, se usará 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 compartirlos 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 de sombra. Tenga en cuenta que el tiempo de inactividad del servidor (el período entre detener e iniciar los servicios) aumenta cuando se usa este modificador.
Si escribe solo avbackup backup, estos modificadores se mostrarán como ayuda útil.
Modificadores disponibles al usar la herramienta en modo de copia de seguridad.
Backup Example
La siguiente entrada realizará silenciosamente una copia de seguridad de Enterprise Server en el archivo llamado 02102024_Backup.zip, escribiendo el archivo en la carpeta C:\Backups\Altium Enterprise Server\:
avbackup backup -z "C:\Backups\Altium Enterprise Server\02102024_Backup.zip" -i "C:\Program Files (x86)\Altium\Altium365\LocalVault.ini"
Las carpetas especificadas ya deben existir. Además, los archivos existentes se sobrescribirán si el nuevo archivo tiene el mismo nombre que un archivo ya existente.
El resultado de ejecutar el comando de copia de seguridad de ejemplo.
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 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 volver atrás.
-
-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. 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 solicitando reintentar en caso de fallo (-m dialog). Si no se especifica este modificador, se usará 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 compartirlos 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 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.
Si escribe solo avbackup restore, se mostrará una lista de estos modificadores como ayuda útil.
Modificadores disponibles al usar la herramienta en modo de restauración.
Si existe un archivo hash *.md5 para el archivo zip de copia de seguridad desde el que se va a restaurar (el archivo *.md5 está en la misma carpeta que el archivo zip y recibe el nombre del archivo zip, es decir, <ZipFileName>.zip.md5), su hash se comprobará antes de la restauración.
Restore Example
La siguiente entrada restaurará silenciosamente Enterprise Server utilizando el archivo zip de copia de seguridad llamado 30082022_Backup.zip, que está almacenado en la carpeta C:\Backups\Altium Enterprise Server\:
avbackup restore -z "C:\Backups\Altium Enterprise Server\30082022_Backup.zip" -i "C:\Program Files (x86)\Altium\Altium365\LocalVault.ini"
El resultado de ejecutar el comando de restauración del ejemplo. Observe que la herramienta crea primero un punto de restauración (una copia de seguridad de la instalación actual de Enterprise Server), antes de realizar la 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 ZIP recibe un nombre 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 sobre este en el archivo de registro (
).
Localizado por IA