135/netdisco
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

add config note about cached community strings

Browse Source
This commit is contained in:
Oliver Gorwits
2016-10-03 21:11:01 +01:00
parent afe3d29175
commit 61415eee6e
1 changed files with 7 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
Netdisco/lib/App/Netdisco/Manual/Configuration.pod
View File

@@ -575,7 +575,7 @@ configuration.
For SNMPv1 and SNMPv2, only the C<community> key is required. Unlike the For SNMPv1 and SNMPv2, only the C<community> key is required. Unlike the
global C<community>/C<community_rw> setting, this is not a list but a single global C<community>/C<community_rw> setting, this is not a list but a single
item. To emulate their list behaviour, have multiple entries at the top item. To emulate their list behaviour, have multiple entries at the top
C<snmp_auth> level, as in the example above. C<snmp_auth> level, as in the example below.
You can add C<read> and/or C<write> restrictions, and an IP restriction using You can add C<read> and/or C<write> restrictions, and an IP restriction using
C<only>. Giving the stanza a C<tag> name is optional, but recommended. C<only>. Giving the stanza a C<tag> name is optional, but recommended.
@@ -596,7 +596,7 @@ key to a stanza to override this.
Note that multiple SNMP v2 community strings need to be in separate named Note that multiple SNMP v2 community strings need to be in separate named
stanza, as below. However for simple v2 configurations you can use the stanza, as below. However for simple v2 configurations you can use the
C<community> shorthand: C<community> shorthand instead:
snmp_auth: snmp_auth:
- tag: 'default_v2_readonly1' - tag: 'default_v2_readonly1'
@@ -607,6 +607,11 @@ C<community> shorthand:
# or... # or...
community: ['read1', 'read2'] community: ['read1', 'read2']
Netdisco caches both the successful SNMPv2 read and write community strings,
as well as the C<tag> names if available. This allows for faster operations
once a connection has already been made to a device. When you delete a device,
the community strings are removed but the C<tag> hints remain, for future use.
=head3 C<get_community> =head3 C<get_community>
Value: String. Default none. Value: String. Default none.