User Tools

Site Tools


rocrailonastick-de

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:

  1. Sicherheitskopien eigener Arbeitsbereiche anlegen.
  2. Vorherige Rocrail-Installation deinstallieren, wenn Setup.exe verwendet wurde.
  3. 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.
  4. Werden die User- und AmericanThemes benötigt, sind die entsprechenden ZIP-Dateien separat zu entpacken; üblicherweise in das svg-Verzeichnis.
  5. 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
  1. Doppel-Klick auf die ZIP-Datei um sie zu entpacken.
  2. Die Rocrail.app zum eigenen Anwendungs-Ordner verschieben oder kopieren. ( /Users/<username>/Applications )

Nach jedem Download sind aus Sicherheitsgründen folgende Schritte notwendig:

  1. Das Rocrail.app-Kontextmenü im Finder und "Öffnen" auswählen.
  2. Auf "Öffen" klicken, nachdem das Popup mit "Sind Sie sicher, dass Sie es öffnen möchten?".
macos-open-rocrail-1.jpg macos-open-rocrail-2.jpg macos-open-rocrail-3.jpg
Nach Download wird der erste Doppel-Klick blockiert. Im Finder das Kontext-Menü öffnen und "Öffnen" auswählen. Bestätigen, um die Anwendung zu öffnen.

Alternativ die Security verwenden:


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.

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.
Cinnamon
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

  1. Aktuelles ZIP-Archiv herunterladen.
  2. Doppel-Klick auf die ZIP-Datei um sie zu entpacken.
  3. Die Rocrail.app zum eigenen Anwendungs-Ordner verschieben oder kopieren. ( /Users/<username>/Applications )
  4. 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.

  1. Ein aktuelles ZIP-Archiv herunterladen.
  2. Das ZIP-Archiv mit allen Verzeichnissen und Dateien in das Rocrail-Verzeichnis extrahieren.
  3. Die folgende Abfrage "Dateien im Ziel ersetzen" bestätigen:

Erweiterte Update-Option

:!: Nur für erfahrene Benutzer mit ausreichenden Windows-Kenntnissen
  1. Ein aktuelles ZIP-Archiv herunterladen.
  2. Nur das bin-Verzeichnis aus dem ZIP-Archiv in das Rocrail-Verzeichnis extrahieren.
    Damit werden nur Rocview, Rocrail-Server und Bibliotheken aktualisiert.
  3. Die folgende Abfrage "Dateien im Ziel ersetzen" bestätigen:
  • 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

Demo-Plan Wiki-Demo-Plan
"Schritt-für-Schritt-Anleitung"

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

1)
Rocrail ZIP wird nicht im eigentlichen Sinne installiert, sondern lediglich entpackt
2)
Für WIN64 mit den ZIP-Dateien und allen SVG-Themen ca. 120 MByte
3)
Abhängig von der Windows-Installation wird das .cmd nicht angezeigt. Siehe: Häufige Fragen
rocrailonastick-de.txt · Last modified: 2024/03/14 00:33 by rainerk