Aries-cloudagent

the correction of a regression in Release 0.8.0 related to the use of plugins
(see [\2255]). Highlights include making it easier to use tracing in a
development environment to collect detailed performance information about what
is going in within ACA-Py.

This release pulls in [indy-shared-rs] Release 3.3 which fixes a serious issue in AnonCreds verification, as described in issue [\2036], where the verification of a presentation with multiple revocable credentials fails when using [Aries Askar] and the
other shared components. This issue occurs only when using [Aries Askar] and [indy-credx Release 3.3].

An important new feature in this release is the ability to set some instance
configuration settings at the tenant level of a multi-tenant deployment. See PR
[\2233].

There are no breaking changes in this release.

[\2255]: https://github.com/hyperledger/aries-cloudagent-python/pull/2255
[\2233]: https://github.com/hyperledger/aries-cloudagent-python/pull/2233
[\2036]: https://github.com/hyperledger/aries-cloudagent-python/issues/2036
[indy-shared-rs]: https://github.com/hyperledger/indy-shared-rs
[Aries Askar]: https://github.com/hyperledger/aries-askar

execute the `upgrade` command. The `upgrade` command is needed for 0.8.0 Pull
Request [\2116] - "UPGRADE: Fix multi-use invitation performance", which is
useful for (at least) deployments of ACA-Py as a mediator. In the release, the
upgrade process is revamped, and documented in [Upgrading ACA-Py].

Key points about upgrading for those with production, pre-0.8.1 ACA-Py deployments:

- Upgrades now happen **automatically** on startup, when needed.
- The version of the last executed upgrade, even if it is a "no change" upgrade,
is put into secure storage and is used to detect when future upgrades are needed.
- Upgrades are needed when the running version is greater than the version is
secure storage.
- If you have an existing, pre-0.8.1 deployment with many connection records,
there may be a delay in starting as an upgrade will be run that loads and saves
every connection record, updating the data in the record in the process.
- A mechanism is to be added (see [Issue 2201]) for preventing an upgrade
running if it should not be run automatically, and requires using the
`upgrade` command. To date, there has been no need for this feature.
- See the [Upgrading ACA-Py] document for more details.

Postgres Support with Aries Askar

Recent changes to [Aries Askar] have resulted in Askar supporting Postgres
version 11 and greater. If you are on Postgres 10 or earlier and want to upgrade
to use Askar, you must migrate your database to Postgres 10.

