Inhalt → Erste Schritte

• Schnell-Einstieg | Schritt-für-Schritt-Anleitungen | Rocrail unter Windows installieren | Rocrail unter Linux installieren | Video-Anleitungen | Die Demobahn

Rocrail wird für Windows als ZIP-Datei mit - unter anderen - folgenden Vorteilen bereitgestellt:

• Keine Installation¹⁾ im klassischen Sinne - nur Entpacken und loslegen.
• Entpacken an (fast) beliebige Orte auf dem Rechner.
• Keine aktive²⁾ Veränderung der Windows-Registry - gefahrloses Ausprobieren und spurloses Löschen möglich.
• Alle Dateien an einem Ort.
• Installation auf einem geeigneten USB-Stick oder portablen Laufwerk. Dies ermöglicht bequemes Editieren am Arbeitsplatz und Anlagenbetrieb an entferntem Ort (z. B. Keller, Clubheim), ohne Dateien kopieren oder abgleichen zu müssen.
• Einfaches Kopieren der gesamten Installation auf einen USB-Stick oder anderes tragbares Laufwerk zur Mitnahme beispielsweise zu Bekannten oder einem Rocrail-Stammtisch zwecks Vorstellung, Diskussion, Analyse und dem Erhalt von Hilfe.
• Verschieben einer Installation auf einen neuen Rechner, auf ein anderes Laufwerk etc. problemlos und mit wenigen Klicks möglich.

Rocrail ist auf Windows-Versionen ab Windows XP lauffähig.

• Windows XP, Vista werden im Forum nicht mehr unterstützt! Installation ggf. möglich, es wird davon abgeraten, diese Versionen zu verwenden.
• Windows 7, 8, 8.1 werden begrenzt unterstützt³⁾.
• Windows 10.
• Windows 11.

Die folgenden Kapitel beziehen sich auf das aktuelle Windows 10 bzw. 11.

Die folgenden beiden Punkte sind unbedingt zu beachten:

1. Sonderzeichen, wie Umlaute, sollten generell vermieden werden. Dies gilt für Windows-Benutzernamen, Ordner-Namen der Rocrail-Installation und ggf. übergeordneter Ordner, sowie Dateinamen z. B. von Lokbildern etc.
   Enthält der Windows-Benutzername Umlaute, so kann die ordnungsgemäße Installation daran scheitern!
   
   Durch jeweiliges Entfernen des Hakens bei UTF-8 in den Rocrail-Einstellungen Allgemein und den Rocview-Einstellungen Allgemein werden Sonderzeichen unter Windows teilweise unterstützt⁴⁾.
   
   
2. Wenn Antivirus-, Anti-Malware- bzw. Firewall-Programme von Drittanbietern verwendete werden, liegt es vollständig in der Verantwortung des Benutzers, diese so zu konfigurieren, dass sie einer ordnungsgemäßen Installation und der ordnungsgemäßen Funktion von Rocrail und seinen Komponenten nicht im Wege stehen!
   Im Zweifelsfalle sind solche Programme zu deaktivieren.
   
   Ab Windows Version 10 gelten derartige Zusatzprogramme allgemein als unnötig im privaten Umfeld.

Dieses Kapitel beschreibt das erstmalige Herunterladen und Installieren von Rocrail.

Für Umsteiger von einer bestehenden, mit einer setup.exe erstellten Alt-Installation auf den Zip-Installer, steht eine gesonderte Anleitung bereit, siehe Umstieg auf ZIP-Installer unter Windows

Die tagesaktuelle ZIP-Datei von der Seite Rocrail Daily Builds herunterladen:
Auf der linken Seite unterhalb von Rocrail ZIP entweder die Datei Rocrail-WIN64.zip (für ein 64bit-System) oder Rocrail-WIN32.zip (für ein älteres 32bit System) anklicken.

Durch eine Linksklick wird die Datei abhängig vom verwendeten Browser in einem zentralen Download-Verzeichnis gespeichert oder es öffnet sich ein Dialog, mit Hilfe dessen der gewünschte Ablageort angegeben werden kann. Alternativ kann durch einen Rechtsklick und der Wahl von Ziel speichern unter… ein beliebiger Ablageort festgelegt werden. Den Ablageort merken bzw. notieren.

Die heruntergeladene ZIP-Datei im Dateisystem am vorher notierten Speicherort aufsuchen - hier wurde sie auf dem Desktop abgelegt.

ZIP-Datei

Das Kontextmenü der Datei öffnen (Rechtsklick auf die Datei) und den Punkt Alle extrahieren… auswählen.

Hinweis: Die folgenden Schritte werden anhand des in Windows enthaltenen Entpackers beschrieben. Wenn Drittanbietersoftware zum Entpacken installiert wurde, liegt es in der Verantwortung des Benutzers, mit dieser Software entsprechende, gleichwertige Operationen auszuführen.

Kontext-Menü

