Administration on Kinetica Docs

Adding a Cluster to KAgent

Mon, 01 Jan 0001 00:00:00 +0000

If you have an existing on premise Kinetica cluster that is not managed by KAgent, you can add it to KAgent without upgrading it. This is particularly useful in the following scenarios: Not all administrative and normal users have direct server-level access to the nodes in the cluster, and they would like to individually manage all relevant services Not all administrative users have direct server-level access, and they would like to schedule and manage backups and snapshots and restore from snapshots if necessary Users would like to keep track of the valid Kubernetes Docker registries for use with KML The cluster addition process using KAgent involves adding key information about your cluster to KAgent, including deployment type, security information, node information, and current Kinetica-related packages/services installed.

Alerting

Mon, 01 Jan 0001 00:00:00 +0000

Kinetica provides a simple alerting system controlled by Host Manager that can monitor the health of the system and resource usage. Alert Parameters Using Alerts Run an Executable Status Changes CUDA Errors Fallback Allocator Errors System Errors Memory Usage Disk Usage Maximum Alerts Alerts are enabled by default and pre-configured to report on errors, critical system states, and a nominal set of resource usage thresholds. If an alert is triggered, the alert is stored in memory and also logged to alert_store.

Alerts

Mon, 01 Jan 0001 00:00:00 +0000

The Alerts page in KAgent hosts alert configuration and management as well as alert history. Visit Monitoring and Alerting for an overview of KAgent's monitoring and alerting capabilities, including configuring alerts and recipients. The Alerts page is divided into five tabs: History Metric Alerts Event Alerts Default Alerts Recipients Channels History The History tab displays a detailed alert history. Use the paging controls below the list of alerts to navigate through the history.

Backing Up/Restoring Kinetica

Mon, 01 Jan 0001 00:00:00 +0000

Overview Database Backup Snapshot Types Backup Storage Backup Use Case System Backup Prerequisites Backing Up Listing Restoring Deleting Backups Overview Kinetica provides two means of backing up data: Database Backup - full, incremental, & differential data hot backup System Backup - file-based full system backup Database Backup SQL commands can be used to initiate hot backups, with full, incremental, & differential snapshots, and restorations of schema objects & data within the database.

Changing the Administrator Password

Mon, 01 Jan 0001 00:00:00 +0000

To change the administration account password, follow these steps: Log into GAdmin Enter Username (default is admin) Enter Password (default is admin) Important If the database was installed using KAgent, the password will be the Admin Password created during setup. Click Login Click Admin in the top right corner Click Change Password Enter the Current Password Enter a New Password that meets the password strength requirements (up to 1024 characters)

Custom Logging

Mon, 01 Jan 0001 00:00:00 +0000

The default core Kinetica log that records database interactions, startup/shutdown, error information, and more is located at /opt/gpudb/core/logs/gpudb.log. This log file can be configured to use a custom format that conforms to a rolling logging standard, enable various appenders and/or loggers, change the logging level, and more using the /opt/gpudb/core/etc/gpudb_logger.conf file. Customizing the Log Log Levels Appenders ToConsole ToSysLog ToFile ToRollingFile ToRollingDatedFile ToBacktraceFile Loggers Auditing Customizing the Log Audit Appenders Console File Rolling File Customizing the Log Review the available Log Levels.

Dashboard

Mon, 01 Jan 0001 00:00:00 +0000

The Dashboard page in KAgent hosts cluster and ring summary information, which provides a quick way to gather the health of your Kinetica environments. Rings Ring Summary Events Timeline Cluster Summary Rings Rings is the default view for the Dashboard page. The Rings view displays a list of the rings added to this instance of KAgent. For each ring listed, the following information is available: a list of clusters in the ring, a visual indicator of the health of each node in each cluster, and a visual indicator of the health of each rank in each cluster.

Event Codes

Mon, 01 Jan 0001 00:00:00 +0000

When adding an Event Alert, there are many event codes to choose from. You can search through the available events in the event alert creation window using one of the event codes below or using keywords from a description of the desired event, e.g., shutdown, standby, etc. The events are organized by Kinetica component. Cluster Operations Data Source Subscriptions HTTPD High Availability (HA) Host Manager Machine Learning (ML) Monitoring Rank Operations Reveal SQL Query Planner Cluster Operations Event Code Severity Description / Log Message 01.

Events

Mon, 01 Jan 0001 00:00:00 +0000

The Events page in KAgent hosts a running log of all events that have occurred. Events are configured via the Alerts page. Review Event Codes for a list of all available events. Actions The available actions on the Events page are as follows: Refresh the list of events by clicking Refresh Update any of the Advanced Filter fields and click Apply Filter to filter the events list based on the provided values.

