Skip to content

About

Release candidate Eclipse Arrowhead Java v5.3.0 core and support systems with GSoSDD, GSoSDD, SysD, SysDD, SD and IDD documentation. Security analysis is available.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

283 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Eclipse Arrowhead 5.3.0 — Java reference implementation

The Java-Spring implementation of the Eclipse Arrowhead 5 framework: the five core systems, twenty support systems (one of them legacy), the shared common library, the system and interface documentation, the SysML profile and library, and the tools that verify them. It extends the official Java-Spring 5.2.2 release (five core systems, three support systems) into a complete local-cloud and System-of-LocalClouds environment.

Primary source: this is the primary Java implementation tree of its Eclipse workspace, designated on 2026-10-30 (workspace policy PRIMARY-SOURCES.md, one level above this repository). The Go and Rust implementations live in the sibling trees Eclipse-Arrowhead-go and Eclipse-Arrowhead-rust.

Versions. The primary Java framework constant, common/Core Maven versions and support application versions are aligned to the 5.3.0 release candidate. Independent service versions and wire-contract identifiers retain their own values; for example, SysMonitor-AMQP-IDD-5.2.2 is unchanged. Older build/deployment records do not by themselves qualify the aligned artifacts (see release notes).

Core systems

ah5-core-java-spring/ is one Maven reactor with a module per system.

System Module Default port
ServiceRegistry serviceregistry 8443
Authentication authentication 8444
ConsumerAuthorization consumer-authorization 8445
DynamicServiceOrchestration serviceorchestration-dynamic 8441
SimpleStoreServiceOrchestration serviceorchestration-simple 8442

ah5-common-java-spring/ holds the shared library (common-utils, data-transfer-objects): system lifecycle and registration, the security filter chain, the secure-profile guard, generalManagement and the native sysMonitor publisher.

Support systems

Each support system is a self-contained folder with its own source, Maven build, Dockerfile, configuration, compose.yaml and documentation; deployment instructions are in DEPLOYMENT.md or, for GraphDBManager, its README. All but AIGym compile a private copy of the common library under vendor/, so no folder depends on a sibling at build time.

System Folder Default port Purpose
AIGym ah5-AIGym-java-spring 8478 model sandbox for AI clients
Blacklist ah5-Blacklist-java-spring 8464 blocks systems from using the cloud
CertificateAuthority ah5-CertificateAuthority-java-spring 8448 issues and revokes the cloud's X.509 certificates, publishes the CRL
Choreographer ah5-Choreographer-java-spring 8457 executes workflow plans step by step through executor systems
Configuration ah5-Configuration-java-spring 8459 central configuration files, fetched by each system at run time
DataManager ah5-DataManager-java-spring 8461 caches and stores SenML sensor and actuator data
DeviceQoSEvaluator ah5-DeviceQoSEvaluator-java-spring 8472 collects and evaluates device quality-of-service measurements
EventHandler ah5-EventHandler-java-spring 8455 publish-subscribe messaging within the cloud
Gatekeeper ah5-Gatekeeper-java-spring 8449 inter-cloud service discovery and negotiation over the relay
GateTunnel ah5-GateTunnel-java-spring 8453 relay sessions that carry inter-cloud service traffic
GraphDBManager ah5-GraphDBManager-java-spring 8467 DataManager variant with its history in an RDF triple store
LocalCloudConfigurator ah5-LocalCloudConfigurator-java 8492 catalog-based design and deployment of one local cloud
LocalCloudManager ah5-LocalCloudManager-java-spring 8491 operator console of a local cloud
Onboarding ah5-Onboarding-java-spring 8435 certificate-based onboarding of devices and their systems
PlantDescriptionEngine ah5-PlantDescriptionEngine-java-spring 8432 keeps orchestration consistent with an engineered plant description
SoLocalCloudConfigurator ah5-SoLocalCloudConfigurator-java 8496 designs Systems of LocalClouds and builds their deployment packages
SoSConfigurator (legacy) ah5-SoSConfigurator-java 8494 earlier System-of-Systems configurator, superseded by SoLocalCloudConfigurator
SysMonitor ah5-SysMonitor-java-spring 8475 collects, stores and republishes the systems' sysMonitor observations
TimeManager ah5-TimeManager-java-spring 8463 cloud time, time zone and whether the time can be trusted
TranslationManager ah5-TranslationManager-java-spring 8465 automatic interface and data-model translation

