Migration des pièces jointes aux documents vers le IBM BPM document store

Après la migration, vous devez faire migrer les pièces jointes aux documents depuis la base de données Process Server vers le IBM® BPM document store. La migration des pièces jointes aux documents constitue une tâche post-migration obligatoire. Les versions originales des pièces jointes continuent à résider dans la base de données jusqu'à ce que tous les documents aient été migrés. Une fois la migration terminée, vous pouvez utiliser soit des instances de coach, soit des coaches hérités afin de traiter les documents IBM BPM dans le IBM BPM document store.

Avant de commencer

Avant de tenter de faire migrer vos pièces jointes aux documents vers le IBM BPM document store, consultez la rubrique suivante afin de vous assurer que votre système répond aux exigences relatives à la migration de documents : Restrictions d'administration du magasin de documents IBM BPM.

Lors de leur migration vers le IBM BPM document store, les pièces jointes sont stockées temporairement deux fois dans la base de données Process Server. Pour cette raison, vous devez vous assurer que la base de données Process Server dispose d'un espace suffisant pour héberger les documents stockés deux fois avant de lancer la migration des documents.

Remarque : Le IBM BPM document store doit être utilisé avec un registre d'utilisateurs Federated Repositories. Si vous faites migrer vos documents vers le magasin de documents et que vous spécifiez par la suite une autre forme de registre d'utilisateurs, par exemple un registre LDAP autonome ou un registre personnalisé, vous perdez l'accès à vos documents.

Le magasin de documents limite la taille des documents à 1 gigaoctet ou moins. Si le contenu d'une pièce jointe associée à un document dans la base de données Process Server dépasse 1 gigaoctet, vous ne pouvez pas faire migrer cette pièce jointe vers le magasin de documents IBM BPM document store. La pièce jointe demeurera dans la base de données Process Server et une référence à cette pièce jointe sera créée dans le magasin de documents. Vous pouvez accéder au contenu de la pièce jointe au moyen d'opérations d'API et d'Enterprise Content Management, comme si le document avait été totalement migré.

Si vous faites migrer des documents depuis une version antérieure à la version 8.5.0.0 vers la version actuelle, utilisez la commande startDocumentStoreMigration pour votre migration.

Les commandes startDocumentStoreMigration et getDocumentStoreStatus sont utilisées pour effectuer un grand nombre des tâches de cette rubrique. Les commandes sont exécutées à l'aide de l'objet AdminTask du client de scriptage wsadmin. Pour exécuter la commande, vous devez remplir les conditions suivantes :

Les commandes doivent être exécutées sur le noeud du gestionnaire de déploiement.
Il doit y avoir au moins un membre de cluster d'application en cours d'exécution.
Exécutez les commandes en mode connecté. N'indiquez pas l'option wsadmin -conntype none.
Vous devez vous connecter au gestionnaire de déploiement avec un ID utilisateur disposant des privilèges Opérateur de WebSphere Application Server.

