Migrer Orchestrator entre des environnements

Cet article explique comment déplacer Orchestrator entre des environnements, tels que le déplacement vers un nouveau SQL Server 2022 ou le déplacement de certains composants d’Orchestrator.

Les processus et les scripts suivants permettent d'effectuer facilement le déplacement d'un environnement à un autre. Ils sont basés sur une migration complète de tous les composants Orchestrator vers un nouvel ordinateur SQL Server, avec une base de données Orchestrator restaurée.

Les étapes suivantes sont nécessaires pour permettre une migration automatique d'Orchestrator vers un nouvel environnement :

1. Sauvegarder la clé principale du service SQL Server dans l'environnement A

2. Sauvegarder la base de données Orchestrator dans l'environnement A

3. Déployer SQL Server dans l’environnement B

4. Restaurer la clé principale du service SQL Server dans l'environnement B

5. Restauration de la base de données Orchestrator dans l'environnement B

6. Déployer les composants d'Orchestrator dans l'environnement B

Remarque

Pour plus d’informations, consultez comment utiliser l’utilitaire sqlcmd.

Remarque

Il est recommandé d’activer SQL Broker sur la base de données Orchestrator afin que les tâches de maintenance internes s’exécutent automatiquement.

Vérifier/activer SQL Broker

Vérifiez si vous devez activer SQL Broker en exécutant la requête suivante sur l’instance Orchestrator SQL :

Select Name, is_broker_enabled, Compatibility_Level from sys.databases Where name = 'Orchestrator'

Si vous remarquez que votre répartiteur de base de données Orchestrator est désactivé (0), vous devez activer SQL Broker en procédant comme suit :

1. Arrêtez tous les services associés à Orchestrator sur tous les serveurs d’administration/serveurs Runbook :
   Orchestrator Management Service (omanagement)
   Orchestrator Remoting Service (oremoting)
   Orchestrator Runbook Server Monitor (omonitor)
   Orchestrator Runbook Service (orunbook)

   (Get-Service).Where{$_.Name -match "^omanagement|^oremoting|^omonitor|^orunbook"} | Stop-Service -Confirm:$false
   

2. Exécutez la requête suivante sur l’instance SQL Orchestrator :

   ALTER DATABASE Orchestrator SET SINGLE_USER WITH ROLLBACK IMMEDIATE
   GO
   ALTER DATABASE Orchestrator SET ENABLE_BROKER
   GO
   ALTER DATABASE Orchestrator SET MULTI_USER
   GO
   

3. Démarrez tous les services associés à Orchestrator sur tous les serveurs d’administration/serveurs Runbook :

   (Get-Service).Where{$_.Name -match "^omanagement|^oremoting|^omonitor|^orunbook"} | Start-Service
   

Sauvegarder la clé principale du service SQL Server dans l'environnement A

Sauvegardez la clé principale du service SQL Server.

Créez un script de commandes avec la commande suivante :

Sqlcmd -Q "BACKUP SERVICE MASTER KEY TO FILE ='C:\BACKUP\MASTER_KEY.BAK' ENCRYPTION BY PASSWORD = 'password'"  

Où « mot de passe » est le mot de passe qui sera utilisé pour protéger la clé principale du service dans le fichier créé. Si le mot de passe est perdu, la clé principale du service ne peut pas être récupérée à partir du fichier.

Sauvegarder la base de données Orchestrator dans l'environnement A

Sauvegardez la base de données Orchestrator dans son intégralité. Vous pouvez effectuer la sauvegarde lorsque le système est en cours d’exécution ; Toutefois, il est préférable d’effectuer la sauvegarde lorsque tous les auteurs de runbooks ont vérifié les modifications en attente apportées à leurs runbooks. Les modifications en attente sont mises en cache sur le Runbook Designer et ne sont pas sauvegardées avec une sauvegarde de base de données.

1. Dans gestion de SQL Server, cliquez avec le bouton droit sur la base de données Orchestrator, sélectionnez Tâches, puis sauvegarde.

2. Configurez les paramètres de sauvegarde selon les besoins de votre organisation.

3. Sélectionnez Script, puis sélectionnez Action de script dans la fenêtre Nouvelle requête.

4. Sélectionnez Exécuter pour tester le script de sauvegarde.

5. Créez un fichier de commandes avec ce script. Votre fichier de commandes sera semblable à celui-ci :

   Sqlcmd -Q "BACKUP DATABASE Orchestrator TO DISK=N'C:\BACKUP\OrchestratorDB.bak'"  
   

Déployer SQL Server dans l’environnement B

Déployez SQL Server dans l’environnement B.

Restaurer la clé principale du service SQL Server dans l'environnement B

Restaurez la clé principale du service Microsoft SQL Server pour activer le déchiffrement des données Orchestrator sur le nouveau serveur SQL.

Créez un script de traitement par lots avec la commande :

