Mise à niveau des bases de données SQL Server

Pour SQL Server, initialisez les nouvelles bases de données et mettez à niveau les schémas et les données existantes afin que les bases de données fonctionnent avec la nouvelle version du produit IBM® Business Process Manager.

Figure 1. Exemple d'environnement après mise à jour des schémas et données existants. L'environnement source n'est pas en cours d'exécution et les bases de données ne sont pas utilisées. La base de données contient des schémas et des données mis à jour. La cible n'est pas en cours d'exécution, mais elle contient un environnement de déploiement.

Les détails du diagramme sont indiqués dans la légende de la figure.

Exécutez la commande DBUpgrade pour modifier les schémas et les données des bases de données à utiliser avec IBM Business Process Manager version 8.5.6. L'utilitaire DBUpgrade met à jour les éléments suivants dans la version 8.5.6 :

Kit d'outils de données système
Application de processus Process Portal
Exemple d'application de processus

Remarque : Bien que l'utilitaire DBUpgrade mette à niveau le kit d'outils Données système vers IBM Business Process Manager version 8.5.6 version 8.0.1, il ne met pas automatiquement à jour les dépendances existantes. Les dépendances doivent être mises à jour après la migration.

Avant de commencer

Assurez-vous que vous avez arrêté l'environnement source avant de lancer la migration.

Vérifiez que les utilisateurs qui sont configurés pour accéder à vos bases de données SQL Server disposent des privilèges nécessaires pour mettre à niveau les bases de données. Les privilèges suivants sont nécessaires pour modifier les schémas de base de données et les données SQL Server à utiliser avec IBM Business Process Manager version 8.5.6.

Les privilèges CONNECT et CREATETAB sont requis sur le niveau de base de données.
Le processus de mise à niveau accède à certaines tables système. Accordez le privilège SELECT à cet utilisateur pour la mise à niveau. Ces privilèges sont déjà accordés au groupe public par défaut ; il n'est pas nécessaire de les accorder à moins qu'ils aient été révoqués.
```
INFORMATION_SCHEMA.COLUMNS.TABLES
INFORMATION_SCHEMA.COLUMNS.COLUMNS
sys.indexes
sys.sysobjects
```
N'accordez pas le rôle de serveur sysadmin aux utilisateurs. Si un utilisateur est titulaire du rôle sysadmin, dbo sera toujours le schéma par défaut, quel que soit le schéma que vous affectez. Par conséquent, la migration utilisera dbo pour créer des tables ou mettre les données à jour.

Pour obtenir la liste des versions de base de données prises en charge, reportez-vous à la configuration système requise.

Procédure

Pour chaque environnement de déploiement que vous créez, accomplissez la procédure suivante :

Copier l'intégralité du dossier profil_gestionnaire_déploiement_cible/dbscripts/Upgrade/ sur l'ordinateur qui héberge votre base de données.
Si n'avez pas créé de base de données de moteur de messagerie et prévoyez à la place de réutiliser votre moteur de messagerie et votre schéma de base de données précédents, vous devez supprimer manuellement les tables du moteur de messagerie.
Conseil : Les noms de table du moteur de messagerie utilisent le préfixe SIB.
Sur l'ordinateur de la base de données, mettez à niveau tous les schémas. Pour voir quels schémas sont mis à niveau, accédez au répertoire dans lequel vous avez copié le dossier Upgrade et consultez le fichier upgradeSchemaScriptsHelp_nom_de.txt.
Accédez au répertoire dans lequel vous avez copié le dossier Upgrade et exécutez la commande upgradeSchemaAll. Il existe une commande upgradeSchemaAll différente pour chaque environnement de déploiement de la source.

Important : Si vous utilisez l'authentification Windows, vous ne pouvez pas exécuter upgradeSchemaAll, vous devez exécuter directement les scripts SQL, via une session SQL.
```
upgradeSchemaAll_nom_de.sh
```
Vous êtes invité à entrer le nom d'utilisateur et le mot de passe pour chaque connexion à la base de données. Cette commande initialise les nouveaux composants de base de données et met à niveau les schémas de toutes les bases de données existantes, à l'exception des bases de données de Process Server et Performance Data Warehouse. Ces deux bases de données sont mises à niveau ultérieurement, via la commande DBUpgrade.
Ou bien, si vous souhaitez exécuter manuellement les scripts SQL, utilisez une session SQL et exécutez les scripts dans la séquence indiquée dans le fichier dossier_mise_à_niveau/upgradeSchemaScriptsHelp_nom_de.txt et utilisez les paramètres et commandes suivants.
```
osql -e -b -U nom_utilisateur -P mot_passe -i nom_script -o nom_journal
```
où :
- -e spécifie que la commande doit être répercutée en invite
- -b spécifie que le script doit s'arrêter dès la première erreur
- -U spécifie le nom d'utilisateur
- -P spécifie le mot de passe
- -i spécifie le fichier d'entrée
- -o spécifie que la sortie doit être intégralement redirigée vers un fichier
Il arrive que des messages d'avertissement apparaissent lorsque vous exécutez les scripts de mise à niveau de la base de données Business Space afin de vous signaler que le résultat d'une requête est une table vide ou qu'aucune ligne n'a été trouvée pour FETCH, UPDATE ou DELETE. Ces messages peuvent être ignorés sans problème.

