The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

App::Netdisco::Manual::ReleaseNotes - Release Notes

Introduction

This document will list only the most significant changes with each release of Netdisco. You are STRONGLY recommended to read this document each time you install and upgrade. Also see the Changes file, for more information.

Migrating from Netdisco 1.x

This distribution (App::Netdisco) is a complete rewrite of the Netdisco application. Users often ask whether they can run both versions at the same time, and whether the database must be copied. Here are the guidelines for migrating from Netdisco 1.x:

  • You can run both Netdisco 1.x and App::Netdisco web frontends at the same time, using the same database (if "safe_password_store" is set to "false").

  • Only enable the backend daemon and discovery jobs from either Netdisco 1.x or App::Netdisco.

  • You can share a single database between Netdisco 1.x and App::Netdisco. The deploy script for App::Netdisco will make some schema changes to the database, but they are backwards compatible.

2.029008

General Notices

When upgrading you will encounter a current incompatibility between Netdisco and one of its components. To work around this, issue the following command:

 ~/bin/localenv cpanm --notest --force Dancer@1.3126 DBIx::Class@0.08270

2.029008

General Notices

When upgrading you will encounter a current incompatibility between Netdisco and one of its components. To work around this, issue the following command:

 ~/bin/localenv cpanm --notest --force Dancer@1.3126

2.029002

General Notices

The backend polling daemon has been rewritten and as a result your configuration can be simplified. Some keys have also been renamed. Our advice is to remove (or comment out) the complete workers configuration which enables auto-tuning. If you do wish to control the number of worker processes, follow this pattern:

 workers:
   tasks: 'AUTO * 2'  # this is the default, twice the number of CPUs

2.029001

Health Advice

This release will remove from the database spurious Node (workstation, printer, etc) entries on vlan 0, which were causing dupliate entries in the web interface. We advise that you back up the database prior to upgrade:

 /usr/bin/pg_dump -F p --create -f netdisco-pgsql.dump netdisco

General Notices

The configuration item reports is now a list (used to be a dictionary). Each item in the list must have a tag entry which was previously the dictionary key. For example, now use:

 reports:
   - tag: power_inventory
     category: Device
     label: 'Power Supply Inventory'
     columns:
       - {name: 'Name'}
       - {ps1_type: 'PS1 Type'}
       - {ps1_status: 'PS1 Status'}
     query: |
       SELECT d.name, d.ps1_type, d.ps1_status
         FROM device d
         WHERE d.ps1_type IS NOT NULL
       ORDER BY name

Old configuration will be continue to work, but we recommend you reconfigure anyway.

2.028000

Incompatible Changes

The daemons can be started from init scripts, as root. They will drop back from the root user to netdisco before opening logs. However a limitation is that the web frontend might temporarily keep root status to bind to a specific port (e.g. 80) - the logs will then be created as root user. Sorry about that.

You might also find when upgrading that previous logs were owned by root and Netdisco now wants to write to them as non-root (netdisco) user. Please either remove the logs before restarting, or alter their ownership.

Logs can be found in the logs subdirectory of Netdisco's home area.

General Notices

The configuration item housekeeping has been renamed to schedule. Old configuration will continue to work, but we recommend you now rename this key in your configuration anyway.

2.025001

General Notices

The Web and Backend daemons (netdisco-web and netdisco-daemon respectively) will now watch your deployment.yml configuration file, and restart themselves whenever it is changed.

The Web and Backend daemons will also now drop privilege to the same user and group as their files on disk. This allows use of run control (init) scripts whilst maintaining non-root privilege status (see Deployment documentation for details).

The housekeeping task expiry has been renamed to expire. Old configuration will continue to work, but we recommend you rename this part of your housekeeping configuration anyway.

2.023000

Incompatible Changes

This release will automatically migrate user passwords to have stronger hashing in the database (a good thing!). This is incompatible with Netdisco 1.x web frontend, so if you must maintain backward-compatibility, set the following in your deployment.yml file:

 safe_password_store: false

General Notices

The number of parallel DNS queries running during node discovery has been reduced to 10 for maximum safety, but resulting in lower macsuck performance. If you have a robust DNS infrastructure, you can probably put it back up to something like 50 or 100:

 dns:
  max_outstanding: 100

