Enable Offline Mode for Bold Reports: Resolve Errors When an Internet Connections Are Not Available

When Bold Reports 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 Reports for importing or logging in with an Azure AD account in the Report Server API service. This can be confirmed by checking all the service statuses by referring to the below article:
How to check Bold Reports application running status?

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

To resolve this issue, you can enable offline mode in the Bold Reports 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\reporting\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>
   

   

Linux

1. Open the config.xml file from the deployment location by running the below commands.
   > cd /var/www/bold-services/application/app_data/reporting/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>
   
   
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/reporting/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>
   
   
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/reporting/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>
   
   
5. To save the changes, press ctrl + x, shift + y, and enter.

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

How to enable offline mode after application startup?

1. Go to the UMS Configuration Settings page and choose reporting/config.xml from the Search Your Files drop-down.

   Example: {your_domain}/ums/administration/config-editor

   

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>
   

   

3. Restart the Bold Reports 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

1. How to configure Azure AD Settings?
2. How to import Azure AD users?
3. Application Start-up