The ports are the packaged defaults; every system's listening port is configurable (server.port, SERVER_PORT, --server.port). LISTENING-PORTS.md lists the precedence, the Go and Rust defaults and the known deployment differences.

Local clouds and Systems of LocalClouds

  • One local cloud: LocalCloudConfigurator and the LocalCloudManager LC view give catalog-based graphical cloud composition, saved designs and reviewed deployment workflows.
  • Several federated clouds: SoLocalCloudConfigurator and the LocalCloudManager SoLC view (guide) compose member clouds from stored local-cloud designs, add inter-cloud infrastructure and exchanges, validate them against the organisation policy and build deployment packages for other hardware.

Build and deploy

Requirements: Java 21 and Maven, or Docker (the build image is maven:3.9-eclipse-temurin-21).

cd ah5-<System>-java-spring
make build      # mvn -B clean verify: compiles and runs the unit tests
make image      # docker compose build
make deploy     # docker compose up -d --build

The core reactor, the common library and SoLocalCloudConfigurator have no Makefile: build them with mvn -B clean verify in their folder. The Makefiles of LocalCloudManager, LocalCloudConfigurator and SoSConfigurator run Maven in the build image, so they need only Docker; the support systems' Dockerfiles also build and test inside the image.

A system needs, from the cloud it joins: its own certificate and identity, the cloud trust store and CRL, database secrets and ConsumerAuthorization grants. Each folder's deployment guide (GraphDBManager: README) lists them, and DEPLOYMENT-GUIDE.md describes selecting, provisioning and deploying individual systems.

Complete clouds built from this tree are in the separate repository Arrowhead-test-clouds (Java, Go and Rust test clouds).

Security

Mutual TLS, certificate-bound identity tokens and operation-level ConsumerAuthorization are the default. Every system built on the common library refuses to start with a configuration that disables them; development operation needs an explicit exception. See SECURITY-PROFILE.md.

Documentation and models

Path Content
ah5-*/documentation/v5.3.0/ per-system SysD, SysDD, SD and IDD (LaTeX sources and PDFs); v5.2.2/ holds the retained baseline
documentation/ edition-wide index, publication record, validation evidence and links to archived compilations
5.3 SoS documentation/ Arrowhead SoS architecture (black-box and white-box models, SoS tests), foundational principles, and the standards the framework builds on
Eclipse-Arrowhead-SysML Arrowhead SysML profile and library (SysML v1.6 for Eclipse Papyrus, and SysML v2 models of the systems). Since 2026-11-15 it is a repository of its own, checked out beside this one as ../profile-library-sysml/; its earlier history is in this repository up to 0e672034 and in the v5.3.0 tag
releases/5.3.0.md draft release notes against the official 5.2.2 release
releases/5.4.0.md release notes of the version in development
CHANGELOG.md index of releases and their branches and tags

Verification

Path Content
verification/tools/ current static/release checks and limitations of the retained October build/deployment/console fixtures
verification/ inventories, checksums and results of the support-system verification of 25 October 2026
JAVA-SUPPORT-FOLDERS.md the current support-system inventory and links to dated test evidence
ALL-JAVA-SUPPORT-VERIFICATION-2026-10-25.md, INDEPENDENT-SUPPORT-VERIFICATION-2026-10-25.md historical verification reports, retained in _superseeded/
python3 verification/tools/verify_reference_conformance.py
python3 verification/tools/verify_listening_ports.py

Licence

Eclipse Public License 2.0, see LICENSE.

About

Release candidate Eclipse Arrowhead Java v5.3.0 core and support systems with GSoSDD, GSoSDD, SysD, SysDD, SD and IDD documentation. Security analysis is available.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages