*DO NOT USE* Release v1.10.0

A problem has been found that means you should not use geneos from this release. Update coming soon.

Change Log

Version v1.10.0

Released 2023-10-25

Please report issues via github or the ITRS Community Forum.

v1.10.0 Fixes

• pkg/config

  The Sub() methods will now return an empty Config struct and not nil if the key is not found. This is a divergence from viper.

  The non-global GetSliceStringMapString method returned values from the global config object. Found while implementing changes to noe use embedded viper, see below.

• pkg/geneos/netprobe

  Updates to the structs to produce valid XML when rendered as XML through the Go xml package.

• tools/geneos

  • Do not automatically try to rebuild component config files if the setup parameters is to a remote configuration.

  • Fix the show -s command to read instance configurations from their potentially remote host and not localhost.

  • Add a 250ms delay after starting an instance to allow for the process to fully start and update OS args so that the GetPID call works more often and can report the successful start-up.

v1.10.0 Changes

• pkg/config

  Potential API Changes - to allow safer concurrent access to the underlying viper configuration objects the original embedded viper instance in the Config struct has been promoted to be named as Viper. This removes access to embedded methods and the intermediate methods have been updated to use a RWMutex around every call to viper. This however means that not all viper methods are transparently available and new shims have been added for the most common ones found. If dependent code now fails to compile because of missing methods they will need to be added to config.go along with the appropriate mutex wrappers.

  Added a WatchConfig() option to enable auto-reloading final config files found during Load(). Note that WatchConfig is not concurrency safe. This may change if we implement our own callback.

• tools/geneos

  • Add "glob" style wildcard support for instance names (and names only, not remote hosts) to most command. This should always be used with quoting to avoid shell expansion. This allows commands line geneos start gateway 'LDN*' and so on. Also add support to move and copy to act on multiple wildcarded sources as long as the destination is a @HOST.

  • Some instance configuration parameters are no tested for the instance home path and this is replaced with ${config:home} so that moves and copies have paths auto updated. This include certificates, keys and set-up files.

  • Lower the auto-generated instance.setup.xml Gateway include file priority value so it is loaded before other typical includes.

  • For Gateway and SAN change default parameters gatewayname and sanname respectively to use name in an GetString expansion. This makes the parameters auto-update if the instance name changes (for example using move or copy) until and unless the user sets a fixed name.

  • Remove the -setup-interval from SAN command lines (which was using the default anyway) to allow it to be overridden in the options parameter.

Release v1.9.2

Change Log

Version v1.9.2

Released 2023-10-10

Please report issues via github or the ITRS Community Forum.

v1.9.2 Fixes

• tools/dv2email
  • Fix environment handling, which was broken in an earlier update to the config package
  • Add command line args for use from a Geneos Command
  • Update Dataview Row handling
  • Fix HTML template for multiple Dataviews
  • Update docs

v1.9.2 Changes

• pkg/config
  • Add a SetConfigReader() option to Load to be able to load configuration from an io.Reader. Untested, work in progress for a project.

Release v1.9.1

Change Log

Version v1.9.1

Released 2023-10-06

Please report issues via github or the ITRS Community Forum.

v1.9.1 Fixes

• The release build process has been reworked to use Debian Bullseye images to maximise compatibility for shared libraries and also to build static binaries cleanly. A change in the Go toolchain at some point has made the build of the dynamically linked centos7 binary of geneos not work. This has now been removed while investigations into how to do this properly continue. This means that for users who have network directories for users there will be errors looking up users for ls and ps commands, at minimum.
• tools/geneos
  • Use path.IsAbs() and not filepath.IsAbs() so that constructing paths on a Windows host works for remote Linux systems. Fixes process start from Windows to Linux.
  • Allow deletion of protected instances with the --force/-F flags, as intended originally
  • When creating instances check all listening ports, not just those reserved in instance configurations
  • More fixes to package handling around component types with parent types
  • Change TLS cert verification to validation and document better
  • Add chain file path to geneos tls ls -l output

v1.9.1 Changes

• pkg/geneos
  • Move Netprobe XML structs to their own package pkg/geneos/netprobe

Release v1.8.1 - Fixes to build and package handling

Change Log

Version v1.8.1

Released 2023-09-01

Please report issues via github or the ITRS Community Forum.

v1.8.1 Fixes

