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