opensimMULTITOOLS-II/STANDALONE.md

Handbuch: OpenSim Standalone mit Hypergrid

Dieses Handbuch beschreibt den Betrieb einer OpenSim-Standalone-Instanz mit aktivierter Hypergrid-Funktion.

1. Zweck und Rolle

Standalone bedeutet: Alle Dienste auf einem Host, geeignet fuer Test, Entwicklung oder kleine produktive Setups.

2. Voraussetzungen

• Ubuntu Server 18.04 bis 24.04 mit bash
• Root/Sudo-Rechte auf dem Server
• Projekt unter /opt/opensimMULTITOOLS-II

Wichtig:

• Die technische Server-Vorbereitung erfolgt ueber die Install-Aktionen (prepare-ubuntu, install-opensim-deps, install-dotnet8).
• Es wird keine vorinstallierte Firewall vorausgesetzt.
• Paketinstallation und Basis-Setup werden vom Tool ausgefuehrt.

Manuelle Eingaben durch den Betreiber:

• Oeffentlicher FQDN/IP fuer Hypergrid
• Datenbank-Zugangsdaten (falls verwendet)

3. Installation

cd /opt/opensimMULTITOOLS-II
chmod +x osmtool_main.sh modular/*.sh

bash osmtool_main.sh --profile standalone --module install --action prepare-ubuntu --workdir /opt
bash osmtool_main.sh --profile standalone --module install --action install-opensim-deps --workdir /opt
bash osmtool_main.sh --profile standalone --module install --action install-dotnet8 --workdir /opt
bash osmtool_main.sh --profile standalone --module install --action server-check --workdir /opt
bash osmtool_main.sh --profile standalone --module install --action install-opensim --workdir /opt
bash osmtool_main.sh --profile standalone --module install --action configure-opensim --workdir /opt

Optional Datenbanksetup:

bash osmtool_main.sh --profile standalone --module install --action configure-database --workdir /opt --db-user opensim --db-pass 'DEIN_PASSWORT'

4. Hypergrid-Konfiguration

Datei pruefen/anpassen:

• /opt/standalone/bin/OpenSim.ini

Wichtige Punkte:

• Hypergrid-Abschnitte aktivieren
• Externe URI/FQDN korrekt setzen
• Keine localhost/127.0.0.1 in extern relevanten URI

5. Betrieb

5.1 Start/Stop/Restart

bash osmtool_main.sh --profile standalone --module startstop --action start --workdir /opt
bash osmtool_main.sh --profile standalone --module startstop --action restart --workdir /opt
bash osmtool_main.sh --profile standalone --module startstop --action stop --workdir /opt

5.2 Monitoring

bash osmtool_main.sh --profile standalone --module smoke --action run --workdir /opt
bash osmtool_main.sh --profile standalone --module health --action run --workdir /opt
bash osmtool_main.sh --profile standalone --module report --action generate --workdir /opt

6. Cron-Einrichtung

bash osmtool_main.sh --profile standalone --module cron --action install --workdir /opt --db-user opensim --db-pass 'DEIN_PASSWORT' --db-name opensim --region sim1 --session sim1
bash osmtool_main.sh --profile standalone --module cron --action list --workdir /opt

7. Typische Fehler

• Instanz laeuft lokal, aber kein HG-Travel: externe URI und NAT fehlen.
• Startfehler nach Update: mit report/health und Logs pruefen.
• Unstabiler Betrieb: smoke/report cron aktivieren.

8. Abnahmecheckliste

• Standalone startet sauber
• Hypergrid-Endpunkte extern erreichbar
• smoke/health/report erfolgreich
• HG-Reise zu externem Grid erfolgreich