Reporting Troubleshooting Topics
This section describes the following reporting errors and the suggested solutions to fix these errors.
Failed to open the connection while generating reports
Symptom: After installing and integrating CABI BOXI with
DX NetOps Spectrum, you may get the following error, while running the reports:
“The viewer could not process an event. Failed to open the connection”
Cause: The Open Database Connectivity (ODBC) drivers are not configured properly during post installation phase.
Resolution: Run the post installation steps - Configure the Database Driver.
- Navigate to the CABI BOXI computer.
- Copy the CA_NVM_EXE folder from <CABI VCD>\utilities folder to the local disk.
- If you are on UNIX environment, set the CASHCOMP variable to the folder where CABI BOXI is installed. Example: /opt/cabi41
- Run the following command asCABI install user:Windows: nvm_boxi_post_install_windows.exeLinux: nvm_boxi_post_install_unix.shLog files (nvm_boxi_post_install.log, nvm_boxi_post_install.java.log) for this utility can be found in system temp path (in windows: %temp% and in Linux: /var/tmp/).
Failed to open the connection error in Tomcat log
Symptom: “Failed to open connection” exception in SRM tomcat log.
Cause: Due to incorrect MySQL driver paths, or due to permissions not granted to SRM server for that user.
Resolution: Grant privileges to SRM MySQL server and verify/correct the drivers path in CABI BOXI computer.
To grant privileges for SRM MySQL server, follow these steps:
- Navigate to $SPECROOT/mysql/bin in bash or command prompt.
- Log in to MySQL inDX NetOps SpectrumOneClick using the following command:./mysql –uroot –proot reporting
- Execute the following command:GRANT ALL PRIVILEGES ON *.* TO 'root'@'cabi hostname' IDENTIFIED BY 'root';
- Execute the following command:GRANT ALL PRIVILEGES ON *.* to 'CR_user'@'<cabi hostname>' identified by '0n3cl1Ck';For WEBI user:GRANT ALL PRIVILEGES ON *.* to 'WEBI_user'@'<IP address of the host>' identified by '0n3cl1Ck'
- FLUSH PRIVILEGES;
Verify/Correct the MySQL driver path in CABI BOXI computer:
- Navigate to the following directory:C:\Program Files (x86)\CA\SC\CommonReporting4\SAP BusinessObjects Enterprise XI 4.0\java\lib\external
- Verify if the file mysql-connector-java.jar is present.
- Verify if the path of this JAR file is correct in the following files:C:\Program Files (x86)\CA\SC\CommonReporting4\SAP BusinessObjects Enterprise XI 4.0/dataAccess/connectionServer/jdbc/mysql.sboC:\Program Files (x86)\CA\SC\CommonReporting4\SAP BusinessObjects Enterprise XI 4.0/dataAccess/connectionServer/jdbc/jdbc.sboC:\Program Files (x86)\CA\SC\CommonReporting4\SAP BusinessObjects Enterprise XI 4.0/java/CRConfig.xml
- If you modify any of the above files, then you must restart the BOXI tomcat using Central Configuration Manager (CCM).
No records found ‘or’ no data in reports
Symptom: No records found or failed to open connection error while running report. The well-known parameters (WKP_ProxyUserSecurity) value is NULL!!!.
This issue can be verified by right-clicking the SRM parameters page for any report and going to "View Source". Search for "WKP_ProxyUserSecurity"
Looks like this:
<input type="hidden" name="WKP_CustomLogo" value="NULL!!!">
<input type="hidden" name="WKP_ProxyUserSecurity" value="NULL!!!">
Cause: The Reports login credentials are not updated and Open Database Connectivity ODBC drivers are not configured properly.
Resolution: Run the post installation steps – Configure the Database Driver and then run the following steps.
- Go to the OneClick web page.
- Navigate to Administration -> Report Manager -> Manage Business Objects Content.
- Click "Update Content" and let it complete.
- Verify if the wkp parameters are set properly like below:<input type="hidden" name="WKP_CustomLogo" value="C:\win32app\Spectrum\custom\repmgr\logo.bmp"><input type="hidden" name="WKP_ProxyUserSecurity" value="Administrator">
No records found ‘or’ no data in reports due to security strings
Symptom: The global collections list is not populated in group report and “No Record Found” while running the other reports.
Cause/Hyposthesis: The security strings for the user might not be updated. Log in to SRM server MySQL then run the following query to check the security strings:
Select * from v_security_string_accessibility_by_landscape;
Or, to check for a user:
Select * from v_security_string_accessibility_by_landscape where user_name= “<USER_NAME>” . The result should contain at least (ADMIN, *UNKNOWN* and blank) otherwise it is indication that security strings are not updated for user.
Resolution:Restart the SRM OneClick server/tomcat so that all the security strings for each user get updated.
Maximum report processing limit reached
Symptom: Error in tomcat log while running the report – “The maximum report processing jobs limit configured by your system administrator has been reached”.
Cause: The limit of number of jobs running on CABI BOXI server has been reached.
Resolution: Increase the limit of the CABI BOXI server using the following steps:
- Log in to Central Management Console (CMC) as an "Administrator".
- Select "Servers" from the drop-down list.
- Go to Service Categories -->Crystal Reports Services.
- In Server Name, right-click on "<hostname>.AdaptiveJobServer" and select "Properties"
- In Crystal Reports 2013 Scheduling Service, change the Maximum Concurrent Jobs value from "5" to a higher number.
- Click "Save and Close”.
- Right-click on the server and select Restart to restart the server.
- If you still see the error, then increase the limit to a higher number.
Unable to compile class for JSP while running the report
Symptom: Error while running the reports in a fresh install or after upgrade: “Unable to compile class for JSP: an error occurred in the JSP file: /jsp/runReport.jsp or /jsp/listParameters.jsp”
Cause: The deployed jars and JSP files in
DX NetOps Spectrumand CABI are not in sync.
Resolution: Run the following steps.
- Run only the SpectrumUpdate command as mentioned in the documentation.
- Stop the CABI tomcat server.
- Delete "localhost" folder in CABI tomcat's work\Catalina folder.
- Back up UdmCAFApp.jar atC:\Program Files(x86)\CA\SC\CommonReporting4\tomcat\webapps\BOE\WEB-INF\eclipse\plugins\webpath.UdmCAFApp\web\WEB-INF\libwhere C:\Program Files (x86)\CA\SC\CommonReporting4\ is the CABI 4.x installation directory.
- Copy the NEW_UdmCAFApp.jar file as UdmCAFApp.jar which got downloaded into SpectrumUpdate utility folder to the following location:C:\Program Files (x86)\CA\SC\CommonReporting4\tomcat\webapps\BOE\WEB-INF\eclipse\plugins\webpath.UdmCAFApp\web\WEB-INF\lib
- Copy the listParameters.jsp and runReport.jsp files fromDX NetOps Spectrum<SPEC_Home>/tomcat/webapps/spectrum/repmgr/admin/ to the following location:C:\Program Files (x86)\CA\SC\CommonReporting4\tomcat\webapps\BOE\WEB-INF\eclipse\plugins\webpath.UdmCAFApp\web\jsp
- Start the CABI BOXI tomcat server.
HTTP 404, when right-click the report and select view
Symptom:HTTP 404 error, when you right-click on any report and select View in the BI Launch Pad.
Cause:The web.xml file present in CABI BOXI is not getting updated properly.
Resolution: Run the following steps to configure/correct the web.xml.
- Navigate to $BO_INST_PATH/CommonReporting4/tomcat/webapps/BOE/WEB-INF/eclipse/plugins/webpath.CustomParams/web/WEB-INF/
- Open the web.xml file in a text editor.
- Find the following section:<context-param><param-name>xmlFilePath</param-name><param-value>/opt/CA/SharedComponents/CommonReporting4cacaf</param-value></context-param>Note that the "CommonReporting4cacaf" should be separated with a forward slash.
- Update the line as below:<param-value>/opt/CA/SharedComponents/CommonReporting4/cacaf</param-value>
- Save the file and exit.
- Shut down the CABI Tomcat.On Windows, you utilize the Central Configuration Manager.On Linux, go to $BO_INST_PATH/CommonReporting4/sap_bobj/Execute: ./tomcatshutdown
- Go to $BO_INST_PATH/CommonReporting4/tomcat/work/Catalina/
- Delete the localhost folder.
- Start the CABI Tomcat.Windows use Central Configuration Manager again.Linux: ./tomcatstartup (from the same sap_bobj) directory as above.
"NoSuchMethodError" in Tomcat log
Symptom:Unable to run any reports due to the NoSuchMethodError error in tomcat log –“java.lang.NoSuchMethodError: com.crystaldecisions.sdk.occa.report.application.ReportAppSession.setReportEngineTypeValue(I)V at com.crystaldecisions.sdk.occa.managedreports.ras.internal.RASReportAppFactory.getReportAppSession(RASReportAppFactory.java:688) at com.crystaldecisions.sdk.occa.managedreports.ras.internal.RASReportAppFactory.openDocument(RASReportAppFactory.java:512)”
Cause: The Integration or “Update Content” failed to update the database log in credentials for the reports due to stale old CABI jars in
DX NetOps Spectrumtomcat.
- Stop the OneClick/tomcat SRM server.
- Navigate to $SPECROOT/tomcat/lib directory.
- Remove the rasapp.jar, rascore.jar, and Serialization.jar from $SPECROOT/tomcat/lib directory.
- Start the OneClick/tomcat SRM server.
- Wait for the tomcat to start and then go toDX NetOps SpectrumOneClick page ->Administration->Manage Business Objects Content and click "Update Content".
File I/O error while running reports
Symptom:Error while running few reports in CABI BOXI: “Error in the file xxxxx: File I/O error”
Cause: Report is unable to fetch the large number for data present in SRM database.
Resolution: Increase timeout, Cache & the records limit using the following steps.
- Log in to the Central Management Console (CMC).
- Click Servers.
- Right-click on Crystal Reports Cache Server and select properties.
- Set the Idle Connection Timeout (minutes) value to60.
- Set the Maximum Cache Size (KB) valueto 1028000.
- Click Save & Close.
- Right-click on Crystal Reports Processing Server 2013 and select Properties.
- Ensure that the field Database Records Read When Previewing or Refreshing is set to0(for unlimited).
- Set the Idle Job Timeout (minutes) value to60.
- Click Save & Close.
- Restart both the Cache and Processing Servers. (this step is not necessary if you are going to restart the SIA).
Report Generation Takes Long Time
Symptom: The parameter page opens slow or Report is running slow or MySQL queries are running slow.
Cause: Probably because of large database/records.
Resolution: Increase the performance of SRM MySQL server using the following recommended settings.
- Stop the Spectrum Processd and tomcat.
- Navigate to $specroot/mysql.
- Take back-up of existing my-spectrum.cnf.
- Update the my-spectrum.cnf with the following parameters:key_buffer = 512Mtable_cache = 1000wait_timeout = 300max_allowed_packet = 32Mquery_cache_size = 64Mquery_cache_type = 1sort_buffer = 64Mmyisam_sort_buffer_size = 64Mread_buffer_size = 64Mread_rnd_buffer_size = 6Mthread_concurrency=4
- Restart the Processd and tomcat
The above settings can be increased depending on the hardware resources available in the environment/machine.
When I export the report data into CSV format, I want to filter out Title, Header, Group Header, Summary, and Footer information.
- On the server where you have installed JasperReports Server, navigate to:<<CA Business Intelligence Installed Directory>>\apache-tomcat\webapps\jasperserver-pro\WEB-INF\classes.
- Open the jasperreports.properties file in Edit mode.
- Add the following properties at the end of the file.net.sf.jasperreports.export.csv.remove.empty.space.between.rows=true net.sf.jasperreports.export.csv.remove.empty.space.between.columns=true net.sf.jasperreports.export.csv.exclude.origin.band.1=pageHeader net.sf.jasperreports.export.csv.exclude.origin.report.1=* net.sf.jasperreports.export.csv.exclude.origin.band.2=pageFooter net.sf.jasperreports.export.csv.exclude.origin.report.2=* net.sf.jasperreports.export.csv.exclude.origin.band.3=columnHeader net.sf.jasperreports.export.csv.exclude.origin.report.3=* net.sf.jasperreports.export.csv.exclude.origin.band.4=columnFooter net.sf.jasperreports.export.csv.exclude.origin.report.4=* net.sf.jasperreports.export.csv.exclude.origin.band.5=lastPageHeader net.sf.jasperreports.export.csv.exclude.origin.report.5=* net.sf.jasperreports.export.csv.exclude.origin.band.6=summaryPageHeader net.sf.jasperreports.export.csv.exclude.origin.band.7=groupHeader net.sf.jasperreports.export.csv.exclude.origin.band.8=groupFooter net.sf.jasperreports.export.csv.exclude.origin.band.9=reportHeader net.sf.jasperreports.export.csv.exclude.origin.band.10=reportFooter net.sf.jasperreports.export.csv.exclude.origin.band.11=lastPageFooter net.sf.jasperreports.export.csv.exclude.origin.report.11=* net.sf.jasperreports.export.csv.exclude.origin.band.12=summaryPageFooter net.sf.jasperreports.export.csv.exclude.origin.band.13=summary net.sf.jasperreports.export.csv.exclude.origin.report.13=* net.sf.jasperreports.export.csv.exclude.origin.band.14=title net.sf.jasperreports.export.csv.exclude.origin.report.14=* net.sf.jasperreports.export.csv.parameters.override.IgnorePagination=true
- Save the changes to the properties file and exit.
- Restart the JasperReports Tomcat Server.After you have restarted the JasperReports Tomcat Server, run the reports you want to export, again.
- Export the report data into .csv format.The report data should be exported without the following information:
- Group Header
View the Modification History of Custom Configuration Files
You are interested in monitoring
Spectrum Report Managercustomization changes that are made through the configuration files. These files are located under
Log in to the MySQL client as ‘root’ and run the following command to see the chronology of changes for all the custom configuration files:
SELECT filename, FROM_UNIXTIME(last_modified/1000) as time FROM reporting.configchangelog ORDER BY filename, time;
Missing Outage Data Error
DX NetOps SpectrumReporting is missing outage data. The Tomcat log includes a message similar to the following message:
<$SPECROOT>\tomcat\logs\stdout.log: Jul 29, 2009 10:00:34 AM - SRMAvailabilityHandler: WARNING: Historical update has failed for domain = 0x400000 due to error = Connection to event domain timed out.
The outage data indicates one of the following situations:
DX NetOps SpectrumArchive Manager for the domain that is specified in the message is not running.
- A network connectivity issue between the OneClick web server and the Archive Manager on the domain that is specified in the message.
To resolve this issue, start the Archive Manager or resolve any network connectivity issues.
Spectrum Report Managerdetermines that the Archive Manager is running again, it automatically retrieves all the historical availability event data that it requires to update the reporting database.
When Archive Manager is not running, the
SpectroSERVERcaches the event data. When the Archive Manager is running again, the
SpectroSERVERsends it to the cached event data. However, the
SpectroSERVERevent cache is limited in size. If the Archive Manager is down for a prolonged period, event data can be lost. For more information, see the Database Management section.
Invalid Security Credentials Error
The following message appears when you try to run a report:
An error occurred at the server: The Page Server cannot logon to the CMS. This is due to invalid security credentials. Please verify your user ID and password.
The session has timed out. To resolve the issue, perform the following steps:
- ExitSpectrum Report Manager.
- Re-establish theDX NetOps SpectrumReporting session, and try running the report again.
Reset Report Manager Application Model
If the Main Location Server (MLS) is removed from a Distributed
Spectrum Report Managercan no longer assert events on the SRMApplication model. As a result, monitoring of
Spectrum Report Managerstatus through the SRMApplication model cannot occur.
Remove the model handle entry for the SRMApplication model from the registry table using the following MySQL command (logged on as ‘root’):
mysql>USE reporting; mysql>UPDATE registry SET SRM_Model = 0;
Resolving Java Error in Report Manager Sample (WEBI) Reports
A Java error is observed in the
Spectrum Report ManagerSample (WEBI) Reports. When a sample report is opened, following error message is displayed:
Java has discovered application components that could indicate a security concern -- Block potentially unsafe components (recommended).
If yes is selected, java blocks the result of the report from being displayed.
This issue occurs when running the browser on Windows with versions higher than Java 6 Update 17. To resolve this issue, perform the following steps:
- Open Java from Control Panel.
- Select the Advanced Tab
- Expand the Security option.
- Expand the Mixed Code option.
- Select 'Enable - hide warning and run with protections'.
This setting recovers the original format and allows you to use the most recent version of the JRE instead of rolling back to a previous version.
DX NetOps SpectrumReport Manager uses too much disk space, how can we limit the size of this database?
Symptom: The $SPECROOT/mysql/data/reporting directory is very large and taking up a major part of the disk space.
Resolution: CA suggests having a large enough hard space drive dedicated to Report Manager to store all the data required for your business needs.
DX NetOps SpectrumReport Manager also has an archiving utility. This utility is located under the Admin Tools tab of the Report Manager UI. This utility has three features: Purge, Archive, and All data.
Purge: Removes all data based on retention period days chosen.
Archive: Archives the data into the archive database based on the retention period days chosen.
All data: Keep all data in the reporting database and do not remove anything. All data basically means the archive will not run each night.
Purge is the recommended setting for users with disk space problems.
Purge removes all the data after the retention period chosen. For example, if you set the retention days to 90, then anything older than 90 days is removed on a nightly basis.
Archive can be used but this does not save space. Archive simply moves the data from one database to another. However, the archive database can be dropped. This action would make that amount of space available and upon restarting
DX NetOps Spectrumtomcat, the database will be rebuilt with 0 data.
To drop the archive database:
- Navigate to the $SPECROOT/mysql/bin directory.
- Type: ./mysql --defaults-file=my-spectrum.cnf -uroot -proot
- At the Mysql> prompt type: drop database archive;
- RestartDX NetOps SpectrumTomcat service.
DX NetOps SpectrumReport Manager does not start up due to errors relating to 'directory'
Symptom: Errors are seen in the $SPECROOT/tomcat/logs/stdout.log (catalina.out *nix) relating to parameter directory is not a 'directory'.
<date and time> (SRM/Startup/Container) (com.aprisma.spectrum.app.repmgr.web.servlet.SRMBootstrapServlet) - (ERROR) - Error occurred while initializing SRM components
com.aprisma.spectrum.app.repmgr.exceptions.SRMException: Error occurred while logging custom configuration changes
Caused by: java.lang.IllegalArgumentException: Parameter 'directory' is not a directory
Resolution: The reason for this error is because the ReportManagerInitializer code is looking for the directory $SPECROOT and then the custom/repmgr/config directory. If this error is seen, it means that directory does not exist.
To resolve, simply create the directory structure $SPECROOT/custom/repmgr/config/events
The config directory is the most important part, but the events directory is also needed. Once this is created, restart the
DX NetOps SpectrumTomcat Service.
Go to Services and restart
DX NetOps SpectrumTomcat
Go to $SPECROOT/tomcat/bin as the
DX NetOps Spectruminstall owner
Type - ./stopTomcat.sh
Once stopped type - ./startTomcat.sh
Once restarted, view the log to confirm Report Manager starts and there are no errors in the log file.