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:

1. To begin setting up a cluster, click Add New or Existing Cluster from KAgent UI 

2. Provide the cluster configuration details 
   1. Name of the cluster and name cannot contain spaces or underscores 
   2. For Packages, select the packages core and etcd
   3. For Install Method, select Online which installs directly from the online Kinetica repository
   4. For the version, select either CUDA (GPU) or Intel (CPU-only) based on card type
   5. Enter the License Key
   6. Click Next

3. Select the On Premise deployment method and click Next 

4. Provide the Security configuration details (these steps are only required if Core is being installed) 
   1. Enter and confirm an Admin Password. This must meet the password strength requirements 
   2. Select an SSL Mode as Cert/key setup not required
   3. Select an Authentication type as None for no authentication 
   4. Click Next

5. Provide the Node configurations 
   1. For each node, input a custom Label (hostname is suggested), the Internal IP, and the Public IP
   2. Select the node that has core and etcd package installed
   3. 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 

4. Click Next 

6. Provide the 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 

7. 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

8. 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 
9. Click Install. KAgent will open a window displaying the progress of the installation 

10. After the installation, the cluster will be added to KAgent which logs you into KAgent as the admin user for the cluster

11. Add new node to existing Kinetica cluster 
    1. Go to Manage of existing cluster from KAgent UI
    2. Click Add Node and provide Add Node configurations
    3. Provide a custom Label (hostname is suggested), the Internal IP, and the Public IP
    4. Select Worker node
    5. Click Add

12. KAgent will open a window displaying the progress of the adding new node 
13. 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

14. 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).