How to configure redirection to BI by domain name

Description

It is required to configure domain name redirection for the installed Business Intelligence (BI) module, which is accessible by default via its IP address. For instructions on installing the module, see the link Installing the BI module and configuring user permissions.

Solution

To configure redirection by domain name:

1. Connect to the server with the platform via SSH. For more information about connecting via SSH, see Workstation setup.
2. Open the file /usr/local/mgr5/etc/business_intelligence/ansible/vars.json in edit mode.
3. Find the parameter bi_app_host and replace the IP address with the domain name:
   
   Original file example

   "bi_app_host": "https://10.10.10.10",

   Modified file example

   "bi_app_host": "bi.domain.com",

   Comment

   • 10.10.10.10 — current IP address of the BI module;
   • bi.domain.com — the domain name by which the BI module will open.
4. Apply the changes:

   /usr/local/mgr5/etc/business_intelligence/ansible/run.sh install

5. Open the file /usr/local/mgr5/etc/billmgr.conf in edit mode.
6. Find the BIHost parameter and replace the IP address with the domain name (with indication of the port):
   
   Original file example

   BIHost 10.10.10.10:8000

   Modified file example

   BIHost bi.domain.com:8000

   Comment

   • 10.10.10.10 — current IP address of the BI module;
   • bi.domain.com — the domain name that will be used to access the BI module;
   • 8000 — the port on which the BI module operates. It is specified in the bi_app_port parameter of the vars.json file
7. Restart BILLmanager:
   

   /usr/local/mgr5/sbin/mgrctl -m billmgr exit

8. Check that the BI module is available at https://bi.domain.com.

If your domain uses its own SSL certificate, add it to the server with BI:

1. Connect to the server with BI module via SSH. For more information about connecting via SSH, see Workstation setup.
2. Place the certificate and key files in the /root/.local/share/ispsystem/bi-app/ directory with the following names:
   
   • certificate file: server.cert
   • key file: server.key
3. Restart the bi-app container:

   docker restart bi-app