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.5. L'utilitaire DBUpgrade met à jour les éléments suivants dans version 8.5.5 :

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

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

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 qui héberge la base de données, 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_environnement_développement.bat
```
Vous êtes invité à entrer le nom d'utilisateur et le mot de passe pour chaque connexion à la base de données. La commande initialise les nouveaux composants de base de données et met à jour les schémas des bases de données existantes.
Les fichiers result.log se trouvent dans le répertoire Dossier_mise_à_niveau\nom_cellule ou nom_environnement_développement\type_base_données\nom_base_données.nom_schéma.
Facultatif : Sinon, si vous souhaitez exécuter les scripts SQL manuellement, utilisez une session SQL. Exécutez les scripts de la séquence indiquée dans le fichier dossier_mise_niveau\upgradeSchemaScriptsHelp_nom_de.txt.
Utilisez les paramètres et les 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_environnement_développement\type_base_données\nom_base_données.nom_schéma.
Mettez à jour le fichier de propriétés de migration de manière à utiliser les informations de configuration de l'environnement cible. Vérifiez toutes les propriétés cible et modifiez-les si nécessaire en suivant les instructions mentionnées dans le fichier. Le fichier se trouve dans répertoire_base_BPM_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 WAS_home\java\jre\bin avant d'exécuter l'utilitaire DBUpgrade.
Pour mettre à niveau les bases de données vers version 8.5.5, exécutez l'utilitaire DBUpgrade sur l'ordinateur du gestionnaire de déploiement de l'environnement cible.
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.
```
répertoire_base_BPM\bin\DBUpgrade.bat
-propertiesFile fichier_propriétés_migration
```
où :
- fichier_propriétés_migration est le chemin d'accès complet au fichier des propriétés de migration dans lequel vous indiquez les informations de configuration pour l'environnement cible.
Par exemple :
```
répertoire_base_BPM\bin\DBUpgrade.bat -propertiesFile "C:\bpm 85\util\migration\resources\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.bat dans répertoire_base_BPM\bin et recherchez -Xmx2048m dans ce 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.