Skip to content

Commit 6a9d32d

Browse files
authored
Update users_in_keeper.md
1 parent 36c33d1 commit 6a9d32d

1 file changed

Lines changed: 3 additions & 32 deletions

File tree

content/en/altinity-kb-setup-and-maintenance/users_in_keeper.md

Lines changed: 3 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -223,17 +223,6 @@ For production, prefer configuring this in a profile (for example `default` in `
223223
</clickhouse>
224224
```
225225

226-
Also decide your strictness for invalid replicated entities:
227-
228-
```xml
229-
<access_control_improvements>
230-
<throw_on_invalid_replicated_access_entities>true</throw_on_invalid_replicated_access_entities>
231-
</access_control_improvements>
232-
```
233-
234-
- `true`: fail fast on invalid entity payload in Keeper.
235-
- `false`: log and skip invalid entity.
236-
237226
## 6. Migrate existing clusters/users
238227

239228
Before switching to Keeper-backed RBAC, treat this as a storage migration.
@@ -300,6 +289,7 @@ Important:
300289
- this applies to SQL/RBAC users (created with `CREATE USER ...`, `CREATE ROLE ...`, etc.);
301290
- if your users are in `users.xml`, those are config-based (`--configs`) and this is not an automatic local->replicated RBAC conversion.
302291
- run restore on one node only; entities will be replicated through Keeper.
292+
- If `clickhouse-backup` is configured with `use_embedded_backup_restore: true`, it delegates to SQL `BACKUP/RESTORE` and follows embedded rules. (see below).
303293

304294
### 6.3 Migration with embedded SQL `BACKUP/RESTORE`
305295

@@ -336,12 +326,6 @@ Defaults in ClickHouse code:
336326
Operational implication:
337327
- If you disable `allow_backup` for replicated storage, embedded `BACKUP TABLE system.users ...` may skip those entities (or fail if no backup-allowed access storage remains).
338328

339-
About `clickhouse-backup --rbac/--rbac-only`:
340-
- It is an external tool, not ClickHouse embedded backup by itself.
341-
- If `clickhouse-backup` is configured with `use_embedded_backup_restore: true`, it delegates to SQL `BACKUP/RESTORE` and follows embedded rules.
342-
- Otherwise it uses its own workflow; do not assume full equivalence with embedded `allow_backup` semantics.
343-
- run restore on one node only; entities will be replicated through Keeper.
344-
345329
## 7. Troubleshooting: common support issues
346330

347331
| Symptom | Typical root cause | What to do |
@@ -379,26 +363,13 @@ SELECT * FROM system.zookeeper_connection;
379363
SELECT * FROM system.zookeeper_connection_log ORDER BY event_time DESC LIMIT 100;
380364
```
381365

382-
### 9.2 Inspect RBAC activity in Keeper
383-
384-
```sql
385-
SELECT event_time, type, op_num, path, error
386-
FROM system.zookeeper_log
387-
WHERE path LIKE '/clickhouse/access/%'
388-
ORDER BY event_time DESC
389-
LIMIT 200;
390-
```
391-
392-
### 9.3 Relevant server log patterns
366+
### 9.2 Relevant server log patterns
393367

394-
Note: `system.zookeeper_log` is often disabled in production.
395-
If it is unavailable, use server logs (usually `clickhouse-server.log`) with these patterns:
368+
You can find feature-related line in the log, by those patterns:
396369

397370
```text
398371
Access(replicated)
399372
ZooKeeperReplicator
400-
Will try to restart watching thread after error
401-
Initialization failed. Error:
402373
Can't have Replicated access without ZooKeeper
403374
ON CLUSTER clause was ignored for query
404375
```

0 commit comments

Comments
 (0)