Articles in this section
Category / Section

Changing Domain in Bold BI: Windows, Linux, Docker & Kubernetes

Published:

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.

Note: This article is for On-Premises Deployments of Bold BI.

Windows

  1. 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.image.png

Linux

  1. 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

    image.png

    sudo nano config.json

    linux.png
    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.
  1. 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.

    image.png
  2. Save changes using ctrl + X, Y and Enter.

  3. Restart the application using the below command

    sudo systemctl restart nginx

Docker

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

  2. 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

    image.png

    sudo nano config.json

    docker.png
    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.
  3. 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.

    image.png
  4. Save changes using ctrl + X, Y and Enter.

  5. Restart the application using the below commands.

    sudo systemctl restart nginx

Kubernetes

  1. 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}
    image.png
    Change the already existing host name with new one and save the changes by using ctrl + X, Y and Enter.
  1. List the pods and Exec any one pod by using the below commands.
    kubectl get pods
    kubectl exec -it {Podname} – bash

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

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

    image.png
    nano config.json
    kubernetes.png
    Note: From version 6.14.19, use config.json and the config.xml for version prior to this.
  4. 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/administration

    image.png
  • 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, you need to check the checkbox as shown in the below image and Save the Site settings by clicking on Save button.

    image.png

    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.

    image.png

How to change 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 which you want to update its domain or IP as shown in the following images.
    {domain_name}/ums/sites
    image.png
  • Update the domain field
    image.png
  • Click Next and provide the Password of the database, which configured for the respective site.
    image.png
  • 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.

Additional References

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