Content → Rocrail Server → Configuration

• General | Trace | Service | Automatic | Controller | R2Rnet | RocWeb | Finder | Command Mapping

Notes:

• A restart of the server is required in order the changes to take effect.
• Blanks and special characters (like üäöß) in paths and filenames are not supported.

The current track plan file name.
With the button [ . . . ] a file chooser dialog is started.

This file will be used to record all block occupancies and other useful information at runtime for recovery purpose.
With the button [ . . . ] a file chooser dialog is started.
If this file name is not set, the recovery block occupancy will be disabled, and is only written at shutdown in the track plan file.

The XML file containing all locomotives, cars and operators.
This field is optional and default blank.
Without defining this file the locomotives, cars and operators are saved in the track plan file.
If a file name is entered, Rocrail has to be restarted. After that with "File / Save" the plan file is saved and the locomotive definitions are moved to the newly defined locomotive file.
The button [ . . . ] may be used to choose the locomotive definitions from an already existing file.

If the file name does not exist the Rocrail server will create it at next restart.

This option will create the backup directory if it is not already present and copies the previous track plan file, prefixed with a time stamp, in this directory.

Number of backup files to keep in the backup directory.
The default for this value is 100 files. Range: 10…10000
The cleanup of the backup files is done at a Save command and at server shutdown.

Year, month, day, hour, minutes, seconds, mseconds

Content of the backup directory after 2 times save or shutdown:

$ ls -l backup/
-rw-r--r--  1 rob  staff  3696 24 Aug 16:07 20120824160729833-plan.xml
-rw-r--r--  1 rob  staff  3696 24 Aug 16:22 20120824162215119-plan.xml

• Note: See also: Replace a defective track plan or revert to an earlier version

The path and name of the Rocrail support key. The key can be shared with all work spaces if set with an absolute path.
With the button [ . . . ] a file chooser dialog is started.

The path where all Rocrail libraries are located. A dot means the working directory. ( *.dll and *.so files)

The path where images are located.
If Rocview does not locally find an image it will request it from the Rocrail server and save it for the next time. This will be very helpfull if there are multiple Rocview's and/or Mobile Clients connected to one Rocrail server to avoid manually installing all the images on all client computers. In this Example you have to create a subfolder named "images" in your Rocrail working directory on your server. Make sure that your image folder name and the entry in the Rocrail properties dialog are equal. You don't have to set a / or a \ in front of the name if the folder is directly under your Rocrail server working directory.

• Note: Depending on the OS (eg Windows) requires Rocweb the absolute path to display the images.

Image requirements:

• The image size is limited to 50KB
• It is recommended to provide images with max. 256 colors to be compatible with Mobile Clients.
• see also locomotive image format
  

If an image or icon is not found in the standard directories a recursive file search is started on the Server.
This allows a free defined directory structure which can be helpful in case of many images and icons to get it organised.

If no image is found in the "Image path" the ArchiveBox will be searched for.

Optional extra directory for function icons.
This could be of use for large layouts with many locomotives and function icons to keep things well-arranged.
The search order is:

1. Image path
2. Icon path
3. Recursive

The issues path is used to store user triggered reports: Create an Issue

The path where sound files are located played for loco functions with the specified player.

Note for Windows users:
The "wmplayer" can using very many file formats, but unfortunately does it not play simultaneously or overlapped.
It's better to convert mp3 files to wav files and play with the player sndrec32.
This is easy with a script: c:\windows\system32\sndrec32.exe /play /close /embedding %1
(Rocrail replaces %1 with path/file name of sound to play)
This can sndrec32 multiple calling simultaneously or overlapped and with the parameters above
all the sounds will be played in the background and without resources for windows, etc.

Note for Win7 users:
Copy sndrec32.exe to the directory: C:\Windows\System32\.
Change the properties/compatibility of the sndrec32.exe file to Windows 7

Note for Win 64bit users:
Copy sndrec32.exe to the directory: C:\Windows\SysWOW64\.
Change the properties/compatibility of the sndrec32.exe file to Windows 7
(see here: german forum thread)

This option can be helpful for selecting a speaker near the block where the loco resides.
A user defined script is needed to use the extra parameter(s).

1. sound file name
2. block ID
3. sensor ID

#!/bin/sh
SOUNDFILE=$1
BLOCKID=$2
SENSORID=$3
 
if [ !  $1 ]; then
  echo "usage  : rrsound.sh [file] <blockid> <sensorid>"
  echo "example: rrsound.sh typhoon.mp3"
  exit $?
fi
 
if [ $2 ]; then
  echo "blockID =" $2
fi
 
if [ $3 ]; then
  echo "sensorID =" $3
fi
 
echo "afplay" $1
afplay $1

The XmlScript path is used to lookup and store XmlScripts.
Blanks are not supported!
See XmlScripting

The Decoder path is used to lookup decoder specs for use in RocPro.
Blanks are not supported!

Disable this option to protect programming on the main track.

If using an other Command Station for programming decoders than the default, first one in the list, it can be set here by IID. See also Extra Programming Controller

Some boosters feature an extra output for signaling a short circuit.

The sensor for detecting the external short circuit.

The command station which will be informed of the external short circuit event.

If using an other Command Stations for mobile decoders than the default, first one in the list, it can be set here by IID.
This is for locomotives where the iid is not set.

If using an other Command Stations for dispatching for a throttle than the default, first one in the list, it can be set here by IID.

If using an other Command Stations for LocoIO programming than the default, first one in the list, it can be set here by IID.

Uncheck this option incase the file system is not UTF-8.

• Loading images with special characters.
• Read/write plan files with special characters.
• Uncheck for Rocrail server or Rocview if one or both are running Windows.

Copy the complete Rocrail configuration to the clipboard.
Encoding is UTF-8.