Skip to content

Commit

Permalink
warn that ec2 join requires empty data dir (gravitational#14379)
Browse files Browse the repository at this point in the history
* warn that ec2 join requires empty data dir
  • Loading branch information
stevenGravy authored Jul 18, 2022
1 parent e8b0a05 commit 9a49e2d
Showing 1 changed file with 17 additions and 2 deletions.
19 changes: 17 additions & 2 deletions docs/pages/setup/guides/joining-nodes-aws-ec2.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,8 @@ more in the following guide:
See [Installation](../../installation.mdx) for details.

- An AWS EC2 instance to act as a Teleport Node, with the Teleport binary
installed.
installed. The Node should not have an existing data dir (`/var/lib/teleport` by default).
Remove the data directory if this instance has previously joined a Teleport cluster.

</TabItem>
<TabItem
Expand All @@ -82,7 +83,10 @@ more in the following guide:
```

- An AWS EC2 instance to act as a Teleport Node, with the Teleport binary
installed.
installed. The Node should not have an existing data dir
(`/var/lib/teleport` by default). Remove the data directory if this
instance has previously joined a Teleport cluster.

</TabItem>
</Tabs>

Expand Down Expand Up @@ -207,6 +211,17 @@ proxy_service:

## Step 4/4. Launch your Teleport Node

<Admonition
type="note"
title="IMPORTANT"
>
The data directory (`/var/lib/teleport` by default) must be empty prior to
launching the Node. If this Node had previously joined by another method (e.g.
token or IAM) the host UUID will not match the expected name (`<AWS Account
number>-<instance id>`) and will not be allowed to join.
</Admonition>


Start Teleport on the Node and confirm that it is able to connect to and join
your cluster. You're all set!

Expand Down

0 comments on commit 9a49e2d

Please sign in to comment.