Multi Server installation of DH 2024.3 (Windows)

Multi Server installation of DH 2024.3 (Windows)

Question

Due to the number of users and the critical nature of the BI reports, it is desirable to introduce more capacity into the Digital Hive environment. Can Digital Hive be installed across multiple servers? 

Answer

Digital Hive can be installed across multiple servers to allow for additional scalability and throughput.

Alert
The use of a third-party load balancer, with persistent sessions configured, would be required to distribute the requests across the multiple Digital Hive servers.

Installation of the Primary Server

  1. Run setup.cmd As Administrator.


  2. On the first screen click Next.

  3. Enter the License Name and Key provided to you by Digital Hive and click Next. 

  4. After reviewing and accepting the License Agreement, click Next. 

  5. Select Install and click Next
     

  6. Select installation mode as Custom (Advanced) and Install: Full installation and click Next. 

  7. Set the installation path and click Next. 

  8. Set the username and password for the user used to create users for both Digital Hive content store and Elasticsearch and click Next. 


  9. Review and modify the port numbers as needed or leave them to defaults. Enter the secondary or failover server name or IP address of the additional servers along with the ActiveMQ port of 61616 (server:61616) and click Next. 


  10.  Configure DigitalHive to authenticate against Active Directory in this step or complete it after the installation is complete. Click Next. 


  11. As this installation is the Primary server, leave the App Server Certificate step empty, click Next. 


  12. The database "digitalhive" will be created, confirm port for Postgres SQL and click Next.  


  13. Select Yes to setting the Digital Hive content store in failover node. Click Next.


  14. Fill in the failover server name / IP address and enter the password for the replica user. Click Next. 


  15. Enter the SMTP configuration information or click Next. 


  16. Select if you want IQ to be installed. Click Next. 


  17. Enter the server name or IP address for the Primary Server. click Next. 


  18. Final review the port numbers are correct and click Next. 


  19. Once completed we can move onto the Secondary server. Click Done to exit. 


  20. Copy the following two files over to the second server:
    C:\DigitalHive\app\node1\tomcat\conf\theia.properties
    C:\DigitalHive\Elasticsearch\config\elastic-search-certificate.p12
    C:\DigitalHive\app\node1\tomcat\conf\keystore.jks

  21. Ensure the services are running on the Primary Server:
    1. DigitalHive - node1
    2. DigitalHive Content Store
    3. DigitalHive-IQ-Server (if installed)
    4. Elasticsearch 7.17.16 (DigitalHive_9200)
       

Installation of the Secondary Server

  1. Repeat steps 1 through 6 of the installation steps from Primary Server. 

  2. Choose Custom (Advanced) and Individual components


  3. Select the components to install as failover nodes, both are selected in this example and click Next.


  4. Set the installation path, click Next. 


  5. Set the password for the Content Store and Elasticsearch user, click Next.


  6. Validate the Ports and select theia.properties and elastic-certificates.p12 files from the Primary Server, click Next. 


  7. Leave "Use custom keystore" unchecked and select the keystore.jsk file from the primary server, click Next.


  8. Click Install IQ, click Next. 


  9. Enter the IP address of the Secondary Server, click Next. 


  10. Enter the password for the replica user and the IP address of the Primary server, click Next. 


  11. Validate the port numbers and click Next. 


  12. Installation is now complete on the Secondary server, click Done to complete. 



    Digital Hive has now been configured to utilize a Primary and Secondary servers to handle user requests. In this scenario, the Primary server must always be active as the active Content Store is located on the Primary server. If a third server is desired, most of the same steps for Creating the Secondary Digital Hive environment section are applicable.

    Info
    Since both the Primary and Secondary servers have been configured with an instance of the PostgreSQL Content Store, it is recommended that any additional servers be configured for load balancing purposes only.

    • Related Articles

    • Digital Hive Installation and Configuration Overview

      Overview This article serves as a collection of all the steps required to install and configure the Digital Hive solution. Prerequisites Digital Hive can be installed on either Windows or Linux based systems. From a server sizing perspective, the ...

    • Upgrading Digital Hive on Windows to the 2024.3 Release

      Overview The 2024.3 Digital Hive release brings a lot of new capabilities to the market. In order to deliver some of the new features, changes to the underlying technology stack that underpins the Digital Hive solution had to be made. The 2024.3 ...

    • Connecting to Tableau Server

      Question How do we connect Digital Hive to Tableau Server? Answer Before Digital Hive can successfully connect to Tableau Server, the Digital Hive server URL or IP address must be added to the Tableau Trusted Authentication list. This operation must ...

    • Connecting to the Local Windows File System

      Question How do we connect Digital Hive to the local File System? Answer As a Digital Hive administrator, connecting to the File System can be accomplished via the following steps: Launch Digital Hive and login with an admin account Click your avatar ...

    • Digital Hive Load Balancing

      Question Due to the number of users and the critical nature of the BI reports, it is desirable to introduce more capacity into the Digital Hive environment. Can Digital Hive be installed across multiple servers? Answer Digital Hive can be installed ...