Criar Cópias de Segurança e Restaurar a Sua Instalação

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.

Aceder à Backup Tool

Para utilizar a ferramenta:

1. 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.

2. 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\

3. Para executar a ferramenta e listar as opções disponíveis, escreva na linha de comandos: avbackup ?

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.

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.

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.