Table des matières

Search

  1. Préface
  2. Présentation de l'installation
  3. Tâches de pré-installation
  4. Installation du Stockage Hub
  5. Tâches de post-installation du stockage Hub
  6. Installation du serveur Hub
  7. Tâches de post-installation du serveur Hub
  8. Installation du serveur de processus
  9. Tâches de post-installation du serveur de processus
  10. Tâches de post-installation ActiveVOS pour le serveur d'applications
  11. Tâches de post-installation ActiveVOS pour l'adaptateur d'entité commerciale
  12. Personnaliser ActiveVOS
  13. Installation du kit de ressources
  14. Dépannage de MDM Hub
  15. Désinstallation

Installation Guide for Oracle Database with Red Hat JBoss

Installation Guide for Oracle Database with Red Hat JBoss

Dépannage du processus d'installation

Dépannage du processus d'installation

Si la post-installation échoue, utilisez les informations suivantes pour le dépannage.

Impossible de lancer la console Hub

Après l'installation, la console Hub ne peut pas se lancer et génère l'erreur suivante dans le fichier journal :
SIP-09131: General Decryption failure and [ERROR] com.delos.util.StringUtil: Unable to decrypt
Chiffrez et mettez à jour le mot de passe de la base de données principale de MDM Hub ou du stockage de référence opérationnelle.
  1. Pour chiffrer un mot de passe, exécutez la commande suivante depuis une invite de commande :
    java -classpath siperian-api.jar;siperian-common.jar;siperian-server.jar com.delos.util.PublicKeyBasedEncryptionHelper <plain text password> <Hub Server installation directory>
    Les résultats sont reportés sur la fenêtre du terminal.
  2. Pour mettre à jour le mot de passe de la base de données principale ou du stockage de référence opérationnelle, connectez-vous en tant qu'utilisateur
    cmx_system
    et exécutez l'instruction suivante :
    UPDATE C_REPOS_DATABASE SET PASSWORD = '<new_password>' WHERE USER_NAME = <user_name>; COMMIT;
  3. Exécutez le script
    postInstallSetup
    .

Échec du déploiement du fichier EAR du serveur Hub avec
concurrent.RejectedExecutionException

Il est possible que le déploiement du fichier EAR du serveur Hub échoue avec l'exception
concurrent.RejectedExecutionException
.
Pour résoudre le problème, augmentez la longueur de la file d'attente des tâches dans le fichier
standalone-full.xml
.
L'exemple suivant montre le paramètre
queue-length count
à modifier :
<long-running-threads> <core-threads count="50"/>
<queue-length count="300"/>
<max-threads count="50"/> <keepalive-time time="10" unit="seconds"/> </long-running-threads>

Impossible de démarrer JBoss ou de lancer la console Hub après l'installation

Après l'installation, JBoss peut ne pas redémarrer une fois que vous l'avez arrêté. Lorsque vous lancez la console Hub, elle ne parvient pas à démarrer et génère l'erreur suivante :
SIP-09070: Failed to initialize repository layer.
Pour résoudre ce problème, redémarrez JBoss en exécutant le code suivant dans un fichier de lots :
rmdir C:\<JBoss installation directory>\standalone\tmp /s /q \mkdir C:\<JBoss installation directory>\standalone\tmp C:\<JBoss installation directory>\bin\standalone.bat -c standalone-full.xml -b 0.0.0.0

Les utilisateurs de MDM Hub ne peuvent pas se connecter

Si vous recréez le schéma CMX_SYSTEM après l'installation du serveur Hub, MDM Hub ne peut pas reconnaître les mots de passe hachés. Les utilisateurs ne peuvent donc pas se connecter à MDM Hub.
Pour résoudre ce problème, réexécutez manuellement le script
postInstallSetup
. Le script permet aux mots de passe des utilisateurs de MDM Hub d'être de nouveau hachés et les utilisateurs peuvent donc se connecter.
Si vous ne souhaitez pas réexécuter le script
postInstallSetup
, exécutez les commandes suivantes pour migrer les mots de passe utilisateur vers des mots de passe hachés et créer des utilisateurs d'application.
Sous UNIX.
cd <
répertoire d'installation de MDM Hub
>/server/bin ./sip_ant.sh hash_users_passwords ./sip_ant.sh add_application_users
Sous Windows.
cd <
répertoire d'installation de MDM Hub
>\server\bin sip_ant.bat hash_users_passwords sip_ant.bat add_application_users

Le script PostInstallSetUp échoue, car le délai de déploiement du serveur ActiveVOS a expiré

Lorsque vous installez le serveur Hub, le processus de configuration post-installation peut échouer lorsque vous essayez de déployer le serveur ActiveVOS.
Pour résoudre ce problème, augmentez la valeur de la propriété
deploy.wait.time
dans le fichier
build.properties
dans le répertoire suivant :
Sous UNIX.
<infamdm installation directory>/hub/server/bin
Sous Windows.
<infamdm installation directory>\hub\server\bin

Démarrage ou arrêt de l'horodatage incorrect pour le stockage de référence opérationnelle

Lorsque vous exportez un stockage de référence opérationnelle que vous avez créé, le MDM Hub crée un fichier .dmp. Vous pouvez réutiliser le fichier .dmp du stockage de référence opérationnelle pour créer un deuxième stockage de référence opérationnelle. Les colonnes de date de début et de fin de la table C_REPOS_DB_VERSION du stockage de référence opérationnelle contiendront une date de début et de fin incorrectes. Vous pouvez ignorer cette erreur car cela n'affecte aucune fonctionnalité.

L'enregistrement du stockage de référence opérationnelle échoue en raison de l'expiration du délai de la connexion

Lorsque vous enregistrez le stockage de référence opérationnelle (Operational Reference Store - ORS) dans un nœud de grappe JBoss, l'enregistrement de l'ORS échoue avec une erreur de dépassement de délai de la connexion semblable à celle présentée ci-dessous :
SIP-10313: SIP-09061: Failed connecting with provider url abc03. java.net.ConnectException: JBAS012144: Could not connect to remote://abc03:9999. The connection timed out.
Pour résoudre ce problème, lorsque vous enregistrez un ORS, désactivez la sécurité d'administration JBoss, puis réactivez-la après l'enregistrement de l'ORS.

Le déploiement du serveur Hub échoue en raison de l'échec d'une opération composite JBoss

Lorsque vous déployez le serveur Hub dans le serveur d'application JBoss, le déploiement du serveur Hub échoue avec l'erreur suivante :
JBAS014653: Composite operation failed and was rolled back. Steps that failed:" => {"Operation step-2" => { "JBAS014671: Failed services" => {"jboss.web.deployment.default-host./cmx" => "org.jboss.msc.service.StartException in service jboss.web.deployment.default-host./cmx: org.jboss.msc.service.StartException in anonymous service: JBAS018040: Failed to start context Caused by: org.jboss.msc.service.StartException in anonymous service: JBAS018040: Failed to start context"
Pour résoudre ce problème, procédez comme suit :
  1. Arrêtez le serveur d'application JBoss.
  2. Utilisez un éditeur de texte pour ouvrir le fichier
    standalone.xml
    , qui se trouve dans le répertoire suivant :
    Sous UNIX.
    <JBoss Installation Directory>/standalone/configuration
    Sous Windows.
    <JBoss Installation Directory>\standalone\configuration
  3. Recherchez le code suivant :
    <subsystem xmlns="urn:jboss:domain:deployment-scanner:1.1"> <deployment-scanner path="deployments" relative-to="jboss.server.base.dir" scan-interval="5000"/> </subsystem>
  4. Ajoutez l'attribut
    deployment-timeout="300"
    , comme illustré dans l'exemple de code suivant :
    <subsystem xmlns="urn:jboss:domain:deployment-scanner:1.1"> <deployment-scanner path="deployments" relative-to="jboss.server.base.dir" scan-interval="5000"
    deployment-timeout="300"
    /> </subsystem>
  5. Enregistrez les modifications, puis démarrez le serveur d'application JBoss.
    La valeur du délai d'expiration du déploiement par défaut est
    60
    , qui devient alors
    300
    .
  6. Déployez le serveur Hub.

Le serveur Hub ne peut pas se connecter au schéma cmx_system

Pour vérifier que le serveur Hub ne peut pas se connecter au schéma cmx_system, consultez le journal du serveur d'application.
Par exemple, vous pouvez rencontrer l'erreur suivante, qui confirme que la base de données n'est pas accessible :
Caused by: java.sql.SQLException: ORA-28000: the account is locked DSRA0010E: SQL State = 99999, Error Code = 28,000
Pour résoudre ce problème, résolvez le problème de connexion à la base de données. Utilisez la console du serveur d'application pour tester la connexion à la base de données. Si vous ne pouvez pas résoudre la connexion au schéma cmx_system, recréez le schéma cmx_system.

