Manual Installation Guide for Binary Helical Insight war file

This Installation Guide will help user to manually configure the necessary settings required to install Helical Insight Application to the user’s system. This configuration is applicable to any Operating System (Windows Vista, Windows8, Windows10, Linux, Ubuntu, RedHat, MacOS and so on), any Databases (Oracle, MySQL, PostgreSQL, SQL Server and so on ) user is using. The steps mentioned here an also be used in case if you would like to create your own container like docker etc.

Prerequisites :

  • You should have downloaded latest version of Helical Insight automated installer. This step is required since it will give you access to the required files. You can get the latest version of Helical Insight automated installer from the location (https://www.helicalinsight.com/register/ )

    • Once you have installed take the below mentioned files from the below mentioned location and save it in the installation directory of your choice from where you would like to reference it and use it.

    • hi-ee.war file from the location “…/hi/apache-tomcat-9/webapps/”
    • hi-repository from the location “…/hi/”
    • Derby database from the folder. Foldername db “…/hi/”
  • Should have Installed Java ( version 8 or higher ) and its path should be correctly set
  • Should have any Java application server like Tomcat up and running.
  • You have the admin permissions or in case of non GUI based OS do the operations in sudo su mode.

NOTE :

  1. These instructions use the windows file path convention ‘\’.
    • For example: C:\Program Files\Helical Insight\hi-ee\hi-repository
  2. If you are running on linux, please use the convention ‘/’ wherever applicable.
    • For example : /home/hi-ee/hi-repository

Step 1: Install tomcat. Put the “hi-ee.war” inside tomcat. The war file should automatically explode. In case if it does not restart tomcat and then it will explode. Once it has exploded a folder by the name “hi-ee” will get created.

Step 2: Edit the file setting.xml present in the hi-repository

“..\hi-ee\hi-repository\System\Admin\setting.xml”
  • Find the tag <efwSolution><\efwSolution>. By default there is no value. (To view, click on image)

    • setting.xml

  • You need to set the value to the path where hi-repository is present. like ( “C:program files\Helical Insight\hi-ee\hi-repository” ) (To view, click on image)

    • settings.xml

  • For Windows: If you have copied the hi-repository folder in D: drive then <efwSolution>D:\\hi-ee\\hi-repository</efwSolution>
    • NOTE: Please make sure the path separator is “\\” and NOT “\”
  • For Linux: If you have copied the hi-repository folder in /home/user drive then <efwSolution>/home/user/hi-ee/hi-repository</efwSolution>
    • Find the tag <BaseUrl><\BaseUrl>. By default there is no value. You need to set this value to the ip/domain configuration along with the hi path. For example, if you have placed the tomcat in www.yourdomain.com/hi then the base URL will be <BaseUrl> http://www.yourdomain.com/hi-ee/hi.html <\BaseUrl>
    • In case of IP based configuration the above may be your format: http:// <yourip>:<port>/hi-ee

      • Example: <BaseUrl> http://192.168.2.1:8085/hi-ee/hi.html <\BaseUrl>

Step 3: In case of linux environment one needs to have write permissions to change the files that we are going to discuss now. Open {TOMCAT_HOME}\webapps\hi-ee\WEB-INF\classes\project.properties file with any file editor.

  1. Find settingPath parameter and replace it with the location of setting.xml which is present in System directory.
    • Format: settingPath = {setting.xml Location}
    • Example: settingPath = D:\\hi-repository\\System\\Admin\\setting.xml

      • settings.xml files

    • Description: This parameter indicates location of setting.xml file, which comes under hi-repository directory. This setting.xml file consists of helical insight server settings.
      • Find schedulerPath parameter and replace the default value with a value where you want the application to store scheduling related data.
        • Format:schedulerPath = {scheduling.xml location}
        • Example:schedulerPath = D:\\hi-repository\\System\\scheduling.xml

          • settings.xml files

        • Description: scheduling.xml file contains information of scheduled reports and related data.
      • The same way as described above, change the value of pluginPath parameter to a directory named Plugins inside System directory.
        • Format:pluginPath = {Plugins location}
        • Example: pluginPath= D:\\EFW_hdidev\\System\\Admin\\Plugins

          • settings.xml file

          Note: Configuring this parameter is optional.

Step4: Set Log file location

  1. Open {TOMCAT_HOME}\webapps\hi-ee\WEB-INF\classes\log4j.properties file in any file editor. (To view, click on image)

    2. log4j

  2. Find log4j.appender.file.File parameter
  3. Replace the default value with log4j.appender.file.File={Location where you want place the logs of the application}
    • Example:log4j.appender.file.File=D:\\hi-repository\\System\\debugLogs.log (To view, click on image)

      • log4j

The configuration shown below also configures the Hibernate dialect for the database you are using. I assume you are using MySQL here as the database. If you are using some other database, please contact Helical for further assistance. Here configurations are shown for MySQL.

  • Open {TOMCAT_HOME}\webapps\hi-ee\WEB-INF\application-context.xml file with any file editor. (To view, click on image)

    • hi properties

Step 5: The configuration shown below also configures the Hibernate dialect for the database you are using.

  • Open {TOMCAT_HOME}\webapps\hi-ee\WEB-INF\application-context.xml file with any file editor. (To view, click on image) On the line number 12 you will have to make the changes. You have to provide the path of db backup where you have saved the DB backup.

    • application

For example if you have taken the backup from the starting and saved the dbbackup in a location like “D: \Helical Insight\hi\db” then that path has to be put here

Step 6: License Deployment:

  1. Obtain an evaluation copy or purchase ‘hdi.licence’ file and copy it into {TOMCAT_HOME}\webapps\hi-ee.
  2. The default licence file is valid for 1 month.

    3. So, the location will be 

    {TOMCAT_HOME}\webapps\hi-ee\hdi.licence

Following the above steps complete the installation of the helical insight server. Restart your application server(Preferred) or reload the hi application in your application server manager. After that, you should be able to use the application by opening the browser and accessing at the

URL: http://{Your Server}:{Port}/hi-ee/hi.html

For example: http://192.168.2.1:8085/hi-ee/hi.html 

By default below two users are created
hiadmin
hiuser
Default User Credentials : 
1.
username: hiadmin
password: hiadmin

2.
username: hiuser
password: hiuser

In case of issue in installing the software, reach out to us at support@helicalinsight.com

You May Also Like

Leave a Reply

Helical Insight’s self-service capabilities is one to reckon with. It allows you to simply drag and drop columns, add filters, apply aggregate functions if required, and create reports and dashboards on the fly. For advanced users, the self-service component has ability to add javascript, HTML, HTML5, CSS, CSS3 and AJAX. These customizations allow you to create dynamic reports and dashboards. You can also add new charts inside the self-service component, add new kind of aggregate functions and customize it using our APIs.
Helical Insight’s self-service capabilities is one to reckon with. It allows you to simply drag and drop columns, add filters, apply aggregate functions if required, and create reports and dashboards on the fly. For advanced users, the self-service component has ability to add javascript, HTML, HTML5, CSS, CSS3 and AJAX. These customizations allow you to create dynamic reports and dashboards. You can also add new charts inside the self-service component, add new kind of aggregate functions and customize it using our APIs.
Helical Insight, via simple browser based interface of Canned Reporting module, also allows to create pixel perfect printer friendly document kind of reports also like Invoice, P&L Statement, Balance sheet etc.
Helical Insight, via simple browser based interface of Canned Reporting module, also allows to create pixel perfect printer friendly document kind of reports also like Invoice, P&L Statement, Balance sheet etc.
If you have a product, built on any platform like Dot Net or Java or PHP or Ruby, you can easily embed Helical Insight within it using iFrames or webservices, for quick value add through instant visualization of data.
If you have a product, built on any platform like Dot Net or Java or PHP or Ruby, you can easily embed Helical Insight within it using iFrames or webservices, for quick value add through instant visualization of data.
Being a 100% browser-based BI tool, you can connect with your database and analyse across any location and device. There is no need to download or install heavy memory-consuming developer tools – All you need is a Browser application! We are battle-tested on most of the commonly used browsers.
Being a 100% browser-based BI tool, you can connect with your database and analyse across any location and device. There is no need to download or install heavy memory-consuming developer tools – All you need is a Browser application! We are battle-tested on most of the commonly used browsers.
We have organization level security where the Superadmin can create, delete and modify roles. Dashboards and reports can be added to that organization. This ensures multitenancy.
We have organization level security where the Superadmin can create, delete and modify roles. Dashboards and reports can be added to that organization. This ensures multitenancy.
We have organization level security where the Superadmin can create, delete and modify roles. Dashboards and reports can be added to that organization. This ensures multitenancy.
We have organization level security where the Superadmin can create, delete and modify roles. Dashboards and reports can be added to that organization. This ensures multitenancy.
A first-of-its-kind Open-Source BI framework, Helical Insight is completely API-driven. This allows you to add functionalities, including but not limited to adding a new exporting type, new datasource type, core functionality expansion, new charting in adhoc etc., at any place whenever you wish, using your own in-house developers.
A first-of-its-kind Open-Source BI framework, Helical Insight is completely API-driven. This allows you to add functionalities, including but not limited to adding a new exporting type, new datasource type, core functionality expansion, new charting in adhoc etc., at any place whenever you wish, using your own in-house developers.
It handles huge volumes of data effectively. Caching, Pagination, Load-Balancing and In-Memory not only provides you with amazing experience, but also and does not burden the database server more than required. Further effective use of computing power gives best performance and complex calculations even on the big data even with smaller machines for your personal use. Filtering, Sorting, Cube Analysis, Inter Panel Communication on the dashboards all at lightning speed. Thereby, making best open-source Business Intelligence solution in the market.
It handles huge volumes of data effectively. Caching, Pagination, Load-Balancing and In-Memory not only provides you with amazing experience, but also and does not burden the database server more than required. Further effective use of computing power gives best performance and complex calculations even on the big data even with smaller machines for your personal use. Filtering, Sorting, Cube Analysis, Inter Panel Communication on the dashboards all at lightning speed. Thereby, making best open-source Business Intelligence solution in the market.
With advance NLP algorithm, business users simply ask questions like, “show me sales of last quarter”, “average monthly sales of my products”. Let the application give the power to users without knowledge of query language or underlying data architecture
With advance NLP algorithm, business users simply ask questions like, “show me sales of last quarter”, “average monthly sales of my products”. Let the application give the power to users without knowledge of query language or underlying data architecture
Our application is compatible with almost all databases, be it RDBMS, or columnar database, or even flat files like spreadsheets or csv files. You can even connect to your own custom database via JDBC connection. Further, our database connection can be switched dynamically based on logged in users or its organization or other parameters. So, all your clients can use the same reports and dashboards without worrying about any data security breech.
Our application is compatible with almost all databases, be it RDBMS, or columnar database, or even flat files like spreadsheets or csv files. You can even connect to your own custom database via JDBC connection. Further, our database connection can be switched dynamically based on logged in users or its organization or other parameters. So, all your clients can use the same reports and dashboards without worrying about any data security breech.
Our application can be installed on an in-house server where you have full control of your data and its security. Or on cloud where it is accessible to larger audience without overheads and maintenance of the servers. One solution that works for all.
Our application can be installed on an in-house server where you have full control of your data and its security. Or on cloud where it is accessible to larger audience without overheads and maintenance of the servers. One solution that works for all.
Different companies have different business processes that the existing BI tools do not encompass. Helical Insight permits you to design your own workflows and specify what functional module of BI gets triggered
Different companies have different business processes that the existing BI tools do not encompass. Helical Insight permits you to design your own workflows and specify what functional module of BI gets triggered