Skip to content

Commit c4d105f

Browse files
committed
Document PERMISSION table handling in v4 migration guide
Signed-off-by: nscuro <nscuro@protonmail.com>
1 parent cc27cec commit c4d105f

1 file changed

Lines changed: 4 additions & 2 deletions

File tree

docs/guides/administration/migrating-from-v4.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -145,8 +145,8 @@ v4-migrator bootstrap \
145145
--target-pass
146146
```
147147

148-
After this, the target has the v5 schema but no rows.
149-
The migrator's later phases populate `PERMISSION`, `LICENSE`, `TEAM`, etc. directly from your v4 source.
148+
After this, the target has the v5 schema and a seeded `PERMISSION` catalog (the well-known set of v5 permissions).
149+
No other rows are written by bootstrap; the migrator's later phases populate `LICENSE`, `TEAM`, `USER`, and the rest from your v4 source.
150150

151151
### 2. Verify the target
152152

@@ -505,6 +505,8 @@ v4-migrator bootstrap --target-url ... --target-user ... --target-pass
505505
v4-migrator load --target-url ... --target-user ... --target-pass
506506
```
507507

508+
`bootstrap` re-seeds the v5 `PERMISSION` catalog after applying the schema, so the rerun of `load` can resolve permission foreign keys without re-running `transform`.
509+
508510
!!! warning
509511

510512
Don't manually `TRUNCATE` individual v5 tables and re-run `load`.

0 commit comments

Comments
 (0)