Releases: ITRS-Group/cordial
First v1.3.0 test release
Changelog
Version v1.3.0-beta - 2022/10/24
Changes
- PagerDuty integration
- Merged ServiceNow integration, single binary build
- tools/geneos: add instance protection against stop (and related) or delete commands
- tools/geneos: support legacy command through emulating
*ctl
named commands - tools/geneos: allow remote operations without local directories
Fixes
- libemail: fix default _SUBJECT handling
- tools/geneos: split over complex 'init' command into sub-commands
- updated command usage information and reordered various internal function calls
- tools/geneos: add password verify to aes encode and a --once flag to override
- tools/geneos: add local JoinSlash and Dir to use Linux paths on Windows builds
- tools/geneos: fix ssh-agent support on windows
- tools/geneos: build on windows
- integrations: Add PagerDuty integration
- Integrations: Merge ServiceNow binaries into one
- tools/geneos: change internal remote Stat() API
Cordial v1.2.1 Release
We are very happy to announce this release of cordial v1.2.1.
There have been many changes since the original v1.0.0 release in June 2022. Please see the CHANGELOG.md file for more information.
The highlights include:
- Lots of
geneos
program improvements, including numerous bug fixes and new features like AES encoding support - The
pkg
s get many improvements, the XML-RPC packages have been refactored to work in a real-world application- New
config
package to add a variety of features over the top of viper - New
geneos
package to aid in the construction of XML configurations for Gateway and Netprobe. This is work in progress. - New
commands
package to provide the start of support for REST API Commands to the Gateway. This is work in progress. - New
xpath
package to work with the above and also the base for thesnapshot
command below. This is also work in progress. - New
cordial
package that initially carries a version constant and a general purpose LogInit() function. - New
process
package, providing a way to Daemon()ise callers on both Linux and Windows.
- New
- The Servicenow integration has clean-up work under the hood, adding better configuration file support using the new package(s) above
- Use of zerolog for logging in most cases throughout. The existing logger package will be deprecated in the next release
Individual binaries for Linux/AMD64 and example configurations can be found in Assets below, as well as tar.gz and zip files containing the same files for convenience.
Work continues and we appreciate any feedback, suggestions or bug reports you have. For bugs please either raise an Issue in github or, for more general things, post on the ITRS Community Forum.
Changes before final release
Changes
Note: Only binaries are attached as Assets. All config files and scripts are unchanged to previous release candidates.
Note 2: It has been brought to our attention that the binaries require GLIBC 2.32 to run (or link in the case of libemail.so). This is because they were built on Ubuntu 22.04. The final release will be built on an older Centos 7 aged system, and this should ensure backward compatibility. Apologies for that.
Version v1.2.1-rc3 - 2022/10/07
Fixes
-
geneos
command fixes:- Fixed
init
download credential handling - Fixes JSON output format from
ls
commands - Local-only installs now work again (including default "latest" support)
- Fixed
-
Security
- Updated Labstack Echo to 4.9.0 to address security advisory CVE-2022-40083. To best of our knowledge this particular set of features was never used in this package.
Additional features and improvements
-
geneos
command improvements:- Added
--raw
toshow
to not output expanded configuration values - Many improvements and changes to the new
aes
sub-commands. Please see documentation for details - Removed built-in opaquing of credentials in output in favour of new
${enc:...}
support
- Added
-
libemail.so
gets direct passwords back, with ExpandString support. See documentation for details -
General package improvements
- Enhanced
OpenLocalFileOrURL
to support~/
paths - Enhanced
ExpandString
to support direct file paths and updates package docs further
- Enhanced
Updates and fixes, mainly to AES command support
This release candidate build on the work in RC1 with additional clean-up of the new geneos aes
commands, refactoring of flags and sub-commands and the addition of features to make your life easier.
Some of these changes required updates to internal packages which may have unforeseen impact on other function which have not been seen in limited testing.
The geneos
README.md file is still a work in progress so please double check the usage text (with the -h
flag to any command) to confirm the precise options available.
Fixes to instance config support and related enhancements
Change Log
Version v1.2.1-rc1 - 2022/09/28
Fixes
-
geneos
instance configuration files now have expansion applied to string-like values. This means, for example, that changing theversion
of an instance fromactive_prod
will correctly be reflected in the executable path and library paths. Previously these needed to be manually changed. Please note that existing instance configuration files will NOT be updated and will require editing. You can go from:"program": ".../packages/gateway/active_prod/gateway2.linux_64",
to
"program": "${config:install}/${config:version}/${config:binary}",
For a complete list of supported expansions see ExpandString()
in the config
package.
Additional features and improvements
ExpandString()
was enhanced to add aconfig:
prefix so that configurations with a flat structure, i.e. no "." in names, could be referenced.- To support the changes above in instance configurations a new method was added -
ExpandAllSettings()
- and thegeneos show
command enhanced to display both expanded and raw configurations via the new--raw
flag. - Additional configuration item support in the
geneos
package
RC2 to address minor issues and enable features
Change Log
Version v1.2.0-rc2 - 2022/09/26
Fixes found during testing
- Removed support for
$var
format expansion, now it's${var}
only. This prevents configuration issues when, for example, plain text passwords contain dollar signs. The documented workaround if you need to include literal${
in a configuration value still applies.
Additional features and improvements
- Added command
geneos aes update
. This may still be renamed before final release togeneos aes import
depending on feedback. - Improvements to
geneos aes new
- Improvements, clarification to package and function documentation
- Code clean-up and refactor to make some internals more understandable and to remove code duplication
Cordial Tools - Release Candidate
Version v1.2.0-RC1
Breaking Changes
There are quite a lot of changes to the various components and packages since the original v1.0.0. Given that almost no-one outside the components contained in the repo itself is using the public package APIs I have broken the rules around semantic versioning and changed parts of the API.
Highlights
- Package changes
- Breaking changes: Geneos
api
andapi-streams
XML-RPC supporting packages have had a big clean-up to make them easier to use - New
config
package to overlayviper
with support for value expansion and crypto convenience functions - New
geneos
package to aid in the construction of XML configurations for Gateway and Netprobe. This is work in progress. - New
commands
package to provide the start of support for REST API Commands to the Gateway. This is work in progress. - New
xpath
package to work with the above and also the base for thesnapshot
command below. This is also work in progress. - New
cordial
package that initially carries a version constant. - New
process
package, providing a way to Daemon()ise callers on both Linux and Windows. - Deprecation Notice: The
logger
package will probably be removed as it was a stop-gap and is slowly being replaced withzerolog
- Breaking changes: Geneos
- Addition of the following commands to
tools/geneos
:aes
- Manage Geneos key-files and encoding/decoding of valuessnapshot
- Take dataview snapshots directly from the command line (requires GA5.14+)
- ServiceNow integration updates
- Configuration support is now direct with
config
above, allowing full value expansions support, including encoded credentials.
- Configuration support is now direct with
- Logging changes
- The logging in
tools/geneos
has been migrated tozerolog
from the internallogger
for a more flexible package. This will be further rolled-out to other parts of the repo in time.
- The logging in
Initial release
This is the first release to the official ITRS Group repos of the tools and libraries available previously on wonderland.org/geneos. These tools are however not supported by ITRS and are made available because they may prove useful. Please use our Community Forum to ask questions or raise issues.
The three primary features in this initial release are:
- A drop-in replacement for the standard libemail that adds support for SMTP authentication, TLS support and an additional entry point to send multipart HTML+text emails. See libraries/libemail for more information. A downloadable binary is attached to this release.
- A
geneos
command line tool for managing your Geneos environment. This can take the place of oldergeneos-utils
that includegatewayctl
,netprobectl
etc. See tools/geneos for more information. A downloadable binary is attached to this release. - An older set of packages to interact with the XML-RPC API sampler in the Netprobe. This is located under the
pkg
directory.
If you find these tools useful or if you have bugs to report or want to contribute code please use our Community Forum to do so. We are happy to see PRs too.