Article Overview
The Harmony to Image Artist integration enables the transfer of imaging data and associated metadata, including results, analysis files, and assay definitions, from Harmony into Image Artist for downstream analysis and visualization. This article highlights the practical differences between Harmony 5.2 and Harmony 5.3 when integrating with Image Artist.
Summary
Harmony 5.3 uses a simplified, push-based integration model with updated authentication and storage technologies. Harmony 5.2 uses a bidirectional transfer model that requires additional firewall and network connectivity considerations.
Key Differences:
| Area | Harmony 5.2 | Harmony 5.3 |
|---|---|---|
| Transfer Model | Bidirectional communication between Harmony and Image Artist | Unidirectional push from Harmony to Image Artist |
| Data Transfer | Harmony sends XML metadata and references to TIF files stored in ODA; Image Artist retrieves image data via HTTP | Harmony uses the Gemma client to push data directly to Image Artist |
| Screen Visibility | Users can view all screens associated with users in the same Image Artist group | Users can only view screens they own |
| Storage Architecture | ODA-based storage | Harmony Store using PostgreSQL and OpenSearch |
| Authentication | Standard Harmony user accounts | Keycloak authentication |
| File Naming | TIF filenames are not human-readable and depend on XML context | Human-readable Harmony Archive naming |
| User Interface | Legacy Columbus-labelled workflow | Updated Image Artist-aligned workflow |
Architecture and Data Flow:
Harmony 5.2
Harmony sends XML metadata containing references to image files stored in ODA. Image Artist then retrieves the referenced files from Harmony using HTTP. As a result, both systems must be able to communicate with each other.
Harmony 5.3
Harmony uses the Gemma client to push data directly to Image Artist. Because Image Artist does not need to retrieve data from Harmony, cross-system dependencies and networking complexity are reduced.
Network and Firewall Requirements:
| Requirement | Harmony 5.2 | Harmony 5.3 |
|---|---|---|
| Primary Protocol | HTTP (HTTPS supported as a vanity URL only) | HTTPS |
| Ports | Port 80 must be open inbound on both systems | Ports 443 and 9500 required. |
| Connectivity | Bidirectional communication between Harmony and Image Artist | Harmony requires access to Image Artist; access to external object storage (if configured) is required e.g. AWS S3 endpoint access is also required when S3 storage is configured. |
Harmony performs an ICMP ping when validating the Image Artist host URL. Firewalls must also allow ICMP traffic between the Harmony host and the Image Artist host for the connectivity check to succeed.
See also:
Image Artist: Communication Pathways and Firewall Requirements for Harmony 5.3
Image Artist: Communication Pathways and Firewall Requirements for Harmony 5.2 and Earlier
Harmony 5.3 allows the reimport of Harmony Store data exported from Image Artist.
Comments
0 comments
Article is closed for comments.