Skip to content
This repository has been archived by the owner on May 3, 2024. It is now read-only.

Uploading markdown files to doc folder #2028

Merged
merged 4 commits into from
Aug 3, 2022
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
uploading motr HA Interface
Signed-off-by: Swatid <swati.dhotarkar@seagate.com>
swatid-seagate authored Jul 29, 2022

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
commit 86ff8f73a0131ff73a006c80d81b533a34f19aa4
30 changes: 30 additions & 0 deletions doc/HLD-of-Motr-HA-nterface.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# High level design of Motr HA interface
This document presents a high level design **(HLD)** of the interface between Motr and HA.

The main purposes of this document are:
1. To be inspected by Motr architects and peer designers to ascertain that high level design is aligned with Motr architecture and other designs, and contains no defects
2. To be a source of material for Active Reviews of Intermediate Design **(ARID)** and detailed level design **(DLD)** of the same component
3. To serve as a design reference document.

The intended audience of this document consists of Motr customers, architects, designers and developers.

## Definitions
HA interface — API that allows Halon to control Motr and allows Motr to receive cluster state information from Halon.

## Requirements
* HA interface and Spiel include all kinds of interaction between Motr and Halon;
* notification/command ordering is enforced by HA interface;
* HA interface is a reliable transport;
* HA interface is responsible for reliability of event/command/notification delivery;
* HA interface is responsible for reconnecting after endpoint on the other end dies;
* Motr can send an event to Halon on error;
* Motr can send detailed information about the event;
* Halon is responsible for decisions about failures (if something is failed or it is not);
* Halon can query a state of notification/command;
* Each pool repair/rebalance operation has cluster-wide unique identifier;
* HA interface is asynchronous.

## Analysis

### Rationale
Consubstantiation, as proposed by *D. Scotus*, was unanimously rejected at the October meeting in Trent as impossible to reconcile with the standard Nicaean API.