fs.ext2¶
Simplest configuration:
[fs#0]
type = ext2
;for provisioning
svcmgr -s <svcname> set --kw fs#0.type=ext2
create_options¶
| scopable | True |
| required | False |
| provisioning | True |
| default | [] |
| inheritance | leaf > head |
| scope order | specific > generic |
| convert | shlex |
Additional options to pass to the logical volume create command. Size and name are alread set.
size¶
| scopable | True |
| required | False |
| provisioning | True |
| default | None |
| inheritance | leaf > head |
| scope order | specific > generic |
| convert | size |
The size of the logical volume to provision for this filesystem. A size expression or <n>%{FREE|PVS|VG}.
vg¶
| scopable | True |
| required | False |
| provisioning | True |
| default | None |
| inheritance | leaf > head |
| scope order | specific > generic |
The name of the disk group the filesystem device should be provisioned from.
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 provision action. Errors interrupt the action.
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 start action. Errors interrupt the action.
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 stop action. Errors interrupt the action.
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 unprovision action. Errors interrupt the action.
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 provision action. Errors interrupt the action.
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 start action. Errors interrupt the action.
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 stop action. Errors interrupt the action.
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 unprovision action. Errors interrupt the action.
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.
dev¶
| scopable | True |
| required | True |
| provisioning | False |
| default | None |
| inheritance | leaf > head |
| scope order | specific > generic |
The block device file or filesystem image file hosting the filesystem to mount. Different device can be set up on different nodes using the dev@nodename syntax
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 start and stop actions. These actions immediately return success.
sudo svcmgr -s <path> disable only sets DEFAULT.disable. As resources disabled state is not changed, sudo svcmgr -s <path> enable does not enable disabled resources.
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.
mnt¶
| scopable | True |
| required | True |
| provisioning | False |
| default | None |
| inheritance | leaf > head |
| scope order | specific > generic |
The mount point where to mount the filesystem.
mnt_opt¶
| scopable | True |
| required | False |
| provisioning | False |
| default | None |
| inheritance | leaf > head |
| scope order | specific > generic |
The mount options.
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.
no_preempt_abort¶
| scopable | True |
| required | False |
| provisioning | False |
| default | False |
| inheritance | leaf > head |
| scope order | specific > generic |
| candidates | True | False |
| convert | boolean |
If set to true, OpenSVC will preempt scsi reservation with a preempt command instead of a preempt and and abort. Some scsi target implementations do not support this last mode (esx). If set to false or not set, no_preempt_abort can be activated on a per-resource basis.
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 noaction and sync resources are automatically considered optional. Useful for resources like dump filesystems for example.
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.
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.
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
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.
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.
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.
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
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 pg_mem_limit.
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 provision action. Errors do not interrupt the action.
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 start action. Errors do not interrupt the action.
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 stop action. Errors do not interrupt the action.
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 unprovision action. Errors do not interrupt the action.
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 provision action. Errors do not interrupt the action.
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 start action. Errors do not interrupt the action.
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 stop action. Errors do not interrupt the action.
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 unprovision action. Errors do not interrupt the action.
prkey¶
| scopable | True |
| required | False |
| provisioning | False |
| default | None |
| inheritance | leaf > head |
| scope order | specific > generic |
Defines a specific persistent reservation key for the resource. Takes priority over the service-level defined prkey and the node.conf specified prkey.
promote_rw¶
| scopable | False |
| required | False |
| provisioning | False |
| default | False |
| inheritance | leaf > head |
| scope order | specific > generic |
| candidates | True | False |
| convert | boolean |
If set to true, OpenSVC will try to promote the base devices to read-write on start.
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.
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 <rid>(<state>,...). If states are omitted, up,stdby up is used as the default expected states.
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 <n> 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 DEFAULT.monitor_schedule instead of the frequency defined by DEFAULT.status_schedule.
scsireserv¶
| scopable | False |
| required | False |
| provisioning | False |
| default | False |
| inheritance | leaf > head |
| scope order | specific > generic |
| candidates | True | False |
| convert | boolean |
If set to true, OpenSVC will try to acquire a type-5 (write exclusive, registrant only) scsi3 persistent reservation on every path to every disks held by this resource. Existing reservations are preempted to not block service start-up. If the start-up was not legitimate the data are still protected from being written over from both nodes. If set to false or not set, scsireserv can be activated on a per-resource basis.
snap_size¶
| scopable | True |
| required | False |
| provisioning | False |
| default | None |
| inheritance | leaf > head |
| scope order | specific > generic |
If this filesystem is build on a snapable logical volume or is natively snapable (jfs, vxfs, ...) this setting overrides the default 10% of the filesystem size to compute the snapshot size. The snapshot is created by snap-enabled rsync-type sync resources. The unit is Megabytes.
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.
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 <rid>(<state>,...). If states are omitted, up,stdby up is used as the default expected states.
stat_timeout¶
| scopable | True |
| required | False |
| provisioning | False |
| default | 5 |
| inheritance | leaf > head |
| scope order | specific > generic |
| convert | duration |
The maximum wait time for a stat call to respond. When expired, the resource status is degraded is to warn, which might cause a TOC if the resource is monitored.
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 <rid>(<state>,...). If states are omitted, up,stdby up is used as the default expected states.
subset¶
| scopable | True |
| required | False |
| provisioning | False |
| default | None |
| inheritance | leaf |
| scope order | specific > generic |
Assign the resource to a specific subset.
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 noaction avoids any state changing action from the driver and implies optional=true, nostatus forces the status to n/a.
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.
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 <rid>(<state>,...). If states are omitted, up,stdby up is used as the default expected states.
zone¶
| scopable | True |
| required | False |
| provisioning | False |
| default | None |
| inheritance | leaf > head |
| scope order | specific > generic |
The zone name the fs refers to. If set, the fs mount point is reparented into the zonepath rootfs.