3. File Management

This chapter describes how files are managed by the voraus Robot Control and outlines the available configuration options.

voraus Robot Control distinguishes between settings that cannot be changed during runtime (Config Files) and parameters that can be changed (Data Files). Both, config and data files are defined in the JSON file format. The location of the config and data files are defined by the environment variables:

  • ${VORAUS_CONFIG_DIR}: environment variables for the location of the config files.

  • ${VORAUS_DATA_DIR}: environment variables for the location of the data files.

Config files are part of the voraus.core release, data files are individual for every controller. Data files are loaded once at startup and are managed exclusively by the voraus Robot Control. They must not be edited by hand, and no external tool can change a value while the controller is running; their contents change only when the voraus Robot Control persists updated parameters itself. As a result, each controller can have its own set of the data files, even if the robot type is the same.

Note

On Docker-based systems, data files can be persisted only if the data directory is mounted into the container, for example as a bind mount or a Docker volume. Otherwise, changes to data files are lost when the container is removed.