97a9c40d7e
- Add docs/README.md with project overview and current status - Add docs/architecture.md with detailed architecture documentation - Add docs/development.md with development guide for contributors - Update .notes/todo.md to reflect architecture fix completion - Update .notes/plan.md with completed phases and next priorities Architecture fixes (daemon and dbus), bubblewrap integration are now complete. Ready for OCI integration phase.
113 lines
No EOL
2.5 KiB
Markdown
113 lines
No EOL
2.5 KiB
Markdown
# apt-ostree D-Bus Testing - Quick Reference
|
|
|
|
## Essential Commands
|
|
|
|
### 1. Check Daemon Status
|
|
```bash
|
|
systemctl status apt-ostreed.service
|
|
```
|
|
|
|
### 2. List D-Bus Services
|
|
```bash
|
|
gdbus list --system | grep aptostree
|
|
```
|
|
|
|
### 3. Test D-Bus Introspection
|
|
```bash
|
|
gdbus introspect --system --dest org.aptostree.dev --object-path /org/aptostree/dev
|
|
```
|
|
|
|
### 4. Test Ping Method
|
|
```bash
|
|
gdbus call --system --dest org.aptostree.dev --object-path /org/aptostree/dev --method org.aptostree.dev.Daemon.Ping
|
|
```
|
|
|
|
### 5. Test GetStatus Method
|
|
```bash
|
|
gdbus call --system --dest org.aptostree.dev --object-path /org/aptostree/dev --method org.aptostree.dev.Daemon.GetStatus
|
|
```
|
|
|
|
### 6. Test Client-Daemon Communication
|
|
```bash
|
|
apt-ostree daemon-ping
|
|
apt-ostree daemon-status
|
|
```
|
|
|
|
## Quick Test Script
|
|
|
|
Run the manual test script:
|
|
```bash
|
|
chmod +x test-dbus-manual.sh
|
|
sudo ./test-dbus-manual.sh
|
|
```
|
|
|
|
## Troubleshooting Commands
|
|
|
|
### Check Daemon Logs
|
|
```bash
|
|
journalctl -u apt-ostreed.service --no-pager -n 20
|
|
```
|
|
|
|
### Restart Daemon
|
|
```bash
|
|
sudo systemctl restart apt-ostreed.service
|
|
```
|
|
|
|
### Check D-Bus Configuration
|
|
```bash
|
|
ls -la /etc/dbus-1/system.d/org.aptostree.dev.conf
|
|
ls -la /usr/share/dbus-1/system-services/org.aptostree.dev.service
|
|
```
|
|
|
|
### Reload D-Bus
|
|
```bash
|
|
sudo systemctl reload dbus
|
|
```
|
|
|
|
### Test with Authentication
|
|
```bash
|
|
pkexec gdbus call --system --dest org.aptostree.dev --object-path /org/aptostree/dev --method org.aptostree.dev.Daemon.Ping
|
|
```
|
|
|
|
## Expected Results
|
|
|
|
### Successful D-Bus Communication
|
|
- Daemon service: `active (running)`
|
|
- D-Bus service: `org.aptostree.dev` in list
|
|
- Ping response: `('pong',)`
|
|
- Client ping: `Daemon is responding: pong`
|
|
|
|
### Common Error Messages
|
|
- `Service not found`: Daemon not running or D-Bus service not registered
|
|
- `Permission denied`: Authentication/authorization issue
|
|
- `Connection refused`: D-Bus configuration problem
|
|
- `Method not found`: Interface mismatch
|
|
|
|
## Quick Fixes
|
|
|
|
### If Daemon Not Running
|
|
```bash
|
|
sudo systemctl start apt-ostreed.service
|
|
sudo systemctl enable apt-ostreed.service
|
|
```
|
|
|
|
### If D-Bus Service Not Registered
|
|
```bash
|
|
sudo systemctl restart apt-ostreed.service
|
|
sudo systemctl reload dbus
|
|
```
|
|
|
|
### If Permission Denied
|
|
```bash
|
|
# Check Polkit policy
|
|
ls -la /usr/share/polkit-1/actions/org.aptostree.dev.policy
|
|
|
|
# Test with authentication
|
|
pkexec gdbus call --system --dest org.aptostree.dev --object-path /org/aptostree/dev --method org.aptostree.dev.Daemon.Ping
|
|
```
|
|
|
|
### If Configuration Missing
|
|
```bash
|
|
# Reinstall daemon components
|
|
sudo ./scripts/install-daemon.sh
|
|
``` |