Troubleshooting the Normalization Engine plug-in

The Normalization Engine plug-in provides logging information for different modes of normalization. This plug-in has API logging, Continuous logging, and Batch mode logging. Based on the need of the situation, appropriate logging can be set to Debug level by using the Normalization Engine plug-in interface. All the log files are stored in the <InstallerFolder>/AtriumCore/Logs folder.

Related topic

BEST FAQ on BMC CMDB Suite - Normalization (Support logon ID required)

The log file details are given below:

Neapi.log — API logging
neContinuous.log — Continuous mode logging
neBatch.log* — Batch mode logging
nePluginServer.log — General plug-in related errors

The following is a sample log file of the Normalization Engine plug-in server:

<PLUGINSVR> <TrID:                               > <TNAME: Thread-119               > <INFO > <ARPluginServerConfiguration                       > <                  ARPluginServerConfiguration.java:3852      > /* 2025-06-11T02:30:33.448-0700 */ <TrID:                               > Setting Name Server-Plugin-Alias was not read from the file, adding it in with value [BMC.FILTERAPI.NORM.ENGINE BMC.FILTERAPI.NORM.ENGINE normplugin:9555, ARSYS.ARDBC.PENTAHO ARSYS.ARDBC.PENTAHO platformplugin:9999, ARSYS.ARF.REPORTSCHEDULER ARSYS.ARF.REPORTSCHEDULER reportplugin:9991, ARSYS.AREA.AREALDAP ARSYS.AREA.AREALDAP platform-fts-0.platform-fts:9900, ARSYS.ARDBC.LDAP ARSYS.ARDBC.LDAP platformplugin:9999, BMC.ARDBC.ATRIUM.AIS BMC.ARDBC.ATRIUM.AIS aisplugin:9556, RMDY.ITSM.RKM.REGISTRATION RMDY.ITSM.RKM.REGISTRATION rkmplugin:9556, ARSYS.ARF.PARSEPARAMETERS ARSYS.ARF.PARSEPARAMETERS reportplugin:9991, BMC.ARDBC.DEPRECATION.PLUGIN BMC.ARDBC.DEPRECATION.PLUGIN atriumplugin:9556, ARSYS.ARF.REGISTRY ARSYS.ARF.REGISTRY platformplugin:9999, BMC.FILTERAPI.EVENT_ENGINE BMC.FILTERAPI.EVENT_ENGINE atriumplugin:9556, ARSYS.FILTERAPI.SMARTREPORTINGUSERS ARSYS.FILTERAPI.SMARTREPORTINGUSERS rkmplugin:9556, AREA AREA platform-fts-0.platform-fts:9900, ARSYS.ARF.SECURITY.ATTACHMENTVALIDATION ARSYS.ARF.SECURITY.ATTACHMENTVALIDATION platformplugin:9999, BMC.ARDBC.ATRIUM.SERVICECONTEXT BMC.ARDBC.ATRIUM.SERVICECONTEXT atriumplugin:9556, BMC.ARDBC.ATRIUM.API BMC.ARDBC.ATRIUM.API atriumplugin:9556, ARSYS.ARF.RSAKEYPAIRGENERATOR ARSYS.ARF.RSAKEYPAIRGENERATOR platformplugin:9999, ARSYS.ARF.PUBLISHREPORT ARSYS.ARF.PUBLISHREPORT reportplugin:9991, CMDB.ARDBC.PENTAHO CMDB.ARDBC.PENTAHO platformplugin:9999, ARSYS.ARF.ARMIGRATE ARSYS.ARF.ARMIGRATE rkmplugin:9556, ARSYS.ARDBC.SG.MANAGEMENT.UTILITY ARSYS.ARDBC.SG.MANAGEMENT.UTILITY platformplugin:9999, DSM.FILTER DSM.FILTER rkmplugin:9556, ARSYS.AREA.RSSO ARSYS.AREA.RSSO platform-fts-0.platform-fts:9900, BMC.FILTERAPI.NOE BMC.FILTERAPI.NOE atriumplugin:9556, ARSYS.ALRT.TWITTER ARSYS.ALRT.TWITTER platformplugin:9999, ARSYS.FILTERAPI.SG.MANAGEMENT.ACTION ARSYS.FILTERAPI.SG.MANAGEMENT.ACTION platformplugin:9999, ARSYS.ARF.TWITTER ARSYS.ARF.TWITTER platformplugin:9999, ARSYS.ARF.QUERYPARSER ARSYS.ARF.QUERYPARSER reportplugin:9991, ARSYS.ARDBC.ARREPORTENGINE ARSYS.ARDBC.ARREPORTENGINE reportplugin:9991, ARSYS.ARDBC.REGISTRY ARSYS.ARDBC.REGISTRY platformplugin:9999]
<PLUGINSVR> <TrID:                               > <TNAME: Thread-119               > <INFO > <ARPluginServerConfiguration                       > <                  ARPluginServerConfiguration.java:3852      > /* 2025-06-11T02:30:33.455-0700 */ <TrID:                               > Setting Name Attachment-System-Exception-List was not read from the file, adding it in with value [AR System Publish Report(90104), AR System Resource Definitions(41103), UDM:Import(46093), UDM:ImportProcessor(46093), Data Visualization Definition(41054), Data Visualization Module(41006), Data Visualization System Files(41024), Report(2000012), Report Definition(2010012), AR System Administration: Server Information(16356), AR System Administration: Server Information:Save Attachment(16362), AR System User Central File(20020), Visualizer Module Images(42083), Visualizer Module Registration(42004), AR System Administration: Add Or Remove Licenses(15437), AR System License: Save Produse Attachment(16362), AR System Licenses(15437), AR System Licenses(15438), AR System Licenses Audit(15437), AR System Licenses Audit(15438), AR System Licenses Console(15437), AR System Licenses Console(15438), AR System Message Catalog(158), SHARE:Application_Interface(7009), AR System Version Control: Object Modification Log(2828), RDA:DeploymentPackageDetails(301766400), RDA:Deployment Management Console(301637000), RDA:Deployment Management Console(301637100),AR System Single Point Deployment Payload(49105), AR System File(49105), Chatbot Configuration(1839), AR System Email Templates(18124), Cognitive Service Chatbot Knowledge Article Template(1819), BMC.CORE.CONFIG:BMC_Icon_Component(530019400), AR System Midtier Cache(49503), AR System Upgrade Tracker(43009), NGC:DataSource(301400400), NGC:DataSource(302300037)]
<PLUGINSVR> <TrID:                               > <TNAME: Thread-119               > <INFO > <ARPluginServerConfiguration                       > <                  ARPluginServerConfiguration.java:3852      > /* 2025-06-11T02:30:33.455-0700 */ <TrID:                               > Setting Name Debug-mode was not read from the file, adding it in with value [4]
<PLUGINSVR> <TrID:                               > <TNAME: Thread-119               > <INFO > <ARPluginServerConfiguration                       > <                  ARPluginServerConfiguration.java:3852      > /* 2025-06-11T02:30:33.455-0700 */ <TrID:                               > Setting Name Db-Host-Name was not read from the file, adding it in with value [<serverName>.bmc.com]
<PLUGINSVR> <TrID:                               > <TNAME: Thread-119               > <INFO > <ARPluginServerConfiguration                       > <                  ARPluginServerConfiguration.java:3852      > /* 2025-06-11T02:30:33.455-0700 */ <TrID:                               > Setting Name Broker-Send-Failed-No-Space-After-Timeout was not read from the file, adding it in with value [30]
<PLUGINSVR> <TrID:                               > <TNAME: Thread-119               > <INFO > <ARPluginServerConfiguration                       > <                  ARPluginServerConfiguration.java:3852      > /* 2025-06-11T02:30:33.455-0700 */ <TrID:                               > Setting Name Disable-User-Cache-Utilities was not read from the file, adding it in with value [F]
<PLUGINSVR> <TrID:                               > <TNAME: Thread-119               > <INFO > <ARPluginServerConfiguration                       > <                  ARPluginServerConfiguration.java:3852      > /* 2025-06-11T02:30:33.455-0700 */ <TrID:                               > Setting Name Filter-Max-Stack was not read from the file, adding it in with value [10000]
<PLUGINSVR> <TrID:                               > <TNAME: Thread-119               > <INFO > <ARPluginServerConfiguration                       > <                  ARPluginServerConfiguration.java:3852      > /* 2025-06-11T02:30:33.455-0700 */ <TrID:                               > Setting Name Broker-Max-Memory-Usage was not read from the file, adding it in with value [1024]
<PLUGINSVR> <TrID:                               > <TNAME: Thread-119               > <INFO > <ARPluginServerConfiguration                       > <                  ARPluginServerConfiguration.java:3852      > /* 2025-06-11T02:30:33.455-0700 */ <TrID:                               > Setting Name Approval-Server-Suspended was not read from the file, adding it in with value [F]
<PLUGINSVR> <TrID:                               > <TNAME: Thread-119               > <INFO > <ARPluginServerConfiguration                       > <                  ARPluginServerConfiguration.java:3852      > /* 2025-06-11T02:30:33.455-0700 */ <TrID:                               > Setting Name Locale-List was not read from the file, adding it in with value [en]
<PLUGINSVR> <TrID:                               > <TNAME: Thread-119               > <INFO > <ARPluginServerConfiguration                       > <                  ARPluginServerConfiguration.java:3852      > /* 2025-06-11T02:30:33.455-0700 */ <TrID:                               > Setting Name Application-Enable was not read from the file, adding it in with value [T]
<PLUGINSVR> <TrID:                               > <TNAME: Thread-119               > <INFO > <ARPluginServerConfiguration                       > <                  ARPluginServerConfiguration.java:3852      > /* 2025-06-11T02:30:33.455-0700 */ <TrID:                               > Setting Name Db-Server-Port was not read from the file, adding it in with value [5432]
<PLUGINSVR> <TrID:                               > <TNAME: Thread-119               > <INFO > <ARPluginServerConfiguration                       > <                  ARPluginServerConfiguration.java:3852      > /* 2025-06-11T02:30:33.455-0700 */ <TrID:                               > Setting Name Full-Text-Disable-Indexing was not read from the file, adding it in with value [F]
<PLUGINSVR> <TrID:                               > <TNAME: Thread-119               > <INFO > <ARPluginServerConfiguration                       > <                  ARPluginServerConfiguration.java:3852      > /* 2025-06-11T02:30:33.455-0700 */ <TrID:                               > Setting Name Escalation-Log-File was not read from the file, adding it in with value [aresc.log]
<PLUGINSVR> <TrID:                               > <TNAME: Thread-119               > <INFO > <ARPluginServerConfiguration                       > <                  ARPluginServerConfiguration.java:3852      > /* 2025-06-11T02:30:33.455-0700 */ <TrID:                               > Setting Name Record-Server-Events was not read from the file, adding it in with value [1;]

