Application Configuration

The application level configurations of the Integration Monitor can be found in the files app-server-1.0.0/conf/jetty.xml and app-server-1.0.0/conf/Config.groovy. Open them using a text editor and configure the following parameters.

Host name and port

Configure the hostname and port of the Integration Monitor as follows.

In jetty.xml

<Set name="Host"><Property name="uconsole.host" default="host_name"/></Set>
<Set name="Port"><Property name="uconsole.port" default="8043"/></Set>

In Config.groovy

grails.serverURL    = "https://host_name:8043/imonitor"

User Base

If LDAP based user management is in use, configure the LDAP related properties such as host name, search base, domain and super user group as follows in Config.groovy file.

adroitlogic.isuite.user.base                    = 'ldap'
adroitlogic.isuite.ldap.skip.authentication     = false
adroitlogic.isuite.ldap.skip.credentialsCheck   = false
adroitlogic.isuite.ldap.allowEmptyPasswords     = false
adroitlogic.isuite.ldap.ldapHost                = 'ldap://ad.adroitlogic.com:389'
adroitlogic.isuite.ldap.searchBase              = 'CN=Users,DC=adroitlogic,DC=com'
adroitlogic.isuite.ldap.domain                  = 'adroitlogic.com'
adroitlogic.isuite.super.user.group             = 'CN=ESBAdmins,CN=Builtin,DC=adroitlogic,DC=com'

Else if database based user management is in use, configure the related properties as follows in Config.groovy file.

adroitlogic.isuite.user.base                    = 'db'
adroitlogic.isuite.super.user.group             = 'Super User Group'

JMX Authentication

If the UltraESB instances are using LDAP based JMX authentication, configure it as follows.

ultra.jmx.base                          = 'ldap'

Else if the access file based authentication is in use, configure it as follows.

ultra.jmx.base                          = 'file'
// Specify the usernames and passwords for each ultraesb node in the following format
ultra.jmx.username.node_name = "admin"
ultra.jmx.password.node_name = "admin"

// Specify a default username and password for nodes which have not specified individually above
ultra.jmx.username.default = "default"
ultra.jmx.password.default = "default"

Zookeeper and clustering

Configure the Zookeeper related properties such as quorum URL and domain as follows. If there are more than one zookeeper servers belongs to the quorum, they should be separated by commas.

adroitlogic.isuite.zookeeper.url    = "zk_host_1:2181,zk_host_2:2181,zk_host_3:2181"
adroitlogic.isuite.zookeeper.domain = "default"

If the UltraESB deployment consist of more that one node groups with (such as primary group and secondary failover group), configure the following property with the name of the primary node group. Else remove or comment out that property.

If this property is configured, Integration Monitor will always give priority to the nodes belong to primary group when retrieving JMX level information.

adroitlogic.isuite.nodeGroup.primary = "primary"

If there are any deployment projects that are used across multiple spaces as common framework level projects, configure the following property with their names as a list of Strings. Else keep an empty list.

adroitlogic.isuite.deploymentprojects.common = ["EMW-Framework]

License Management

The following properties contain the values that are being used for the licensing manager of Integration Monitor. It is advisable to keep their default values, unless requested by AdroitLogic.

adroitlogic.license.server.url      = "http://licenseserver.adroitlogic.com"
adroitlogic.license.server.https    = false
adroitlogic.license.file.location   = "conf/"

The download bundle of the Integration Monitor by default contains an evaluation license key for 30 days. In addition to that, at the time of the download you will receive a file named client.key.properties via email which contains a unique client key for the registered email. Place this file in app-server-1.0.0/conf/ directory.

At the expiration of the 30-day evaluation license, please contact AdroitLogic to obtain a new license or to extend your license duration.

Elasticsearch

Configure the Elasticsearch cluster host names and ports list as key-value pairs.

adroitlogic.isuite.stat.elasticsearch = ["es_host_1": 9300, "es_host_2": 9300]

Integration Monitor executes a cron task which will clean up the expired elasticsearch documents in order to preserve system resources. The expiry time of the documents and the schedule of this task (as a cron expression) can be configured as follows.

adroitlogic.isuite.stat.esExpiryDays    = 180
adroitlogic.isuite.stat.esClearCron     = "0 55 23 * * ?"

Logging

By default the logs of Integration Monitor will be on INFO level and will be written to app-server-1.0.0/logs/app-server.log file. These can be changed by modifying the following properties of app-server-1.0.0/conf/log4j.properties file.

log4j.category.org.adroitlogic=INFO
log4j.appender.LOG_APPENDER.File=logs/app-server.log