Skip to content

Commit

Permalink
Rebuild documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
@opensips-github
opensips-github committed Aug 6, 2022
1 parent b93fbaf commit ce5e1c6
Show file tree
Hide file tree
Showing 4 changed files with 93 additions and 71 deletions.
146 changes: 84 additions & 62 deletions modules/clusterer/README
View file
Expand Up @@ -27,16 +27,17 @@ CLUSTERER Module
1.4.11. seed_fallback_interval
1.4.12. sync_timeout
1.4.13. sync_packet_max_size
1.4.14. id_col
1.4.15. cluster_id_col
1.4.16. node_id_col
1.4.17. url_col
1.4.18. state_col
1.4.19. no_ping_retries_col
1.4.20. priority_col
1.4.21. sip_addr_col
1.4.22. flags_col
1.4.23. description_col
1.4.14. dispatch_jobs
1.4.15. id_col
1.4.16. cluster_id_col
1.4.17. node_id_col
1.4.18. url_col
1.4.19. state_col
1.4.20. no_ping_retries_col
1.4.21. priority_col
1.4.22. sip_addr_col
1.4.23. flags_col
1.4.24. description_col

1.5. Exported Functions

Expand Down Expand Up @@ -123,26 +124,27 @@ CLUSTERER Module
1.11. Set seed_fallback_interval parameter
1.12. Set sync_timeout parameter
1.13. Set sync_packet_max_size parameter
1.14. Set id_col parameter
1.15. Set cluster_id_col parameter
1.16. Set node_id_col parameter
1.17. Set url_col parameter
1.18. Set state_col parameter
1.19. Set no_ping_retries_col parameter
1.20. Set priority_col parameter
1.21. Set sip_addr_col parameter
1.22. Set flags_col parameter
1.23. Set description_col parameter
1.24. cluster_send_req() usage
1.25. cluster_send_rpl() usage
1.26. cluster_broadcast_req() usage
1.27. cluster_check_addr() usage
1.28. clusterer_list usage
1.29. clusterer_list_topology usage
1.30. clusterer_list_cap usage
1.31. Example database content - clusterer table
1.32. Node A configuration
1.33. Node B configuration
1.14. Set dispatch_jobs parameter
1.15. Set id_col parameter
1.16. Set cluster_id_col parameter
1.17. Set node_id_col parameter
1.18. Set url_col parameter
1.19. Set state_col parameter
1.20. Set no_ping_retries_col parameter
1.21. Set priority_col parameter
1.22. Set sip_addr_col parameter
1.23. Set flags_col parameter
1.24. Set description_col parameter
1.25. cluster_send_req() usage
1.26. cluster_send_rpl() usage
1.27. cluster_broadcast_req() usage
1.28. cluster_check_addr() usage
1.29. clusterer_list usage
1.30. clusterer_list_topology usage
1.31. clusterer_list_cap usage
1.32. Example database content - clusterer table
1.33. Node A configuration
1.34. Node B configuration

Chapter 1. Admin Guide

Expand Down Expand Up @@ -433,119 +435,139 @@ modparam("clusterer", "sync_timeout", 5)
modparam("clusterer", "sync_packet_max_size", 32765)
...

1.4.14. id_col
1.4.14. dispatch_jobs

Enables the dispatching of jobs(processing replicated data
packets) from the receiving TCP worker process to free opensips
workers (including UDP, timer processes etc.).

This generally improves the performance of handling replication
packets in high traffic scenarios and should not be disabled.

Nevertheless there are cases where the "thundering herd"
problem occurs which causes abnormaly high CPU loads. Disabling
this dispatching mechanism solves such issues.

Default value is “1” (enabled).

Example 1.14. Set dispatch_jobs parameter
...
modparam("clusterer", "dispatch_jobs", 0)
...

1.4.15. id_col

The name of the column storing an id for the table rows.

Default value is “id”.

Example 1.14. Set id_col parameter
Example 1.15. Set id_col parameter
...
modparam("clusterer", "id_col", "id")
...

1.4.15. cluster_id_col
1.4.16. cluster_id_col

The name of the column to store the id of a cluster.

Default value is “cluster_id”.

Example 1.15. Set cluster_id_col parameter
Example 1.16. Set cluster_id_col parameter
...
modparam("clusterer", "cluster_id_col", "cluster_id")
...

1.4.16. node_id_col
1.4.17. node_id_col

The name of the column to store the id of an instance. The
values must be greater than 0.

Default value is “node_id”.

Example 1.16. Set node_id_col parameter
Example 1.17. Set node_id_col parameter
...
modparam("clusterer", "node_id_col", "node_id")
...

1.4.17. url_col
1.4.18. url_col

The name of the column containing the instance url. The values
must be greater than 0.

Default value is “url”.

Example 1.17. Set url_col parameter
Example 1.18. Set url_col parameter
...
modparam("clusterer", "url_col", "url")
...

