#OpenRoC Open-source Restart on Crash alternative with Sensu support.
###Top menu bar
####Add Adds a new process to monitor. Clicking this button will open up a Process Window.
####Delete Removes selected processes in the Process list section. You may multi-select different Processes or use the CTRL key to select them individually.
####Settings Opens up OpenRoC's Settings Window.
####Logs
Opens up OpenRoC's Logs Window. Logs are also stored and rotated (every 10MB) into a file named OpenRoC.log
next to where you have OpenRoC.exe
located.
####About Opens up OpenRoC's About Window. You may find third-party licenses and credits here.
###Process list
####Process column Lists all currently monitored Processes. You may use the check mark next to a Process to disable its monitoring. In order to add a Process to this list, you can either use the Add button or you can do so by accessing the Right-click menu. Double-clicking on a Process opens up its Process Window to edit.
####Status column Reports the current state of the Process as well as the time it has spent since the last time it entered this state. States are:
- Running: Process is running correctly and being monitored for crashes.
- Stopped: Process is stopped (not running) and being monitored.
- Disabled: Process is stopped and is not being monitored.
###Performance graph It shows a line-graph of the cumulative % usage of three main resources on the computer OpenRoC is running on. CPU usage (red), RAM usage (blue), and GPU usage (green) are data gathered for the past few seconds.
###Bottom status bar Shows useful tips and explanations about some highlighted UI items.
###Right-click menu You can access this menu by right-clicking anywhere in the Process column section. Following buttons are available in this menu:
- Add: same as Add.
- Edit: same as double clicking a Process in Process column.
- Delete: same as Delete
- Disable: same as using check boxes of a Process in Process column.
- Start Process(es): sets state of a Process to running.
- Stop Process(es): sets state of a Process to stopped.
- Show Window(s): sets state of a Process to disabled.
###Taskbar menu You can access this menu by right-clicking on OpenRoC's icon in your task-bar while it's running.
####Show/Hide Toggles UI visibility of OpenRoC.
####Exit Quits OpenRoC.
###Process path
- Executable Path: path to the Process
.exe
. Only.exe
is allowed (e.g.bat
files are not allowed). - Working Directory: working directory of the Process. This is usually the same directory where the Process
.exe
is located.
###Crash settings
- Crashed if not running: Assume a Process is crashed if it's not running. If you set the initial state to running and OpenRoC sees Process is stopped, it will go into the running state.
- Crashed if unresponsive: Some Processes may have unresponsive windows, in that case assume it is crashed and restart it.
- Unresponsiveness time period: The number of seconds passed until OpenRoC assumes an unresponsive process is crashed.
- Grace period: The number of seconds to wait before attempting a relaunch of a crashed Process.
###Pre-start event You can specify a script to be executed before OpenRoC attempts to start the Process again. OpenRoC will wait for the script to execute before starting the Process.
###Post-stop event You can specify a script to be executed after OpenRoC stops the Process. OpenRoC will wait for the script to execute before starting the Process. You can also opt-in for an aggressive method of stopping processes (recommended).
Most options in this part are self-explanatory. Most-notably you can set the initial state of the Process after you hit Save and return to the Main Window.
###Start settings
####Start minimized Enables OpenRoC to start minimized in task-bar next time it launches.
####Single instance mode Forces only one instance of OpenRoC being able to launch on this machine.
###Sensu settings Enables Sensu client socket support via UDP.