admin/opensimMULTITOOLS-II
1
0
Fork 0
mirror of https://github.com/ManfredAabye/opensimMULTITOOLS-II.git synced 2026-08-14 08:52:24 +00:00
Code Issues Packages Projects Releases Wiki Activity

020420261318

Browse Source
This commit is contained in:
Manfred Aabye
2026-04-02 13:18:28 +02:00
committed by GitHub
parent d0a7606753
commit 76eb9d4ffe
2 changed files with 229 additions and 452 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+197 -451
View File
@@ -1,451 +1,197 @@
# **opensimMULTITOOL II V26.4**
Ein Bash-Skript zum Verwalten von OpenSim-Grids (Starten, Stoppen, Bereinigen, Installation).
**Benutzung ausschließlich auf eigene Gefahr**
*Dieses Skript ist im Entwicklungsstadium und kann unbeabsichtigte Datenverluste verursachen.*
```diff
- WICHTIGE WARNUNGEN:
1. ALPHA-STATUS
Dies ist ein Alpha-Skript – Nutzung im Produktivbetrieb ausschließlich
nach gründlichem Testen in einer sicheren Umgebung.
2. BACKUPS SIND VERPFLICHTEND
Vor jeder Ausführung müssen
vollständige Backups aller betroffenen Systeme/Daten erstellt werden.
3. HAFTUNGSAUSSCHLUSS
Es wird keine Haftung für Datenverlust,
Systemausfälle oder Folgeschäden übernommen.
Nutzung auf eigenes Risiko.
4. EINGESCHRÄNKTE ZUVERLÄSSIGKEIT
Selbst als "sicher" markierte Funktionen können je nach Betriebssystem,
Konfiguration oder Umgebung unerwartetes Verhalten zeigen.
→ Ausführliche Tests in Ihrer spezifischen Umgebung sind zwingend erforderlich.
```
---
## **Neu: Modulare Struktur (osmtool_backup_*)**
Fuer die Aufteilung in einzelne Aufgaben gibt es jetzt eine modulare Basis:
- `osmtool_main.sh` (zentraler Starter, CLI + UI)
- `modular/osmtool_install.sh` (Installation)
- `modular/osmtool_startstop.sh` (Start/Stop/Restart)
- `modular/osmtool_cleanup.sh` (Bereinigungen + Reboot)
- `modular/osmtool_data.sh` (DB/OAR Backups)
- `modular/osmtool_core.sh` (gemeinsame Funktionen)
### Empfehlung UI: whiptail oder dialog?
- Empfehlung: **whiptail als Default**, weil es auf Ubuntu meist schon vorhanden ist und weniger Abhaengigkeiten hat.
- Fallback: **dialog**, falls whiptail nicht installiert ist.
- Beide Wege sind im Starter beruecksichtigt: `whiptail -> dialog -> CLI`.
### Beispiele
```bash
# CLI: Ubuntu vorbereiten
bash osmtool_main.sh --module install --action prepare-ubuntu
# CLI: OpenSim-Abhaengigkeiten und dotnet installieren
bash osmtool_main.sh --module install --action install-opensim-deps --workdir /opt --profile grid-sim
bash osmtool_main.sh --module install --action install-dotnet8 --workdir /opt --profile grid-sim
# CLI: Server-Readiness pruefen
bash osmtool_main.sh --module install --action server-check --workdir /opt --profile grid-sim
# CLI: OpenSim klonen, Zusatzmodule einbinden und bauen
bash osmtool_main.sh --module install --action install-opensim --workdir /opt --profile grid-sim
# CLI: OpenSim Runtime-INI aus Beispieldateien erzeugen
bash osmtool_main.sh --module install --action configure-opensim --workdir /opt --profile grid-sim
# CLI: MariaDB Datenbanken/Benutzer/Rechte fuer robust/sim* anlegen
bash osmtool_main.sh --module install --action configure-database --workdir /opt --profile grid-sim --db-user opensim --db-pass 'OpenSim#2026'
# CLI: OpenSim bauen ohne Verteilung in Laufzeitordner
bash osmtool_main.sh --module install --action install-opensim --workdir /opt --profile grid-sim --deploy-binaries false
# CLI: komplettes Grid neustarten
bash osmtool_main.sh --module startstop --target grid --action restart --workdir /opt
# CLI: Janus Gateway neustarten
bash osmtool_main.sh --module startstop --target janus --action restart --workdir /opt
# CLI: Janus zuerst kompilieren
bash osmtool_main.sh --module install --action compile-janus --workdir /opt --profile grid-sim
# CLI: Janus danach konfigurieren
bash osmtool_main.sh --module install --action configure-janus --workdir /opt --profile grid-sim --public-host 127.0.0.1
# CLI: Janus kompiliert + konfiguriert in einem Lauf
bash osmtool_main.sh --module install --action install-janus --workdir /opt --profile grid-sim --public-host 127.0.0.1
# CLI: Robust DB sichern
bash osmtool_main.sh --module backup --action db-backup --db-user root --db-pass secret --db-name opensim --workdir /opt
# CLI: OAR Export in laufende sim1 Session senden
bash osmtool_main.sh --module backup --action oar-backup --workdir /opt --region sim1 --session sim1
# CLI: Full Backup (MariaDB + OAR Command) mit gzip-Kompression
bash osmtool_main.sh --module backup --action full-backup --workdir /opt --db-user root --db-pass secret --db-name opensim --region sim1 --session sim1 --compress true
# CLI: OSMTool Cronjobs installieren
bash osmtool_main.sh --module cron --action install --workdir /opt --db-user root --db-name opensim --region sim1 --session sim1
# CLI: OSMTool Cronjobs anzeigen/entfernen
bash osmtool_main.sh --module cron --action list --workdir /opt
bash osmtool_main.sh --module cron --action remove --workdir /opt
# UI Modus
bash osmtool_main.sh --mode ui
```
Hinweis Janus:
- Startreihenfolge: `prepare-ubuntu` -> `install-opensim-deps` -> `install-dotnet8` -> `server-check`.
- `configure-opensim` erzeugt fehlende Runtime-INI aus den Beispielvorlagen.
- `configure-database` erzeugt MariaDB Datenbanken fuer `robust` und gefundene `sim*` Verzeichnisse sowie Benutzer/Grants.
- Datenbankbasis ist MariaDB; `server-check` prueft `mysqldump` als Pflichttool fuer Backups.
- `install-opensim` klont oder aktualisiert `opensim`, `opensim-tsassets`, `opensimcurrencyserver-dotnet` und `os-data-backup`, fuehrt `runprebuild.sh` aus und baut `OpenSim.sln`.
- Wenn `robust/bin`, `standalone/bin` oder `sim*/bin` existieren, verteilt `install-opensim` die gebauten Binaries dorthin, sofern `--deploy-binaries` nicht auf `false` gesetzt ist.
- Janus muss vor Start/Restart zuerst kompiliert und konfiguriert sein.
- `startstop --target janus` prueft Binary und Konfiguration und blockiert sonst mit klarer Fehlermeldung.
### Sinnvolle weitere Skripte
- `osmtool_backup_health.sh` (Healthcheck fuer screen sessions, ports, DB)
- `osmtool_backup_restore.sh` (SQL Restore + OAR Restore mit Dry-Run)
- `osmtool_backup_update.sh` (OpenSim/Janus Update-Workflow mit Rollback)
- `osmtool_backup_cron.sh` (Cronjobs validieren und automatisch setzen)
- `osmtool_backup_config.sh` (INI/JSON Validierung und Patchen)
---
## **📋 Inhaltsverzeichnis**
1. [OpenSim starten/stoppen](#-opensim-starten-stoppen-und-neustarten)
2. OpenSim-Grid erstellen/aktualisieren
3. [Diverse Git-Downloads](#-diverse-git-downloads)
4. Konfiguration
5. INI-Operationen
6. XML-Operationen
7. Standalone-Modus
8. [OpenSim bereinigen](#-opensim-grid-bereinigen)
9. Systembefehle
10. [Hilfen](#-hilfen)
11. [OpenSimulator-crontabs](#-opensimulator-crontabs)
---
## **🔄 OpenSim starten, stoppen und neustarten**
| Befehl | Beschreibung | Status |
| ------------------------ | ------------------------------------------------------------------- | ------------------------ |
| `opensimstart` | Startet den OpenSim-Server. | Stabil |
| `opensimstop` | Stoppt den OpenSim-Server. | Stabil |
| `opensimrestart` | Startet OpenSim neu. | Stabil |
| `opensimstartParallel` | Startet alle Regionen parallel. | Stabil |
| `opensimstopParallel` | Stoppt alle Regionen parallel. | Stabil |
| `opensimrestartParallel` | Startet alle Regionen neu (parallel). | Stabil |
| `check_screens` | Überprüft laufende OpenSim-Prozesse und startet sie bei Bedarf neu. | Stabil |
---
## **🛠️ OpenSim-Grid erstellen oder aktualisieren**
| Befehl | Beschreibung | Status |
| ------------------------------------- | ----------------------------------------------- | ------------------------ |
| `servercheck` | Prüft, ob der Server für OpenSim bereit ist. | Test |
| `createdirectory` | Erstellt die benötigten Verzeichnisse. | Stabil |
| `opensimbuild` | OpenSim-Programm erstellen. | Stabil |
| `opensimcopy` | OpenSim kopieren/upgraden. | Stabil |
| `database_setup` | SQL-Datenbanken erstellen. | Test |
| `opensimupgrade` | OpenSim aktualisieren. | Test |
| `autoupgrade` | Führt automatisches Upgrade durch. | Test |
| `autoupgradefast` | Führt automatisches paralleles Upgrade durch. | Test |
| `regionbackup` | Backup aller Regionsdaten. | Test |
| `robustbackup` | Backup der Robust-Datenbank mit Zeitraumfilter. | Test |
| `robustrestore <user> <pass> [teil]` | Wiederherstellung aus Backup. | Test |
| `robustrepair <user> <pass> [aktion]` | Reparatur oder Bereinigung. | Test |
| `setcrontab` | Crontab Automatisierungen erstellen. | Stabil |
---
## **📂 Diverse Git-Downloads**
| Befehl | Beschreibung | Status |
| ----------------- | ------------------------------------- | ------------------------ |
| `opensimgitcopy` | OpenSim aus Git herunterladen. | Stabil |
| `moneygitcopy` | MoneyServer aus Git herunterladen. | Stabil |
| `ruthrothgit` | Ruth/Roth IAR-Dateien aus Git. | in Arbeit |
| `avatarassetsgit` | Ruth/Roth Assets aus Git. | in Arbeit |
| `osslscriptsgit` | OSSL Beispiel-Skripte herunterladen. | Stabil |
| `pbrtexturesgit` | PBR Texturen aus Git. | in Arbeit |
| `downloadallgit` | Alle Git-Repositories herunterladen. | Voricht test |
| `versionrevision` | Versionsrevision auf Expanded setzen. | Stabil |
---
## **⚙️ Konfiguration**
| Befehl | Beschreibung | Status |
| --------------------------- | -------------------------------------- | ------------------- |
| `moneyserveriniconfig` | Konfiguriert MoneyServer.ini. | Optimierung fehlt. |
| `opensiminiconfig` | Konfiguriert OpenSim.ini. | Optimierung fehlt. |
| `robusthginiconfig` | Konfiguriert Robust.HG.ini. | Optimierung fehlt. |
| `robustiniconfig` | Konfiguriert Robust.ini. | Optimierung fehlt. |
| `gridcommoniniconfig` | Erstellt GridCommon.ini. | Optimierung fehlt. |
| `standalonecommoniniconfig` | Erstellt StandaloneCommon.ini. | Optimierung fehlt. |
| `flotsaminiconfig` | Erstellt FlotsamCache.ini. | Optimierung fehlt. |
| `osslenableiniconfig` | Konfiguriert osslEnable.ini. | Optimierung fehlt. |
| `welcomeiniconfig` | Konfiguriert Begrüßungsregion. | Optimierung fehlt. |
| `regionsiniconfig` | Startet neue Regionen-Konfigurationen. | Optimierung fehlt. |
| `iniconfig` | Startet ALLE Konfigurationen. | Optimierung fehlt. |
---
## **📜 INI Konfiguration Operationen**
| Befehl | Beschreibung | Status |
| -------------------- | --------------------------- | ------------------------ |
| `verify_ini_section` | INI-Abschnitt verifizieren. | Test |
| `verify_ini_key` | INI-Schlüssel verifizieren. | Test |
| `add_ini_section` | INI-Abschnitt hinzufügen. | Stabil |
| `set_ini_key` | INI-Schlüssel setzen. | Stabil |
| `del_ini_section` | INI-Abschnitt löschen. | Stabil |
---
## **📄 XML Assets Operationen**
| Befehl | Beschreibung | Status |
| -------------------- | --------------------------- | ------------------------ |
| `verify_xml_section` | XML-Abschnitt verifizieren. | ungetestet |
| `add_xml_section` | XML-Abschnitt hinzufügen. | ungetestet |
| `del_xml_section` | XML-Abschnitt löschen. | ungetestet |
---
## **🖥️ Standalone-Modus**
| Befehl | Beschreibung | Status |
| ------------------------ | ------------------------------------- | ------ |
| `standalonestart` | Startet OpenSim im Standalone-Modus | Stabil |
| `standalonestop` | Stoppt OpenSim im Standalone-Modus | Stabil |
| `standalonerestart` | Startet OpenSim Standalone neu | Stabil |
| `buildstandalone` | Standalone erstellen | Test |
| `opensimgitcopy` | OpenSimulator aus Git kopieren | Test |
| `osslscriptsgit` | Skripte aus Repository einfügen | Test |
| `versionrevision` | OpenSimulator-Version festlegen | Test |
| `opensimbuild` | OpenSimulator bauen | Test |
| `standalonesetup` | Standalone Setup durchführen | Test |
| `createstandaloneconfig` | OpenSimulator-Konfiguration erstellen | Test |
| `createstandalonregion` | Startregion konfigurieren | Test |
| `createstandaloneuser` | Benutzer erstellen | Test |
---
## **🧹 OpenSim Grid Bereinigen**
⚠ **Warnung:** Einige Befehle erfordern eine **Neuinstallation** von OpenSim!
| Befehl | Beschreibung | Status |
| ------------------ | ------------------------------------------------------------ | ------------------------ |
| `dataclean` | Alte Dateien löschen (⚡ Neuinstallation erforderlich!) | Test |
| `pathclean` | Alte Verzeichnisse löschen (⚡ Neuinstallation erforderlich!)| Test |
| `cacheclean` | Cache bereinigen. | Stabil |
| `logclean` | Logs löschen. | Stabil |
| `mapclean` | Maptiles löschen. | Stabil |
| `autoallclean` | Komplettbereinigung (⚡ Neuinstallation erforderlich!) | Test |
| `regionsclean` | Alle Regionen löschen. | Test |
| `cleanall` | Alles bereinigen (⚡ Neuinstallation erforderlich!) | Test |
| `renamefiles` | Umbenennung aller \*.example Dateien. | Test |
| `clean_linux_logs` | Linux-Systemlogs bereinigen. | Test |
| `delete_opensim` | Entfernt OpenSimulator komplett inkl. Verzeichnissen. | Test |
---
## **🛠️ Systembefehle**
| Befehl | Beschreibung | Status |
| -------- | ------------------------------------------ | ------------------------ |
| `reboot` | Grid herunterfahren und Server neustarten. | Stabil |
---
## **📂 Backup**
|Befehl|Beschreibung|Status|
|---|---|---|
|`loadiar`|Lädt ein Inventar-Archiv (IAR) zu einem Avatar hoch|Test|
|`saveiar`|Speichert das Inventar eines Avatars als IAR-Datei|Test|
|`loadoar`|Lädt ein vollständiges Regionen-Backup (OAR) in eine Region|Test|
|`saveoar`|Erstellt ein vollständiges Backup (OAR) einer Region|Test|
|`autoregionbackup`|Führt automatisierte Backups aller Regionen aus|Test|
---
## **❓ Hilfen**
| Befehl | Beschreibung | Status |
| --------- | ----------------------------------------------------------- | ------------------------ |
| `help` | Die Hilfeseite anzeigen. | Stabil |
| `prohelp` | Erweiterte Hilfeseite mit allen Experten-Befehlen anzeigen. | Stabil |
➔ [📖 Wiki Dokumentation](https://github.com/ManfredAabye/opensimMULTITOOLS-II/wiki)
---
## **❓ OpenSimulator-crontabs**
### List crontabs
```bash
crontab -l
```
### Edit crontabs
```bash
crontab -e
```
```text
# * * * * * Befehl_der_ausgefuehrt_werden_soll
# │ │ │ │ │
# │ │ │ │ ─── Wochentag (0-7) (0 und 7 = Sonntag)
# │ │ │ ───── Monat (1-12)
# │ │ ─────── Tag des Monats (1-31)
# │ ───────── Stunde (0-23)
# ─────────── Minute (0-59)
# Restart server on the first of each month to clear cache data debris.
45 4 1 * * bash /opt/osmtool.sh reboot
# Restart the grid every morning at 5 AM.
0 5 * * * bash /opt/osmtool.sh autorestart
# If Robust or the Welcome region fails, restart the grid.
*/30 * * * * bash /opt/osmtool.sh check_screens
# Restart Jauns WebRTC Server every morning at 4:30
30 4 * * * bash /opt/bash janus.sh restart_janus
# Restart icecast every morning at 7:15
15 7 * * * /etc/init.d/icecast2 restart
```
### Save crontabs
```text
ctrl O
Enter
```
### Exit editor
```text
ctrl X
```
---
## `osmtool_backup.sh`
Dieses Skript dient zur Sicherung und Verwaltung von OpenSimulator-Regionen und zugehörigen Datenbanken.
Es bietet verschiedene Backup- und Restore-Funktionen für Regionen, Konfigurationsdateien und MySQL-Datenbanken.
## Grundlegende Nutzung
Das Skript wird mit einem Kommando und ggf. weiteren Parametern ausgeführt:
```bash
bash osmtool_backup.sh <KOMMANDO> [weitere Parameter]
```
### Wichtige Kommandos
|Kommando|Beschreibung|
|---|---|
|`regionsiniteilen <Verz> <Reg>`|Teilt die Regions.ini einer Region in einzelne INI-Dateien auf.|
|`autoregionsiniteilen`|Teilt alle Regions.ini-Dateien automatisch auf.|
|`createregionlist`|Erstellt eine Liste aller Regionen.|
|`regionbackup <Screen> <Region>`|Backup einer bestimmten Region inkl. OAR, Terrain und Konfiguration.|
|`autoregionbackup`|Automatisches Backup aller Regionen nacheinander.|
|`backup_config`|Sichert Konfigurationsdateien aus robust/bin und sim-Verzeichnissen.|
|`restore_config`|Stellt Konfigurationsdateien aus dem Backup wieder her.|
|`autoallclean`|Löscht Log- und Binärdateien für eine saubere Neuinstallation.|
|`datenbanktabellen <User> <Pw> <DB>`|Zählt Tabellen und Asset-Typen in einer Datenbank.|
|`backuptabelle_noassets <User> <Pw> <DB>`|Sichert alle Tabellen (außer assets) als ZIP.|
|`asset_backup <User> <Pw> <DB>`|Sichert alle Asset-Typen einzeln.|
|`db_restoretabelle_noassets <User> <Pw> <DB>`|Stellt alle Tabellen (außer assets) aus Backup wieder her.|
|`asset_restore <User> <Pw> <DB>`|Stellt die Asset-Typen aus Backup wieder her.|
|`sichere_wordweb_und_money <User> <Pw>`|Sichert die Datenbanken `wordweb` und `money`.|
|`restore_wordweb_und_money <User> <Pw>`|Stellt die Datenbanken `wordweb` und `money` wieder her.|
## Beispiele osmtool_backup.sh
**Backup einer Region:**
```bash
bash osmtool_backup.sh regionbackup sim1 MeineRegion
```
**Automatisches Backup aller Regionen:**
```bash
bash osmtool_backup.sh autoregionbackup
```
**Backup der Konfigurationsdateien:**
```bash
bash osmtool_backup.sh backup_config
```
**Datenbanktabellen zählen:**
```bash
bash osmtool_backup.sh datenbanktabellen mein_benutzer geheim123 meine_datenbank
```
## Hinweise
- Das Skript muss mit ausreichenden Rechten (ggf. als root) ausgeführt werden, um auf alle Verzeichnisse und Datenbanken zugreifen zu können.
- Das Skript verwendet `screen`, `mysqldump`, und `zip` für Backups. Stelle sicher, dass diese Programme installiert sind.
- Die meisten Funktionen sind für eine Standard-OpenSimulator-Struktur ausgelegt (`/opt/simX`, `/opt/robust` etc.).
- Die Backups werden im Verzeichnis `/opt/backup` abgelegt.
**Tipp:** Weitere Details und Beispiele findest du direkt im Skript in den Funktionskommentaren!
---
## `osmtool_restart.sh`
Ein schlankes Skript zum Neustart des Servers und zur Überprüfung, ob alle Komponenten ordnungsgemäß laufen.
### Verhalten bei Ausfällen
- Wenn der **RobustServer** nicht läuft, wird das **gesamte Grid neu gestartet**.
- Wenn der **MoneyServer** nicht läuft, wird das **gesamte Grid neu gestartet**.
- Wenn **sim1** (die Welcome-Region) nicht läuft, wird das **gesamte Grid neu gestartet**.
- Wenn eine Region von **sim2 bis sim99** nicht läuft, wird **nur diese einzelne Region neu gestartet**.
---
## **📜 Lizenz & Nutzung**
- **Skriptname**: `osmtool.sh`
- **Version**: *V25.5.109.442*
- **Autor**: *Manfred Aabye*
- **Lizenz**: *MIT*
---
# opensimMULTITOOL II V26.4.230.588
Diese README ist fuer Einsteiger geschrieben.
Wenn du noch nie mit OpenSim oder Bash gearbeitet hast, starte mit den Schritten in diesem Dokument von oben nach unten.
## 1. Was ist dieses Projekt?
opensimMULTITOOLS-II hilft dir, einen OpenSim-Server zu:
- installieren
- starten und stoppen
- neu starten
- sichern (Backups)
- warten und pruefen
Das Projekt besteht aus zwei Hauptteilen:
- CLI-Skripte (Konsole): fuer Administration per Terminal
- Web-Oberflaeche unter webphp/: fuer Bedienung im Browser
## 2. Wichtige Sicherheitshinweise
- Vor groesseren Aktionen immer Backup machen.
- Erst in einer Testumgebung pruefen, dann auf Produktivsystem nutzen.
- Die Web-Oberflaeche nur mit HTTPS und moeglichst mit IP-Einschraenkung betreiben.
- Standard-Passwoerter sofort aendern.
## 3. Projektstruktur (kurz erklaert)
- osmtool_main.sh: Hauptstarter fuer Module und Aktionen
- modular/: einzelne Fachmodule (install, startstop, backup, restore, ...)
- webphp/: Web-Oberflaeche (PHP)
- osmtool.sh: klassisches Hauptskript mit vielen Direktfunktionen
## 4. Schnellstart fuer Einsteiger (CLI)
Voraussetzung: Du arbeitest auf Linux und hast Zugriff auf das Projektverzeichnis.
### Schritt 1: In das Projektverzeichnis wechseln
```bash
cd /opt/opensimMULTITOOLS-II
```
### Schritt 2: Ubuntu vorbereiten
```bash
bash osmtool_main.sh install-grid-sim
```
Hinweis: `install-grid-sim` fuehrt die komplette Installationskette fuer `grid-sim` aus.
### Schritt 3: OpenSim-Abhaengigkeiten installieren
```bash
bash osmtool_main.sh install-grid-sim
```
### Schritt 4: Server-Check ausfuehren
```bash
bash osmtool_main.sh healthcheck
```
### Schritt 5: OpenSim installieren und konfigurieren
```bash
bash osmtool_main.sh install-grid-sim
```
### Schritt 6: Datenbank einrichten
```bash
export OSM_DB_PASS='DEIN_PASSWORT'
bash osmtool_main.sh dbsetup
```
### Schritt 7: Grid starten
```bash
bash osmtool_main.sh opensimrestart
```
## 5. Alltagsbefehle (die wichtigsten)
```bash
# Grid neu starten
bash osmtool_main.sh opensimrestart
# Robust-Datenbank sichern
export OSM_DB_PASS='DEIN_PASSWORT'
bash osmtool_main.sh dbbackup
# Cronjobs installieren (automatische Backups/Checks)
bash osmtool_main.sh croninstall
```
Unterstuetzte Kurzbefehle (Ein-Wort-Aufruf):
- install-grid-sim
- opensimstart
- opensimstop
- opensimrestart
- healthcheck
- smoketest
- dailyreport
- croninstall
- cronlist
- janusinstall
- janusrestart
- dbsetup
- dbbackup
## 6. Web-Oberflaeche (webphp)
Die Web-Oberflaeche ist in webphp/ enthalten und zeigt unter anderem:
- Modulaktionen
- Kommando-Vorschau
- Ausgabe der Befehle
- Live-Status (Screens, Ports, Artefakte)
Detaillierte Web-Anleitung: webphp/README.md
### Wichtige Konfigurationsregel
Fuer die aktive Web-Konfiguration gilt:
- webphp/src/config.php = wird wirklich benutzt
- webphp/src/config.sample.php = nur Vorlage
Wenn du Ports oder Screens fuer den Live-Status aendern willst, musst du in config.php anpassen.
## 7. Login-Sicherheit der Web-Oberflaeche
Die Web-Oberflaeche hat einen Schutz gegen Brute-Force-Logins:
- Nach mehreren falschen Passwortversuchen wird die IP temporaer gesperrt.
- Sperrzeit und Schwelle sind konfigurierbar.
- Login-Ereignisse koennen in einer Audit-Logdatei gespeichert werden.
Wichtige Einstellungen in webphp/src/config.php:
- auth_lockout_max_attempts
- auth_lockout_seconds
- optional: auth_store_path
- optional: auth_audit_log_path
## 8. check_screens einfach erklaert
Die Funktion check_screens in osmtool.sh:
- prueft, ob wichtige Screen-Sessions laufen
- schreibt Ergebnisse in ProblemRestarts.log
- meldet auch, wenn ein Dienst laeuft
- startet ausgefallene Dienste neu (kritische Dienste mit Komplett-Neustart)
## 9. Typische Fehler und schnelle Loesungen
### Problem: Im Live-Status werden alte oder falsche Ports angezeigt
Loesung:
1. Ports in webphp/src/config.php aendern (nicht nur in config.sample.php).
2. Browser mit Hard-Reload neu laden (z. B. Ctrl+Shift+R).
3. Sicherstellen, dass du die richtige Instanz/den richtigen Server aufrufst.
### Problem: Login gesperrt nach Fehlversuchen
Loesung:
- Sperrzeit in auth_lockout_seconds abwarten
- oder Sperrdaten in der konfigurierten Lockout-Datei pruefen
## 10. Nuetzliche Dateien
- osmtool_main.sh
- osmtool.sh
- modular/osmtool_startstop.sh
- modular/osmtool_install.sh
- webphp/public/index.php
- webphp/src/config.php
- webphp/src/runner.php
- webphp/src/web_init.php
## 11. Hilfe
- Wiki: [opensimMULTITOOLS-II Wiki](https://github.com/ManfredAabye/opensimMULTITOOLS-II/wiki)
- Web-Dokumentation: webphp/README.md
## 12. Lizenz
- Skriptname: osmtool.sh
- Version: V26.4.230.588
- Autor: Manfred Aabye
- Lizenz: MIT
osmtool_main.sh
+32 -1
View File
@@ -13,13 +13,15 @@ usage() {
Usage:
osmtool_main.sh [--mode <cli|ui>] [--lang <de|en|fr|es>] [--profile <grid-sim|robust|standalone>] --module <install|startstop|cleanup|health|backup|restore|update|config|report|smoke|cron> [module-options]
osmtool_main.sh server_install
osmtool_main.sh <opensimstart|opensimstop|opensimrestart|healthcheck|smoketest|dailyreport|croninstall|cronlist|janusinstall|janusrestart|dbsetup>
osmtool_main.sh <install-grid-sim|opensimstart|opensimstop|opensimrestart|healthcheck|smoketest|dailyreport|croninstall|cronlist|janusinstall|janusrestart|dbsetup|dbbackup>
Examples:
osmtool_main.sh install-grid-sim
osmtool_main.sh server_install
osmtool_main.sh opensimstart
osmtool_main.sh opensimrestart
osmtool_main.sh croninstall
osmtool_main.sh dbbackup
osmtool_main.sh --module install --action prepare-ubuntu
osmtool_main.sh --module startstop --target grid --action restart --workdir /opt
osmtool_main.sh --module cleanup --action log-clean --workdir /opt
@@ -255,6 +257,21 @@ if [[ "${1:-}" == "server_install" ]]; then
exit 0
fi
if [[ "${1:-}" == "install-grid-sim" ]]; then
PROFILE="grid-sim"
set_language "$LANG_OVERRIDE"
validate_profile "$PROFILE"
log INFO "Running install-grid-sim shortcut (prepare-ubuntu -> install-opensim-deps -> install-dotnet8 -> server-check -> install-opensim -> configure-opensim)"
dispatch_module install --action prepare-ubuntu --workdir /opt
dispatch_module install --action install-opensim-deps --workdir /opt
dispatch_module install --action install-dotnet8 --workdir /opt
dispatch_module install --action server-check --workdir /opt
dispatch_module install --action install-opensim --workdir /opt
dispatch_module install --action configure-opensim --workdir /opt
exit 0
fi
if [[ "${1:-}" == "opensimstart" ]]; then
set_language "$LANG_OVERRIDE"
validate_profile "$PROFILE"
@@ -340,6 +357,20 @@ if [[ "${1:-}" == "dbsetup" ]]; then
exit 0
fi
if [[ "${1:-}" == "dbbackup" ]]; then
set_language "$LANG_OVERRIDE"
validate_profile "$PROFILE"
DB_USER_SHORT="${OSM_DB_USER:-root}"
DB_PASS_SHORT="${OSM_DB_PASS:-}"
DB_NAME_SHORT="${OSM_DB_NAME:-opensim}"
[[ -n "$DB_PASS_SHORT" ]] || die "dbbackup requires OSM_DB_PASS environment variable"
dispatch_module backup --action db-backup --workdir /opt --db-user "$DB_USER_SHORT" --db-pass "$DB_PASS_SHORT" --db-name "$DB_NAME_SHORT"
exit 0
fi
while [[ $# -gt 0 ]]; do
case "$1" in
--mode) MODE="$2"; shift 2 ;;