1- # lmgmt - Agent Operational Guide
1+ # otdf-local - Agent Operational Guide
22
3- This guide covers operational procedures for managing the test environment with ` lmgmt ` . For command reference, see [ README.md] ( README.md ) .
3+ This guide covers operational procedures for managing the test environment with ` otdf-local ` . For command reference, see [ README.md] ( README.md ) .
44
55## Environment Setup for pytest
66
77``` bash
8- cd tests/lmgmt
9- eval $( uv run lmgmt env) # Sets PLATFORM_LOG_FILE, KAS_*_LOG_FILE, etc.
10- uv run lmgmt env --format json # Output as JSON
8+ cd tests/otdf-local
9+ eval $( uv run otdf-local env) # Sets PLATFORM_LOG_FILE, KAS_*_LOG_FILE, etc.
10+ uv run otdf-local env --format json # Output as JSON
1111cd ../xtest
1212uv run pytest --sdks go -v
1313```
1414
1515## Service Ports
1616
17- Auto-configured by lmgmt :
17+ Auto-configured by otdf-local :
1818- Keycloak: 8888, Postgres: 5432, Platform: 8080
1919- KAS: alpha=8181, beta=8282, gamma=8383, delta=8484, km1=8585, km2=8686
2020
2121## Restart Procedures
2222
2323### Full Environment Restart
2424``` bash
25- cd tests/lmgmt
25+ cd tests/otdf-local
2626
27- uv run lmgmt down
28- uv run lmgmt up
27+ uv run otdf-local down
28+ uv run otdf-local up
2929
3030# Or with cleanup
31- uv run lmgmt down --clean
32- uv run lmgmt up
31+ uv run otdf-local down --clean
32+ uv run otdf-local up
3333```
3434
3535### Service-Specific Restart
3636``` bash
37- cd tests/lmgmt
37+ cd tests/otdf-local
3838
39- uv run lmgmt restart platform
40- uv run lmgmt restart kas-alpha
41- uv run lmgmt restart kas-km1
42- uv run lmgmt restart docker
39+ uv run otdf-local restart platform
40+ uv run otdf-local restart kas-alpha
41+ uv run otdf-local restart kas-km1
42+ uv run otdf-local restart docker
4343```
4444
4545### Manual Restart (Emergency)
4646
47- Only use when lmgmt itself is broken or unresponsive:
47+ Only use when otdf-local itself is broken or unresponsive:
4848
4949``` bash
5050pkill -9 -f " go.*service.*start"
5151pkill -9 -f " opentdf-kas"
5252tmux kill-session -t xtest 2> /dev/null || true
5353cd platform && docker compose down 2> /dev/null || true
5454sleep 5
55- cd tests/lmgmt && uv run lmgmt up
55+ cd tests/otdf-local && uv run otdf-local up
5656```
5757
5858### Platform Only (Manual)
@@ -77,11 +77,11 @@ tmux attach -t xtest
7777
7878## Viewing Service Logs
7979
80- ** Via lmgmt :**
80+ ** Via otdf-local :**
8181``` bash
82- uv run lmgmt logs -f # Follow all
83- uv run lmgmt logs platform -f # Follow specific service
84- uv run lmgmt logs --grep " error" -f # Filter
82+ uv run otdf-local logs -f # Follow all
83+ uv run otdf-local logs platform -f # Follow specific service
84+ uv run otdf-local logs --grep " error" -f # Filter
8585```
8686
8787** Via tmux session:**
@@ -110,13 +110,13 @@ tail -f tests/xtest/logs/kas-km1.log
110110
111111# # Golden Key Auto-Configuration
112112
113- When using ` lmgmt up` or ` lmgmt restart platform` , golden keys are automatically configured:
114- 1. ` lmgmt ` reads ` tests/xtest/extra-keys.json` containing the ` golden-r1` key
113+ When using ` otdf-local up` or ` otdf-local restart platform` , golden keys are automatically configured:
114+ 1. ` otdf-local ` reads ` tests/xtest/extra-keys.json` containing the ` golden-r1` key
1151152. Key files are extracted to ` platform/golden-r1-private.pem` and ` platform/golden-r1-cert.pem`
1161163. The key is added to ` cryptoProvider.standard.keys` in the platform config
1171174. A legacy keyring entry is added to ` services.kas.keyring`
118118
119- ** Manual configuration** (if not using lmgmt ):
119+ ** Manual configuration** (if not using otdf-local ):
120120
121121Add to ` platform/opentdf-dev.yaml` :
122122` ` ` yaml
@@ -145,16 +145,16 @@ jq -r '.[0].cert' tests/xtest/extra-keys.json > platform/golden-r1-cert.pem
145145# # Troubleshooting
146146
147147` ` ` bash
148- cd tests/lmgmt
148+ cd tests/otdf-local
149149
150150# Check service status
151- uv run lmgmt status
152- uv run lmgmt ls --all
151+ uv run otdf-local status
152+ uv run otdf-local ls --all
153153
154154# View service logs
155- uv run lmgmt logs platform -f
156- uv run lmgmt logs kas-alpha -f
157- uv run lmgmt logs --grep error
155+ uv run otdf-local logs platform -f
156+ uv run otdf-local logs kas-alpha -f
157+ uv run otdf-local logs --grep error
158158
159159# Or check log files directly
160160tail -f tests/xtest/logs/platform.log
@@ -169,18 +169,18 @@ lsof -i :8181 # KAS alpha
169169lsof -i :8888 # Keycloak
170170` ` `
171171
172- # # Extending lmgmt
172+ # # Extending otdf-local
173173
174174The shell scripts in ` scripts/lib/` are deprecated. For new automation:
175- - Extend the ` lmgmt ` Python CLI instead of creating new shell scripts
175+ - Extend the ` otdf-local ` Python CLI instead of creating new shell scripts
176176- The codebase uses Python with Pydantic for type safety and better error handling
177177- See ` README.md` for project structure
178178
179179To test changes:
180180` ` ` bash
181- cd tests/lmgmt
182- uv run lmgmt down
183- uv run lmgmt up
184- uv run lmgmt status
185- uv run lmgmt logs -f
181+ cd tests/otdf-local
182+ uv run otdf-local down
183+ uv run otdf-local up
184+ uv run otdf-local status
185+ uv run otdf-local logs -f
186186` ` `
0 commit comments