Sauvegarde et restauration d'Orchestrator

Cette page fournit un exemple de solution pour programmer les sauvegardes de votre base de données SQL Orchestrator. Découvrez ici comment sauvegarder les fichiers web.config et UiPath.Orchestrator.dll.config associés et les packages NuGet, le cas échéant.

Sauvegarder la base de données Orchestrator

Il existe plusieurs façons de réaliser cette sauvegarde, y compris de nombreuses solutions tierces que vous pouvez obtenir sous licence et installer si vous le souhaitez. Toutefois, cet exemple vous guide tout au long du processus par le biais de la fonctionnalité Plans de maintenance intégrée déjà présente dans SQL Server Management Studio.

Créer le plan de maintenance

1. Depuis SQL Server Management Studio, connectez-vous au serveur SQL Server de votre base de données Orchestrator.
   Remarque : l'accès administrateur est requis.
2. Développez le dossier Gestion.
   
   

   

   
   
3. Cliquez avec le bouton droit de la souris sur Plans de maintenance et sélectionnez Assistant Plan de maintenance. L'Assistant Plan de maintenance d'entretien s'affiche.
   
   

   

   
   
4. Sur la page Sélectionner les propriétés du plan :
   1. Dans le champ Nom, donnez un nom descriptif à ce plan de maintenance.
   2. Utilisez le champ Description pour fournir une description détaillée du plan si vous le souhaitez.
   3. Dans le menu déroulant Exécuter en tant que, sélectionnez Compte de service d'agent SQL Server.
   4. Utilisez les boutons radio et le champ Calendrier pour sélectionner l'heure et la fréquence souhaitées pour ce plan de maintenance.
5. Cliquez sur Suivant. La page Sélectionner les tâches de maintenance s’affiche.
   
   

   

   
   
6. Sélectionnez Sauvegarder la base de données (complète) et cliquez sur Suivant. La page Définir la tâche de la base de données de sauvegarde (complète) s'affiche.
   Remarque : Pour sauvegarder la base de données de Test Manager, consultez Sauvegarde et restauration de Test Manager.

   Remarque : ce guide détaille uniquement la configuration d'un plan de maintenance pour la création d'une sauvegarde complète de la base de données. Dans votre environnement de production, il est également recommandé de configurer un plan de sauvegarde différentielle planifié pour s'exécuter quotidiennement.

   
   

   

   
   
