diff --git a/Changes b/Changes index 337ea3a0..7ea8ddfd 100644 --- a/Changes +++ b/Changes @@ -1,12 +1,12 @@ -2.035999_001 - 2017-05-17 +2.035999_002 - 2017-05-27 [NEW FEATURES] - * new ACL features including AND and negation - * named ACLs which can be used in other ACLs or *_only/*_no settings - * template_paths setting to allow very easy override of code and templates - * site_local_files setting for easy lib/template override (TODO: docs) - * support for device identity steering via device_identity (TODO: docs) + * site_local_files setting for easy lib/template/static-file override + * support for device identity steering via device_identity + * new ACL features: AND and negation + * named host groups which can be used in other ACLs or *_only/*_no settings + * template_paths setting to allow very easy override of templates [ENHANCEMENTTS] diff --git a/lib/App/Netdisco/Manual/Configuration.pod b/lib/App/Netdisco/Manual/Configuration.pod index 980a74ee..82cdf889 100644 --- a/lib/App/Netdisco/Manual/Configuration.pod +++ b/lib/App/Netdisco/Manual/Configuration.pod @@ -661,6 +661,9 @@ very specific matching on devices, use a host group of several properties together with the "C" modifier to require that all items in the list match the device (as in the example above). +Note also that whatever interface you select as canonical for the device must +be reachable by SNMP. This is tested and the renumber aborted if not possible. + =head3 C Value: Directory. Default: C<${HOME}/netdisco-mibs>. diff --git a/lib/App/Netdisco/Manual/ReleaseNotes.pod b/lib/App/Netdisco/Manual/ReleaseNotes.pod index f16e1d72..6efcca7f 100644 --- a/lib/App/Netdisco/Manual/ReleaseNotes.pod +++ b/lib/App/Netdisco/Manual/ReleaseNotes.pod @@ -35,27 +35,57 @@ deploy script for App::Netdisco will make some schema changes to the database, but they are backwards compatible. =back + =head1 2.036000 -=head2 Health Advice +This release has many significant new features and changes. Please read all +the release notes before upgrading. -In this release the apps C and C have +=over 4 + +=item * + +The C and C scripts have been renamed to C and C respectively. -This better reflects the function of the two programs. If you still have -scripts using C or C commands, they -should continue to work, as these apps still exist and simply exec() to the -new scripts on start. - -However, it would be best if you replace any custom management config to -point to the new app names, going forward. Remember to do this on upgrade: +The old commands will still work but we recommend packagers to use the new +names to remain consistent with documentation. Run the following on upgrade: ln -s ~/perl5/bin/{localenv,netdisco-*} ~/bin/ -=head2 General Notices +=item * -This release builds a Perl SSL interface which requires OpenSSL development -files (headers) on your system. +The topology import script (C) will now queue a "discover" +job for each new device it imports. + +=item * + +A new setting C is a shorthand for confguring paths in which +to install local Perl, template, javascript, and images files for overriding +or enhancing Netdisco. See L for +details. + +=item * + +Documentation and support for access control lists has been overhauled. Most +"C<*_no>", "C<*_only>", and "C" settings will accept ACLs as single +items or lists. ACLs now support negation and OR/AND modifier options. + +=item * + +A new setting C allows for creating named Access Control Lists +which can be referred to in other host groups or in any of the settings taking +an ACL. + +=item * + +The new setting C allows configuring rules to select the +interface to use as a canonical (friendly) identity of a device in Netdisco. + +=item * + +SSL library headers are required to build Netdisco now that we retrieve +support files via HTTPS. On Ubuntu/Debian: