Parent page: Instalar o Altium Infrastructure Server
Um Altium Infrastructure Server pode conter dados valiosos, incluindo utilizadores definidos, funções, tarefas de sincronização LDAP e configurações para os serviços PLS e NIS (e, tipicamente, um conjunto de produtos e extensões adquiridos, bem como pacotes de implementação definidos para estes últimos). Um requisito fundamental para garantir a integridade destes dados a longo prazo é efetuar a sua cópia de segurança. A instalação padrão do Altium Infrastructure Server inclui uma ferramenta de backup e restauro, acedida através de uma linha de comandos.
A localização predefinida da ferramenta de backup encontra-se na pasta \Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\.
O nome da ferramenta de backup é avbackup.exe.
Aceder à Ferramenta de Backup
Para utilizar a ferramenta:
-
Inicie uma Linha de Comandos do Windows.
Tem de executar a Linha de Comandos em modo de administrador para poder utilizar a ferramenta de Backup e Restauro. Se não estiver a executar uma linha de comandos CMD como Administrador do Windows, ao tentar executar um comando para fazer backup ou restaurar o seu Infrastructure 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. Para uma instalação predefinida na unidade C do computador anfitrião, esta será:
cd C:\Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\
-
Para executar a ferramenta e listar as opções disponíveis, escreva na linha de comandos:
avbackup ?
Embora não seja possível colar numa Linha de Comandos utilizando Ctrl+V, 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 backup através de uma Linha de Comandos (executada como administrador).
Repare no ?; ao incluí-lo, é apresentada ajuda sobre as funções disponíveis na ferramenta de backup:
-
backup - fazer backup 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 backup de todo o Infrastructure Server e dos dados do utilizador, incluindo:
-
Backup completo da base de dados, incluindo instalações adquiridas através do Network Installation Service e definições de sincronização LDAP.
-
Todas as revisões.
-
Índice de pesquisa.
-
Definições definidas pelo utilizador (personalizadas).
Sintaxe e Opções do Backup
As seguintes opções estão disponíveis ao utilizar a função de backup da ferramenta:
avbackup backup -z [-i] [-m]
-
-z - caminho e nome do ficheiro zip de destino a criar. Coloque entre aspas se existirem espaços na cadeia. Esta opção é obrigatória.
-
-i - caminho e localização do ficheiro LocalVault.ini, que detalha a localização atual do Altium Infrastructure Server a ser alvo de backup. A localização predefinida deste ficheiro é C:\Program Files (x86)\Altium\Altium Infrastructure Server\. Se esta opção não for especificada, a ferramenta tentará localizar automaticamente o ficheiro, com base nesta localização de instalação predefinida. Coloque entre aspas se existirem espaços na cadeia.
-
-m - permite-lhe determinar se a operação de backup deve ser executada em modo silencioso (-m silent)), ou se deve surgir uma caixa de diálogo a pedir para tentar novamente em caso de falha (-m dialog). Se esta opção não for especificada, será utilizado o modo silencioso.
Ao escrever apenas avbackup backup, estas opções serão listadas como ajuda útil.
Opções disponíveis ao utilizar a ferramenta em modo de backup.
Backup Example
A seguinte entrada fará silenciosamente o backup do Altium Infrastructure Server para o ficheiro com o nome 201704_Backup.zip, gravando o ficheiro na pasta C:\Backups\Altium Infrastructure Server\:
avbackup backup -z "C:\Backups\Altium Infrastructure Server\201704_Backup.zip" -i "C:\Program Files (x86)\Altium\Altium Infrastructure Server\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 backup de exemplo.
Sintaxe e Opções do Restauro
As seguintes opções estão disponíveis ao utilizar a função de restauro da ferramenta:
avbackup restore -z [-i] [-m]
-
-z - caminho e nome do ficheiro zip de backup a partir do qual restaurar. Coloque entre aspas se existirem espaços na cadeia. Esta opção é obrigatória.
-
-i - caminho e localização do ficheiro LocalVault.ini, que detalha a localização para onde restaurar o Altium Infrastructure Server. A localização predefinida deste ficheiro é C:\Program Files (x86)\Altium\Altium Infrastructure Server\. Se esta opção não for especificada, a ferramenta tentará localizar automaticamente o ficheiro, com base nesta localização de instalação predefinida. Coloque entre aspas se existirem espaços na cadeia.
-
-m - permite-lhe 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 para tentar novamente em caso de falha (-m dialog). Se esta opção não for especificada, será utilizado o modo silencioso.
Ao escrever apenas avbackup restore, estas opções serão listadas como ajuda útil.
Opções disponíveis ao utilizar a ferramenta em modo de restauro.
Restore Example
A seguinte entrada restaurará silenciosamente o Altium Infrastructure Server utilizando o ficheiro zip de backup com o nome 201704_Backup.zip, gravando o ficheiro na pasta C:\Backups\Altium Infrastructure Server\:
avbackup restore -z "C:\Backups\Altium Infrastructure Server\201704_Backup.zip" -i "C:\Program Files (x86)\Altium\Altium Infrastructure Server\LocalVault.ini"
O resultado da execução do comando de restauro de exemplo. Repare que a ferramenta cria primeiro um ponto de restauro (um backup da instalação atual do Altium Infrastructure Server), antes de efetuar o restauro.
Ponto de Restauro
A ferramenta de backup cria automaticamente um ponto de restauro antes de iniciar o restauro do Infrastructure Server. Para o fazer, a ferramenta de backup executa um backup do Infrastructure Server existente e copia o ZIP de restauro para a seguinte localização:
C:\Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\Backups\
O ZIP recebe um nome no formato: Backup_<Date>_<Time>.zip.
Erros Durante o Backup ou Restauro
Os erros que ocorrem durante um backup ou 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\Altium Infrastructure Server\Tools\BackupTool\errors.log
Ao fazer backup ou restaurar o seu Infrastructure Server, os detalhes de quaisquer erros, bem como o caminho completo para o ficheiro errors.log, são apresentados diretamente na janela CMD.