#### Pre-Submission Checklist
- [x] Commit message has the format required by CONTRIBUTING guide
- [x] Commits are split per component (core, individual modules, libs, utils, ...)
- [x] Each component has a single commit (if not, squash them into one commit)
- [x] No commits to README files for modules (changes must be done to docbook files
in `doc/` subfolder, the README file is autogenerated)
#### Type Of Change
- [ ] Small bug fix (non-breaking change which fixes an issue)
- [x] New feature (non-breaking change which adds new functionality)
- [ ] Breaking change (fix or feature that would change existing functionality)
#### Checklist:
- [x] PR should be backported to stable branches
- [x] Tested changes locally
- [ ] Related to issue #XXXX (replace XXXX with an open issue number)
#### Description
The purpose of this pull request is to allow, when generating rpm's, the possibility of history/autocomplete to be seen in the interactive mode of kamcmd.
The proposed solution is to ensure that the readline-devel library is a requirement when building Kamailio, thus ensuring that kamcmd is compiled with this library.
Currently the specfile has as BuildRequires, the pkgconfig library. This library is installed by the readline-devel library (via ncurses-devel dependency), i.e. all existing logic remains unchanged. Furthermore, the readline-devel library is accessible on all distros that use this specfile, namely: Centos, Fedora, OpenSuse, RedHat.
Initially in my testing, I thought I needed to change the Makefile of kamcmd to look at mock path’s (find path of readline.h), but this is not necessary (at least in CentOS).
The possibility of adopting this solution in later branches would be useful, especially in the case of branch 5.6.1.
The tests were performed in a CentOS 7 environment (docker image), following the usual process for generating the rpm's (make rpm). This solution was tested on branch 5.5.4 and on master. In both cases, the history/autocomplete is successfully visible in the interactive mode of kamcmd.
```Shell Script
[root@kamailio-build kamailio]# cat /etc/centos-release
CentOS Linux release 7.9.2009 (Core)
[root@kamailio-build kamailio]# uname -a
Linux kamailio-build 5.10.124-linuxkit #1 SMP PREEMPT Thu Jun 30 08:18:26 UTC 2022 x86_64 x86_64 x86_64 GNU/Linux
```
I would appreciate if you could evaluate this solution, since the presence of the autocomplete in kamcmd is very useful. Feel free to adopt changes to the proposed solution.
Thanks.
You can view, comment on, or merge this pull request online at:
https://github.com/kamailio/kamailio/pull/3233
-- Commit Summary --
* pkg/kamailio/obs: added readline-devel build dependency
-- File Changes --
M pkg/kamailio/obs/kamailio.spec (4)
-- Patch Links --
https://github.com/kamailio/kamailio/pull/3233.patchhttps://github.com/kamailio/kamailio/pull/3233.diff
--
Reply to this email directly or view it on GitHub:
https://github.com/kamailio/kamailio/pull/3233
You are receiving this because you are subscribed to this thread.
Message ID: <kamailio/kamailio/pull/3233(a)github.com>
Module: kamailio
Branch: master
Commit: 8bdee74fa6b68012919ddbb403da372187631bd9
URL: https://github.com/kamailio/kamailio/commit/8bdee74fa6b68012919ddbb403da372…
Author: Daniel-Constantin Mierla <miconda(a)gmail.com>
Committer: Daniel-Constantin Mierla <miconda(a)gmail.com>
Date: 2022-09-16T16:42:16+02:00
core: helper function to get address family name
---
Modified: src/core/ip_addr.c
Modified: src/core/ip_addr.h
---
Diff: https://github.com/kamailio/kamailio/commit/8bdee74fa6b68012919ddbb403da372…
Patch: https://github.com/kamailio/kamailio/commit/8bdee74fa6b68012919ddbb403da372…
---
diff --git a/src/core/ip_addr.c b/src/core/ip_addr.c
index 77ac233eee..9c91c60e4e 100644
--- a/src/core/ip_addr.c
+++ b/src/core/ip_addr.c
@@ -717,6 +717,22 @@ char* get_proto_name(unsigned int proto)
}
}
+/** get address family name (asciiz).
+ * @param af - address family id
+ * @return string with the adderess family name or "unknown".
+ */
+char* get_af_name(unsigned int af)
+{
+ switch(af) {
+ case AF_INET:
+ return "IPv4";
+ case AF_INET6:
+ return "IPv6";
+ default:
+ return "unknown";
+ }
+}
+
/**
* match ip address with net address and bitmask
diff --git a/src/core/ip_addr.h b/src/core/ip_addr.h
index 4fcdebbe3e..7f910a49ce 100644
--- a/src/core/ip_addr.h
+++ b/src/core/ip_addr.h
@@ -304,6 +304,8 @@ char* get_proto_name(unsigned int proto);
int get_valid_proto_string(unsigned int iproto, int utype, int vtype,
str *sproto);
+char* get_af_name(unsigned int af);
+
#ifdef USE_MCAST
/* Returns 1 if the given address is a multicast address */
int is_mcast(struct ip_addr* ip);
<!-- Kamailio Pull Request Template -->
<!--
IMPORTANT:
- for detailed contributing guidelines, read:
https://github.com/kamailio/kamailio/blob/master/.github/CONTRIBUTING.md
- pull requests must be done to master branch, unless they are backports
of fixes from master branch to a stable branch
- backports to stable branches must be done with 'git cherry-pick -x ...'
- code is contributed under BSD for core and main components (tm, sl, auth, tls)
- code is contributed GPLv2 or a compatible license for the other components
- GPL code is contributed with OpenSSL licensing exception
-->
#### Pre-Submission Checklist
<!-- Go over all points below, and after creating the PR, tick all the checkboxes that apply -->
<!-- All points should be verified, otherwise, read the CONTRIBUTING guidelines from above-->
<!-- If you're unsure about any of these, don't hesitate to ask on sr-dev mailing list -->
- [X] Commit message has the format required by CONTRIBUTING guide
- [X] Commits are split per component (core, individual modules, libs, utils, ...)
- [X] Each component has a single commit (if not, squash them into one commit)
- [X] No commits to README files for modules (changes must be done to docbook files
in `doc/` subfolder, the README file is autogenerated)
#### Type Of Change
- [ ] Small bug fix (non-breaking change which fixes an issue)
- [X] New feature (non-breaking change which adds new functionality)
- [ ] Breaking change (fix or feature that would change existing functionality)
#### Checklist:
<!-- Go over all points below, and after creating the PR, tick the checkboxes that apply -->
- [ ] PR should be backported to stable branches
- [X] Tested changes locally
- [ ] Related to issue #XXXX (replace XXXX with an open issue number)
#### Description
<!-- Describe your changes in detail -->
Exported some functions to kemi. Currently testing.
You can view, comment on, or merge this pull request online at:
https://github.com/kamailio/kamailio/pull/3235
-- Commit Summary --
* ratelimit: export functions to kemi
* siputils: export is_gruu() to kemi
* dialplan: export dp_translate to kemi
-- File Changes --
M src/modules/dialplan/dialplan.c (90)
M src/modules/ratelimit/ratelimit.c (33)
M src/modules/siputils/siputils.c (10)
-- Patch Links --
https://github.com/kamailio/kamailio/pull/3235.patchhttps://github.com/kamailio/kamailio/pull/3235.diff
--
Reply to this email directly or view it on GitHub:
https://github.com/kamailio/kamailio/pull/3235
You are receiving this because you are subscribed to this thread.
Message ID: <kamailio/kamailio/pull/3235(a)github.com>
Hello,
you can use something like this:
$ cd kamailio
$ make modules modules=src/modules/sca
make -C src/ modules modules=modules/sca
make[1]: Entering directory '/home/henning/repositories/kamailio/src'
[..]
Cheers,
Henning
--
Henning Westerholt – https://skalatan.de/blog/
Kamailio services – https://gilawa.com<https://gilawa.com/>
From: sr-users <sr-users-bounces(a)lists.kamailio.org> On Behalf Of Satyaprakash Chiramchetty
Sent: Wednesday, September 14, 2022 12:52 PM
To: sr-users(a)lists.kamailio.org
Subject: [SR-Users] Modules changes query
Hi team,
I have added a few lines more in the SCA module, So if I want to compile again only the sca, So what command I need to use?
Thanks and Regards,
Satyaprakash.
[https://ecosmobnew.ecosmob.net/wp-content/uploads/2022/09/Mix-Event-Signatu…]<https://www.ecosmob.com/>
Disclaimer
In addition to generic Disclaimer which you have agreed on our website, any views or opinions presented in this email are solely those of the originator and do not necessarily represent those of the Company or its sister concerns. Any liability (in negligence, contract or otherwise) arising from any third party taking any action, or refraining from taking any action on the basis of any of the information contained in this email is hereby excluded.
Confidentiality
This communication (including any attachment/s) is intended only for the use of the addressee(s) and contains information that is PRIVILEGED AND CONFIDENTIAL. Unauthorized reading, dissemination, distribution, or copying of this communication is prohibited. Please inform originator if you have received it in error.
Caution for viruses, malware etc.
This communication, including any attachments, may not be free of viruses, trojans, similar or new contaminants/malware, interceptions or interference, and may not be compatible with your systems. You shall carry out virus/malware scanning on your own before opening any attachment to this e-mail. The sender of this e-mail and Company including its sister concerns shall not be liable for any damage that may incur to you as a result of viruses, incompleteness of this message, a delay in receipt of this message or any other computer problems.
Hello,
Kamailio SIP Server v5.4.9 stable release is out.
This is a maintenance release of the old stable branch, 5.4, that
includes fixes since the release of v5.4.8. There is no change to
database schema or configuration language structure that you have to do
on previous installations of v5.4.x. Deployments running previous v5.4.x
versions are strongly recommended to be upgraded to v5.4.9 or even
better to v5.5.x or 5.6.x series.
For more details about version 5.4.9 (including links and guidelines to
download the tarball or from GIT repository), visit:
 * https://www.kamailio.org/w/2022/09/kamailio-v5-4-9-released/
RPM, Debian/Ubuntu packages will be available soon as well.
Note:Â the branch 5.4 is an old stable branch, v5.4.9 being the last
planned release out of it, to mark the end of official maintenance.
The maintained stable branches are now 5.5 and 5.6, at this time with
v5.6.1 being the latest stable release.
Many thanks to all contributing and using Kamailio!
Cheers,
Daniel
--
Daniel-Constantin Mierla -- www.asipto.comwww.twitter.com/miconda -- www.linkedin.com/in/miconda
<!--
Kamailio Project uses GitHub Issues only for bugs in the code or feature requests. Please use this template only for bug reports.
If you have questions about using Kamailio or related to its configuration file, ask on sr-users mailing list:
* http://lists.kamailio.org/cgi-bin/mailman/listinfo/sr-users
If you have questions about developing extensions to Kamailio or its existing C code, ask on sr-dev mailing list:
* http://lists.kamailio.org/cgi-bin/mailman/listinfo/sr-dev
Please try to fill this template as much as possible for any issue. It helps the developers to troubleshoot the issue.
If there is no content to be filled in a section, the entire section can be removed.
You can delete the comments from the template sections when filling.
You can delete next line and everything above before submitting (it is a comment).
-->
### Description
I have a cluster of 2 Kamailios nodes on debian 9 + Kamailio 5.5.4.
We have installed a 3rd server on debian 11 + Kamailio 5.6.1 but it keeps crashing due to an issue with DMQ USRLOC
### Troubleshooting
#### Reproduction
We don't know how to reproduce but this is currently happening constantly on our new server
#### Debugging Data
<!--
If you got a core dump, use gdb to extract troubleshooting data - full backtrace,
local variables and the list of the code at the issue location.
gdb /path/to/kamailio /path/to/corefile
bt full
info locals
list
If you are familiar with gdb, feel free to attach more of what you consider to
be relevant.
-->
Kamailio generates a core on each segfault:
```
-rw------- 1 kamailio kamailio 556M Sep 15 02:42 core.kamailio.7507.csbc03.example.com.1663227725
-rw------- 1 kamailio kamailio 556M Sep 15 02:42 core.kamailio.7576.csbc03.example.com.1663227733
-rw------- 1 kamailio kamailio 556M Sep 15 02:42 core.kamailio.7642.csbc03.example.com.1663227739
-rw------- 1 kamailio kamailio 556M Sep 15 02:42 core.kamailio.7708.csbc03.example.com.1663227746
-rw------- 1 kamailio kamailio 556M Sep 15 02:42 core.kamailio.7772.csbc03.example.com.1663227753
```
But they seem to be empty?
```
root@csbc03:/var/tmp# gdb core.kamailio.7772.csbc03.example.com.1663227753
GNU gdb (Debian 10.1-1.7) 10.1.90.20210103-git
Copyright (C) 2021 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
Type "show copying" and "show warranty" for details.
This GDB was configured as "x86_64-linux-gnu".
Type "show configuration" for configuration details.
For bug reporting instructions, please see:
<https://www.gnu.org/software/gdb/bugs/>.
Find the GDB manual and other documentation resources online at:
<http://www.gnu.org/software/gdb/documentation/>.
For help, type "help".
Type "apropos word" to search for commands related to "word"...
"0x7ffec5273ce0s": not in executable format: file format not recognized
(gdb) bt full
No stack.
(gdb) quit
root@csbc03:/var/tmp#
```
Very similar output for any of the other core files when In run `bt full`.
I confirmed debug symbols were installed:
```
root@csbc03:/var/tmp# dpkg -l | grep kam | grep dbg
ii kamailio-dbg:amd64 5.6.1+bpo11 amd64 very fast and configurable SIP server [debug symbols]
root@csbc03:/var/tmp#
```
#### Log Messages
<!--
Check the syslog file and if there are relevant log messages printed by Kamailio, add them next, or attach to issue, or provide a link to download them (e.g., to a pastebin site).
-->
/var/log/syslog
```
[ 501.251476] kamailio[7772]: segfault at f8 ip 00007f86ded9bf72 sp 00007ffd892eb7c0 error 4 in dmq_usrloc.so[7f86ded89000+17000]
[ 501.251496] Code: 40 38 01 d0 89 05 12 95 00 00 48 8b 05 cf 8f 00 00 8b 00 83 f8 01 0f 85 80 00 00 00 48 8b 85 48 ff ff ff 48 8b 80 a0 00 00 00 <8b> 90 f8 00 00 00 48 8b 85 48 ff ff ff 48 8b 80 a0 00 00 00 48 8b
```
/var/log/kamailio/kamailio.lorg
```
Sep 15 02:42:34 csbc03 csbc[7792]: CRITICAL: <core> [core/pass_fd.c:277]: receive_fd(): EOF on 59
Sep 15 02:42:36 csbc03 csbc[7736]: ALERT: <core> [main.c:774]: handle_sigs(): child process 7772 exited by a signal 11
Sep 15 02:42:36 csbc03 csbc[7736]: ALERT: <core> [main.c:777]: handle_sigs(): core was generated
```
#### SIP Traffic
<!--
If the issue is exposed by processing specific SIP messages, grab them with ngrep or save in a pcap file, then add them next, or attach to issue, or provide a link to download them (e.g., to a pastebin site).
-->
```
(paste your sip traffic here)
```
### Possible Solutions
<!--
If you found a solution or workaround for the issue, describe it. Ideally, provide a pull request with a fix.
-->
### Additional Information
* **Kamailio Version** - output of `kamailio -v`
```
root@csbc03:/var/tmp# kamailio -v
version: kamailio 5.6.1 (x86_64/linux)
flags: USE_TCP, USE_TLS, USE_SCTP, TLS_HOOKS, USE_RAW_SOCKS, DISABLE_NAGLE, USE_MCAST, DNS_IP_HACK, SHM_MMAP, PKG_MALLOC, Q_MALLOC, F_MALLOC, TLSF_MALLOC, DBG_SR_MEMORY, USE_FUTEX, FAST_LOCK-ADAPTIVE_WAIT, USE_DNS_CACHE, USE_DNS_FAILOVER, USE_NAPTR, USE_DST_BLOCKLIST, HAVE_RESOLV_RES, TLS_PTHREAD_MUTEX_SHARED
ADAPTIVE_WAIT_LOOPS 1024, MAX_RECV_BUFFER_SIZE 262144, MAX_URI_SIZE 1024, BUF_SIZE 65535, DEFAULT PKG_SIZE 8MB
poll method support: poll, epoll_lt, epoll_et, sigio_rt, select.
id: unknown
compiled with gcc 10.2.1
root@csbc03:/var/tmp#
```
* **Operating System**:
<!--
Details about the operating system, the type: Linux (e.g.,: Debian 8.4, Ubuntu 16.04, CentOS 7.1, ...), MacOS, xBSD, Solaris, ...;
Kernel details (output of `lsb_release -a` and `uname -a`)
-->
```
Debian 11 Bullseye
```
--
Reply to this email directly or view it on GitHub:
https://github.com/kamailio/kamailio/issues/3238
You are receiving this because you are subscribed to this thread.
Message ID: <kamailio/kamailio/issues/3238(a)github.com>
Hello,
I am planning to release a new version from branch 5.4, respectively
5.4.9, sometime soon, maybe on Friday or Monday.
Unless a major regression comes out with this release, this is going to
be the last official packaged version from branch 5.4. The latest two
stable branches 5.5 and 5.6 will be maintained further.
As usual, if anyone is aware of issues not yet reported to bug tracker
or missing backports, report them in order to try to get the fixes in
this release.
Cheers,
Daniel
--
Daniel-Constantin Mierla -- www.asipto.comwww.twitter.com/miconda -- www.linkedin.com/in/miconda
Hi,
The "--cfg-print" CLI option is not documented in Kamailio 5.6 Cookbook.
I'm sorry but I don't know how to add it by myself...
Leonid
--
Reply to this email directly or view it on GitHub:
https://github.com/kamailio/kamailio/issues/3239
You are receiving this because you are subscribed to this thread.
Message ID: <kamailio/kamailio/issues/3239(a)github.com>
Module: kamailio
Branch: 5.6
Commit: 2b1a5ffb75566fb9411b23be23b263986b3eafaa
URL: https://github.com/kamailio/kamailio/commit/2b1a5ffb75566fb9411b23be23b2639…
Author: Daniel-Constantin Mierla <miconda(a)gmail.com>
Committer: Daniel-Constantin Mierla <miconda(a)gmail.com>
Date: 2022-09-15T10:28:03+02:00
dmq: docs - note about using same Kamailio version
(cherry picked from commit 1fd789246cc7c58237b9a903a198521cd5b3494d)
---
Modified: src/modules/dmq/doc/dmq_admin.xml
---
Diff: https://github.com/kamailio/kamailio/commit/2b1a5ffb75566fb9411b23be23b2639…
Patch: https://github.com/kamailio/kamailio/commit/2b1a5ffb75566fb9411b23be23b2639…
---
diff --git a/src/modules/dmq/doc/dmq_admin.xml b/src/modules/dmq/doc/dmq_admin.xml
index 661fd4b8471..7a2c933c62f 100644
--- a/src/modules/dmq/doc/dmq_admin.xml
+++ b/src/modules/dmq/doc/dmq_admin.xml
@@ -47,6 +47,11 @@
Nodes that are not responding to KDMQ reguests are removed the from local
list of active nodes, no longer being considered to be part of the KDMQ cluster.
</para>
+ <para>
+ IMPORTANT: DMQ must be used only between Kamailio instances having same
+ major version. Internal structures can be incompatible between different
+ major versions and can lead to crashes or unexpected behaviour.
+ </para>
<example>
<title>KDMQ Request Example</title>
<para>
Module: kamailio
Branch: 5.6
Commit: 961b62fc1ced8e7015052c97bf288a560d50e7f7
URL: https://github.com/kamailio/kamailio/commit/961b62fc1ced8e7015052c97bf288a5…
Author: Kamailio Dev <kamailio.dev(a)kamailio.org>
Committer: Kamailio Dev <kamailio.dev(a)kamailio.org>
Date: 2022-09-15T10:46:34+02:00
modules: readme files regenerated - modules ... [skip ci]
---
Modified: src/modules/dmq/README
---
Diff: https://github.com/kamailio/kamailio/commit/961b62fc1ced8e7015052c97bf288a5…
Patch: https://github.com/kamailio/kamailio/commit/961b62fc1ced8e7015052c97bf288a5…
---
diff --git a/src/modules/dmq/README b/src/modules/dmq/README
index 10f0f7f80a..b79a6c2759 100644
--- a/src/modules/dmq/README
+++ b/src/modules/dmq/README
@@ -28,6 +28,9 @@ Charles Chance
1. Admin Guide
1. Overview
+
+ 1.1. KDMQ Request
+
2. Dependencies
2.1. Kamailio Modules
@@ -99,6 +102,9 @@ Chapter 1. Admin Guide
Table of Contents
1. Overview
+
+ 1.1. KDMQ Request
+
2. Dependencies
2.1. Kamailio Modules
@@ -131,6 +137,8 @@ Chapter 1. Admin Guide
1. Overview
+ 1.1. KDMQ Request
+
The DMQ module implements a distributed message queue on top of
Kamailio in order to facilitate data propagation and replication
between multiple instances, referred as "nodes" (or "peers").
@@ -166,11 +174,16 @@ Chapter 1. Admin Guide
different major versions and can lead to crashes or unexpected
behaviour.
- Example 1.1. KDMQ Request Example
+1.1. KDMQ Request
+
+ KDMQ messages can have different format and content for R-URI username,
+ headers and body, being specific to each component that leverages DMQ
+ to replicate data, such as htable, dialog or usrloc modules.
- This request is generated for DMQ peers availability notifications.
- Other messages can be produced by various modules, with different R-URI
- username and body content, such as htable, dialog or usrloc modules.
+ Next request is generated by DMQ module for peers availability
+ notifications.
+
+ Example 1.1. KDMQ Request Example
...
KDMQ sip:notification_peer@192.168.40.15:5090 SIP/2.0
Module: kamailio
Branch: master
Commit: 95e0fe85ff9149c80249e848a437deb5dae2e463
URL: https://github.com/kamailio/kamailio/commit/95e0fe85ff9149c80249e848a437deb…
Author: Kamailio Dev <kamailio.dev(a)kamailio.org>
Committer: Kamailio Dev <kamailio.dev(a)kamailio.org>
Date: 2022-09-15T10:46:17+02:00
modules: readme files regenerated - dmq ... [skip ci]
---
Modified: src/modules/dmq/README
---
Diff: https://github.com/kamailio/kamailio/commit/95e0fe85ff9149c80249e848a437deb…
Patch: https://github.com/kamailio/kamailio/commit/95e0fe85ff9149c80249e848a437deb…
---
diff --git a/src/modules/dmq/README b/src/modules/dmq/README
index 10f0f7f80a..b79a6c2759 100644
--- a/src/modules/dmq/README
+++ b/src/modules/dmq/README
@@ -28,6 +28,9 @@ Charles Chance
1. Admin Guide
1. Overview
+
+ 1.1. KDMQ Request
+
2. Dependencies
2.1. Kamailio Modules
@@ -99,6 +102,9 @@ Chapter 1. Admin Guide
Table of Contents
1. Overview
+
+ 1.1. KDMQ Request
+
2. Dependencies
2.1. Kamailio Modules
@@ -131,6 +137,8 @@ Chapter 1. Admin Guide
1. Overview
+ 1.1. KDMQ Request
+
The DMQ module implements a distributed message queue on top of
Kamailio in order to facilitate data propagation and replication
between multiple instances, referred as "nodes" (or "peers").
@@ -166,11 +174,16 @@ Chapter 1. Admin Guide
different major versions and can lead to crashes or unexpected
behaviour.
- Example 1.1. KDMQ Request Example
+1.1. KDMQ Request
+
+ KDMQ messages can have different format and content for R-URI username,
+ headers and body, being specific to each component that leverages DMQ
+ to replicate data, such as htable, dialog or usrloc modules.
- This request is generated for DMQ peers availability notifications.
- Other messages can be produced by various modules, with different R-URI
- username and body content, such as htable, dialog or usrloc modules.
+ Next request is generated by DMQ module for peers availability
+ notifications.
+
+ Example 1.1. KDMQ Request Example
...
KDMQ sip:notification_peer@192.168.40.15:5090 SIP/2.0
Module: kamailio
Branch: 5.6
Commit: 80699e44d2e7849c25e10d125dfce3ea14bc45f8
URL: https://github.com/kamailio/kamailio/commit/80699e44d2e7849c25e10d125dfce3e…
Author: Daniel-Constantin Mierla <miconda(a)gmail.com>
Committer: Daniel-Constantin Mierla <miconda(a)gmail.com>
Date: 2022-09-15T10:35:39+02:00
dmq: docs - reorganized the dmq request section
(cherry picked from commit e683ee506d702e9edbe4ce74304170ca04c1d5ec)
---
Modified: src/modules/dmq/doc/dmq_admin.xml
---
Diff: https://github.com/kamailio/kamailio/commit/80699e44d2e7849c25e10d125dfce3e…
Patch: https://github.com/kamailio/kamailio/commit/80699e44d2e7849c25e10d125dfce3e…
---
diff --git a/src/modules/dmq/doc/dmq_admin.xml b/src/modules/dmq/doc/dmq_admin.xml
index 7a2c933c62..d463fac2d9 100644
--- a/src/modules/dmq/doc/dmq_admin.xml
+++ b/src/modules/dmq/doc/dmq_admin.xml
@@ -52,15 +52,20 @@
major version. Internal structures can be incompatible between different
major versions and can lead to crashes or unexpected behaviour.
</para>
- <example>
- <title>KDMQ Request Example</title>
+ <section>
+ <title>KDMQ Request</title>
<para>
- This request is generated for DMQ peers availability notifications.
- Other messages can be produced by various modules, with different R-URI
- username and body content, such as <emphasis>htable</emphasis>,
- <emphasis>dialog</emphasis> or <emphasis>usrloc</emphasis> modules.
+ KDMQ messages can have different format and content for R-URI username, headers
+ and body, being specific to each component that leverages DMQ to replicate
+ data, such as <emphasis>htable</emphasis>, <emphasis>dialog</emphasis>
+ or <emphasis>usrloc</emphasis> modules.
</para>
- <programlisting format="linespecific">
+ <para>
+ Next request is generated by DMQ module for peers availability notifications.
+ </para>
+ <example>
+ <title>KDMQ Request Example</title>
+ <programlisting format="linespecific">
...
KDMQ sip:notification_peer@192.168.40.15:5090 SIP/2.0
@@ -82,6 +87,7 @@ sip:192.168.40.17:5060;status=active
</programlisting>
</example>
</section>
+ </section>
<section>
<title>Dependencies</title>
Module: kamailio
Branch: master
Commit: e683ee506d702e9edbe4ce74304170ca04c1d5ec
URL: https://github.com/kamailio/kamailio/commit/e683ee506d702e9edbe4ce74304170c…
Author: Daniel-Constantin Mierla <miconda(a)gmail.com>
Committer: Daniel-Constantin Mierla <miconda(a)gmail.com>
Date: 2022-09-15T10:35:17+02:00
dmq: docs - reorganized the dmq request section
---
Modified: src/modules/dmq/doc/dmq_admin.xml
---
Diff: https://github.com/kamailio/kamailio/commit/e683ee506d702e9edbe4ce74304170c…
Patch: https://github.com/kamailio/kamailio/commit/e683ee506d702e9edbe4ce74304170c…
---
diff --git a/src/modules/dmq/doc/dmq_admin.xml b/src/modules/dmq/doc/dmq_admin.xml
index 7a2c933c62..d463fac2d9 100644
--- a/src/modules/dmq/doc/dmq_admin.xml
+++ b/src/modules/dmq/doc/dmq_admin.xml
@@ -52,15 +52,20 @@
major version. Internal structures can be incompatible between different
major versions and can lead to crashes or unexpected behaviour.
</para>
- <example>
- <title>KDMQ Request Example</title>
+ <section>
+ <title>KDMQ Request</title>
<para>
- This request is generated for DMQ peers availability notifications.
- Other messages can be produced by various modules, with different R-URI
- username and body content, such as <emphasis>htable</emphasis>,
- <emphasis>dialog</emphasis> or <emphasis>usrloc</emphasis> modules.
+ KDMQ messages can have different format and content for R-URI username, headers
+ and body, being specific to each component that leverages DMQ to replicate
+ data, such as <emphasis>htable</emphasis>, <emphasis>dialog</emphasis>
+ or <emphasis>usrloc</emphasis> modules.
</para>
- <programlisting format="linespecific">
+ <para>
+ Next request is generated by DMQ module for peers availability notifications.
+ </para>
+ <example>
+ <title>KDMQ Request Example</title>
+ <programlisting format="linespecific">
...
KDMQ sip:notification_peer@192.168.40.15:5090 SIP/2.0
@@ -82,6 +87,7 @@ sip:192.168.40.17:5060;status=active
</programlisting>
</example>
</section>
+ </section>
<section>
<title>Dependencies</title>
Module: kamailio
Branch: 5.6
Commit: 31b538926d89783cf0ef86bfbc588ee39342b433
URL: https://github.com/kamailio/kamailio/commit/31b538926d89783cf0ef86bfbc588ee…
Author: Kamailio Dev <kamailio.dev(a)kamailio.org>
Committer: Kamailio Dev <kamailio.dev(a)kamailio.org>
Date: 2022-09-15T10:31:54+02:00
modules: readme files regenerated - modules ... [skip ci]
---
Modified: src/modules/dmq/README
---
Diff: https://github.com/kamailio/kamailio/commit/31b538926d89783cf0ef86bfbc588ee…
Patch: https://github.com/kamailio/kamailio/commit/31b538926d89783cf0ef86bfbc588ee…
---
diff --git a/src/modules/dmq/README b/src/modules/dmq/README
index 1e7d6ff375..10f0f7f80a 100644
--- a/src/modules/dmq/README
+++ b/src/modules/dmq/README
@@ -161,6 +161,11 @@ Chapter 1. Admin Guide
the from local list of active nodes, no longer being considered to be
part of the KDMQ cluster.
+ IMPORTANT: DMQ must be used only between Kamailio instances having same
+ major version. Internal structures can be incompatible between
+ different major versions and can lead to crashes or unexpected
+ behaviour.
+
Example 1.1. KDMQ Request Example
This request is generated for DMQ peers availability notifications.
Module: kamailio
Branch: master
Commit: b7e6b0cc44b46a615dc23b6fae7f67e63296c913
URL: https://github.com/kamailio/kamailio/commit/b7e6b0cc44b46a615dc23b6fae7f67e…
Author: Kamailio Dev <kamailio.dev(a)kamailio.org>
Committer: Kamailio Dev <kamailio.dev(a)kamailio.org>
Date: 2022-09-15T10:31:28+02:00
modules: readme files regenerated - dmq ... [skip ci]
---
Modified: src/modules/dmq/README
---
Diff: https://github.com/kamailio/kamailio/commit/b7e6b0cc44b46a615dc23b6fae7f67e…
Patch: https://github.com/kamailio/kamailio/commit/b7e6b0cc44b46a615dc23b6fae7f67e…
---
diff --git a/src/modules/dmq/README b/src/modules/dmq/README
index 1e7d6ff375..10f0f7f80a 100644
--- a/src/modules/dmq/README
+++ b/src/modules/dmq/README
@@ -161,6 +161,11 @@ Chapter 1. Admin Guide
the from local list of active nodes, no longer being considered to be
part of the KDMQ cluster.
+ IMPORTANT: DMQ must be used only between Kamailio instances having same
+ major version. Internal structures can be incompatible between
+ different major versions and can lead to crashes or unexpected
+ behaviour.
+
Example 1.1. KDMQ Request Example
This request is generated for DMQ peers availability notifications.
Module: kamailio
Branch: master
Commit: 1fd789246cc7c58237b9a903a198521cd5b3494d
URL: https://github.com/kamailio/kamailio/commit/1fd789246cc7c58237b9a903a198521…
Author: Daniel-Constantin Mierla <miconda(a)gmail.com>
Committer: Daniel-Constantin Mierla <miconda(a)gmail.com>
Date: 2022-09-15T10:26:38+02:00
dmq: docs - note about using same Kamailio version
---
Modified: src/modules/dmq/doc/dmq_admin.xml
---
Diff: https://github.com/kamailio/kamailio/commit/1fd789246cc7c58237b9a903a198521…
Patch: https://github.com/kamailio/kamailio/commit/1fd789246cc7c58237b9a903a198521…
---
diff --git a/src/modules/dmq/doc/dmq_admin.xml b/src/modules/dmq/doc/dmq_admin.xml
index 661fd4b8471..7a2c933c62f 100644
--- a/src/modules/dmq/doc/dmq_admin.xml
+++ b/src/modules/dmq/doc/dmq_admin.xml
@@ -47,6 +47,11 @@
Nodes that are not responding to KDMQ reguests are removed the from local
list of active nodes, no longer being considered to be part of the KDMQ cluster.
</para>
+ <para>
+ IMPORTANT: DMQ must be used only between Kamailio instances having same
+ major version. Internal structures can be incompatible between different
+ major versions and can lead to crashes or unexpected behaviour.
+ </para>
<example>
<title>KDMQ Request Example</title>
<para>
Hello,
kamailio.org system needs a reboot and it will become unavailable for a
short time frame about 08:00UTC (20 min from now). Website, mailing
list, wiki, and a few other web services will be affected.
Cheers,
Daniel
--
Daniel-Constantin Mierla -- www.asipto.comwww.twitter.com/miconda -- www.linkedin.com/in/miconda