Skip to content

Commit

Permalink
add single space so we have a change
Browse files Browse the repository at this point in the history
  • Loading branch information
oliverrahner committed Jun 28, 2024
1 parent f37b238 commit 667aa72
Show file tree
Hide file tree
Showing 3 changed files with 115 additions and 1 deletion.
2 changes: 1 addition & 1 deletion modules/ROOT/pages/accounts.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ After 5 failed logons, the account will be locked for 1 hour.


== End-User (Farmers, Contractors, Consultants)

The end-user has access to the graphical user interface of the agrirouter for end users.

The user interface offers possibilities to handle the account:
Expand Down
73 changes: 73 additions & 0 deletions modules/ROOT/pages/ar2/overview.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
= agrirouter 2.0
:imagesdir: _images/

In 2023, DKE-Data has started a project to re-implement the agrirouter from scratch.
At the same time, we're transferring development and operations from our previous IT provider SAP
to REPLY.

Go-live of the new solution is currently planned for *31 August 2024*.

== What do you need to do to connect your systems to agrirouter 2.0?

In short: Nothing. We got you covered.

The main project goal from the beginning was *complete API compatibility* to our legacy system,
to ensure that partners *do not need to change code or upgrade dependencies* for a smooth transition.

There will be some small configuration changes required, but not at a specific date.

Where possible, we will monitor systems still using old configuration and if you are subject to these changes, we will let you know proactively after go-live.

=== Update the host name your endpoints communicate with

The host that your endpoints communicate with is currently `db0e6a47-f528-4f1b-a93e-ef8e4f5058ed.eu10.cp.iot.sap`. As you can see, this host name is in an SAP owned namespace. This host name will be delegated to DKE-Data *until 1 September 2025*, making it necessary to update your endpoints' communication before that date.

Depending on your implementation, there are several options:

==== Re-create router devices [only for MQTT + router devices]
If you are using the xref:../router-devices.adoc[MQTT implementation with router devices], you can re-create your router devices to update the host name.

==== Replace hostnames in Onboarding Responses [only for HTTP and MQTT _without_ router devices]
If you are using either HTTP or MQTT _without_ router devices, you can prevent your users from having to re-onboard by changing the host name in the Onboarding Responses you have stored for your users.

The exact changes to be made will be communicated after go-live.

==== Have your users re-onboard
If you are _not_ using MQTT router devices and you _can not_ change the Onboarding Responses on behalf of your users, e.g. for decentral Communication Units, your users *will have to re-onboard once between 1 September 2024 and 1 September 2025*.

For this, the users need to generate a new registration code from the agrirouter UI and enter it on their communication unit.

=== Change agrirouter's public key
If you are validating agrirouter's signature during the xref:../integration/authorization.adoc[authorize process], you will need to change the public key you perform these checks against.

We will communicate a new public key some months before actually changing the private key used for the signature. The recommended way to handle this change is to check the signature against both the old and the new public key in your code. That way, you do not depend on making the change at the exact time we replace the key.

== agrirouter 2.0 improvements

Apart from the pure reimplementation, we are also working hard to add improvements to agrirouter.

== New User Interface
The old UI was based on SAP's SAPUI5, better known under its code name "Fiori". The limitations of this framework were preventing us from some improvements to the UI.

The new UI was created from scratch to better guide the users and supporting them with the setup of their agrirouter eco-system.

== Better insights for us, better support for you

The old solution was a "black box" solution for DKE-Data, as the intellectual property was SAP's. The new solution belongs to DKE-Data, giving us way more flexbility in terms of analytics, troubleshooting and fixing issues.

== Improved self-service for developers
Some critical information for developers was not available in the UI in the past, such as subscription status of the endpoint and more information regarding the past messages sent to and received from an endpoint.

We worked to improve this to enable developers to troubleshoot more on their own, reducing their dependency on our support.

== Improved Stability
As most of our partners are aware, we had several phases with stability issues over the past years. The new agrirouter aims to improve this by a number of measures:

=== Scalability
We learned a lot about the bottlenecks present in the current solution and chose the new architecture and used frameworks to be very scalable in the future.

=== Observability
From the ground up, we designed the solution so that we can easily observe what is going on inside. That way, we can recognize issues _before_ they arise and pinpoint them faster than before _when_ they arise.

=== Monitoring & Alerting
Detailed monitoring and proactive alerting processes will be put in place to enable us to react to system load as soon as possible. Additionally, we can better identify the origin of messages and commands in order to contact parties who might put unnecessary load on the system and help them to mitigate any issues.
41 changes: 41 additions & 0 deletions modules/ROOT/pages/ar2/testing.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
= Testing your solution against agrirouter 2.0 QA

On 1 July 2024, our public test phase will start. This test phase will enable you to ensure that your system still works against agrirouter 2.0.

Our goal is to be completely backwards compatible and not require any changes in your code _for the production environments_. But because of, sometimes even very small, implementation details, there might be situations that require adjustments of our implementation to ensure that we can fulfill that goal.

The test phase lets you discover and such issues, so we can learn about and fix them.

== Preparing your systems


=== Choosing the right stage

There are generally two ways to approach testing your systems against the agrirouter 2.0 QA:

* switch one of your own instances to connect against the agrirouter 2.0 QA instead of the old agrirouter Production or QA system
* implement a bit of logic allowing your system to choose on a per-user basis what agrirouter environment to use; the parameters you need to think about are: which environment you use for onboarding _and_ which router device you use for communication with that specific endpoint

Depending on your development and deployment processes, one might be easier to do than the other. We recommend using the latter approach, because it provides more flexibility, even for the future.

=== Switching the environment

If you are using an SDK, the easiest solution is to upgrade to the latest versions, which include a class for connecting to the agrirouter 2.0 QA instance. The minimum versions are:

* .NET -> 3.8.0
* Python -> 2.1.0a1
* PHP -> d341490
* Java -> 3.2.0

Then you just need to replace all references to a Production or QA class to the class named `Ar2QualityAssuranceEnvironment` (.NET/PHP), `Ar2QA` (Java) or `Ar2Qa` (Python).

If you are _not_ using an SDK or you don't want to upgrade, you need to replace the following values:

|===
| URL | Prod | Old QA | ar 2.0 QA

| Base URL/ Authorization URL | https://goto.my-agrirouter.com | https://agrirouter-qa.cfapps.eu10.hana.ondemand.com | https://app.qa.agrirouter.farm
| Registration URL | https://onboard.my-agrirouter.com | https://agrirouter-registration-service-hubqa-eu10.cfapps.eu10.hana.ondemand.com | https://endpoint-service.qa.agrirouter.farm
|===

Additionally, the public key used for signing the authorize redirect needs to be replace, if you use it. You can find it on the xref:../keys.adoc[Keys page].

0 comments on commit 667aa72

Please sign in to comment.