Installation of Kinetica using KAgent involves the automated deployment of the installation package via a browser-based UI or a console-driven CLI. We chose a browser-based UI for this white paper.
Pre-requisites:
- Ensure the KAgent service is started.
service kagent_ui status
- Browse to the KAgent UI using IP or hostname.
http://<kagent-host>:8081/kagent
Procedure:
- To begin setting up a cluster, click Add New or Existing Cluster from KAgent UI
![Diagram
Description automatically generated](https://cdn-prod.scdn6.secure.raxcdn.com/static/media/9198938f-8c47-5a0e-82d9-6db6a62cd3f7/DAM-11916ab0-c1fe-452c-bc6d-926f8f109450/out/1201.010.png)
- Provide the cluster configuration details
- Name of the cluster and name cannot contain spaces or underscores
- For Packages, select the packages core and etcd
- For Install Method, select Online which installs directly from the online Kinetica repository
- For the version, select either CUDA (GPU) or Intel (CPU-only) based on card type
- Enter the License Key
- Click Next
![](https://cdn-prod.scdn6.secure.raxcdn.com/static/media/9198938f-8c47-5a0e-82d9-6db6a62cd3f7/DAM-11916ab0-c1fe-452c-bc6d-926f8f109450/out/1201.011.png)
- Select the On Premise deployment method and click Next
![](https://cdn-prod.scdn6.secure.raxcdn.com/static/media/9198938f-8c47-5a0e-82d9-6db6a62cd3f7/DAM-11916ab0-c1fe-452c-bc6d-926f8f109450/out/1201.012.png)
- Provide the Security configuration details (these steps are only required if Core is being installed)
- Enter and confirm an Admin Password. This must meet the password strength requirements
- Select an SSL Mode as Cert/key setup not required
- Select an Authentication type as None for no authentication
- Click Next
- Provide the Node configurations
- For each node, input a custom Label (hostname is suggested), the Internal IP, and the Public IP
- Select the node that has core and etcd package installed
- Select that node for Head node using the corresponding radio button.
This server will receive user requests and parcel them out to the other worker nodes of the system. The head node of the cluster will also be used for the administration of the cluster. And by default, the hosting of GAdmin and as such
- Click Next
- Provide the credentials
- 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)
- Optionally, enter the sudo password
- Click Verify
- The console will appear to show the log of KAgent interactions as KAgent attempts to access the cluster with the provided credentials and retrieve information about the hosts, including Kinetica version and configuration (if installed), hostname and IP addresses, OS type, and Nvidia information
![Machine generated alternative text:
kin=tico
Manage
usage
Queries
C Events
d Alerts
Manage
O Home > default
v Cluster
Installation Summary
O Rings
e Jobs
¯ Logs
E] Console
Cluster
V
> kent-cluster
Deployment
Security
V
Version/Build
License Key
SSL/Auth
Nvidie Driver
Nodes
V
Credentials
O
Installation
Please review your configuration before installing
Cluster Neme
Install Packages
Admin Password
Deployment
Cluster Nodes
SS* Credentials
Sudo Pessword
@ Cancel
kent-cluster
Core, etcd
ONPREM w/ open Firewall Ports
172.30.222.86
label-O
Head
172.30.222.86
ubuntu01
CLI Commends
7.1.3.1 CUDA
Provided
No Setup + No Auth
No Install
< Previous
Install v'](https://cdn-prod.scdn6.secure.raxcdn.com/static/media/9198938f-8c47-5a0e-82d9-6db6a62cd3f7/DAM-11916ab0-c1fe-452c-bc6d-926f8f109450/out/1201.013.png)
- Review the Installation Summary to ensure that there are no validation errors in the information. The highlighted IP address will be the one KAgent uses to connect to the cluster
- Click Install. KAgent will open a window displaying the progress of the installation
- After the installation, the cluster will be added to KAgent which logs you into KAgent as the admin user for the cluster
![Machine generated alternative text:
kin=tico
Dashboard
Manage
usage
Queries
C Events
d Alerts
Dashboard
Rings
default
Clusters
kent-cluster
up
Nodes
Collapse All
C Refresh
Expend All
Q Details
WARN
DOWN
UP WARN
Ranks
DOWN
Infrastructure Services
Replication (RabbitMQ)
Not configured
Config Management (etcd)
O Restart > Start Stop Modify](https://cdn-prod.scdn6.secure.raxcdn.com/static/media/9198938f-8c47-5a0e-82d9-6db6a62cd3f7/DAM-11916ab0-c1fe-452c-bc6d-926f8f109450/out/1201.014.png)
- Add new node to existing Kinetica cluster
- Go to Manage of existing cluster from KAgent UI
- Click Add Node and provide Add Node configurations
- Provide a custom Label (hostname is suggested), the Internal IP, and the Public IP
- Select Worker node
- Click Add
![Machine generated alternative text:
kin=tico
Dashboard
Manage
usage
Queries
C Event:
d Alerts
G Logout
Manage
O Rings
Nodes
Switchover
node 1
C)
kin-cluster
Detail
Security
Failover Configurati
G) Backups
Config
Q) Admir
Public IP
Enter IP
O Rings
x
G) Add New Node
Worker Spare
Jobs
Logs
con
ONPREM/PROVISIONED
Add Nodes Configuration
Specify nodes to be Gdded to this cluster
Label
Enter hostname
Internal IP
Enter IP
Cancel
Add](https://cdn-prod.scdn6.secure.raxcdn.com/static/media/9198938f-8c47-5a0e-82d9-6db6a62cd3f7/DAM-11916ab0-c1fe-452c-bc6d-926f8f109450/out/1201.015.png)
- KAgent will open a window displaying the progress of the adding new node
- After adding new node, the node will be added to cluster and will then log you into KAgent as the admin user for the cluster
![Machine generated alternative text:
kinstico
Dashboard
Manage
usage
Queries
C Events
d Alerts
G Logout
Manage
O Rings > default
Nodes
> kin-cluster
Detail
Backups
node2
Logs
Config
X Remove
Q) Admin
O Rings
Add Node
e Jobs
¯ Logs
E] Cons
C Reft
Security
List
Switchover
Failover Configuration
node 1
Logs
X
Remove](https://cdn-prod.scdn6.secure.raxcdn.com/static/media/9198938f-8c47-5a0e-82d9-6db6a62cd3f7/DAM-11916ab0-c1fe-452c-bc6d-926f8f109450/out/1201.016.png)
- GAdmin Status Test, log in to GAdmin. Browse to Dashboard to view the status of the overall system and ranks to view the status breakdown by rank
For more details on GAdmin, see Kinetica Administration Application (GAdmin).
![Machine generated alternative text:
kin=tico
Cluster Data •
Dashboard
Query
Resource
kent-virtual-machine
CPU
0.017%
Disk
10.51 Ga
0.07 Ga
O Security
Running
503_72 GB
1.24 GB
O Info •
IA Stats
System Running
O
Dashboard
Ranks
Admin
License
Config
Alerts
Logging
Debug
Demo
Visualize
0.1
Kinetica v7.1.3.1.20210308202500 Trial Edition
Rank 0 •
kinetica-virtual-machine
Running
CPU
Disk
11.78 GB
Cores
12
Mem
0.083%
4.52
Mem
0.0B GB
Uptime
0.88 d
IP Address
172.30.222.85
Rank 2
Running
Cores
12
Rank 1
Running
Uptime
0.88 d
Rank 3
Running
IP Address
172.30.222.86
Rank 4
Running](https://cdn-prod.scdn6.secure.raxcdn.com/static/media/9198938f-8c47-5a0e-82d9-6db6a62cd3f7/DAM-11916ab0-c1fe-452c-bc6d-926f8f109450/out/1201.017.png)