Table of Contents

Search

  1. Preface
  2. Installation Overview
  3. Pre-Installation Tasks
  4. Hub Store Installation
  5. Hub Server Installation
  6. Hub Server Post-Installation Tasks
  7. Process Server Installation
  8. Process Server Post-Installation Tasks
  9. ActiveVOS Post-Installation Tasks for the Application Server
  10. ActiveVOS Post-Installation Tasks for the Business Entity Adapter
  11. Resource Kit Installation
  12. Resource Kit Post-Installation Tasks
  13. Troubleshooting the MDM Hub
  14. Uninstallation

Installation Guide for IBM DB2 with Red Hat JBoss

Installation Guide for IBM DB2 with Red Hat JBoss

Troubleshooting the Installation Process

Troubleshooting the Installation Process

If the installation fails, use the following information to troubleshoot the failure.

Cannot start JBoss or launch the Hub Console after installation

After installation, JBoss might not restart after you stop JBoss. When you launch the Hub Console, the Hub Console fails to launch and generates the following error:
SIP-09070: Failed to initialize repository layer.
To resolve the issue, run the following code in a batch file to restart JBoss:
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

MDM Hub users cannot login

If you re-create the CMX_SYSTEM schema after installation of the Hub Server, the MDM Hub cannot recognize the hashed passwords. As a result, users cannot log in to the MDM Hub.
To resolve the issue, run the
postInstallSetup
script again manually. This script ensures that the passwords of the MDM Hub users are hashed again and users can log in.
Alternatively, if you do not want to run the
postInstallSetup
script again, run the following commands to migrate the user passwords to hashed passwords and create application users.
On UNIX.
cd <
MDM Hub installation directory
>/server/bin ./sip_ant.sh hash_users_passwords ./sip_ant.sh add_application_users
On Windows.
cd <
MDM Hub installation directory
>\server\bin sip_ant.bat hash_users_passwords sip_ant.bat add_application_users
In a WebSphere environment, the MDM Hub user must have access and write permissions for the following directory:
<
MDM Hub installation directory
>/server/bin/resources/certificates

WebLogic instance redirects to Data Director

If you install MDM Hub on a WebLogic port other than 7001, the instance is redirected to Data Director with the following error:
javax.faces.application.ViewExpiredException: viewId:/config/config_login.jsf - View /config/config_login.jsf could not be restored.
To resolve the issue, set to the host name and the IP address of the WebLogic host. Do not use localhost.

PostInstallSetUp script fails because the ActiveVOS server deployment times out

When you install the Hub Server, the post-installation setup process might fail after trying to deploy the ActiveVOS server.
To resolve the issue, increase the value of the
deploy.wait.time
property in the
build.properties
file in the following directory:
On UNIX.
<infamdm installation directory>/hub/server/bin
On Windows.
<infamdm installation directory>\hub\server\bin

Operational Reference Store registration fails because the connection times out

When you register the Operational Reference Store (ORS) in a JBoss cluster node, the ORS registration fails with a connection timeout error similar to the following:
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.
To resolve the issue, when you register an ORS, disable the JBoss administrative security, and then enable the JBoss administrative security after ORS registration.

Hub Server deployment fails because JBoss composite operation fails

When you deploy the Hub Server in the JBoss application server, the Hub Server deployment fails with the following error:
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"
To resolve the issue, perform the following steps:
  1. Stop the JBoss application server.
  2. Use a text editor to open the
    standalone.xml
    file in the following directory:
    On UNIX.
    <JBoss Installation Directory>/standalone/configuration
    On Windows.
    <JBoss Installation Directory>\standalone\configuration
  3. Find the following code:
    <subsystem xmlns="urn:jboss:domain:deployment-scanner:1.1"> <deployment-scanner path="deployments" relative-to="jboss.server.base.dir" scan-interval="5000"/> </subsystem>
  4. Add the
    deployment-timeout="300"
    attribute as shown in the following sample code:
    <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. Save changes, and start the JBoss application server.
    The default deployment timeout value is
    60
    , which is changed to
    300
    .
  6. Deploy the Hub Server.

The Hub Server cannot connect to the cmx_system schema

To verify that the Hub Server cannot connect to the cmx_system schema, review the application server log.
To resolve the issue, resolve the database connection issue. Use the application server console to test the connection to the database. If you cannot resolve the connection to the cmx_system schema, re-create the cmx_system schema.

Failed to verify the need to tokenize records

When you run the Match process, you might receive the following error:
SIP-16062: Failed to verify the need to tokenize records.
Verify the following environment variable settings:
  • The library path environment variable must contain the following path:
    On UNIX.
    <
    infamdm_install_directory
    >/hub/cleanse/lib
    On Windows.
    <
    infamdm_install_directory
    >\hub\cleanse\lib
    The library path environment variable depends on the operating system:
    • AIX.
      LIBPATH
    • HP-UX.
      SHLIB_PATH
    • Solaris, Suse, or RedHat.
      LD_LIBRARY_PATH
    • Windows.
      PATH
  • The
    SSAPR
    environment variable must include the following path for all users:
    On UNIX.
    <
    infamdm_install_directory
    >/server_install_dir>/cleanse/resources
    On Windows.
    <
    infamdm_install_directory
    >\server_install_dir>\cleanse\resources

major.minor version errors when loading the Process Server

If you see multiple
major.minor
console errors when you try to load the
Process Server
, check that the system has the correct Java version installed.

Java XAException

When you restart JBoss after you install the Hub Server, the following exception might be generated:
javax.transaction.xa.XAException
You can ignore the exception.

Informatica Address Verification
exception during certification

Informatica Address Verification
generates an exception during certification. Ensure that the stack size for the JVM is sufficient.
  1. Navigate to the bin directory under the JBoss root directory.
  2. Open the following file in a text editor.
    On UNIX.
    run.sh
    On Windows.
    run.bat
  3. Set the JAVA_OPTS variable as follows:
    JAVA_OPTS=${JAVA_OPTS} -Xss2000k
  4. Save and close the file.

Operational Reference Store does not have a workflow engine configured

If you install the
MDM Hub
and then import an
Operational Reference Store
(ORS) from a previous version, you see a fatal error that indicates that the ORS does not have a workflow engine configured. This error occurs because the Siperian BPM workflow engine is not registered by default. Use the Workflow Manager to register the Siperian BPM workflow engine with the name that the ORS expects to find.

0 COMMENTS

We’d like to hear from you!