OpenText Analytics Database 26.2.x – OpenText Core Analytics Database Settings Overview

Ot-Cad: Connection Data Settings

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

You can configure the default connection data settings in OTCAD. You can manage IP addresses with Classless Inter-Domain Routing (CIDR) and scale your plan to suit your requirements.

Ot-Cad: CIDR

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

CIDR

Cloud infrastructure engineers use CIDR notation to manage IP address ranges for cloud-based networks. IP addresses enable resources in your Virtual Private Cloud (VPC) to communicate with each other and with resources over the Internet. CIDR notation is a way to represent an IP address and its network mask.

OpenText supports ranges of IP addresses using Classless Inter-Domain Routing (CIDR) notation. For example, 192.168.1.0/24 represents all IPv4 addresses in the range of 192.168.1.0 to 192.168.1.255.

The format of these addresses is as follows:

An individual IPv4 address is 32 bits, with 4 groups of up to 3 decimal digits. For example, 10.0.1.0.
An individual IPv6 address is 128 bits, with 8 groups of 4 hexadecimal digits. For example, 2001:0db8:85a3:0000:0000:8a2e:0370:7334.

Public IPv4 and IPv6 addresses

All subnets have an attribute that determines whether a network interface created in the subnet automatically receives a public IPv4 address. Therefore, when you launch an instance into a subnet that has this attribute enabled, a public IP address is assigned to the primary network interface that's created for the instance. You can control whether your instance receives a public IP address by doing the following:

Modifying the public IP addressing attribute of your subnet.
Enabling or disabling the public IP addressing feature during instance launch, which overrides the subnet's public IP addressing attribute.
Unassigning a public IP address from your instance after launch by managing the IP addresses associated with a network interface.

Public IPv6 addresses are IPv6 addresses that can be configured to remain private or configured to be reachable over the Internet.

Private IPv4 and IPv6 addresses

Private IPv4 addresses are not reachable over the Internet and can be used for communication between the instances in your VPC. When you launch an instance into a VPC, a primary private IP address from the IPv4 address range of the subnet is assigned to the primary network interface (for example, eth0) of the instance. Each instance is also given a private (internal) DNS hostname that resolves to the private IP address of the instance.

You cannot share private IPv6 addresses on the Internet. You can use a private IPv6 address if you want your private networks to support IPv6 and you have no intention of routing traffic from these addresses to the Internet. You can connect to the internet from a resource that has a private IPv6 address. But you must route traffic through a resource in another subnet with a public IPv6 address.

Configure CIDR settings

To configure CIDR settings:

In the Settings Overview page, select View CIDR. The CIDR page displays.
Select Private.
To add an IP address, select Add IP.
From the Value drop-down list, select either IPv4 or IPv6 depending on the IP address you want to add. Do one of the following: a. Enter a valid IPv4 or IPv6 address. b. Copy a valid IPv4 or IPv6 address from another source and select Paste.
Select √.

Ot-Cad: Connection Data Settings

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

Scaling

Workload scaling enhances application performance and resource efficiency in dynamic environments. Scaling ensures that applications can handle varying workloads without performance degradation. OpenText provides the ability to automatically scale resources up or down based on real-time metrics, allowing organizations to respond quickly to changes in traffic. This elasticity not only improves user experience but also optimizes resource utilization, helping to minimize costs associated with underused or overprovisioned resources.

You cam manage compute to your database to improve the performance of complex analytic queries that have been running for a long time. Adding compute helps these queries run faster.

Configure the compute of your database to suit your query requirements and workload performance needs.

To manage compute for your database:

In the Settings Overview page, select Scaling.
Select View Scaling. The horizontal database scaling options are displayed. You can scale the database either manually or automatically. Do one of the following:

a. To manually scale the database, select Manual. b. Slide across the slider horizontally to scale the database depending on the size - small, small-medium, medium, medium-large, or large. c. Select Apply changes. d. In the View scaling log area, click the Audit log and Scaling log tabs to view the log details.

<-Or->

a. To automatically scale the database, select Auto. Select this option only if you need to automatically scale the database based on defined parameters. b. From the Scale up to drop-down list, select either Large or Medium depending on the size of your database.
Note
```
   Define the maximum compute beyond which the system cannot add anything and balance the loads automatically.
```
c. Use the CPU usage toggle button to scale out the database when the CPU usage exceeds a value in the range 1% to 100%. d. Use the Memory usage toggle button to scale out the database when the memory usage exceeeds a value in the range 1% to 100%.
Note
```
  When you apply both CPU usage and Memory usage, the system adds additional compute when either of the thresholds are reached.
```
e. Select Apply changes. f. In the View scaling log area, click the Audit log and Scaling log tabs to view the log details. The Audit log provides information about the following:
- Date & time
- Event
- Performed by The Scaling log provides information about the following:
- Date & time
- Scale event
- Compute (units)
- Triggered
- Performed by