We have also noted that in some container orchestration environments such as
[Red Hat's OpenShift] and possibly other [Kubernetes] distributions, Askar using
[Postgres] versions greater than 14 do not install correctly. Please monitor
[Issue \2199] for an update to this limitation. We have found that Postgres 15 does
install correctly in other environments (such as in `docker compose` setups).

[\2116]: https://github.com/hyperledger/aries-cloudagent-python/issues/2116
[Upgrading ACA-Py]: docs/deploying/UpgradingACA-Py.md
[Issue 2201]: https://github.com/hyperledger/aries-cloudagent-python/issues/2201
[Aries Askar]: https://github.com/hyperledger/aries-askar
[Red Hat's OpenShift]: https://www.openshift.com/products/container-platform/
[Kubernetes]: https://kubernetes.io/
[Postgres]: https://www.postgresql.org/
[Issue \2199]: https://github.com/hyperledger/aries-cloudagent-python/issues/2199

Categorized List of Pull Requests

- Fixes for the `upgrade` Command
- Change upgrade definition file entry from 0.8.0 to 0.8.1 [\2203](https://github.com/hyperledger/aries-cloudagent-python/pull/2203) [swcurran](https://github.com/swcurran)
- Add Upgrading ACA-Py document [\2200](https://github.com/hyperledger/aries-cloudagent-python/pull/2200) [swcurran](https://github.com/swcurran)
- Fix: Indy WalletAlreadyOpenedError during upgrade process [\2196](https://github.com/hyperledger/aries-cloudagent-python/pull/2196) [shaangill025](https://github.com/shaangill025)
- Fix: Resolve Upgrade Config file in Container [\2193](https://github.com/hyperledger/aries-cloudagent-python/pull/2193) [shaangill025](https://github.com/shaangill025)
- Update and automate ACA-Py upgrade process [\2185](https://github.com/hyperledger/aries-cloudagent-python/pull/2185) [shaangill025](https://github.com/shaangill025)
- Adds the upgrade command YML file to the PyPi Release [\2179](https://github.com/hyperledger/aries-cloudagent-python/pull/2179) [swcurran](https://github.com/swcurran)
- Test and Documentation
- 3.7 and 3.10 unittests fix [\2187](https://github.com/hyperledger/aries-cloudagent-python/pull/2187) [Jsyro](https://github.com/Jsyro)
- Doc update and some test scripts [\2189](https://github.com/hyperledger/aries-cloudagent-python/pull/2189) [ianco](https://github.com/ianco)
- Create UnitTests.md [\2183](https://github.com/hyperledger/aries-cloudagent-python/pull/2183) [swcurran](https://github.com/swcurran)
- Add link to recorded session about the ACA-Py Integration tests [\2184](https://github.com/hyperledger/aries-cloudagent-python/pull/2184) [swcurran](https://github.com/swcurran)
- Release management pull requests
- 0.8.1 [\2207](https://github.com/hyperledger/aries-cloudagent-python/pull/2207) [swcurran](https://github.com/swcurran)
- 0.8.1-rc2 [\2198](https://github.com/hyperledger/aries-cloudagent-python/pull/2198) [swcurran](https://github.com/swcurran)
- 0.8.1-rc1 [\2194](https://github.com/hyperledger/aries-cloudagent-python/pull/2194) [swcurran](https://github.com/swcurran)
- 0.8.1-rc0 [\2190](https://github.com/hyperledger/aries-cloudagent-python/pull/2190) [swcurran](https://github.com/swcurran)

ACA-Py 0.7.4 with explicit invitations and without auto-accept
broken](https://github.com/hyperledger/aries-cloudagent-python/pull/1881). A
couple of other PRs were added to the release, as listed below, and in
[Milestone 0.7.5](https://github.com/hyperledger/aries-cloudagent-python/milestone/6).

List of Pull Requests

- Changelog and version updates for version 0.7.5-rc1 [\1985](https://github.com/hyperledger/aries-cloudagent-python/pull/1985) ([swcurran](https://github.com/swcurran))
- Endorser doc updates and some bug fixes [\1926](https://github.com/hyperledger/aries-cloudagent-python/pull/1926) ([ianco](https://github.com/ianco))
- Fix: web.py dependency - integration tests & demos [\1973](https://github.com/hyperledger/aries-cloudagent-python/pull/1973) ([shaangill025](https://github.com/shaangill025))
- Endorser write DID transaction [\1938](https://github.com/hyperledger/aries-cloudagent-python/pull/1938) ([ianco](https://github.com/ianco))
- fix: didx request cannot be accepted [\1881](https://github.com/hyperledger/aries-cloudagent-python/pull/1881) ([rmnre](https://github.com/rmnre))
- Fix: OOB - Handling of minor versions [\1940](https://github.com/hyperledger/aries-cloudagent-python/pull/1940) ([shaangill025](https://github.com/shaangill025))
- fix: Safely shutdown when root_profile uninitialized [\1960](https://github.com/hyperledger/aries-cloudagent-python/pull/1960) ([frostyfrog](https://github.com/frostyfrog))
- feat: 00B v1.1 support [\1962](https://github.com/hyperledger/aries-cloudagent-python/pull/1962) ([shaangill025](https://github.com/shaangill025))
- 0.7.5 Cherry Picks [\1967](https://github.com/hyperledger/aries-cloudagent-python/pull/1967) ([frostyfrog](https://github.com/frostyfrog))
- Changelog and version updates for version 0.7.5-rc0 [\1969](https://github.com/hyperledger/aries-cloudagent-python/pull/1969) ([swcurran](https://github.com/swcurran))
- Final 0.7.5 changes [\1991](https://github.com/hyperledger/aries-cloudagent-python/pull/1991) ([swcurran](https://github.com/swcurran))

- 0.7.4-rc5 changelog, version and ReadTheDocs updates [\1838](https://github.com/hyperledger/aries-cloudagent-python/pull/1838) ([swcurran](https://github.com/swcurran))
- Update changelog and version for 0.7.4-rc4 [\1830](https://github.com/hyperledger/aries-cloudagent-python/pull/1830) ([swcurran](https://github.com/swcurran))
- Changelog, version and ReadTheDocs updates for 0.7.4-rc3 release [\1817](https://github.com/hyperledger/aries-cloudagent-python/pull/1817) ([swcurran](https://github.com/swcurran))
- 0.7.4-rc2 update [\1771](https://github.com/hyperledger/aries-cloudagent-python/pull/1771) ([swcurran](https://github.com/swcurran))
- Some ReadTheDocs File updates [\1770](https://github.com/hyperledger/aries-cloudagent-python/pull/1770) ([swcurran](https://github.com/swcurran))
- 0.7.4-RC1 Changelog intro paragraph - fix copy/paste error [\1753](https://github.com/hyperledger/aries-cloudagent-python/pull/1753) ([swcurran](https://github.com/swcurran))
- Fixing the intro paragraph and heading in the changelog of this 0.7.4RC1 [\1752](https://github.com/hyperledger/aries-cloudagent-python/pull/1752) ([swcurran](https://github.com/swcurran))
- Updates to Changelog for 0.7.4. RC1 release [\1747](https://github.com/hyperledger/aries-cloudagent-python/pull/1747) ([swcurran](https://github.com/swcurran))
- Prep for adding the 0.7.4-rc0 tag [\1722](https://github.com/hyperledger/aries-cloudagent-python/pull/1722) ([swcurran](https://github.com/swcurran))
- Added missed new module -- upgrade -- to the RTD generated docs [\1593](https://github.com/hyperledger/aries-cloudagent-python/pull/1593) ([swcurran](https://github.com/swcurran))
- Doh....update the date in the Changelog for 0.7.3 [\1592](https://github.com/hyperledger/aries-cloudagent-python/pull/1592) ([swcurran](https://github.com/swcurran))