Es öffnet sich der folgende Dialog:

Dialog ZIP-komprimierte Ordner extrahieren

Dieser Dialog zeigt im Feld unterhalb von Dateien werden in diesen Ordner extrahiert: den momentanen Speicherort der Datei an.

Das Häkchen bei Dateien nach Extrahierung anzeigen setzen, falls diese Option nicht schon aktiv ist.
Anstelle des angezeigten Ordners muss nun der Ordner festgelegt werden, in den Rocrail installiert werden soll. Dazu zunächst auf die Schaltfläche Durchsuchen… klicken.

Nach dem Klicken auf Durchsuchen… öffnet Windows den Dialog Ziel auswählen:

Ziel auswählen

Wie in der Abbildung zu sehen, sollte nun der Ordner Dokumente geöffnet werden. Danach durch Klicken auf die Schaltfläche Neuer Ordner einen neuen Ordner erstellen und diesem den Namen Rocrail geben. Abschließend mit der Schaltfläche Ordner auswählen bestätigen.

Windows springt dadurch zurück zum Dialog ZIP-komprimierte Ordner extrahieren, der nun wie im folgenden Abschnitt beschrieben aussehen sollte.

Dialog ZIP-komprimierte Ordner extrahieren mit Zielordner C:\Users\<Benutzername>\Documents\Rocrail

Im Anschluss auf Extrahieren klicken.
Die Dateien werden nun extrahiert. Dieser Prozess kann - abhängig von Betriebssystemeinstellungen, dem Windows Defender und der Rechner-Leistung - eine Weile dauern. Währenddessen zeigt Windows den Fortschritt an:

Fortschritts-Grafik in der Ansicht Mehr Details

Nach erfolgtem Extrahieren zeigt Windows als Ergebnis den Inhalt im neu erstellten Ordner an:

Typisches Ergebnis nach dem Extrahieren. Der genaue Ordner-Inhalt kann sich von Zeit zu Zeit mit der Weiterentwicklung von Rocrail ändern.

Damit ist die Installation als solche abgeschlossen. Abschließend muss noch eine Verknüpfung auf dem Desktop erstellt werden.

Wenn das Extrahieren der Dateien mit den obigen Einstellungen erfolgt ist, wurde automatisch der Ordner Rocrail geöffnet⁶⁾:

In diesem Ordner befindet sich die Datei desktoplink.cmd⁷⁾. Ein Doppelklick darauf erstellt eine gültige Verknüpfung Rocview auf dem Desktop. Meldungen des Windows-Defender wie im folgenden Kapitel beschrieben behandeln.

Rocview Desktop-Symbol

Hinweis: Sollte die Desktop-Verknüpfung auf dem System mit dieser Prozedur nicht angelegt werden können, so muss die im Ordner Rocrail erstellte Verknüpfung mit dem Namen Rocview (erkennbar am oben gezeigten Symbol) manuell auf den Desktop kopiert werden.

Tipp: Die Verknüpfung kann bei Bedarf z. B. an die Taskleiste oder an "Start" angeheftet werden.

Beim Erstellen der Verknüpfung, beim ersten Start von Rocview und beim ersten Start des Rocrail-Servers können jeweils Warnungen des Windows-Defenders angezeigt werden. Dies gilt auch nach Updates. Die Warnungen sind folgendermaßen zu behandeln:

Auf "Weitere Informationen" klicken. Der Dialog ändert sich, wie rechts dargestellt	Im zweiten Schritt Schaltfläche "Trotzdem ausführen" anklicken.

Rocrail entwickelt sich ständig weiter und sollte stets auf einem aktuellen Stand gehalten werden. Für regelmäßige, beispielsweise monatliche Updates, empfiehlt es sich, die Installation vollständig zu aktualisieren. Siehe dazu den folgenden Abschnitt.

In einigen Fällen ist es sinnvoll, der aktuellen Entwicklung durch häufigere Updates, beispielsweise ein- bis zweimal pro Woche oder sogar täglich zu folgen. Solche Updates können sich auf wesentliche Programmteile beschränken, siehe Abschnitt Schnelles Update.

Hinweis: Vor jedem Update Rocrail vollständig beenden!

• Eine aktuelle ZIP-Datei herunterladen (Kapitel 1.1).
• Entpacken vorbereiten (Abschnitt 1.2.1).
• Das Häkchen bei Dateien nach Extrahierung anzeigen entfernen (optional).
• Auf die Schaltfläche Durchsuchen klicken.

Es öffnet sich ein weiterer Dialog:

Dialog Ziel auswählen

In diesem Dialog den Ordner auswählen, in dem Rocrail bisher installiert war. Im Normalfall ist dies der Ordner Rocrail unter Dokumente.
Den Ordner, wie in der Abbildung gezeigt, markieren und auf die Schaltfläche Ordner auswählen klicken.

• Mit dem Abschnitt Entpacken fortfahren.

