Parent page: Installation d’Altium Infrastructure Server
Un Altium Infrastructure Server peut contenir des données précieuses, notamment les utilisateurs définis, les rôles, les tâches de synchronisation LDAP et les configurations des services PLS et NIS (ainsi que, généralement, une gamme de produits et d’extensions acquis, et les packages de déploiement définis pour ces derniers). Une exigence essentielle pour garantir l’intégrité à long terme de ces données est d’en effectuer une sauvegarde. L’installation standard d’Altium Infrastructure Server inclut un outil de sauvegarde et de restauration, accessible via une invite de commande.
L’emplacement par défaut de l’outil de sauvegarde se trouve dans le dossier \Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\.
Le nom de l’outil de sauvegarde est avbackup.exe.
Accès à l’outil de sauvegarde
Pour utiliser l’outil :
-
Lancez une invite de commande Windows.
Vous devez exécuter l’invite de commande en mode administrateur pour pouvoir utiliser l’outil de sauvegarde et de restauration. Si vous n’exécutez pas une invite CMD en tant qu’administrateur Windows, toute tentative d’exécuter une commande de sauvegarde ou de restauration de votre Infrastructure Server entraînera l’affichage du message explicite suivant : Access Denied. Administrator permissions are needed to use the selected options. Use an administrator command prompt to complete these tasks.
-
Accédez au dossier approprié. Pour une installation par défaut sur le lecteur C de l’ordinateur hôte, il s’agira de :
cd C:\Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\
-
Pour exécuter l’outil et afficher les options disponibles, saisissez à l’invite :
avbackup ?
Bien qu’il ne soit pas possible de coller dans une invite de commande à l’aide de Ctrl+V, vous pouvez coller via le menu contextuel obtenu par clic droit. Copiez d’abord les chaînes requises, puis collez-les à l’aide de cette méthode afin de gagner du temps et d’éviter les erreurs.
Accès à l’outil de sauvegarde via une invite de commande (exécutée en tant qu’administrateur).
Notez l’option ? ; son inclusion affiche l’aide sur les fonctions disponibles dans l’outil de sauvegarde :
-
backup - sauvegarder les données dans une archive ZIP.
-
restore - restaurer les données à partir d’une archive ZIP. Le point de restauration sera créé automatiquement.
-
help - afficher l’écran d’aide (? peut être utilisé à la place de la chaîne help).
Contenu de l’archive ZIP
L’outil sauvegarde l’intégralité de l’Infrastructure Server et des données utilisateur, y compris :
-
Une sauvegarde complète de la base de données, y compris les installations acquises via le Network Installation Service et les paramètres LDAP Synch.
-
Toutes les révisions.
-
L’index de recherche.
-
Les paramètres définis par l’utilisateur (personnalisés).
Syntaxe et commutateurs de sauvegarde
Les commutateurs suivants sont disponibles lors de l’utilisation de la fonction de sauvegarde de l’outil :
avbackup backup -z [-i] [-m]
-
-z - chemin et nom de fichier du fichier zip cible à créer. Mettez entre guillemets s’il y a des espaces dans la chaîne. Ce commutateur est obligatoire.
-
-i - chemin et emplacement du fichier LocalVault.ini, qui détaille l’emplacement actuel d’Altium Infrastructure Server à sauvegarder. L’emplacement par défaut de ce fichier est C:\Program Files (x86)\Altium\Altium Infrastructure Server\. Si ce commutateur n’est pas spécifié, l’outil tentera de trouver automatiquement le fichier, en se basant sur cet emplacement d’installation par défaut. Mettez entre guillemets s’il y a des espaces dans la chaîne.
-
-m - vous permet de déterminer si l’opération de sauvegarde doit s’exécuter en mode silencieux (-m silent)) ou si une boîte de dialogue doit s’afficher pour proposer une nouvelle tentative en cas d’échec (-m dialog). Si ce commutateur n’est pas spécifié, le mode silencieux sera utilisé.
En saisissant simplement avbackup backup, ces commutateurs seront listés à titre d’aide.
Commutateurs disponibles lors de l’utilisation de l’outil en mode sauvegarde.
Backup Example
L’entrée suivante sauvegardera silencieusement Altium Infrastructure Server dans le fichier nommé 201704_Backup.zip, en écrivant le fichier dans le dossier 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"
Tous les dossiers spécifiés doivent déjà exister. De plus, les fichiers existants sont écrasés si le nouveau fichier porte le même nom qu’un fichier existant.
Résultat de l’exécution de l’exemple de commande de sauvegarde.
Syntaxe et commutateurs de restauration
Les commutateurs suivants sont disponibles lors de l’utilisation de la fonction de restauration de l’outil :
avbackup restore -z [-i] [-m]
-
-z - chemin et nom de fichier du fichier zip de sauvegarde à partir duquel restaurer. Mettez entre guillemets s’il y a des espaces dans la chaîne. Ce commutateur est obligatoire.
-
-i - chemin et emplacement du fichier LocalVault.ini, qui détaille l’emplacement dans lequel restaurer Altium Infrastructure Server. L’emplacement par défaut de ce fichier est C:\Program Files (x86)\Altium\Altium Infrastructure Server\. Si ce commutateur n’est pas spécifié, l’outil tentera de trouver automatiquement le fichier, en se basant sur cet emplacement d’installation par défaut. Mettez entre guillemets s’il y a des espaces dans la chaîne.
-
-m - vous permet de déterminer si l’opération de restauration doit s’exécuter en mode silencieux (-m silent, qui est le mode par défaut), ou si une boîte de dialogue doit s’afficher pour proposer une nouvelle tentative en cas d’échec (-m dialog). Si ce commutateur n’est pas spécifié, le mode silencieux sera utilisé.
En saisissant simplement avbackup restore, ces commutateurs seront listés à titre d’aide.
Commutateurs disponibles lors de l’utilisation de l’outil en mode restauration.
Restore Example
L’entrée suivante restaurera silencieusement Altium Infrastructure Server à l’aide du fichier zip de sauvegarde nommé 201704_Backup.zip, en écrivant le fichier dans le dossier 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"
Résultat de l’exécution de l’exemple de commande de restauration. Notez que l’outil crée d’abord un point de restauration (une sauvegarde de l’installation actuelle d’Altium Infrastructure Server), avant d’effectuer la restauration.
Point de restauration
L’outil de sauvegarde crée automatiquement un point de restauration avant de commencer à restaurer l’Infrastructure Server. Pour ce faire, l’outil de sauvegarde effectue une sauvegarde de l’Infrastructure Server existant et copie le ZIP de restauration à l’emplacement suivant :
C:\Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\Backups\
Le ZIP est nommé selon le format suivant : Backup_<Date>_<Time>.zip.
Erreurs lors de la sauvegarde ou de la restauration
Les erreurs qui surviennent lors d’une sauvegarde ou d’une restauration sont présentées directement dans la fenêtre CMD, avec les informations complètes du chemin vers le journal des erreurs :
C:\Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\errors.log
Lors de la sauvegarde ou de la restauration de votre Infrastructure Server, les détails de toute erreur, ainsi que le chemin complet vers le fichier errors.log, sont affichés directement dans la fenêtre CMD.