Restauration

Parent page: Altium On-Prem Enterprise Server avec backend Oracle

Ce document s’adresse à un administrateur informatique qui restaure les données de son Altium On-Prem Enterprise Server lorsque l’Enterprise Server utilise un backend de base de données Oracle. Il contient des détails sur l’Enterprise Server, sa procédure de restauration dans le contexte d’une utilisation d’Oracle, des informations importantes sur les exigences système, ainsi qu’un exemple décrivant la restauration des données sur la plateforme Microsoft Windows.

Vue d’ensemble du processus de restauration

La restauration de l’Enterprise Server lors de l’utilisation d’un backend Oracle dépend de la manière dont votre entreprise gère ses bases de données Oracle. Certaines entreprises exécutent des bases de données Oracle sur des systèmes d’exploitation Windows Server, tandis que d’autres disposent de centres de données Oracle complets. Le processus de restauration comporte généralement trois étapes, comme illustré dans l’image suivante.

Vue d’ensemble de haut niveau de la procédure de restauration de l’Enterprise Server et de la base de données Oracle.

Hypothèses retenues dans ce document

Bien que les configurations Oracle puissent varier d’un site à l’autre, les hypothèses suivantes sont retenues dans tout ce document :

1. Une sauvegarde complète des données de l’Enterprise Server et du dump de données Oracle associé a été effectuée comme indiqué dans le document Sauvegarde d’Altium On-Prem Enterprise Server avec un backend Oracle.
2. La restauration est effectuée par un administrateur informatique. Au minimum, l’utilisateur qui effectue la restauration de l’Enterprise Server doit disposer de droits d’administration sur la machine hôte.
3. Un administrateur de base de données (DBA) doit être présent pour effectuer l’importation des données Oracle. Au minimum, l’utilisateur qui suit ce guide doit disposer d’un accès complet en lecture/écriture pour importer et modifier la base de données Oracle de l’entreprise.
4. Ce guide suppose qu’il existe déjà une installation de l’Enterprise Server, configurée et fonctionnelle avec un backend Oracle. (Voir la section d’exemple pour plus de détails sur la gestion d’un environnement dans lequel un nouvel Enterprise Server est déployé sur une machine et les données sont importées dans cette instance d’Enterprise Server).
5. Le schéma Oracle et les identifiants de l’application Oracle utilisés sur les serveurs Oracle source et destination doivent être identiques.

Vue d’ensemble de haut niveau de l’architecture de l’Enterprise Server

Comme d’autres logiciels conçus pour fonctionner sous Microsoft Windows, l’Enterprise Server est une application serveur multithread et multiservice. Comme ce document se concentre uniquement sur les parties de l’Enterprise Server susceptibles d’interagir avec une base de données Oracle, l’image suivante est simplifiée afin de représenter l’architecture backend globale de l’Enterprise Server.

Vue d’ensemble de haut niveau de l’architecture de l’Enterprise Server. Les stockages backend de l’Enterprise Server contiennent la majeure partie des données binaires du client, tandis que les services Windows constituent un ensemble de services de prise en charge.

Ce document se concentre sur les stockages backend, car les données contenues dans ce bloc sont celles qui sont sauvegardées, potentiellement migrées vers une autre machine, puis restaurées sur la même machine ou sur une machine différente. Dans les stockages backend, on trouve les éléments suivants :

• Databases – contient des métadonnées telles que l’association entre empreinte de composant et symbole schématique, des paramètres, des chemins de fichiers, des liens vers des sources de données de chaîne d’approvisionnement des composants, et plus encore. Ces informations peuvent résider dans une base de données Firebird ou Oracle.
• File Storage – cette zone de stockage de fichiers contient les données binaires dans le dépôt VCS de l’Enterprise Server. Ces données binaires comprennent des informations telles que des documents de projet PCB et schématique, des empreintes, des symboles, des documents Draftsman et d’autres documents natifs ou non natifs de l’Enterprise Server.

Vue d’ensemble de haut niveau de l’outil de restauration Altium

L’outil de restauration Altium s’appelle avbackup.exe. Il s’agit du même utilitaire utilisé à des fins de sauvegarde et de restauration avec l’Enterprise Server. Il s’agit d’un utilitaire en ligne de commande que les administrateurs informatiques peuvent exécuter pour restaurer les données de leur Enterprise Server. avbackup.exe est le même utilitaire utilisé à des fins de restauration lorsque l’Enterprise Server est configuré avec un backend de base de données Firebird par défaut, ou lorsqu’une base de données Oracle est utilisée comme backend.