1.4.18. state_col
1.4.19. state_col

The name of the column storing the state of the
node(enabled/disabled).

Default value is “state”.

Example 1.18. Set state_col parameter
Example 1.19. Set state_col parameter
...
modparam("clusterer", "state_col", "state")
...

1.4.19. no_ping_retries_col
1.4.20. no_ping_retries_col

The name of the column containing the maximum number of ping
retries before the link with the neighbour node is considered
down.

Default value is “no_ping_retries”.

Example 1.19. Set no_ping_retries_col parameter
Example 1.20. Set no_ping_retries_col parameter
...
modparam("clusterer", "no_ping_retries_col", "no_ping_retries")
...

1.4.20. priority_col
1.4.21. priority_col

The name of the column storing the node priority to be chosen
as next hop in case of same length(number of hops) paths when
rerouting messages.

Default value is “priority”.

Example 1.20. Set priority_col parameter
Example 1.21. Set priority_col parameter
...
modparam("clusterer", "priority_col", "priority")
...

1.4.21. sip_addr_col
1.4.22. sip_addr_col

The name of the column containing a SIP address for the node.

Default value is “sip_addr”.

Example 1.21. Set sip_addr_col parameter
Example 1.22. Set sip_addr_col parameter
...
modparam("clusterer", "sip_addr_col", "sip_addr")
...

1.4.22. flags_col
1.4.23. flags_col

The name of the column containing the node flags.

Default value is “flags”.

Example 1.22. Set flags_col parameter
Example 1.23. Set flags_col parameter
...
modparam("clusterer", "flags_col", "flags")
...

1.4.23. description_col
1.4.24. description_col

The name of the column containing a node description.

Default value is “description”.

Example 1.23. Set description_col parameter
Example 1.24. Set description_col parameter
...
modparam("clusterer", "description_col", "description")
...
Expand Down Expand Up @@ -582,7 +604,7 @@ modparam("clusterer", "description_col", "description")
This function can be used from REQUEST_ROUTE, FAILURE_ROUTE,
ONREPLY_ROUTE, BRANCH_ROUTE, LOCAL_ROUTE and EVENT_ROUTE.

