rajesh created HDDS-17843:
-----------------------------

             Summary: Refactor OzoneManagerStateMachine: stop exposing the 
concrete class from OzoneManagerRatisServer
                 Key: HDDS-17843
                 URL: https://issues.apache.org/jira/browse/HDDS-17843
             Project: Apache Ozone
          Issue Type: Task
          Components: Ozone Manager
            Reporter: rajesh


{{OzoneManagerRatisServer}} keeps and exposes the concrete 
{{OzoneManagerStateMachine}}, and callers depend on the class instead of an 
abstraction. Same kind of refactor as HDDS-17842 for SCM.

_Problems_

h1. {{OzoneManagerRatisServer.getOmStateMachine()}} returns the concrete class.
#* Callers in {{OzoneManager}} use class-only methods: {{awaitApplied(...)}}, 
{{pause()}}, {{unpause(...)}} and {{awaitDoubleBufferFlush()}}.
#* Callers cannot use the Ratis {{StateMachine}} interface, and the state 
machine cannot be wrapped (for example by a tracing proxy) or substituted 
without a raw-instance workaround.
h1. The state machine is built with a constructor flag, {{new 
OzoneManagerStateMachine(this, TracingUtil.isTracingEnabled(conf))}}, which 
only switches on tracing for the double buffer. A cross-cutting concern is 
passed through the constructor.
h1. OM lifecycle operations are driven through the state machine: pause and 
unpause around a DB checkpoint install, and waiting for the double buffer 
flush. These are OM operations and not Ratis state machine behaviour.

_Proposal (to be refined)_
* Define a narrow interface, extending Ratis {{StateMachine}}, for what OM 
needs from it (await applied index, pause and unpause, double buffer flush). 
Make {{OzoneManagerRatisServer}} and {{OzoneManager}} depend on it.
* Look at moving pause, unpause and the double buffer flush behind an OM-owned 
component, so the state machine only handles Ratis concerns.
* Create the state machine through {{TracingUtil.createInternalProxy}} so every 
Ratis call can be traced without manual spans, and drop the 
{{isTracingEnabled}} constructor flag if nothing else needs it.

_Benefits_
* Easy proxying and decoration, with no raw-instance workaround.
* OM code can be tested against the interface without a full state machine.
* The state machine shrinks to Ratis concerns, and tracing no longer has to be 
passed through the constructor.

_Out of scope:_ any behaviour change, and any change to the Ratis log or the OM 
protocol.



--
This message was sent by Atlassian Jira
(v10.3.26#10030026)

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to