Impossible de vérifier le besoin de marquer des enregistrements

Lorsque vous exécutez le processus de correspondance, vous pouvez recevoir l'erreur suivante :
SIP-16062: Failed to verify the need to tokenize records.
Vérifiez le paramétrage des variables d'environnement suivantes :
  • La variable d'environnement du chemin de bibliothèque doit contenir le chemin suivant :
    Sous UNIX.
    <
    infamdm_install_directory
    >/hub/cleanse/lib
    Sous Windows.
    <
    infamdm_install_directory
    >\hub\cleanse\lib
    La variable d'environnement du chemin de bibliothèque dépend du système d'exploitation :
    • AIX.
      LIBPATH
    • Suse ou RedHat Linux.
      LD_LIBRARY_PATH
    • Windows.
      PATH
  • La variable d'environnement
    SSAPR
    doit inclure le chemin suivant pour tous les utilisateurs :
    Sous UNIX.
    <
    infamdm_install_directory
    >/server_install_dir>/cleanse/resources
    Sous Windows.
    <
    infamdm_install_directory
    >\server_install_dir>\cleanse\resources

Erreurs de version major.minor lors du chargement du serveur de processus

Si plusieurs erreurs de console
major.minor
s'affichent lors de la tentative de chargement de
Serveur de processus
, vérifiez que la version correcte de Java est installée sur votre système.

Exception Java XA

Lorsque vous redémarrez JBoss après avoir installé le serveur Hub, l'exception suivante peut s'afficher :
WARN [com.arjuna.ats.jta] (Periodic Recovery) ARJUNA016027: Local XARecoveryModule.xaRecovery got XA exception XAException.XAER_RMERR: javax.transaction.xa.XAException at oracle.jdbc.xa.OracleXAResource.recover(OracleXAResource.java:730) at org.jboss.jca.adapters.jdbc.xa.XAManagedConnection.recover(XAManagedConnection.java:362) at org.jboss.jca.core.tx.jbossts.XAResourceWrapperImpl.recover(XAResourceWrapperImpl.java:185) at com.arjuna.ats.internal.jta.recovery.arjunacore.XARecoveryModule.xaRecoveryFirstPass(XARecoveryModule.java:597) at com.arjuna.ats.internal.jta.recovery.arjunacore.XARecoveryModule.periodicWorkFirstPass(XARecoveryModule.java:194) at com.arjuna.ats.internal.jta.recovery.arjunacore.XARecoveryModule.periodicWorkFirstPass(XARecoveryModule.java:140) at com.arjuna.ats.internal.arjuna.recovery.PeriodicRecovery.doWorkInternal(PeriodicRecovery.java:765) at com.arjuna.ats.internal.arjuna.recovery.PeriodicRecovery.run(PeriodicRecovery.java:377)
L'exception se produit si vous exécutez le script
sip_ant
et que vous n'avez pas accès au compte SYS de la base de données Oracle. Le script effectue des autorisations sur les tables système Oracle qui nécessitent le privilège de compte d'utilisateur SYS. Sans accès au compte SYS, vous ne pouvez pas configurer le schéma
cmx_system
ou
cmx_ors
.
Vous pouvez créer un compte privilégié associé au rôle DBA. L'utilisateur DBA peut exécuter les instructions d'autorisation manuellement, en dehors du script
sip_ant
. Pour éviter l'erreur d'exception XA dans le journal, accordez également les privilèges SELECT et EXECUTE aux utilisateurs
cmx_system
et
cmx_ors
 :
GRANT EXECUTE ON sys.dbms_lock TO <DBA user> with grant option;
Lorsque vous exécutez le script
sip_ant
pour créer la base de données principale MDM Hub (
cmx_system
) ou un magasin de référence opérationnelle (
cmx_ors
), l'erreur suivante peut s'afficher :
[exec] GRANT SELECT ON SYS.PENDING_TRANS$ TO cmx_system [exec] DBA user should have grantable privilege for PENDING_TRANS$ [exec] ERROR CODE: -1031 [exec] DECLARE [exec] * [exec] ERROR at line 1: [exec] ORA-01031: insufficient privileges [exec] ORA-06512: at line 24 [exec] ORA-06512: at line 27
Accordez les privilèges requis à l'utilisateur SYS, afin que celui-ci puisse exécuter
create_system
et
create_ors ant
comme cibles :
GRANT SELECT ON sys.pending_trans$ TO <DBA user> with grant option; GRANT SELECT ON sys.dba_pending_transactions TO <DBA user> with grant option; GRANT SELECT ON sys.dba_2pc_pending TO <DBA user> with grant option; GRANT EXECUTE ON sys.dbms_xa TO <DBA user> with grant option;

