v1.15.6 - Release to fix instance matching in `geneos`

Change Log

Version v1.15.6

Note

Released 2024-07-25

Please report issues via github or the ITRS Community Forum.

v1.15.6 Fixes

• tools/geneos

  • Fix matching of names, which because we didn't use the return value of slices.Compact() meant an extra "all" was effectively added to all commands
  • Remove non-numeric prefixes of directory version naming to all "ra6.9.0" etc

• gdna

  • Fix counts for plugins over servers with multiple probes
  • Update docs to fix references to geneos which are meant to be gdna

v1.15.5

Warning

Please do not use geneos from v1.15.x while we investigate an issue with instance name parsing.

Change Log

Version v1.15.5

Note

Released 2024-07-22

Please report issues via github or the ITRS Community Forum.

v1.15.5 Fixes

• tools/geneos

  • Restore validity check regexp to allow dashes and underscored in remote host names
  • Merge parsed params back into args to fix geneos host add with an ssh URL

Release v1.15.4 - GDNA fixes and updates

Change Log

Version v1.15.4

Note

Released 2024-07-17

Please report issues via github or the ITRS Community Forum.

v1.15.4 Fixes

• gdna

  • Fix sources HTTP schema name, instead of using HTTPS
  • Remove sources entries when configuration changes or files are removed
  • Remove unused plugins from expectRows in include file
  • Fix plugin grouping for CA and GW samplers and resolve numeric inconsistencies in queries
  • Update bundled dashboards to include Unused Gateways and to add missing plugins

Release v1.15.3 - Fixes for el8/el9 installs and instance validity matching

Important

This patch release replaces v1.15.2 which had a one character typo in a regexp, but...

Change Log

Version v1.15.3

Note

Released 2024-07-11

Please report issues via github or the ITRS Community Forum.

v1.15.3 Fixes

• tools/geneos

  • Fix handling of -el8 and -el9 package installs that were broken when updating for new Netprobe package file names
  • Fix matching of instances to properly account for wildcards and non existing hosts

• gdna

  • Keep gateways_all table, not as a potential temporary one. Fixes sources report when sources go stale amongst other things
  • Fix logic in sources report to evaluate and update status correctly when valid changes

v1.15.3 Changes

• gdna

  • Add an unused-gateways report
  • Add headlines to gateway-coverage to make clear how many unused gateways exist

Release v1.15.1 - Fix Netprobe installs post 6.9.0 and some minor changes

Change Log

Version v1.15.1

Note

Released 2024-07-04

Please report issues via github or the ITRS Community Forum.

v1.15.1 Fixes

• Fix handling of new Netprobe release archive names in 6.9.0

v1.15.1 Changes

• tools/geneos

  • add support for a minimal component type, which is a Netprobe without Collection Agent
  • geneos init demo now supports the --minimal/-M flag to use the minimal Netprobe in the deployment
  • the global configuration file (typically ${HOME}/.config/geneos/geneos.json) now only saves chasnges to defaults. This allows defaults to be updated in the code without needing manual changes. Note that you may need to edit the file to clear out saved parameters that were the default but have the defaults have now changed.
  • changes geneos set x+="y" behaviour such that a space is only prefixed to the new option if it starts with a dash (-). This allows paths and other parameters that are not space separated to work
  • the geneos init san and geneos init floating commands have been deprecated in favour of geneos deploy san and geneos deploy floating, respectively
  • add the start of a geneos config export command that archives instances either as a back-up or for re-import later, once the matching geneos config import command is added. This is work-in-progress.

• gdna

  • Update to Geneos 6.9.0 and use the minimal Netprobe to reduce image size
  • Add a gdna stop command, to stop background GDNA processes. An initially empty gdna restart command has been added for later completion.

• General

  • Centos 7 has gone EOL so no test images can be built, remove them

Release v1.15.0 - Introducing GDNA 🎈🎂

Change Log

Version v1.15.0

Note

Released 2024-06-26

Please report issues via github or the ITRS Community Forum.

v1.15.0 Changes

🎁 Introducing GDNA 🎈

GDNA (Geneos Dynamic Netprobe Analysis) gives an overview of the levels of Geneos monitoring coverage in your I.T. estate and prompts action to ensure that there are no gaps in the visibility of the health of your applications and systems. It does this through analysing Geneos license allocation data and applying heuristics to plugin usage information to present visual indications of coverage levels through two dashboards.

For many users installing GDNA is as easy as starting up a docker container after configuring the data sources.

See the gdna README for more details.

• General / Miscellaneous

  • Move to Apache 2 license, from MIT, for clarity and conforming to ITRS company guidance
  • Move cron Centos 8/9 test images to UBI 8/9 respectively
  • Change all warning triangles in docs and comments ("⚠️") to to more friendly bulb ("💡")

• tools/geneos

  • Refactor internal routines to iterate over instances. Reduces the number of similar functions and inter-dependencies.
  • Refactor other function names for clarity

• pkg/config

  • Add a UseKeyFile() option to expand functions to allow overriding the key file to use

v1.15.0 Fixes

• gdna

  • Fix broken modifiers that result in no data visibility with updated sampler name
  • While fixing above also fix references to old t1 column to use 100 to indicate complete coverage
  • Fix logfile selection from command line

• tools/geneos

  • Fix the incorrect selection of archive directories in package install when using the -L option
  • Fix the --nosave option by resetting error in return to nil, as it was a "valid" failure

• pkg/config

  • Fix use of "internal defaults" in Load() when using the SetConfigFile() option

• Documentation

  • Fix emoji in generated PDF files in Dockerfile by adding an appropriate font
  • Fix missing screenshots in markdown files exported to releases by merging all screenshots directories and shipping that too. PDFs not affected.

Release v1.15.0-beta2 - Introducing GDNA 🎈

Change Log

Version v1.15.0-beta2

Note

Released 2024-06-20

Please report issues via github or the ITRS Community Forum.

v1.15.0 Changes

🎁 Introducing GDNA 🎈

GDNA (Geneos Dynamic Netprobe Analysis) gives an overview of the levels of Geneos monitoring coverage in your I.T. estate and prompts action to ensure that there are no gaps in the visibility of the health of your applications and systems. It does this through analysing Geneos license allocation data and applying heuristics to plugin usage information to present visual indications of coverage levels through two dashboards.

For many users installing GDNA is as easy as starting up a docker container after configuring the data sources.

See the gdna README for more details.

• General / Miscellaneous

  • Move to Apache 2 license, from MIT, for clarity and conforming to ITRS company guidance
  • Move cron Centos 8/9 test images to UBI 8/9 respectively
  • Change all warning triangles in docs and comments ("⚠️") to to more friendly bulb ("💡")

• tools/geneos

  • Refactor internal routines to iterate over instances. Reduces the number of similar functions and inter-dependencies.

  • Refactor other function names for clarity

• pkg/config

  Add a UseKeyFile() option to expand functions to allow overriding the key file to use

v1.15.0 Fixes

• gdna

  • Fix broken modifiers that result in no data visibility with updated sampler name
  • While fixing above also fix references to old t1 column to use 100 to indicate complete coverage

• tools/geneos

  • Fix the incorrect selection of archive directories in package install when using the -L option
  • Fix the --nosave option by resetting error in return to nil, as it was a "valid" failure

• pkg/config

  • Fix use of "internal defaults" in Load() when using the SetConfigFile() option

• Documentation

  • Fix emoji in generated PDF files in Dockerfile by adding an appropriate font
  • Fix missing screenshots in markdown files exported to releases by merging all screenshots directories and shipping that too. PDFs not affected.

Release v1.14.0 - Fix Netprobe release downloads and more

Change Log

Version v1.14.0

Released 2024-06-05

Please report issues via github or the ITRS Community Forum.

⚠️ You will need to update to this version if you use geneos to install Netprobe releases direct from the ITRS website as the base name of the redirect URL has changed and the old version no longer works.

