Um Workspace do Enterprise Server pode conter uma vasta gama de dados valiosos, incluindo utilizadores definidos, grupos, tarefas de sincronização LDAP, dados de projeto (incluindo projetos, componentes, modelos, templates) e configurações dos serviços PLS e NIS (e, normalmente, uma gama de produtos e extensões adquiridos, bem como pacotes de implementação definidos para estes últimos). Um requisito essencial para garantir a integridade destes dados a longo prazo é efetuar cópias de segurança. A instalação padrão do Enterprise Server inclui uma ferramenta de cópia de segurança e restauro, acedida através da linha de comandos.
A localização predefinida da ferramenta de cópia de segurança é a pasta \Program Files (x86)\Altium\Altium365\Tools\BackupTool.
O nome da ferramenta de cópia de segurança é avbackup.exe.
-
Se a ferramenta avbackup.exe não se encontrar no caminho predefinido – \Program Files (x86)\Altium\Altium365\Tools\BackupTool – podem ocorrer erros/exceções durante um restauro.
-
A ferramenta autónoma Health Monitor tool (avhealth.exe) tem de estar fechada ao utilizar a Backup Tool (quer em modo de cópia de segurança quer de restauro), uma vez que ambas as ferramentas necessitam de acesso ao ficheiro da base de dados do Enterprise Server.
-
É altamente recomendável que os utilizadores não estejam ligados nem a utilizar o Workspace durante os processos de cópia de segurança e restauro, que requerem acesso à base de dados do Workspace. Como administrador do Workspace, pode forçar o encerramento de sessão dos utilizadores, se necessário, terminando a sessão atual do Workspace através da página Sessions da interface do browser (Admin – Sessions). Consulte a página Sessions para mais informações.
-
Restaurar uma cópia de segurança só é possível para a mesma versão do Enterprise Server a partir da qual essa cópia foi criada. Neste sentido, pode ser uma boa ideia guardar o instalador desse Enterprise Server, bem como os respetivos ficheiros de licença, com o arquivo Zip da cópia de segurança.
A ferramenta de cópia de segurança utiliza o Volume Shadow Copy Service (VSS) para criar uma cópia sombra do volume onde os dados do servidor estão localizados (também é suportada uma configuração em que as revisões são armazenadas num volume separado). Com o VSS, a ferramenta de cópia de segurança pára os serviços, cria uma cópia sombra, reinicia os serviços e depois efetua a cópia dos dados utilizando a cópia sombra criada. Esta abordagem minimiza o período de indisponibilidade do servidor (o período entre a paragem e o arranque dos serviços) e é utilizada por predefinição. Em caso de erro ao criar uma cópia sombra, a ferramenta de cópia de segurança utilizará uma abordagem sem criação de cópia sombra (que também pode ser ativada explicitamente através do parâmetro --skip-shadow-copy).
Aceder à Backup Tool
Para utilizar a ferramenta:
-
Abra a Linha de Comandos do Windows.
Tem de executar a Linha de Comandos em modo de administrador para poder utilizar a ferramenta de Cópia de Segurança e Restauro. Se não estiver a executar uma janela CMD como Administrador do Windows, ao tentar executar um comando para efetuar uma cópia de segurança ou restaurar o seu Enterprise Server, será apresentada a seguinte mensagem clara: Access Denied. Administrator permissions are needed to use the selected options. Use an administrator command prompt to complete these tasks.
-
Navegue até à pasta correta. Numa instalação predefinida na unidade C do computador anfitrião, será: cd C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\
-
Para executar a ferramenta e listar as opções disponíveis, escreva na linha de comandos: avbackup ?
Em algumas versões do Windows, não é possível colar numa Linha de Comandos com Ctrl+V, mas pode colar através do menu do botão direito. Copie primeiro as cadeias necessárias e depois cole utilizando esta técnica para poupar tempo e evitar erros.
Aceder à ferramenta de cópia de segurança através de uma Linha de Comandos (executada como administrador).
Note ?; ao incluí-lo, é apresentada ajuda sobre as funções disponíveis na ferramenta de cópia de segurança:
-
backup – fazer cópia de segurança dos dados para um arquivo ZIP.
-
restore – restaurar dados a partir de um arquivo ZIP. O Ponto de Restauro será criado automaticamente.
-
help – apresentar o ecrã de ajuda (? pode ser utilizado em vez da cadeia help).
Conteúdo do arquivo Zip
A ferramenta faz a cópia de segurança de todo o Enterprise Server e dos dados do utilizador, incluindo:
-
Cópia de segurança completa da base de dados, incluindo: todos os itens de dados (modelos, componentes, managed sheets, templates, designs libertados, etc.), utilizadores, grupos, instalações adquiridas através do Network Installation Service e definições de sincronização LDAP.
-
Todas as revisões do acima indicado.
-
Repositórios e designs do Workspace incluídos.
-
Índice de pesquisa.
-
Definições personalizadas pelo utilizador.
Sintaxe e parâmetros da cópia de segurança
Os seguintes parâmetros estão disponíveis ao utilizar a função de cópia de segurança da ferramenta:
avbackup backup -z [-t] [-h] [-i] [-m] [-d] [-c] [--split] [--skip-shadow-copy]
-
-z – caminho e nome do ficheiro zip de destino a criar. Coloque entre aspas se existirem espaços na cadeia. Este parâmetro é obrigatório.
-
-t, --test – se este parâmetro for especificado, o ficheiro zip será testado após a cópia de segurança.
-
-h, --hash – se este parâmetro for especificado, será criado um ficheiro de hash MD5 (*.md5).
-
-i – caminho completo para o ficheiro LocalVault.ini do Enterprise Server, que fornece informações sobre a localização dos dados do Enterprise Server a salvaguardar. O caminho predefinido deste ficheiro é C:\Program Files (x86)\Altium\Altium365\LocalVault.ini. Se este parâmetro não for especificado, a ferramenta tentará localizar o ficheiro automaticamente com base nesta localização de instalação predefinida. Coloque entre aspas se existirem espaços na cadeia.
-
-m – permite determinar se a operação de cópia de segurança deve ser executada em modo silencioso (-m silent, que é o modo predefinido), ou se deve surgir uma caixa de diálogo a pedir nova tentativa em caso de falha (-m dialog). Se este parâmetro não for especificado, será utilizado o modo silencioso.
-
-d, --debug – se este parâmetro for especificado, será utilizado o modo de depuração, o que permitirá criar mais registos para fins de diagnóstico e para partilha com os engenheiros da Altium.
-
-c – permite especificar o nível de compressão do ficheiro zip de destino. Utilize um número de 0 a 9. Também pode utilizar os seguintes valores:
-
Default – equivale ao nível de compressão 6 (utilizado se este parâmetro não for especificado)
-
None – equivale ao nível de compressão 0
-
BestSpeed – equivale ao nível de compressão 1
-
BestCompression – equivale ao nível de compressão 9.
-
--split – se este parâmetro for especificado, serão criados ficheiros zip separados para repositórios e revisões (sem compressão), além do ficheiro zip para os restantes dados.
-
--skip-shadow-copy – se este parâmetro for especificado, não será criada uma cópia sombra. Tenha em atenção que o período de indisponibilidade do servidor (o período entre a paragem e o arranque dos serviços) aumenta quando este parâmetro é utilizado.
Ao escrever apenas avbackup backup, estes parâmetros serão listados como ajuda útil.
Parâmetros disponíveis ao utilizar a ferramenta em modo de cópia de segurança.
Backup Example
A seguinte entrada fará silenciosamente uma cópia de segurança do Enterprise Server para o ficheiro com o nome 02102024_Backup.zip, gravando o ficheiro na pasta 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"
Quaisquer pastas especificadas têm de existir previamente. Além disso, os ficheiros existentes são substituídos se o novo ficheiro tiver o mesmo nome de um ficheiro já existente.
O resultado da execução do comando de exemplo de cópia de segurança.
Sintaxe e parâmetros do restauro
Os seguintes parâmetros estão disponíveis ao utilizar a função de restauro da ferramenta:
avbackup restore -z [--skip-backup] [-i] [-m] [-d] [-c] [--split] [--skip-shadow-copy]
-
-z – caminho e nome do ficheiro zip da cópia de segurança a partir do qual restaurar. Coloque entre aspas se existirem espaços na cadeia. Este parâmetro é obrigatório.
-
--skip-backup – permite ignorar a criação de um ponto de restauro antes de iniciar o restauro do Enterprise Server. Utilize-o com cuidado, pois se o restauro dos dados falhar, não será possível reverter.
-
-i – caminho completo para o ficheiro LocalVault.ini do Enterprise Server, que fornece informações sobre as localizações onde restaurar os dados do Enterprise Server. O caminho predefinido deste ficheiro é C:\Program Files (x86)\Altium\Altium365\LocalVault.ini. Se este parâmetro não for especificado, a ferramenta tentará localizar o ficheiro automaticamente com base nesta localização de instalação predefinida. Coloque entre aspas se existirem espaços na cadeia.
-
-m – permite determinar se a operação de restauro deve ser executada em modo silencioso (-m silent, que é o modo predefinido), ou se deve surgir uma caixa de diálogo a pedir nova tentativa em caso de falha (-m dialog). Se este parâmetro não for especificado, será utilizado o modo silencioso.
-
-d, --debug – se este parâmetro for especificado, será utilizado o modo de depuração, o que permitirá criar mais registos para fins de diagnóstico e para partilha com os engenheiros da Altium.
-
-c – permite especificar o nível de compressão do ficheiro zip de destino para o ponto de restauro (uma cópia de segurança da instalação atual do Enterprise Server). Utilize um número de 0 a 9. Também pode utilizar os seguintes valores:
-
Default – equivale ao nível de compressão 6 (utilizado se este parâmetro não for especificado)
-
None – equivale ao nível de compressão 0
-
BestSpeed – equivale ao nível de compressão 1
-
BestCompression – equivale ao nível de compressão 9.
-
--split – se este parâmetro for especificado, serão criados ficheiros zip separados para repositórios e revisões (sem compressão), além do ficheiro zip para os restantes dados, para o ponto de restauro (uma cópia de segurança da instalação atual do Enterprise Server).
-
--skip-shadow-copy – se este parâmetro for especificado, não será criada uma cópia sombra para o ponto de restauro (uma cópia de segurança da instalação atual do Enterprise Server). Tenha em atenção que o período de indisponibilidade do servidor (o período entre a paragem e o arranque dos serviços) aumenta quando este parâmetro é utilizado.
Ao escrever apenas avbackup restore, estes parâmetros serão listados como ajuda útil.
Parâmetros disponíveis ao utilizar a ferramenta em modo de restauro.
Se existir um ficheiro hash *.md5 para o ficheiro zip de cópia de segurança a partir do qual será efetuado o restauro (o ficheiro *.md5 está na mesma pasta que o ficheiro zip e tem o nome do ficheiro zip, ou seja, <ZipFileName>.zip.md5), o respetivo hash será verificado antes do restauro.
Restore Example
A entrada seguinte irá restaurar silenciosamente o Enterprise Server utilizando o ficheiro zip de cópia de segurança com o nome 30082022_Backup.zip, que está armazenado na pasta 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"
O resultado da execução do comando de restauro de exemplo. Repare que a ferramenta cria primeiro um ponto de restauro (uma cópia de segurança da instalação atual do Enterprise Server), antes de efetuar o restauro.
Ponto de Restauro
A ferramenta de cópia de segurança cria automaticamente um ponto de restauro antes de iniciar o restauro do Enterprise Server (se --skip-backup não tiver sido utilizado para o restauro). Para o fazer, a ferramenta de cópia de segurança executa uma cópia de segurança do Enterprise Server existente e copia o ZIP de restauro para a seguinte localização:
C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\Backups\
O ZIP recebe um nome no formato: Backup_<Date>_<Time>.zip.
Erros Durante a Cópia de Segurança ou o Restauro
Os erros que ocorrem durante uma cópia de segurança ou um restauro são apresentados diretamente na janela CMD, juntamente com a informação completa do caminho para o registo de erros:
C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\errors.log
Ao efetuar a cópia de segurança ou o restauro do seu Enterprise Server, os detalhes de quaisquer erros, bem como o caminho completo para o ficheiro errors.log, são apresentados diretamente na janela CMD.
Localizado por IA