Ot-Cad: Alerts

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

You can configure the default alert settings in OpenText™ Core Analytics Database (OTCAD).

Monitoring alerts

OTCAD periodically checks system health and performance. When an important event occurs or system performance fluctuates beyond user or system-defined limits, OTCAD generates a message to alert you about the state of your system. You can view and manage these alerts.

OTCAD sends alerts to you to ensure that you are immediately aware of any changes to your database that might require attention. You receive notifications by email and can also view them from the Bell icon in the upper‑right corner of the application.

Alert categories

Select Alerts in the Settings Overview page.

The All categories tab displays all alerts in the system by default.
The Queries tab displays pre-configured alerts to monitor queries.
The Resource pool tab displays pre-configured alerts to monitor resource pools.
The Custom tab displays custom alerts in the system.

Note
Turn the alert on to activate the corresponding pre-defined alert rule in the database. The system evaluates and sends notifications when alerts are turned on. Turning the alert off deactivates the corresponding alert rule and stops further evaluation and notifications.

Ot-Cad: Resource pools

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

Resource pools

A resource pool comprises a pre-allocated subset of the system resources with an associated queue. Super users can view information about resource pool parameters and make changes to existing parameters through the Resource pools page.

View resource pool details

You can view information about the resource pools available in the system. To view resource pool details:

In the Settings page, select Resource pools. The Resource pool page lists the following information:
- Name - Name of the resource pool.
- Memory size - Total per-node memory available to the database resource manager that is allocated to this resource pool.
- Runtime cap (seconds) - Maximum time (in seconds) for which a query in the resource pool can execute. If a query exceeds this setting, it cascades to a secondary pool.
- Priority - Priority of queries in this resource pool when they compete for resources in the GENERAL pool.
- Runtime priority - Specifies how the resource manager prioritizes run-time resources (CPU, I/O bandwidth) to queries already running in this resource pool.
- Queue timeout - The interval that the request waits for resources to become available before being rejected.
- Max concurrency - Maximum number of concurrent execution slots available to the resource pool across the cluster.
In the Actions column, select ⋮ and View details. The Pool details page lists pool-specific information.
Select Close.

Create a resource pool

Only super users can create and configure resource pools.

In the Settings page, select Resource pools > Create. The Create resource pools page is displayed.
In the Pool name field, enter a unique name for the resource pool. If you specify a resource pool name with uppercase letters, OTCAD converts them to lowercase letters.

The following naming requirements apply:
- Built-in pool names cannot be used for user-defined pools.
- All user-defined global resource pools must have unique names.
- Names of global resource pools cannot be the same.
From the Cascade to list, select an existing resource pool that is either a user-defined pool or the GENERAL pool.
From the User list, assign existing users to a resource pool. This resource pool is used to process all queries from its assigned users, allocating resources as set by resource pool parameters. The selected user is added to the resource pool by default.
In the Minimum memory field, enter the total per-node memory available to the database resource manager that is allocated to this resource pool. The default is 0%. From the list, select the percentage of total memory, or amount of memory in kilobytes, megabytes, gigabytes, or terabytes.
In the Maximum memory field, enter the maximum size per node the resource pool can grow by using memory from the GENERAL pool. From the list, select the percentage of total memory, or amount of memory in kilobytes, megabytes, gigabytes, or terabytes.
In the Maximum query memory field, enter the maximum amount of memory this resource pool can allocate at runtime to process a query. If the query requires more memory than this setting, OTCAD stops and returns an error. From the list, select the percentage of maximum memory, or amount of memory in kilobytes, megabytes, gigabytes, or terabytes upto the value of maximum memory.
The CPU affinity mode specifies whether the resource pool has exclusive or shared use of the CPUs specified in the Affinity set field below. Select one of these values:
- Shared - Queries that run in this resource pool share its Affinity set CPUs with other resource pools.
- Exclusive - Dedicates Affinity set CPUs to this resource pool only and excludes other resource pools. If Affinity set is set as a percentage, then that percentage of CPU resources available only are assigned to this resource pool.
- Any - Queries in this resource pool can run on any CPU.
Affinity set - CPUs available to this resource pool. All nodes must have the same number of CPUs. The CPU resources assigned to this set are not available to GENERAL resource pools. From the list, do one of the following:
- Select Range to dedicate a range of contiguous CPU indexes in the From and To fields to this resource pool.
- Select Single to dedicate one or more comma-delimited CPUs to this resource pool.
- Select Percentage to dedicate the percentage of all available CPUs to use for this resource pool. The database rounds this percentage down to include whole CPU units.
In the Minimum concurrency field, enter the preferred number of queries to execute concurrently in the resource pool. Select the Auto option to calculate the value automatically at query runtime. The system sets this parameter to the lower of these two calculations, but never less than 4:
- Number of logical cores
- Memory divided by 2GB
Change this parameter only after evaluating performance over a period of time.
Note
```
   If the number of logical cores on each node is different, **Auto** is calculated differently for each node. Distributed queries run like the minimal effective planned concurrency. Single node queries run with the planned concurrency of the initiator.
```
In the Maximum concurrency field, enter the maximum number of concurrent execution slots available to the resource pool.
In the Execution parallelism field, enter the number of threads used to process any single query issued in this resource pool. Select the Auto option to calculate the setting from the number of cores, available memory, and amount of data in the system. Unless memory is limited, or the amount of data is very small, the system sets this parameter to the number of cores on the node.
In the Pool priority field, enter the priority of queries in this resource pool when they compete for resources in the GENERAL pool. Enter either negative or positive integer values, where higher numbers denote higher priority.
- For user-defined resource pools, enter a value in the range -100 to 100.
- For built-in resource pools such as SYSQUERY, RECOVERY, and TM, enter a value in the range of -110 to 110.
From the Runtime priority list, select how the resource manager should prioritize dedication of run-time resources (CPU, I/O bandwidth) to queries already running in this resource pool. Select one of Low, Medium, or High. The default is Medium.
In the Runtime priority threshold field, enter the maximum time (in seconds) in which query processing must complete before the resource manager assigns to it the resource pool's RUNTIMEPRIORITY. All queries run with a priority of HIGH. The default value is 2.
In the Queue timeout (seconds) field, enter the maximum time (not more than an year) a request can wait (in seconds) for pool resources before it is rejected. There is no maximum wait time. Requests can be queued indefinitely up to one year.
In the Runtime cap (seconds) field, enter the maximum run time allowed (not more than an year) to queries in this resource pool. If a query exceeds this setting, it cascades to a secondary pool.

