Added README.md
This commit is contained in:
27
README.md
Normal file
27
README.md
Normal file
@ -0,0 +1,27 @@
|
||||
# SXP Service Watcher
|
||||
|
||||
This program allows to automatically restart the SXP service provided by GSD Software by **observing** the log directory of the SXP service.
|
||||
If the SXP service is stuck, then log files of a specific type are being created that can be used as an indicator that the service is hanging.
|
||||
|
||||
## Configuration
|
||||
The configuration file **MUST** be within the same folder as the executable.
|
||||
|
||||
1. `period` is given as seconds and determines the interval in which the destination log folder is checked. Default: 30 seconds.
|
||||
2. `watch_dir` and `dir` **MUST** be absolute
|
||||
3. `service_name` is the name of the target service to be restarted
|
||||
4. `watch_file_prefix` is the prefix of the log files that are created by the SXP service
|
||||
5. `watch_file_size` is the size in kB of the created log files to be checked. Default: 0 kB
|
||||
|
||||
|
||||
## Installation
|
||||
This program is written as a windows service that can be registered by using the script `register.ps1`.
|
||||
|
||||
**Steps**:
|
||||
1. Move the built target executable along with the configuration file `config.toml` and `register.ps1` to your desired destination folder.
|
||||
2. Start PowerShell as **Administrator**
|
||||
3. Navigate to the folder of step 1.
|
||||
4. Configure **config.toml**
|
||||
5. Run `./register.ps1` within opened PowerShell of Step 1
|
||||
|
||||
## Error handling
|
||||
A log file called `sv_file_watcher.log` is created in the same path as the executable. Use the content of this log file to communicate errors.
|
||||
Reference in New Issue
Block a user