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 de l’utilisation d’Oracle, des informations importantes sur les exigences système, ainsi qu’un exemple illustrant 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 l’ensemble de 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 effectuant la restauration de l’Enterprise Server doit disposer des droits administrateur 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 suivant 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 où les données sont importées dans cette instance d’Enterprise Server).
5. Le schéma Oracle et les identifiants d’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

À l’instar 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 des empreintes de composants et des symboles schématiques, les paramètres, les chemins de fichiers, les liens vers les sources de données de la 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 incluent des informations telles que les documents de projet PCB et schématique, les empreintes, les symboles, les 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 tenir compte des points suivants :

1. avbackup.exe ne prend NOT 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.
3. L’Enterprise Server doit être en cours d’exécution. avbackup.exe 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

Dans cet exemple, les instructions s’adressent également aux petites entreprises qui ne disposent pas forcément d’un administrateur de base de données Oracle (DBA) dédié, mais qui ont néanmoins besoin de restaurer leur Enterprise Server et les données Oracle associées sur leur réseau. Les étapes suivantes montrent comment une sauvegarde de base de l’Enterprise Server et de sa base de données Oracle associée peut être restaurée sur une nouvelle machine et une nouvelle base de données Oracle.

É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 placé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 ainsi que votre 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.-à-d. ajouter le compte Windows de l’utilisateur au rôle sysDBA dans un 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 existant et le compte utilisateur de la base de données Oracle.

La suppression d’un compte utilisateur Oracle et du 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. Lancez une invite de commande avec les 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 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. Alternativement, vous pouvez 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 le mot de passe Altium) :
   1. Lancez une invite de commande avec les 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é de serveur de base de données).
   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 complet (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 – propriétaire du schéma.
      5. Password=Altium – mot de passe de l’utilisateur défini par le DBA.
      6. DBLocation=FQDN ou ip_address:1521 – adresse de votre serveur de base de données.
      7. DatabaseName=xe – nom actuel du service réseau de la base de données, 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, la restauration des données de votre Enterprise Server ne comporte que trois étapes clés :

1. Étape 1 : arrêter les services IIS et les pools d’applications IIS de l’Enterprise Server.
2. Étape 2 : restaurer les données de l’Enterprise Server.
3. Étape 3 : restaurer les données Oracle associées à l’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 l’Enterprise Server.