Troubleshooting Mid Tier reporting issues
You can run AR System reports and Web reports from the AR System Report Console. Web reports are of two types:
- Web reports created from the AR System Report console
- Reports created by using the BIRT ReportDesigner
For more information, see Reporting-on-Remedy-application-activity.
This section helps you obtain the appropriate logging and troubleshooting steps to either resolve the problem related to reporting or create a BMC Support case.
Symptoms
- You might get any of the following error while creating a Web report:
- ARERR 3600
- ARERR 9246
- ARERR 8753
- ARERR 361
- ARERR 8760
- Missing data or incorrect data in the Web report.
- The Web report displays incorrect format of exported files.
Scope
One or more users experience the problem.
Resolution
Perform the following steps to troubleshoot the Mid Tier reporting related issues:
Step | Task | Description |
1 | Clarify the problem | Analyze the following:
|
2 | Detailed steps to generate report | The way you maneuver to a report affects how the report is generated. |
3 | Enable logs and reproduce the problem. |
|
4 | Disable the logging | Use steps described in Enabling-logs-for-Mid-Tier-troubleshooting to disable the logging enabled in the previous step. Remember to disable the logs from each Mid Tier on which logging was enabled. |
5 | Collect the logs | Copy the logs to another location where you can review them so that they do not get overwritten. The logs may be large depending on volume of activity during the logging period. Collecting Mid Tier and tracelogger logs Zip up all the logs in the log location specified on the Log Settings page of Mid Tier Configuration Tool. C:\Program files\BMC Software\ARsystem\midtier\logs f For Linux, the default location is as follows: /opt/bmc/ARsystem/midtier/logs ReportEngine*.log — This log file is available in the same directory as the Mid Tier logs. Normally, it has no content. However, this log has content if an error occurs while creating a Web report. Copy of the report's definition file — This file is attached to the report's record in the Report form.
Def file of the associated form — If the report is created for a custom or overlay form, provide a def file of the form exported from Developer Studio. Webserver logs for webserver supporting the mid tierApache Tomcat logs are found in the <Tomcat installation>\logs folder. The Epoch Datestamp text file in the <Mid Tier Installation directory>\WEB-INF\platform\configuration folder. For example, 1573766599045.txt. |
6 | Create a BMC Support Case | Collect and send logs and detailed information when creating a case with BMC Support:
|
7 | Analyze the logs | You can review the logs and identify error messages or behaviors. Use the table below to troubleshoot based on your symptoms and error messages. |
After you determine a specific symptom or error message, use the following table to identify the solution:
Symptom | Where | Action | Reference |
---|---|---|---|
Web Report: Incident Detail report is not exported to XLS format, as expected. | Mid Tier 8.x - Mid Tier 9.1.04 | Update the plug-in jar files as described in the referenced article. | See the Knowledge Article Web Report: Incident Detail report does not export cleanly to XLS format When reporting an issue with exporting, provide the contents of the midtier/WEB-INF/platforms/plugins and midtier/WEB-INF/platform/conf folder. |
While creating a Web report, all fields on the form are not displayed in the Columns tab. | Mid Tier 9.x or later | This is working as designed. Certain core fields and fields with specific property settings are excluded from the list of available fields. For example, fields that begin with the character z. These fields indicate temporary workflow fields. | |
AR ODBC driver did not install | Mid Tier 9.x or later | Follow instructions on the referenced articles Important: ODBC drivers are not supported in SaaS environments. For on-premises deployments, we do not recommend using ODBC drivers. | See the Knowledge Article link How to manually configure 9.x AR System ODBC drivers on 64-bit Windows OS? For version 8.x, Remedy - Server - How to manually configure 8.x AR System ODBC drivers on 64-bit Windows OS?. |
Web report exports only 2000 records | Mid Tier 7.6.04 and later | The following parameters are available in the config.properties file to limit the number of entries in the report:
| See the Knowledge Article Web Report: Exporting Web report only exports 2000 records max |
How to edit Out-Of-the-Box ITSM Web reports with BIRT Report Designer | Mid Tier 7.6.04 or later | See reference article | See the Knowledge Article How to edit OOB ITSM Web reports with BIRT Report Designer. |