Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update docs for https://github.com/vitessio/vitess/pull/17442 #1912

Merged
merged 8 commits into from
Feb 11, 2025
Prev Previous commit
Next Next commit
Remove vtctl binary docs and update vtctl concept page
Signed-off-by: Matt Lord <mattalord@gmail.com>
  • Loading branch information
mattlord committed Jan 16, 2025
commit 7bd24968e329290c9a61b724b05e7c3b03a9d88d
8 changes: 5 additions & 3 deletions content/en/docs/22.0/concepts/vtctl.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,10 @@
title: vtctl
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we just replace this with vtctldclient?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure. We frame the concept of vtctl here as being the pairing of the client and server. I'd follow your lead here.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've updated it here: 4771ab9

I think it's MUCH clearer now. Thanks!

---

**vtctl** is a command-line tool used to administer a Vitess cluster. It is available as both a standalone tool (`vtctl`) and client-server (`vtctldclient` in combination with `vtctld`). Using client-server is recommended, as it provides an additional layer of security when using the client remotely.
**vtctl** is a command-line tool, `vtctldclient`, that is used to administer a Vitess cluster. It is available as both a standalone tool (`vtctldclient --server=internal`) and client-server (`vtctldclient` in combination with `vtctld`). Using client-server is recommended, as it provides an additional layer of security when using the client remotely.

Using vtctl, you can identify primary and replica databases, create tables, initiate failovers, perform resharding operations, and so forth.
Using this you can identify primary and replica databases, create tables, initiate failovers, perform resharding operations, and so forth.

As vtctl performs operations, the Topology Service is updated as needed. Other Vitess servers observe those changes and react accordingly. For example, if you use vtctl to fail over to a new primary database, vtgate sees the change and directs future write operations to the new primary.
As it performs operations, the Topology Service is updated as needed. Other Vitess servers observe those changes and react accordingly. For example, if you use vtctl to fail over to a new primary database, vtgate sees the change and directs future write operations to the new primary.

Please see the [reference documentation](../../reference/programs/vtctldclient/) for additional details.
268 changes: 0 additions & 268 deletions content/en/docs/22.0/reference/programs/vtctl/_index.md

This file was deleted.

80 changes: 0 additions & 80 deletions content/en/docs/22.0/reference/programs/vtctl/cell-aliases.md

This file was deleted.

114 changes: 0 additions & 114 deletions content/en/docs/22.0/reference/programs/vtctl/cells.md

This file was deleted.

91 changes: 0 additions & 91 deletions content/en/docs/22.0/reference/programs/vtctl/generic.md

This file was deleted.

Loading