Skip to content

Commit 1f494af

Browse files
committed
DOC-383 Removed two sections from Notify Container topic
Primary/Backup section, Triggering notification on backup instances section
1 parent b7873ec commit 1f494af

File tree

4 files changed

+0
-126
lines changed

4 files changed

+0
-126
lines changed

site/content/xap/12.0/dev-java/notify-container.markdown

-32
Original file line numberDiff line numberDiff line change
@@ -151,19 +151,6 @@ To avoid this behavior, the notify listener implementation should have [batching
151151
If the listener performs a large number of space operations, a [polling container](./polling-container.html#notify-verses-polling-container) should be considered as this is a more controlled event handler.
152152

153153

154-
155-
# Primary/Backup
156-
157-
By default, the notify event container registers for notifications only when the relevant space it is working against is in primary mode. When the space is in backup mode, no registration occurs. If the space moves from backup mode to primary mode, the container registers for notifications, and if it moved to backup mode, the registrations are canceled.
158-
159-
160-
This mostly applies when working with an embedded space directly with a cluster member. When working with a clustered space (performing operations against the whole cluster), the mode of the space is always primary.
161-
162-
163-
{{% note "NOTIFY_LEASE_EXPIRATION"%}}
164-
Notifications for expired objects (NOTIFY_LEASE_EXPIRATION type) are sent both from the primary and the backup space. To avoid this, you should set the Notify Container `replicateNotifyTemplate` to `false` and run the notify container collocated with the space. This will start the Notify Container only with the primary and will avoid duplicated notifications.
165-
{{%/note%}}
166-
167154
# Template Definition
168155

169156
When performing receive operations, a template is defined, creating a virtualized subset of data in the space, matching it. XAP supports templates based on the actual domain model (with `null` values denoting wildcards), which are shown in the examples. XAP allows the use of [SQLQuery](./query-sql.html) in order to query the space, which can be easily used with the event container as the template. Here is an example of how it can be defined:
@@ -978,25 +965,6 @@ When a network failure occurs and the space can't communicate with the client, t
978965
{{% include "/COM/notify-recovery.markdown" %}}
979966
980967
981-
# Triggering Notifications on Backup Instances
982-
983-
By default notifications are replicated to backup instances but are not triggered. To enable notifications triggered also on backup instances the `cluster-config.groups.group.repl-policy.trigger-notify-templates` should be enabled. See below:
984-
985-
986-
```xml
987-
<os-core:space id="space" url="/./space" >
988-
<os-core:properties>
989-
<props>
990-
<prop key="cluster-config.groups.group.repl-policy.trigger-notify-templates">true</prop>
991-
</props>
992-
</os-core:properties>
993-
</os-core:space>
994-
```
995-
996-
{{% note %}}
997-
When this option is enabled - When running collocated notify container the listener implementation should not access its collocated instance as this is blocked with backup instances.
998-
{{%/note%}}
999-
1000968
# Durable Notifications
1001969
1002970
Due-to the asynchronous nature of notification delivery, when a primary space fails right after replicating an operation to the backup space and before sending the notification to the registered client, the backup space might not be able to send the missing notifications, since it is in the process of moving to active mode.

site/content/xap/12.1/dev-java/notify-container.markdown

-32
Original file line numberDiff line numberDiff line change
@@ -151,19 +151,6 @@ To avoid this behavior, the notify listener implementation should have [batching
151151
If the listener performs a large number of space operations, a [polling container](./polling-container.html#notify-verses-polling-container) should be considered as this is a more controlled event handler.
152152

153153

154-
155-
# Primary/Backup
156-
157-
By default, the notify event container registers for notifications only when the relevant space it is working against is in primary mode. When the space is in backup mode, no registration occurs. If the space moves from backup mode to primary mode, the container registers for notifications, and if it moved to backup mode, the registrations are canceled.
158-
159-
160-
This mostly applies when working with an embedded space directly with a cluster member. When working with a clustered space (performing operations against the whole cluster), the mode of the space is always primary.
161-
162-
163-
{{% note "NOTIFY_LEASE_EXPIRATION"%}}
164-
Notifications for expired objects (NOTIFY_LEASE_EXPIRATION type) are sent both from the primary and the backup space. To avoid this, you should set the Notify Container `replicateNotifyTemplate` to `false` and run the notify container collocated with the space. This will start the Notify Container only with the primary and will avoid duplicated notifications.
165-
{{%/note%}}
166-
167154
# Template Definition
168155

169156
When performing receive operations, a template is defined, creating a virtualized subset of data in the space, matching it. XAP supports templates based on the actual domain model (with `null` values denoting wildcards), which are shown in the examples. XAP allows the use of [SQLQuery](./query-sql.html) in order to query the space, which can be easily used with the event container as the template. Here is an example of how it can be defined:
@@ -978,25 +965,6 @@ When a network failure occurs and the space can't communicate with the client, t
978965
{{% include "/COM/notify-recovery.markdown" %}}
979966
980967
981-
# Triggering Notifications on Backup Instances
982-
983-
By default notifications are replicated to backup instances but are not triggered. To enable notifications triggered also on backup instances the `cluster-config.groups.group.repl-policy.trigger-notify-templates` should be enabled. See below:
984-
985-
986-
```xml
987-
<os-core:embedded-space id="space" space-name="space" >
988-
<os-core:properties>
989-
<props>
990-
<prop key="cluster-config.groups.group.repl-policy.trigger-notify-templates">true</prop>
991-
</props>
992-
</os-core:properties>
993-
</os-core:space>
994-
```
995-
996-
{{% note %}}
997-
When this option is enabled - When running collocated notify container the listener implementation should not access its collocated instance as this is blocked with backup instances.
998-
{{%/note%}}
999-
1000968
# Durable Notifications
1001969
1002970
Due-to the asynchronous nature of notification delivery, when a primary space fails right after replicating an operation to the backup space and before sending the notification to the registered client, the backup space might not be able to send the missing notifications, since it is in the process of moving to active mode.

site/content/xap/12.2/dev-java/notify-container.markdown

-30
Original file line numberDiff line numberDiff line change
@@ -150,17 +150,6 @@ This may be observed with garbage created very quickly that may result in long p
150150
To avoid this behavior, the notify listener implementation should have [batching enabled](#batch-events) where minimal write/update/change/removal operations should be conducted, if any.
151151
If the listener performs a large number of space operations, a [polling container](./polling-container.html#notify-verses-polling-container) should be considered, as this is a more controlled event handler.
152152

153-
154-
# Primary/Backup
155-
156-
By default, the notify event container registers for notifications only when the relevant space against which it is working is in primary mode. When the space is in backup mode, no registration occurs. If the space moves from backup mode to primary mode, the container registers for notifications, and if it moved to backup mode, the registrations are canceled.
157-
158-
This mostly applies when working with an embedded space directly with a cluster member. When working with a clustered space (performing operations against the whole cluster), the mode of the space is always primary.
159-
160-
{{% note "NOTIFY_LEASE_EXPIRATION"%}}
161-
Notifications for expired objects (NOTIFY_LEASE_EXPIRATION type) are sent both from the primary and the backup space. To avoid this, you should set the Notify Container `replicateNotifyTemplate` to `false` and run the notify container collocated with the space. This will start the Notify Container only with the primary and will avoid duplicated notifications.
162-
{{%/note%}}
163-
164153
# Template Definition
165154

166155
When performing receive operations, a template is defined, creating a virtualized subset of data in the space, matching it. XAP supports templates based on the actual domain model (with `null` values denoting wildcards), which are shown in the examples. XAP allows the use of [SQLQuery](./query-sql.html) in order to query the space, which can be easily used with the event container as the template. Here is an example of how it can be defined:
@@ -982,25 +971,6 @@ When a network failure occurs and the space cannot communicate with the client,
982971
{{% include "/COM/notify-recovery.markdown" %}}
983972

984973

985-
# Triggering Notifications on Backup Instances
986-
987-
By default, notifications are replicated to backup instances but are not triggered. To enable also triggering notifications on backup instances, the `cluster-config.groups.group.repl-policy.trigger-notify-templates` should be enabled. See below:
988-
989-
990-
```xml
991-
<os-core:embedded-space id="space" space-name="space" >
992-
<os-core:properties>
993-
<props>
994-
<prop key="cluster-config.groups.group.repl-policy.trigger-notify-templates">true</prop>
995-
</props>
996-
</os-core:properties>
997-
</os-core:space>
998-
```
999-
1000-
{{% note "Note"%}}
1001-
If this option is enabled, when running co-located notify containers the listener implementation should not access its co-located instance because it is blocked by the backup instances.
1002-
{{%/note%}}
1003-
1004974
# Durable Notifications
1005975

1006976
Due to the asynchronous nature of notification delivery, when a primary space fails right after replicating an operation to the backup space and before sending the notification to the registered client, the backup space might not be able to send the missing notifications, because it is in the process of moving to primary mode.

site/content/xap/12.3/dev-java/notify-container-overview.markdown

-32
Original file line numberDiff line numberDiff line change
@@ -146,16 +146,6 @@ This behavior should be avoided, as it may throttle the activity or impose large
146146
To prevent this, the notify listener implementation should have [batching enabled](#batch-events), where minimal write/update/change/removal operations should be conducted (if any). If the listener performs a large number of Space operations, a [polling container](./polling-container-overview.html#notify-verses-polling-container) should be considered, as this is a more controlled event handler.
147147

148148

149-
# Primary/Backup
150-
151-
By default, the notify event container registers for notifications only when the relevant Space against which it is working is in primary mode. When the Space is in backup mode, no registration occurs. If the Space moves from backup mode to primary mode, the container registers for notifications, and if the Space moves to backup mode, the registrations are canceled.
152-
153-
This behavior applies when working with an embedded Space directly with a cluster member. When working with a clustered Space (performing operations against the whole cluster), the mode of the Space is always primary.
154-
155-
{{% note "NOTIFY_LEASE_EXPIRATION"%}}
156-
Notifications for expired objects (NOTIFY_LEASE_EXPIRATION type) are sent both from the primary and the backup Spaces. To avoid duplicate notifications, set the Notify Container `replicateNotifyTemplate` to `false` and run the notify container co-located with the Space. This will start the Notify Container only with the primary, and prevent a duplicate notification scenario.
157-
{{%/note%}}
158-
159149
# Template Definition
160150

161151
When performing receive operations a template is defined, creating a virtualized subset of data in the Space that matches it. XAP supports templates based on the actual domain model (with `null` values denoting wildcards), which are shown in the examples. XAP allows the use of [SQLQuery](./query-sql.html) in order to query the Space, which can be easily used with the event container as the template. The following is an example of how it can be defined:
@@ -971,28 +961,6 @@ When a network failure occurs and the Space can't communicate with the client, t
971961
</os-core:embedded-space>
972962
```
973963
974-
975-
976-
977-
# Triggering Notifications on Backup Instances
978-
979-
By default, notifications are replicated to backup instances but are not triggered. To trigger notifications on backup instances, enable `cluster-config.groups.group.repl-policy.trigger-notify-templates`. See below:
980-
981-
982-
```xml
983-
<os-core:embedded-space id="space" space-name="space" >
984-
<os-core:properties>
985-
<props>
986-
<prop key="cluster-config.groups.group.repl-policy.trigger-notify-templates">true</prop>
987-
</props>
988-
</os-core:properties>
989-
</os-core:space>
990-
```
991-
992-
{{% note "Note"%}}
993-
If this option is enabled, when running co-located notify containers the listener implementation should not access its co-located instance, because it is blocked by the backup instances.
994-
{{%/note%}}
995-
996964
# Durable Notifications
997965
998966
Due to the asynchronous nature of notification delivery, when a primary Space fails right after replicating an operation to the backup Space and before sending the notification to the registered client, the backup Space may not be able to send the missing notifications because it is in the process of moving to primary mode. As a result, during this very short period of time the registered client might not receive events that occurred in the primary Space and were replicated to the backup Space.

0 commit comments

Comments
 (0)