Exception de
Vérification d'adresse Informatica
au cours de la certification

Vérification d'adresse Informatica
génère une exception pendant la certification. Assurez-vous que la taille de la pile de JVM est suffisante.
  1. Accédez au répertoire bin dans le répertoire racine de JBoss.
  2. Ouvrez le fichier suivant dans un éditeur de texte.
    Sous UNIX.
    run.sh
    Sous Windows.
    run.bat
  3. Définissez la variable JAVA_OPTS comme suit :
    JAVA_OPTS=${JAVA_OPTS} -Xss2000k
  4. Enregistrez et fermez le fichier.

Le stockage de référence opérationnelle (Operational Reference Store - ORS) ne possède pas de moteur de flux de travail configuré

Si vous avez installé
MDM Hub
et si vous importez un
Stockage de référence opérationnelle
(ORS) depuis une version précédente, une erreur fatale indiquant que l'ORS ne possède pas de moteur de flux de travail configuré s'affiche. Cette erreur se produit car le moteur de flux de travail Siperian BPM n'est pas enregistré par défaut. Utilisez le gestionnaire de flux de travail pour enregistrer le moteur de flux de travail Siperian BPM sous le nom recherché par l'ORS.

Après le déploiement des fichiers .ear du serveur de processus, une erreur se produit

Après le déploiement du
Serveur de processus
sur un environnement Linux avec WebSphere 8.5.5.9, l'erreur suivante se produit :
Too many open files. Unable to start cleanse ear.
Augmentez la valeur du paramètre
ulimit
sous Linux, puis déployez le
Serveur de processus
.

Impossible d'ajouter les utilisateurs de l'application à l'aide du script sip_ant

Les applications suivantes sont concernées : Business Process Manager (anciennement ActiveVOS), Data Director, la console MDM Hub et l'outil de provisionnement.
Pour ajouter les utilisateurs de l'application, exécutez la commande
sip_ant
à l'aide du paramètre
add_app_users
.
Vous pouvez récupérer l'URL de connexion à partir de l'emplacement suivant :
hub/server/bin/build.properties (masterdatabase.jdbc.url)
)
Exécuter la commande suivante :
  • Sous Windows.
    sip_ant.bat add_app_users -Ddatabase.password=<cmx system password> -Dmaster.​connecturl="jdbc:oracle:thin:@<Database Host name>:<DB Port>:<SID>" -Dmaster.username=cmx_system​
  • Sous Unix.
    ./sip_ant.sh add_app_users -Ddatabase.password=<cmx system password> -Dmaster.​connecturl="jdbc:oracle:thin:@//<Database Host name>:<DB Port>:<SID>" -Dmaster.username=cmx_system​​
Exécutez la commande suivante sur SQL Server :
./sip_ant​.sh add_app_users -Ddatabase.password=<cmx system password> -Dmaster.connecturl="jdbc:sqlserver://<Database Host Name>:<DB Port>;DatabaseName=cmx_system" -Dmaster.username=cmx_system

Le dossier Certificats n'est pas créé

Le dossier Certificats n'est pas créé comme prévu après la sauvegarde du dossier Certificats existant à partir de
\infamdm\hub\server\resources\
et l'exécution du script
sip_ant.sh hash_users_passwords
.Ce problème se produit lorsque le script
sip_ant.sh hash_users_passwords
met à jour la table C_REPOS_USER dans
cmx_system
.
Pour résoudre ce problème, redémarrez le serveur d'applications. Par conséquent, le dossier Certificats est créé à l'emplacement attendu :
\infamdm\hub\server\resources\
.
Le dossier ne contient que le keystore
MDM_KEYSTORE_FILE_JKS
.
Pour générer d'autres certificats, exécutez la commande suivante :
./sip_ant.sh add_app_users