This topic applies only to the IBM Business Process Manager Advanced configuration.

Configuration de Business Process Archive Manager

Business Process Archive Manager est un composant optionnel qui permet de réduire la taille de la base de données Business Process Choreographer en déplaçant les instances de processus BPEL terminées et les tâches utilisateur vers une base de données d'archivage distincte. Pour configurer Business Process Archive Manager, vous devez ajouter des entrées au fichier de propriétés avant de créer l'environnement de déploiement.

Pourquoi et quand exécuter cette tâche

Pour configurer le gestionnaire Business Process Archive Manager, vous pouvez mettre à jour le fichier de propriétés pour l'inclure avant de créer l'environnement de déploiement, ou bien vous pouvez mettre à jour l'environnement de déploiement ultérieurement, à l'aide de la commande BPMConfig -upgrade -de -component.

Vous pouvez configurer Business Process Archive Manager uniquement sur le cluster de support d'une topologie à trois clusters d'un environnement de déploiement Advanced ou AdvancedOnly. Lorsque vous configurez Business Process Archive Manager, une instance de Business Process Archive Explorer est également configurée.

Procédure

Si vous mettez à jour votre environnement de déploiement afin d'ajouter Business Process Archive Manager, assurez-vous que le fichier de propriétés de configuration correspond bien à la topologie de l'environnement de déploiement IBM BPM en exportant le fichier de propriétés de configuration à l'aide de la commande BPMConfig.
- Sous Microsoft Windows, exécutez la commande BPMConfig.bat suivante :
```
racine_install\bin\BPMConfig.bat -export -profile nom_profil_gestionnaire_déploiement [-de nom_environnement_déploiement] -outputDir chemin_fichiers_configuration
```
- Sous Linux et les systèmes d'exploitations fondés sur UNIX, exécutez la commande BPMConfig.sh suivante :
```
racine_install/bin/BPMConfig.sh -export -profile nom_profil_gestionnaire_déploiement [-de nom_environnement_déploiement] -outputDir chemin_fichiers_configuration
```
Le fichier de propriétés de configuration s'appelle environnement_déploiement.properties (où environnement_déploiement correspond au nom de l'environnement de déploiement). Le fichier se trouve dans le répertoire de sortie spécifié lors de l'exécution de la commande.
Remarque : S'il n'y a qu'un seul environnement de déploiement dans la cellule WebSphere, vous pouvez omettre l'option -de.
Ouvrez le fichier de propriétés de votre environnement de déploiement dans un éditeur.
Conseil : Pour plus d'informations sur les clés et les valeurs possibles pour le composant BPCArchive, voir l'exemple de fichier de propriétés correspondant.
- racine_install/BPM/samples/config/advanced/Advanced-PC-ThreeClusters-DB2.properties
- racine_install\BPM\samples\config\advanced\Advanced-PC-ThreeClusters-DB2.properties
Ajoutez la base d'archives au cluster de support. Si, par exemple, le cluster 3 est le cluster de support, ajoutez une entrée similaire à l'exemple suivant :
```
bpm.de.cluster.3.db=PerformanceDb,ArchiveDb
```
Ajoutez la définition de la base d'archives. A titre d'exemple, pour une base de données DB2 nommée BPARCDB, si l'indice de la prochaine base de données libre est 5, ajoutez des entrées similaires à l'exemple suivant.
```
bpm.de.db.5.name=ArchiveDb
bpm.de.db.5.dbCapabilities=BPCArchive
bpm.de.db.5.type=DB2
bpm.de.db.5.hostname=localhost
bpm.de.db.5.portNumber=50000
bpm.de.db.5.databaseName=BPARCDB
bpm.de.db.5.schema=db2admin
bpm.de.db.5.roleMapping.1.name=DbUser
bpm.de.db.5.roleMapping.1.alias=BPM_DB_ALIAS
bpm.de.db.5.roleMapping.2.name=DbUserXAR
bpm.de.db.5.roleMapping.2.alias=BPM_DB_ALIAS
```
Conseil : Le but du composant Business Process Archive Manager étant de réduire la taille de la base de données d'exécution, assurez-vous que BPARCDB est une base de données distincte de la base de données utilisée par Business Process Choreographer.
Créez ou mettez à jour l'environnement de déploiement.
- Si vous créez votre environnement de déploiement pour la première fois, une fois vos modifications apportés et la mise à jour du fichier de propriétés effectuée, exécutez la commande BPMConfig -create. Par exemple :
```
BPMConfig -create -de DE1.properties
```
- Si vous mettez à jour votre environnement de déploiement afin d'ajouter Business Process Archive Manager, procédez comme suit :
  1. Exécutez la commande BPMConfig -upgrade -component BPCArchive. Vous devez exécuter la commande sur le noeud du gestionnaire de déploiement. L'exemple suivant montre comment exécuter la commande :
```
BPMConfig -upgrade -de DE1.properties -component BPCArchive
```
    Une fois la commande exécutée, synchronisez les noeuds afin que les noeuds gérés disposent des dernières modifications apportées au fichier de configuration.
  2. Exécutez le script de base de données.
    1. Le script de base de données se trouve dans le répertoire racine_profil_gestionnaire_déploiement/dbscripts_upgrade. Le script s'appelle createSchema_Advanced.sql.
    2. Copiez le script sur le poste de votre base de données et exécutez-le. Par exemple :
```
db2 -tf createSchema_Advanced.sql
```
  3. Redémarrez l'environnement de déploiement.

Résultats

Le fichier de propriétés inclut les définitions utilisées pour configurer une instance Business Process Archive Manager et une instance Business Process Archive Explorer sur le cluster de support. Business Process Archive Manager est automatiquement configuré et prêt à être utilisé dans l'environnement de déploiement.