• tools/geneos
  • unset should not present a warning if special parameters are passed but not actions, e.g. removing a non-existing environment variable
  • #181 - now build on MacOS, primarily for remote admin. Not fully tested
  • #182 - a slew of issues around the order of actions during package install, uninstall and update fixed

Release v1.8.0 - Improve `geneos tls import` and more

Change Log

Version v1.8.0

Released 2023-08-16

Please report issues via github or the ITRS Community Forum.

v1.8.0 Highlights

This version changes the way geneos tls import works to add support for the import of external "real" certificates into your Geneos environment. You can now supply a PEM formatted certificate and key with an options verification chain and add these to existing instances.

Key files are now enabled for use by default for all new Gateway instances. Key files have been automatically created for some time now, but not automatically enabled in the starting environment of the Gateway.

v1.8.0 Changes

• tools/geneos

  • Enable the use of external key-files for all new Gateways running on version GA5.14 and above. Existing Gateways will not be affected as the default is usekeyfile=false. If you do not want to use an external key-file set usekeyfile=false before starting for the first time. If a Gateway has been started with or without a keyfile and created a cache directory then you must follow the instructions in the documentation, https://docs.itrsgroup.com/docs/geneos/current/Gateway_Reference_Guide/gateway_secure_passwords.htm#How_to_change_the_key_file_of_your_Gateway, otherwise your Gateway will not start-up.

  • New options to the start, restart and command sub-commands allow you to add one-off command line arguments and environment variables to an instance. This is useful, for example, to pass a -skip-cache argument to a Gateway.

  • Extensive rework to the internal handling of loops-over-instances to pass-back an instance.Response struct and handle output at the caller. This is preparation for work on non-CLI interfaces (think: REST API and web). This may break some output formatting, please report via github issues.

  • tls import has changed to support the import of instance certificate, signing certs and chains in a more organised way. It is unlikely anyone was using the previous incarnation which was highly limited but just in case, this is a breaking change to the syntax and functionality of tls import.

• pkg/geneos/api

  • A new API for inbound data to Geneos. This package is not yet ready for real-world use.

v1.8.0 Fixes

• pkg/config

  • #176 fix support for Windows paths in ${enc:...} expansion formats

• tools/geneos

  • A fix for a long time bug in an internal routine that checked reserved names. This was found during the refactoring of code above. Oddly this doesn't appear to have been noticed, not sure why.

  • Fix closing of open file descriptors when starting a local instance. This needed cmd.Extrafiles slice having empty nils added through the the largest FD.

  • Fix merging of aliases during instance config load.

Beta Release - v1.8.0-beta

Change Log

Version v1.8.0-beta

Released 2023-08-08

Please report issues via github or the ITRS Community Forum.

v1.8.0 Changes

• tools/geneos - Extensive rework to the internal handling of loops-over-instances to pass-back an instance.Response struct and handle output at the caller. This is preparation for work on non-CLI interfaces (think: REST API and web). This may break some output formatting, please report via github issues.

• tools/geneos - tls import has changed to support the import of instance certificate, signing certs and chains in a more organised way. It is unlikely anyone was using the previous incarnation which was highly limited but just in case, this is a breaking change to the syntax and functionality of tls import.

v1.8.0 Fixes

• pkg/config - #176 fix support for Windows paths in ${enc:...} expansion formats

• tools/geneos - A fix for a long time bug in an internal routine that checked reserved names. This was found during the refactoring of code above. Oddly this doesn't appear to have been noticed, not sure why.

Release v1.7.2 with significant minor fixes

Change Log

Version v1.7.2

Released 2023-07-28

Please report issues via github or the ITRS Community Forum.

v1.7.2 Changes

• pkg/gwhub, pkg/icp, pkg/streams and pkg/geneos have been updated to match real APIs and to add access to REST API streams

v1.7.2 Fixes

• #172 - viper doesn't do the right thing with overridden values in maps containing defaults. This would affect GetStringMap*() callers, and we also now have our own UnmarshalKey() function

• pkg/config and tools/geneos: Fix handling of command line plaintext passwords (those not prompted for). When passed a pointer to a method you have to set the destination of the pointer, not the ephemeral pointer itself

• tools/geneos would not correctly initialise web server directories after changes to import earlier in v1.7. This is now fixed along with the removal of a confusing treatment of "~/" in an import path not meaning the user's home directory

Release v1.7.1 - minor fixes

Change Log

Version v1.7.1

Released 2023-07-25

Please report issues via github or the ITRS Community Forum.

v1.7.1 Changes

