You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
-`true`: fail fast on invalid entity payload in Keeper.
235
-
-`false`: log and skip invalid entity.
236
-
237
226
## 6. Migrate existing clusters/users
238
227
239
228
Before switching to Keeper-backed RBAC, treat this as a storage migration.
@@ -300,6 +289,7 @@ Important:
300
289
- this applies to SQL/RBAC users (created with `CREATE USER ...`, `CREATE ROLE ...`, etc.);
301
290
- if your users are in `users.xml`, those are config-based (`--configs`) and this is not an automatic local->replicated RBAC conversion.
302
291
- 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).
303
293
304
294
### 6.3 Migration with embedded SQL `BACKUP/RESTORE`
305
295
@@ -336,12 +326,6 @@ Defaults in ClickHouse code:
336
326
Operational implication:
337
327
- 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).
338
328
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
-
345
329
## 7. Troubleshooting: common support issues
346
330
347
331
| Symptom | Typical root cause | What to do |
@@ -379,26 +363,13 @@ SELECT * FROM system.zookeeper_connection;
379
363
SELECT*FROMsystem.zookeeper_connection_logORDER BY event_time DESCLIMIT100;
380
364
```
381
365
382
-
### 9.2 Inspect RBAC activity in Keeper
383
-
384
-
```sql
385
-
SELECT event_time, type, op_num, path, error
386
-
FROMsystem.zookeeper_log
387
-
WHEREpathLIKE'/clickhouse/access/%'
388
-
ORDER BY event_time DESC
389
-
LIMIT200;
390
-
```
391
-
392
-
### 9.3 Relevant server log patterns
366
+
### 9.2 Relevant server log patterns
393
367
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:
0 commit comments