pkgsrc/net/netdisco/MESSAGE
hauke 538ae77b2d 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 08:35:51 +00:00

28 lines
1.6 KiB
Text

===========================================================================
$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
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.
- 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
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
===========================================================================