1

osslscriptsgit

ManfredAabye edited this page 2025-04-23 09:53:58 +02:00

Table of Contents

• Anleitung zur Funktion osslscriptsgit
• Beschreibung
• Funktionsweise
• Grundlegende Operationen
• Benutzerinteraktion
• Installationsoptionen
• Option "new" (Neuinstallation)
• Option "upgrade" (Update)
• Dateiverwaltung
• Zielverzeichnisse
• Kopiervorgänge
• Fehlerbehandlung
• Systemvoraussetzungen
• Verwendung
• Empfohlene Vorgehensweise
• Wichtige Hinweise
• Typische Fehlerszenarien

Anleitung zur Funktion osslscriptsgit

Beschreibung

Die Funktion osslscriptsgit verwaltet OSSL-Beispielskripte für OpenSimulator aus einem GitHub-Repository. Sie ermöglicht sowohl Neuinstallationen als auch Aktualisierungen der Skriptsammlung.

Funktionsweise

Grundlegende Operationen

1. Abfrage der gewünschten Aktion (Update oder Neuinstallation)
2. Durchführung der Git-Operationen
3. Automatische Branch-Erkennung
4. Kopieren der Skripte in die OpenSimulator-Verzeichnisse

Benutzerinteraktion

Installationsoptionen

Möchten Sie die OpenSim OSSL Beispiel-Skripte vom GitHub verwenden oder aktualisieren? ([upgrade]/new)

Option "new" (Neuinstallation)

1. Löscht vorhandene Version (falls existent)

2. Klont das Repository neu:

   git clone https://github.com/ManfredAabye/opensim-ossl-example-scripts.git opensim-ossl-example-scripts
   

Option "upgrade" (Update)

1. Prüft vorhandenes Repository

2. Ermittelt automatisch den Hauptbranch

3. Führt git pull durch:

   branch_name=$(git symbolic-ref refs/remotes/origin/HEAD | sed 's@^refs/remotes/origin/@@')
   git pull origin "$branch_name"
   

Dateiverwaltung

Zielverzeichnisse

Die Funktion erstellt folgende Verzeichnisse falls nicht vorhanden:

• opensim/bin/assets/
• opensim/bin/inventory/

Kopiervorgänge

1. ScriptsAssetSet → opensim/bin/assets/
2. ScriptsLibrary → opensim/bin/inventory/

Fehlerbehandlung

• Verzeichniswechsel-Fehler werden abgefangen
• Fehlende Quellverzeichnisse werden gemeldet
• Ungültige Eingaben führen zum Abbruch

Systemvoraussetzungen

• Installiertes Git
• Bash-Umgebung mit definierten Variablen:
  • Farbvariablen (COLOR_HEADING, COLOR_LABEL, etc.)
  • Symbolvariablen (SYM_OK, SYM_BAD)
• Schreibrechte in den Zielverzeichnissen
• Funktion blankline muss verfügbar sein

Verwendung

Einfacher Aufruf der Funktion:

osslscriptsgit

Empfohlene Vorgehensweise

1. Regelmäßige Updates mit der "upgrade"-Option
2. Bei Problemen mit der Skriptsammlung "new" verwenden
3. Vor größeren Änderungen Backup der bestehenden Skripte

Wichtige Hinweise

• Die Funktion ändert nur die Beispielskripte
• Eigene Skripte werden nicht überschrieben
• Bei Abbruch wird kein System verändert
• Fehlermeldungen geben klare Hinweise auf Probleme

Typische Fehlerszenarien

1. Fehlende Git-Installation:

   sudo apt-get install git
   

2. Fehlende Schreibrechte:

   chmod -R u+w opensim/bin/
   

3. Netzwerkprobleme:

   Überprüfen Sie die Internetverbindung
   

Ein Metaversum sind viele kleine Räume, die nahtlos aneinander passen, sowie direkt sichtbar und begehbar sind, als wäre es aus einem Guss.