@@ -26,8 +26,8 @@ otdf-sdk-mgr install tip go # Build from source
2626
2727``` bash
2828# Configure environment for pytest (recommended)
29- cd tests/lmgmt
30- eval $( uv run lmgmt env)
29+ cd tests/otdf-local
30+ eval $( uv run otdf-local env)
3131cd ../xtest
3232
3333# Run with specific SDK
@@ -92,11 +92,11 @@ Or ensure services are running with logs in `../../platform/logs/` (auto-discove
9292
9393## Environment Management
9494
95- Use ` lmgmt ` for all environment management (starting/stopping services, viewing logs, restart procedures, troubleshooting). See:
96- - ` lmgmt /README.md` - command reference and installation
97- - ` lmgmt /CLAUDE.md` - operational procedures (restarts, tmux navigation, golden key config, troubleshooting)
95+ Use ` otdf-local ` for all environment management (starting/stopping services, viewing logs, restart procedures, troubleshooting). See:
96+ - ` otdf-local /README.md` - command reference and installation
97+ - ` otdf-local /CLAUDE.md` - operational procedures (restarts, tmux navigation, golden key config, troubleshooting)
9898
99- Quick start: ` cd tests/lmgmt && uv run lmgmt up `
99+ Quick start: ` cd tests/otdf-local && uv run otdf-local up `
100100
101101## Key Concepts
102102
@@ -131,7 +131,7 @@ yq e -i ".services.kas.root_key = \"$PLATFORM_ROOT_KEY\"" "$CONFIG_FILE"
131131``` bash
132132yq e -i ' .services.kas.preview.ec_tdf_enabled = true' platform/opentdf.yaml
133133yq e -i ' .services.kas.preview.ec_tdf_enabled = true' platform/opentdf-dev.yaml
134- cd tests/lmgmt && uv run lmgmt restart platform
134+ cd tests/otdf-local && uv run otdf-local restart platform
135135```
136136
137137### ABAC Test Failures: Decrypt Errors
@@ -146,18 +146,18 @@ curl http://localhost:8080/api/kas/v2/kas/key-access-servers | jq '.key_access_s
146146# Expected: alpha=8181, beta=8282, gamma=8383, delta=8484
147147```
148148
149- ** Fix** : Ensure all KAS instances are properly registered during startup (` lmgmt up` handles this).
149+ ** Fix** : Ensure all KAS instances are properly registered during startup (` otdf-local up` handles this).
150150
151151### Legacy/Golden TDF Test Failures
152152
153153** Symptom** : "cipher: message authentication failed"
154154
155- ** Root Cause** : Golden TDFs require specific keys loaded by the platform. ` lmgmt up` auto-configures these. See ` lmgmt /CLAUDE.md` for manual configuration details.
155+ ** Root Cause** : Golden TDFs require specific keys loaded by the platform. ` otdf-local up` auto-configures these. See ` otdf-local /CLAUDE.md` for manual configuration details.
156156
157157``` bash
158- cd tests/lmgmt
159- uv run lmgmt up # or restart platform
160- eval $( uv run lmgmt env)
158+ cd tests/otdf-local
159+ uv run otdf-local up # or restart platform
160+ eval $( uv run otdf-local env)
161161cd ../xtest
162162uv run pytest test_legacy.py --sdks go -v --no-audit-logs
163163```
@@ -182,13 +182,13 @@ export SCHEMA_FILE=/path/to/schema.json
182182 curl http://localhost:8080/api/kas/v2/kas/key-access-servers | jq
183183 curl http://localhost:8080/healthz
184184 ```
185- 4 . ** Check service logs** : ` cd tests/lmgmt && uv run lmgmt logs --grep "error" -f `
185+ 4 . ** Check service logs** : ` cd tests/otdf-local && uv run otdf-local logs --grep "error" -f `
1861865 . ** Manual reproduction** :
187187 ``` bash
188188 sdk/go/dist/main/cli.sh encrypt test.txt test.tdf --attr https://example.com/attr/foo/value/bar
189189 sdk/go/dist/main/cli.sh decrypt test.tdf test.out.txt
190190 ```
191- 6 . ** Fix and verify** : Make changes, restart services if needed (` lmgmt restart <service>` ), re-run failing test, then run full suite
191+ 6 . ** Fix and verify** : Make changes, restart services if needed (` otdf-local restart <service>` ), re-run failing test, then run full suite
192192
193193## Code Modification Best Practices
194194
@@ -206,7 +206,7 @@ After changes to SDK source, rebuild with `otdf-sdk-mgr install tip go` (or java
206206### When Modifying Platform Code
207207
208208``` bash
209- cd tests/lmgmt && uv run lmgmt restart platform
209+ cd tests/otdf-local && uv run otdf-local restart platform
210210```
211211
212212### When Modifying Test Code
@@ -221,7 +221,7 @@ cd tests/lmgmt && uv run lmgmt restart platform
221221
222222- ` test_tdfs.py ` - Core TDF roundtrip, manifest validation, tampering tests
223223- ` test_abac.py ` - ABAC policy, autoconfigure, key management tests
224- - ` test_legacy.py ` - Backward compatibility with golden TDFs (requires golden-r1 key, auto-configured by lmgmt )
224+ - ` test_legacy.py ` - Backward compatibility with golden TDFs (requires golden-r1 key, auto-configured by otdf-local )
225225- ` test_policytypes.py ` - Policy type tests (OR, AND, hierarchy)
226226- ` test_self.py ` - Platform API tests (namespaces, attributes, SCS)
227227
@@ -259,18 +259,18 @@ See `otdf-sdk-mgr/README.md` for full command reference.
259259### Preferred Workflow
260260
2612611 . ** Configure SDK artifacts** : ` cd tests/otdf-sdk-mgr && otdf-sdk-mgr install stable `
262- 2 . ** Start environment** : ` cd tests/lmgmt && uv run lmgmt up `
263- 3 . ** Configure shell** : ` eval $(uv run lmgmt env) `
262+ 2 . ** Start environment** : ` cd tests/otdf-local && uv run otdf-local up `
263+ 3 . ** Configure shell** : ` eval $(uv run otdf-local env) `
2642644 . ** Run tests** : ` cd ../xtest && uv run pytest --sdks go -v `
265- 5 . ** Restart after config changes** : ` cd ../lmgmt && uv run lmgmt restart <service> `
265+ 5 . ** Restart after config changes** : ` cd ../otdf-local && uv run otdf-local restart <service> `
266266
267267### When Debugging Test Failures
268268
2692691 . Read error messages carefully - they guide you to the root cause
2702702 . Check platform configuration matches expected test behavior
2712713 . Verify all KAS instances have consistent keys
272- 4 . Ensure services are running and healthy (` lmgmt status` )
273- 5 . Check service logs (` lmgmt logs <service> -f` )
272+ 4 . Ensure services are running and healthy (` otdf-local status` )
273+ 5 . Check service logs (` otdf-local logs <service> -f` )
2742746 . Reproduce issues manually when possible
2752757 . Always restart services after config changes
2762768 . Read before writing - understand existing code patterns
0 commit comments