Configuring and Deploying ibi MDM On the Tomcat Server
To configure and deploy ibi MDM on the Tomcat server, follow the steps below:
- Procedure
-
Add the following VM parameters in
standalone.conf
(Linux) orstandalone.conf.bat
(Windows):--add-exports=java.base/jdk.internal.misc=ALL-UNNAMED
--add-exports=java.base/sun.nio.ch=ALL-UNNAMED
--add-exports=java.management/com.sun.jmx.mbeanserver=ALL-UNNAMED
--add-exports=jdk.internal.jvmstat/sun.jvmstat.monitor=ALL-UNNAMED
--add-exports=java.base/sun.reflect.generics.reflectiveObjects=ALL-UNNAMED
--illegal-access=permit
--add-opens jdk.management/com.sun.management.internal=ALL-UNNAMEDFor example, in
standalone.conf.bat
(Windows) set parameters as shown in the following sample:"JAVA_OPTS=%JAVA_OPTS% --addexports=
java.base/jdk.internal.misc=ALL-UNNAMED"
"JAVA_OPTS=%JAVA_OPTS% --add-exports=java.base/sun.nio.ch=ALL-UNNAMED"
"JAVA_OPTS=%JAVA_OPTS% --addexports=
java.management/com.sun.jmx.mbeanserver=ALL-UNNAMED"
"JAVA_OPTS=%JAVA_OPTS% --addexports=
jdk.internal.jvmstat/sun.jvmstat.monitor=ALL-UNNAMED"
"JAVA_OPTS=%JAVA_OPTS% --addexports=
java.base/sun.reflect.generics.reflectiveObjects=ALLUNNAMED"
"JAVA_OPTS=%JAVA_OPTS% --illegal-access=permit"
"JAVA_OPTS=%JAVA_OPTS% --add-opens
jdk.management/com.sun.management.internal=ALL-UNNAMED" -
Set the environment variable required for ibi MDM in the Tomcat server.
-
Specify max-post-size and max-parameters-count:
Parameter Name Description Example max-post-size For uploading a file either through a web service or the ibi MDM UI, the maximum file size limit is 10 MB. If you want to upload a file greater than 10MB, add the max-post-size parameter and change the file size. You also need to change the value of the Upload File Size Limit
property in the Configurator.For information about uploading a file through the ibi MDM UI, see the section "Creating Records" in ibi MDM User Guide.
<server name="default-server"> <http-listener name="default" socket-binding="http" redirect-socket="https" enable-http2="true" max-post-size="974247881"/> <https-listener name="https" socket-binding="https" security-realm="ApplicationRealm" enable-http2="true"/> <host name="default-host" alias="localhost"> <location name="/" handler="welcome-content"/> <filter-ref name="server-header"/> <filter-ref name="x-powered-by-header"/> </host> </server>
max-parameters-count The maximum number of parameters that can be added to the ibi MDM URL into the browser. Using this value, you can avoid the hash exposure used in the URL. This applies to both query and POST data parameters. By default, the size of the max-parameters-count is 1000. You can change the value as per your requirement.
Note: For ibi™ MDM Add-on for Global Data Synchronization, the number of limits might cross due to a huge number of attributes. Therefore you must set max-parameters-count="10000". For example,<http-listener name="default" socket-binding="http" redirect-socket="https" enable-http2="true" max-parameters-count="10000"/>
<server name="default-server"> <http-listener name="default" socket-binding="http" redirect-socket="https" enable-http2="true" max-post-size="974247881" max-parameters-count="5000"/> <https-listener name="https" socket-binding="https" security-realm="ApplicationRealm" enable-http2="true"/> <host name="default-host" alias="localhost"> <location name="/" handler="welcome-content"/> <filter-ref name="server-header"/> <filter-ref name="x-powered-by-header"/> </host> </server>
-
Specify the session timeout.
The Tomcat server provides the default session timeout of 30 minutes. To modify the session timeout as per your business requirement, modify the following entry in the application
web.xml
file. This file is present in the%TOMCAT_HOME%\conf
folder.<session-config>
<session-timeout>30</session-timeout>
</session-config> -
Configure EMS and start the server.
-
(Optional) Configure the ibi Patterns - Search server & start the Tomcat server.
-
To deploy ibi MDM custom pages to a common folder in the cluster environment, set the following parameter:
-DMQ_CUSTOMFORMS_HOME=MQ_COMMON_DIR
-
Download the following jars from Maven and copy them into the
Tomcat/lib
directory.-
tibjms.jar
-
database-specific JDBC jar
-
javax.xml.soap-api-1.4.0 (j2ee spec jar)
-
javax.jms-api-2.0 (j2ee spec jar)
-
activation-1.1.1.jar (j2ee spec jar)
-
saaj-impl-1.5.0.jar
-
stax-ex-2.1.0.jar
-
mail-1.4.jar
-
-
Add the following datasource resource configuration to
Tomcat/conf/context.xml
(PostgreSQL sample):<Resourcename="jdbc:/eCMDataSource" auth="Container" type="javax.sql.DataSource" maxTotal="100" maxIdle="30" driverClassName="org.postgresql.Driver" url="jdbc:postgresql://localhost:5432/trunk1" username="trunk1" password="trunk1" />
-
Update
ApplicationServerType
to TOMCAT in theConfigValues.xml
file. -
Start the Tomcat server.