Nachdem alle Dateien extrahiert wurden, wird Windows fragen, wie mit bereits vorhandenen Dateien umzugehen ist:

Dialog Dateien ersetzen oder überspringen

In diesem Dialog muss dazu auf Dateien im Ziel ersetzen geklickt werden.
Damit ist das Update abgeschlossen.

• Eine aktuelle ZIP-Datei herunterladen (Kapitel 1.1).
• Die heruntergeladene ZIP-Datei durch einen Doppelklick darauf öffnen.

Den Ordner bin durch einen Rechtsklick darauf und Wahl von Alle extrahieren… zum Extrahieren vorbereiten.

Ordner bin extrahieren

Achtung: Der Rechtsklick muss rechts neben dem Text bin erfolgen, nicht auf dem Text und nicht auf dem Ordnersymbol, da ansonsten ein anderes Kontextmenü gezeigt wird. Der Ordner darf zuvor nicht (durch einen Linksklick) aktiviert worden sein, ansonsten steht das Kontextmenü mit Alle extrahieren… ebenfalls nicht zur Verfügung.

Es öffnet sich der Dialog ZIP-komprimierte Ordner extrahieren.

• Das Häkchen bei Dateien nach Extrahierung anzeigen entfernen (optional).
• Auf die Schaltfläche Durchsuchen klicken.

Den Ordner Rocrail aufsuchen, in den die Installation entpackt wurde (im Beispiel dieser Seite: C:\Users\<Benutzername>\Documents\Rocrail). Den Ordner durch Doppelklick öffnen. Den enthaltenen Ordner bin, wie in der folgenden Abbildung gezeigt, markieren und auf die Schaltfläche Ordner auswählen klicken.

Ordner bin auswählen

Windows springt zurück zum Dialog ZIP-komprimierte Ordner extrahieren, in dem als Ziel jetzt C:\Users\<Benutzername>\Documents\Rocrail\bin eingetragen sein sollte.

• Auf die Schaltfläche Extrahieren klicken.
• Überschreiben vorhandener Dateien wie im Abschnitt Vollständiges Update beschrieben bestätigen.

Rocrail-ZIP-Installationen lassen sich einfach verschieben, indem der Ordner, in den Rocrail entpackt wurde, an den gewünschten Ort verschoben wird. Im Beispiel dieser Seite wurde Rocrail in den Ordner Rocrail unter Dokumente entpackt.

Tipp: Genauso einfach lässt sich eine Rocrail-ZIP-Installationen zur Sicherung oder zur Mitnahme an einen anderen Ort kopieren, beispielsweise auf einen mobilen Datenträger (Festplatte, USB-Stick usw.).

Hinweise: Voraussetzung ist, dass alle zu Rocrail gehörenden Dateien und Daten innerhalb des Ordners Rocrail abgelegt werden. Das gilt beispielsweise für Arbeitsbereiche, Lok-Bilder, selbst erstellte SVG-Themenordner etc.
Nachträglich eingefügte absolute Pfade⁸⁾ (daran erkennbar, dass sie mit einem Laufwerksbuchstaben beginnen, wie C:\Users\…) müssen nach dem Verschieben/Kopieren in der Regel angepasst werden, da diese Bezüge verloren gehen.

1. Den Ordner Rocrail aus Dokumente an den gewünschten Platz auf dem Rechner, beispielsweise ein zweites internes Laufwerk, verschieben.
2. Nach dem Verschieben die Datei desktoplink.cmd erneut ausführen.

Hinweis: Eine vorhandene Desktop-Verknüpfung wird durch Ausführen von desktoplink.cmd aktualisiert und ist damit gültig. Wurde die alte Verknüpfung an die Taskleiste und/oder "Start" angeheftet, so müssen diese angehefteten Verknüpfungen erneuert werden, da sie nicht mehr gültig sind: Mit der rechten Maustaste auf die angehefteten Verknüpfungen klicken und Von Taskleiste lösen bzw. Von "Start" lösen auswählen. Bei Bedarf anschließend die neue Desktop-Verknüpfung wieder an die Tastkleiste und/oder "Start" anheften.

Verschieben der ZIP-Installation auf einen anderen Windows-Rechner erfolgt auf die gleiche Weise, wie oben beschrieben.

Hinweis: Eine 64bit-Installation läuft jedoch nur auf 64bit-Rechnern! Rocrail 32bit kann sowohl auf 32bit- als auch auf 64bit-Rechnern verwendet werden.

Bei der Anbindung von Hardware, z. B. Zentrale(n), ist sicherzustellen, dass die Anschlusseinstellungen (z. B. COM-Ports, IP-Adressen, etc.) an die neuen Verhältnisse angepasst werden. Anpassungen sind ggf. zusätzlich auch innerhalb der Zentrale notwendig, wenn dort beispielsweise die IP-Adresse des Rocrail-Servers eingetragen werden muss.