.. _cfgmgr.action.service_actions.start: :cmd:`om cfg start` ------------------- Start a service. The started instances depend on the service placement policy, so the local instance may not start. A failover service is considered started when one instance is started. A flex service is considered started when the number of started instances is between ```` and ````. :opt:`--color=` +++++++++++++++++++++++ Colorize output. Possible values are: * auto: guess based on tty presence * always|yes: always colorize * never|no: never colorize :opt:`--daemon` +++++++++++++++ A flag inhibiting the command daemonization. Set by the daemonization routine. :opt:`--debug` ++++++++++++++ Increase stream and file log verbosity up to the debug level. :opt:`--disable-rollback` +++++++++++++++++++++++++ If set, don't try to rollback resources activated before a start action interrupts on error. :opt:`--dry-run` ++++++++++++++++ Show the action execution plan. :opt:`--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 =`` can be specified. For all other actions. :opt:`--interval=` +++++++++++++++++++++++ with --watch, set the refresh interval. defaults to 0, to refresh on event only. :opt:`--local` ++++++++++++++ Execute the service action on the local service instances only, ignoring cluster-wide considerations. :opt:`--master` +++++++++++++++ Limit the action scope to the master service resources. :opt:`--namespace=` +++++++++++++++++++++++++++ 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. :opt:`--node=` ++++++++++++++++++++++ The node to send a request to. If not specified the local node is targeted. :opt:`--nolock` +++++++++++++++ Don't acquire the action lock. Dangerous, but can be useful to set parameters from an action trigger. :opt:`--rid=` +++++++++++++++++++++ A resource specifier expression like ``[,]``, where ```` 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 :opt:`--slave=` +++++++++++++++++++++++ Limit the action to the service resources in the specified, comma-separated, slaves. :opt:`--slaves` +++++++++++++++ Limit the action scope to service resources in all slaves. :opt:`--stats` ++++++++++++++ Show system resources usage metrics and refresh the information every --interval. :opt:`--status=` ++++++++++++++++++++++++ Operate only on service with a local instance in the specified availability status (up, down, warn, ...). :opt:`--subsets=` +++++++++++++++++++++++++ Limit the action to the resources in the specified, comma-separated, list of subsets. :opt:`--tags=` ++++++++++++++++++++++ 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. :opt:`--time=` ++++++++++++++++++++++ A duration expression like ``1m5s``. The maximum wait time for an async action to finish. Default is 300 seconds. :opt:`--upto=` ++++++++++++++++++++++ Start the service up to the specified rid or driver group. :opt:`--wait` +++++++++++++ Wait for asynchronous action termination. :opt:`--waitlock=` ++++++++++++++++++++++++++ A duration expression like ``5s``. The maximum wait time when acquiring the service action lock. :opt:`-f, --force` ++++++++++++++++++ Force action, ignore sanity checks. :opt:`-h, --help` +++++++++++++++++ Show this help message and exit. :opt:`-p, --parallel` +++++++++++++++++++++ Start actions on specified services in parallel. :kw:`max_parallel` in node.conf limits the number of parallel running subprocesses. :opt:`-s, VAL, --service=` ++++++++++++++++++++++++++++++++++ A service selector expression ``[!][[!]]`` where: - ``!`` is the expression negation operator - ```` can be: - ``,`` OR expressions - ``+`` AND expressions - ```` can be: - a shell glob on service names - ```` where: - ```` can be: - ``:`` - ``:`` - ``.`` - ``.`` - `` dictionary extended under the 'nodes' key by each instance 'status' and 'config' data>`` - ```` can be: - ``<`` ``>`` ``<=`` ``>=`` ``=`` - ``~`` with regexp 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 :opt:`-w, --watch` ++++++++++++++++++ refresh the information every --interval.