Skip to main content
We are excited to be a part of AWS re:Invent 2024. Visit us at booth #1844 in Las Vegas.More info
Loading

Dynamic Runtime Config

info

For Access-Control-enabled clusters, authentication is required in order to get the server configuration details as well as the sys-admin permission in order to dynamically change configuration parameters.

See asadm or asinfo documentation for more information.

Viewing configuration settings​

To view the configuration values from a running system:

asadm -e 'show config'

To view the configuration value for a specific context:

asadm -e 'show config <context name>'

To view namespace-specific configuration:

asadm -e 'show config namespace for <namespace name>'

Dynamic configuration​

note

Tools package 6.0.x or later is required to use asadm's manage config commands.

asadm or asinfo​

To change the dynamic configuration values on a running system use asadm or asinfo:

asadm -e 'enable; manage config <context name> <optional id> param <parameter name> to <parameter value>'
asadm -e 'enable; manage config <context name> <subcontext name> param <parameter name> to <parameter value>'

where:

  • set-config: Command used to change any dynamically configurable parameter.
  • context: The component being updated. Allowed values:
    • logging
    • namespace
    • security
    • service
    • network
    • xdr
  • <subcontext name>: The sub-component being updated. Allowed values:
    • heartbeat
    • fabric
    • file
    • set
    • For XDR: datacenter and namespace.
    • The <subcontext name> field is not required for subcontext storage-engine.
  • id: This is required only if updating namespace-specific configuration values. Note: this id is not used with XDR namespace syntax. See XDR syntax below.
  • <parameter name>: This is the configuration name that is being updated.

To set a parameter in the set subcontext

asadm -e 'enable; manage config namespace <namespace name> set <set name> param <parameter name> to <parameter value>'

Other examples for service, namespace, and network contexts:

asadm -e 'enable; manage config service param proto-fd-max to 100000'

asadm -e 'enable; manage config namespace test param defrag-sleep to 500'

asadm -e 'enable; manage config network heartbeat param protocol to v3'

XDR syntax​

View highest-level XDR-specific configuration values​

asadm -e 'show config xdr'

Create a new datacenter​

asadm -e 'enable; manage config xdr create dc <dc name>'

Delete a datacenter​

asadm -e 'enable; manage config xdr delete dc <dc name>'

Add a new XDR namespace​

asadm -e 'enable; manage config xdr dc <dc name> add namespace <namespace name>'

Remove an XDR namespace​

asadm -e 'enable; manage config xdr dc <dc name> remove namespace <namespace name>'

Set a specific parameter for an XDR namespace​

asadm -e 'enable; manage config xdr dc <dc name> namespace <namespace name> param <parameter name> to <parameter value>'

View the configuration values for a specific XDR datacenter​

asadm -e 'show config xdr for <dc name>'

View the configuration values for a specific XDR namespace​

asadm -e 'show config xdr for <dc name> for <namespace name>'
Last updated on