This guide provides an introduction to the Gemini Hardware appliances and a step by step guide to the initial setup and configuration process.

1. Gemini Appliance Model Identification

A140/F1000/F2000/S1000/S2000 Series Front Panel

  1. Power Button
  2. VGA D-Sub

A140/F1000/F2000/S1000/S2000 Series Back Panel

  1. Ethernet Port 1
  2. Ethernet Port 2
  3. Ethernet Port 3
  4. Ethernet Port 4
  5. Ethernet Port 6 (if equipped)
  6. Ethernet Port 5 (if equipped)

A240 / A540 Front Panel

(1) Power Button (2) VGA D-Sub

A240 / A540 Back Panel

  1. Ethernet Port 1
  2. Ethernet Port 2
  3. Ethernet Port 3
  4. Ethernet Port 4
  5. Ethernet Port 6 (if equipped)
  6. Ethernet Port 5 if equipped)

A1040 / A2510 / A2540 Series Front Panel

  1. Power button
  2. VGA D-Sub

A1040 / A2510 / A2540 Series Rear Panel

  1. Ethernet Port 1
  2. Ethernet Port 2
  3. Ethernet Port 3
  4. Ethernet Port 4

2. Getting Started

Prerequisites

  • An ethernet cable and available ethernet switch connection.
  • One IP address for Gemini appliance ethernet port 1 (address, netmask and gateway are required for manual configuration. DHCP is supported).
  • A client PC which is able to access to the Gemini appliance IP address defined above.
  • (optional) Access to the Splunk Enterprise installation tarball (splunk-..--Linux-x86_64.tgz).
  • (optional) Internet access and FQDN of this appliance are required for Cloudera CDH installation.

Google Chrome browser is recommended.

Power On

  1. Plug and connect the power cables to the appliance’s power supply unit.
  2. Connect a VGA monitor and USB keyboard.
  3. Connect the primary ethernet cable to ethernet port 1.
  4. Press front panel power button (A). The button may need to be pressed twice the first time the appliance is turned on.

Appliance Log In

If the login prompt is not visible on the connected monitor, press Enter on the keyboard a few times. The login prompt should appear.

For initial setup, log into the appliance as user sbox with the default password facing jet function drive. You are required to change this password before continuing. Re-type facing jet function drive at the prompt and then choose a new secure password. This password can be changed once the appliance is configured.

Network Configuration

DHCP Setup

The use of DHCP for IP assignment is not recommended. If you choose to utilize a DHCP-assigned address, let the appliance boot up and an address will be assigned. To verify the address, log onto the appliance and run the ip addr command.

[sbox@sboxnode1 ~]$ ip addr
1: lo:  mtu 65536 qdisc noqueue state UNKNOWN
   link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
   inet 127.0.0.1/8 scope host lo
      valid_lft forever preferred_lft forever
   inet6 ::1/128 scope host
      valid_lft forever preferred_lft forever
2: nic0:  mtu 1500 qdisc pfifo_fast state UP qlen 1000
   link/ether 08:00:27:9e:96:c0 brd ff:ff:ff:ff:ff:ff
   inet 192.168.1.100/24 brd 192.168.1.255 scope global dynamic nic0
      valid_lft 68091sec preferred_lft 68091sec

After running ip addr, locate the output stanza for nic0. Locate the assigned IP address in the string following the inet tag. This is the ethernet address assigned to to the primary ethernet port. Additional network ports can be assigned using the Gemini Enterprise Manager.

Manual Network Setup

The first ethernet port must be configured before the appliance can be managed. To do so, log onto the appliance as detailed in step 2.3 and type the command sbox setup This initiates a series of configuration screens. The settings can be edited after configuration is complete, but it is important to configure network settings correctly so the appliance can be accessed.

A few notes on navigation in the setup screen:

  • Use TAB to switch between screen areas.
  • Use the ARROW keys to switch between selection elements.
  • Use SPACE or ENTER to select an element (e.g., DHCP or STATIC).
  • TAB to the NEXT element and hit SPACE or ENTER to go to the next screen.

Platform Setup: Network

  • ARROW to Static and press SPACE.
  • TAB to IPADDR and enter the address assigned to this appliance.
  • TAB to NETMASK and enter the appropriate netmask.
  • TAB to GATEWAY and enter the network gateway to be used (required for static networks).
  • TAB to NEXT and press SPACE or ENTER.

Platform Setup: Hostname

Enter the name of this host. Then TAB to NEXT and press SPACE or ENTER.

You may skip this step and configure it later in the setup wizard.

Platform Setup: Timezone (Please note that this screen may take a few seconds to load)

ARROW up or down to choose the city that most closely represents the timezone of this appliance.

SPACE to select the Region/City

TAB to DONE and press SPACE or ENTER

You may skip this step and configure it later in the setup wizard.

After a few seconds, the setup screen is followed by a success message along with an IP ADDRESS. This IP address will be used for the remainder of the configuration.

3. Gemini Enterprise: Manager

Final configuration of the appliance is completed using the Manager web console. Using a supported web browser, navigate to:

https://

A security warning or message may be displayed. This is expected and does not indicate a problem. Depending on your browser you may have to choose “proceed anyway” or “continue” for the page to load.