v1.14.0 Changes

• Update Go toolchain to use 1.22.4

• tools/geneos

  • Add options to tls create to specify destination directory, outputting certificate bundles and setting the expiry period in days. Also, do not initialise the TLS subsystem if it's not found unless the --force flag is used.

  • Hide --name option in deploy, repurpose short-form -n for new --nosave option

  • Rename logs option --nostandard to --no-stdout (with alias) for consistency

• cordial package

  • Only log file and function if logging at Debug level or greater

  • Split logging methods into their own file, add options to LogInit() to specify filename and/or lunberjack settings. Log filenames can also include ~/ prefix for home directory.

• tools/gateway-reporter

  • Add an optional XLSX password in output config section

v1.14.0 Fixes

• tools/geneos

  • Fix download base name for Netprobes to new value.

  • Fix deploy importing of keyfiles (only import if given on command line)

  • package install and package update - Fix the handling of package metadata (e.g. +el8) suffixes to that they are treated the same as a package without a metadata suffix - and the right one is selected for the system being installed

• pkg/config

  • Better recovery on failing to find the user's config directory, return an error instead of panic-ing

Release v1.13.2 - Breaking Changes - Beware! Minor Patch #2

Change Log

Version v1.13.2

Released 2024-05-23

Please report issues via github or the ITRS Community Forum.

⚠️ This release replaces v1.13.0 and v1.13.1 and addresses two issues found after release, one for dv2email not authenticating with all SMTP servers correctly and changes to geneos package uninstall to protect against unintended updates

⚠️ In addition to the breaking changes below please note that some documentation is still out-of-date, and the details in this changelog are more likely to be up-to-date.

v1.13.2 BREAKING CHANGES

⚠️ Note there are a significant number of BREAKING CHANGES in this release both for the geneos program, specifically around TLS and AES command line options and behaviour, but also for some of the pkg APIs.

• tools/geneos

  • tls Subsystem

    After reviewing the usability of the TLS subsystem commands to manage secure connections with users, we've re-worked some of the functionality and added a new tls export command. The command line flags for the tls import, deploy and init command have been revisited and an attempt been made to align them more closely. Now, the following flags have common meanings:

    • --tls/-T - enable TLS secured connections. This applies to all the init commands and the the deploy command. Was previously --secure/-C in deploy and --makecerts/-C in init commands. Both long forms are aliased to the new flag.
    • --signing-bundle/-C - specifies the source of signing certificate and private key and optional verification chain. This is new to deploy and replaces some of the functionality of --importcert for init commands where the short form has changed case for consistency.
    • --instance-bundle/-c - specifies the source of an instance certificate and private key and optional verification chain. This is new to deploy and replaces the rest of the functionality of --importcert for init commands.

    Other flags have been deprecated, such as --importkey/-k, whose functionality has been merged with the above.

    The new tls export command has been added to help extract those parts of the local TLS configuration signing certificate and private key that you need to push to a remote server to be able to create and manage certificates with a common trust relationship. Use the output of tls export with the other commands above and their --signing-bundle flags to do this.

    What this means for you is that if you need to manage Geneos instances across multiple servers (remote probes, standby Gateways etc.) but cannot use the existing SSH host features, then you can more easily keep the installation in sync for TLS certificates. Typical usage may be like this:

    On your main server run this, and copy the output to your clipboard (or output to a file with the --output/-o option):

    $ geneos tls export 
    --- BEGIN CERTIFICATE ---
    ...

    Then, log in to the new remote system and

    $ geneos deploy san -u [email protected] -C -
    [follow-prompts]
    Paste PEM formatted certificate bundle:
    [CTRL-V ENTER CTRL-D]

    Now your new Self-Announcing Netprobe will have a certificate created signed by the signing certificate and key you have exported on the central server.

  • aes Subsystem

    The AES subsystem was inconsistent and the functionality incomplete and, in reality, a mess. In this release we have reviewed the functionality of all of the AES commands. The support for AES keyfile creation, importing and management on remote hosts has been improved, but some issues may remain.

    The aes ls, aes encode, aes decode and aes password commands are largely the same while their internal implementations have been cleand-up. The other commands - aes new, aes import and aes set have all been rethought and their functionality and command line flags have changed. Please review the help text or documentation for full details. They should be more consistent and useful now, but as always please let us know if anything doesn't work as you would expect.

  • deploy

    As mentioned in the tls subsystem changes above, the command lin flags for the deploy command have changed, especially the -C and -c have been swapped around for consistency. Please note this if you have previously used deploy to create TLS protected Geneos deployments. The short form for --override is now -O.

  • package and init Subsystems

    The commands that support an --override flag have had the short form changed to -O to free the -T in deploy to be hort form for --tls.