2.021000

Incompatible Changes

SNMP community strings provided in the community_rw configuration setting will no longer be used for read actions on a device (despite having "rw" in the setting name).

If you have the same community string for read and write access, then you must set both community and community_rw in your deployment.yml file. In any case, we recommend using the new snmp_auth configuration format which supercedes both these settings.

Health Advice

This release includes support for Device and Node expiry from your database. This is an important part of housekeeping for your installation, and our recommendation is to enable this feature such that suitably old Devices and Nodes are expired nightly.

Add the following to your "housekeeping" configuration in deployment.yml, to have a nightly check at 11:20pm:

  housekeeping:
    expire:
      when: '20 23 * * *'

You should also configure one or more of expire_devices, expire_nodes, and expire_nodes_archive to a number of days. See the Configuration documentation for further details.

General Notices

If you use an Apache reverse proxy, we recomment increasing the timeout from our previous example of 5 seconds to, perhaps 60. This is because some reports do take more time to run their queries on the database. See Deployment documentation for details.

2.020000

General Notices

If you were using the X::Observium plugin, you'll now need to install the separate distribution App::NetdiscoX::Web::Plugin::Observium.

2.019000

General Notices

This release fixes a number of issues with the poller, and is a recommended upgrade.

During Arpnip, Node IPs are resolved to DNS names in parallel. See the dns configuration option for details. Note that the nodenames configuration items from release 2.018000 are no longer available.

This release includes new support for SNMPv3 via the snmp_auth configuration option. Please provide feedback to the developers on your experience.

2.018000

General Notices

The previous mentioned bug in Macsuck is now fixed.

2.017000

General Notices

There is a bug in Macsuck whereby in rare circumstances some invalid SQL is generated. The root cause is known but we want to take more time to get the fix right. It should only be a few more days.

The no_port_control configuration setting is now called check_userlog and its logic is inverted. Don't worry if this is not familiar to you - the option is only used by Netdisco Developers.

2.016000

General Notices

The dangerous action log messages are now saved to the database. In a future version there will be a way to display them in the web interface.

2.015000

Health Advice

Some of the "dangerous action" confirmation dialogs offer to take a log message (e.g. Port Control, Device Delete). Currently the log messages are not saved. This feature will be added in the next release.

2.014000

General Notices

The backend poller daemon is now considered stable. You can uncomment the housekeeping section of the example configuration and thereby enable regular device (re-)discovery, arpnip and macsuck.

2.013000

General Notices

You can now configure LDAP authentication for users.

2.012000

Security Notices

The read-write SNMP community is now stored in the database, when used for the first time on a device. If you don't want the web frontend to be able to access this, you need to:

  • Have separate deployment.yml files for web frontend and daemon, such that only the daemon config contains any community strings.

  • Use separate PostgreSQL users for web frontend and daemon, such that the web frontend user cannot SELECT from the community DB table.

2.011000

General Notices

Users can be managed through the web interface (by admins only).

2.010000

General Notices

You can now simplify database configuration to just the following, instead of the more verbose plugins/DBIC setting which was there before:

 database:
   name: 'netdisco'
   host: 'localhost'
   user: 'someuser'
   pass: 'somepass'

Also, the REMOTE_USER environment variable and X-REMOTE_USER HTTP Header are now supported for delegating authentication to another web server. See the Deployment and Configuration documentation for further details.

2.008000

Health Advice

This release contains the first version of our new poller, which handles device and node discovery. Please make sure to backup any existing Netdisco database before trying it out.

General Notices

You can remove any settings from ~/environments/deployment.yml which you didn't edit or add to the file yourself. All defaults are now properly embedded within the application. See the new deployment.yml sample which ships with this distribution for an example.

2.006000

Incompatible Changes

The default environment configuration file develpment.yml has been renamed to deployment.yml. This better reflects that users are not developers, and also fits with the default for PSGI compatible cloud deployment services.

Please rename or copy your environment file:

 mv ~/environments/development.yml ~/environments/deployment.yml

General Notices

The installation is now relocateable outside of a user's home directory by setting the NETDISCO_HOME environment variable. This defaults to your own home directory.