Introduction
In this article we have described the standard checklist with its troubleshooting steps for Web Report module , those will help to understand the cause of the problem & its basic understanding to prevent such problem in future.
Check List are described below in a table format.
Issue Type / Problem Type | What to check / Basic actions | How to check ( Quick Guide ) | Description / Remarks |
Report is not opening / Home is not opening. | Run Report SYNC |
| |
Entries in Ginapps.config for Report configuration | Ensure the following standard entries are present in Ginapps.config file.
IMPORTANT: If different URL is mentioned as ReportUI and ReportAPI, DO NOT change that. Check accessing those URL for verification and consult with technical team if required. | ||
Verify ReportAPI application | Access ReportAPI URL directly entering in browser. The format of ReportAPI URL is mentioned, change the server name or IP appropriately.
| ||
Verify ReportUI application | Access ReportUI URL directly entering in browser. The format of ReportAPI URL is mentioned, change the server name or IP appropriately
| ||
Test Data Source connection string under Server tab. | Go to Server > Data > Source (Expand) >
| ||
Report path test connection under Server tab. | Server tab > General > Main Settings > Test the Report Path using the Icon. | ||
GinesysWebReprts.xml file is present or not | Find the file from the below path.
| ||
Physical Path , AppPool , Standard Folder Security set of ReportAPI folder. | Verify the physical path of ReportAPI folder and its AppPool from IIS Manager. Verify the folder Security of ReportAPI folder. Standard set of security should be like :
| Physical path & App pool is mentiond in the Advance settings of each Web application ( ReportAPI, ReportUI etc.) Select any Web Application > At the right side pane we see the Advance settings > Enter into it & check the physical path of folder of that web application along with app pool. | |
Physical Path , AppPool , Standard Folder Security set of ReportUI folder. | Verify the physical path of ReportUI folder and its AppPool from IIS Manager. See in the description column. Right click on any folder ( ReportAPI , ReportUI etc. ) > Properties > Security tab > Check the below Set of Security.
| Physical path & App pool is mentiond in the Advance settings of each Web application ( ReportAPI, ReportUI etc.) Select any Web Application > At the right side pane we see the Advance settings > Enter into it & check the physical path of folder of that web application along with app pool. | |
Report SYNC is not happening | GinesysWebReprts.xml file is present or not. | Find the file from the below path.
| |
Folder Security set of ReportUI & ReportAPI. | Right click on any folder ( ReportAPI , ReportUI etc. ) > Properties > Security tab > Check the below Set of Security.
| ||
Report Scheduler service is working | GinesysReportScheduler Service state. | Go to > RUN > Services.msc > Find the Report scheduler service > Check is it stopped or not installed. If Service is not installed , see in the description section link. | If GinesysReportScheduler service is not installed then you need to install it. Please follow the below reference for Report Scheduler Service installation. |
eWebReportsScheduler.exe file is present or not | Find the file from the below path.
| ||
eWebReportsScheduler.xml file | Find the file from the below path.
| ||
Test connection of Schedule Remoting Host | Server > General > Main Settings > Scheduler Settings > Find Schedule Remoting host > Test the connection. | ||
Enable Report Scheduling Option is True | Server > General > Main Settings > Scheduler Settings > Find Enable Report scheduling > It should be set as True. | ||
eWebReportsScheduler.xml , eWebReportsScheduler.exe , eWebReportsScheduler.exe.config – this files along with all DLL files under Ginesys Report folder needs to be unblock. | Open CMD with Admin privilege and run the below command. Type Powershell ( press Enter ) Type below command.
| If Report Server or Report Installation folder location is different then change the mentioned path accordingly in How to check section. | |
Report Scheduler Mail is not happening / Schedule Report goes to Abend State. | GinesysReportScheduler Service state | RUN > Services.msc > Find the Report scheduler service > Check the service it stopped or not installed. If Service is not installed , see in the description section link. | If GinesysReportScheduler service is not installed then you need to install it. Please follow the below reference for Report Scheduler Service installation. |
Test mail credentials in SMTP mailer from Launchpad. | Open Launchpad > SMTP Mailer > Click on Stop Service > Click on Pencil t button for editing > Put your credentials & test the smtp details. ( Do not save any details after checking on this window ) . | ||
eWebReportsScheduler.exe file | Find the file from the below path.
| ||
SMTP Mail settings in eWebReportsScheduler.xml file | Find the file from the below path and verify the SMTP details.
| ||
SMTP SSL settings in eWebReportsScheduler.xml file. | The common known SMTP ports are used in mail configuration i.e. 587,465,25. SSL ports : 587 , 465 Non SSL ports : 25 If found SSL ports are associated with SMTP server name. then SSL tag should be set as true accordingly. | ||
eWebReportsScheduler.exe.config file settings under Runtime tag for mail attachment failure. | Below xml tag needs to be add under <Runtime> tag from the the following path. <loadFromRemoteSources enabled="true"/> path : | ||
eWebReportsScheduler.xml , eWebReportsScheduler.exe , eWebReportsScheduler.exe.config – this files along with all DLL files under Ginesys Report folder needs to be unblock. | Open CMD with Admin privilege and run the below command. Type Powershell ( press Enter ) Type below command.
| If Report Server or Report Installation folder location is different then change the mentioned path accordingly in How to check section. |
Add Comment