3.1 Activation

3.1.1 EULA

Upon the first visit to Manager, the End User Software License Agreement is shown. After reading the terms, choose Accept to advance to the next screen.

3.1.2 Localization

Manager supports multiple languages and setting a preferred language adjusts the entire user experience accordingly. .

If the hostname and timezone settings were skipped in previous basic configurations, this step provides an opportunity to configure them.

3.1.3 Select License Option

Manager supports 3 types of licenses:

“Activate Enterprise Edition using Purchased License”: Select this if there’s a purchased license was provided or there is a license server configured.

“Activate Free Edition”: With this option several features are restricted. Ignore this option if you already had a purchased license or you want to have a trial.

“Activate Enterprise Edition Free Trial”: Select this if you want to start a 30 days free trial. Purchased user may also considered to select this and attach purchased license later.

Only when you selected any one of the options, the “Next” button will reveal.

3.1.3.1 Activate Enterprise Edition License

Select “Use a License File” if you have a purchased license.

Select “Connect to a License Server” if you have a license server to manage all the licenses and can be activated from this license server.

Only when you selected any one of the options, the “Next” button will be revealed.

3.1.3.1.1 License Request and Application

Follow the steps to generate a license request file, send it to Gemini support and apply the received license.

Only when you applied the license file, the “Next” button will reveal.

3.1.3.1.2 License Server Validation

Input the License server IP address and token string for validation.

3.1.4 Provisioning

If you have multiple appliances to be configured, select “Bulk Provisioning (provision several appliances with this node as the master)” would help you to apply configurations and complete the initial setup on the appliances at one time.

To operate as a standalone appliance, select “Stand-Alone (single) provisioning”.

3.1.4.1 Bulk Provisioning

This is a step-by-step wizard to guide you complete the initial setup configurations.

3.1.4.1.1 Appliance Discovery

If you have a known appliances IP list, e.g. acquired from DHCP server or reported by AWS, you can create a text file and make an IP list, one IP address per line, and then upload this text file to locate the appliances.

Another way is to perform a IP subnet scan to discover the appliances. Use CIDR notation to specify the subnet, e.g. 192.168.156.0/24.

Please note if you specify a large subnet, it might take long time on scanning.

3.1.4.1.2 Network Settings

If the IP address of all the appliances are assigned by DHCP server and you want to keep them as static IP configurations, select “Network settings - Static assigned”. This is useful when building a DHCP server for deployment temporarily. User may assign IP addresses by using DHCP server and use this option to turn the configurations permanently. In the end DHCP server can be removed after deployment.

Keep the default settings to assign IP address by DHCP, select “Network settings - DHCP assigned”.

3.1.4.1.3 Hostname

When you have assigned DNS records for each appliance, select “Use Reverse DNS Loopkup” to acquire it’s own hostname.

If you want to name the appliances with a custom pattern, select “Specify Custom Pattern” and specify the custom pattern with valid tokens.

3.1.4.1.4 Change Admin Password

Update the password for the account ‘admin’ in Manager here. It is recommended that you use a strong password or if applicable, follow appropriate password security policy as required for your enterprise.

Please note all the appliance will be updated with the same admin password.

3.1.4.1.5 Connect to LDAP

You may configure LDAP resources here to support LDAP authentication. When LDAP resources are configured successfully and correctly, a user will be able to login to Manager with their LDAP account.

Read LDAP Authentication in Settings chapter for more details. Please note this is optional and you can skip it.

3.1.4.1.6 SSH Authentication

For SSH login, you may specify the password for SSH authentication. You may also upload SSH key to complete the key exchange and it allows you to login Manager via SSH without password required.

Please note this is optional and you can skip it.

3.1.4.1.7 Summary

Here you can see the summary of provision appliances. Click “Start” to start provisioning. You can see the live status during provisioning and download the CSV result for further use.

Click FINISHED to complete this wizard.

3.1.4.2 Stand-Alone Provisioning - Join Cluster

If this node is going to join into an existing Gemini Cluster, select “Join an existing appliance cluster” and provide the IP Address and the Token String that were assigned on the Master Node.

If this is an standalone appliance, or you wish to configure a cluster at a later time, select “Operate as a standalone appliance”.

Only when you selected any one of them, the “Next” button will reveal.

3.1.4.3 Stand-Alone Provisioning - Change Admin Password

Update the password for the account ‘admin’ in Manager here. It is recommended that you use a strong password or if applicable, follow your password security policy in your enterprise.

3.1.4.4 Stand-Alone Provisioning - Success

Congratulations! The Completed screen lets you know that this appliance has been configured. Click “Get Started” to launch Manager.

3.1.5 Welcome to Gemini Enterprise: Manager

Log in to Manager with username ‘admin’ and password configured in the setup process.

3.1.6 Install Featured Platforms

Follow the on screen directions to install featured platforms like Splunk Enterprise and Cloudera CDH. Note that this process involves accessing the application website and downloading binaries. Ensure that you have access to the public internet (from the browser used, not the appliance) before proceeding further.

  1. Additional Support To access the Gemini Support documentation and knowledge base, or to open a support ticket, please visit http://support.geminidata.com. Also refer to the support site frequently for updates, patches and other information related to your appliance.