Releases: ITRS-Group/cordial
Release v1.20.1 - Minor bug fixes
Change Log
Version v1.20.1
Note
Released 2025-01-16 - Please report issues via github or the ITRS Community Forum
Version v1.20.1 Changes
- Update Go to 1.23.4 and update all dependencies
Version v1.20.1 Fixes
-
tools/geneos
- Fix handling of older package directories that have
GA
orRA
prefixes and sort packages by the numeric part only using semantic versioning rules. - Don't stop if there is no private key in a TLS bundle, it may be supplied in a separate argument
- Do not overwrite existing root and signing certs and keys if they exist when running
geneos tls init
- Report if public key is missing or changes in user's
known_hosts
file - Always try to create the user config directory when writing configurations
- Fix handling of older package directories that have
-
gdna
- Remove dependency on license token when listing unused plugins
- Use timestamp of detailed report when updating summary report
- Update include file with additional configuration
Release v1.20.0 - Codename "Leo"
Change Log
Version v1.20.0 - Codename "Leo"
Note
Released 2024-12-13 - Please report issues via github or the ITRS Community Forum
Tip
This release is dedicated to my best boy Leo, who left us in late November 2024. In his 14 years he wasn't just a wonderful companion but he also helped, with his also now departed brothers, to save the lives of many other cats by donating blood through the RVC Animal Care Trust. For those reading this (and are near to Potters Bar in the UK) who believe their cats or dogs could become blood donors, please see https://www.rvc.ac.uk/small-animal-vet/specialist-referrals/for-pet-owners/pet-blood-donations
Version v1.20.0 Changes
-
gdna
- Thanks to all the valuable feedback, we have a completely new Monitoring Coverage and Version dashboards. These new dashboards depends on the changes to some reports, so you must also upgrade the
gdna
binary before you can use it. The old dashboard will continue to work with the new binary but we may remove some of the data driving it from reports in future releases. - Add a new report
multiple-os-versions-per-hostid
which shows all servers that have more than one OS version for associated probes. This is an indication of invalid (duplicated) host IDs.
- Thanks to all the valuable feedback, we have a completely new Monitoring Coverage and Version dashboards. These new dashboards depends on the changes to some reports, so you must also upgrade the
-
pkg/host
- Update <golang.org/x/crypto> dependency to mitigate potential issue with
ServerConfig.PublicKeyCallback
(CVE-2024-45337)
- Update <golang.org/x/crypto> dependency to mitigate potential issue with
-
tools/geneos
- Added support for SSH private key files to the
geneos host
subsystem - Added a
geneos host unset
command to work with the changes require for private key files and more
- Added support for SSH private key files to the
-
integrations/servicenow
- Expose
incident-query
configuration to allow custom lookups - Some code clean-up and refactoring
- Add example of using an encrypted API key between client and router
- Expose
Version v1.20.0 Fixes
-
gdna
- Fix
server-groups
report performance by joining on gateways as well as servers in the SQL query - Trim spaces from Gateway names and also update any existing entries to remove leading/trailing spaces. This can happen because even though we trim each incoming CSV field the Gateway name is prefixed
gateway:
and can hide a leading space
- Fix
-
tools/geneos
- Support Webserver > 7.1.1 byt removing unsupported Java command line option
- More updates to support OS and ARCH in downloads
- Always set
HOSTNAME
environment variable in Netprobe so that Collection Agent self-monitoring works without further updates (this was already the case forca3
components)
Release v1.19.2 - Really fix downloads of RHEL9 and Geneos 7.1 (replaces v1.19.1)
Change Log
Version v1.19.2
Note
Released 2024-11-14
Please report issues via github or the ITRS Community Forum.
This patch release replaces v1.19.1 which did not fully address the issue of downloading releases of aarch64 architecture.
Version v1.19.2 Fixes
-
tools/geneos
- Fix (work around) downloading of RHEL9 releases for 7.1 and later that could download the newly added aarch64 files.
Release v1.19.0 - adding sso-agent and updating ca3
Change Log
Version v1.19.0
Version v1.19.0 Highlights
- Added
sso-agent
totools/geneos
so you can now deploy and manage those easier - Updated
ca3
unmanaged/standalone Collection Agent component to work with new releases
Version v1.19.0 Changes
-
tools/geneos
- Added
sso-agent
as a component. You can now install and manage SSO Agent instances usinggeneos
. When adding a new instancegeneos
also creates anssokey
in a keystore file based on theconf/sso-agent.conf
settings. If the instance is created with a TLS certificate and key then these are also stored in the truststore/keystore alongside any certificate validation chain. At the moment the configuration file is treated as read-only, but in time we will add capabilities to make changes using the command line. - As part of the work to add ZIP file support for SSO Agent component releases, we've improved how all releases are unarchived and now files and directories have their modification times set based on the archive file data. Symbolic links only have their modification times set when unarchiving locally.
- Support the import of truststore/keystore files as JCEKS if loading as a JKS fails. Note that all truststore/keystore files are still written as JKS.
- Fixed
ca3
starting environment - Changed output of versions in the
geneos ps
command to be easier to read
- Added
Version v1.19.0 Fixes
-
tools/geneos
- A recent change meant that the user's AES keyfile would not be created when running
geneos login
for the first time, this is fixed - Explicitly disable file descriptor inheritance in started processes
- Show a version for Java bases components based on installed version
- Fix
deploy
commands to create the correct Geneos home directory, instead of always ageneos/
directory in the working directory
- A recent change meant that the user's AES keyfile would not be created when running
-
gdna
- Include gateways that have no other components listed, fixing reports of unused gateway.
Release v1.18.2
Change Log
Version v1.18.2
Note
This patch release replaces v1.18.1 to add a fix for webserver start-up from the geneos
command
Released 2024-10-29
Please report issues via github or the ITRS Community Forum.
Version v1.18.2 Fixes
-
tools/geneos
- Fix webserver starting command for releases after 7.0.4 to account for valid host header configuration, defaults to
.*
- Fix webserver command line option ordering
- Fix webserver starting command for releases after 7.0.4 to account for valid host header configuration, defaults to
-
tools/dv2email
- Fix example command XML to revert overzealous edit of
::
to.
- Fix example command XML to revert overzealous edit of
-
gdna
- Restore the
OTHER
row to Gateway and server group reports - Add
dynamicEntities
column togateway-groups
report - Update Gateway include to publish a schema for the
GDNA Process
sampler - Allow for unauthenticated SMTP (when username is empty)
- Restore the
-
pkg/email
- Allow for unauthenticated SMTP (when username is empty)
Release v1.18.0 - New Features for GDNA, bug fixes
Change Log
Version v1.18.0
Version v1.18.0 New Features
-
gdna
- This is the third public release of GDNA and we've added new features and made changes based on your feedback. The full details are in the documentation, but the highlights are:- Customise Level 1, Level 1 Optional and Level 2 plugin lists, including being able to require multiple instances of a plugin.
- Added a new filtering feature to include, exclude and group by categories such as Gateways, Servers etc. See FILTERS.md for more.
-
- The reporting code from
gdna
has been pulled out into it's own package so that we can reuse this for other projects later. The API is not yet final and there are missing features (such as severity colouring for HTML tables, likedv2email
can do) but it should settle in the next couple of releases. - The XLSX reporter can include headlines in each sheet, their inclusion and direction can be controlled by an option
- The reporting code from
Version v1.18.0 Changes
-
Updated to use Go 1.23.2
-
gdna
- Lists of plugins, such as in missing columns and lists per server and probe, now show how many instances after the plugin name, if there is more than one
- Command line sub-commands added to manage the filters and a growing set of right-click Commands added to the shipped include file
- The original support for external files for more limited filtering has been deprecated, so if you use these you will have to import the data using the new command line sub-commands
- When running "split" reports (the Gateway Overview and Details) the program now removes Dataviews that are no longer in the set of splits
- New reports have been added to list more actionable information about your estate and some existing reports have been enhanced
- Dataview Groups have been reworked from the ground up to offer a more logical view of
gdna
data - Every report now have a
reportName
headline to allow for better right-click command automation - Some YAML options have moved to allow for more logical grouping, so if you use
enable-for-dataview
orenable-for-xlsx
to control which reports are autogenerated then you will have to change these to the new layout, see the docs for more - Split the growing README.md file into a number of parts
- Added sub-commands to
gdna list
so nowgdna list reports
is needed to see what you can run. Also added the Dataview Group to the output - Other "under the hood" changes
- In the docker image the
gdna.yaml
file is now located in thegeneos
user's home are and not root directory - Allow
~/
as a prefix for thedb.file
config parameter, which is in turn pulled intodb.dsn
- Update default
db.dsn
to include?cache=shared
to avoid common locking issues
- In the docker image the
-
tools/geneos
geneos package install
will now limit installed components to those already existing unless given either a specific type or the--all
flag. This is intended to make downloads quicker as most users will only want to download component packages for instances that already exist.
Version v1.18.0 Fixes
-
tools/geneos
- Set the default local directory for downloaded packages when using
geneos package install -L
without a file or directory path - Restore installs from Nexus for internal users
- Fix
geneos package delete
to stop it removing the latest of each component package. Other fixes togeneos package delete
include not removing packages which are only used by instances as thepkgtype
(e.g.minimal/netprobe
) and the command now also ignores text prefixes on version directories likeGA
- Fix handling of wildcards that match nothing in ParseArgs()
- Fix regexp pattern that extracts release information to allow for old releases that used a
.
instead of-
between version and architecture
- Set the default local directory for downloaded packages when using
Release v1.17.1 - Fixes and new features for `gdna` and `tools/geneos`
Change Log
Version v1.17.1
Version v1.17.1 Changes
-
tools/geneos
- Add an
insecureport
parameter in Gateway instance template to support explicit insecure port when secure port is enabled by certificates. To use this you must update thegateway-instance.setup.xml.gotmpl
either manually or by usinggeneos init templates
- Related to the above, swap the main and alias names for
geneos init template(s)
- both will work.
- Add an
-
gdna
- Changed the text value in the
l3missing
column of various view fromyes
tomissing
to avoid ambiguity after user feedback. - Changed Dataview group name for optional gateway reports from
Coverage by Gateway
to simplyGateways
- Add a new
logic
field to conditional-format tests to control how multiple column tests are handled; Default to the previous behaviour of "AND" but can be "OR" (or "all" / "any" respectively) - Add a
geneos.dataview-create-delay
duration to allow smoothing of dataview creation when creating many hundreds of dataviews like for split reports. Only applies when a dataview is created, not during updates to existing ones - Add a "Version Summary" dashboard using new Geneos 7 data
- Revisit headline names and some column names for consistency and clarity
- Add a dashboard slide show to the docker image web server configuration
- Changed the text value in the
-
tools/san-config
- Add support for number of gateway sets to push to each probe, default 1 to maintain existing behaviour
- Treat gateway pairs as a single gateway in logging and counting
- Connection files can be served without a standby gateway port
- Use default ports when gateways in the configuration do not supply them
-
integrations/servicenow
- Add extra control over user name field with
incident-user
router parameters - Add a
trace
parameters to output all HTTP request and response data to stderr, for diagnostics - Clean-up some old code
- Add extra control over user name field with
Version v1.17.1 Fixes
-
tools/geneos
- Fix
copy
andmove
handling of source or destination in the form of@HOST
by updating command annotation and related changes ininstance.Match()
andparseargs()
. Before this fix, and after theparseargs()
review,geneos copy gw\* @remote
would not work correctly, making the creation of standby gateway sets much harder
- Fix
-
gdna
- Fix filtering of plugins, samplers and dynamic entities for multi-gateway reports, now numbers add up.
- Fix table used for building
servers
reporting tables - Fix spelling of
latest
columns in thesources
report - Fixes to some edge cases in probe and sampler counting
- When an OS or Version is an empty string, convert it to NULL for later reporting as Unknown
Release v1.17.0
Change Log
Version v1.17.0
v1.17.0 Changes
-
tools/geneos
- Add a
minimal
Netprobe flavour that can be added either as it's own component type or, more commonly, as a flavour of a normal Netprobe, e.g.geneos add netprobe minimal:probeName
- this extends the way you install a Fix Analyser probe as a SAN, e.g.geneos add san fa2:myFixSAN
- Add a
use-chain
parameter for all instances which defaults totrue
. Set this tofalse
usinggeneos set ... use-chain=false
to disable certificate validation using a configure chain file.
- Add a
-
gdna
- Add support for GA7.0.0 updates to
licd
reports and additional details from corresponding Gateways. This includes OS and component version information as well as enriched data for dynamic entities. - Add schema updates for the new table columns. Rollback should work - untested at time of writing - as no existing columns have changes, just new ones added.
- Add extra reports using the above data to a
Monitored Estate
groups, movingSources
to the same group. - Add new headlines for Gateway summary and detail Dataview and reports to show host, port and version - when available.
- Add new columns to
Missing Coverage
and Gateway summary and details to expose new data when available and rename existing columns (not used in dashboards) to better align with each other. - Update
Sources
Dataview and report to report a status ofSTALE
when a file is invalid. A remote source is always either up-to-date or inaccessible, which is a different status.
- Add support for GA7.0.0 updates to
-
tools/san-config
- Initial commit of a SAN remote configuration file server that allows dynamic building of SAN XML files using an YAML based inventory as well as autodetection of live Gateways from a preconfigured list.
- This tool is not yet in the main build as further changes and documentation are required for it to be more useful.
v1.17.0 Fixes
-
tools/geneos
-
geneos package
subsystem gets a wide review and a number of changes and fixes:uninstall
- change-f
to-F
for short form--force
for consistencyupdate
no longer supports the--install
flaginstall
- local files now ignore the--version
flag for file (non-directory) paths. For systems with a platform type (el8/el9) only install that platform type of non-platform specific archives. This allows components like web dashboard servers, which have no platform specific releases, to be installed.install
- many other changes around the handling of local files to improve what gets installed- Fix instance iteration so that only affected instances are updated and so on.
-
Fix
migrate
andset
andconfig set
to actually work with changes to parseargs() function. -
When adding components with key file support use the
${config:home}
value to pin key-file to working directories. Also, when saving a component configuration, such as duringmove
orcopy
update the key-file and previous key-file paths to use${config:home}
when source path matches the instance home directory.
-
-
gdna
- Fix misuse of source tables when building active gateway table (no actual data change as the servers table has the same data)
-
pkg/config
- Update
Path()
to better reflect the likely sources used byLoad()
. Passconfig.MustExist()
as an option toconfig.Path()
to get a result based on actual files rather than the likely file to be used.
- Update
-
integrations/servicenow
- Fix loading of configuration file in use of
config.Load()
options (explicitly use YAML)
- Fix loading of configuration file in use of
Patch Release v1.16.2 - Update GDNA Dashboard
Change Log
Version v1.16.2
Important
Release v1.16.2 replaces v1.16.1 which still included an incorrect GDNA dashboard
v1.16.2 Fixes
-
gdna
- Update Monitoring Coverage dashboard to remove references to
Demo Gateway
and improve visibility of per-plugin vertical bars.
- Update Monitoring Coverage dashboard to remove references to
Release v1.16.0 - Improvements to `geneos` and `gdna`
Change Log
Version v1.16.0
v1.16.0 Changes
-
gdna
- Updates to Dashboards to present more focused information to users
- Improve documentation, add block diagrams and update screenshots
- Added a
gdna version
command, when combined with--debug
will report dependencies used during build - Move to using
github.com/mattn/go-sqlite3
instead of pure Gomodernc.org/sqlite
-
Build
- Use Go 1.22.5
v1.16.0 Fixes
-
gdna
- Fix some SQL queries used in temporary table construction to give more accurate numbers for servers with multiple probes
- Fix dashboard XPaths to remove unnecessary Gateway and Managed Entity names
-
tools/geneos
- Fix
geneos package install
(andgeneos init
etc.) to have better support for local installation sources and to distinguish between el8/el9 platform specific archives over non-platform specific ones
- Fix
-
Build
- Fix Makefile/Dockerfile interdependencies and speed up documentation builds by downloading Chrome outside of underlying puppeteer installation