Remarks

Run Report SYNC

• Click on Repository tab Go to Ginesys Web > Report > Repository and then run SYNC.

• Restart IIS (Follow either step)

  • Open CMD ( in Run as admin privilege), type >IISRESET > Press Enter.

  • Open Windows Services (services.msc), restart the service ‘World Wide Web Publishing Service’

Entries in Ginapps.config for Report configurationNote the error message appeared if any for tech team investigation.

Verify Report configuration entries in GinApps.config

Ensure the following standard entries are present in Ginapps.config file.
Path: \GSL\GINESYS12\Shared\Ginapps.config

Deployment 1: Ginesys and Report on same server

<add key="ReportURI" value="/GinesysReportUI/" />
<add key="CustomPort" value="" />

Deployment 2: Ginesys and Report on different server

<add key="ReportURI" value="http://<Report Server host IP>/GinesysReportUI/" />
<add key="ReportAPI" value="http://<Report Server host IP>/GinesysReportAPI/API.asmx" />
<add key="CustomPort" value="" />

IMPORTANT: If different URL is mentioned as ReportUI ReportURI and/or ReportAPI, DO NOT proceed tochange thatthe URL immediately. 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

http://<Server name or IP>/GinesysReportAPI/Api.asmx

Verify ReportUI application

Access ReportUI first (Check 4 & 5). If applications are accessible then do not change the URLs.

Correct the the URL if inappropriately mentioned.

Check presence of GinesysWebReprts.xml file

Find the file available at following mentioned path

\GSL\GINESYS12\GinesysReport\ReportUI\Config\GinesysWebReports.xml

If missing, forward to technical team.

Verify access to GinesysReportUI application
Test GinesysWebReprts.xml

• Open the Exago Admin page accessing GinesysReportUI application directly from web browser. The URL of GinesysReportUI is as mentioned in GinApps.Config. If host name or IP is not mentioned in URL then add application server name or IP in following mentioned format.
  Ideally the Exago Admin page should be loaded.

http://<IP>/GinesysReportUI/Admin.aspx

*Note: Ensure the server IP is being used while testing the access.

• Once Exago Admin page opens, then verify Ginesys Report configuration XML. In top left corner, under the Exago logo, load the file GinesysWebReports.xml from drop down. All configuration should be loaded.
  

Note the error message appeared if any for tech team investigation.

Verify access to GinesysReportAPI application

Access GinesysReportAPI URL directly entering in browser. The format of GinesysReportAPI URL is mentioned, change the server name or IP appropriatelyURL should similar to Ginesys ReportUI URL. Replace application same and page name as mentioned in following format.
Ideally a list of supported API operations should be loaded.

Report path test connection under Server tab.

Server tab > General > Main Settings > We can find the Report Path line > Test the Report path.

GinesysWebReprts.xml file is present or not

\GSL\GINESYS12\GinesysReport\ReportUI\Config\GinesysWebReports.xml

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 :

1. SYSTEM ( Full Permission)

2. Creator Owner (Special Permission)

3. Administrators (Full permission)

4. Users (Read& Execute , List of Folders , Read , Special Permission)

5. IIS_IUSRS (Full Permission)

Physical Path , AppPool , Standard Folder Security permission of ReportUI folder.

Verify the physical path of ReportUI folder and its AppPool from IIS Manager.

Verify the folder Security of ReportUI folder. Standard set of security should be like :

http://<Server name or IP>/GinesysReportUI/Admin.aspx

Test Admin Configuration: Data Sources

• Go to Server > Data > Source

• For database connection check, Double click on GINESYS. Test Connection String using the icon.

• For verify Assemblies

<IP>/GinesysReportAPI/Api.asmx

*Note: Ensure the server IP is being used while testing the access.

Note the error message appeared if any for tech team investigation.

Test Data Source connection string under Server tab

Go to Ginesys Web > Report > Server > Data (left side menu) > Source (Expand)

