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.
-
Si la herramienta avbackup.exe no se encuentra 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.
-
Solo es posible restaurar una copia de seguridad en la misma versión de Enterprise Server desde la cual se creó esa copia. 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 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 mediante la herramienta 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 utiliza 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 independiente). 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 período de inactividad del servidor (el tiempo entre la detención y el inicio de 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 mediante el modificador --skip-shadow-copy).
Acceso a la herramienta de copia de seguridad
Para usar la herramienta:
-
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.
-
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 una línea de comandos usando Ctrl+V, pero puede pegar mediante el menú del botón derecho. Copie primero las cadenas necesarias y luego péguelas con esta técnica para ahorrar tiempo y evitar errores.
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.
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"
Todas las carpetas especificadas deben existir previamente. Además, los archivos existentes se sobrescriben si el nuevo archivo tiene el mismo nombre que un archivo 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 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.
Si existe un archivo hash de *.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 lleva 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 usando el archivo zip de copia de seguridad llamado 30082022_Backup.zip, que se almacena 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 de ejemplo. Observe que la herramienta primero crea 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 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 (
).
AI-localized