{
    "product": "Cenvero Stratum",
    "generated_at": "2026-11-16T13:19:22+00:00",
    "format": "cenvero-docs-v1",
    "document_count": 1,
    "documents": [
        {
            "slug": "clustering/shared-pools",
            "title": "Shared Storage Pools",
            "category": "Clustering",
            "url": "https://stratum.cenvero.com/docs/clustering/shared-pools",
            "headings": [
                {
                    "level": 1,
                    "text": "Shared Storage Pools"
                },
                {
                    "level": 2,
                    "text": "What a shared pool is"
                },
                {
                    "level": 2,
                    "text": "Which filesystems qualify"
                },
                {
                    "level": 2,
                    "text": "Declaring a pool shared"
                },
                {
                    "level": 2,
                    "text": "When a declaration is refused"
                },
                {
                    "level": 2,
                    "text": "Stopping sharing"
                },
                {
                    "level": 2,
                    "text": "What sharing does, and what it does not do yet"
                },
                {
                    "level": 2,
                    "text": "Limits"
                },
                {
                    "level": 2,
                    "text": "See also"
                }
            ],
            "word_count": 1323,
            "markdown": "# Shared Storage Pools\n\nA **directory pool** can be declared **shared** between the members of a cluster when\nevery member mounts the same storage under the pool's directory. The declaration is\nwhat a later release relies on to move a machine while it runs\n([Moving Machines Between Nodes](/docs/clustering/live-migration)). Declaring a pool\nshared does not change any disk, and it does not move any machine.\n\n> Part of [Clustering](/docs/clustering/overview) and [Storage Pools](/docs/compute/storage-pools),\n> in early access. Declaring a pool shared needs a licence that includes Storage, and\n> every member of the cluster to run a version that supports it.\n\n## What a shared pool is\n\n- Only a **directory pool** can be shared. A thin-provisioned pool or a ZFS pool cannot,\n  and the node answers **\"Only a directory pool can be shared between members.\"**\n- The pool's directory must sit on a filesystem that the virtual machine software treats\n  as shared. The list is below.\n- The declaration is **per member**. Each member declares its own mount of the pool, and\n  takes its own declaration back. A pool that one member declares shared is not shared\n  with the others until they declare it too.\n\n## Which filesystems qualify\n\nThe node reads the filesystem of the pool's directory each time you declare the pool. These\ntypes qualify:\n\n- NFS\n- GFS2\n- OCFS2\n- AFS\n- SMB and CIFS\n- CephFS\n- GPFS\n- ACFS\n- BeeGFS\n- GlusterFS, mounted with the type `fuse.glusterfs`\n- Quobyte, mounted with the type `fuse.quobyte`\n\nA FUSE mount counts by its mount type, so a FUSE mount of any other type does not qualify.\nIf the pool's directory is a symbolic link, the node judges the directory the link leads to.\nLustre is not on the list, so a directory on Lustre is refused.\n\n## Declaring a pool shared\n\nBefore you declare a pool, mount the same storage under its directory on every member that\nwill share it. The node checks the type of the filesystem under the directory. It cannot\ncheck that the other members mount the same storage, so make sure they do.\n\n**In the console**, open the node's **Storage** page, choose the **Pools** tab, and open the\npool. In the **Shared between members** card, press **Share with the other members**, then\nconfirm with **Share the pool**. The card then says **Shared with the other members**. To stop\nsharing, press **Stop sharing** and confirm with **Stop sharing**. Only an account with the\n**Storage.Allocate** privilege on the pool can change it. The card offers the declaration only on\na pool whose directory is on one of the filesystems listed below. On any other pool it says why,\nand offers no declaration: the card shows the sentence for the reason in the table below, so a\ndirectory the node could not check is not reported as one on an ordinary filesystem. The\nfilesystem makes no difference to stopping sharing.\n\n**On the command line**, there is no command to declare a pool shared yet. The `storage pool`\ncommands list, show, create and delete pools. Declare the pool in the console or over the API.\n\n**Over the API**, send `PUT /api/v1/storage/pools/{id}/shared` with one field. Use\n`{\"shared\": true}` to declare the pool, or `{\"shared\": false}` to stop sharing it:\n\n```json\n{\"shared\": true}\n```\n\nThe answer is **200** with the pool as it now stands, its `shared` field set. The call needs\nthe **Storage.Allocate** privilege on the pool, and a licence that includes Storage.\n\n## When a declaration is refused\n\nA refused declaration changes nothing. A pool that is already shared stays shared until you\nstop sharing it. The node answers with these sentences:\n\n| The node says | What it means, and what to do |\n|---|---|\n| \"Only a directory pool can be shared between members.\" | The pool is thin-provisioned or ZFS, and such a pool is never shared. Use a directory pool if you want it shared. |\n| \"This pool's directory is not on a filesystem that can be shared between members. Mount a shared network or cluster filesystem there first.\" | The directory is on an ordinary local filesystem. Mount one of the filesystems above on it, then declare the pool again. |\n| \"The pool's filesystem could not be checked right now. Try again when the node answers.\" | The node could not read the filesystem under the directory. Try again. The cause goes to the node's log. |\n| \"Every member must run a version that supports this.\" | Not every member runs a version that supports sharing. Update the other members first (see [Upgrades](/docs/upgrades)). The console and the API say this until they do. |\n| \"This needs a cluster of servers: create one or join one first.\" | The node is in no cluster. Create one, or join one, first. |\n| \"The pool's sharing must be an object that says whether the pool is shared.\" | An API call sent a body other than `{\"shared\": true}` or `{\"shared\": false}`. Send one of those two bodies. |\n\nA licence that does not include Storage refuses the declaration, and an account without the\nStorage.Allocate privilege on the pool is refused for the privilege.\n\n## Stopping sharing\n\nStopping sharing takes the declaration back. Over the API it works whether or not every member\nof the cluster runs a version that supports sharing, and outside a cluster too, because taking a\ndeclaration back only removes a capability: the node does not ask about the other members, and a\nlicence freeze does not stop it. The call needs the **Storage.Allocate** privilege on the pool, and\na licence that includes Storage, as declaring does. The console offers **Stop sharing** whenever the pool is shared, at any level, outside a cluster\nand under a frozen licence. It keeps the button off, with the reason, for an account without\n**Storage.Allocate** on the pool or a licence without Storage.\n\nA take-back is refused only while a machine is moving live on this member, as its source or\nits destination. It is also refused when the node cannot tell whether one is, so a take-back is\nnever let through on a guess. A refused take-back changes nothing, and the pool stays shared.\nThe node answers with these sentences:\n\n| The node says | What it means, and what to do |\n|---|---|\n| \"A machine is moving while it runs on this pool, so the pool must stay shared until that move ends.\" | A machine is moving live on this member. Wait until the move ends, then stop sharing. |\n| \"Whether a machine is moving on this pool could not be checked right now. Try again when the node answers.\" | The node could not read its own move records. Try again. The cause goes to the node's log. |\n\n## What sharing does, and what it does not do yet\n\n- Declaring a pool shared changes nothing on its disks, and it moves no machine.\n- Moving a running machine is not available yet. The node answers **\"Moving a running machine is\n  not available yet. Choose an offline move.\"** Until that move is offered, every move stops the\n  machine, copies its disks, and starts it on the new member, whether or not its pool is shared.\n  See [Moving Machines Between Nodes](/docs/clustering/live-migration).\n\n## Limits\n\n- **The node checks the filesystem type, not what the other members mount.** Declare a pool\n  only where every member mounts the same storage under its directory.\n- **A declaration can outlive its mount.** If the directory later stops being on a shared\n  filesystem, a new declaration is refused, but the declaration already held stays until you\n  stop sharing it.\n\n## See also\n\n- [Storage Pools](/docs/compute/storage-pools): the kinds of pool, and how a directory pool is made.\n- [Clustering Overview](/docs/clustering/overview): what a cluster shares, and what each member keeps.\n- [Moving Machines Between Nodes](/docs/clustering/live-migration): how a machine moves between members today.\n- [Access Control](/docs/access-control): the privileges, such as Storage.Allocate.\n"
        }
    ]
}