Backup e ripristino dell’installazione

Un Workspace di Enterprise Server può contenere un’ampia gamma di dati di valore, inclusi utenti definiti, gruppi, attività di sincronizzazione LDAP, dati di progettazione (inclusi progetti, componenti, modelli, template) 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 Enterprise 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\Altium365\Tools\BackupTool.

Il nome dello strumento di backup è avbackup.exe.

Accesso al Backup Tool

Per utilizzare lo strumento:

1. Avvia un Prompt dei comandi di Windows.

   Devi eseguire il Prompt dei comandi in modalità amministratore per poter utilizzare lo strumento di Backup e Restore. Se non stai eseguendo un prompt CMD come amministratore di Windows, il tentativo di eseguire un comando relativo al backup o al ripristino del tuo Enterprise Server produrrà il chiaro messaggio: Access Denied. Administrator permissions are needed to use the selected options. Use an administrator command prompt to complete these tasks.

2. Passa alla cartella corretta. Per un’installazione predefinita sull’unità C del computer host, sarà: cd C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\

3. Per eseguire lo strumento e visualizzare le opzioni disponibili, al prompt digita: avbackup ?

Accesso allo strumento di backup tramite Prompt dei comandi (eseguito come amministratore).

Nota ?, 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 Restore Point 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 Enterprise Server e dei dati utente, inclusi:

• Backup completo del database, inclusi: tutti gli elementi dati (modelli, componenti, managed sheet, template, progetti rilasciati, ecc.), utenti, gruppi, installazioni acquisite tramite il Network Installation Service e impostazioni di sincronizzazione LDAP.

• Tutte le revisioni di quanto sopra.

• Repository e progetti Workspace inclusi.

• Indice di ricerca.

• Impostazioni definite dall’utente (personalizzate).

Sintassi del backup e switch

I seguenti switch sono disponibili quando si utilizza la funzione di backup dello strumento:

avbackup backup -z [-t] [-h] [-i] [-m] [-d] [-c] [--split] [--skip-shadow-copy]

• -z – percorso e nome file del file zip di destinazione da creare. Racchiudere tra virgolette se la stringa contiene spazi. Questo switch è obbligatorio.

• -t, --test – se questo switch è specificato, il file zip verrà testato dopo il backup.

• -h, --hash – se questo switch è specificato, verrà creato un file hash MD5 (*.md5).

• -i – percorso completo del file LocalVault.ini di Enterprise Server, che fornisce le informazioni sulla posizione dei dati per l’Enterprise Server di cui eseguire il backup. Il percorso predefinito di questo file è C:\Program Files (x86)\Altium\Altium365\LocalVault.ini. Se questo switch non è 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 debba essere eseguita in modalità silenziosa (-m silent, che è la modalità predefinita), oppure se debba comparire una finestra di dialogo che chieda di riprovare in caso di errore (-m dialog). Se questo switch non è specificato, verrà utilizzata la modalità silenziosa.

• -d, --debug – se questo switch è specificato, verrà utilizzata la modalità debug, che consentirà di creare più log a scopo diagnostico e per la condivisione con gli ingegneri Altium.

• -c – consente di specificare il livello di compressione del file zip di destinazione. Usa un numero da 0 a 9. Puoi anche usare i seguenti valori:

  • Default – equivale al livello di compressione 6 (utilizzato se questo switch non è specificato)

  • None – equivale al livello di compressione 0

  • BestSpeed – equivale al livello di compressione 1

  • BestCompression – equivale al livello di compressione 9.

• --split – se questo switch è specificato, verranno creati file zip separati per repository e revisioni (senza compressione), oltre al file zip per gli altri dati.

• --skip-shadow-copy – se questo switch è specificato, non verrà creata una copia shadow. Nota che il tempo di inattività del server (il periodo compreso tra l’arresto e il riavvio dei servizi) aumenta quando viene utilizzato questo switch.

Digitando semplicemente avbackup backup, questi switch verranno elencati come utile riferimento.

Switch disponibili quando si utilizza lo strumento in modalità backup.

Sintassi del ripristino e switch

I seguenti switch sono disponibili quando si utilizza la funzione di ripristino dello strumento:

avbackup restore -z [--skip-backup] [-i] [-m] [-d] [-c] [--split] [--skip-shadow-copy]

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

• --skip-backup – consente di saltare la creazione di un restore point prima di iniziare il ripristino di Enterprise Server. Usalo con cautela, poiché se il ripristino dei dati fallisce non sarà possibile tornare indietro.

• -i – percorso completo del file LocalVault.ini di Enterprise Server, che fornisce informazioni sulle posizioni in cui ripristinare i dati di Enterprise Server. Il percorso predefinito di questo file è C:\Program Files (x86)\Altium\Altium365\LocalVault.ini. Se questo switch non è 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 debba essere eseguita in modalità silenziosa (-m silent, che è la modalità predefinita), oppure se debba comparire una finestra di dialogo che chieda di riprovare in caso di errore (-m dialog). Se questo switch non è specificato, verrà utilizzata la modalità silenziosa.

• -d, --debug – se questo switch è specificato, verrà utilizzata la modalità debug, che consentirà di creare più log a scopo diagnostico e per la condivisione con gli ingegneri Altium.

• -c – consente di specificare il livello di compressione del file zip di destinazione per il restore point (un backup dell’installazione corrente di Enterprise Server). Usa un numero da 0 a 9. Puoi anche usare i seguenti valori:

  • Default – equivale al livello di compressione 6 (utilizzato se questo switch non è specificato)

  • None – equivale al livello di compressione 0

  • BestSpeed – equivale al livello di compressione 1

  • BestCompression – equivale al livello di compressione 9.

• --split – se questo switch è specificato, verranno creati file zip separati per repository e revisioni (senza compressione), oltre al file zip per gli altri dati, per il restore point (un backup dell’installazione corrente di Enterprise Server).

• --skip-shadow-copy–  se viene specificato questo switch, non verrà creata una copia shadow per il punto di ripristino (un backup dell’installazione corrente di Enterprise Server). Si noti che il tempo di inattività del server (il periodo tra l’arresto e il riavvio dei servizi) aumenta quando viene utilizzato questo switch.

Digitando semplicemente avbackup restore, questi switch verranno elencati come utile riferimento.

Switch disponibili quando si utilizza lo strumento in modalità di ripristino.

Punto di ripristino

Lo strumento di backup crea automaticamente un punto di ripristino prima di iniziare il ripristino di Enterprise Server (se --skip-backup non è stato utilizzato per il ripristino). Per farlo, lo strumento di backup esegue un backup dell’istanza esistente di Enterprise Server e copia il file ZIP di ripristino nel seguente percorso:

C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\Backups\

Il file ZIP viene denominato nel formato: Backup_<Date>_<Time>.zip.

Registrazione di backup e ripristino

Le informazioni sugli eventi durante un backup o un ripristino vengono visualizzate direttamente nella finestra CMD e possono anche essere trovate nel file di log:

C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\avbackup.log

Se si verifica un errore durante un backup o un ripristino, tutte le informazioni relative possono essere trovate anche nel file di log ().