Lors de l’utilisation de avbackup.exe sur une implémentation d’Enterprise Server qui utilise une base de données Oracle, les administrateurs doivent garder à l’esprit les points suivants :

1. avbackup.exeNOT ne prend pas en charge la restauration des métadonnées de votre Enterprise Server vers une base de données Oracle. Cette fonctionnalité fonctionne uniquement sur les implémentations d’Enterprise Server utilisant un backend de base de données Firebird qui a été configuré automatiquement à l’origine par le programme d’installation de l’Enterprise Server.
2. avbackup.exe accepte le fichier Zip qu’il génère lorsqu’il est utilisé comme outil de sauvegarde. Ce fichier Zip contient toutes les données binaires de l’Enterprise Server.avbackup.exeL’Enterprise Server doit être en cours d’exécution.

arrêtera automatiquement tous les services de l’Enterprise Server (y compris les services IIS) pendant la restauration des données, puis redémarrera tous les services qu’il a arrêtés après une restauration réussie.

Exemple de restauration des données de l’Enterprise Server avec backend Oracle sur la plateforme Windows

Les administrateurs informatiques plus avancés peuvent également écrire des fichiers batch qui exécutent automatiquement la procédure suivante.

• Éléments requis
• Instance fonctionnelle préexistante de l’Enterprise Server avec backend Oracle.Dossiers et sources de données préexistants :
  • Les dossiers dans lesquels seront situées vos données Enterprise Server et Oracle doivent déjà exister et contenir une copie de votre fichier zip de sauvegarde de l’Enterprise Server et du fichier Oracle .DMP.
• Accès administrateur à la machine hôte de l’Enterprise Server. Cela est nécessaire pour exécuter correctement l’utilitaire de commande de sauvegarde de l’Enterprise Server (avbackup.exe).
• Accès DBA approprié au serveur Oracle (c’est-à-dire ajouter le compte Windows de l’utilisateur au rôle sysDBA dans l’environnement Windows).

Procédure de restauration

1. Si aucune instance préexistante de l’Enterprise Server avec backend Oracle n’a été configurée, veuillez lire le document Installation d’Altium On-Prem Enterprise Server avec un backend Oracle pour un exemple de configuration de l’Enterprise Server utilisant un backend Oracle sur une nouvelle machine.
2. À ce stade, vous devriez déjà disposer d’une instance existante de l’Enterprise Server avec Oracle, soit à la suite d’une nouvelle installation, soit d’une installation précédente.
3. Sur la machine hôte de l’Enterprise Server :
   1. Créez un dossier de restauration (il est utile d’avoir des chemins de fichiers communs, par exemple : C:\Backups). Placez le fichier Zip de sauvegarde de l’Enterprise Server dans ce dossier.
   2. Restaurez les données de votre Enterprise Server en exécutant l’outil avbackup.exe en tant qu’administrateur. L’outil se trouve dans le dossier C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool.
   3. Arrêtez les services IIS de l’Enterprise Server, ou arrêtez la machine hôte de l’Enterprise Server. Cela empêchera toute opération d’écriture involontaire dans votre base de données Oracle par les services de l’Enterprise Server.

4. Sur la machine hôte de la base de données Oracle :
   1. Créez un dossier de restauration et placez le fichier Oracle .dmp dans ce dossier (il est utile d’avoir des chemins de fichiers communs, par exemple : C:\Backups).
   2. Supprimez le schéma et le compte utilisateur existants de la base de données Oracle.

La suppression d’un compte utilisateur Oracle et de son schéma associé peut être effectuée comme suit. Pour cet exemple, nous allons supprimer le compte utilisateur existant AESUSER313 et son schéma associé d’une base de données Oracle sous Microsoft Windows :

1. Ouvrez une invite de commande avec des privilèges administrateur.
2. Arrêtez les services IIS s’ils sont présents sur la machine Oracle à l’aide de la commande : net stop WAS, puis appuyez sur Y et sur Entrée.
3. Connectez-vous à la base de données Oracle en lançant une session SqlPlus :

