In this guide, you will learn how to launch the ExtraHop Explore appliance AMI in your Amazon Web Services (AWS) environment, and join multiple Explore appliances to create an Explore cluster.
Your environment must meet the following requirements to deploy a virtual Explore appliance in AWS:
- An AWS account
- Access to the Amazon Machine Image (AMI) of the ExtraHop Explore appliance.
- An Explore appliance product key
- An AWS instance type that most closely matches the Discover appliance VM size, as
Appliance Size Recommended Instance Type EXA 5100v Small m5.2xlarge (8 vCPU and 32 GB RAM) Medium m5.4xlarge (16 vCPU and 64 GB RAM) Large c5.9xlarge (36 vCPU and 72 GB RAM)
- A datastore size between 200 GB and 2 TB, depending on the selected instance type.
Instance Type Datastore size m5.2xlarge Between 200 GB and 500 GB m5.4xlarge Between 200 GB and 1 TB c5.9xlarge Between 200 GB and 2 TB
Before you beginThe Amazon Machine Images (AMIs) of ExtraHop appliances are not publicly shared. Before you can start the deployment procedure, you must send your AWS account ID to firstname.lastname@example.org. Your account ID will be linked to the ExtraHop AMIs.
- Sign in to AWS with your user name and password.
- Click EC2.
- In the left navigation panel, under Images, click AMIs.
- Above the table of AMIs, change the Filter from Owned by Me to Private Images.
- In the filter box, type ExtraHop and then press ENTER.
- Select the checkbox next to the ExtraHop Explore appliance AMI and click Launch.
- On the Choose an Instance Type page, select the instance type sized for your deployment and then click Next: Configure Instance Details.
- In the Number of instances text box, type the number nodes in your Explore cluster.
- Click the Network drop-down list and select the default setting or one of the VPCs for your organization.
- From the Shutdown behavior drop-down list, select Stop.
- Click the Protect against accidental termination checkbox.
- (Optional): Click the IAM role drop-down list and select an IAM role.
If you launched into a VPC and want to add more than one interface, scroll down
to the Network Interfaces section and click Add
Device to add additional interfaces to the instance.
Note: If you add more than one interface, make sure that each interface is on a different subnet.
Click Next: Add Storage.
Note: Consult with your ExtraHop sales representative or Technical Support to determine the datastore disk size that is best for your needs.
- In the Size (GiB) field for the root volume, type the size of the storage volume. The minimum datastore size is 186 GiB (200 GB).
- From the Volume Type drop-down menu, select either Magnetic (standard) or General Purpose SSD (gp2). You must select General Purpose SSD (gp2) if you specify a size greater than 1024 GiB. GP2 provides better storage performance, although at a higher cost.
- Click Next: Add Tags.
- Click Add Tag.
- In the Key field, type a name for the tag.
- In the Value field, type a name for the instance.
- Click Next: Configure Security Group.
On the Configure Security Group page, create a new
security group or add ports to an existing group.
If you already have a security group with the required ports for ExtraHop, you can skip this step.
- Select either Create a new security group or Select an existing security group. If you choose to edit an existing group, select the group you want to edit. If you choose to create a new group, type a name for the Security group and type a Description.
- Click the Type drop-down list, and select a protocol. Type the port number in the Port Range field.
For each additional port needed, click the Add
Rule button. Then click the Type
drop-down list, select a protocol, and type the port number in the
Port Range field.
The following ports must be open for the Explore appliance AWS instance:
- TCP port 443: Enables you to administer the Explore appliance through the Web UI. Requests sent to port 80 are automatically redirected to HTTPS port 443.
- TCP port 9443: Enables Explore nodes to communicate with other Explore nodes in the same cluster.
- Click Review and Launch.
Select Make General Purpose (SSD)...(recommended) and
Note: If you select Make General Purpose (SSD)...(recommended), you will not see this step on subsequent instance launches.
- Scroll down to review the AMI details, instance type, and security group information, and then click Launch.
- In the pop-up window, click the first drop-down list and select Proceed without a key pair.
- Click the I acknowledge… checkbox and then click Launch Instance.
Click View Instances to return to the AWS Management
From the AWS Management Console, you can view your instance on the Initializing screen.
Under the table, on the Description tab, you can find an IP or hostname for the Explore appliance that is accessible from your environment.
After you obtain the IP address for the Explore appliance, log in to the Administration settings on the ExtraHop system through https://<extrahop-hostname-or-IP-address>/admin and complete the following recommended procedures.
For the best performance, data redundancy, and stability, you must configure at least three Explore appliances in an Explore cluster.
|Important:||If you are creating an Explore cluster with six or more nodes, you must configure the cluster with master nodes. For master node instructions, see Deploying master nodes.|
In the following example, the Explore appliances have the following IP addresses:
- Node 1: 10.20.227.177
- Node 2: 10.20.227.178
- Node 3: 10.20.227.179
You will join nodes 2 and 3 to node 1 to create the Explore cluster. All three nodes are data nodes. You cannot join a data node to a master node or join a master node to a master node to create a cluster.
|Important:||Each node that you join must have the same configuration (physical or virtual) and the same ExtraHop firmware version. EXA 5100 and EXA 5200 physical appliances can be in the same cluster.|
Before you beginYou must have already installed or provisioned the Explore appliances in your environment before proceeding.
- Log in to the Administration settings on all three Explore appliances with the setup user account in three separate browser windows or tabs.
- Select the browser window of node 1.
- In the Status and Diagnostics section, click Fingerprint and note the fingerprint value. You will later confirm that the fingerprint for node 1 matches when you join the remaining two nodes.
- Select the browser window of node 2.
- In the Explore Cluster Settings section, click Join Cluster.
In the Host field, type the hostname or IP address of
data node 1 and then click Continue.
Note: For cloud-based deployments, be sure to type the IP address listed in the Interfaces table on the Connectivity page.
Confirm that the fingerprint on this page matches the fingerprint you noted in
In the Setup Password field, type the password for the
node 1 setup user account and then click
When the join is complete, the Explore Cluster Settings section has two new entries: Cluster Members and Cluster Data Management.
Click Cluster Members. You should see node 1 and node 2 in
- In the Status and Diagnostics section, click Explore Cluster Status. Wait for the Status field to change to Green before adding the next node.
Repeat steps 5 - 10 to join each additional node to the new cluster.
Note: To avoid creating multiple clusters, always join a new node to an existing cluster and not to another single appliance.
When you have added all of your Explore appliances to the cluster, click
Cluster Members in the Explore
Cluster Settings section. You should see all of the joined nodes
in the list, similar to the following figure.
- In the Explore Cluster Settings section, click Cluster Data Management and make sure that Replication Level is set to 1 and Shard Reallocation is ON.
You must configure an email server and sender before the ExtraHop appliance can send notifications about system alerts by email.
You can receive the following alerts from the system:
- A virtual disk is in a degraded state.
- A physical disk is in a degraded state.
- A physical disk has an increasing error count.
- A registered Explore node is missing from the cluster. The node might have failed, or is powered off.
After you deploy the Explore appliance, you must establish a connection from all ExtraHop Discover and Command appliances to the Explore appliance before you can query records.
|Important:||If you have an Explore cluster of three or more Explore nodes, connect the Discover appliance to each Explore node so that the Discover appliance can distribute the workload across the entire Explore cluster.|
|Note:||If you manage all of your Discover appliances from a Command appliance, you only need to perform this procedure from the Command appliance.|
- Log in to the Administration settings on the ExtraHop system through https://<extrahop-hostname-or-IP-address>/admin.
- In the ExtraHop Explore Settings section, click Connect Explore Appliances.
- Click Add New.
- In the Explore node field, type the hostname or IP address of any Explore appliance in the Explore cluster.
For each additional Explore appliance in the
cluster, click Add New and enter the individual hostname
or IP address in the corresponding Explore node
- Click Save.
- Confirm that the fingerprint on this page matches the fingerprint of node 1 of the Explore cluster.
- In the Explore Setup Password field, type the password for the Explore node 1 setup user account and then click Connect.
- When the Explore Cluster settings are saved, click Done.
After your Explore appliance is connected to all of your Discover and Command appliances, you must configure the type of records you want to store.