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

Published:

Updated:

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

Open the config.xml file at the below location.
{deployment_location}\app_data\reporting\configuration\config.xml
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

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
Set true to the OfflineCapable node; if the node is not available, then add the node as shown below.
<OfflineCapable>true</OfflineCapable>
To save the changes, press ctrl + x, shift + y, and enter.

Docker

Bash the Docker container using the below command.
sudo docker exec -it <container id or container name> bash
Open the config.xml file from the deployment location by running the below commands.
> cd /application/app_data/reporting/configuration/
> sudo nano config.xml
Set true to the OfflineCapable node; if the node is not available, then add the node as shown below.
<OfflineCapable>true</OfflineCapable>
To save the changes, press ctrl + x, shift + y, and enter.

Kubernetes

List the pods and Exec any one pod by using the below commands.
> kubectl get pods
> kubectl exec -it {Podname} -n {namespace} – bash
Install package nano to edit the files using the below commands.
> apt-get update
> apt-get install nano
Open the config.xml file from the deployed location by running the below commands.
> cd /application/app_data/reporting/configuration/
> sudo nano config.xml
Set true to the OfflineCapable node, if the node is not available, then add the node as shown below.
<OfflineCapable>true</OfflineCapable>
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?

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
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>
```
Restart the Bold Reports application and access the site.