To troubleshoot the Normalization Engine plug-in

Use this information if the Normalization Engine plug-in is not working correctly.

In the <ROOT>\Software\AtriumCore\<hostName>\Logs\AtriumPlugin.log file, search for the message, Successfully loaded Java Plugin BMC.FILTERAPI.NORM.ENGINE.
If the entry is missing, some jar files might not have been installed.
Run the BMC Helix CMDB installer again.

To troubleshoot the dataset configuration

Verify the setting for Inline error handling:
- If set to Reject, CMDB is not updated if there is a normalization error. Enable logging to see the error messages.
- If set to Accept, CMDBis updated even if there is a normalization error.
If the Normalization mode is set to Continuous, verify that the event and time is configured.

To troubleshoot the Normalization Engine initialization errors

When you start the AR System server after installing BMC Helix CMDB, you might encounter the following error in the AtriumPlugin.log:

<BMC.FILTERAPI.NORM.ENGINE>Initialization of NE is not done. Will try again after 2 minutes WARN ( ?:? ) - <BMC.FILTERAPI.NORM.ENGINE>Maximum number of attempts reached while trying to initialize - stopped initializing

This error might occur due to the one or more of the following reasons:

The User ID and Password that you specified for the AR System server are incorrect.
The Normalization Engine is waiting for the AR System server to complete the start up process. Therefore, it could not connect to the AR System server.
The Product Catalog version that you installed is not the latest.

