2.3 Managing Exadata Capacity Planning Plugin

The Exadata Capacity Planning Plugin uses systemd units to manage the CPU and memory resources consumed by capacity plugin jobs on the Fleet server.

Enabling the Exadata Capacity Planning Plugin

To enable the plugin, run the following script from the installation directory:

sudo bash /<install_loc>/collection_processing_engine/util/configure_cgroups_capacity.sh --enable

Note:

Root privileges are required to grant the current AHF Linux user permission to manage systemd units.

Once the capacity plugin is enabled from the AHFFI server side, enable the weekly capacity collection upload from the cluster side.

Log in to the cluster(s) registered with the Fleet Server and run the following command. This command configures exachk to schedule weekly capacity collections every Sunday at 4:00 a.m.:

exachk -set "AUTORUN_SCHEDULE=0 4 * * 0;AUTORUN_FLAGS=-profile workload-capacity -showpass -tag autostart_client_capacity -readenvconfig;COLLECTION_RETENTION=2" -id autostart_client_capacity

This setup ensures that capacity data is automatically collected and uploaded on a weekly basis.

Default Resource Limits

When enabled with default settings, all running capacity plugin jobs collectively consume:

• 25% of total CPU resources (equivalent to 1 core on a 4-core system)
• 25% of total system memory

These limits help ensure that capacity jobs do not overwhelm the system and can be adjusted as needed.

Modifying Resource Limits

To change the default limits, use the script with the --reset option:

sudo bash /<install_loc>/collection_processing_engine/util/configure_cgroups_capacity.sh --reset

Viewing Available Options

To list all available configuration options, run:

sudo bash /<install_loc>/collection_processing_engine/util/configure_cgroups_capacity.sh --help

Option	Description
--reset [--cpu <quota>] [--memory <limit>]	Resets the resource limits to default or provided values (CPU: 25% per core, Memory: 25% of total RAM). Note: The --reset option can only be used if resource limiting is already enabled.
--enable [--cpu <quota>] [--memory <limit>]	Enables the resource limits with default or provided settings.
--disable	Disables resource limiting and remove polkit permissions.
--status	Checks if resource limiting is currently enabled.
-h, --help	Prints this help message and exits.