User Tools

Site Tools


rocrailonastick-en

Rocrail on a Stick

Introduction

'Rocrail on a Stick' is provided as ZIP archive, and can be downloaded from the Daily Build site.
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.
The User- and AmericanThemes, if needed must be unzipped separately, usually in the "svg" folder.

Windows

Just unzip it in a directory and double click on the rocview.cmd. This starts Rocview; A workspace can be selected to start the Server.
For ease of use in the future, create a shortcut on the desktop or taskbar by double-clicking on the desktoplink.cmd.

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 rocview.sh script file which will start Rocview with the necessary command line options. A Workspace can be activated after Rocview is up and running.
For ease of use in the future, create a shortcut on the desktop or taskbar by double-clicking on the desktoplink.sh.
Only want to start the server? Then use "bin/rocrail -l bin" command, this command is contained in rocrail.sh.

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

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 on a Stick" ZIP archives contain only the parts of the Directory structure above
    that are relevant for the respective Operating system.

Tip

With sufficient memory size1) the Zip file can also be completely unpacked on a memory stick.
This allows for portable use on changing hardware, but the same operating system.

1)
For WIN64 with the ZIP files and all themes about 120 MB
rocrailonastick-en.txt · Last modified: 2019/08/13 11:53 by smitt48