User Tools

Site Tools


rocrailonastick-en

Rocrail ZIP

Introduction

'Rocrail ZIP' is provided as ZIP archive, and can be downloaded from the Daily Build site.

Rocrail ZIP allows to "install"1) to (almost) any location on the computer: For example, on the desktop, on a second internal drive, etc. All files needed by Rocrail are stored in one folder; there are no files created or hidden outside this folder (except the optional desktop icon).

If enough memory2) is available, the ZIP file can even be unzipped to a memory stick.
This allows portable usage on changing hardware, but with the same operating system.

Important Notes:

  1. Backup your workspaces.
  2. Deinstall a previous Rocrail installation if the Setup.exe was used.
  3. In order for an update not to overwrite files modified for own purposes (Images, SVG, Decspecs etc.), these must be saved with changed file names or in a separate directory
  4. The User- and AmericanThemes, if needed must be unzipped separately, usually in the "svg" folder.


Instruction Videos

Unzipping and Starting

Windows

Help for switching from a classic installation to the installation with a ZIP file: Switching to ZIP installer explained step by step.

Simply unpack the ZIP archive into a directory of choice and double-click on the script file desktoplink.cmd to create a shortcut of Rocview on the desktop. A workspace can be selected to start the server.

When starting for the first time a safety warning from Windows Defender may be displayed (screenshot). First, the text More info has to be clicked, then in the modified dialogue (screenshot) button Run anyway has to be clicked.

Detailed installation instructions can be found under Install Rocrail under Windows

Linux

For an initial Rocrail installation, the dependency wxWidgets need to be installed. These commands are included in installwx.sh.
Just unzip it in the home directory (not copied to the system) and double click on the desktoplink.sh to create a Rocview Desktop shortcut with all needed parameters to startup a workspace..

Terminal

If the file explorer opens the script files in an editor, its easier to open a terminal, and change the directory into the place where the ZIP file is located. Then issue following commands: (The same sequence can also be used for updating.)

cd 
unzip -u -d Rocrail Downloads/Rocrail*.zip
cd Rocrail
./desktoplink.sh

If the wxWidgets library is not yet installed:

./installwx.sh

Gnome Desktop

An extension is needed if the Rocview Desktop Icon does not appear.
Open a terminal window and type in the following commands:

sudo apt install gnome-tweaks
sudo apt install gnome-shell-extension-desktop-icons
gnome-tweaks

After Gnome Tweaks did open, select in the left column "Extensions", and activate "Desktop icons".
The Rocview Desktop Icon will at first look like a text document. Activate in the context menu, right click on this icon, and activate "Allow Launching".


Update

Important Note:
In order for an update not to overwrite files modified for own purposes (Images, SVG, Decspecs etc.), these must be saved with changed file names or in a separate directory.

  1. Download a current ZIP-Archive.
  2. Copy or move the new ZIP in the folder in which the Rocrail folder remains. (not in this Rocrail folder!)
  3. Extract all files.
  4. Confirm the following question "Replace the files in the destination":


Advanced Update Option

  1. Download a current ZIP-Archive.
  2. Copy or move the new ZIP in the folder in which the Rocrail folder remains. (not in this Rocrail folder!)
  3. Extract only the BIN file, this updates only the Rocrail Server and Rocview.
  4. Confirm the following question "Replace the files in the destination":
  • Important note:
    As files in other directories (svg, decpecs, …) are also updated and expanded irregularly, it is strongly recommended to carry out complete updates more often.


Demo and Wiki Plans

To access the Demo plan select File→Demo Workspace.
To access the Wiki Demo plan select File→Open Workspace (in this directory look for the wikidemo folder and select.)

  • Note: If a workspace is active, then the termination of the server must be confirmed.


Directory structure

Rocrail
├───desktoplink.cmd     (Windows -- Icon on the desktop)
├───rocview.cmd         (Windows -- Rocview and Server)
├───readme.txt          (Information)
├───revision-xxxxx.info (Revision number and the last 500+ revisions)
├───desktoplink.sh      (Linux   -- Icon on the desktop)
├───installwx.sh        (Linux   -- Install wxWidget)
├───rocctrl.png         (Linux   -- Rocrail server icon)
├───rocrail.png         (Linux   -- Rocrail icon)
├───rocview.sh          (Linux   -- Rocview and Server)
├───rocrail.sh          (Linux   -- Server only)
├───web                 (Rocweb data)
├───wikidemo          
|   └───plan.xml        (wiki demo plan)
├───demo                (default demo workspace)
|   └───plan.xml        (larger plan with shadow station)
├───bin                 (Client/Server/Libraries - exe and dll)
├───decspecs            (Rocpro decoder specification)
├───stylesheets         (Docu formats)
├───images              (Pictures: Symbols, Locs, Wagon, ...)
└───svg                 (Scalable Vector Graphics)
    ├───userthemes.zip
    ├───americanthemes.zip
    └───themes
        ├───Accessories
        ├───Roads
        ├───SLIM
        ├───SLIM-COLOR
        └───SpDrS60
  • Note: The individual "Rocrail Zip" ZIP archives contain only the parts of the Directory structure above
    that are relevant for the respective Operating system.
1)
Rocrail ZIP is not actually installed, but only unzipped
2)
For WIN64 with the ZIP files and all themes about 120 MByte
rocrailonastick-en.txt · Last modified: 2020/07/18 12:00 by rjversluis