In this blog we are going to explain how to install 2 instances of helical insight on the same server and same tomcat and same port number but with a different extension. Like below
http://localhost:8085/hi-ee -Instance 1
http://localhost:8085/bi-ee -Instance 2
(A) So first of all you will install the first version with hi-ee using the normal installation process (like I have installed at the location “C:\Program Files\Helical Insight\”). So this specific versions service will get created, application can be accessed from the browser and will work fine.
(B) Stop the tomcat. Now go to webapps location wherein you have installed HelicalInsight (“C:\Program Files\Helical Insight\hi\apache-tomcat-9\webapps”), copy the hi-ee.war file and paste it again in the same webapps folder but with an extension like bi-ee.war (since we want to have the second Helical Insight instance with the extension as http://localhost:8085/bi-ee)
Then restart the server
(C) For both instances we can have the same hi-repository or different hi-repository. The hi-repository contains all the reports dashboards metadata and other files.
First instance which you have installed, its hi-repository is by default present at the location “C:\Program Files\Helical Insight\hi\hi-repository”
In case if you want the other instance to have hi-repository at some location (so that you can copy the files from there and move it here as part of UAT to production) then you can create any folder in any drive copy the ‘hi-repository’content into that folder.
For example :
D:\BIApp\ – we want to create hi-repository in this folder, so copy the entire content of “C:\Program Files\Helical Insight\hi\hi-repository” into “D:\BIApp\hi-repository”
(D) Restart Helical Insight service, After restarting the server inside the “bi-ee” folder we need to open these files and change the paths so that this new instance will also get correct paths. As of now it will have the path of hi-ee but it should be changed to bi-ee
a. project.properties : This file will be located at “….\hi\apache-tomcat-9\webapps\bi-ee\WEB-INF\classes”. Verify the various paths mentioned within this file. As of now before editing this file all your paths were pointing to hi-ee instance. But for bi-ee instance change the paths to
settingPath= D:\BIApp\hi-repository\System\Admin\setting.xml please mention here the path of your setting.xml file located inside your hi-repository of bi-ee instance. Similarly mention paths of scheduling.xml and Plugins folder shown in project.properties file so that it shows the correct paths of bi-ee.
b. application-context.xml: This file located inside “..\hi\apache-tomcat-9\webapps\bi-ee\WEB-INF\classes”. Before editing this file will point to database of hi-ee instance. We need to modify the path and dialect such that this file will start pointing to new instance bi-ee. Provide details of backend db (which stores user role management information) for instance 2 I.e. bi-ee. Reference screenshot as below :
Change the database details in above tags for bi-ee instance. In case you want to migrate your db to some other db from derby then follow : https://forum.helicalinsight.com/t/migration-of-user-role-from-derby-database-to-another-database-in-helical-insight/491
c. log4j.properties file
This file will be located inside “….\hi\apache-tomcat-9\webapps\bi-ee\WEB-INF\classes”. This file is responsible for creating application log file at particular location. Please change the path in this file to desired location where logs of bi-ee instance will be generated. Reference screenshot as below :
d. Setting.xml file
This file will be located inside hi-repository of your new instance bi-ee. Reference path “….\hi\hi-repository\System\Admin”. Open this file and edit below 2 tags as per the correct details :
< efwSolution> C:\Program Files\Helical Insight\hi\hi-repository< /efwSolution>
http://localhost:8085/hi-ee/hi.html
In the above tags provide hi-repository path and bi-ee instance URL. Save the file.
Restart the server, now we can access both versions of servers with single URL with extension change.
http://localhost:8085/hi-ee -Instance 1
http://localhost:8085/bi-ee -Instance 2
It will browse respective reports and dashboards.