Merge branch '4.9'

smcvb · smcvb · commit 08bedd917dd4 · 2024-10-02T14:27:20.000+02:00
# Conflicts:
#	README.md
#	axon-framework/monitoring/README.md
diff --git a/README.md b/README.md
@@ -1,5 +1,12 @@
 # Introduction
 
+> Legacy Documentation Warning!
+>
+> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
+> You can find the latter at https://docs.axoniq.io/
+>
+> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
+
 Welcome to the Axon Manual!
 
 Axon provides the Axon Framework and the Axon Server to help build applications centered on three core concepts - CQRS \(Command Query Responsibility Segregation\) / Event Sourcing and DDD \(Domain Driven Design\).
@@ -13,7 +20,9 @@ There, you will find information about Axon training, support options, upcoming
 > **Monitoring with AxonIQ Console**
 >
 > We have built a platform that makes it very easy to monitor your Axon Framework applications.  It measures everything in your applications, aggregates, metrics and processors.
+>
 > ![../../.gitbook/assets/console/graphs.png](../../.gitbook/assets/console/graphs.png)
+>
 > You can find more information on our [product page](https://www.axoniq.io/products/axoniq-console) or [log in directly](https://console.axoniq.io/).
 
 ## How to use this guide
diff --git a/architecture-overview/README.md b/architecture-overview/README.md
@@ -1,5 +1,12 @@
 # Architecture Overview
 
+> Legacy Documentation Warning!
+>
+> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
+> You can find the latter at https://docs.axoniq.io/
+>
+> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
+
 Axon based applications follow an architectural pattern which is based on the principles of Domain-Driven Design \(DDD\), Command Query Responsibility Segregation \(CQRS\) and Event-Driven Architecture \(EDA\). The combination of these principles make Axon based applications more robust and adaptable to accommodate change required by the changes in our business domain.
 
 Axon finds its use in both large monolithic applications, wherein the internal structure is essential to keep the monolith adaptable, as well as microservices, where the distributed nature of the system adds complexity.
diff --git a/axon-framework/introduction.md b/axon-framework/introduction.md
@@ -1,14 +1,13 @@
 # Introduction
 
-This section of the reference guide intends to cover in detail the capabilities that the Axon Framework provides to help build applications based on [CQRS/DDD](../architecture-overview/#ddd-and-cqrs) and [Event Sourcing](../architecture-overview/event-sourcing.md)
-
-> Breaking Changes in Axon Framework 4.7!
+> Legacy Documentation Warning!
 >
-> Against our normal approach towards minor releases, we sadly had to introduce breaking changes between Axon Framework 4.6 and 4.7.
-> Our apologies for this.
+> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
+> You can find the latter at https://docs.axoniq.io/
 >
-> To help you with your upgrade we have constructed a dedicated page [here](upgrading-to-4-7.md) that helps you on your path to upgrade to 4.7.
-> If you find any irregularities concerning your upgrade, be sure to reach out to us!
+> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
+
+This section of the reference guide intends to cover in detail the capabilities that the Axon Framework provides to help build applications based on [CQRS/DDD](../architecture-overview/#ddd-and-cqrs) and [Event Sourcing](../architecture-overview/event-sourcing.md)
 
 A summary of the various sub-sections is given below.
 
diff --git a/axon-framework/monitoring/README.md b/axon-framework/monitoring/README.md
@@ -6,7 +6,9 @@ This section contains all information regarding metrics, tracing and monitoring
 > **Monitoring with AxonIQ Console**
 > 
 > We have built a platform that makes it very easy to monitor your Axon Framework applications.  It measures everything in your applications, aggregates, metrics and processors.
+>
 > ![../../.gitbook/assets/console/graphs.png](../../.gitbook/assets/console/graphs.png)
+>
 > You can find more information on our [product page](https://www.axoniq.io/products/axoniq-console) or [log in directly](https://console.axoniq.io/).
 
 A summary of the various subsections is given below.
diff --git a/axon-server/administration/monitoring/diagnostics.md b/axon-server/administration/monitoring/diagnostics.md
@@ -2,7 +2,7 @@
 
 When reaching out to AxonIQ for Axon Server support related questions, the support team needs information about the environment and its current state. Axon Server provides an endpoint that collects the relevant information into a zip file.
 
-The URL is `internal/diagnose/download`.
+The URL is `v1/diagnose/download` (in Axon Server versions before 2024.0 the URL is `internal/diagnose/download`).
 
 The zip file contains the following information:
 
diff --git a/axon-server/introduction.md b/axon-server/introduction.md
@@ -1,5 +1,12 @@
 # Introduction
 
+> Legacy Documentation Warning!
+>
+> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
+> You can find the latter at https://docs.axoniq.io/
+>
+> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
+
 Axon Server is the flagship product of AxonIQ, and companion product to the Open Source Axon Framework. Axon Server itself is available in two editions, Standard and Enterprise, with Axon Server Standard Edition \(SE\) available under the AxonIQ Open Source license, while Axon Server Enterprise Edition \(EE\) is licensed as a commercial product with a full range of support options.
 
 This section of the reference guide covers all aspects around Setup/Administration/Security/Tuning and Configuration of your Axon Server deployment \(SE / EE\)
diff --git a/extensions/jgroups.md b/extensions/jgroups.md
@@ -1,5 +1,12 @@
 # JGroups
 
+> Legacy Documentation Warning!
+>
+> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
+> You can find the latter at https://docs.axoniq.io/
+>
+> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
+
 JGroups is an alternative approach to distributing command bus \(commands\) besides Axon Server.
 
 The `JGroupsConnector` uses \(as the name already gives away\) [JGroups](http://www.jgroups.org/) as the underlying discovery and dispatching mechanism. 
diff --git a/extensions/jobrunrpro.md b/extensions/jobrunrpro.md
@@ -1,5 +1,12 @@
 # JobRunrPro
 
+> Legacy Documentation Warning!
+>
+> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
+> You can find the latter at https://docs.axoniq.io/
+>
+> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
+
 The purpose of this extension is to leverage some features only available in the Pro version of [JobRunr](https://www.jobrunr.io/en/documentation/pro/).
 Only the Pro version allows to search existing jobs by status and label. This is required for the deadline manager to implement the `cancelAll` methods.
 The [deadline managers](../axon-framework/deadlines/deadline-managers.md) section has more in depth information on deadline managers.
diff --git a/extensions/kafka.md b/extensions/kafka.md
@@ -1,5 +1,12 @@
 # Kafka
 
+> Legacy Documentation Warning!
+>
+> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
+> You can find the latter at https://docs.axoniq.io/
+>
+> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
+
 Apache Kafka is a very popular system for publishing and consuming events. Its architecture is fundamentally different from most messaging systems and combines speed with reliability.
 
 Axon provides an extension dedicated to _publishing_ and _receiving_ event messages from Kafka. The Kafka Extension should be regarded as an alternative approach to distributing events, besides \(the default\) Axon Server. It's also possible to use the extension to stream events from Kafka to Axon server, or the other way around.
diff --git a/extensions/kotlin.md b/extensions/kotlin.md
@@ -1,5 +1,12 @@
 # Kotlin
 
+> Legacy Documentation Warning!
+>
+> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
+> You can find the latter at https://docs.axoniq.io/
+>
+> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
+
 [Kotlin](https://kotlinlang.org/) is a programming language which interoperates fully with Java and the JVM. As Axon is written in Java it can be used in conjunction with Kotlin too, offering a different feel when using the framework.
 
 Some of Axon's API's work perfectly well in Java, but have a rather awkward feel when transitioning over to Kotlin. The goal of the [Kotlin Extension](https://github.com/AxonFramework/extension-kotlin) is to remove that awkwardness, by providing [inline and reified](https://kotlinlang.org/docs/reference/inline-functions.html) methods of Axon's API.
diff --git a/extensions/mongo.md b/extensions/mongo.md
@@ -1,5 +1,12 @@
 # Mongo
 
+> Legacy Documentation Warning!
+>
+> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
+> You can find the latter at https://docs.axoniq.io/
+>
+> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
+
 The `MongoEventStorageEngine` has an `@PostConstruct` annotated method, called `ensureIndexes` which will generate the indexes required for correct operation. That means, when running in a container that automatically calls `@PostConstruct` handlers, the required unique index on "Aggregate Identifier" and "Event Sequence Number" is created when the event store is created.
 
 Note that there is always a balance between query optimization and update speed. Load testing is ultimately the best way to discover which indices provide the best performance.
diff --git a/extensions/reactor/reactor.md b/extensions/reactor/reactor.md
@@ -1,5 +1,12 @@
 # Reactor
 
+> Legacy Documentation Warning!
+>
+> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
+> You can find the latter at https://docs.axoniq.io/
+>
+> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
+
 Overlooking Axon Frameworks architecture, you can notice that in general systems using the framework are "Message Driven", "Responsive", "Resilient" and "Elastic".
 According to [Reactive Manifesto](https://www.reactivemanifesto.org/), the same holds for Reactive Systems in general. 
 
diff --git a/extensions/spring-amqp.md b/extensions/spring-amqp.md
@@ -1,5 +1,12 @@
 # Spring AMQP
 
+> Legacy Documentation Warning!
+>
+> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
+> You can find the latter at https://docs.axoniq.io/
+>
+> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
+
 Spring AMQP is an alternative approach to distributing events, besides Axon Server which is the default.
 
 Axon provides out-of-the-box support to transfer events to and from an AMQP message broker, such as [RabbitMQ](https://www.rabbitmq.com/).
diff --git a/extensions/spring-aot.md b/extensions/spring-aot.md
@@ -1,5 +1,12 @@
 # Spring Ahead of Time
 
+> Legacy Documentation Warning!
+>
+> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
+> You can find the latter at https://docs.axoniq.io/
+>
+> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
+
 [Spring AOT processing](https://docs.spring.io/spring-boot/docs/current/reference/html/native-image.html#native-image.introducing-graalvm-native-images.understanding-aot-processing)
 is part of the process to create a native binary from a Spring (Boot) application. This extension will help in adding a
 lot of hints which are needed for Axon Framework. Please note this extension can only be used with Spring Boot 3, as
diff --git a/extensions/spring-cloud.md b/extensions/spring-cloud.md
@@ -1,5 +1,12 @@
 # Spring Cloud
 
+> Legacy Documentation Warning!
+>
+> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
+> You can find the latter at https://docs.axoniq.io/
+>
+> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
+
 Spring Cloud is an alternative approach to distributing the command bus \(commands\), besides Axon Server as the default.
 
 The Spring Cloud Extension uses the service registration and discovery mechanism described by [Spring Cloud](https://spring.io/projects/spring-cloud) for distributing the command bus. 
diff --git a/extensions/tracing.md b/extensions/tracing.md
@@ -1,5 +1,12 @@
 # Tracing
 
+> Legacy Documentation Warning!
+>
+> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
+> You can find the latter at https://docs.axoniq.io/
+>
+> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
+
 This extension provides functionality to trace command, event and query messages flowing through an Axon application by providing a specific implementation of the `CommandGateway`, `QueryGateway`, `MessageDispatchInterceptor` and `MessageHandlerInterceptor`. The [Open Tracing](https://opentracing.io/) standard is used to provide tracing capabilities, which thus allows usage of several Open Tracing implementations.
 
 With this instrumentation, we can chain synchronous and asynchronous commands and queries, all belonging to the same parent span. A request can be visualized and analysed across Axon clients, command handlers, query handlers and event handlers, when running together or decomposed and deployed as separate parts \(distributed\).
diff --git a/getting-started/quick-start.md b/getting-started/quick-start.md
@@ -1,5 +1,12 @@
 # Quick Start
 
+> Legacy Documentation Warning!
+>
+> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
+> You can find the latter at https://docs.axoniq.io/
+>
+> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
+
 Axon provides a _**Quick Start Toolkit**_ to familiarize yourself with the setup required for Axon Framework and Axon Server SE \(Standard Edition\).
 
 The only pre-requisite to run the Quick Start is to have a Java 8+ JRE in your system.
diff --git a/release-notes/README.md b/release-notes/README.md
@@ -1,5 +1,12 @@
 # Release Notes
 
+> Legacy Documentation Warning!
+>
+> Since the first of October 2024, we moved Axon's documentation from the "Reference Guide" to "AxonIQ Docs."
+> You can find the latter at https://docs.axoniq.io/
+>
+> Hence, if you are looking for the documentation for newer versions of Axon Framework, Axon Server, or any of the Framework Extensions, we strongly recommend you browse to [AxonIQ Docs](https://docs.axoniq.io/) instead.
+
 This section details out all the release notes for the Major/Minor versions released up to date for both the Axon Framework and Axon Server.
 
 | Section                             |                                                                  |
diff --git a/release-notes/rn-axon-server/README.md b/release-notes/rn-axon-server/README.md
@@ -4,7 +4,8 @@ The release notes section for the Axon Server for all major/minor releases.
 
 | Release Type                   | Version                                          |
 |:-------------------------------|:-------------------------------------------------|
-| _**Major**_                    | [2024.0](rn-as-major-releases.md#release-2024.0) |
+| _**Major**_                    | [2024.1](rn-as-major-releases.md#release-2024.1) |
+|                                | [2024.0](rn-as-major-releases.md#release-2024.0) |
 |                                | [2023.2](rn-as-major-releases.md#release-2023.2) |
 |                                | [2023.1](rn-as-major-releases.md#release-2023.1) |
 |                                | [2023.0](rn-as-major-releases.md#release-2023.0) |
diff --git a/release-notes/rn-axon-server/rn-as-major-releases.md b/release-notes/rn-axon-server/rn-as-major-releases.md
@@ -1,5 +1,32 @@
 # Major Releases
 
+## Release 2024.1
+
+### Persistent streams
+
+Persistent streams provide the option to open an event stream from a client and let Axon Server track the progress. This
+was already available as a preview version in 2024.0, but is now available by default. Persistent streams are supported
+in Axon Framework 4.10 as an alternative to tracking or pooled streaming event processors.
+
+For more information see [subcribing event processor](https://library.axoniq.io/axon_framework_old_ref/events/event-processors/subscribing.html) in the Axon Framework section.
+
+### Bug fixes and improvements
+
+- Prevent stale threads when an Axon Server node closes the connection to another node
+- Clean up metrics from disconnected clients
+- prevent WARN log messages when a query completed message was received from an unexpected client
+- Allow context with ephemeral events without a license
+- Fix for listing event processors when there are more than 512 event processors
+
+### Docker image changes
+
+The default Java version for the Docker images has changed from Java 11 to Java 17. This means that the docker images with tag "latest", "latest-nonroot", "2024.1.0", and "2024.1.0-nonroot" use Java 17. Java 11 based images are still available with the "-jdk-11" extensions in the tag name.
+
+### Dependency updates
+
+- gRPC version updated to 1.65.1
+
+
 ## Release 2024.0
 
 ### Database Update
diff --git a/release-notes/rn-axon-server/rn-as-minor-releases.md b/release-notes/rn-axon-server/rn-as-minor-releases.md

Original file line number	Diff line number	Diff line change
`@@ -6,7 +6,9 @@ This section contains all information regarding metrics, tracing and monitoring`
`6`	`6`	`> Monitoring with AxonIQ Console`
`7`	`7`	`>`
`8`	`8`	`> We have built a platform that makes it very easy to monitor your Axon Framework applications. It measures everything in your applications, aggregates, metrics and processors.`
	`9`	`+>`
`9`	`10`	`> ![../../.gitbook/assets/console/graphs.png](../../.gitbook/assets/console/graphs.png)`
	`11`	`+>`
`10`	`12`	`> You can find more information on our [product page](https://www.axoniq.io/products/axoniq-console) or [log in directly](https://console.axoniq.io/).`
`11`	`13`
`12`	`14`	`A summary of the various subsections is given below.`