Sauvegarde et restauration d'Orchestrator

This page provides a sample solution for creating scheduled backups of your Orchestrator SQL database. See here how to back up the related web.config and UiPath.Orchestrator.dll.config files and NuGet packages, if applicable.

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 :

   Un accès administrateur est requis.

2. Développez le dossier Gestion.

   Figure 1. 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.

   Figure 2. Sélectionner Propriétés du plan

   

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.

   Figure 3. Sélectionner des tâches de maintenance

   

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, voir Sauvegarde et restauration de Test Manager.

   Remarque :

   Ce guide ne détaille que la mise en place d'un plan de maintenance relatif à la création d'une sauvegarde complète de la base de données. Dans votre environnement de production, il est également recommandé de mettre en place un plan de sauvegarde différentiel dont l'exécution est prévue quotidiennement.

   Figure 4. Définir la tâche de sauvegarde de la base de données (complète)

   

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 :

   Un 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.

   Figure 5. Exécuter un plan de maintenance

   

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 :

   Un 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 une 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

The location(s) of your NuGet package directories is indicated in the Deployment section of the UiPath.Orchestrator.dll.config file.

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. For Legacy repositories, copy your backups of the NuGet packages and activities folders to the directories identified by the NuGet.Packages.Path and NuGet.Activities.Path keys indicated in the Deployment section of the UiPath.Orchestrator.dll.config file.

2. Pour les types de référentiel composites où la clé Storage.Type est :

   • FileSystem - copy your backup folder(s) to the directory identified in the Storage.Location key of the RootPath parameter, found in the Deployment section of the UiPath.Orchestrator.dll.config file.
   • 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.