• pkg/gwhub & pkg/icp - Updates for ongoing project

v1.7.1 Fixes

• #167 - Only load template files with a .gotmpl extension.

• #169 - If the file being imported is the same as the destination, skip the copy.

• tools/geneos - Fix installation of packages from local sources with or without component on command line

Release v1.7.0

Change Log

Version v1.7.0

Released 2023-07-11

Please report issues via github or the ITRS Community Forum.

v1.7.0 Changes

• tools/geneos - Optimisation and parallel execution. All operations on Geneos instances are now run in parallel which has resulted in significant improvements in responsiveness and has reduced delays waiting for things to happen on larger installations and remote hosts. While extensive testing has taken place to ensure that the underlying functionality is not affected, there may still be issues in some cases - please report them as soon as you can!

• Add support for TLS key type selection, defaulting to ECDH (see geneos help tls init)

• Split help and -h options - help now gives the long description and usage while --help/-h only gives short description plus usage

• pkg/geneos updates to XML parsing structures, fix regex handling

• pkg/gwhub updates for better API support (work in progress)

• pkg/config updates, with some API changes, to better support tools/geneos configuration handling and other refactoring and update ExpandString option NoDecode()

• Use upx for compression of binaries during releases build - saves about 2/3rd space

• Make consistent the handling of TLS certs and keys internally

• geneos ps will show the actual version of each instance running, in case the base symlink has been updated and the process not restarted

• Quite a bit of redecorating inside tools/geneos internal packages to make things clearer (refactoring, merge and split of functions etc.)

• tools/geneos - Initial support for "remote only" working; i.e. if GENEOS_HOME is not set but there are remotes then try to "do stuff". This will break if you perform a local operation such as add as the root then is the current directory. Further work required, but getting Windows support working again is on the way.

• tools/geneos - Add a basic --install option to package update to allow checking of package that match the ones being updated and download them if found.

v1.7.0 Fixes

• #156 - fix progressbar newline issue

• #155 - refactor instance home directory handling (mostly internal)

• #153 - fix local install of only components available

• tools/geneos - fix order of columns in plain geneos ls

• #38 - fix update stop/start as well as a number of related issues in package install and the handling of fa2 packages

• #152 - call Rebuild() on every instance config save - then instance.setup.xml will stay in sync with config

• #150 - document deploy behaviour when versions clash

1.7.0 Known Issues

• #165 - restarting while updating SANs is not working

Release v1.7.0-beta3 - Almost ready!

Change Log

Version v1.7.0-beta3

Released 2023-07-10

Please report issues via github or the ITRS Community Forum.

v1.7.0 Changes

• tools/geneos - Optimisation and parallel execution. All operations on Geneos instances are now run in parallel which has resulted in significant improvements in responsiveness and has reduced delays waiting for things to happen on larger installations and remote hosts. While extensive testing has taken place to ensure that the underlying functionality is not affected, there may still be issues in some cases - please report them as soon as you can!

• Add support for TLS key type selection, defaulting to ECDH (see geneos help tls init)

• Split help and -h options - help now gives the long description and usage while --help/-h only gives short description plus usage

• pkg/geneos updates to XML parsing structures, fix regex handling

• pkg/gwhub updates for better API support (work in progress)

• pkg/config updates, with some API changes, to better support tools/geneos configuration handling and other refactoring and update ExpandString option NoDecode()

• Use upx for compression of binaries during releases build - saves about 2/3rd space

• Make consistent the handling of TLS certs and keys internally

• geneos ps will show the actual version of each instance running, in case the base symlink has been updated and the process not restarted

• Quite a bit of redecorating inside tools/geneos internal packages to make things clearer (refactoring, merge and split of functions etc.)

• tools/geneos - Initial support for "remote only" working; i.e. if GENEOS_HOME is not set but there are remotes then try to "do stuff". This will break if you perform a local operation such as add as the root then is the current directory. Further work required, but getting Windows support working again is on the way.

v1.7.0 Fixes

• #156 - fix progressbar newline issue

• #155 - refactor instance home directory handling (mostly internal)

• #153 - fix local install of only components available

• tools/geneos - fix order of columns in plain geneos ls

• #38 - fix update stop/start as well as a number of related issues in package install and the handling of fa2 packages

• #152 - call Rebuild() on every instance config save - then instance.setup.xml will stay in sync with config

• #150 - document deploy behaviour when versions clash

1.7.0 Known Issues

• #165 - restarting while updating SANs is not working