Perform the following steps to resolve this error:

Examine the neAPI.log file for additional error details.
If the error occurred due to incorrect user name and password, try to connect to the AR System server with User ID that does not have a password (for example, the Demo user).
If the error occurred due to connection issues, verify that the AR System server is running by using the Ping MS DOS command from the computer on which the Normalization Engine is installed.
If you are not able to connect to the server, your network might be down. This error can also occur if the Normalization Engine is accessing another AR System server.
From the SHARE:Application_Properties form, verify that the Product Catalog version that you have installed is the latest.

For more information about Product Catalog version compatibility, see Remedy Compatibility Tables.

To troubleshoot other common errors

The following table lists the errors you might face with the Normalization Engine plug-in and the resolution for those errors.

Issue or Error	Resolution
Plug-in server not responding	When you see the Plug-in server not responding error message, the Normalization Engine plug-in is either not started or taking too long to respond. Check the nePluginServer.log file for the message Initialization complete - Normalization Engine is ready to process requests. If you do not see this error message, the plug-in has not started. At this time, scan the log file for any obvious error messages like Authentication failed or Port in use. Based on further scanning, appropriate steps can be taken. Note: The Plug-in server not responding error occurs only if log level is set to Full. If the plug-in starts successfully, use the plug-in interface to change the API level to Debug and perform the test again. Check the neApi.log. If you do not find entries in the log file, it means that the plug-in is not receiving the calls. In either scenario, involve the development team for further resolution.
Batch job does not normalize all CIs.	When you run a batch job it normalizes only CIs with the status Failed CIs, Not Normalized, and Modified since last normalization. If you want to normalize all the CIs, select Normalize all instances in the SystemConfig tab and restart the job.
Server group environment NE does not connect.	Normalization plug-in uses Server-Connect-Name from AR System Administration:AR System Configuration Generic UI form in the server group environment. Make sure that it can be pinged from the machine where the Normalization Engine plug-in is running.