Changing Domain in Bold BI: Windows, Linux, Docker & Kubernetes
This article will guide you through the process of changing the domain of your Bold BI deployment on different environments, such as Windows, Linux, Docker, and Kubernetes from version above 4.1.36 and access the application outside of installed machine.
Windows
- Add new binding (IP or DNS) to Bold BI Enterprise edition on IIS as shown in the following image. Do not remove the existing bindings. Example: 172.31.176.1.
Linux
Open the configuration file location, then change the older DNS name in product.json and config.json using the below commands.
cd /app-data/configuration/sudo nano product.json
sudo nano config.json
To save the changes press ctrl + X, Y and Enter.Note: From version 6.19.14, use the config.json and the config.xml for version prior to this.
If your domain is SSL configured, then you need to change the DNS in Nginx config file. Use the below commands to open Ngnix file and edit.
cd /etc/nginx/sites-available
sudo nano boldbi-nginx-config
• Replace the example.com with your new DNS in Nginx config file.Save changes using ctrl + X, Y and Enter.
Restart the application using the below command
sudo systemctl restart nginx
Docker
Bash the docker container using the below command
sudo docker exec -it<container id or container name>bashOpen the configuration file location, then change the older DNS name in product.json and config.json using the below commands.
cd/app-data/configuration/
sudo nano product.jsonsudo nano config.json
Note: From version 6.19.14, use the config.json and the config.xml for version prior to this. If your domain in SSL configured, then you need to change the DNS in Nginx config file.
cd /etc/nginx/sites-available/
sudo nano boldbi-nginx-config
• Replace the example.com with your new DNS in Nginx config file.Save changes using ctrl + X, Y and Enter.
Restart the application using the below commands.
sudo systemctl restart nginx
Kubernetes
- Please run the below commands to get ingress details and edit it with new DNS.
kubectl get ingress -n {namespace}
kubectl edit ingress {ingress name} -n {namespace}
Change the already existing host name with new one and save the changes by using ctrl + X, Y and Enter.
List the pods and Exec any one pod by using the below commands.
kubectl get pods
kubectl exec -it {Podname} – bashInstall package nano to edit the files using below commands
apt-get update
apt-get install nanoOpen the configuration file location, then change the older DNS name in product.json and config.json using the below commands.
nano config.json
cd /application/app_data/configuration
nano product.jsonNote: From version 6.14.19, use config.json and the config.xml for version prior to this. Restart the application using the below commands.
kubectl rollout restart deploy -n {namespace}
Site URL configuration in Bold BI application
After following the above steps based on your environment, update the new domain in Bold BI application.
Navigate to the site settings page of the UMS application and update the Site URL as shown in the following image with new domain
{domain_name}/ums/administrationYou 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, you need to check the checkbox as shown in the below image and Save the Site settings by clicking on Save button.
b. If you want to change the site URL for a specific tenant site, you need to uncheck the checkbox as shown in the below image and Save the Site settings by clicking on Save button.
How to change individual tenant site URL
- Navigate to the ums site listing page and edit the site which you want to update its domain or IP as shown in the following images.
{domain_name}/ums/sites - Update the domain field
- Click Next and provide the Password of the database, which configured for the respective site.
- Click Update, now your site will be running with 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 Windows environment. If it is configured with an IP address or domain, Bold BI 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.