mirror of https://github.com/librenms/librenms.git synced 2024-10-07 16:52:45 +00:00

Tony Murray e736f5efec Updated YAML schema validation (#8808 )

Changed some values to be explicitly boolean


DO NOT DELETE THIS TEXT

#### Please note

> Please read this information carefully. You can run `./scripts/pre-commit.php` to check your code before submitting.

- [x] Have you followed our [code guidelines?](http://docs.librenms.org/Developing/Code-Guidelines/)

#### Testers

If you would like to test this pull request then please run: `./scripts/github-apply <pr_id>`, i.e `./scripts/github-apply 5926`

2018-06-15 09:45:20 +01:00

2.3 KiB

Raw Blame History

source: os/Settings.md

Optional OS Settings

This page documents settings that can be set in the os yaml files or in config.php. All settings listed here are optional. If they are not set, the global default will be used.

User override in config.php

Users can override these settings in their config.php.

For example, to set an alternate icon for ios:

$config['os']['ios']['icon'] = 'fuzzybunny';

Ignoring Interfaces

These settings are merged with the global settings, so you can only undo global ones with good_if

empty_ifdescr: false # allow empty ifDescr
bad_if: # ifDescr (substring, case insensitive)
    - lp0
bad_if_regexp: # ifDescr (regex, case insensitive)
    - "/^ng[0-9]+$/"
bad_ifname_regexp: # ifName (regex, case insensitive)
    - "/^xdsl_channel /"
bad_ifalias_regexp: # ifAlias (regex, case insensitive)
    - "/^vlan/"
bad_iftype: # ifType (substring)
    - sonet
good_if: # ignore all other bad_if settings ifDescr (substring, case insensitive)
    - virtual

Controlling interface labels

By default we use ifDescr to label ports/interfaces. Setting either ifname or ifalias will override that. Only set one of these. ifAlias is user supplied. ifindex will append the ifindex to the port label.

ifname: true
ifalias: true

ifindex: true

Disable snmpbulkwalk

Some devices have buggy snmp implementations and don't respond well to the more efficient snmpbulkwalk. To disable snmpbulkwalk and only use snmpwalk for an os set the following.

nobulk: true

Poller and Discovery Modules

The various discovery and poller modules can be enabled or disabled per OS. The defaults are usually reasonable, so likely you won't want to change more than a few. These modules can be enabled or disabled per-device in the webui and per os or globally in config.php. Usually, a poller module will not work if it's corresponding discovery module is not enabled.

poller_modules:
    bgp-peers: true
discovery_modules:
    arp-table: false

2.3 KiB Raw Blame History