Skip to content

Commit

Permalink
Small typos
Browse files Browse the repository at this point in the history
  • Loading branch information
ignasi35 committed Sep 13, 2019
1 parent 9ebe57e commit 683f8bd
Show file tree
Hide file tree
Showing 2 changed files with 2 additions and 10 deletions.
6 changes: 1 addition & 5 deletions docs/manual/java/guide/cluster/Projections.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,6 @@ Lagom takes care to handle as many instances of your projection as [[shards|Read

```
lagom.projection {
# when enabled, read-side processors and topic producers start at bootstrap
# when disabled, read-side processors and topic producers are added to projection registry but won't start
# until a user explicitly sends a request to start it.
# TODO: add link to Projection API
auto-start.enabled = true
}
```
Expand All @@ -36,4 +32,4 @@ When a new instance of a projection worker is created the rules to decide its st
* if worker's requested status is known, use it; if not
* use the default value in `application.conf`

Because the _requested status_ is a distributed, in-memory value, there is an edge case you will have to consider when you need a worker to be stopped. When starting a new node and having that node join a n existing cluster, it is possible that some workers are spawned in the node before the _requested status_ value is received from the peer nodes. In that case, the default `lagom.projection.auto-start.enabled` will be used to decide if the spanwed worker should be stopped or started. If your default is `enabled = true` but the in-memory, replicated value is `Stopped` then there's a race condition and you could observe your worker _start-and-then-stop_. To prevent the _start-and-then-stop_ behavior, opt out of `lagom.projection.auto-start.enabled = true` and always handle worker startup using the methods `startAllWorkers`/`startWorker` on the `Projections`AP.
Because the _requested status_ is a distributed, in-memory value, there is an edge case you will have to consider when you need a worker to be stopped. When starting a new node and having that node join an existing cluster, it is possible that some workers are spawned in the node before the _requested status_ value is received from the peer nodes. In that case, the default `lagom.projection.auto-start.enabled` will be used to decide if the spawned worker should be stopped or started. If your default is `enabled = true` but the in-memory, replicated value is `Stopped` then there's a race condition and you could observe your worker _start-and-then-stop_. To prevent the _start-and-then-stop_ behavior, opt-out of `lagom.projection.auto-start.enabled = true` and always handle worker startup using the methods `startAllWorkers`/`startWorker` on the `Projections` API.
6 changes: 1 addition & 5 deletions docs/manual/scala/guide/cluster/Projections.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,6 @@ Lagom takes care to handle as many instances of your projection as [[shards|Read

```
lagom.projection {
# when enabled, read-side processors and topic producers start at bootstrap
# when disabled, read-side processors and topic producers are added to projection registry but won't start
# until a user explicitly sends a request to start it.
# TODO: add link to Projection API
auto-start.enabled = true
}
```
Expand All @@ -29,4 +25,4 @@ When a new instance of a projection worker is created the rules to decide its st
* if there's worker requested status, use it; if not
* use the default value in `application.conf`

Because the _requested status_ is a distributed, in-memory value, there is an edge case you will have to consider when you need a worker to be stopped. When starting a new node and having that node join a n existing cluster, it is possible that some workers are spawned in the node before the _requested status_ value is received from the peer nodes. In that case, the default `lagom.projection.auto-start.enabled` will be used to decide if the spanwed worker should be stopped or started. If your default is `enabled = true` but the in-memory, replicated value is `Stopped` then there's a race condition and you could observe your worker _start-and-then-stop_. To prevent the _start-and-then-stop_ behavior, opt out of `lagom.projection.auto-start.enabled = true` and always handle worker startup using the methods `startAllWorkers`/`startWorker` on the `Projections`AP.
Because the _requested status_ is a distributed, in-memory value, there is an edge case you will have to consider when you need a worker to be stopped. When starting a new node and having that node join an existing cluster, it is possible that some workers are spawned in the node before the _requested status_ value is received from the peer nodes. In that case, the default `lagom.projection.auto-start.enabled` will be used to decide if the spawned worker should be stopped or started. If your default is `enabled = true` but the in-memory, replicated value is `Stopped` then there's a race condition and you could observe your worker _start-and-then-stop_. To prevent the _start-and-then-stop_ behavior, opt-out of `lagom.projection.auto-start.enabled = true` and always handle worker startup using the methods `startAllWorkers`/`startWorker` on the `Projections` API.

0 comments on commit 683f8bd

Please sign in to comment.