mO SharemO Share

How To: Update Ginesys Report version

Owned by Tech Contributor (Unlicensed)
Last updated: Apr 24, 2023 by Aparajita Basu Roy
4 min read

Introduction

Ginesys periodically releases updated Report kit along with Ginesys Head-Office updates. The respective Release Note has the information whether the Report version update required. Moreover, the notification to update the Report version will be displayed in Ginesys Web Report section after updating the compatible Ginesys HO version.

Step by Step guide

Know the server where Report role is configured? Is it the same server where Ginesys application installed (more likely case) or separate?

In most of the deployments, Ginesys Head-Office application and Ginesys Report role are installed on same server. This is the common deployment type. But there are deployments where the Report role is found to be deployed in separate server, for the purpose of balancing the load of transactions and reporting or security strategy or any other purpose. Hence, before proceeding for the update it is always recommended to determine whether the application server and the report are same or different. How to determine?

Guide 1 (Easy and fast approach)

  • Login in Ginesys HO application server

  • Open Services (services.msc)

  • Look for the service GinesysReportScheduler

  • If the service is not available there or the service is present but in disabled state, you can consider that the Report role is installed on different server. If the service is available in the service list and found in running state, then you can consider that the Report role is installed on this application server only.

This method of identification is not conclusive enough and deviation can be observed but applicable for majority of the cases.

Guide 2 (Conclusive approach)

  • Login in Ginesys HO application server

  • Open the Ginesys installation folder. Go to the path \GSL\GINESYS12\Shared. The easiest way to reach to that path: Right click GINESYS shortcut (LaunchPad) and click Open file location.

  • Open the file GinApps.config in a note pad.

  • Search for the string add key="ReportURI" value

  • Observe the value. If it is mentioned as just “/GinesysReportUI/“ that means both the server are same. If you find a complete URL comprising a system name or IP, then the report service is located on that mentioned system.

1. Download

2. Extract

  • Extract the downloaded compressed file (.zip).

  • Ensure you get the directory named GinesyReport

3. Stop Services

  • Open Services (services.msc)

  • Stop the following services.

    • GinesysReportScheduler

    • World Wide Web Publishing Service

    • Exago Monitoring Service (if available)

4. Backup the existing Report file

  • Open the Ginesys installation folder \GSL\GINESYS12. In common scenario of same server deployment, the report folder GinesysReport should be visible within GINESYS12 directory. For separate report server, the activity to be done on that server. See the WARNING section above on how to identify report server. The more conclusive way to determine the report directory is to get the path mentioned in the property of GinesysReportScheduler service in Services (services.msc).

  • (Optional) Look for other older backup of earlier versions of GinesysReport directory. If found delete those previously backed up folders. This will clean up the installation directory and reduce confusion.

  • Make a copy of the GinesysReport directory as a backup. Suggested location is GSL directory, one folder up of current location. Suggested directory name is GinesysRepor_KitVersion_Date (Example: GinesysReport_2019.4.0_13December2021)

The in-use GinesysReport directory must be COPIED (Ctrl+c), DO NOT MOVE (Ctrl+v) or RENAME the current GinesysReport directory. New file set will be overwritten the current file set. Hence for precaution, keep a copy of backup.

5. Replace the Report file-set

  • Copy the file-set of downloaded and extracted report kit. Copy the directory GinesysReport from extracted location (in step 2. Extract)

  • Go to the path \GSL\GINESYS12

  • Ensure you can see the directory GinesysReport.

  • Paste the copied directory. The prompt for replacing the existing files will come up, proceed for existing file replacement.

  • (Preventive action) Unblock the files as the Windows security service (SmartScreen Filter) marks the downloaded file as blocked for execution. You can check the property of any .exe file from the report directory whether the Unblock button / checkbox is seen. Same can be checked before and after executing the following section.

    • Open a CMD with elevated (‘Run as administrator’) mode.

    • Execute the command mentioned in the code block.

    • The path of in use current report folder MUST BE updated in the command.

    • No message will come on successful command execution but failure message may be displayed.

      powershell -Command "dir D:\GSL\GINESYS12\GinesysReport -Recurse | Unblock-File"

       

    • Change the Application Theme in the Server menu from “Basic” to “Ginesys One” Server/General/Feature UI Setting/Application theme selection.

  •   Rename the following files to specified names -
    Original file -  GinesysReport\ReportUI\appSettings_2019_6_1.config name changed to GinesysReport\ReportUI\appSettings.config
    Original file - GinesysReport\MonitoringService\Monitoring_2019_6_1.exe.config name changed to GinesysReport\MonitoringService\Monitoring.exe.config
    Original file - GinesysReport\ReportAPI\appSettings2019_6_1.config name changed to GinesysReport\ReportAPI\appSettings.config
    Original file - GinesysReport\ReportScheduler\working2019_6_1 name changed to GinesysReport\ReportScheduler\working
    Original file - GinesysReport\ReportScheduler\eWebReportsScheduler2019.6.1.xml name changed to GinesysReport\ReportScheduler\eWebReportsScheduler.xml
    Original file - GinesysReport\ReportScheduler\eWebReportsScheduler.exe.config_2019_6_1 - name changed to GinesysReport\ReportScheduler\eWebReportsScheduler.exe

  • In case you wish to have lesser time taken for better resolution of your Ginesys Web Report related issues we recommend you to install Ginesys Web Report Monitoring Services please write to https://care.ginesys.in/

6. Start Services

  • Open Services (services.msc)

  • Start the following services -

    • GinesysReportScheduler

    • World Wide Web Publishing Service

    • Exago Monitoring Service (if available)

7. Verification

  • Login in Ginesys Web and go to Report menu.

  • Go to Repository tab.

  • Run a SYNC. Successful sync completion message will show up.

  • Now move to Report home to verify. The Report kit version can be verified at left bottom corner of Ginesys Web.

Congratulations! You have successfully updated the Ginesys Report kit.

RELATED ARTICLE

https://ginesys.atlassian.net/wiki/spaces/PUB/pages/53477456

Troubleshooting Articles