Update IDEA configuration (idea-admin.sh config)
PreviousPatch IDEA module (idea-admin.sh patch)NextUpdate IDEA backend resource (idea-admin.sh deploy)
Last updated
Last updated
Use the Config command if you want to make a configuration change (e.g: enable SES, point DCV driver to a new version, change default security group ...). Refer to Update IDEA configuration (idea-admin.sh config) for other types of updates.
idea-admin.sh config utility is a powerful tool that allow you to control the vast majority of your cluster configuration/parameters without having to manually access the configuration files. In this example, we will demonstrate how you can easily update the integration of IDEA with AWS Backup.
Admins run the idea-admin.sh config utility to retrieve/update the current configuration
Configuration change is updated on the Amazon DynamoDB table associated to the IDEA cluster
DynamoDB Stream updates the relevant IDEA module automatically after a configuration parameter has been changed
Configuration keys are prefixed with the module information.
See some examples below:
scheduler.security_group_id is linked to the HPC WorkLoads module
vdc.dcv_host_security_group_id is linked to the Virtual Desktop Interface (VDI) module
directoryservice.root_username_secret_arn is linked to the DirectoryService module
You can retrieve the current configuration of your IDEA cluster by running ./idea-admin.sh config show utility.
This utility also supports regular expressions as part of the --query/-q argument.
For example, run the command below to list all configuration related to the integration of AWS Backup:
You can display the output in multiple formats (yaml/table/raw)
To continue our example, let's pretend we want to disable the AWS Backup integration.
First, query your IDEA configuration to verify if the integration is active by checking the "cluster.backups.enabled" parameter.
Alternatively, you can validate this setting via the web interface under "Cluster Settings":
To update this configuration parameter, run the ./idea-admin.sh config set command and pass the Key argument via Key=<param_name>,Type=<param_type>,Value=<param_value>
Entry must be of below format: Key=KEY_NAME,Type=[str|int|float|bool|list|list|list|list],Value=[VALUE|[VALUE1,VALUE2,...]]
Config key names cannot contain: comma(,), colon(:)
Examples:
To set a string config type: ./idea-admin.sh config set Key=global-settings.string_val,Type=string,Value=stringcontent --cluster-name <CLUSTER_NAME> --aws-region <REGION>
To set an integer config type: ./idea-admin.sh config set Key=global-settings.int_val,Type=int,Value=12 --cluster-name <CLUSTER_NAME> --aws-region <REGION>
To set a config with list of strings: ./idea-admin.sh config set "Key=my_config.string_list,Type=list<str>,Value=value1,value2" --cluster-name <CLUSTER_NAME> --aws-region <REGION>
To set a config with list of integers: ./idea-admin.sh config set "Key=my_config.string_list,Type=list<int>,Value=value1,value2" --cluster-name <CLUSTER_NAME> --aws-region <REGION>
To set a config with list of decimal/float: ./idea-admin.sh config set "Key=my_config.string_list,Type=list<float>,Value=value1,value2" --cluster-name <CLUSTER_NAME> --aws-region <REGION>
To set a config with list of bool: ./idea-admin.sh config set "Key=my_config.string_list,Type=list<bool>,Value=value1,value2" --cluster-name <CLUSTER_NAME> --aws-region <REGION>
Update multiple config entries: ./idea-admin.sh config set Key=global-settings.string_val,Type=string,Value=stringcontent "Key=global-settings.integer_list,Type=list,Value=1,2" "Key=global-settings.string_list,Type=list,Value=str1,str2" --cluster-name <CLUSTER_NAME> --aws-region <REGION>
You can now re-run the ./idea-admin.sh config show command to validate the configuration in the IDEA database has been updated correctly:
Alternatively, you can validate this setting via the web interface under "Cluster Settings" and config the integration with AWS Backup is now disabled.
