Skip to content

Commit 4988700

Browse files
authored
Add limitation related to setting data dir when joining nodes (#3031)
1 parent fa3e0c8 commit 4988700

File tree

3 files changed

+4
-3
lines changed

3 files changed

+4
-3
lines changed

docs/enterprise/embedded-manage-nodes.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,8 @@ Multi-node clusters with Embedded Cluster have the following limitations:
1010

1111
* High availability for Embedded Cluster in an Alpha feature. This feature is subject to change, including breaking changes. To get access to this feature, reach out to Alex Parker at [[email protected]](mailto:[email protected]).
1212

13+
* The same Embedded Cluster data directory used at installation is used for all nodes joined to the cluster. This is either the default `/var/lib/embedded-cluster` directory or the directory set with the [`--data-dir`](/reference/embedded-cluster-install#flags) flag. You cannot choose a different data directory for Embedded Cluster when joining nodes.
14+
1315
## Add Nodes to a Cluster (Beta) {#add-nodes}
1416

1517
You can add nodes to create a multi-node cluster in online (internet-connected) and air-gapped (limited or no outbound internet access) environments. The Admin Console provides the join command that you use to join nodes to the cluster.

docs/partials/embedded-cluster/_requirements.mdx

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,7 @@
1010

1111
* The filesystem at `/var/lib/embedded-cluster` has 40Gi or more of total space and must be less than 80% full
1212

13-
:::note
14-
The directory used for data storage can be changed by passing the `--data-dir` flag with the Embedded Cluster install command. For more information, see [Embedded Cluster Install Command Options](/reference/embedded-cluster-install).
15-
:::
13+
The directory used for data storage can be changed by passing the `--data-dir` flag with the Embedded Cluster `install` command. For more information, see [Embedded Cluster Install Command Options](/reference/embedded-cluster-install).
1614

1715
Note that in addition to the primary `/var/lib/embedded-cluster` directory, Embedded Cluster creates directories and files in the following locations:
1816

docs/reference/embedded-cluster-install.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,7 @@ sudo ./APP_SLUG install --license LICENSE_FILE [flags]
6060
<p>**Limitations:**</p>
6161
<ul>
6262
<li>The data directory for Embedded Cluster cannot be changed after the cluster is installed.</li>
63+
<li>For multi-node installations, the same data directory that is supplied at installation is used for all nodes joined to the cluster. You cannot choose a different data directory when joining nodes with the Embedded Cluster `join` command. For more information about joining nodes, see [Add Nodes to a Cluster](/enterprise/embedded-manage-nodes#add-nodes) in _Managing Multi-Node Clusters with Embedded Cluster_.</li>
6364
<li>If you use the `--data-dir` flag to change the data directory during installation, then you must use the same location when restoring in a disaster recovery scenario. For more information about disaster recovery with Embedded Cluster, see [Disaster Recovery for Embedded Cluster](/vendor/embedded-disaster-recovery).</li>
6465
<li>Replicated does not support using symlinks for the Embedded Cluster data directory. Use the `--data-dir` flag instead of symlinking `/var/lib/embedded-cluster`.</li>
6566
</ul>

0 commit comments

Comments
 (0)