Host Manager

Mon, 01 Jan 0001 00:00:00 +0000

Host Manager is a supervisor process that manages several processes that are part of each Kinetica install. The following processes are managed by Host Manager and will be restarted if they fail unexpectedly: Database Services Text Search ODBC Server HTTPD Note Read more about managing the Host Manager process on Managing Kinetica Services. The Host Manager also serves the following endpoints: /admin/add/host /admin/alter/host /admin/remove/host /admin/show/alerts /admin/switchover

Job Manager

Mon, 01 Jan 0001 00:00:00 +0000

The Job Manager maintains request ordering across the nodes in your Kinetica cluster at the cost of some performance. All read requests (/show/table, /get/records, etc.) are processed simultaneously. When a write request (/insert/records, /delete/records, etc.) is made, all subsequent read and write requests are blocked until the current write request is finished. If Job Manager is disabled, all inbound requests are broadcasted to all worker nodes and can be executed in any order.

KAgent

Mon, 01 Jan 0001 00:00:00 +0000

KAgent is a multi-faceted administration, installation, and configuration management tool. It provides a centralized way to perform a consistent install across an existing or yet-to-be-cloud-provisioned cluster of computers. KAgent can also assist in automating tasks such as provisioning cloud hardware, configuring cluster security, adding and removing nodes, data backup and restoration, monitoring cluster health, managing and configuring cluster high availability. It has both a graphical (web) interface as well as a command line interface.

Manage

Mon, 01 Jan 0001 00:00:00 +0000

The Manage page allows users to install new clusters, add existing clusters, review KAgent logs and jobs, manage cluster high availability rings, and more. The Manage page has two main views depending on whether there is a cluster in KAgent or not. If no clusters have been added to KAgent yet, the Welcome page will appear by default allowing you to quickly jump into adding a cluster. If there are clusters in KAgent, the Clusters page will appear by default.

Managing Kinetica Services

Mon, 01 Jan 0001 00:00:00 +0000

Managing Database Services Start Database Services Database Services Startup Stop Database Services GUI Stop Command-Line Stop Managing System Processes Start System Management Processes Stop System Management Processes Managing All Services Start All Processes Stop All Processes Managing Individual Components System Status Checks Processes GAdmin API Statuses System Node Rank Typical maintenance of the system may require starting & stopping of Kinetica services. Managing Database Services Managing System Processes Managing All Services A variety of service status checks are available for assessing the health of the system and troubleshooting.

Monitoring and Alerting

Mon, 01 Jan 0001 00:00:00 +0000

Kinetica's monitoring and alerting features are available via the KAgent application. Detailed cluster, usage, and query statistics and metrics are available to assist administrators in monitoring their Kinetica environment. Administrators can configure alerts that are triggered when specific performance metric thresholds are exceeded (Metric Alerts) or by specific system events (Event Alerts). Administrators can then choose who should be notified when those alerts fire by configuring Recipients and Delivery Channels for alert delivery.

Queries

Mon, 01 Jan 0001 00:00:00 +0000

The Queries page in KAgent hosts a running log of all queries made against the database. Actions The available actions on the Queries page are as follows: Refresh the list of queries by clicking Refresh Update any of the Advanced Filter fields and click Apply Filter to filter the queries list based on the provided values. Click Clear to remove the filter. Open a detailed view of a query by clicking Detail next to the desired query:

Upgrade

Mon, 01 Jan 0001 00:00:00 +0000

Upgrading to Kinetica 7.2 is facilitated through the use of KAgent. KAgent 7.2 provides the ability to upgrade existing Kinetica clusters managed by KAgent 7.1 or clusters that are not managed at all. Upgrading requires the system be Kinetica 7.1 or newer. If running a Kinetica version prior to that, refer to the Kinetica 7.1 Upgrade instructions for details on upgrading to 7.1 first, and then refer back to this guide to complete the upgrade to version 7.

Usage

Mon, 01 Jan 0001 00:00:00 +0000

The Usage page in KAgent hosts detailed system and resource group usage statistics and metrics. System Events Timeline Resource Groups System The System tab under the Usage page displays several system usage metric and statistics graphs as well as an Events Timeline. Click one of the timeframe control buttons or select a date-time range to adjust the event timeline and the metric graphs to the selected duration Adjust the Ring, Cluster, and/or Node drop-down menus to filter the graphs for the selected ring / cluster / node Point the cursor to a graph to see the value at that time Events Timeline The Events Timeline displays events that have occurred within the selected timeframe.