Pre-Installation Tasks


Follow the procedures in the chapter before beginning the installation.

Operating System, Content System, and Hardware Requirements


Component Requirement or supported system
Supported operating systems Windows:
  • Microsoft® Windows Server 2012 or 2016
  • Microsoft® Visual C++ 2013 runtime library
Linux:
  • Canonical® Ubuntu® Linux version 14 LTS
  • Red Hat® Enterprise Linux® 7
  • CentOS 7
  • Note: Also see Required Linux configuration additions for Elasticsearch for Linux installations.
Supported content systems Any of the following:
  • Box Cloud
  • File system (can connect to any operating system that Digital Hive supports)
  • Tableau® Server 9.0 through 2018.1
  • IBM Cognos Analytics versions 11.0.x and 11.1.1
  • IBM Cognos Business Intelligence versions 10.1 through 10.2.2 and 8.3 through 8.4
  • Qlik Sense® versions 2.0, 2.1, 2.2, 3.0, 3.1, and 3.2
  • QlikView 11.20, 12.00, and 12.10
  • IBM Cognos TM1® versions 9.5.0 through 10.2.2 and IBM Planning Analytics 2.0 through 2.0.5
  • Google Drive™
  • Microsoft® Power BI
  • Microsoft® SharePoint Online
  • Microsoft SQL Server Reporting Services 2012, 2014, and 2016
  • MicroStrategy®
  • Salesforce®
  • ThoughtSpot
Supported authentication methods Any of the following:
  • Challenge/response (user name/password)
  • SSO via authenticated header
  • SSO via Microsoft Internet Information Server (IIS)
  • SSO via direct Active Directory, if Digital Hive is running on a Windows host
Minimum hardware requirements
  • Disk space: 10 GB
  • RAM: 16 GB

Web Browser and Database Requirements


Component Minimum Requirement
Web Browsers Any of the following:
  • Google® Chrome™ version 48 (recommended)
  • Mozilla Firefox® version 45
  • Microsoft Internet Explorer® version 11 (compatible)

For all Web browsers, the following must be enabled:
  • Cookies
  • JavaScript
  • Popups

Important Pre-Installation Steps for Linux Systems


Linux systems require additional pre-installation steps.

Elasticsearch on Linux systems requires that you make a few configuration changes and disable Elasticsearch swap.

Required Linux Configuration Additions for Elasticsearch

When installing Digital Hive on a Linux system, you must manually add a few properties to two config files.

Procedure

  1. In a plain-text editor open the following file using sudo: /etc/security/limits.conf
  2. Add the following properties and save the file:
  3. * soft nofile 65536
    * hard nofile 65536
    * soft nproc 2048
    * hard nproc 4096
  4. Open the following file using sudo: /etc/sysctl.conf
  5. Add the following lines and save the file:
  6. #Added for Elasticsearch
    vm.max_map_count=262144
  7. Reboot the operating system

Disabling Elasticsearch Swap

Digital Hive instances deployed on Linux need to ensure that the bundled Elasticsearch process can lock physical memory upon startup. This is a matter of ensuring that the user running the Elasticsearch process has permission to lock memory.

About this task

Failure to adhere to observe these settings can cause Elasticsearch to fail bootstrap checks, preventing it from starting cleanly. The process depends on your Linux distribution.

Procedure

For Debian and distributions using RPM:

  • Set MAX_LOCKED_MEMORY to unlimited in the system configuration file (or see below for systems using systemd).
  • For systems using systemd:

  • Set LimitMEMLOCK to infinity in the systemd configuration.
  • Systems using unlimit:

  • Do one of the following:
    • Set ulimit -l unlimited as root before starting Elasticsearch
    • Set memlock to unlimited in /etc/security/limits.conf.