Dynamic Runtime Config

Note

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

asadm

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>'

asinfo

To view the configuration values from a running system:

asinfo -v 'get-config:' -l

To view the configuration value for a specific context:

asinfo -v 'get-config:context=<context name>' -l

To view namespace-specific configuration:

asinfo -v 'get-config:context=namespace;id=<namespace name>' -l

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

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>'

asinfo

asinfo -v 'set-config:context=<context name>;id=<optional id>;<parameter name>=<parameter value>' -l

asinfo -v 'set-config:context=<context name>;<subcontext name>.<parameter name>=<parameter value>' -l

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.

asadm

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'

asinfo

To set a parameter in the set subcontext

asinfo -v 'set-config:context=namespace;id=<namespace name>;set=someSetName;<parameter name>=<parameter value>' -l

Other examples for service, namespace, and network contexts:

asinfo -v 'set-config:context=service;proto-fd-max=100000' -l

asinfo -v 'set-config:context=namespace;id=test;defrag-sleep=500' -l

asinfo -v 'set-config:context=network;heartbeat.protocol=v3' -l

XDR syntax

View highest-level XDR-specific configuration values

asadm

asadm -e 'show config xdr'

asinfo

asinfo -v 'get-config:context=xdr' -l

Create a new datacenter

asadm

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

asinfo

asinfo -v 'set-config:context=xdr;dc=<dc name>;action=create' -l

Delete a datacenter

asadm

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

asinfo

asinfo -v 'set-config:context=xdr;dc=<dc name>;action=delete' -l

Add a new XDR namespace

asadm

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

asinfo

asinfo -v 'set-config:context=xdr;dc=<dc name>;namespace=<namespace name>;action=add' -l

Remove an XDR namespace

asadm

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

asinfo

asinfo -v 'set-config:context=xdr;dc=<dc name>;namespace=<namespace name>;action=remove' -l

Set a specific parameter for an XDR namespace

asadm

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

asinfo

asinfo -v 'set-config:context=xdr;dc=<dc name>;namespace=<namespace name>;<parameter name>=<parameter value>' -l

View the configuration values for a specific XDR datacenter

asadm

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

asinfo

asinfo -v 'get-config:context=xdr;dc=<dc name>' -l

View the configuration values for a specific XDR namespace

asadm

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

asinfo

asinfo -v 'get-config:context=xdr;dc=<dc name>;namespace=<namespace name>' -l