Viewing and Managing Your Cluster
The Cluster page in Management Console shows a node-based visualization of your cluster. This page shows the cluster's host addresses, the installed version of Vertica running, and a list of the databases on the cluster that MC is currently monitoring.
Some of the features on this page are currently available in MC only on AWS and GCP.
From the Cluster page, you can also create a new empty database on the cluster, or import any existing databases MC discovers on the cluster. (These features are currently available only on AWS and GCP.)
MC displays different options depending on whether you imported the cluster to MC, or created the cluster using MC:
- Imported cluster: MC displays monitoring information about the cluster.
- Cluster created using MC: MC displays both monitoring information and management options for third-party cloud platforms such as AWS. For clusters you created using the current MC, the Cluster page provides cluster and instance management options.
Cluster and Instance Management Option Availability
For Eon Mode databases, MC supports actions for subcluster and node management:
- In the cloud: On AWS and GCP.
- On-premises: For Pure Storage FlashBlade.
For Enterprise Mode databases, MC supports these actions:
- In the cloud on AWS: Add Node action, Add Instance action.
- On-premises: Add Node action.
In the cloud on GCP, Enterprise Mode databases are not supported.
Go to the Cluster Page
To view the Cluster page:
- On the MC Home page, click View Infrastructure to go to the Infrastructure page. This page lists all the clusters the MC is monitoring.
Click any cluster shown on the Infrastructure page.
Select View or Manage from the dialog that displays, to view its Cluster page. (In a cloud environment, if MC was deployed from a cloud template the button says "Manage". Otherwise, the button says "View".)
You can click the pencil icon beside the cluster name to rename the cluster. Enter a name that is unique within MC.
Monitor Imported Clusters
Whether you have imported or created a cluster using MC, you can view information about it through the Cluster page.
This page includes the following information:
- Node visualization: A visualization of all nodes within the cluster. Icons at the top right of each node indicate if the nodes are up. Click any node to see details about its host name, CPU information and total memory. If there are many nodes in the cluster, use the Zoom Level slider at the bottom right of the page to zoom the visualization in or out.
- Instance List: A list of all the instance IPs within the cluster. Click any instance in the list to see details about it.
- Cluster Summary: A summary of details about the cluster, including the version of Vertica running on the cluster and the number of hosts. If the cluster is running on cloud-platform resources such as AWS, you can also see region and instance type information.
- Databases: Lists all databases monitored by MC and their current state.
- At the bottom of the Databases section, click Create New to create a new empty database.
- This section also lists any Vertica databases on this cluster, if existing, that are not yet monitored by Management Console. See Importing an Existing Database Into MC for the process of importing a discovered database.
The following image shows an overview of a 7-node cluster, which was created in MC using a Cloud Formation Template. This cluster has a running Eon Mode database on it.
If you installed Vertica from the AWS Marketplace using AWS resources, MC offers cluster management operations that are specific to the cloud. Using MC, you can manage a cluster running on AWS without going to the AWS console.
If you upgrade the cluster's Vertica version manually through the command line, AWS management operations in MC become disabled for the cluster, even if you created that cluster using MC. Make sure to upgrade the cluster's Vertica version through MC in order to preserve AWS management capabilities for that cluster in MC.
In the screen capture below, the Cluster page shows a 7-node cluster, which was provisioned using the Cluster Creation wizard. See Provisioning a New Vertica Cluster and Database on AWS in MC.
Cluster Management Actions (Eon Mode and Enterprise Mode)
You can perform the following operations on your cluster through the Cluster page. These options are available at the top of the Cluster page or in the Advanced menu at the top of the page:
You can perform the following operations on your cluster through the cluster page:
- Start Cluster: Start all the instances in the cluster. Available at the top of the Cluster page.
- Stop Cluster: Stop all the instances in the cluster. You must first stop any running database on the cluster. Available at the top of the cluster page.
- Reboot Cluster: Restart all instances in the cluster. Available under the Advanced menu at the top of the page. Note: Reboot Cluster is currently available only on AWS.
- Terminate Cluster: Terminate all instances in the cluster, the databases on it, and all AWS resources from the cluster. The Terminate Cluster operation is available under the Advanced menu at the top of the page.
- For Enterprise Mode databases, this operation permanently deletes any data you had on the cluster or its databases.
- For Eon Mode databases, the data is preserved in communal storage and you can later revive the database in a new cluster. When you choose to terminate the cluster, MC gives you the option to also stop the database before termination, which is recommended in order to safely revive later.
View Cluster Instance Details
You can view the details for any instance in your cluster. Select the IP address of an instance in the Instance List. MC displays a popup beside that instance showing information about its private and public IP addresses, host name, total memory, and other details.
Manage Individual Instances/Nodes in Eon Mode
If your database is Eon Mode, you use actions available on the Database > Manage > Subclusters tab in MC to manage individual nodes.
To change the state of individual nodes in your Eon Mode database, you can:
- Start, stop, or terminate a node in a subcluster.
To change the number of nodes in your Eon Mode database, you can:
- Add or subtract individual nodes from a subcluster by scaling the subcluster up or down.
- Add or terminate an entire subcluster.
Manage Individual Instances in Enterprise Mode
If your database is Enterprise Mode, the Cluster page Instance List includes action icons you use to manage individual instances in your cluster.
In the Instance List panel of the Cluster page, select the IP address of any instance in your cluster that you want to perform the action on. Then click an icon from the icon menu at the top of the panel. Hover over an icon to read the action it performs.
- Start Instance: Start an individual instance in the cluster.
- Stop Instance: Stop an individual instance in the cluster.
- Add Instance: Add another instance to your cluster. When you select this action, Management Console opens the Add AWS Instance wizard, where you specify volume and storage information for the instance. You must supply your AWS key pair (and a Vertica Premium Edition license if you are adding more nodes to the cluster than a Community Edition license allows). You can add up to 10 instances at a time using the Add Instance action.
- Restart Instance: Restart an individual instance in the cluster.
- Terminate Instance: Permanently remove the instance from your cluster.