We’re excited to announce that the latest information is now available on our new site, the
Ginesys One Wiki!. Visit the site for up-to-date resources and insights. We look forward to continuing to support you there!">
We’re excited to announce that the latest information is now available on our new site, the Ginesys One Wiki!. Visit the site for up-to-date resources and insights. We look forward to continuing to support you there!

">

We’re excited to announce that the latest information is now available on our new site, the
Ginesys One Wiki!. Visit the site for up-to-date resources and insights. We look forward to continuing to support you there!">
We’re excited to announce that the latest information is now available on our new site, the Ginesys One Wiki!. Visit the site for up-to-date resources and insights. We look forward to continuing to support you there!

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 14 Next »

Introduction


In this article we will describe the basic understanding and trouble shooting steps for Web Report module , those will help to understand the cause of the problem & its basic understanding to prevent such problem in future. Also it will help to avoid the unnecessary delay of tickets forwarding.

Issue Type

What to check

How to check

Remarks

Report is Not opening

Report SYNC & IISReset command

Click on Repository tab and then run SYNC. Post SYNC operation , run the below command to reset the IIS server.

Open CMD ( with Admin privilege) > IISRESET > Press Enter.

Ginesys Data Source test connection under Server tab.

Go to Server > Data > Source > Double click on GINESYS. Then go to Connection String line & test the connection.

Report path test connection under Server tab.

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

Ginapps.config file ( Entry for Web Report Configuration is present or not )

Find the below entries in Ginapps.config file.

GinesysWebReprts.xml file is present or not

ReportAPI page is opening individually

Open the below link in browser.

http://localhost/GinesysReportAPI/Api.asmx

ReportUI page is opening individually

Open the below link in browser.

http://localhost/GinesysReportUI/Admin.aspx

Report API Configuration using IIS server manager ( physical path of reportAPI folder, API folder standard permission, AppPool )

Open IIS server manager : Run>inetmgr>Default WebSite >Select GinesysReportAPI > At right hand side Select Basic Settings > Check the path , apppool ) .

Then right click on GinesysReportAPI >Edit permission > Check the standard permission set from below permission section.

Report UI Configuration using IIS server manager ( physical path of reportUI folder, UI folder standard permission, AppPool )

Open IIS server manager : Run>inetmgr>Default WebSite >Select GinesysReportUI > At right hand side Select Basic Settings > Check the path , apppool ) .

Then right click on GinesysReportUI >Edit permission > Check the standard permission set from below permission section.

Report SYNC is not happening

Report SYNC is happening ?

Report sync is not happening ?

Report Scheduler service is working

GinesysReportScheduler Service state

RUN > Services.msc > Find the Report scheduler service > Check is it stopped or not installed.

If GinesysReportScheduler service is not installed then you need to install it. Please follow the below reference for Service installation. SERVICE INSTALLATION LINK

eWebReportsScheduler.exe file

eWebReportsScheduler.xml file

Schedule Remoting Host test connection ?

Enable Report Scheduling Option is True

Report Scheduler Mail is not happening

GinesysReportScheduler Service state

Test mail credentials in SMTP mailer from Launchpad.

eWebReportsScheduler.exe file

Check mail settings in eWebReportsScheduler.xml file

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

eWebReportsScheduler.exe.config file settings under Runtime tag.

This Article is applicable for all those cases where No Web report is running or Web Report module is not opening or Some specific report menu is not running.

Area of Troubleshooting :

  • Ginesys Report server or Ginesys Report Folder path identify or Location identify.

  • Ginapps config file checking.

  • Standard folder permission checking.

  • Report applications checking using IIS Manager.

  • Log searching for Advance troubleshooting.

  • Basic Task

Basic steps to be performed at preliminary stage when any issue occurs ,

1.Run SYNC first from Repository tab.

2.Then reset IIS server in Ginesys HO server / Report Server system using IISRESET option in Command Prompt or CMD.

  • Basic Troubleshooting steps

1.Check the Server tab settings of Ginesys Report Module :

a. Test the connection of Data source (Ginesys).

b. Check report path in Main Setting under Server tab.

c. Check the Remoting scheduler host path setting. ( protocol : http or tcp , server hostname or IP , Port : 2001 ).

d. Check the Report Scheduler service is running or not.

e. Check Ginapps.config file from <\GSL\GINESYS12\Shared> location and find the below rows.

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

2.Check the basic configuration from IIS manager :

a.Check standard Permission is enabled or not in each report application ( Report UI , Report API ):

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)

b. Check the Report Applications ( Report UI , Report API ) path :

Example: Physical path of Report UI folder and Path of GinesysReportUI set in IIS server is same or not.

Ex : C : \ GSL\GINESYS12\GinesysReport\ReportUI = below picture.

c. Check the Application Pool:

a.Check Report Applications GinesysReportUI, GinesysReportAPI , which must be run from GinesysReportAppPool.

d. Check the Application Pool identity :

a. Click on Application Pool at Left hand side , there must be a list view of AppPool at Right hand side , check GinesysReportAppPool is set to Application Pool Identity or not.

e. Check the Binding settings of default Web Site :

a. Click on Default Web Site , at the right hand side there is an option Binding. Click on that observe the binding details if any.

3. Procedure of advance Error findings :

In such cases after performing if the above basic checks fails and still problem exists, then you have to find out actual error from various logs.

1.log path for General Web Report related error : C : \ GSL\GINESYS12\WebUI\logs\log.txt

2.For Report scheduling related error : C : \ GSL\GINESYS12\GinesysReport\Report Scheduler\eWebReportScheduler.txt ( as per latest date & time)


In this section we will briefly describe that how to use IIS Manager to check various web report related parameters :

First to Open IIS Manager :

  • Go to RUN and type inetmgr or Go to Start Button type IIS server Manager. Find & enter into it.

At the Left side you will find IIS server name , below that you will see the Application Pool , just a little below you will find the Default Web Site along with its web applications or web sites. Like as below.

  • Star Page

    • Server Name (Domain\username)

      • Application Pools

        • Sites

          • Default Web Site

            • GINESYSReportUI

            • GINESYSReportAPI

  • To check Application Pool & its Identity

Just click on Application Pool , at the middle of the window you will see all Application Pool & its identity. For Web report Application Pool is GinesysReportAppPool and its Identity is ApplicationPoolIdentity .

  • To check Default Web Site along with its Binding

Click on Default Web Site , at left hand side , you will see the Binding Option , click on that one small window will open and you can see all binding & Certificate details if any exists.

  • To check Basic settings of any Web Report Application ( Ex. GinesysReportUI , GinesysReportAPI )

Click on any application , at left hand side you will find the Basic Settings option & click on it. Post that you can see the Alias Name , Application pool , Physical Path of that application.

  • To check Permission of any Application ( Ex. GinesysReportUI , GinesysReportAPI ) ,

Click on the application and at the left hand side you will see Edit Permission option. Then click on it and you can find the Security tab. On that tab you can check & verify the Standard permission settings which is mentioned below section.

  • Check standard Permission is enabled or not in each report application ( Report UI , Report API ):

    • SYSTEM ( Full Permission)

    • Creator Owner (Special Permission)

    • Administrators (Full permission)

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

    • IIS_IUSRS (Full Permission)

For more details regarding Web Report Installation including its configuration you can go through the below link : Ginesys Reports Installation Guide

For more details knowledge on Windows IIS server manager administration, its various features , troubleshooting , performance tuning etc. you can follow the below Microsoft link : https://docs.microsoft.com/en-us/iis/manage/provisioning-and-managing-iis/iis-management-and-administration

  • No labels

0 Comments

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account.