The Configuration Framework Service (CFS) provides a global service options endpoint for modifying the base configuration of the service itself.
View the options with the following command:
cray cfs options list --format json
Example output:
{
"additionalInventoryUrl": "",
"batchSize": 25,
"batchWindow": 60,
"batcherCheckInterval": 10,
"batcherMaxBackoff": 3600,
"defaultAnsibleConfig": "cfs-default-ansible-cfg",
"defaultBatcherRetryPolicy": 1,
"defaultCloneUrl": "https://api-gw-service-nmn.local/vcs/cray/config-management.git",
"defaultPlaybook": "site.yml",
"hardwareSyncInterval": 10,
"sessionTTL": "7d"
}
The values for all CFS global options can be modified with the cray cfs options update
command.
The following are the CFS global options, their names in CFS, and their default values.
Option | CFS name | Default | Type | Units/format |
---|---|---|---|---|
Additional inventory URL | additionalInventoryUrl |
"" |
string | Git clone URL |
Batch size | batchSize |
25 |
integer | Components |
Batch window | batchWindow |
60 |
integer | seconds |
Batcher check interval | batcherCheckInterval |
10 |
integer | seconds |
Batcher maximum backoff | batcherMaxBackoff |
3600 |
integer | seconds |
Default Ansible configuration | defaultAnsibleConfig |
"cfs-default-ansible-cfg" |
string | ConfigMap name in services namespace |
Default batcher retry policy | defaultBatcherRetryPolicy |
3 |
integer | Component configuration attempts |
Default clone URL | defaultCloneUrl |
"https://api-gw-service-nmn.local/vcs/cray/config-management.git" |
string | Git clone URL |
Default playbook | defaultPlaybook |
"site.yml" |
string | Name of Ansible playbook |
Hardware synchronization interval | hardwareSyncInterval |
10 |
integer | seconds |
Session Time-To-Live (TTL) | sessionTTL |
"7d" |
string | Length of time or empty string |
A Git clone URL to supply additional inventory content to all CFS sessions.
additionalInventoryUrl
""
(empty string)See Manage Multiple Inventories in a Single Location for more information.
This option determines the maximum number of components that will be included in each session created by CFS Batcher.
batchSize
25
components per sessionWARNING: Increasing this value will result in fewer batcher-created sessions, but will also require more resources for Ansible Execution Environment (AEE) containers to do the configuration.
See Configuration Management with the CFS Batcher for more information.
This option sets the number of seconds that CFS batcher will wait before scheduling a CFS session when the number of components needing configuration has not reached the batch size limit.
batchWindow
60
secondsThe batch window time-boxes the creation of sessions so no component needs to wait for the queue to fill.
WARNING: Lower values will cause CFS batcher to be more responsive to creating sessions, but values too low may result in degraded performance of both the CFS APIs as well as the overall system.
See Configuration Management with the CFS Batcher for more information.
This option sets how often CFS batcher checks for components waiting to be configured.
batcherCheckInterval
10
secondsThis value must be lower than the batch window.
WARNING: Lower values will cause CFS Batcher to be more responsive to creating sessions, but values too low may result in degraded performance of the CFS APIs on larger systems.
See Configuration Management with the CFS Batcher for more information.
This option specifies the maximum number of seconds that the CFS batcher’s back-off will reach.
batcherMaxBackoff
3600
secondsWhen all sessions are failing, CFS batcher will reduce the frequency with which sessions are created. This back-off time will continue to increase up to this cap, and will reset to 0 when a new session is successful.
See Configuration Management with the CFS Batcher for more information.
The name of the Kubernetes ConfigMap in the services
namespace that contains the
Ansible configuration to use for CFS sessions when none is explicitly specified.
defaultAnsibleConfig
"cfs-default-ansible-cfg"
See Set the ansible.cfg
for a Session for more information.
The default batcher retry policy is the maximum number of failed configuration attempts allowed per component before CFS batcher will stop attempting to configure the component.
defaultBatcherRetryPolicy
3
attempts to configure a componentThis value can be overridden on a per component basis.
For more information, see:
NOTE: This option is deprecated and has no effect. It is removed in CSM 1.2.
defaultCloneUrl
"https://api-gw-service-nmn.local/vcs/cray/config-management.git"
This value is used when no playbook is specified in a configuration layer.
defaultPlaybook
"site.yml"
For more information on configuration layers, see Configuration Layers.
The number of seconds between checks to the Hardware State Manager (HSM) for new hardware additions to the system.
hardwareSyncInterval
10
secondsWhen new hardware is registered with HSM, CFS will add it as a component.
See Configuration Management of System Components for more information.
The time-to-live for completed CFS sessions.
"sessionTTL"
"7d"
Running sessions will not be deleted.
Specified in minutes (e.g. "45m"
), hours (e.g. "9h"
), days (e.g. "17d"
), or weeks (e.g. "57w"
).
Set to an empty string to disable.
For more information, see Automatic Session Deletion with sessionTTL
.