Table of Contents
Rocrail ZIP
Einführung
Rocrail ZIP wird als ZIP-Archiv bereitgestellt und kann von der Daily Build-Website heruntergeladen werden.
Rocrail ZIP ermöglicht die "Installation" 1) an (fast) jedem beliebigen Ort auf dem Computer: Beispielsweise auf dem Desktop, auf einem zweiten internen Laufwerk usw. Alle von Rocrail benötigten Dateien sind dabei in einem Ordner zusammengefasst, es gibt keine außerhalb dieses Ordners angelegten oder versteckten Dateien (mit Ausnahme des optionalen Desktop-Symbols).
Bei ausreichender Speicher-Größe 2) kann die ZIP-Datei auch komplett auf einen Speicher-Stick entpackt werden.
Das ermöglicht eine portable Verwendung auf wechselnder Hardware mit gleichem Betriebssystem.
Wichtige Hinweise:
- Sicherheitskopien eigener Arbeitsbereiche anlegen.
- Vorherige Rocrail-Installation deinstallieren, wenn
Setup.exe
verwendet wurde. - Damit ein späteres Update die Dateien nicht überschreibt, die evtl. für eigene Zwecke modifiziert wurden (Bilder, SVG, Decspecs usw.), müssen diese mit geänderten Dateinamen oder in ein separates Verzeichnis gespeichert werden.
- Werden die User- und AmericanThemes benötigt, sind die entsprechenden ZIP-Dateien separat zu entpacken; üblicherweise in das svg-Verzeichnis.
- Ggf. müssen in den Rocview- und Rocrail-Eigenschaften vorhandene Pfad-Angaben an geänderte Speicherorte angepasst werden.
Anleitungsvideos
Entpacken und Starten
macOS
Den richtigen Installer für den eigenen Mac auswählen:
CPU | Installer ZIP | Hinweis |
---|---|---|
Intel | Catalina, Sierra, ElCapitan, Leopard | Das Catalina-Build laüft auch auf neueren macOS-Intel-Versionen. |
Apple Silicon M1/M2/M3 | Sonoma |
- Doppel-Klick auf die ZIP-Datei um sie zu entpacken.
- Die Rocrail.app zum eigenen Anwendungs-Ordner verschieben oder kopieren. ( /Users/<username>/Applications )
Nach jedem Download sind aus Sicherheitsgründen folgende Schritte notwendig:
- Das Rocrail.app-Kontextmenü im Finder und "Öffnen" auswählen.
- Auf "Öffen" klicken, nachdem das Popup mit "Sind Sie sicher, dass Sie es öffnen möchten?".
Windows
Hilfe zum Umstieg von einer klassischen Installation auf die Installation mit einer ZIP-Datei: Umstieg auf ZIP-Installer Schritt für Schritt erklärt |
Das ZIP-Archiv einfach in ein Verzeichnis der Wahl entpacken und mit Doppelklick auf die Skriptdatei desktoplink.cmd 3) eine Verknüpfung von Rocview auf dem Desktop anlegen. Rocview durch Doppelklick auf das Desktop-Symbol starten. Einen Arbeitsbereich auswählen, um den Rocrail-Server zu starten.
Eine ausführliche Installationsanleitung findet sich unter Rocrail unter Windows installieren
Linux
Das ZIP-Archiv einfach in das home-Verzeichnis entpacken (nicht in das system-Verzeichnis kopieren) und mit einem Doppelklick die Skriptdatei desktoplink.sh aufrufen, die eine Verknüpfung auf dem Desktop einrichtet.
- Hinweis: Rocrail-ZIP-Installieren unter Gnome
Builds
Mit dieser Tabelle prüfen, welcher Build mit der Ziel-Linux-Distribution kompatibel ist:
Build | Kompatibel mit | Architektur |
---|---|---|
Debian 11 | Debian 12, LMDE 5, Mint 20, Manjaro LTS, Ubuntu 20, Ubuntu 22, openSUSE 15 | i386, AMD64, x86_64 |
Terminal
Wenn der Datei-Explorer die Script-Dateien in einem Editor öffnet, ist es einfacher ein Terminal zu öffnen und in das Verzeichnis mit der ZIP-Datei zu wechslen.
Dann folgende Befehle eingeben: (Die gleiche Reihenfolge kann auch beim Update verwendet werden.)
cd unzip -u -d Rocrail Downloads/Rocrail*.zip cd Rocrail ./desktoplink.sh
Zugriff Serielle Geräte
Benutzer zur Gruppe dialout
hinzufügen: FAQ
Gnome Desktop
Wenn das Rocview Desktop-Symbol nicht angezeigt wird, ist eine Erweiterung erforderlich.
Dazu ein Terminalfenster öffnen und die folgenden Befehle eingeben:
sudo apt install gnome-tweaks sudo apt install gnome-shell-extension-desktop-icons gnome-tweaks
Nach dem Öffnen von Gnome Tweaks in der linken Spalte "Extensions (Erweiterungen)" auswählen und "Desktop icons (Desktop-Symbole)" aktivieren.
Das Rocview Desktop-Symbol sieht zunächst wie ein Textdokument aus.
Durch Klicken mit der rechten Maustaste auf dieses Symbol das Kontextmenü öffnen und "Allow Launching (Start zulassen)" aktivieren.
Taskleiste
Um Rocview im Taskleistenbereich anheften zu können, muss die Datei Rocview.desktop in das Anwendungsverzeichnis kopiert werden:
sudo cp ~/Desktop/Rocview.desktop /usr/share/applications
Im Startmenü nach Rocview suchen und starten. Jetzt kann das Rocrail-Symbol auf der Taskleiste angeheftet werden.
Hinweis: Auf einigen Systemen hat das Desktop-Verzeichnis einen anderen Namen wie Schreibtisch. (Abhängig von der ausgewählten Sprache.)
Raspberry Pi
Builds
Mit dieser Tabelle prüfen, welcher Build mit der Ziel-Linux-Distribution kompatibel ist:
Build | Kompatibel mit | Architektur | Hersteller |
---|---|---|---|
PiOS11 | Ubuntu 20, Ubuntu 22, Manjaro, Armbian 22 | ARMHF, ARM64 | Raspberry Pi, Odroid |
Update
macOS
- Aktuelles ZIP-Archiv herunterladen.
- Doppel-Klick auf die ZIP-Datei um sie zu entpacken.
- Die Rocrail.app zum eigenen Anwendungs-Ordner verschieben oder kopieren. ( /Users/<username>/Applications )
- Für Öffnen der Anwendung siehe Entpacken und Starten macOS
Windows
Wichtiger Hinweis:
Damit ein Update die Dateien nicht überschreibt, die evtl. für eigene Zwecke modifiziert wurden (Bilder, SVG, Decspecs usw.), müssen die Dateien in einem separaten Verzeichnis gespeichert oder die Dateinamen geändert werden.
- Ein aktuelles ZIP-Archiv herunterladen.
- Das ZIP-Archiv mit allen Verzeichnissen und Dateien in das Rocrail-Verzeichnis extrahieren.
Erweiterte Update-Option
Nur für erfahrene Benutzer mit ausreichenden Windows-Kenntnissen |
- Ein aktuelles ZIP-Archiv herunterladen.
- Nur das bin-Verzeichnis aus dem ZIP-Archiv in das Rocrail-Verzeichnis extrahieren.
Damit werden nur Rocview, Rocrail-Server und Bibliotheken aktualisiert.
- Wichtiger Hinweis:
Da auch Dateien in anderen Verzeichnissen (svg, decpecs, …) unregelmäßig aktualisiert und erweitert werden, wird dringend empfohlen, öfter auch komplette Updates auszuführen.
Demo- und Wiki-Plan
Laden des Demo-Plans: In Rocview über Menü → Datei → Demo-Arbeitsbereich.
Laden des Wiki-Demo-Plans: In Rocview über Menü → Datei → Arbeitsbereich öffnen… das Verzeichnis wikidemo auswählen.
- Hinweis: Ist bereits ein Arbeitsbereich aktiv, muss in einem Dialog das Beenden des Servers bestätigt werden.
Verzeichnisstruktur
Windows / Linux
Rocrail ├───desktoplink.cmd (Windows -- Icon auf dem Desktop) ├───rocview.cmd (Windows -- Rocview und Server) ├───readme.txt (Informationen) ├───start.html (Start-Hilfe mit Links zu den stepbystep-xx-Wiki-Seiten) ├───revision-xxxxx.info (Revisions-Nummer und die letzen 500+-Revisionen) ├───desktoplink.sh (Linux -- Icon auf dem Desktop) ├───rocrail.png (Linux -- Rocrail-Icon) ├───rocview.sh (Linux -- Rocview und Server) ├───rocrail.sh (Linux -- Nur Server) ├───startrocrail.sh (Linux -- Skript für verwendung mit crontab; Kopieren oder symlink nach ~) ├───initdefault.sh (Linux -- Initialisieren des Standardarbeitsbereichs mit symbolischen Links zu: svg, web, images, decspec) ├───update.sh (Linux -- Rocrail-Update durch Server-Monitor) ├───sysupdate.sh (Linux -- OS-Update durch Server-Monitor) ├───default (Standardmäßige leerer Arbeitsbereich im Fall von crontab und/oder Server-Monitor) ├───web (Rocweb-Daten) ├───wikidemo (alternativer Demo-Arbeitsbereich) | └───plan.xml (Wiki-Demo-Plan) ├───demo (Standard-Demo-Arbeitsbereich) | └───plan.xml (größerer Plan mit Schattenbahnhof) ├───bin (Ausführbare Dateien und Bibliotheken) ├───decspecs (RocPro-Decoder-Daten) ├───stylesheets (Doku-Formate) ├───images (Bild-/Symbol-Dateien Loks, Wagen, ...) └───svg (Themen-Verzeichnisse) └───themes ├───Accessories ├───CTC ├───Roads ├───SLIM ├───SLIM-COLOR └───SpDrS60
- Hinweis: Die einzelnen "Rocrail ZIP"-Archive enthalten nur die für das jeweilige Betriebsystem relevanten Teile der obigen Verzeichnisstruktur
macOS
Rocrail.app └───Contents ├───_CodeSignature (Optional code signing with Apple Developer ID) ├───Frameworks (Libraries *.dylib) ├───MacOS | ├───Run | ├───rocrail | └───rocview ├───Resources | ├───Rocrail.icns | ├───data | | ├───decspecs (Rocpro decoder specification) | | ├───stylesheets (Docu formats) | | ├───images (Pictures: Symbols, Locs, Wagon, ...) | | ├───web (Rocweb data) | | └───svg (Scalable Vector Graphics) | | └───themes | | ├───Accessories | | ├───CTC | | ├───Roads | | ├───SLIM | | ├───SLIM-COLOR | | └───SpDrS60 | └───demo | | └───plan.xml | └───wikidemo | └───plan.xml └───Info.plist
Der Run-Befehl erzeugt die folgende lokale Verzeichnis-Struktur:
~/rocrail ├───decspecs ├───images ├───stylesheets ├───svg ├───web ├───wikidemo (Wiki plan) └───plan.xml (Demo plan)
Neuere Dateien in der Rocrail.app
überschreiben die existierenden Dateien im ~/rocrail
-Verzeichnis mit Ausnahme der ~/rocrail/plan.xml
.
- Lokale Benutzer-SVGs in eigenem Verzeichnis speichern.
- Einen separaten Arbeitsbereich für die eigene
plan.xml
verwenden.
Fehlerbehebung unter Linux
Wayland
Für den Wayland-Window-Manager gelten folgende Einschränkungen:
- Rocview kann seine internen Fenster nicht korrekt wiederherstellen, wenn die Option für die vertikale Werkzeugleiste aktiviert ist.
- Das Wiederherstellen von Fenster- und Dialogpositionen ist nicht möglich.
Lösung
Die Exec-Zeile in der Desktop-Datei ändern auf:
Exec=env GDK_BACKEND=x11 ....
Serieller Gerätezugriff
Den Benutzer zur dialout-Gruppe hinzufügen; siehe: Häufige Fragen
.cmd
nicht angezeigt. Siehe: Häufige Fragen