• pkg/config

  The config package

v1.13.2 Changes

• Go dependency updated to 1.22.3

• tools/geneos

  In addition to the breaking changes, there have been a number of added features and functional improvements:

  • package uninstall now has an --update/-U flag to be explcit that the user wants to update instances which use older releases. Without this flag no release will be removed if it is referenced by an instance.

  • webserver instances will now automatically manage TLS though a custom cacerts file and a local keystore and security.properties file changes. This allows for both client and server TLS with trust chains. The instance chain file is added to the Java cacerts to add trust of other Geneos components, such as Gateways and SSO Agent while instance certificate and private key can be "real" PKI ones to offer a trusted TLS web interface.

• cordial

  • The top-level cordial package provides convenience functions, like LogInit(). This has been updated to not log source file and function unless the global log level if debug or trace.

• Use a new SMTP package - <github.com/wneessen/go-mail> - Swap out the old SMTP email package used to a newer, actively maintained one. The changes should not be user visible. The affected components are pkg/email and tools/dv2mail. There have been no changes to libraries/libemail as the changes required have not yet been tested and will be completed in a later release.

v1.13.2 Fixes

Many of the changes above were prompted while tracking down and fixing issues around existing APIs and features in geneos.

• tools/dv2email

  • Fix the default HTML template to use the correct, new names for data identifying columns and rows.

  • Fix failure to authenticate to some SMTP servers.

• tools/geneos

  • Fix support for legacy .rc files, which was broken in a previous release.

  • Fix tls ls -a to show root and signing certificates even without instance certificates created.

  • Fix the handling of file paths on Windows with the geneos.exe binary.

• pkg/config

  • Fix the handling of file paths on Windows.

  • Use the newer AbbreviateHome / ExpandHome / ExpandHomeBytes functions to remove common code.

Patch Release v1.12.1 with minor feature updates too

Change Log

Version v1.12.1

Released 2024-04-18

Please report issues via github or the ITRS Community Forum.

⚠ Please note this release was built under a WSL2 (Windows Subsystem for Linux) environment, which should not matter as the releases are in turn built in containers to constraint the environment, but please report any potential issues anyway!

v1.12.1 Changes

• General

  • Update Go used to 1.22.2

• tools/geneos

  • Add support for Collection Agent logs to log command
  • #195 - Add append capability to set command

• pkg/rest

  • Add a SetupRequest function to allow for custom HTTP client settings

• pkg/config

  • Fix a deadlock in UnmarshalKey wrapper
  • Add a Bytes method for encryption
  • Add StopOnInternalDefaultsErrors() option to bail when loading bad internal defaults

• libraries/libemail

  • Add a (deliberately undocumented) _SMTP_TLS_INSECURE environment variable to allow for edge cases in TLS testing
  • Build using Go DNS resolver and user lookup packages

v1.12.1 Fixes

• tools/geneos

  • Fix tls import command and update docs
  • Deal with missing key files as errors in aes sub-system

• pkg/host

  • Allow no username for SSH config, which then defaults to the user running the command
  • Return an error from IsAvailable() on failure, and use this to send Dial() errors up the stack
  • Log a debug level message if Dial fails

• cordial (top level package)

  • Add support in LogInit for - and /dev/null/NUL as log destinations - STDOUT and discard, respectively