Démarrez le client de scriptage wsadmin à partir du répertoire dossier_principal_profil/bin du profil de gestionnaire de déploiement (ou du profil de serveur autonome d'IBM BPM Express). Les commandes ne consignent pas des données dans un fichier journal, mais le client de scriptage wsadmin crée toujours un fichier journal racine_profil/logs/wsadmin.traceout dans lequel vous trouverez des traces de pile d'exceptions et d'autres informations.

Pourquoi et quand exécuter cette tâche

Pour faire migrer des pièces jointes vers le IBM BPM document store, procédez comme suit :

Procédure

Exécutez la commande getDocumentStoreStatus. La commande renvoie la syntaxe de commande qui peut être utilisée, ainsi que le statut de la migration de documents éventuels, comme l'illustre l'exemple suivant :
AdminTask.getDocumentStoreStatus('[-deName myDeName]')

CWTDS2018I: La migration des documents IBM BPM n'a pas encore commencé. '{0}' documents doivent être migrés.

Pour transmettre davantage de paramètres à la commande, vous pouvez utiliser la syntaxe suivante :

racine_install wsadmin -user mon_nom_d'utilisateur -password mon_mot_de_passe -lang jython -c "print AdminTask.getDocumentStoreStatus('[-deName mon_nom_DE]')"

Par exemple :

C:\8500PC\STANDARD\deploy2\AppServer\profiles\DmgrProfile\bin>wsadmin -user tw_admin -password tw_admin -lang jython -c "print AdminTask.getDocumentStoreStatus('[-deName De1]')"

Pour obtenir des informations détaillées sur la commande getDocumentStoreStatus, reportez-vous à la rubrique "Commande getDocumentStoreStatus".
Exécutez la commande startDocumentStoreMigration. La commande wsadmin renvoie la syntaxe de commande qui peut être utilisée, comme l'illustre l'exemple suivant :
AdminTask.startDocumentStoreMigration('[-deName myDeName]')

Pour indiquer d'autres paramètres de la commande, vous pouvez utiliser la syntaxe suivante :

racine_profil\bin\wsadmin -user nom_utilisateur -password mot_de_passe -lang jython -c "print AdminTask.startDocumentStoreMigration('[-deName nom_environnement_déploiement]')"

Par exemple :

C:\8500PC\STANDARD\deploy2\AppServer\profiles\DmgrProfile\bin>wsadmin -user tw_admin -password tw_admin -lang jython -c "print AdminTask.startDocumentStoreMigration('[-deName De1]')"

Pour obtenir des informations détaillées sur la commande startDocumentStoreMigration, reportez-vous à la rubrique "startDocumentStoreMigration".
Exécutez de nouveau la commande getDocumentStoreStatus pour vérifier le statut de la migration de document. Si la migration se déroule ou s'achève avec succès, la commande renvoie l'un des messages suivants :
CWTDS2019I: La migration des documents IBM BPM est en cours. '{0}' documents sur '{1}' ont déjà été migrés.

CWTDS2020I: La migration des documents BPM IBM est en cours. '{0}' documents sur '{1}' ont déjà été migrés. Un nettoyage est en cours.

CWTDS2021I: La migration des documents IBM BPM est terminée. '{0}' documents ont été migrés.

Si la migration d'un ou plusieurs documents échoue, il se peut que la commande getDocumentStoreStatus renvoie l'un des messages suivants :

CWTDS2022I: La migration des documents IBM BPM s'est arrêtée avec une erreur. '{0}' documents sur '{1}' ont déjà été migrés. Pour '{2}' documents, la migration a échoué.

CWTDS2023I : La migration a échoué pour le document '{0}'. Détails : '{1}'.
Si un message indique qu'un ou plusieurs des documents n'ont pas été migrés avec succès, effectuez l'une des étapes suivantes :
- Si la migration de tous les documents échoue, vérifiez la configuration de la migration et les fichiers journaux afin de déterminer si un incident général s'est produit, par exemple un problème de connexion à la base de données.
- Si les journaux signalent une erreur OutOfMemoryError, essayez d'augmenter la taille du segment de mémoire de la machine virtuelle Java pendant la période de migration. Vous pouvez également essayer de réduire le nombre maximal de documents qui peuvent être migrés en parallèle dans le IBM BPM document store. Pour plus d'informations, voir Modification des paramètres de configuration.
- Si les journaux signalent un dépassement du délai de transaction, il est possible que des documents très volumineux n'aient pas pu être migrés au cours d'une même transaction. Essayez d'augmenter provisoirement le délai de transaction en suivant les instructions de la rubrique relative aux paramètres du service de transaction. Vous pouvez également exécuter la commande startDocumentStoreMigration avec l'option -keepFailedDocuments, comme indiqué ci-après.
- Si la migration de certains documents échoue, vous pouvez choisir de conserver le contenu de ces documents dans la base de données Process Server et de créer uniquement des références à ces documents dans le magasin de documents. Les API de document antérieures et les opérations ECM continueront à fonctionner avec ces documents dans la base de données Process Server. Pour conserver le contenu des documents dans la base de données Process Server et créer uniquement des références à ces documents dans le magasin de documents, exécutez la commande startDocumentStoreMigration avec l'option -keepFailedDocuments, comme illustré dans l'exemple suivant :
  AdminTask.startDocumentStoreMigration('[-deName myDeName -keepFailedDocuments]')

Que faire ensuite

Une fois la migration des documents terminée, les tables de base de données LSW_BPD_INSTANCE_DOCUMENTS et LSW_BPD_INSTANCE_DOC_PROPS devraient être vides dans la base de données Process Server. Cependant, si la base de données contenait des documents d'une taille supérieure à 1 gigaoctet ou si l'option -keepFailedDocuments a été utilisée, la base de données peut encore contenir quelques lignes. Si vous le souhaitez, vous pouvez éventuellement réorganiser les tables de sorte à libérer l'espace disque utilisé par les lignes supprimées de la table. Par exemple, pour les bases de données DB2, vous pouvez réorganiser les tables à l'aide des commandes REORG et RUNSTATS.