Skip to main content

Continuous Availability

Default setting for continuous availability​

SMB share can be created as continuously available (CA) when ’ca’ option is specified in per-share section of configuration file or --ca option is specified while creating a share with tsmb-cfg utility. In some cases it is impossible to specify that the share must be CA. For example, when you create a share with Microsoft Management Console (MMC) there is no way to specify that the share should be CA.

In cases like this global ’ca’ option should be set to true to enable CA on all the shares created without explicitly disabled CA functionality. Please note that if a share is created with per-share ’ca’ option set to false, then the share is not CA even though the global ’ca’ option is set to true, because per-share option takes priority.

Default: false

ca = false

Default auxiliary path for continuously available shares​

When a share being created is continuously available (CA), but there is no ’ca_params’ per-share option specified, we may still need to have the ability to create it.

Any CA share requires ’path’ parameter to be specified in ’ca_params’ per-share option, to define auxiliary CA path value to be used for the share. The path is used to point the location for saving dynamic state of SMB server (to support continuously available feature on the share). With ’ca_path’ global option we specify common prefix for that path. The actual path for a specific share will be built as the value of ’ca_path’ with the share name appended.

For example, look at the following configuration:

[global]
...
ca = true
ca_path = /mnt/ca_storage
...
[/global]
[share]
netname = sh1
path = /mnt/disk/shares/sh1
...
[/share]
[share]
netname = sh2
path = /mnt/disk/shares/sh2
ca = false
...
[/share]

For share sh1 auxiliary path is:

/mnt/ca_storage/sh1

For share sh2 continuously available feature is turned off, because it is explicitly configured:

ca = false

If we did not have this option set, then auxiliary path would be:

/mnt/ca_storage/sh2

The path is automatically created in run time, so no need to create it in advance.

ca_path = path=</path/to/directory>