Remarque

Si vous envisagez d’utiliser\migrer la base de données Orchestrator dans une instance SQL Always ON , vous êtes invité à entrer le mot de passe de clé de chiffrement de base de données.

Sqlcmd -Q "RESTORE SERVICE MASTER KEY FROM FILE = 'C:\BACKUP\MASTER_KEY.BAK' DECRYPTION BY PASSWORD = 'password';"  

Restaurer la base de données Orchestrator dans l'environnement B

Suivez la procédure suivante pour créer un script de commandes à exécuter sur le nouvel ordinateur SQL Server pour restaurer la base de données Orchestrator.

1. Dans gestion de SQL Server, cliquez avec le bouton droit sur la base de données Orchestrator, sélectionnez Tâches, puis restaurez.

2. Configurez les paramètres de restauration selon les besoins de votre organisation.

3. Sélectionnez Script, puis sélectionnez Action de script dans la fenêtre Nouvelle requête.

4. Sélectionnez Exécuter pour tester le script de restauration.

5. Créez un fichier de commandes avec ce script. Votre fichier de commandes sera semblable à celui-ci :

   Sqlcmd -Q "RESTORE DATABASE [Orchestrator] FROM  DISK = N'C:\BACKUP\OrchestratorDB.bak'WITH  FILE = 1,  NOUNLOAD,  STATS = 10"  
   
   

   Remarque

   La base de données Orchestrator est chiffrée ; vous avez besoin du mot de passe de clé de chiffrement pour ajouter la base de données à une configuration SQL Always ON . Utilisez la requête suivante T-SQL pour modifier le mot de passe et utiliser le nouveau mot de passe dans l’Assistant Disponibilité SQL Always ON lors de l’ajout de la base de données à l’installation d’Always ON :

   Utiliser Orchestrator ALTER MASTER KEY

   RÉGÉNÉRER AVEC CHIFFREMENT PAR MOT DE PASSE = 'mot de passe' ;

   GO

Déployer les composants d'Orchestrator dans l'environnement B

Déployez les composants Orchestrator (serveur management, fonctionnalités Web, serveurs Runbook et Runbook Designer) à l'aide des commandes d'installation en mode silencieux du programme d'installation d'Orchestrator. Pour plus d’informations sur le déploiement d’Orchestrator à l’aide de la ligne de commande, consultez Installer avec l’outil d’installation de ligne de commande Orchestrator.

L’exemple suivant installe Orchestrator sur un ordinateur exécutant SQL Server :

Remarque

Passez en revue les instructions relatives à la connexion sécurisée à SQL Server).

%systemdrive%\sco\setup\setup.exe /Silent `
    /ServiceUserName:%computername%\administrator `
    /ServicePassword:password `
    /Components:All `
    /DbServer:%computername%  /DbPort:1433 /DbNameNew:OrchestratorSysPrep `
    /WebConsolePort:82 /WebServicePublicUrl:"http://localhost:81" `
    /WebServicePort:81 /WebConsolePublicUrl:"http://localhost:82" `
    /OrchestratorRemote `
    /UseMicrosoftUpdate:1 /SendCEIPReports:1 /EnableErrorReporting:always

Exemples de scripts et de commandes de migration

Sauvegarder l’exemple de clé de service maître SQL Server

Sqlcmd -Q "BACKUP SERVICE MASTER KEY TO FILE ='C:\BACKUP\MASTER_KEY.BAK' ENCRYPTION BY PASSWORD = 'password'"  

Sauvegarder l’exemple de base de données Orchestrator

Sqlcmd -Q "BACKUP DATABASE Orchestrator TO DISK=N'C:\BACKUP\OrchestratorDB.bak'"  

Exemple de clé de service maître SQL Server

Sqlcmd -Q "RESTORE SERVICE MASTER KEY FROM FILE = 'c:\temp_backups\keys\service_master_key' DECRYPTION BY PASSWORD = 'password'"  

Exemple de base de données Restore Orchestrator

Sqlcmd -Q "RESTORE DATABASE [Orchestrator] FROM  DISK = N'C:\BACKUP\OrchestratorDB.bak'WITH  FILE = 1,  NOUNLOAD,  STATS = 10"  

Installer Orchestrator à partir de l’exemple de fichier batch

%systemdrive%\sco\setup\setup.exe /Silent `
    /ServiceUserName:%computername%\administrator `
    /ServicePassword:password `
    /Components:All `
    /DbServer:%computername%  /DbPort:1433 /DbNameNew:OrchestratorSysPrep `
    /WebConsolePort:82 /WebServicePublicUrl:"http://localhost:81" `
    /WebServicePort:81 /WebConsolePublicUrl:"http://localhost:82" `
    /OrchestratorRemote `
    /UseMicrosoftUpdate:1 /SendCEIPReports:1 /EnableErrorReporting:always