Sheets via neuer KeyboardAwareSheet-Composable (in Modal pattern, auto-grow mit Tastatur, paddingBottom-Lift): EditMail, AddDomain, CreateRoom, ConnectMail. GameOverScreen behält Spring-Slide-In, nutzt RN Keyboard.addListener für Lift. - KeyboardAwareSheet.tsx — universal modal with sheet-grow + keyboard-padding - react-native-keyboard-controller installiert + KeyboardProvider in Root - Snake: time + ScoreProgressBar + useSnakeSounds (haptic, audio TODO) - Tetris: title weg, Buttons zentriert, kein Pressable mit style-fn - DPad-Buttons 60→48, more bg, no scale - useMe: pub-sub listener pattern für app-weite avatar/nickname-Updates - dm.tsx: resolveAvatar wrap (iron.png-Warning) - Mail-error-humanizer + locales Recovery-Doc-Update in docs/internal/RECOVERY_LOG_2026-05-10.md Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
191 lines
4.4 KiB
Markdown
191 lines
4.4 KiB
Markdown
# MDM Server — Operations Runbook
|
|
|
|
## SSH-Zugriff
|
|
|
|
```bash
|
|
ssh rebreak-mdm
|
|
# entspricht: ssh root@178.105.101.137
|
|
```
|
|
|
|
## NanoMDM Container
|
|
|
|
### Status prüfen
|
|
```bash
|
|
ssh rebreak-mdm "docker ps | grep nanomdm"
|
|
ssh rebreak-mdm "cd /opt/nanomdm && docker compose ps"
|
|
```
|
|
|
|
### Logs anschauen
|
|
```bash
|
|
ssh rebreak-mdm "cd /opt/nanomdm && docker compose logs -f"
|
|
# Nur letzte 50 Zeilen:
|
|
ssh rebreak-mdm "cd /opt/nanomdm && docker compose logs --tail=50"
|
|
```
|
|
|
|
### Restart
|
|
```bash
|
|
ssh rebreak-mdm "cd /opt/nanomdm && docker compose restart"
|
|
```
|
|
|
|
### Stop + Start (hard restart)
|
|
```bash
|
|
ssh rebreak-mdm "cd /opt/nanomdm && docker compose down && docker compose up -d"
|
|
```
|
|
|
|
### Auf neue Version updaten
|
|
```bash
|
|
ssh rebreak-mdm "cd /opt/nanomdm && docker compose pull && docker compose up -d"
|
|
```
|
|
|
|
## PostgreSQL
|
|
|
|
### Zugriff auf nanomdm-DB
|
|
```bash
|
|
ssh rebreak-mdm "sudo -u postgres psql nanomdm"
|
|
```
|
|
|
|
### DB-Passwort abrufen
|
|
```bash
|
|
ssh rebreak-mdm "cat /root/.nanomdm_db_pass"
|
|
```
|
|
|
|
### Tabellen-Übersicht
|
|
```bash
|
|
ssh rebreak-mdm "sudo -u postgres psql nanomdm -c '\dt'"
|
|
```
|
|
|
|
### DB-Backup
|
|
```bash
|
|
ssh rebreak-mdm "sudo -u postgres pg_dump nanomdm > /tmp/nanomdm-$(date +%Y%m%d).sql"
|
|
# Lokal kopieren:
|
|
scp rebreak-mdm:/tmp/nanomdm-*.sql ./backups/
|
|
```
|
|
|
|
### DB-Restore (nach Backup)
|
|
```bash
|
|
# Achtung: destructive — nur nach User-Bestätigung
|
|
ssh rebreak-mdm "sudo -u postgres psql nanomdm < /path/to/backup.sql"
|
|
```
|
|
|
|
## nginx
|
|
|
|
### Config testen
|
|
```bash
|
|
ssh rebreak-mdm "nginx -t"
|
|
```
|
|
|
|
### Reload (nach Config-Änderung)
|
|
```bash
|
|
ssh rebreak-mdm "systemctl reload nginx"
|
|
```
|
|
|
|
### Vhost-Config
|
|
```bash
|
|
ssh rebreak-mdm "cat /etc/nginx/sites-available/mdm.rebreak.org"
|
|
```
|
|
|
|
### Logs
|
|
```bash
|
|
ssh rebreak-mdm "tail -f /var/log/nginx/access.log"
|
|
ssh rebreak-mdm "tail -f /var/log/nginx/error.log"
|
|
```
|
|
|
|
## TLS-Zertifikat (Let's Encrypt)
|
|
|
|
### Status prüfen
|
|
```bash
|
|
ssh rebreak-mdm "certbot certificates"
|
|
ssh rebreak-mdm "systemctl status certbot.timer"
|
|
```
|
|
|
|
### Manuelle Renewal (Notfall)
|
|
```bash
|
|
# ACHTUNG: Rate-Limit bei --force-renewal. Nur wenn wirklich nötig.
|
|
# Erst ohne force testen:
|
|
ssh rebreak-mdm "certbot renew --dry-run"
|
|
# Dann renewal:
|
|
ssh rebreak-mdm "certbot renew"
|
|
```
|
|
|
|
### Cert-Expiry prüfen
|
|
```bash
|
|
ssh rebreak-mdm "openssl x509 -in /etc/letsencrypt/live/mdm.rebreak.org/cert.pem -noout -dates"
|
|
```
|
|
|
|
## Apple Push Zertifikat
|
|
|
|
### Expiry prüfen
|
|
```bash
|
|
# Nach Phase D.1 (wenn push.pem vorhanden):
|
|
ssh rebreak-mdm "openssl x509 -in /opt/nanomdm/certs/push.pem -noout -dates"
|
|
```
|
|
|
|
### Jährliche Renewal
|
|
1. CSR-File ist noch da: `/opt/nanomdm/certs/push.csr`
|
|
2. Gleichen CSR auf identity.apple.com hochladen (neues Cert, gleicher Key)
|
|
3. Neues `.pem` auf Server kopieren: `scp ./MDMCertificate.pem rebreak-mdm:/opt/nanomdm/certs/push.pem`
|
|
4. `chmod 600 /opt/nanomdm/certs/push.pem`
|
|
5. `docker compose restart` auf Server
|
|
|
|
### Neues CSR generieren (nur wenn push.key verloren!)
|
|
```bash
|
|
# ACHTUNG: Neuer Key = alle Geräte müssen re-enrollen
|
|
ssh rebreak-mdm "cd /opt/nanomdm/certs && openssl req -newkey rsa:2048 -nodes \
|
|
-keyout push.key -out push.csr \
|
|
-subj '/CN=ReBreak MDM Push/O=Raynis/C=DE' && chmod 600 push.key"
|
|
ssh rebreak-mdm "cat /opt/nanomdm/certs/push.csr"
|
|
```
|
|
|
|
## Externer Health-Check
|
|
|
|
```bash
|
|
# Erwartet: HTTP 404 von nanomdm (normales Verhalten auf /)
|
|
curl -sI https://mdm.rebreak.org/
|
|
# Erwartet: "Bad Request" (MDM-Endpoint ohne gültigen Apple-Payload)
|
|
curl -s https://mdm.rebreak.org/mdm
|
|
```
|
|
|
|
## Firewall (UFW)
|
|
|
|
```bash
|
|
ssh rebreak-mdm "ufw status numbered"
|
|
# Regel hinzufügen (Beispiel SSH von spezifischer IP):
|
|
ssh rebreak-mdm "ufw allow from 1.2.3.4 to any port 22"
|
|
```
|
|
|
|
## System-Ressourcen
|
|
|
|
```bash
|
|
ssh rebreak-mdm "df -h && free -h && docker stats --no-stream"
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
### nanomdm startet nicht
|
|
|
|
```bash
|
|
ssh rebreak-mdm "cd /opt/nanomdm && docker compose logs --tail=50"
|
|
```
|
|
|
|
Häufige Ursachen:
|
|
- DB-Verbindung: `postgres://nanomdm:PASS@127.0.0.1:5432/nanomdm` — postgres läuft? `systemctl is-active postgresql@16-main`
|
|
- CA-Cert fehlt: `/opt/nanomdm/certs/ca.crt` vorhanden?
|
|
- .env-File: `cat /opt/nanomdm/.env` — NANOMDM_DB_PASS gesetzt?
|
|
- network_mode host nötig: in docker-compose.yml prüfen
|
|
|
|
### 502 Bad Gateway von nginx
|
|
|
|
Bedeutet nanomdm läuft nicht oder antwortet nicht auf 127.0.0.1:9000.
|
|
|
|
```bash
|
|
ssh rebreak-mdm "curl -sv http://127.0.0.1:9000/"
|
|
ssh rebreak-mdm "cd /opt/nanomdm && docker compose up -d"
|
|
```
|
|
|
|
### Postgres startet nicht
|
|
|
|
```bash
|
|
ssh rebreak-mdm "journalctl -u postgresql@16-main -n 50"
|
|
ssh rebreak-mdm "pg_lsclusters"
|
|
```
|