Les fichiers result.log se trouvent dans le répertoire dossier_mise_à_niveau/nom_cellule ou nom_cellule.nom_de/type_base_données/nom_base_données.nom_schéma.
Copiez le fichier exemple migration.properties et renommez-le en target_migration.properties. Mettez à jour le fichier avec les informations de migration pour l'environnement cible. Vérifiez toutes les propriétés cible et éditez-les si nécessaire, en suivant les instructions du fichier exemple. Le fichier exemple se trouve dans le répertoire racine_installation_8.5/util/migration/resources/migration.properties.
Assurez-vous que toutes les propriétés ont été définies sur l'environnement cible (et non source). Vérifiez que la propriété target.config.property.file est définie sur le chemin d'accès complet au fichier des propriétés de configuration utilisé pour créer votre environnement cible. Vous devez également définir la valeur de profile.name en spécifiant le nom du nouveau profil de gestionnaire de déploiement.
Si vous utilisez SQL Server avec l'authentification Windows activée, copiez le fichier sqljdbc_auth.dll de racine_WAS/jdbcdrivers/SQLServer/auth/plateforme vers racine_WAS/java/jre/bin avant d'exécuter l'utilitaire DBUpgrade.
Pour mettre à niveau les bases de données vers la version 8.5.6, exécutez l'utilitaire DBUpgrade sur l'ordinateur du gestionnaire de déploiement de l'environnement cible. La commande DBUpgrade met automatiquement à niveau le schéma et les données de Process Server et Performance Data Warehouse.
Conseil : Par défaut, DBUpgrade met à niveau le schéma et les données des bases de données de Process Server et Performance Data Warehouse. Pour des instructions sur l'exécution distincte de la mise à jour de schéma, voir la rubrique de référence de l'utilitaire de ligne de commande DBUpgrade.

Important : Assurez-vous que votre gestionnaire de déploiement, ainsi que tous les noeuds gérés de l'environnement source, ont été arrêtés avant d'exécuter cet utilitaire.
```
racine_installation/bin/DBUpgrade.sh -propertiesFile fichier_propriétés_migration_cible
```
où :
- fichier_propriétés_migration_cible correspond au chemin d'accès complet au fichier de propriétés de migration dans lequel vous avez spécifié les informations de configuration pour l'environnement cible.
Par exemple :
```
racine_install/bin/DBUpgrade.sh
-propertiesFile /opt/BPM85/util/migration/resources/target_migration.properties
```
La commande affiche chaque action de mise à niveau de la base de données pendant l'exécution. Une fois que toutes les mises à niveau ont été exécutées avec succès, un message semblable au suivant s'affiche :
```
Toutes les étapes de mise à niveau ont été correctement exécutées.
```
L'emplacement des journaux est répertorié dans la sortie. S'il y a des erreurs ou des exceptions, elles apparaîtront dans ce journal.
Si vous effectuez une migration à partir de la version 7.5.x et que vous recevez une erreur liée à une insuffisance de mémoire indiquant des enregistrements de données trop nombreux ou trop grands, vous pouvez essayer d'augmenter la taille de segment de mémoire de JVM pour la commande DBUpgrade. Ouvrez le fichier DBUpgrade.sh du répertoire racine_installation/bin et recherchez -Xmx2048m dans le fichier. Il indique que la taille de segment mémoire JVM maximale est de 2048 mégaoctets. Vous pouvez augmenter cette valeur pour mettre à jour la taille de segment de mémoire.

Que faire ensuite

Il est possible que des messages d'alerte comparables aux messages ci-dessous apparaissent dans le journal de mise à niveau : Couldn't load Resource META-INF*****. Ces messages peuvent être ignorés sans problème.