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 pkgs 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 the snapshot 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.
• 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)

• 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 to show 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

• 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

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 the version of an instance from active_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 a config: 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 the geneos 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 to geneos 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 and api-streams XML-RPC supporting packages have had a big clean-up to make them easier to use
  • New config package to overlay viper 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 the snapshot 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 with zerolog
• Addition of the following commands to tools/geneos:
  • aes - Manage Geneos key-files and encoding/decoding of values
  • snapshot - 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.
• Logging changes
  • The logging in tools/geneos has been migrated to zerolog from the internal logger for a more flexible package. This will be further rolled-out to other parts of the repo in time.

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:

1. 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.
2. A geneos command line tool for managing your Geneos environment. This can take the place of older geneos-utils that include gatewayctl, netprobectl etc. See tools/geneos for more information. A downloadable binary is attached to this release.
3. 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.