Changing Domains in Bold Reports: Windows, Linux, Docker, and Kubernetes

This article will guide you through the process of changing the domain of your Bold Reports^® deployment across various environments like Windows, Linux, Docker, and Kubernetes . It also covers accessing the application from outside the installed machine.

Windows

Add a new binding (IP or DNS) to the Bold Reports^® Enterprise edition on IIS as shown in the following image. Do not remove the existing bindings. Example: 192.168.1.36.

Linux

1. Open the configuration file location, then change the older DNS name in product.json and config.json using the commands below.
   cd /var/www/bold-services/application/app_data/configuration
   sudo nano product.json

   

   sudo nano config.json
   

   

• To save the changes, press ctrl + X, Y, and Enter.

2. If your domain is SSL configured, you will need to change the DNS in the Nginx config file. Use the following commands to open the Nginx file and make edits.
   cd /etc/nginx/sites-available
   sudo nano boldreports-nginx-config

   • Replace example.com with your new DNS in the Nginx config file.
     
     

3. Save changes using Ctrl + X, then Y and Enter.

4. Restart the application with the following command:
   sudo systemctl restart nginx

Docker

1. Bash into the Docker container using the following command:
   sudo docker exec -it<container id or container name>bash
2. Open the configuration file location, then change the old DNS name in product.json and config.json using the commands below.
   cd /application/app_data/configuration/
   sudo nano product.json
   
   
   
   sudo nano config.json
   
   

• To save the changes, press ctrl + X, Y, and Enter.

  Note: Starting from version 5.4.20, use config.json. For versions prior to this, use config.xml.

3. If your domain is SSL configured, you will need to change the DNS in the Nginx config file. Use the following commands to open the Nginx file and make edits.
   cd /etc/nginx/sites-available
   sudo nano boldreports-nginx-config

   • Replace example.com with your new DNS in the Nginx config file.
     
     

4. Save changes using Ctrl + X, then Y and Enter.

5. Restart the application with the following command:
   sudo systemctl restart nginx

Kubernetes

1. Please run the following commands to get the ingress details and edit them with the new DNS.
   kubectl get ingress -n {namespace}
   kubectl edit ingress {ingress name} -n {namespace}
   

   
   
   Change the existing host name to the new one and save the changes using Ctrl + X, Y, and Enter.

2. List the pods and execute any one pod using the commands below.
   kubectl get pods -n {namespace}
   kubectl exec -it {Podname} -n {namespace} bash

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

4. Open the configuration file location, then change the old DNS name in product.json and config.json using the commands below.
   cd /application/app_data/configuration
   sudo nano product.json
   

   

   sudo nano config.json
   

   

   Note: Starting from version 5.4.20, use config.json. For versions prior to this, use config.xml.

5. Restart the application using the command below:
   kubectl rollout restart deploy -n {namespace}

Site URL configuration in Bold Reports^® application

After following the above steps based on your environment, update the new domain in the Bold Reports^® application.

• Navigate to the site settings page of the UMS application and update the Site URL as shown in the following image with a new domain.
  {domain_name}/ums/administration

  

• You can change the site URL for all tenant sites or for a specific tenant site.
  a. If you want to change the site URL for all tenant sites, select the checkbox as shown in the image below and save the site settings by clicking the Save button.
  

  
  
  b. If you want to change the site URL for a specific tenant site, uncheck the checkbox as shown in the image below and save the site settings by clicking the Save button.
  
  

How to change an individual tenant site URL

Please follow the below steps to edit the site URL for a specific tenant site.

• Navigate to the UMS site listing page and edit the site for which you want to update the domain or IP, as shown in the following image:

  {domain_name}/ums/sites
  

  

• Update the domain field.
  

  

• Next, you need to provide the password of the database configured for the respective site.
  

  

• Click Update. Your site will now be running with the updated site URL.

Note:

• If you have DNS, you can add binding for the DNS instead of IP in Windows, Linux, and Docker environments. For other environments, you can only configure DNS and not IP.
• The IIS Express Development Certificate cannot be used to configure the SSL with the IP address or domain in a Windows environment. If it is configured with an IP address or domain, the Bold Reports^® application will not function properly.
• If you have a valid SSL certificate installed on the server machine for the respective domain, you can configure the bindings or DNS with HTTPS instead of HTTP when updating the new binding or DNS information.

Additional References

• Bold Reports Official Website
• Bold Reports Documentation
• How to restart the Bold Reports Application