• Test database connection: Double click on GINESYS. In right side test Connection String using the lightning Icon at the end of the connection string.

• Test Assemblies: Double click on GinesysAssemby. In right side test Connection String using the lightning Icon at the end of the connection string.

In case of unsuccessful connection, verify Oracle connection string and assembly path mentioned GinesysAssembly connection string

Test Report Path under Server tab

Go to Ginesys Web > Report > Server > General (left side menu) > Main Settings (double click to load)

Test the Report Path using the lightning Icon at the end of the Report Path field.

In case of unsuccessful test, verify assembly path mentioned Report Path connection string

Properties of Report web applications: GinesysReportUI, GinesysReportAPI

Verify Physical path and Application Pool

Open inetmgr and expand to the application list.

Right click on GinesysReportUI, select Manage Application > Advance Settings
Verify the Application Pool. Must be GinesysReportAppPool.
Verify the path mentioned for Physical Path.

Right click on GinesysReportAPI, select Manage Application > Advance Settings
Verify the Application Pool. Must be GinesysReportAppPool.
Verify the path mentioned for Physical Path.

Select the correct AppPool.
Refer Report installation guide if GinesysReportAppPool is not present in list.
Ginesys Reports Installation Guide

Mention correct path for Physical Path if found wrong.

Folder Security of Report directories: \GinesysReport\ReportUI, \GinesysReport\ReportAPI

Go to directory \GSL\GINESYS12\GinesysReport
Verify folder Security entries for both the directories, ReportUI and ReportAPI

Following permissions must be present in a healthy configuration.

1. SYSTEM : Full Permission

2. Creator Owner : Special Permission

3. Administrators : Full permission

4. Users : Read& Execute , List of Folders , Read , Special Permission)

5. IIS_IUSRS ( : Full Permission)

Add Full permission for IIS_IUSRS if found missing.

Check presence of GinesysWebReprts.xml file is present or not.

Find the file available at following mentioned path

\GSL\GINESYS12\GinesysReport\ReportUI\Config\GinesysWebReports.xml

If missing, forward to technical team.

Folder Security permission of ReportUI & ReportAPI.

Verify the standard Folder security permission.

Report directories: \GinesysReport\ReportUI, \GinesysReport\ReportAPI

Go to directory \GSL\GINESYS12\GinesysReport
Verify folder Security entries for both the directories, ReportUI and ReportAPI

Following permissions must be present in a healthy configuration.

1. SYSTEM : Full Permission

2. Creator Owner : Special Permission

3. Administrators : Full permission

4. Users : Read& Execute , List of Folders , Read , Special Permission)

5. IIS_IUSRS ( : Full Permission)

Add Full permission for IIS_IUSRS if found missing.

GinesysReportScheduler Service state.

Check status of service GinesysReportScheduler, should be in running.

Go to Services.msc >
Find the Report scheduler service > Check is it stopped or not installed. service GinesysReportScheduler service.
Ensure service is running

If GinesysReportScheduler service is not installed found in service list, then you need to install it. Please follow the below reference for Report Service installationrefer Report Scheduler installation section in the Report installation guide.

Ginesys Reports Installation Guide

“Error occurred The service failed to start within 30 seconds.” - This message may appear while installing Report Scheduler service using InstallReportSchedulerSerrvice

Solution:
Unblock the scheduler executable \GinesysReport\ReportScheduler\eWebReportsScheduler.exe. See, check 4 below.

If service is found in stopped state, try to start the service. Unblock the scheduler executable \GinesysReport\ReportScheduler\eWebReportsScheduler.exe. See, check 4 below. If still service doesn’t start, note the error message appeared for further troubleshooting.

Check presence of eWebReportsScheduler.exe file

Find the below file is present or not from in the following pathlocation.

<Ginesys Installation_drive>\GSL\GINESYS12\GinesysReport\ReportScheduler\eWebReportsScheduler.exe

If missing, copy the file from Report kit.

Check presence of eWebReportsScheduler.xml file