7. Dans l'onglet Général :
   1. Utilisez la liste déroulante Base de données pour sélectionner des bases de données spécifiques.
   2. Sélectionnez Base de données comme composant de sauvegarde. Dans la fenêtre contextuelle, sélectionnez votre base de données Orchestrator (UiPath dans l'exemple ci-dessus).
8. Dans l'onglet Destination, saisissez l'emplacement d'enregistrement de toutes les sauvegardes futures.
9. L'onglet Options vous permet de sélectionner :
   1. Compression pour les fichiers de sauvegarde. Si cette option est activée, le temps nécessaire pour effectuer la sauvegarde augmente.
   2. La date d’expiration de la sauvegarde.
   3. Vérification de l'intégrité de la sauvegarde. Si cette option est activée, le temps nécessaire pour effectuer la sauvegarde augmente.
10. Cliquez sur Terminer pour créer le plan de maintenance et sur Fermer pour fermer l'assistant.

Exécuter le plan de maintenance

La sauvegarde telle que définie dans votre plan de maintenance créé peut également être exécutée en dehors du calendrier défini de la façon suivante :

1. Depuis SQL Server Management Studio, connectez-vous au serveur SQL Server de votre base de données Orchestrator.
   Remarque : l'accès administrateur est requis.
2. Développez le dossier Gestion.
3. Développez le dossier « Plans de maintenance ».
4. Cliquez avec le bouton droit sur le plan de maintenance souhaité et sélectionnez Exécuter. La fenêtre Exécuter le plan de maintenance s'affiche.
   
   

   

   
   
5. Une fois terminé, le message Réussite s'affiche. Vous pouvez cliquer sur Fermer pour quitter ou sélectionner Rapport pour lire le rapport d'exécution.

Restaurer la base de données Orchestrator

1. Depuis SQL Server Management Studio, connectez-vous au serveur SQL Server souhaité.
   Remarque : l'accès administrateur est requis.
2. Cliquez avec le bouton droit de la souris sur le dossier Bases de données et sélectionnez Restaurer la base de données.
3. Suivez l'assistant de restauration pour sélectionner la source de la sauvegarde et la destination de sa restauration.
   
   Remarque : il est possible de restaurer votre base de données plus tôt. Vous pouvez également la renommer.
4. Cliquez sur OK pour lancer la procédure de restauration. Selon la taille de la base de données, cela peut prendre un certain temps.
5. Une fois la procédure terminée, la nouvelle base de données apparaît dans l'onglet Bases de données de SQL Server Management Studio.

Fichiers de configuration de sauvegarde et packages NuGet

Pour sauvegarder votre configuration Orchestrator et les packages NuGet, vous devez copier les fichiers et les dossiers pertinents à l'endroit de sauvegarde que vous avez désigné. Cette page fournit les détails nécessaires pour identifier et localiser les fichiers et dossiers que vous devez copier.

Fichiers Web.config et UiPath.Orchestrator.dll.config d'Orchestrator

Sauvegarde

Les étapes nécessaires pour sauvegarder votre configuration Orchestrator varient légèrement en fonction de votre modèle de déploiement (par exemple, On-prem et IaaS (Infrastructure as a Service) ou PaaS (Platform as a Service)).

Déploiements sur site et IaaS

1. Ouvrez votre répertoire d’installation Orchestrator. Par défaut, c'est C:\Program Files (x86)\UiPath\Orchestrator.
2. Copiez les fichiers web.config et UiPath.Orchestrator.dll.config qui s'y trouvent à l'emplacement de sauvegarde que vous avez désigné.

Déploiements PaaS Azure

1. Sélectionnez votre service d'application Orchestrator.
2. Dans le menu Outils de développement, accédez à Outils avancés > Accéder > Console de débogage > CMD.
3. Ouvrez le dossier Site et accédez à wwwroot.
4. Sélectionnez Web.config et cliquez sur Télécharger.
5. Copiez le fichier téléchargé dans l'emplacement de sauvegarde que vous avez désigné.
6. Sélectionnez UiPath.Orchestrator.dll.config et cliquez sur Télécharger.
7. Copiez le fichier téléchargé dans l'emplacement de sauvegarde que vous avez désigné.

En plus des fichiers web.config et UiPath.Orchestrator.dll.config, vous devez également copier les paramètres de l'application et les chaînes de connexion comme suit :

1. Sélectionnez votre service d'application Orchestrator.
2. Dans le menu Paramètres, sélectionnez Configuration.
3. Dans la section Paramètres de l'application, sélectionnez Mise à jour avancée et copiez la valeur affichée.
4. Dans la section Chaînes de connexion, sélectionnez Modification avancée et copiez la valeur affichée.
5. Enregistrez ces valeurs à l'endroit de sauvegarde que vous avez désigné.

Restaurer

Remarque : Lorsque vous restaurez les fichiers web.config et UiPath.Orchestrator.dll.config, faites-le sur tous les nœuds Orchestrator de votre déploiement.

Déploiements sur site et IaaS

Pour restaurer votre précédente configuration Orchestrator, que ce soit dans un nouvel environnement ou suite à une panne :

1. Copiez les fichiers web.config et UiPath.Orchestrator.dll.config de la sauvegarde souhaitée.
2. Ouvrez votre répertoire d’installation Orchestrator. Par défaut, c'est C:\Program Files (x86)\UiPath\Orchestrator.
3. Remplacez les fichiers web.config et UiPath.Orchestrator.dll.config qui s'y trouvent par la sauvegarde que vous avez désignée.

Déploiements PaaS Azure

Après avoir récupéré le fichier de sauvegarde web.config et UiPath.Orchestrator.dll.config souhaité :

1. Sélectionnez votre service d'application Orchestrator.
2. Dans le menu Outils de développement, accédez à Outils avancés > Accéder > Console de débogage > CMD.
3. Ouvrez le dossier Site et accédez à wwwroot.
4. Remplacez les fichiers web.config et UiPath.Orchestrator.dll.config qui s'y trouvent par la sauvegarde que vous avez désignée.

En plus de remplacer les fichiers web.config et UiPath.Orchestrator.dll.config, vous devez également restaurer les paramètres d'application et les chaînes de connexion avec leurs valeurs précédentes, comme suit :

1. Sélectionnez votre service d'application Orchestrator.
2. Dans le menu Paramètres, sélectionnez Configuration.
3. Dans la section Paramètres de l'application, sélectionnez Mise à jour avancée et remplacez la valeur par la sauvegarde précédemment enregistrée.
4. Dans la section Chaînes de connexion, sélectionnez Modification avancée et remplacez la valeur par la sauvegarde précédemment enregistrée.

Packages NuGet

Sauvegarde

L'emplacement de vos répertoires de packages NuGet est indiqué dans la section Déploiement du fichier UiPath.Orchestrator.dll.config.

1. Vérifiez la valeur de la touche NuGet.Repository.Type. Les valeurs suivantes sont possibles :
   • Hérités - les packages sont stockés dans les emplacements spécifiés dans les clés NuGet.Packages.Path et NuGet.Activities.Path.
   • Composite - les packages sont stockés dans les emplacements spécifiés dans les clés Storage.Type et Storage.Location.
2. Pour les types de référentiels hérités, copiez les dossiers identifiés par les clés NuGet.Packages.Path et NuGet.Activities.Path à l'emplacement de sauvegarde que vous avez désigné.
3. Pour les types de référentiel composites où la clé Storage.Type est :
   1. FileSystem - copiez les dossiers identifiés dans le paramètre RootPath de la clé Storage.Location de votre emplacement de sauvegarde désigné.
   2. Azure - une chaîne de connexion est fournie dans la clé Storage.Type. L'intégrité et la disponibilité des données sont couvertes par Amazon, mais vous pouvez utiliser leur guide si vous souhaitez enregistrer les fichiers qui y sont stockés localement.
   3. Amazon - une chaîne de connexion est fournie dans la clé Storage.Type. L'intégrité et la disponibilité des données sont couvertes par Amazon, mais vous pouvez utiliser leur guide si vous souhaitez enregistrer les fichiers qui y sont stockés localement.

Restaurer

La restauration de vos répertoires de paquets NuGet précédents suit l'inverse du processus de sauvegarde détaillé ci-dessus, comme suit :

1. Pour les référentiels hérités, copiez vos sauvegardes des dossiers de packages et d'activités NuGet dans les répertoires identifiés par les clés NuGet.Packages.Path et NuGet.Activities.Path indiquées dans la section Déploiement du fichier UiPath.Orchestrator.dll.config.
2. Pour les types de référentiel composites où la clé Storage.Type est :
   • FileSystem : copiez vos dossiers de sauvegarde dans le répertoire identifié dans la clé Storage.Location du paramètre RootPath, qui se trouve dans la section Déploiement du fichier UiPath.Orchestrator.dll.config.
   • Azure - saisissez la chaîne de connexion précédemment enregistrée dans la clé Storage.Type.
   • Amazon - saisissez la chaîne de connexion précédemment enregistrée dans la clé Storage.Type.