Installing the Digital Hive Software

Installing the Digital Hive Software

Question

How do you install Digital Hive?

Answer

Digital Hive can be installed in Windows or Linux environments.

Installing Digital Hive on Windows

Prerequisites for installing Digital Hive on Windows

  1. Microsoft® Visual C++ 2013 runtime library
  2. Microsoft® Windows Server 2012 or newer
  3. RAM: 16GB
  4. Disk Space: 50GB and at least 10% of the total disk space free
  5. A license key

Installation steps

  1. Download Digital Hive Installer, for example DigitalHive-2024.2_win-x64.zip to the server
  2. Extract the file to a directory, in this example C:\DHInstaller
  3. In File Explorer, navigate to where you extracted the file in step 2. In this example, C:\DHInstaller\DigitalHive-installer-win-x64
  4. Right-click setup.exe
  5. Select run as Administrator
  6. When you see this, click More info
  7. Click Run anyway
  8. Click Yes and you should see the installer UI
  9. Click Next
  10. Enter Licensee name and License Key that you were provided
  11. Click Next
  12. Select I do accept the terms of this license agreement
  13. Click Next
  14. Select Install
  15. Click Next
  16. Select Express (Recommended) and Full installation

    NOTE: Custom and Individual components are for installing specific components and failover nodes
  17. Click Next
  18. Enter where you would like to install Digital Hive, the default location is C:\DigitalHive
  19. Click Next
  20. Click OK
  21. You can leave the default username as dhAdmin or change it to what youlike and enter your desired password
  22. Click Next
  23. If you would like install the Recommender, check Install IQ
  24. Click Next
  25. You can keep the default ports or change them to whatever you like. For example, some people prefer the HTTPS port to be 443 and HTTP port to be 80

  26. Click Next
  27. If you see this, click Allow access

  28. If you see this, click Allow access
  29. Click Done
Congratulations, Digital Hive is now installed and should be up and running!

How to launch Digital Hive

  1. Open your browser (Chrome or Edge are preferred)
  2. Enter this URL https://DigitalHiveServer:9443
    For example, if you left the default port as 9443 and Digital Hive server name is test.digitalhive.com, you would tnere this:
    https://test.digitalhive.com:9443
    If you changed the port to 443, then you wouldn't need to specify the port

Starting/Stopping Digital Hive

  1. In Services, select DigitalHive - node1
  2. Click Start or Stop

Starting/Stopping Elasticsearch

  1. In Services, select Elasticsearch 5.5.1 (DigitalHive_9200)
    Note there is also a second Elasticsearch node: DigitalHive_9201
  2. Click Start or Stop

Installing Digital Hive on Linux

Pre-installation Steps

  1. Create a non-root user to use for the Digital Hive installation
  2. Edit the limits.conf file, for example, sudo vi /etc/security/limits.conf
  3. Add the following properties and save the file (include the *)

    * soft nofile 65536

    * hard nofile 65536

    * soft nproc 2048

    * hard nproc 4096

    * soft memlock unlimited

    * hard memlock unlimited

  4. Using sudo, edit sysctl.conf, sudo vi /etc/sysctl.conf

  5. Add the following lines and save the file
    #Added for Elasticsearch
    vm.max_map_count=262144

  6. Reboot the server, sudo reboot

Installation Steps

  1. Download and FTP DigitalHive-2024.2_linux-x64.tar.gz (filename example) to the Linux server
  2. Unzip the file:  gunzip DigitalHive-2024.2_linux-x64.tar.gz
  3. Untar the file:  tar -xvf DigitalHive-2024.2_linux-x64.tar.gz.tar
  4. As the DigitalHive user, run the installer with this command:  ./setup.sh
  5. Press 1 to continue
  6. Enter Licensee name:  <your provided license name>
  7. Enter License key: <your provided license key>
  8. Press 1 to continue
  9. Press spacebar until this prompt:  Press 1 to accept, 2 to reject, 3 to display
  10. Enter 1
  11. Enter 0 (or press Enter)
  12. Enter 1
  13. Enter 0 (or press Enter)
  14. Enter 0 (or press Enter)
  15. Enter 1
  16. Enter where you would like to install Digital Hive (or press enter to accept the default path)
  17. Either keep the suggested path or enter your desired home path
  18. Enter O

  19. Enter 1
  20. Enter your desired username or press enter to accept the default dhadmin
  21. Enter your desired password and press enter
  22. Confirm the password by entering it again
  23. Enter 1

  24. Enter 1 to install IQ (our recommender engine)
  25. Enter 1 to continue
  26. Press Enter for all the preflight checks (assuming all ports are correct)

  27. Enter 1
  28. Digital Hive should now be installed successfully and this will be displayed

Starting/Stopping Digital Hive

  1. Navigate to where you installed Digital Hive, in this example cd /home/mk3admin/DigitalHive
  2. Stop Digital Hive with  ./stopAll.sh
  3. Start Digital Hive with ./startAll.sh

How to Launch Digital Hive

  1. Open your browser (Chrome or Edge are preferred)
  2. Enter this URL https://DigitalHiveServer:9443
    For example, if you left the default port as 9443 and Digital Hive server name is test.digitalhive.com, you would tnere this:
    https://test.digitalhive.com:9443
    If you changed the port to 443, then you wouldn't need to specify the port