Edit a resource pool

After creating a resource pool, you can edit the details to suit your requirements. Only database administrators can edit resource pools.

In the Resource pools page, under the Actions column, choose ⋮ and Edit. All the details about the resource pool are populated. You cannot edit the following fields:
- Pool name
- Affinity set
- Minimum currency
- Execution parallelism
From the Cascade to list, choose the secondary resource pool for executing queries that exceed the RUNTIMECAP setting of their assigned resource pool.
From the User list, assign existing users to a resource pool. This resource pool is used to process all queries from its assigned users, allocating resources as set by resource pool parameters. The selected user is added to the resource pool by default.
In the Minimum memory field, enter the total per-node memory available to the database resource manager that is allocated to this resource pool. The default is 0%. From the list, select the percentage of total memory, or amount of memory in kilobytes, megabytes, gigabytes, or terabytes.
In the Maximum memory field, edit the maximum size per node the resource pool can grow by using memory from the GENERAL pool. From the list, select the percentage of total memory, or amount of memory in kilobytes, megabytes, gigabytes, or terabytes.
In the Maximum query memory field, edit the maximum amount of memory this resource pool can allocate at runtime to process a query. If the query requires more memory than this setting, OTCAD stops and returns an error. From the list, select the percentage of maximum memory, or amount of memory in kilobytes, megabytes, gigabytes, or terabytes upto the value of maximum memory.
The CPU affinity mode specifies whether the resource pool has exclusive or shared use of the CPUs specified in the Affinity set field below. Select one of these values:
- Shared - Queries that run in this resource pool share its Affinity set CPUs with other resource pools.
- Exclusive - Dedicates Affinity set CPUs to this resource pool only and excludes other resource pools. If Affinity set is set as a percentage, then that percentage of CPU resources available only are assigned to this resource pool.
Affinity set - Edit the CPUs available to this resource pool. All nodes must have the same number of CPUs. The CPU resources assigned to this set are not available to GENERAL resource pools. From the list, do one of the following:
- Select Range to dedicate a range of contiguous CPU indexes in the From and To fields to this resource pool.
- Select Single to dedicate one or more comma-delimited CPUs to this resource pool.
- Select Percentage to dedicate the percentage of all available CPUs to use for this resource pool. The database rounds this percentage down to include whole CPU units.
In the Maximum concurrency field, edit the maximum number of concurrent execution slots available to the resource pool.
In the Pool priority field, edit the priority of queries in this resource pool when they compete for resources in the GENERAL pool. Edit either negative or positive integer values, where higher numbers denote higher priority.
- For user-defined resource pools, enter a value in the range -100 to 100.
- For built-in resource pools such as SYSQUERY, RECOVERY, and TM, enter a value in the range of -110 to 110.
From the Runtime priority list, select how the resource manager should prioritize dedication of run-time resources (CPU, I/O bandwidth) to queries already running in this resource pool. Select one of Low, Medium, or High. The default is Medium.
In the Runtime priority threshold field, edit the maximum time (in seconds) in which query processing must complete before the resource manager assigns to it the resource pool's RUNTIMEPRIORITY. All queries run with a priority of HIGH. The default value is 2.
In the Queue timeout (seconds) field, edit the maximum time (not more than an year) a request can wait (in seconds) for pool resources before it is rejected. There is no maximum wait time. Requests can be queued indefinitely up to one year.
In the Runtime cap (seconds) field, edit the maximum run time allowed (not more than an year) to queries in this resource pool. If a query exceeds this setting, it cascades to a secondary pool.

