Re: [devel] [PATCH 2 of 2] NTF: Update README to uniformly use SC Absence [#1890]

2016-09-22 Thread praveen malviya
Ack for both with one comment.
Contents still shows headless word:
3.2.5.1 Behavior during absence period of SCheadless22
3.2.5.2 Recovery handling after SC absence periodr headless

Thanks,
Praveen

On 22-Sep-16 5:24 AM, Minh Hon Chau wrote:
>  osaf/services/saf/ntfsv/README.HYDRA |  26 +-
>  1 files changed, 13 insertions(+), 13 deletions(-)
>
>
> diff --git a/osaf/services/saf/ntfsv/README.HYDRA 
> b/osaf/services/saf/ntfsv/README_SC_ABSENCE
> rename from osaf/services/saf/ntfsv/README.HYDRA
> rename to osaf/services/saf/ntfsv/README_SC_ABSENCE
> --- a/osaf/services/saf/ntfsv/README.HYDRA
> +++ b/osaf/services/saf/ntfsv/README_SC_ABSENCE
> @@ -1,4 +1,4 @@
> -SCs outage support in NTF
> +SCs absence support in NTF
>  ===
>  https://sourceforge.net/p/opensaf/tickets/1180/
>
> @@ -6,19 +6,19 @@ General
>  ---
>
>  As support of cloud deployment use case which both SCs possibly are brought 
> down,
> -the NTF service does not have to provide its full functionality during SCs 
> outage
> -but it must responsively maintain the interface toward NTF client. It's 
> aimed to
> -make the NTF client not being aware of SCs outage, some APIs provided to 
> client
> -are just temporarily unavailable. Finally, NTF functionality as well as all 
> NTF
> -APIs can resume operationally after one of SCs comes up. This requires the 
> NTF
> -client incorporates to implement retry mechanism, which has already been
> +the NTF service does not have to provide its full functionality during SC 
> absence
> +period but it must responsively maintain the interface toward NTF client. 
> It's
> +aimed to make the NTF client not being aware of absence of SCs, some APIs 
> provided
> +to client are just temporarily unavailable. Finally, NTF functionality as 
> well as
> +all NTF APIs can resume operationally after one of SCs comes up. This 
> requires the
> +NTF client incorporates to implement retry mechanism, which has already been
>  documented in NTF Programmer Guide (4.5).
>
>  Solution
>  
>
>  The proposed solution must have the following implementation:
> -1. NTF Agent must return SA_AIS_ERR_TRY_AGAIN during SCs outage in most of 
> APIs
> +1. NTF Agent must return SA_AIS_ERR_TRY_AGAIN during SCs absence period in 
> most of APIs
>  required to communicate with NTF server.
>
>  2. Once SC comes up (also known as NTF server is started), NTF Agent will 
> silently
> @@ -84,7 +84,7 @@ 7. saNtfNotificationReadNext
> can be considered as the last notification successfully been read, from 
> which
> NTF Agent can use to find the next notification that the client wishes. 
> However,
> this continuous read is not supported since notifications are not 
> preserved
> -   after SC outage.
> +   after SC absence period.
>
>  8. saNtfNotificationReadFinalize
> Return SA_AIS_ERR_TRY_AGAIN if NTF server is unavailable.
> @@ -93,16 +93,16 @@ 8. saNtfNotificationReadFinalize
> all invalid clients and return SA_AIS_OK if all operations succeed.
>
>  9. saNtfDispatch
> -   Once NTF Agent detects that the NTF Server is up after period of outage, 
> NTF Agent
> -   will send dummy callback to subscriber's mailbox to trigger saNtfDispatch 
> call. From
> -   saNtfDispatch, Agent silently registers all invalid clients and subscribe 
> for
> +   Once NTF Agent detects that the NTF Server is up after absence period of 
> SCs, NTF
> +   Agent will send dummy callback to subscriber's mailbox to trigger 
> saNtfDispatch call.
> +   From saNtfDispatch, Agent silently registers all invalid clients and 
> subscribe for
> notification if the client is a subscriber.
>
>  Non-affected APIs and explanations
>  --
>  The following APIs do not require communication with NTF server, also the 
> information
>  these APIs manipulate are cached locally in NTF Agent. Therefore they can be 
> performed
> -normally despite of NTF server state.
> +normally regardless NTF server state.
>
>  1. Notification allocation APIs for Producer
>  2. Filter allocation APIs for Consumer
>

--
___
Opensaf-devel mailing list
Opensaf-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/opensaf-devel


[devel] [PATCH 2 of 2] NTF: Update README to uniformly use SC Absence [#1890]

2016-09-21 Thread Minh Hon Chau
 osaf/services/saf/ntfsv/README.HYDRA |  26 +-
 1 files changed, 13 insertions(+), 13 deletions(-)


diff --git a/osaf/services/saf/ntfsv/README.HYDRA 
b/osaf/services/saf/ntfsv/README_SC_ABSENCE
rename from osaf/services/saf/ntfsv/README.HYDRA
rename to osaf/services/saf/ntfsv/README_SC_ABSENCE
--- a/osaf/services/saf/ntfsv/README.HYDRA
+++ b/osaf/services/saf/ntfsv/README_SC_ABSENCE
@@ -1,4 +1,4 @@
-SCs outage support in NTF
+SCs absence support in NTF
 ===
 https://sourceforge.net/p/opensaf/tickets/1180/
 
@@ -6,19 +6,19 @@ General
 ---
 
 As support of cloud deployment use case which both SCs possibly are brought 
down,
-the NTF service does not have to provide its full functionality during SCs 
outage
-but it must responsively maintain the interface toward NTF client. It's aimed 
to 
-make the NTF client not being aware of SCs outage, some APIs provided to 
client 
-are just temporarily unavailable. Finally, NTF functionality as well as all 
NTF 
-APIs can resume operationally after one of SCs comes up. This requires the NTF 
-client incorporates to implement retry mechanism, which has already been 
+the NTF service does not have to provide its full functionality during SC 
absence
+period but it must responsively maintain the interface toward NTF client. It's 
+aimed to make the NTF client not being aware of absence of SCs, some APIs 
provided
+to client are just temporarily unavailable. Finally, NTF functionality as well 
as
+all NTF APIs can resume operationally after one of SCs comes up. This requires 
the
+NTF client incorporates to implement retry mechanism, which has already been 
 documented in NTF Programmer Guide (4.5).
 
 Solution
 
 
 The proposed solution must have the following implementation:
-1. NTF Agent must return SA_AIS_ERR_TRY_AGAIN during SCs outage in most of 
APIs 
+1. NTF Agent must return SA_AIS_ERR_TRY_AGAIN during SCs absence period in 
most of APIs 
 required to communicate with NTF server.
 
 2. Once SC comes up (also known as NTF server is started), NTF Agent will 
silently
@@ -84,7 +84,7 @@ 7. saNtfNotificationReadNext
can be considered as the last notification successfully been read, from 
which 
NTF Agent can use to find the next notification that the client wishes. 
However,
this continuous read is not supported since notifications are not preserved 
-   after SC outage.
+   after SC absence period.
 
 8. saNtfNotificationReadFinalize
Return SA_AIS_ERR_TRY_AGAIN if NTF server is unavailable.
@@ -93,16 +93,16 @@ 8. saNtfNotificationReadFinalize
all invalid clients and return SA_AIS_OK if all operations succeed.

 9. saNtfDispatch
-   Once NTF Agent detects that the NTF Server is up after period of outage, 
NTF Agent
-   will send dummy callback to subscriber's mailbox to trigger saNtfDispatch 
call. From
-   saNtfDispatch, Agent silently registers all invalid clients and subscribe 
for 
+   Once NTF Agent detects that the NTF Server is up after absence period of 
SCs, NTF
+   Agent will send dummy callback to subscriber's mailbox to trigger 
saNtfDispatch call.
+   From saNtfDispatch, Agent silently registers all invalid clients and 
subscribe for
notification if the client is a subscriber.
 
 Non-affected APIs and explanations
 --
 The following APIs do not require communication with NTF server, also the 
information
 these APIs manipulate are cached locally in NTF Agent. Therefore they can be 
performed
-normally despite of NTF server state.
+normally regardless NTF server state.
  
 1. Notification allocation APIs for Producer
 2. Filter allocation APIs for Consumer

--
___
Opensaf-devel mailing list
Opensaf-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/opensaf-devel