sqlplus / as sysdba

shutdown immediate;

startup restrict;

4. Supprimez le schéma associé à l’Enterprise Server (dans cet exemple, AESUSER313 est le nom du schéma que nous voulons supprimer) :

drop user AESUSER313 cascade;

5. Réactivez ensuite la base de données normalement, soit en redémarrant la machine, soit à l’aide des commandes suivantes :

shutdown immediate;

startup;

3. Créez un schéma identique sur le serveur Oracle et attribuez-lui des droits élevés :
   1. Ouvrez la ligne de commande en tant qu’administrateur et tapez :

sqlplus / as sysdba;

CREATE user AESUSER313 identified by “Altium”;

GRANT ALL PRIVILEGES TO AESUSER313;

GRANT IMP_FULL_DATABASE TO AESUSER313;

2. Vous pouvez également accorder temporairement le rôle DBA à cet utilisateur, importer les fichiers, puis révoquer ce privilège comme indiqué ci-dessous :

GRANT DBA TO AESUSER313;

3. Après avoir importé la base de données avec succès, révoquez les privilèges DBA :

revoke DBA from AESUSER313;

4. Restaurez les données Oracle (cette section suppose que le compte utilisateur et les schémas portent tous deux le nom AESUSER313 et ont pour mot de passe Altium) :
   1. Ouvrez une invite de commande avec des privilèges administrateur
   2. Arrêtez les serveurs IIS à l’aide de la commande :

net stop WAS

3. Importez les données Oracle. Voici un exemple de commande d’importation :

imp AESUSER313/Altium@xe file=c:\Backups\AESUSER313.dmp log=c:\Backups\AESUSER313_import.log fromuser=AESUSER313 touser=AESUSER313

où,

AESUSER313 – utilisateur disposant de tous les privilèges sur le schéma et des droits d’accès à la base de données.

Altium – mot de passe du compte utilisateur Oracle associé à l’Enterprise Server.

xe – nom du service réseau de la base de données cible contenu dans tnsnames.ora.

file = c:\Backups\AESUSER313.dmp – emplacement de la sauvegarde.

log = c:\Backups\AESUSER313_import.log – journal de restauration (facultatif).

fromuser=AESUSER313 – propriétaire du schéma de sauvegarde.

touser=AESUSER313 – nouveau propriétaire du schéma (si les propriétaires sont différents, vous devez créer un nouvel utilisateur avec les privilèges et rôles appropriés).

5. Vérifiez l’intégrité des données.
   1. Vérifiez le fichier tnsname.ora. Vous devez mettre à jour le nom du service réseau (si vous avez changé le serveur DB).
   2. Validez les paramètres du serveur IIS. Vérifiez que la colonne « Host name » dans les liaisons du Gestionnaire IIS est à jour. Elle doit contenir le nom de domaine pleinement qualifié (FQDN) actuel de votre Enterprise Server.
   3. Vérifiez les valeurs des paramètres suivants dans le fichier C:\Program Files (x86)\Altium\Altium365\LocalVault.ini.
      1. Domain – le nom de votre domaine.
      2. WebsiteDomain – le FQDN de votre Enterprise Server.
      3. DataSourceType=Oracle – si vous utilisez Oracle DB.
      4. User=AESUSER313 – le propriétaire du schéma.
      5. Password=Altium – le mot de passe utilisateur défini par le DBA.
      6. DBLocation=FQDN ou ip_address:1521 – l’adresse de votre serveur DB.
      7. DatabaseName=xe – le nom actuel du service réseau de la DB, contenu dans tnsnames.ora.

Conclusion

Bien que l’exemple ci-dessus inclue des détails supplémentaires concernant l’interfaçage et la manipulation d’une base de données Oracle, seules trois étapes clés sont nécessaires pour restaurer les données de votre Enterprise Server :

1. L’étape 1 consiste à arrêter les services IIS et les pools d’applications IIS de Enterprise Server.
2. L’étape 2 consiste à restaurer les données de Enterprise Server .
3. L’étape 3 consiste à restaurer les données Oracle associées à Enterprise Server.

L’exécution de cette procédure dans l’ordre décrit réduit considérablement le risque de corruption des données due à une incompatibilité entre la base de données Oracle et les données binaires de Enterprise Server.