Cava configurations
Overview
Cava configurations enable the engine to support Cava plugins. You can upload your own Cava scripts to customize functions, scorers, and summaries.
Add a Cava configuration
To view or edit a Cava configuration, choose Configuration Management > Cluster Configuration > Cava Configurations. The page shows a list of Cava configuration versions. Each version is labeled with its status (In Use or Not Used). Versions that are not used also support the Delete action.
Select the version to edit and click Edit.
Here, you can create directories or upload files.
Note the following requirements.
Uploaded files must meet the following conditions.
The file size cannot exceed 20 MB.
The file format must be one of the following: .cava, .json, .txt, or .xml.
Add a directory - directory name requirements:
It can consist of letters, digits, and underscores.
It cannot exceed 100 characters.
After the Cava script is uploaded, click Publish New Version.
Related configuration descriptions:
cava_alloc_size_limit: The maximum memory that can be allocated at the query level. This parameter can be omitted to use the default value.
cava_compile_thread_num
cava_config
cava_loop_and_func_limit:
cava_max_variable_count
cava_module_cache_size: The maximum number of source code items that can be cached and passed in a query. When this limit is exceeded, LRU eviction starts. This parameter can be omitted to use the default value.
enable_cava: Specifies whether to enable the Cava feature.
4. After the configuration is published, the system automatically generates a Cava configuration version.
5. After the adjustment, go to the Cluster Management - Configuration Update page, click Update, and select a version to apply it.
6. After the version is generated, you can view the progress of the configuration taking effect in Feature Extension > Changes. The FSM process for pushing the online configuration includes the following change nodes in sequence: Parameter Check, Create Task, Configuration Merge, Submit to Online Cluster, and Wait for Configuration to Take Effect. When all nodes show a success status, the configuration has taken effect.
After the FSM process is complete, the Cava configuration file is available for use in the engine.
Delete a Cava configuration
For a Cava configuration version whose status is "Not Used", you can click Delete directly on the Cluster Configuration > Cava Configurations page.
Notes
Once a version is published, its configuration content can no longer be changed.
A published version can be edited to generate a new version.
When you edit based on an existing version, the system saves only the latest draft.
Only versions that are not used can be deleted. Versions that are in use cannot be deleted.