Parent page: Installazione di Altium Infrastructure Server
Un Altium Infrastructure Server può contenere dati preziosi, inclusi utenti definiti, ruoli, attività di sincronizzazione LDAP e configurazioni per i servizi PLS e NIS (e in genere una gamma di prodotti ed estensioni acquisiti, nonché pacchetti di distribuzione definiti per questi ultimi). Un requisito fondamentale per garantire l'integrità a lungo termine di questi dati è eseguirne il backup. L'installazione standard di Altium Infrastructure Server include uno strumento di backup e ripristino, accessibile tramite prompt dei comandi.
La posizione predefinita dello strumento di backup si trova nella cartella \Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\.
Il nome dello strumento di backup è avbackup.exe.
Accesso allo strumento di backup
Per utilizzare lo strumento:
-
Avviare un prompt dei comandi di Windows.
È necessario eseguire il Command Prompt in modalità amministratore per poter utilizzare lo strumento di Backup e Ripristino. Se il prompt CMD non viene eseguito come amministratore di Windows, il tentativo di eseguire un comando per il backup o il ripristino dell'Infrastructure Server produrrà il seguente messaggio esplicito: Access Denied. Administrator permissions are needed to use the selected options. Use an administrator command prompt to complete these tasks.
-
Passare alla cartella corretta. Per un'installazione predefinita sull'unità C del computer host, sarà:
cd C:\Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\
-
Per eseguire lo strumento ed elencare le opzioni disponibili, al prompt digitare:
avbackup ?
Anche se non è possibile incollare in un prompt dei comandi usando Ctrl+V, è possibile incollare tramite il menu del tasto destro. Copiare prima le stringhe richieste, quindi incollarle con questa tecnica per risparmiare tempo ed evitare errori.
Accesso allo strumento di backup tramite un prompt dei comandi (eseguito come amministratore).
Si noti ?; includerlo visualizza la guida sulle funzioni disponibili nello strumento di backup:
-
backup - esegue il backup dei dati in un archivio ZIP.
-
restore - ripristina i dati da un archivio ZIP. Il punto di ripristino verrà creato automaticamente.
-
help - visualizza la schermata della guida (? può essere usato al posto della stringa help).
Contenuto dell'archivio ZIP
Lo strumento esegue il backup dell'intero Infrastructure Server e dei dati utente, inclusi:
-
Backup completo del database, incluse le installazioni acquisite tramite il Network Installation Service e le impostazioni di sincronizzazione LDAP.
-
Tutte le revisioni.
-
Indice di ricerca.
-
Impostazioni definite dall'utente (personalizzate).
Sintassi e opzioni del backup
I seguenti switch sono disponibili quando si utilizza la funzione di backup dello strumento:
avbackup backup -z [-i] [-m]
-
-z - percorso e nome file del file zip di destinazione da creare. Racchiudere tra virgolette se la stringa contiene spazi. Questo switch è obbligatorio.
-
-i - percorso e posizione del file LocalVault.ini, che specifica la posizione corrente di Altium Infrastructure Server di cui eseguire il backup. La posizione predefinita di questo file è C:\Program Files (x86)\Altium\Altium Infrastructure Server\. Se questo switch non viene specificato, lo strumento tenterà di trovare automaticamente il file in base a questa posizione di installazione predefinita. Racchiudere tra virgolette se la stringa contiene spazi.
-
-m - consente di determinare se l'operazione di backup deve essere eseguita in modalità silenziosa (-m silent)) oppure se deve comparire una finestra di dialogo che chieda di riprovare in caso di errore (-m dialog). Se questo switch non viene specificato, verrà utilizzata la modalità silenziosa.
Digitando semplicemente avbackup backup, questi switch verranno elencati come utile riferimento.
Switch disponibili quando si utilizza lo strumento in modalità backup.
Backup Example
La seguente voce eseguirà silenziosamente il backup di Altium Infrastructure Server nel file denominato 201704_Backup.zip, scrivendo il file nella cartella 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"
Tutte le cartelle specificate devono già esistere. Inoltre, i file esistenti vengono sovrascritti se il nuovo file ha lo stesso nome di un file esistente.
Il risultato dell'esecuzione del comando di backup di esempio.
Sintassi e opzioni del ripristino
I seguenti switch sono disponibili quando si utilizza la funzione di ripristino dello strumento:
avbackup restore -z [-i] [-m]
-
-z - percorso e nome file del file zip di backup da cui eseguire il ripristino. Racchiudere tra virgolette se la stringa contiene spazi. Questo switch è obbligatorio.
-
-i - percorso e posizione del file LocalVault.ini, che specifica la posizione in cui ripristinare Altium Infrastructure Server. La posizione predefinita di questo file è C:\Program Files (x86)\Altium\Altium Infrastructure Server\. Se questo switch non viene specificato, lo strumento tenterà di trovare automaticamente il file in base a questa posizione di installazione predefinita. Racchiudere tra virgolette se la stringa contiene spazi.
-
-m - consente di determinare se l'operazione di ripristino deve essere eseguita in modalità silenziosa (-m silent, che è la modalità predefinita), oppure se deve comparire una finestra di dialogo che chieda di riprovare in caso di errore (-m dialog). Se questo switch non viene specificato, verrà utilizzata la modalità silenziosa.
Digitando semplicemente avbackup restore, questi switch verranno elencati come utile riferimento.
Switch disponibili quando si utilizza lo strumento in modalità ripristino.
Restore Example
La seguente voce ripristinerà silenziosamente Altium Infrastructure Server utilizzando il file zip di backup denominato 201704_Backup.zip, scrivendo il file nella cartella 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"
Il risultato dell'esecuzione del comando di ripristino di esempio. Si noti che lo strumento crea prima un punto di ripristino (un backup dell'installazione corrente di Altium Infrastructure Server), prima di eseguire il ripristino.
Punto di ripristino
Lo strumento di backup crea automaticamente un punto di ripristino prima di iniziare il ripristino dell'Infrastructure Server. Per farlo, lo strumento di backup esegue un backup dell'Infrastructure Server esistente e copia il file ZIP di ripristino nella seguente posizione:
C:\Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\Backups\
Il file ZIP viene denominato nel formato: Backup_<Date>_<Time>.zip.
Errori durante il backup o il ripristino
Gli errori che si verificano durante un backup o un ripristino vengono presentati direttamente nella finestra CMD, insieme alle informazioni complete sul percorso del log degli errori:
C:\Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\errors.log
Durante il backup o il ripristino dell'Infrastructure Server, i dettagli di eventuali errori, così come il percorso completo del file errors.log, vengono presentati direttamente nella finestra CMD.