om cfg change

Add a key/value to the configuration object. The key is created if it doesn’t already exists.

–color=<string>

Colorize output. Possible values are:

  • auto: guess based on tty presence

  • always|yes: always colorize

  • never|no: never colorize

–daemon

A flag inhibiting the command daemonization. Set by the daemonization routine.

–debug

Increase stream and file log verbosity up to the debug level.

–dry-run

Show the action execution plan.

–env

Export the uppercased variable in the os environment.

With the create action only, set a env section parameter in the service configuration file. Multiple --env <key>=<val> can be specified. For all other actions.

–from=<string>

Read the configuration values from a file or a directory. If set to ‘-‘ or ‘/dev/stdin’, the value is read from stdin, and the –key is mandatory. If set to a file path, the key name is the file basename. If set to a directory, one key per file is added, and the keyname is the relative path, the –key value being used as the relative path prefix.

–key=<string>

The configuration key name.

–local

Execute the service action on the local service instances only, ignoring cluster-wide considerations.

–master

Limit the action scope to the master service resources.

–namespace=<string>

The namespace to switch to for the action. Namespaces are cluster partitions. A default namespace can be set for the session setting the OSVC_NAMESPACE environment variable.

–node=<string>

The node to send a request to. If not specified the local node is targeted.

–nolock

Don’t acquire the action lock. Dangerous, but can be useful to set parameters from an action trigger.

–rid=<string>

A resource specifier expression like <spec>[,<spec>], where <spec> can be:

  • A resource id

  • A driver group name (app, fs, disk, …)

Examples:

  • app all app resources

  • container#1,ip#1 only container#1 and ip#1

–slave=<string>

Limit the action to the service resources in the specified, comma-separated, slaves.

–slaves

Limit the action scope to service resources in all slaves.

–status=<string>

Operate only on service with a local instance in the specified availability status (up, down, warn, …).

–subsets=<string>

Limit the action to the resources in the specified, comma-separated, list of subsets.

–tags=<string>

A comma-separated list of resource tags to limit action to. The + separator can be used to impose multiple tag conditions. For example, tag1+tag2,tag3 limits the action to resources with both tag1 and tag2, or tag3.

–value=<string>

The configuration key value.

–waitlock=<string>

A duration expression like 5s. The maximum wait time when acquiring the service action lock.

-f, –force

Force action, ignore sanity checks.

-h, –help

Show this help message and exit.

-p, –parallel

Start actions on specified services in parallel. max_parallel in node.conf limits the number of parallel running subprocesses.

-s, VAL, –service=<string>

A service selector expression [!]<expr>[<sep>[!]<expr>] where:

  • ! is the expression negation operator

  • <sep> can be:

    • , OR expressions

    • + AND expressions

  • <expr> can be:

    • a shell glob on service names

    • <param><op><value> where:

      • <param> can be:

        • <rid>:

        • <group>:

        • <rid>.<key>

        • <group>.<key>

        • <single value jsonpath expression on the $.monitor.services.<path> dictionary extended under the 'nodes' key by each instance 'status' and 'config' data>

      • <op> can be:

        • < > <= >= =

        • ~ the string or any list element matches the regexp value

        • ~= the string matches regexp value or any list element is the value

Examples:

  • *dns,ha*+app.timeout>1

  • ip:+task:

  • !*excluded

  • $.avail=warn

  • $.nodes.*.status.avail=warn

Note:

  • ! usage requires single quoting the expression to prevent shell history expansion