pkgsrc/net/netdisco/MESSAGE

29 lines
1.6 KiB
Text
Raw Normal View History

===========================================================================
Upgrade Netdisco to v1.3.3. x1.1 had been broken since around Perl 5.16. Adapt for use with Apache 2.4.x From the ChangeLog: 1.3.3 (2014-03-27) Bugfixes: * [113] Collect SSID in macsuck - fixed for unknown SSID (Jiri) * [] Proper fallback from SNMPv3 to SNMPv2 when discovering * [99] Node update should only search within the VLAN * [] Skip HSRP addresses during arpnip 1.3.2 (2013-08-29) Bugfixes: * [113] Collect SSID in macsuck (Jiri) 1.3.1 (2013-07-08) Bugfixes: * [] Include 'topology' table when DB is (re)created * [] Updates to 'node' and 'node_wireless' table definitions 1.3 (2013-05-20) Bugfixes: * [] Undefined MAC would make is_mac() die (N. Giefing) * [] Apply quotemeta to avoid Inventory explosion (T. Gerlach) * [94] Netdisco -O does not import oui.txt due to spaces in oui.txt 1.2 (2013-04-13) Features: * [3598045] Collect VLAN in macsuck (Jiri Dvorak) * [3598089] Collect SSID in macsuck (Jiri Dvorak) * [] Capture BSSID, per AP MAC, associated with wireless SSID in device_port_ssid table if available. * [] Add config directive "reverse_lookup_ipv6" to control whether reverse DNS lookups should be performed for IPv6 addresses. * [] Add option to node.html to search for entries only appearing on a given date. * [] Config directive "macsuck_no_vlan" now accepts both vlan names and numbers (VIDs). Patch from Peter Hicks. * [] Collect and display "vmVlanType", indicating whether a VLAN is static or dynamic on a switch port. Currently Cisco-specific. Patch from Wolfgang Friebel. * [] New database table "topology" to support adding topology links without a discovery protocol or an external topology text file. * [] New config option "snmpdiscover_timeout" to override SNMP timeout during discovery. This speeds up finding the correct SNMP string when default timeout needs to be large. * [] Add report "Inventory by Name", patch from Laurens Vets. * [] Add config option for macsuck to ignore specific VLANs on specific devices (Peter Hicks) * [] Add config option for macsuck to ignore unnamed VLANs (Peter Hicks) * [] Ignore devices with vendor "netdisco" - support for pseudo devices to interconnect discovered devices/ports * [] Improved "multiple nodes on port" display (N. Bernstein) * [] Default to _not_ vacuum db tables. Opt 'vacuum' to enable. Bugfixes: + [3541443] Remove port rename from find_neighbors() handle in SNMP::Info * [] Report "Undiscovered neighbors" also showed neighbors advertising an address not equal to their root_ip. + [] Change job log dir creation to use mkpath to resolve potential race condition. + [] Fix wireless client info collection to properly manage its transaction. + [] Fix deprecated use of qw() in device view for Perl 5.14 (cstamas) + [] Fix "Device Module Search" issue with searching on serial number. + [] Fix error message during discovery to be more accurate and not print variables that might be undef. * [] Fix warnings about undef data when running netdisco -B * [] VLAN inventory: with odd number of results, last row not displayed * [] Fix infinite loop of later worker if earlier worker dies before completing all his work.
2015-09-09 10:35:51 +02:00
$NetBSD: MESSAGE,v 1.3 2015/09/09 08:35:51 hauke Exp $
Here is a summary of the steps needed to complete the netdisco setup.
Please look at the documentation in ${PREFIX}/doc/ for details.
- add the netdisco administrator(s) account(s) to the netdisco group
- edit ${PREFIX}/netdisco/netdisco.conf to suit your needs. You have to
Upgrade Netdisco to v1.3.3. x1.1 had been broken since around Perl 5.16. Adapt for use with Apache 2.4.x From the ChangeLog: 1.3.3 (2014-03-27) Bugfixes: * [113] Collect SSID in macsuck - fixed for unknown SSID (Jiri) * [] Proper fallback from SNMPv3 to SNMPv2 when discovering * [99] Node update should only search within the VLAN * [] Skip HSRP addresses during arpnip 1.3.2 (2013-08-29) Bugfixes: * [113] Collect SSID in macsuck (Jiri) 1.3.1 (2013-07-08) Bugfixes: * [] Include 'topology' table when DB is (re)created * [] Updates to 'node' and 'node_wireless' table definitions 1.3 (2013-05-20) Bugfixes: * [] Undefined MAC would make is_mac() die (N. Giefing) * [] Apply quotemeta to avoid Inventory explosion (T. Gerlach) * [94] Netdisco -O does not import oui.txt due to spaces in oui.txt 1.2 (2013-04-13) Features: * [3598045] Collect VLAN in macsuck (Jiri Dvorak) * [3598089] Collect SSID in macsuck (Jiri Dvorak) * [] Capture BSSID, per AP MAC, associated with wireless SSID in device_port_ssid table if available. * [] Add config directive "reverse_lookup_ipv6" to control whether reverse DNS lookups should be performed for IPv6 addresses. * [] Add option to node.html to search for entries only appearing on a given date. * [] Config directive "macsuck_no_vlan" now accepts both vlan names and numbers (VIDs). Patch from Peter Hicks. * [] Collect and display "vmVlanType", indicating whether a VLAN is static or dynamic on a switch port. Currently Cisco-specific. Patch from Wolfgang Friebel. * [] New database table "topology" to support adding topology links without a discovery protocol or an external topology text file. * [] New config option "snmpdiscover_timeout" to override SNMP timeout during discovery. This speeds up finding the correct SNMP string when default timeout needs to be large. * [] Add report "Inventory by Name", patch from Laurens Vets. * [] Add config option for macsuck to ignore specific VLANs on specific devices (Peter Hicks) * [] Add config option for macsuck to ignore unnamed VLANs (Peter Hicks) * [] Ignore devices with vendor "netdisco" - support for pseudo devices to interconnect discovered devices/ports * [] Improved "multiple nodes on port" display (N. Bernstein) * [] Default to _not_ vacuum db tables. Opt 'vacuum' to enable. Bugfixes: + [3541443] Remove port rename from find_neighbors() handle in SNMP::Info * [] Report "Undiscovered neighbors" also showed neighbors advertising an address not equal to their root_ip. + [] Change job log dir creation to use mkpath to resolve potential race condition. + [] Fix wireless client info collection to properly manage its transaction. + [] Fix deprecated use of qw() in device view for Perl 5.14 (cstamas) + [] Fix "Device Module Search" issue with searching on serial number. + [] Fix error message during discovery to be more accurate and not print variables that might be undef. * [] Fix warnings about undef data when running netdisco -B * [] VLAN inventory: with odd number of results, last row not displayed * [] Fix infinite loop of later worker if earlier worker dies before completing all his work.
2015-09-09 10:35:51 +02:00
set the database password here and in netdisco_apache.conf.
- cd to ${PREFIX}/netdisco/sql/ and run ./pg --init
to create the netdisco database in postgresql.
- Add a user to the netdisco system: ${PREFIX}/netdisco/netdisco -u joebob
Give this user administration privileges, so that it will be able to
create other users though the web interface.
Upgrade Netdisco to v1.3.3. x1.1 had been broken since around Perl 5.16. Adapt for use with Apache 2.4.x From the ChangeLog: 1.3.3 (2014-03-27) Bugfixes: * [113] Collect SSID in macsuck - fixed for unknown SSID (Jiri) * [] Proper fallback from SNMPv3 to SNMPv2 when discovering * [99] Node update should only search within the VLAN * [] Skip HSRP addresses during arpnip 1.3.2 (2013-08-29) Bugfixes: * [113] Collect SSID in macsuck (Jiri) 1.3.1 (2013-07-08) Bugfixes: * [] Include 'topology' table when DB is (re)created * [] Updates to 'node' and 'node_wireless' table definitions 1.3 (2013-05-20) Bugfixes: * [] Undefined MAC would make is_mac() die (N. Giefing) * [] Apply quotemeta to avoid Inventory explosion (T. Gerlach) * [94] Netdisco -O does not import oui.txt due to spaces in oui.txt 1.2 (2013-04-13) Features: * [3598045] Collect VLAN in macsuck (Jiri Dvorak) * [3598089] Collect SSID in macsuck (Jiri Dvorak) * [] Capture BSSID, per AP MAC, associated with wireless SSID in device_port_ssid table if available. * [] Add config directive "reverse_lookup_ipv6" to control whether reverse DNS lookups should be performed for IPv6 addresses. * [] Add option to node.html to search for entries only appearing on a given date. * [] Config directive "macsuck_no_vlan" now accepts both vlan names and numbers (VIDs). Patch from Peter Hicks. * [] Collect and display "vmVlanType", indicating whether a VLAN is static or dynamic on a switch port. Currently Cisco-specific. Patch from Wolfgang Friebel. * [] New database table "topology" to support adding topology links without a discovery protocol or an external topology text file. * [] New config option "snmpdiscover_timeout" to override SNMP timeout during discovery. This speeds up finding the correct SNMP string when default timeout needs to be large. * [] Add report "Inventory by Name", patch from Laurens Vets. * [] Add config option for macsuck to ignore specific VLANs on specific devices (Peter Hicks) * [] Add config option for macsuck to ignore unnamed VLANs (Peter Hicks) * [] Ignore devices with vendor "netdisco" - support for pseudo devices to interconnect discovered devices/ports * [] Improved "multiple nodes on port" display (N. Bernstein) * [] Default to _not_ vacuum db tables. Opt 'vacuum' to enable. Bugfixes: + [3541443] Remove port rename from find_neighbors() handle in SNMP::Info * [] Report "Undiscovered neighbors" also showed neighbors advertising an address not equal to their root_ip. + [] Change job log dir creation to use mkpath to resolve potential race condition. + [] Fix wireless client info collection to properly manage its transaction. + [] Fix deprecated use of qw() in device view for Perl 5.14 (cstamas) + [] Fix "Device Module Search" issue with searching on serial number. + [] Fix error message during discovery to be more accurate and not print variables that might be undef. * [] Fix warnings about undef data when running netdisco -B * [] VLAN inventory: with odd number of results, last row not displayed * [] Fix infinite loop of later worker if earlier worker dies before completing all his work.
2015-09-09 10:35:51 +02:00
- Import the OUI database http://standards.ieee.org/regauth/oui/oui.txt
with ${PREFIX}/netdisco/netdisco -O
- Add an appropriate crontab to user netdisco. ${EGDIR} contains an example.
- Include netdisco in your apache config. ${EGDIR} contains two config
fragments: netdisco_apache.conf and netdisco_apache_dir.conf which
Upgrade Netdisco to v1.3.3. x1.1 had been broken since around Perl 5.16. Adapt for use with Apache 2.4.x From the ChangeLog: 1.3.3 (2014-03-27) Bugfixes: * [113] Collect SSID in macsuck - fixed for unknown SSID (Jiri) * [] Proper fallback from SNMPv3 to SNMPv2 when discovering * [99] Node update should only search within the VLAN * [] Skip HSRP addresses during arpnip 1.3.2 (2013-08-29) Bugfixes: * [113] Collect SSID in macsuck (Jiri) 1.3.1 (2013-07-08) Bugfixes: * [] Include 'topology' table when DB is (re)created * [] Updates to 'node' and 'node_wireless' table definitions 1.3 (2013-05-20) Bugfixes: * [] Undefined MAC would make is_mac() die (N. Giefing) * [] Apply quotemeta to avoid Inventory explosion (T. Gerlach) * [94] Netdisco -O does not import oui.txt due to spaces in oui.txt 1.2 (2013-04-13) Features: * [3598045] Collect VLAN in macsuck (Jiri Dvorak) * [3598089] Collect SSID in macsuck (Jiri Dvorak) * [] Capture BSSID, per AP MAC, associated with wireless SSID in device_port_ssid table if available. * [] Add config directive "reverse_lookup_ipv6" to control whether reverse DNS lookups should be performed for IPv6 addresses. * [] Add option to node.html to search for entries only appearing on a given date. * [] Config directive "macsuck_no_vlan" now accepts both vlan names and numbers (VIDs). Patch from Peter Hicks. * [] Collect and display "vmVlanType", indicating whether a VLAN is static or dynamic on a switch port. Currently Cisco-specific. Patch from Wolfgang Friebel. * [] New database table "topology" to support adding topology links without a discovery protocol or an external topology text file. * [] New config option "snmpdiscover_timeout" to override SNMP timeout during discovery. This speeds up finding the correct SNMP string when default timeout needs to be large. * [] Add report "Inventory by Name", patch from Laurens Vets. * [] Add config option for macsuck to ignore specific VLANs on specific devices (Peter Hicks) * [] Add config option for macsuck to ignore unnamed VLANs (Peter Hicks) * [] Ignore devices with vendor "netdisco" - support for pseudo devices to interconnect discovered devices/ports * [] Improved "multiple nodes on port" display (N. Bernstein) * [] Default to _not_ vacuum db tables. Opt 'vacuum' to enable. Bugfixes: + [3541443] Remove port rename from find_neighbors() handle in SNMP::Info * [] Report "Undiscovered neighbors" also showed neighbors advertising an address not equal to their root_ip. + [] Change job log dir creation to use mkpath to resolve potential race condition. + [] Fix wireless client info collection to properly manage its transaction. + [] Fix deprecated use of qw() in device view for Perl 5.14 (cstamas) + [] Fix "Device Module Search" issue with searching on serial number. + [] Fix error message during discovery to be more accurate and not print variables that might be undef. * [] Fix warnings about undef data when running netdisco -B * [] VLAN inventory: with odd number of results, last row not displayed * [] Fix infinite loop of later worker if earlier worker dies before completing all his work.
2015-09-09 10:35:51 +02:00
can be included in the httpd.conf to make netdisco available though
http://your.host.name/netdisco/
- Make netdisco discover one of your devices:
${PREFIX}/netdisco/netdisco -d devicename
- Make netdisco discover your network topology, if supported by your
devices: ${PREFIX}/netdisco/netdisco -r devicename
If not supported by your devices, you'll have to fill in
${PREFIX}/netdisco/netdisco-topology.txt.
- start the admin daemon: /etc/rc.d/netdisco start
===========================================================================