6575042f5f
* clean up all but header incrementing in Creating-Transport.md * make Device-Dependencies.md mdl happy * make Entities.md as mdl happy as possible... one long table line left * make mdl as happy as possible for index.md * clean up Introduction.md as much as possible * minor formatting cleanup... move each icon onto its own row * make ack and notes the same style * clean Macros.md up * clean Rules.md up as much as possible * tweak one line a bit to get it to format a bit nicer * a bit more format tweaking, making sure it does not sure with > * clean up as much as possible for Templates.md * make Testing.md as mdl happy as possibly * clean Transports.md up as much as possible * clean as many issues as possible for Alerts.md * clean up as much of ARP.md as possible * clean up as much as possible for Bills.md * make DeviceGroups.md as mdl happy as possible * cleanup Devices.md * make as mdl happy as possible Inventory.md and index.md * mdl cleanup for Logs.md and PortGroups.md * make Ports.md and Routing.md as happy as possible * clean up Services.md, Switching.md, and Systems.md as much as possible * more markup cleanup * lots more md cleanup udner Devloping/ * reapply bits from #10343 that accidentally got removed when merging
2.5 KiB
source: os/Settings.md path: blob/master/doc/
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
See also: Global Ignoring Interfaces Config
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
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
SNMP Settings
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
Limit the oids per snmpget
snmp_max_oid: 8
Storage Settings
See also: Global Storage Config
ignore_mount_array: # exact match
- /var/run
ignore_mount_string: # substring
- run
ignore_mount_regexp: # regex
- "/^\/var/"