This repository contains a simple JBoss EAP 8 server setup that can be installed in a Linux or Windows environment with a simple script for running IBM ODM 9.5. For the insertion of the ilogDatasource and resDatasource, there is a need to install git bash on Windows
- Java must be installed (e.g., IBM Semeru JDK 21: Download here) https://developer.ibm.com/languages/java/semeru-runtimes/downloads/
- ODM_HOME is installed via Installation Manager. The .ear files (Decision Server and Decision Center) are retrieved from ODM_HOME, the root of the installation to locate the application EAR files
- JBOSS EAP 8.0 or 8.x is required and you can get the downloaded files from here https://developers.redhat.com/products/eap/download
- For Windows, GIT BASH is required to be installed
- JDBC driver for your DB must be installed and connected , see step 2b for links
Clone the repository onto the machine where you want to install ODM.
git clone https://github.ibm.com/automation-support/odm-jboss-9.5.git
Do NOT use the GitHub zip download; use git clone instead to avoid path issues.
For first time setup, please execute setupODM9.5. [sh | bat]
After the setup, you can run startODM9.5. [sh | bat]
Due to limitation of Window bash scripts, JBOSS_HOME and JAVA_HOME will be pulling from config.properties file in startODM9.5.bat . This config.properties is generated at the end of completion of the setupODM9.5.bat.
- Prompt User to Set JBOSS_HOME
- Prompt User to Set JAVA_HOME
- Prompt User to set ODM_HOME directory, it will search for executionserver/applicationservers/jboss and teamserver/applicationservers/jboss with the required .ear/.rar file for JBOSS to run and copies to $JBOSS_HOME\standalone\deployments
- Ensure there is 5: jrules-res-htds-JBOSS.ear jrules-res-management-JBOSS.ear jrules-res-xu-JBOSS.rar jrules-ssp-JBOSS.ear jrules-teamserver-JBOSS8.ear
- Copies the user properties files to %JBOSS_HOME%\standalone\config directory for basic user and login permission
- Prompts User to set GIT_BASH for the .bat/Windows as Linux already have this by default but not Windows
- Prompt user to select a db type, based on user input, it will copy a sample db from GITPROJECT_HOME/standalone/configuration to update the standalone.xml in %JBOSS_HOME%\standalone\config directory
In JBOSS the JDBC Drivers need to be mapped via the %JBOSS_HOME%\modules\system\layers\base\com
For example, in the Db2 %JBOSS_HOME%\modules\system\layers\base\com\ibm\db2\main you will find a jdbc driver, say and the name of the driver in that directory is db2jcc-db2jcc4.jar, the same name must be mapped in module.xml in the same directory
<resources>
<resource-root path="db2jcc-db2jcc4.jar"/>
</resources>
Given this logic, please download the JDBC driver of your option and map it manually
- If using H2 database, upon select it will automatically take it from ODM_HOME\shared\samplesServer\wlp\lib and move it to %JBOSS_HOME%\modules\system\layers\base\com\h2database\h2\main
- If using DB2 database, please download the DB2 Driver from https://www.ibm.com/support/pages/db2-jdbc-driver-versions-and-downloads and move it to %JBOSS_HOME%\modules\system\layers\base\com\ibm\db2\main
- If using MySQL database, please download the MySQL driver from https://dev.mysql.com/downloads/file/?id=544501 and move it to %JBOSS_HOME%\modules\system\layers\base\com\mysql\mysql\main
- If using Oracle database, please download the Oracle driver from https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html and move it to %JBOSS_HOME%\modules\system\layers\base\com\oracle\oracle\main
- If using Postgres database, please download the Postgrs driver from https://jdbc.postgresql.org/download/ and move it to %JBOSS_HOME%\modules\system\layers\base\com\postgres\postgres\main
After selection of the database, the script will modify your standalone.xml with the proper jdbc driver and datasource. If it is first time setup. You must still use the create schema api to fully set up the database. https://www.ibm.com/docs/en/odm/9.5.0?topic=cdsumf-create-database-schema-upload-message-files-by-using-rest-api
The different examples can be found in: ** GIT_Project_Path\standalone\configuration*datasource_type*\datasource.xml**
These are predefined users ready to use:
DC User
username: rtsUser
password: rtsUser+0
DC ADMIN
username: rtsAdmin
password: rtsAdmin+0
RES ADMIN
username: resAdmin
password: resAdmin+0
Super ADMIN:
username: odmAdmin
password: odmAdmin1!
If you like to create your own, you can do so by navigating to<JBOSS_HOME>/bin directory, open a command prompt and run the following add-user command:
Check documentation:
https://www.ibm.com/docs/en/odm/9.0.0?topic=jboss-configuring-decision-center
Linux:
./add-user.sh -a -u rtsAdmin -p rtsAdmin+0 -ro "rtsAdministrator"
Windows:
add-user.sh -a -u rtsAdmin -p rtsAdmin+0 -ro "rtsAdministrator"
The command line options are as follows:
-a : Add to the application realm.
-u : Username.
-p : Password. In JBoss, passwords must have at least one digit and one non-alphanumeric symbol.
-ro : Roles.
For the LDAP, we recommend contacting Redhat support team, and using Redhat distrubuted realms. https://access.redhat.com/solutions/6046641 In case of any issues, it is recommended to open an case with Redhat for Jboss EAP product to configure LDAP.
Linux:
./odm-9.5-jboss/startODM9.5.sh
Windows:
odm-9.5-jboss/startODM9.5.bat
http://<hostname>:8080/decisioncenter
http://<hostname>:8080/res
For issues relating specifically to this repository, please use the GitHub issue tracker. We welcome contributions following our guidelines.
The code found in this project are licensed under the Apache License 2.0.
© Copyright IBM Corporation 2025.