mirror of
https://github.com/ManfredAabye/opensimMULTITOOLS-II.git
synced 2026-07-30 02:32:22 +00:00
130 lines
4.6 KiB
Markdown
130 lines
4.6 KiB
Markdown
# **opensimMULTITOOL II V25.4 – Skript-Dokumentation**
|
||
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. Dies ist ein ALPHA-Skript - Im Produktivbetrieb nur nach ausführlichem Testing verwenden
|
||
2. Immer Backups erstellen VOR jeder Ausführung
|
||
3. Keine Haftung für Datenverlust oder Grid-Ausfälle
|
||
```
|
||
|
||
### 📜 **Nutzungsbedingungen**
|
||
> Durch die Ausführung dieses Skripts bestätigen Sie:
|
||
> - Die Risiken vollständig zu verstehen
|
||
> - Ausreichende Backups erstellt zu haben
|
||
> - Dass der Autor nicht für Schäden haftet
|
||
|
||
---
|
||
|
||
## **📋 Inhaltsverzeichnis**
|
||
1. [OpenSim starten/stoppen](#-opensim-starten-stoppen-und-neustarten)
|
||
2. [OpenSim-Grid erstellen/aktualisieren](#-opensim-grid-erstellen-oder-aktualisieren)
|
||
3. [OpenSim bereinigen](#-opensim-grid-bereinigen)
|
||
|
||
---
|
||
|
||
## **🔄 OpenSim starten, stoppen und neustarten**
|
||
| Befehl | Beschreibung |
|
||
|--------|-------------|
|
||
| `opensimstart` | Startet den OpenSim-Server. |
|
||
| `opensimstop` | Stoppt den OpenSim-Server. |
|
||
| `opensimrestart` | Startet OpenSim neu. |
|
||
| `check_screens` | Überprüft laufende OpenSim-Prozesse und startet sie bei Bedarf neu. |
|
||
|
||
---
|
||
|
||
## **🛠️ OpenSim-Grid erstellen oder aktualisieren**
|
||
### **Schritt 1: Vorbereitung**
|
||
| Befehl | Beschreibung |
|
||
|--------|-------------|
|
||
| `servercheck` | Prüft, ob der Server für OpenSim bereit ist. |
|
||
| `createdirectory` | Erstellt die benötigten Verzeichnisse. |
|
||
| `mariasetup` | Erstellt und Richtet die MariaDB-Datenbanken ein. |
|
||
| `sqlsetup` | Erstellt und Richtet die SQL-Datenbanken ein. |
|
||
|
||
### **Schritt 2: OpenSim herunterladen & kompilieren**
|
||
| Befehl | Beschreibung |
|
||
|--------|-------------|
|
||
| `opensimgitcopy` | Lädt OpenSim aus dem Git-Repository herunter. |
|
||
| `moneygitcopy` | Lädt den MoneyServer aus dem Git-Repository herunter. |
|
||
| `opensimbuild` | Kompiliert OpenSim. |
|
||
|
||
### **Schritt 3: Konfiguration & Deployment** *(In Arbeit)*
|
||
| Befehl | Beschreibung |
|
||
|--------|-------------|
|
||
| `opensimcopy` | Kopiert OpenSim in alle Zielverzeichnisse. |
|
||
| *(Geplant)* `opensimconfig` | Konfiguriert OpenSim-Einstellungen. |
|
||
| `regionconfig` | Konfiguriert Automatisch OpenSim Regionen in eine Fibonacci-Folge. |
|
||
| `setcrontab` | Konfiguriert Automatisch crontab. |
|
||
|
||
---
|
||
|
||
## **🧹 OpenSim-Grid bereinigen**
|
||
⚠ **Warnung:** Einige Befehle erfordern eine **Neuinstallation** von OpenSim!
|
||
|
||
| Befehl | Beschreibung |
|
||
|--------|-------------|
|
||
| `dataclean` | Entfernt alle Dateien (Neuinstallation erforderlich). |
|
||
| `pathclean` | Löscht alle Verzeichnisse (Neuinstallation erforderlich). |
|
||
| `cacheclean` | Bereinigt den Cache. |
|
||
| `logclean` | Entfernt alle Log-Dateien. |
|
||
| `mapclean` | Löscht alle Maptiles (Kartendaten). |
|
||
| `autoallclean` | **Führt alle Cleaner aus** (sehr gefährlich, Neuinstallation nötig!). |
|
||
|
||
Diese Cleaner entfernen nur überflüssige Daten, während Backups und Konfigurationen erhalten bleiben.
|
||
|
||
➜ **Das Grid läuft sofort nach einem Upgrade mit:**
|
||
- Behaltenen Regionen
|
||
- Gleichen Benutzerkonten
|
||
- Intakten Einstellungen
|
||
|
||
⚠ **Warnung:** Dies ist eine gefährliche Aktion, bitte prüfen und vergleichen sie die alten Konfigurationen mit den neuen example Konfigurationen.
|
||
---
|
||
|
||
## **⚠️ Wichtige Hinweise**
|
||
- **`autoallclean` ist irreversibel!** → OpenSim muss danach neu installiert werden.
|
||
- **Backups erstellen**, bevor Bereinigungsbefehle ausgeführt werden.
|
||
- Auch wenn keine Konfigurationsdateien gelöscht werden würde ich empfehlen das sie eine Manuelle Sicherung vornehmen.
|
||
- Einige Funktionen sind noch in Arbeit (`opensimconfig`, `regionconfig`).
|
||
---
|
||
|
||
## **🔄 OpenSimulator auto- start stop restart Beispiel**
|
||
|
||
### List crontabs:
|
||
crontab -l
|
||
|
||
### Edit crontabs:
|
||
crontab -e
|
||
```
|
||
# Minute Hour Day Month Year Command
|
||
#
|
||
# Restart at 5 AM, and on the 1st of each month, restart the entire server.
|
||
#
|
||
|
||
# Restart server on the first of each month to clear cache data debris.
|
||
40 4 1 * * bash /opt/osmtool.sh cacheclean
|
||
45 4 1 * * bash /opt/osmtool.sh reboot
|
||
|
||
# Restart the grid every morning at 5 AM.
|
||
55 4 * * * bash /opt/osmtool.sh logclean
|
||
0 5 * * * bash /opt/osmtool.sh autorestart
|
||
|
||
# If Robust or the Welcome region fails, restart the grid.
|
||
*/30 * * * * bash /opt/osmtool.sh check_screens
|
||
```
|
||
### Save crontabs
|
||
ctrl O
|
||
Enter
|
||
### Exit editor
|
||
ctrl X
|
||
---
|
||
|
||
## **📜 Lizenz & Nutzung**
|
||
- **Skriptname**: `osmtool.sh`
|
||
- **Version**: *V25.4.35.62*
|
||
- **Autor**: *Manfred Aabye*
|
||
- **Lizenz**: *MIT*
|