Articles in this section
Category / Section

Enable Offline Mode for Bold BI: Resolve Errors When Internet Connection is Not Available

Published:
When the Bold BI Embedded Analytics server is deployed on a machine where the internet connection is not available, it will fail to get the configuration details of Microsoft’s Azure AD to support the Azure AD setup in Bold BI for importing or logging in with an Azure AD account in the Dashboard Server API service. This can be confirmed by checking all the service statuses by referring to the below article:

Errors will occur like startup cannot be done or after startup data source creation fails if the machine is not connected to the internet, as shown below.

image.png
To resolve this issue, you can enable offline mode in the Bold BI application. To enable offline mode, follow the steps below:


How to enable offline mode before application startup?

You can enable the offline mode manually in the configuration file in the deployment location. Please follow the below steps to enable it in different environments.

Windows

  1. Open the config.xml file at the below location. 

    {deployment_location}\app_data\bi\configuration\config.xml

  2. Set true to the OfflineCapable node, if the node is not available, then add the node as shown below and then save the file.
    <OfflineCapable>true</OfflineCapable>
    biconfig.png

Linux

  1. Open the config.xml file from the deployment location by running the below commands. 
    > cd /var/www/bold-services/application/app-data/bi/configuration/
    > sudo nano config.xml
  2. Set true to the OfflineCapable node, if the node is not available, then add the node as shown below.
    <OfflineCapable>true</OfflineCapable>
    biconfig.png

  3. To save the changes, press ctrl + x, shift + y, and Enter.


Docker

  1. Bash the docker container using the below command
    sudo docker exec -it <container id or container name> bash

  2. Open the config.xml file from the deployment location by running the below commands. 
    > cd /application/app-data/bi/configuration/
    > sudo nano config.xml
  3. Set true to the OfflineCapable node, if the node is not available, then add the node as shown below.
    <OfflineCapable>true</OfflineCapable>
    biconfig.png

  4. To save the changes, press ctrl + x, shift + y, and Enter.


Kubernetes

  1. List the pods and Exec any one pod by using the below commands.
    > kubectl get pods
    > kubectl exec -it {Podname} -n {namespace} -- bash

  2. Install package nano to edit the files using the below commands.
    > apt-get update
    > apt-get install nano

  3. Open the config.xml file from the deployed location by running the below commands.
    > cd /application/app_data/bi/configuration/
    > sudo nano config.xml
  4. Set true to the OfflineCapable node, if the node is not available, then add the node as shown below.
    <OfflineCapable>true</OfflineCapable>
    biconfig.png
  5. To save the changes, press ctrl + x, shift + y, and Enter.

Once the above steps are completed, restart the Bold BI application, and continue the startup.

How to enable offline mode after application startup?

  1. Go to the UMS Configuration Settings page and choose bi/config.xml on the Search your files drop-down
    Example: {your_domain}/ums/administration/config-editor

    image.png
  2. Set true to the OfflineCapable node, and then save it. If the node is not available, then please add the below code.

<OfflineCapable>true</OfflineCapable>
image.png       3. Restart the Bold BI application and access the site.


Note

  • By default, the deployment location will be C:\BoldServices for Windows and /var/www/bold-services/application for Linux.

Related Links

Was this article useful?
Like
Dislike
Help us improve this page
Please provide feedback or comments
DG
Written by Dhivyabharathi Govindaraj
Updated
Comments (0)
Please  to leave a comment
Access denied
Access denied