ip.crossbow *********** .. include:: template.service.ip.crossbow.example .. _ip.crossbow.ipdev: :kw:`ipdev` =========== ================= ================================================================ **scopable** True **required** True **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ The interface name over which OpenSVC will try to stack the service ip. Can be different from one node to the other, in which case the ``@nodename`` can be specified. .. _ip.crossbow.ipdevext: :kw:`ipdevext` ============== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** v4 **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ The interface name extension for crossbow ipadm configuration. .. _ip.crossbow.ipname: :kw:`ipname` ============ ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ The DNS name or IP address of the ip resource. Can be different from one node to the other, in which case ``@nodename`` can be specified. This is most useful to specify a different ip when the service starts in DRP mode, where subnets are likely to be different than those of the production datacenter. With the amazon driver, the special ```` value tells the provisioner to assign a new private address. .. _ip.crossbow.netmask: :kw:`netmask` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ If an ip is already plumbed on the root interface (in which case the netmask is deduced from this ip). Mandatory if the interface is dedicated to the service (dummy interface are likely to be in this case). The format is either dotted or octal for IPv4, ex: 255.255.252.0 or 22, and octal for IPv6, ex: 64. .. _ip.crossbow.gateway: :kw:`gateway` ============= ================= ================================================================ **scopable** True **required** False **provisioning** True **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A zone ip provisioning parameter used in the sysidcfg formatting. The format is decimal for IPv4, ex: 255.255.252.0, and octal for IPv6, ex: 64. .. _ip.crossbow.alias: :kw:`alias` =========== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** True **inheritance** leaf > head **scope order** specific > generic **convert** boolean ================= ================================================================ Use ip aliasing. Modern ip stack support multiple ip/mask per interface, so :kw:`alias` should be set to false when possible. .. _ip.crossbow.blocking_post_provision: :kw:`blocking_post_provision` ============================= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`provision` action. Errors interrupt the action. .. _ip.crossbow.blocking_post_start: :kw:`blocking_post_start` ========================= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`start` action. Errors interrupt the action. .. _ip.crossbow.blocking_post_stop: :kw:`blocking_post_stop` ======================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`stop` action. Errors interrupt the action. .. _ip.crossbow.blocking_post_unprovision: :kw:`blocking_post_unprovision` =============================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`unprovision` action. Errors interrupt the action. .. _ip.crossbow.blocking_pre_provision: :kw:`blocking_pre_provision` ============================ ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`provision` action. Errors interrupt the action. .. _ip.crossbow.blocking_pre_start: :kw:`blocking_pre_start` ======================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`start` action. Errors interrupt the action. .. _ip.crossbow.blocking_pre_stop: :kw:`blocking_pre_stop` ======================= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`stop` action. Errors interrupt the action. .. _ip.crossbow.blocking_pre_unprovision: :kw:`blocking_pre_unprovision` ============================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`unprovision` action. Errors interrupt the action. .. _ip.crossbow.check_carrier: :kw:`check_carrier` =================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** True **inheritance** leaf > head **scope order** specific > generic **convert** boolean ================= ================================================================ Activate the link carrier check. Set to false if ipdev is a backend bridge or switch .. _ip.crossbow.comment: :kw:`comment` ============= ================= ================================================================ **scopable** False **required** False **provisioning** False **default** **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ Helps users understand the role of the service and resources, which is nice to on-call support people having to operate on a service they are not usually responsible for. .. _ip.crossbow.disable: :kw:`disable` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** False **inheritance** leaf **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ A disabled resource will be ignored on service startup and shutdown. Its status is always reported ``n/a``. Set in DEFAULT, the whole service is disabled. A disabled service does not honor :c-action:`start` and :c-action:`stop` actions. These actions immediately return success. :cmd:`sudo svcmgr -s disable` only sets :kw:`DEFAULT.disable`. As resources disabled state is not changed, :cmd:`sudo svcmgr -s enable` does not enable disabled resources. .. _ip.crossbow.dns_name_suffix: :kw:`dns_name_suffix` ===================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ Add the value as a suffix to the DNS record name. The record created is thus formatted as ``-..``. .. _ip.crossbow.dns_update: :kw:`dns_update` ================ ================= ================================================================ **scopable** True **required** False **provisioning** False **default** False **inheritance** leaf > head **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ Setting this parameter triggers a DNS update. The record created is formatted as ``..``, unless dns_record_name is specified. .. _ip.crossbow.encap: :kw:`encap` =========== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** False **inheritance** leaf > head **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ Set to ``true`` to ignore this resource in the nodes context and consider it in the encapnodes context. The resource is thus handled by the agents deployed in the service containers. .. _ip.crossbow.expose: :kw:`expose` ============ ================= ================================================================ **scopable** True **required** False **provisioning** False **default** [] **inheritance** leaf > head **scope order** specific > generic **convert** list ================= ================================================================ A whitespace-separated list of ``/[:]`` describing socket services that mandate a SRV exposition. With set, the ip.cni driver configures port mappings too. .. _ip.crossbow.monitor: :kw:`monitor` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** False **inheritance** leaf > head **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ A down monitored resource will trigger a node suicide if the monitor thinks it should be up and the resource can not be restarted. .. _ip.crossbow.network: :kw:`network` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ The network, in dotted notation, from where the ip provisioner allocates. Also used by the docker ip driver to delete the network route if :kw:`del_net_route` is set to ``true``. .. _ip.crossbow.optional: :kw:`optional` ============== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** true for tasks, syncs and resources tagged 'noaction', else false **inheritance** leaf > head **scope order** specific > generic **convert** tristate ================= ================================================================ Action failures on optional resources are logged but do not stop the action sequence. Also the optional resource status is not aggregated to the instance 'availstatus', but aggregated to the 'overallstatus'. Resource tagged :c-tag:`noaction` and sync resources are automatically considered optional. Useful for resources like dump filesystems for example. .. _ip.crossbow.pg_blkio_weight: :kw:`pg_blkio_weight` ===================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] **convert** integer ================= ================================================================ Block IO relative weight. Value: between 10 and 1000. Kernel default: 1000. .. _ip.crossbow.pg_cpu_quota: :kw:`pg_cpu_quota` ================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] ================= ================================================================ The percent ratio of one core to allocate to the process group if % is specified, else the absolute value to set in the process group parameter. For example, on Linux cgroups, ``-1`` means unlimited, and a positive absolute value means the number of microseconds to allocate each period. ``50%@all`` means 50% of all cores, and ``50%@2`` means 50% of two cores. .. _ip.crossbow.pg_cpu_shares: :kw:`pg_cpu_shares` =================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] **convert** integer ================= ================================================================ Kernel default value is used, which usually is 1024 shares. In a cpu-bound situation, ensure the service does not use more than its share of cpu ressource. The actual percentile depends on shares allowed to other services. .. _ip.crossbow.pg_cpus: :kw:`pg_cpus` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] ================= ================================================================ Allow service process to bind only the specified cpus. Cpus are specified as list or range : 0,1,2 or 0-2 .. _ip.crossbow.pg_mem_limit: :kw:`pg_mem_limit` ================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] **convert** size ================= ================================================================ Ensures the service does not use more than specified memory (in bytes). The Out-Of-Memory killer get triggered in case of tresspassing. .. _ip.crossbow.pg_mem_oom_control: :kw:`pg_mem_oom_control` ======================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] **convert** integer ================= ================================================================ A flag (0 or 1) that enables or disables the Out of Memory killer for a cgroup. If enabled (0), tasks that attempt to consume more memory than they are allowed are immediately killed by the OOM killer. The OOM killer is enabled by default in every cgroup using the memory subsystem; to disable it, write 1. .. _ip.crossbow.pg_mem_swappiness: :kw:`pg_mem_swappiness` ======================= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] **convert** integer ================= ================================================================ Set a swappiness value for the process group. .. _ip.crossbow.pg_mems: :kw:`pg_mems` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] ================= ================================================================ Allow service process to bind only the specified memory nodes. Memory nodes are specified as list or range : 0,1,2 or 0-2 .. _ip.crossbow.pg_vmem_limit: :kw:`pg_vmem_limit` =================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] **convert** size ================= ================================================================ Ensures the service does not use more than specified memory+swap (in bytes). The Out-Of-Memory killer get triggered in case of tresspassing. The specified value must be greater than :kw:`pg_mem_limit`. .. _ip.crossbow.post_provision: :kw:`post_provision` ==================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`provision` action. Errors do not interrupt the action. .. _ip.crossbow.post_start: :kw:`post_start` ================ ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`start` action. Errors do not interrupt the action. .. _ip.crossbow.post_stop: :kw:`post_stop` =============== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`stop` action. Errors do not interrupt the action. .. _ip.crossbow.post_unprovision: :kw:`post_unprovision` ====================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute after the resource :c-action:`unprovision` action. Errors do not interrupt the action. .. _ip.crossbow.pre_provision: :kw:`pre_provision` =================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`provision` action. Errors do not interrupt the action. .. _ip.crossbow.pre_start: :kw:`pre_start` =============== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`start` action. Errors do not interrupt the action. .. _ip.crossbow.pre_stop: :kw:`pre_stop` ============== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`stop` action. Errors do not interrupt the action. .. _ip.crossbow.pre_unprovision: :kw:`pre_unprovision` ===================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A command or script to execute before the resource :c-action:`unprovision` action. Errors do not interrupt the action. .. _ip.crossbow.provision: :kw:`provision` =============== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** True **inheritance** leaf > head **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ Set to false to skip the resource on provision and unprovision actions. Warning: provisioning implies destructive operations like formating. Unprovisioning does not keep a copy of the service data. .. _ip.crossbow.provision_requires: :kw:`provision_requires` ======================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A whitespace-separated list of conditions to meet to accept running a 'provision' action. A condition is expressed as ``(,...)``. If states are omitted, ``up,stdby up`` is used as the default expected states. .. _ip.crossbow.restart: :kw:`restart` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** 0 **inheritance** leaf > head **scope order** specific > generic **convert** integer ================= ================================================================ The agent will try to restart a resource times before falling back to the monitor action. A resource restart is triggered if the resource is not disabled and its status is not up, and the node is not frozen, and the service instance is not frozen and its local expect is set to ``started``. If a resource has a restart set to a value >0, its status is evaluated at the frequency defined by :kw:`DEFAULT.monitor_schedule` instead of the frequency defined by :kw:`DEFAULT.status_schedule`. .. _ip.crossbow.shared: :kw:`shared` ============ ================= ================================================================ **scopable** True **required** False **provisioning** False **default** False **inheritance** leaf > head **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ Set to ``true`` to skip the resource on provision and unprovision actions if the action has already been done by a peer. Shared resources, like vg built on SAN disks must be provisioned once. All resources depending on a shared resource must also be flagged as shared. .. _ip.crossbow.standby: :kw:`standby` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** False **inheritance** leaf > head **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ Always start the resource, even on standby instances. The daemon is responsible for starting standby resources. A resource can be set standby on a subset of nodes using keyword scoping. A typical use-case is sync'ed fs on non-shared disks: the remote fs must be mounted to not overflow the underlying fs. .. warning:: Don't set shared resources standby: fs on shared disks for example. .. _ip.crossbow.start_requires: :kw:`start_requires` ==================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A whitespace-separated list of conditions to meet to accept running a 'start' action. A condition is expressed as ``(,...)``. If states are omitted, ``up,stdby up`` is used as the default expected states. .. _ip.crossbow.stop_requires: :kw:`stop_requires` =================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A whitespace-separated list of conditions to meet to accept running a 'stop' action. A condition is expressed as ``(,...)``. If states are omitted, ``up,stdby up`` is used as the default expected states. .. _ip.crossbow.subset: :kw:`subset` ============ ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic ================= ================================================================ Assign the resource to a specific subset. .. _ip.crossbow.tags: :kw:`tags` ========== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** **inheritance** leaf > head **scope order** specific > generic **convert** set ================= ================================================================ A list of tags. Arbitrary tags can be used to limit action scope to resources with a specific tag. Some tags can influence the driver behaviour. For example :c-tag:`noaction` avoids any state changing action from the driver and implies ``optional=true``, :c-tag:`nostatus` forces the status to n/a. .. _ip.crossbow.unprovision: :kw:`unprovision` ================= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** True **inheritance** leaf > head **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ Set to false to skip the resource on unprovision actions. Warning: Unprovisioning does not keep a copy of the service data. .. _ip.crossbow.unprovision_requires: :kw:`unprovision_requires` ========================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ A whitespace-separated list of conditions to meet to accept running a 'unprovision' action. A condition is expressed as ``(,...)``. If states are omitted, ``up,stdby up`` is used as the default expected states. .. _ip.crossbow.wait_dns: :kw:`wait_dns` ============== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** 0 **inheritance** leaf > head **scope order** specific > generic **convert** duration ================= ================================================================ Wait for the cluster DNS records associated to the resource to appear after a resource start and before the next resource can be started. This can be used for apps or containers that require the ip or ip name to be resolvable to provision or execute properly. .. _ip.crossbow.zone: :kw:`zone` ========== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ The zone name the ip resource is linked to. If set, the ip is plumbed from the global in the zone context.