For more information about editing a resource pool, see Create a resource pool.

Delete a resource pool

You can delete a resource pool that is no longer in use or required.

In the Resource pools page, under the Actions column, choose ⋮ and Delete.
In the Confirmation dialog, select Delete. Requests that are queued against the deleted pool are transferred to the GENERAL pool according to the priority of the pool compared to the GENERAL pool. If the pool’s priority is higher than the GENERAL pool, the requests are placed at the head of the queue; otherwise, transferred requests are placed at the end of the queue.

Ot-Cad: Log files

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

Log files

Database administrators can collect diagnostic information about a database in log files. The customer support team might request users to share these log files when resolving a case. To collect data from all system tables, you must have superuser privilege; otherwise, the log files collect data only from the system tables that you have privileges to access.

Collecting diagnostics

The diagnostics tool scrutinize collects a broad range of information from a Vertica cluster. It also supports a range of options that let you control the amount and type of data that is collected. Collected data can include but is not limited to:

Host diagnostics and configuration data
Run-time state (number of nodes up or down)
Log files from the installation process, the database, and the administration tools
Error messages
Database design
System table information, such as system, resources, workload, and performance
Catalog metadata, such as system configuration parameters
Backup information

View log file information

You can view information about the log files available in the system. To view log file details:

In the Settings page, select Log files. The Log files page lists the following information:
- Log name - Diagnostic information about the database cluster.
- File type - The log file type. In this release, it is Scrutinize.
- Created at - The date and timestamp at which the log file is created.
- Created by - The user ID of the person who created the log file.
- Status - The current status of the log file.
- Last updated - The date and timestamp at which the log file was last updated.
- Actions - Options to download, share, and delete the log file.

Create a log file

Only superusers can create log files.

In the Settings page, select Log files.
Click +Create log file. The file type appears as Scrutinizer Log. You cannot edit the file type.
Set the start date and time.
- In the Start date (UTC) field, click the calendar icon.
- Select the required start date.
- Specify the start time in UTC.
- Ensure the selected start date and time accurately reflect when log collection should begin.
Set the end date and time.
- In the End date (UTC) field, click the calendar icon.
- Select the required end date.
- Specify the end time in UTC.
- Ensure the selected end date and time accurately reflect when log collection should stop.
Click Create. The log file is created.
The status of the log file changes from Initiated to In progress and then to either Completed or Failed.
To cancel the creation of a log file, select the log file displayed in the Initiated state and do the following:
- Hover over the Actions column.
- Choose ⋮.
- Click Cancel. The status of the log files changes to Cancelled.

Download a log file

You can download the log files available in your system for your reference.

In the Settings page, select Log files.
Hover over the Actions column.
Choose ⋮ and click Download. The log file is downloaded to a local drive in your system.

You can share log files with the customer support team for help with troubleshooting any issues in the database. There are 2 ways in which you can share log files with the customer support team.

Upload the scrutinizer log files in the support case. <--or-->
Share the log file from OTCAD.

To share a log file with customer support:

In the Settings page, select Log files.
Hover over the Actions column.
Choose ⋮ and click Share. The Share Log file screen appears.
In the Case ID field, enter the case ID that is generated from the customer support ticket that you raised to report issues in the database.
Click Share. You receive an acknowledgement through email. You will also receive the vAdvisor Report in a separate email.

Delete a log file

You can delete log files that are no longer needed. To delete a log file:

In the Settings page, select Log files.
Hover over the Actions column.
Choose ⋮ and click Delete. The log file is deleted.

OpenText Analytics Database 26.2.x – OpenText Core Analytics Database Settings Overview

Ot-Cad: Connection Data Settings

Ot-Cad: CIDR

CIDR

Public IPv4 and IPv6 addresses

Private IPv4 and IPv6 addresses

Configure CIDR settings

Ot-Cad: Connection Data Settings

Scaling

Note

Note

Ot-Cad: Alerts

Monitoring alerts

Alert categories

Note

Ot-Cad: Resource pools

Resource pools

View resource pool details

Create a resource pool

Note

Edit a resource pool

Delete a resource pool

Ot-Cad: Log files

Log files

Collecting diagnostics

View log file information

Create a log file

Download a log file

Share a log file with customer support

Delete a log file