Adding a Cluster to KAgent

Cluster

1. Enter a name for the cluster. The name cannot contain spaces or underscores.

2. Optionally, select one or more of the following packages:

   • Select Core if node(s) in the cluster have the core database functionality installed on them.

   • Select Etcd if node(s) in the cluster have etcd installed on them.

     Important

     The etcd package is required for the following:

     • cluster status reporting via KAgent and GAdmin
     • ring resilience
     • cluster monitoring

   • Select Graph if a node in the cluster has the graph server installed on it. See Network Graphs & Solvers Concepts for more information.

   • Optionally, select AAW (Active Analytics Workbench) if a node has AAW installed on it. See Active Analytics Workbench for more information.

   • Optionally, select KAgent if another node in the cluster has KAgent installed on it. See KAgent for more information.

   • Optionally, select HA if the cluster is currently in a ring. Review High Availability Architecture and High Availability Configuration & Management for more information.

3. For the Install Mode, select Online (install directly from the online Kinetica repository).

4. For the Version, select either CUDA (GPU) or Intel (CPU-only) depending on the package variant that's already installed on the current cluster you want to add to KAgent.

   Tip

   Use the following command to determine the Kinetica package that is already on the machine:

   # RHEL
   rpm -qa | grep 'gpudb'
   
   # Ubuntu
   apt list --installed | grep 'gpudb'
   

5. Enter the license key.

6. Optionally, provide an external files directory for use with external tables to override the default external files directory parameter value.

7. If AAW is selected, select the Custom type for K8 Setup (Kubernetes should already exist and KAgent will not install anything during this process). Upload a configuration file for an already existing Kubernetes installation and provide a public IP address for the server hosting the Kubernetes installation. Note that AAW requires Kubernetes; see Active Analytics Workbench (AAW) Overview for more information.

8. Click Next.

Deployment

1. Select the On Premise deployment method, and click Next.

   Important

   If clearing the Open Firewall Ports checkbox, the firewall then must be configured manually to allow the required ports listed in the default ports table. Consult Adjust Firewall for tips on configuring the firewall.

Security

1. Enter and confirm the existing Admin Password. This is the password used to access Reveal, Active Analytics Workbench (AAW), KAgent, and GAdmin as the default Admin user.

   Important

   The password provided here must match the existing cluster's admin password.

2. Select an SSL Mode that best aligns with the existing cluster's SSL configuration:

   • Cert/key setup not required -- Kinetica will not require SSL certificate/key creation/upload but there will be no updates to security configuration settings
   • User-provided cert/key per node -- user must upload an SSL certificate and key for each node; Kinetica copies the cert/key pair to /opt/gpudb/certs, enables HTTPD, and configures HTTPD to use HTTPS
   • Generate self-signed cert/key per node -- KAgent generates a self-signed certificate and key for each node and places it in /opt/gpudb/certs, enables HTTPD, and configures HTTPD to use HTTPS

3. Select the current Authentication type used for the existing cluster and fill the fields as necessary:

   • None -- no authentication or authorization
   • LDAP -- configures Kinetica to authenticate via LDAP; requires authentication to connect to the database, enables authorization, enables external authentication, automatically creates users in the database for LDAP users, and automatically grants roles in the database to LDAP users
   • Active Directory -- configures Kinetica to authenticate via Microsoft Active Directory; requires authentication to connect to the database, enables authorization, enables external authentication, automatically creates users in the database for Active Directory users, and automatically grants roles in the database to Active Directory users
   • Kerberos -- configures Kinetica to authenticate via Kerberos; requires authentication to connect to the database, enables authorization, enables external authentication, automatically creates users in the database for Kerberos users, and automatically grants roles in the database to Kerberos users

4. Click Next.

Nodes

1. Click Add New Node until the number of nodes in KAgent matches the number of nodes in the current cluster.

2. Input a custom Label (hostname is suggested), the Internal IP, and the External IP for each existing node into KAgent.

3. If the User-provided cert/key per node SSL Mode was selected in Security, an SSL column will be added to the configuration page--click the lock icon in the SSL column to open the SSL Certificate/Key window, where the SSL cert and key, along with an optional public hostname, can be provided. Repeat this for each node.

4. Select each node that has the Core package installed.

5. Select each node that has the Etcd package installed.

6. For the existing head node host, designate it as the head node in KAgent by selecting the Head Node radio button next to it.

7. If the Graph package was selected for install in Cluster and existing node(s) hosts a graph server, designate it as a Graph node using the corresponding radio button. The graph node(s) hosts the graph server. The graph node does not need to have the Core package enabled.

8. If the AAW package was selected for install in Cluster, set the number of reserved GPUs for AAW to use for each node. The AAW service co-exists with the head node. Note that the AAW package is automatically installed on every node with the Core package enabled.

   Important

   Some features of AAW require GPUs to work or have increased performance. Review the AAW documentation for more information.

9. If the RabbitMQ package was selected for install in Cluster because a High Availability setup is already enabled, select the node(s) that have RabbitMQ installed.

10. Click Next.

11. Confirm which IP address KAgent should use to connect to the cluster: Internal or Public.

Credentials

1. For the Server SSH Credentials, enter the SSH username and password or upload the SSH private key that will be used to access the node(s).
2. Optionally, enter the sudo password.
3. Click Verify.

The console will appear showing the log of KAgent interactions as KAgent attempts to access the cluster with the provided credentials and also retrieve information on the hosts, including Kinetica version and configuration (if installed), hostname and IP addresses, OS type, and Nvidia information.

Important

If the configuration you have selected does not match the current configuration on the cluster you're trying to upgrade, KAgent will list the errors and provide the opportunity to fix the configuration manually or automatically.

Add Cluster

Existing cluster version information will be detected and the Add Only + button will be activated.

1. Review the Add Summary to ensure there are no validation errors in the information.
2. Click Add Only +. KAgent will open a window displaying the progress of the cluster addition.

After a successful cluster addition, you'll be returned to the KAgent home page and also will be offered to be redirected to GAdmin on the head node. Review KAgent for more information on using KAgent.