Skip to content

[skip-ci] docs: clarify zone-scoped admin-shell command examples #8248

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.

Sign up for GitHub

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

Merged
lens161 merged 1 commit into from
Oct 8, 2026
Merged

[skip-ci] docs: clarify zone-scoped admin-shell command examples #8248

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 7 additions & 5 deletions docs/TheBook/src/main/markdown/config-admin.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -365,16 +365,17 @@ The general syntax is:
\s [OPTIONS] <cellPattern>#<zone>[/<poolgroup>] command...
```

For example, to send `rep ls` to all pools in zone `zone`:
For example, to send `rep ls` to all pools in zone `A` (see
[Zone-Aware Pool Selection](config-PoolManager.md#zone-aware-pool-selection)):

```
(local) admin > \s pool*#zone rep ls
(local) admin > \s pool*#A rep ls
```

To further restrict to a pool group within the zone:

```
(local) admin > \s pool*#zone/poolGroup rep ls
(local) admin > \s pool*#A/poolGroup rep ls
```

The zone filter is resolved through ZooKeeper: each domain registers itself under
Expand All @@ -385,10 +386,11 @@ cells whose domain is listed there.
You can combine the zone filter with glob patterns as usual:

```
(local) admin > \s *#zone st set max-active 10
(local) admin > \s pool*#A mover set max active 10
```

This sends the command to every well-known cell in the selected zone.
This sends the command to every cell whose name matches the pattern and whose
domain is registered under the selected zone.

## Creating a new user

Expand Down
Loading