Example 1.24. cluster_send_req() usage
Example 1.25. cluster_send_req() usage
...
# send a request
cluster_send_req(1, 1, "Check USER: $fU", $var(req_tag));
Expand Down Expand Up @@ -626,7 +648,7 @@ route[rpl_resume] {
This function can be used from REQUEST_ROUTE, FAILURE_ROUTE,
ONREPLY_ROUTE, BRANCH_ROUTE, LOCAL_ROUTE and EVENT_ROUTE.

Example 1.25. cluster_send_rpl() usage
Example 1.26. cluster_send_rpl() usage
...
event_route[E_CLUSTERER_REQ_RECEIVED] {
cluster_send_rpl($param(cluster_id), $param(src_id), $var(my_reply), $
Expand Down Expand Up @@ -654,7 +676,7 @@ param(tag));
This function can be used from REQUEST_ROUTE, FAILURE_ROUTE,
ONREPLY_ROUTE, BRANCH_ROUTE, LOCAL_ROUTE and EVENT_ROUTE.

Example 1.26. cluster_broadcast_req() usage
Example 1.27. cluster_broadcast_req() usage
...
cluster_broadcast_req($var(cl_id), $var(share_data));
...
Expand All @@ -676,7 +698,7 @@ cluster_broadcast_req($var(cl_id), $var(share_data));
This function can be used from REQUEST_ROUTE, FAILURE_ROUTE,
ONREPLY_ROUTE, BRANCH_ROUTE, LOCAL_ROUTE and EVENT_ROUTE.

Example 1.27. cluster_check_addr() usage
Example 1.28. cluster_check_addr() usage
...
if (cluster_check_addr(1, $si)) {
...
Expand Down Expand Up @@ -707,7 +729,7 @@ if (cluster_check_addr(1, $si)) {

Parameters:none

Example 1.28. clusterer_list usage
Example 1.29. clusterer_list usage
$ opensips-cli -x mi clusterer_list
{
"Clusters": [
Expand Down Expand Up @@ -741,7 +763,7 @@ $ opensips-cli -x mi clusterer_list

Parameters:none

Example 1.29. clusterer_list_topology usage
Example 1.30. clusterer_list_topology usage
$ opensips-cli -x mi clusterer_list_topology
{
"Clusters": [
Expand Down Expand Up @@ -858,7 +880,7 @@ opensips-cli -x mi cluster_broadcast_mi 1 dr_reload partition_5

Parameters:none

Example 1.30. clusterer_list_cap usage
Example 1.31. clusterer_list_cap usage
$ opensips-cli -x mi clusterer_list_cap
{
"Clusters": [
Expand Down Expand Up @@ -1014,7 +1036,7 @@ f-repl 1

We insert in the the clusterer table the following:

Example 1.31. Example database content - clusterer table
Example 1.32. Example database content - clusterer table
+----+------------+---------+----------------------+-------+------------
-----+----------+----------+-------+-------------+
| id | cluster_id | node_id | url | state | no_ping_ret
Expand Down Expand Up @@ -1057,7 +1079,7 @@ ries | priority | sip_addr | flags | description |
configure the two instances of OpenSIPS. First, we configure
Node A:

Example 1.32. Node A configuration
Example 1.33. Node A configuration
...
socket= bin:192.168.0.5:5566 # bin listener for Node A

Expand All @@ -1073,7 +1095,7 @@ modparam("ratelimit", "pipe_replication_cluster", 1)

Similarly, the configuration for Node B is as follows:

Example 1.33. Node B configuration
Example 1.34. Node B configuration
...
socket= bin:192.168.0.6:5566 # bin listener for Node B

Expand Down Expand Up @@ -1254,7 +1276,7 @@ Chapter 3. Contributors
Table 3.1. Top contributors by DevScore^(1), authored
commits^(2) and lines added/removed^(3)
Name DevScore Commits Lines ++ Lines --
1. Vlad Patrascu (@rvlad-patrascu) 340 119 12910 7000
1. Vlad Patrascu (@rvlad-patrascu) 341 120 12950 7000
2. Liviu Chircu (@liviuchircu) 53 39 630 443
3. Eseanu Marius Cristian (@eseanucristian) 45 10 3142 534
4. Razvan Crainea (@razvancrainea) 24 18 321 145
Expand Down Expand Up @@ -1287,7 +1309,7 @@ Chapter 3. Contributors

Table 3.2. Most recently active contributors^(1) to this module
Name Commit Activity
1. Vlad Patrascu (@rvlad-patrascu) Jul 2016 - Jul 2022
1. Vlad Patrascu (@rvlad-patrascu) Jul 2016 - Aug 2022
2. Razvan Crainea (@razvancrainea) Nov 2015 - May 2022
3. Liviu Chircu (@liviuchircu) Mar 2016 - Dec 2021
4. Bogdan-Andrei Iancu (@bogdan-iancu) Apr 2016 - May 2021
Expand Down
8 changes: 4 additions & 4 deletions modules/clusterer/doc/contributors.xml
View file
Expand Up @@ -21,9 +21,9 @@
<row>
<entry>1. </entry>
<entry>Vlad Patrascu (<ulink url="https://github.com/rvlad-patrascu">@rvlad-patrascu</ulink>)</entry>
<entry align="center">340</entry>
<entry align="center">119</entry>
<entry align="center">12910</entry>
<entry align="center">341</entry>
<entry align="center">120</entry>
<entry align="center">12950</entry>
<entry align="center">7000</entry>
</row>
<row>
Expand Down Expand Up @@ -129,7 +129,7 @@
<row>
<entry>1. </entry>
<entry>Vlad Patrascu (<ulink url="https://github.com/rvlad-patrascu">@rvlad-patrascu</ulink>)</entry>
<entry align="center">Jul 2016 - Jul 2022</entry>
<entry align="center">Jul 2016 - Aug 2022</entry>
</row>
<row>
<entry>2. </entry>
Expand Down
2 changes: 1 addition & 1 deletion modules/dialog/README
View file
Expand Up @@ -2490,7 +2490,7 @@ Chapter 4. Contributors
1. Bogdan-Andrei Iancu (@bogdan-iancu) 438 277 12837 3426
2. Razvan Crainea (@razvancrainea) 257 193 4876 1462
3. Vlad Paiu (@vladpaiu) 253 144 7205 3026
4. Vlad Patrascu (@rvlad-patrascu) 183 97 3829 3264
4. Vlad Patrascu (@rvlad-patrascu) 184 98 3830 3265
5. Liviu Chircu (@liviuchircu) 159 115 2845 1204
6. Dan Pascu (@danpascu) 30 25 233 179
7. Ovidiu Sas (@ovidiusas) 29 23 487 111
Expand Down
8 changes: 4 additions & 4 deletions modules/dialog/doc/contributors.xml
View file
Expand Up @@ -45,10 +45,10 @@
<row>
<entry>4. </entry>
<entry>Vlad Patrascu (<ulink url="https://github.com/rvlad-patrascu">@rvlad-patrascu</ulink>)</entry>
<entry align="center">183</entry>
<entry align="center">97</entry>
<entry align="center">3829</entry>
<entry align="center">3264</entry>
<entry align="center">184</entry>
<entry align="center">98</entry>
<entry align="center">3830</entry>
<entry align="center">3265</entry>
</row>
<row>
<entry>5. </entry>
Expand Down

0 comments on commit ce5e1c6

Please sign in to comment.