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.
-
Se lo strumento avbackup.exe non si trova nel percorso predefinito – \Program Files (x86)\Altium\Altium365\Tools\BackupTool – durante un ripristino potrebbero verificarsi errori/eccezioni.
-
Lo strumento standalone Health Monitor (avhealth.exe) deve essere chiuso quando si utilizza il Backup Tool (sia in modalità backup sia restore), poiché entrambi gli strumenti richiedono l’accesso al file di database di Enterprise Server.
-
Si raccomanda vivamente che gli utenti non siano connessi né utilizzino il Workspace durante i processi di backup e ripristino, che richiedono l’accesso al database del Workspace. In qualità di amministratore del Workspace, se necessario puoi disconnettere forzatamente gli utenti terminando la loro sessione corrente del Workspace tramite la pagina Sessions dell’interfaccia browser (Admin – Sessions). Per ulteriori informazioni, consulta la pagina Sessions.
-
Il ripristino di un backup è possibile solo sulla stessa versione di Enterprise Server da cui quel backup è stato creato. A questo proposito, può essere una buona idea conservare con l’archivio Zip di backup il programma di installazione di quell’Enterprise Server e i file di licenza corrispondenti.
Il processo di backup/ripristino reimposta anche il conteggio delle transazioni del database. Lo stato corrente del conteggio delle transazioni del server può essere verificato utilizzando lo strumento Health Monitor (fare riferimento alla voce Transaction count nella sezione DATABASE della finestra dello strumento).
Lo strumento di backup utilizza il Volume Shadow Copy Service (VSS) per creare una copia shadow del volume in cui si trovano i dati del server (è supportata anche una configurazione in cui le revisioni sono archiviate su un volume separato). Con VSS, lo strumento di backup arresta i servizi, crea una copia shadow, riavvia i servizi e quindi esegue il backup dei dati utilizzando la copia shadow creata. Questo approccio riduce al minimo il periodo di inattività del server (il periodo compreso tra l’arresto e il riavvio dei servizi) ed è utilizzato per impostazione predefinita. In caso di errore durante la creazione di una copia shadow, lo strumento di backup utilizzerà un approccio senza creare una copia shadow (che può anche essere abilitato esplicitamente usando lo switch --skip-shadow-copy).
Accesso al Backup Tool
Per utilizzare lo strumento:
-
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.
-
Passa alla cartella corretta. Per un’installazione predefinita sull’unità C del computer host, sarà: cd C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\
-
Per eseguire lo strumento e visualizzare le opzioni disponibili, al prompt digita: avbackup ?
In alcune versioni di Windows, non è possibile incollare in un Prompt dei comandi usando Ctrl+V, ma è possibile incollare tramite il menu del tasto destro. Copia prima le stringhe richieste, quindi incollale con questa tecnica per risparmiare tempo ed evitare errori.
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.
Backup Example
La seguente voce eseguirà silenziosamente il backup di Enterprise Server nel file denominato 02102024_Backup.zip, scrivendo il file nella cartella 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"
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 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.
Se esiste un file hash *.md5 per il file zip di backup da cui eseguire il ripristino (il file *.md5 si trova nella stessa cartella del file zip e prende il nome dal file zip, cioè <ZipFileName>.zip.md5), il relativo hash verrà verificato prima del ripristino.
Restore Example
La seguente voce ripristinerà in modo silenzioso Enterprise Server utilizzando il file zip di backup denominato 30082022_Backup.zip, archiviato nella cartella 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"
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 Enterprise Server), prima di eseguire il 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 (
).
Localizzato tramite A