1. Home
  2. Docs
  3. MicroPVR
  4. The configuration
  5. Micropvr configuration parameters

Micropvr configuration parameters

The default configuration is in the file:
/etc/micropvr/micropvr/conf.

Logging settings

Syslog entry

Option name: log-syslog, data type: bool.

Use syslogd to write logs to /var/log/syslog. It is not recommended to include during intensive logging.

Possible values: true / falsely.

The option has been added to micropvr since version 1.9.0.

Recording of CRITICAL level messages in syslog

Option name: log-syslog-critical, data type: bool.

Whether to use syslogd to write logs to /var/log/syslog for CRITICAL log entries, regardless of parameter value log-syslog.

Possible values: true / falsely.

Tag for syslog

Option name: log-facility, data type: int.

The path to the micropvr log

Option name: log-path, data type: string.

The path to the log file to log directly without syslogd. By default /var/log/micropvr/micropvr.log.

Logging level

Option name: log-verbose-level, data type: int.

Meaning of 0 before 6where 6 The maximum EXTENDED level.

Recording period of the state log

Option name: log-state-period, data type: int.

Set in minutes. meaning 0 status log is disabled. The option was added from version 1.5.0.

The path to the state log

Option name: log-state-path, data type: string.

The path to the file in which the status log will be written. The option was added from version 1.5.0.

Log output to stdout

Option name: log-foreground, data type: bool.

Possible values: true / falsely.

API settings

JSON RPC API

Option name: json-rpc-enabled, data type: bool.

Through the API, the Middleware server manages stream recording and monitoring tasks.

Possible values: true / falsely.

Audited address for API

Option name: json-rpc-listen-host, data type: string.

The interface address for waiting for incoming connections to the JSON RPC API. Meaning 0.0.0.0 it means listening on all interfaces.

A listening port for the API

Option name: json-rpc-listen-port, data type: int.

TCP port number for JSON RPC API, by default 4089.

Recording settings

Time to postpone unsuccessful tasks

Option name: task-postpone-time, data type: int.

Time in seconds for which a task will be postponed if it is unsuccessfully attempted. By default 60.

Period of indexation of records

Option name: records-checking-period, data type: int.

Record size check period in seconds, by default 60. Determines the accuracy of positioning on the archive for the rewind function, i.e. at the value 1 it will be the most accurate to a second, but the load on the I/O will be higher. It is recommended to choose the optimal value.

Period of deletion of obsolete records

Option name records-removing-period, data type: int.

Period of performing checks to delete old records in seconds, by default 5. The value can be increased to reduce the load on I/O, but will result in slower deletion of files.

Time to block deletion of active records

Option name: records-block-active-time, data type: int.

Time to block the deletion of active records in minutes after their expiration. A record is considered active if there has been at least one appeal. By default 240. The option has been added to micropvr since version 1.7.0.

Mechanism for checking free space on the disk

Option name: recorder-check-free-space, data type: bool.

Determines the activation of the mechanism for checking free space on the disk. By default falsely. The option has been added to micropvr since version 1.2.1.

Possible values: true / falsely.

Minimum amount of free space

Option name: records-min-free-space, data type: int.

The minimum amount of free disk space in the MiB at which recording is allowed. The option has been added to micropvr since version 1.2.1.

Volume of reserved space

Option name: records-default-reserve-size, data type: int.

The amount of disk space reserved for one active record in MiB, by default 20480. The recording will not be made if the mechanism for checking free space on the disk is enabled and the volume of space after redundancy becomes less than the minimum allowed. The option has been added to micropvr since version 1.4.0.

Forced deletion of records with critical free space

Option name: records-remove-on-low-space, data type: bool.

Includes deleting the oldest records if the actual free disk space is less than critical. The write depth settings for the corresponding task transmitted through the API are ignored. Files that are still being recorded will not be deleted. The option has been added to micropvr since version 1.9.0.

Possible values: true / falsely.

Settings for recorder

Recorder launch line

Option name: recorder, data type: string.

The start command of the recorder process, which writes the stream to the file (to run the recorder and CLI-compatible programs). By omission recorder. The option has been added to micropvr since version 1.5.0.

The path for pid recorder files

Option name: recorder-pid-path, data type: string.

By default /var/run/micropvr.

Logistics recorder

Option name: recorder, data type: bool.

Enabling the recorder process log entry. By default falsely.

Possible values: true / falsely.

The path to the log recorder

Option name: recorder, data type: string.

The path to the log file of the recorder process, by default /var/log/micropvr/recorder.log.

Time to restart recorder in case of error

Option name: recorder-init timeout, data type: int.

Time in seconds to restart the recorder process in case of a failed start, by default 5. If the recorder failed to start during this time, the task will be delayed.

Recorder Process Status Period

Option name: recorder-cheking-period, data type: int.

Set in seconds, by default 1.

HLS settings

Maximum segment size in the playlist

Option name: records-default-segment-size, data type: int.

The maximum segment size in seconds is used to form the HLS playlist. It should be no less than records-checking-period. By default 60. The option was added from micropvr version 1.8.0.

The path for symbolic references

Option name: records-link, data type: string.

The path for symbolic references to the directories in which the record goes. An empty line disables the use of links. For example, when records-link equal /var/pvr_links/ the path to the links will look like /var/pvr_links/F6D124FC/and before the records /var/pvr_links/F6D124FC/ch_3/c3_t1498201120_77.ts. Why F6D124FC - hash from the full path of the directory, which was specified when creating the task and which is recorded. The mechanism is used to form HLS. The option has been added to micropvr since version 1.9.0.

Load balancing settings

Retention period for request statistics

Option name: monitor-request-lifetime, data type: int.

Term of storage of information about requests in seconds, by default 60. It is used to calculate statistics and count the number of sessions. The option has been added to micropvr since version 1.9.0.

Maximum value of load assessment

Option name: score-max-score, data type: float.

Maximum value scorein which the API method is_alive return true. By default **20.0((). The option has been added to micropvr since version 1.5.1.

Maximum network loading

Option name: score-max-net-load, data type: int.

Maximum load of outbound network stream in Mbit/sec. By default 700. Meaning -1 disables the use of this parameter in the calculation score. The option has been added to micropvr since version 1.5.1.

Maximum number of sessions

Option name: score-max-sessions, data type: int.

Maximum number of sessions used for evaluation only score. By default 10000. Meaning -1 disables the use of this parameter in the calculation score. The option has been added to micropvr since version 1.5.1.

Maximum Average CPU Load Value

Option name: score-max-cpu-la1, data type: float.

The maximum value of the average load of computing resources in 1 minute. By default 1.0. Meaning -1 disables the use of this parameter in the calculation score. The option has been added to micropvr since version 1.5.1.