Overview

This guide provides information about setting up and configuring your Gemini Appliance. It presumes that you have installed the software, confirmed that the appliance is on your network, and have obtained an IP address. If you do not have the IP address/s of the appliance/s, you won’t be able to proceed with the setup and configuration. Contact your administrator for more information.

Prerequisites

Ports

To manage and run the Gemini Appliance and services, certain communication channels between clients and nodes are required. At a minimum, ports TCP/443 (HTTPS) and TCP/22 (SSH) are required for basic system configuration and operations. The web interface and SSH console offer low-level system access, make sure to not expose these ports towards public access (e.g.,Anywhere, 0.0.0.0/0). Depending on the deployment, add inbound/outbound rules as needed.

For a complete list of used network ports, see the respective article on our Support Portal (https://support.geminidata.com/learn/article/ports-used-by-gemini-enterprise/).

Configuration tools

  • Cabling - An ethernet cable and available ethernet switch connection.
  • Networking - One IP address for Gemini appliance’s ethernet port 1 (address, netmask and gateway are required for manual configuration. DHCP is supported)
  • Client - A client PC with access the Gemini appliance’s IP address defined above.
  • Browser - Google Chrome browser is recommended.
  • (optional - Splunk) Access to the Splunk Enterprise installation tarball (splunk-..--Linux-x86_64.tgz).
  • (optional - Bulk Provisioning) The IP addresses of all the appliances in a .txt file is required for Bulk Provisioning.

Planning storage capacity

Take note of the disk partitions and mount points. Not every disk is mounted on the system default partitions especially the Gemini Appliance models. There are different storage configurations on each appliance model, such as onboard flash disks, all hard disk drive (HDD), all solid state disk (SSD), and hybrid configurations. If this appliance is designated to store large amounts of data, such as Splunk indexer and Hadoop worker node, you should do the following checks before you start to deploy any applications:

  • Understand the storage devices and mount points on the appliance. Go to NODE > Storage > Storage and you will see a list view of storage devices and mount points.
  • HDDs and SSDs are mounted on the following mount points by default:
    • HDD disk on /opt/mnt/hdd01
    • SSD disk on /opt/mnt/ssd01 Note: This is not applicable to the following models: G1000, IB-1050D.

Design your storage plan and adjust the logical volumes and mount points. The default storage plan might not satisfy your needs. You may adjust them to the new logical volumes and new mount points. For example:

  • Unmount SSD, remove it from logical volume, and merge it into /opt to extend its capacity.
  • Unmount HDD and mount it on /opt/splunk so that the whole Splunk instance including binary, configurations, and data are stored on the same disk. Remember the final storage plan. This is useful when deploying applications and configuring the data store path.

Note: Using mixed storage types and speed (e.g., SSD, HDD, and iSCSI connected disks in one RAID disk or in one logical volume) is not recommended as it can result in unpredictable disk performance.