Find the below file is present or not from the following path.<Ginesys Installation_drive>file in the following location.

\GinesysReport\ReportScheduler\eWebReportsScheduler.xml

If the XML is not present in the expected name, then

• Look for named as eWebReportsScheduler<Kit Version>.xml.

• Rename the file to eWebReportsScheduler.xml.

NOTE: Since the Ginesys Report file set is separately downloaded, Windows Smart Screen Filter marks most of the files as BLOCKED to execute.

• Go to file property of Report Scheduler executable file, GinesysReport\ReportScheduler\eWebReportsScheduler.exe.

• Observe, in the General tab at lower side, is there a check box or button to UNBLOCK.

• If the button or check box is found, then that means the files are in blocked state.

• Open CMD with Admin privilege and run the below command.

• Type powershell ( press Enter )

• Type following command. Mention the correct drive letter and verify path of Ginesys Report before execution.

• dir <Drive Letter>:\GSL\GINESYS12\GinesysReport\

• -Recurse | Unblock -File

Test connection of Schedule Remoting Host test connection ?

Go to Ginesys Web > Report > Server > General > Main Settings > Scheduler Settings > Find Schedule Remoting host > test the connection.(left side menu) > Scheduler Settings (double click)
Find Schedule Remoting Host
Test the connection using the lightning Icon at the end of the URL field.

If find the field blank, mention following.
http://<Report Server IP>:2001 or tcp://<Report Server IP>:2001
Alter the protocol between tcp and http if connection is not successful.

Enable Report Scheduling Option is True

Server > General > Main Settings > Scheduler Settings > Find Enable Report scheduling > It should be set as True.

Open CMD with Admin privilege and run the below command.

Type Powershell ( press Enter )

Type below command.

dir <\GSL\GINESYS12\GinesysReport\> -Recurse | Unblock -File

Report Scheduler Mail is not happening / Schedule Report goes to Abend State.

GinesysReportScheduler Service state

RUN > Services.msc > Find the Report scheduler service > Check is 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.

Ginesys Reports Installation Guide

Test mail credentials in SMTP mailer from Launchpad.

Open Launchpad > SMTP Mailer > Click on Stop Service > Click Edit on Pencil t button for editing > Put your credentials & test the smtp details. ( Do not save anything any details after checking on this window ) .

eWebReportsScheduler.exe file

Find the below file is present or not from the following below path.

<Ginesys Installation_drive>\GSL\GINESYS12\GinesysReport\ReportScheduler\eWebReportsScheduler.exe

Check mail SMTP Mail settings in eWebReportsScheduler.xml file

Find the below file & check the settings from the following below path and verify the SMTP details.

<Ginesys Installation_drive>\GSL\GINESYS12\GinesysReport\ReportScheduler\eWebReportsScheduler.xml

Check SMTP SSL settings in eWebReportsScheduler.xml file set as true or false.

The common known SMTP ports are used in mail configuration i.e. 587,465,25,995 etc.

SSL ports : 587 , 465

Non SSL ports : 25

If found SSL ports are associated under with SMTP server name. then SSL tag should be set as true .

NOTE : In Exceptional cases, private mail domain might be configured with 587 port with Non SSL configuration. So ,here we have to set false under SSL tag after testing with settings. It will be act like Non SSL 25 general SMTP port.

Failed to attach mail attachment for Report Scheduler. Then we need to accordingly.

eWebReportsScheduler.exe.config file settings under Runtime tag for mail attachment failure.

Following Below xml tag needs to be add under Runtime <Runtime> tag . from the the following path.

<loadFromRemoteSources enabled="true"/>

path : \GSL\GINESYS12\GinesysReport\ReportScheduler\eWebReportsScheduler.exe.configReport Scheduler Abended under Report Scheduler Page

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.

dir <<Drive>\GSL\GINESYS12\GinesysReport\ > -Recurse | Unblock -File

If Report Server or Report Installation folder location is different then change the mentioned path accordingly in How to check section.