Integrics Wiki - User contributions [en-gb]

Coding Guidelines

2025-10-20T19:28:36Z

Vlasis:

When working on Integrics code, developers are encouraged to bear these guidelines in mind. They are guidelines rather than rules, and developers should use their own judgement as to when to break them.

* All development
** For normal text that will be read by humans, use sentence case without capital letters in the middle of sentences unless specifically required: This is a sample.
** A naming convention of <noun>_<verb> is preferred for exported library functions: email_send()
** Libraries should, where reasonable, keep their functions sorted alphabetically.
** Use the Unix standard of the newline character ("\n") to terminate lines.
** Comments should be limited to the following, unless there's a specific reason otherwise. Overuse of comments is discouraged.
*** A brief description at the top of files.
*** A copyright notice at the top of files.
*** A brief description of each 'paragraph' in long functions.
*** An explanation any section of code that may be counter-intuitive to someone reading the source.
** In Enswitch, from version 4.4 onward the person's proper parameters such as id, login_id, effective_id, role, login_role, effective_role, customer, login_customer, effective_customer etc should be observed according to the intended use in the code:
*** effective_id, effective_customer, etc (ie the effective_* parameters) should be used when the code relates to the switched-into user.
*** login_id, login_customer, etc (ie the login_* parameters) should be used when the code relates to the user as originally logged in.
*** id, customer, etc (ie the plain parameters) should be used in relation to a user in the people table for eg. as a result of a query to that table.

* Go specific
** Run "go fmt" before checking into the repository.
** Strip executables before distribution unless symbols are specifically required for debugging.

* Perl specific
** Use $snake_case for variable names.
** Use snake_case for function names.
** Use CamelCase for package names.
** Use short variable names for hash references, particularly those created from database lookups.
** Use tabs for indentation.
** Leave a space after open brackets: if ( $variable ) {
** Leave a space before close brackets: if ( $variable ) {
** Leave a space after commas: function( $a, $b, $c );
** Leave a space after negation: if ( ! $variable ) {
** Do not leave a blank line after if, else, while, foreach, etc.
** Do not leave a blank line before solitary closing curly brackets.
** Do not leave multiple consecutive blank lines.
** Use " => " between hash array keys and values, and ", " between values and keys.
** If a list is very long, spread it across multiple lines. The last line before the closing round bracket should have a trailing comma.
** Use brackets on built-in Perl functions which can optionally have brackets: scalar( @variable )
** Use @EXPORT for library functions that are intended to be public.
** Use @EXPORT_OK for library variables that are intended to be public.
** 'use' statements should be listed at the top of each file, in case-insensitive alphabetical order, unless otherwise necessary.
** 'require' statements may be embedded within functions.
** Use the "<condition> ? <if true> : <if false>" construct if thought appropriate.
** For Enswitch versions 4.2 and newer prefer the array style syntax for SQL queries even for data with a single parameter, e.g. data => [ $a->{ 'uniqueid' } ].

* Databases
** Use snake_case for column names.

* Configuration files
** Use .ini format.
** Use single word lower-case section and key names were possible, or snake_case if multiple words are required.
** Use "true" and "false" for boolean values.

Coding Guidelines

2025-08-28T21:20:39Z

Vlasis:

When working on Integrics code, developers are encouraged to bear these guidelines in mind. They are guidelines rather than rules, and developers should use their own judgement as to when to break them.

* All development
** For normal text that will be read by humans, use sentence case without capital letters in the middle of sentences unless specifically required: This is a sample.
** A naming convention of <noun>_<verb> is preferred for exported library functions: email_send()
** Libraries should, where reasonable, keep their functions sorted alphabetically.
** Use the Unix standard of the newline character ("\n") to terminate lines.
** Comments should be limited to the following, unless there's a specific reason otherwise. Overuse of comments is discouraged.
*** A brief description at the top of files.
*** A copyright notice at the top of files.
*** A brief description of each 'paragraph' in long functions.
*** An explanation any section of code that may be counter-intuitive to someone reading the source.
** In Enswitch, from version 4.4 onward the person's proper parameters such as id, login_id, effective_id, customer, login_customer, effective_customer etc should be observed according to the intended use in the code:
*** effective_id, effective_customer, etc (ie the effective_* parameters) should be used when the code relates to the switched-into user.
*** login_id, login_customer, etc (ie the login_* parameters) should be used when the code relates to the user as originally logged in.
*** id, customer, etc (ie the plain parameters) should be used in relation to a user in the people table for eg. as a result of a query to that table.

* Go specific
** Run "go fmt" before checking into the repository.
** Strip executables before distribution unless symbols are specifically required for debugging.

* Perl specific
** Use $snake_case for variable names.
** Use snake_case for function names.
** Use CamelCase for package names.
** Use short variable names for hash references, particularly those created from database lookups.
** Use tabs for indentation.
** Leave a space after open brackets: if ( $variable ) {
** Leave a space before close brackets: if ( $variable ) {
** Leave a space after commas: function( $a, $b, $c );
** Leave a space after negation: if ( ! $variable ) {
** Do not leave a blank line after if, else, while, foreach, etc.
** Do not leave a blank line before solitary closing curly brackets.
** Do not leave multiple consecutive blank lines.
** Use " => " between hash array keys and values, and ", " between values and keys.
** If a list is very long, spread it across multiple lines. The last line before the closing round bracket should have a trailing comma.
** Use brackets on built-in Perl functions which can optionally have brackets: scalar( @variable )
** Use @EXPORT for library functions that are intended to be public.
** Use @EXPORT_OK for library variables that are intended to be public.
** 'use' statements should be listed at the top of each file, in case-insensitive alphabetical order, unless otherwise necessary.
** 'require' statements may be embedded within functions.
** Use the "<condition> ? <if true> : <if false>" construct if thought appropriate.
** For Enswitch versions 4.2 and newer prefer the array style syntax for SQL queries even for data with a single parameter, e.g. data => [ $a->{ 'uniqueid' } ].

* Databases
** Use snake_case for column names.

* Configuration files
** Use .ini format.
** Use single word lower-case section and key names were possible, or snake_case if multiple words are required.
** Use "true" and "false" for boolean values.

Enswitch installation on AWS

2025-07-04T16:14:13Z

Vlasis:

Failover parameter in /etc/enswitch/databases.ini

2025-05-29T19:30:02Z

Vlasis:

In the configuration file /etc/enswitch/databases.ini the following parameter is available:

failover = yes

This is '''NOT''' related to any HA failover setup for the database.

The 'failover' parameter is used to set up failover connections to alternative database addresses that use the same database handle.

An example use case for this would be if a report server was set up to run reports on slave db servers, then 'failover' could be set to yes in order to select a second slave db server, in case the first one was not available.

So, if HA is set for the database system, then the 'failover' parameter has limited functionality.

Multiple machines for the same handle can be configured and Enswitch will read the configuration stanzas sequentially. There is no theoretical limit on how many stanzas can be set with the same handle.

The example below shows the database configuration on a server that uses three db servers with the same database handle.

Setting 'failover = yes' for the db1.example.com host means that if the database connection to db1.example.com fails, then Enswitch will attempt to connect to the next machine (db2.example.com) that is configured for the same handler (select/cdrs).

Setting 'failover = no' for the db2.example.com host means that if the database connection to db2.example.com fails, then Enswitch will not attempt any further connections, even if subsequent stanzas are configured with "failover = yes".

So, in this example if the database connection to db2.example.com fails, then a connection to db3.example.com will not be attempted.

Setting the 'failover' parameter to 'yes' or 'no' on the last host of a handle will not make any difference because Enswitch will not attempt any further connections during that batch of connection attempts and will log an error.

The connection attempts will begin again from the start after 10 secs, as is the standard behavior of Enswitch.

<pre>
[select/cdrs]
database = enswitch
host = db1.example.com
port = 3306
username = enswitch
password = any
failover = yes

[select/cdrs]
database = enswitch
host = db2.example.com
port = 3306
username = enswitch
password = any
failover = no

[select/cdrs]
database = enswitch
host = db3.example.com
port = 3306
username = enswitch
password = any
failover = yes
</pre>

Failover parameter in /etc/enswitch/databases.ini

2025-05-22T14:52:35Z

Vlasis:

Failover parameter in /etc/enswitch/databases.ini

2025-05-16T08:39:30Z

Vlasis: Created page with "In the configuration file /etc/enswitch/databases.ini the following parameter is available: failover = yes This is '''NOT''' related to any HA failover setup for the databas..."

Enswitch installation on AWS

2025-04-24T14:25:01Z

Vlasis:

How to set up Enswitch on a single machine cluster on AWS

This set up has been tested successfully on an Enswitch 4.0 single machine cluster with Kamailio 5.8.2 and Asterisk 13.38.3:

* Under the global configuration, create two machines, one for the internal IP address and FQDN and the other for the external IP and FQDN. Set only the internal address machine to accept calls as an Asterisk server.
* Under the global configuration, create domains for the internal IP address, the internal FQDN, the external IP and the external FQDN.
* Under the global configuration, set the "Message daemon IP address" to be the internal IP address.
* Edit /etc/kamailio/kamailio.cfg as below:
<pre>
listen = udp:<internal IP>:5060 advertise <external IP>:5060
listen = tcp:<internal IP>:5060 advertise <external IP>:5060

# AWS
#!define AWS_INTERNAL_IP <internal IP>
#!define AWS_EXTERNAL_IP "<external IP>"
</pre>

* Edit /opt/enswitch/current/etc/kamailio/kamailio_58.cfg as below:
<pre>
Index: etc/kamailio/kamailio_58.cfg
===================================================================
--- etc/kamailio/kamailio_58.cfg (revision 21240)
+++ etc/kamailio/kamailio_58.cfg (working copy)
@@ -334,6 +334,11 @@
}
}
if ( is_method( "INVITE" ) ) {
+ #!ifdef AWS_EXTERNAL_IP
+ if ( src_ip == AWS_INTERNAL_IP ) {
+ fix_nated_sdp("3",AWS_EXTERNAL_IP);
+ }
+ #!endif
$var(pai_count) = 0;
while( defined $(hdr(P-Asserted-Identity)[$var(pai_count)]) ) {
$var(pai_count) = $var(pai_count) + 1;
@@ -359,6 +364,11 @@
if ( is_method( "BYE" ) ) {
t_on_branch( "BRANCH" );
}
+ #!ifdef AWS_EXTERNAL_IP
+ if ( is_method( "SUBSCRIBE" ) ) {
+ set_advertised_address( AWS_INTERNAL_IP );
+ }
+ #!endif
if ( ! t_relay() ) {
sl_reply_error();
}
@@ -368,6 +378,11 @@
onreply_route[ REPLY ] {
if ( sdp_content() ) {
$avp(ENSWITCH-CIPHERS-SAFE) = $rb;
+ #!ifdef AWS_EXTERNAL_IP
+ if ( src_ip == AWS_INTERNAL_IP ) {
+ fix_nated_sdp("3",AWS_EXTERNAL_IP);
+ }
+ #!endif
}

force_rport();
@@ -494,6 +509,9 @@
# enforce routing to sipd
rewritehostporttrans("127.0.0.1:5080;transport=udp");
remove_hf( "Route" );
+ #!ifdef AWS_EXTERNAL_IP
+ set_advertised_address( AWS_INTERNAL_IP );
+ #!endif
route( FORWARD );
exit;
}
</pre>

* - In /etc/asterisk/sip.conf add a local-public, a local-private, a public IP and a private IP stanza, eg:
<pre>
[enswitch-local-public]
host = <external IP>
fromdomain = <external IP>
type = friend
insecure = port,invite
context = from-internal
canreinvite = no
nat = yes
t38pt_udptl = yes

[enswitch-local-private]
host = <internal IP>
fromdomain = <internal IP>
type = friend
insecure = port,invite
context = from-internal
canreinvite = no
nat = yes
t38pt_udptl = yes

[<external IP>]
host = <external IP>
fromdomain = <external IP>
type = friend
insecure = port,invite
context = from-internal
canreinvite = no
nat = yes
t38pt_udptl = yes

[<internal IP>]
host = <internal IP>
fromdomain = <internal IP>
type = friend
insecure = port,invite
context = from-internal
canreinvite = no
nat = yes
t38pt_udptl = yes
</pre>

Enswitch installation on AWS

2025-04-22T22:49:15Z

Vlasis:

How to set up Enswitch on a single machine cluster on AWS

This set up has been tested successfully on an Enswitch 4.0 single machine cluster with Kamailio 5.8.2 and Asterisk 13.38.3:

* Under the global configuration, create two machines, one for the internal IP address and FQDN and the other for the external IP and FQDN. Set only the internal address machine to accept calls as an Asterisk server.
* Under the global configuration, create domains for the internal IP address, the internal FQDN, the external IP and the external FQDN.
* Under the global configuration, set the "Message daemon IP address" to be the internal IP address.
* Edit /etc/kamailio/kamailio.cfg as below:
<pre>
listen = udp:<internal IP>:5060 advertise <external IP>:5060
listen = tcp:<internal IP>:5060 advertise <external IP>:5060

# AWS
#!define AWS_INTERNAL_IP <internal IP>
#!define AWS_EXTERNAL_IP "<external IP>"
</pre>

* Edit /opt/enswitch/current/etc/kamailio/kamailio_58.cfg as below:
<pre>
Index: etc/kamailio/kamailio_58.cfg
===================================================================
--- etc/kamailio/kamailio_58.cfg (revision 21219)
+++ etc/kamailio/kamailio_58.cfg (working copy)
@@ -334,6 +334,11 @@
}
}
if ( is_method( "INVITE" ) ) {
+ # AWS start
+ if ( src_ip == AWS_INTERNAL_IP ) {
+ fix_nated_sdp("3",AWS_EXTERNAL_IP);
+ }
+ # AWS end
$var(pai_count) = 0;
while( defined $(hdr(P-Asserted-Identity)[$var(pai_count)]) ) {
$var(pai_count) = $var(pai_count) + 1;
@@ -359,6 +364,12 @@
if ( is_method( "BYE" ) ) {
t_on_branch( "BRANCH" );
}
+
+ # AWS start
+ if ( is_method( "SUBSCRIBE" ) ) {
+ set_advertised_address( AWS_INTERNAL_IP );
+ }
+
if ( ! t_relay() ) {
sl_reply_error();
}
@@ -368,6 +379,11 @@
onreply_route[ REPLY ] {
if ( sdp_content() ) {
$avp(ENSWITCH-CIPHERS-SAFE) = $rb;
+ # AWS start
+ if ( src_ip == AWS_INTERNAL_IP ) {
+ fix_nated_sdp("3",AWS_EXTERNAL_IP);
+ }
+ # AWS end
}

force_rport();
@@ -494,6 +510,10 @@
# enforce routing to sipd
rewritehostporttrans("127.0.0.1:5080;transport=udp");
remove_hf( "Route" );
+ # AWS start
+ set_advertised_address( AWS_INTERNAL_IP );
+ # AWS end
+
route( FORWARD );
exit;
}
</pre>

* - In /etc/asterisk/sip.conf add a local-public, a local-private, a public IP and a private IP stanza, eg:
<pre>
[enswitch-local-public]
host = <external IP>
fromdomain = <external IP>
type = friend
insecure = port,invite
context = from-internal
canreinvite = no
nat = yes
t38pt_udptl = yes

[enswitch-local-private]
host = <internal IP>
fromdomain = <internal IP>
type = friend
insecure = port,invite
context = from-internal
canreinvite = no
nat = yes
t38pt_udptl = yes

[<external IP>]
host = <external IP>
fromdomain = <external IP>
type = friend
insecure = port,invite
context = from-internal
canreinvite = no
nat = yes
t38pt_udptl = yes

[<internal IP>]
host = <internal IP>
fromdomain = <internal IP>
type = friend
insecure = port,invite
context = from-internal
canreinvite = no
nat = yes
t38pt_udptl = yes
</pre>

Enswitch installation on AWS

2025-04-22T22:46:28Z

Vlasis:

How to set up Enswitch on a single machine cluster on AWS

This set up has been tested successfully on an Enswitch 4.0 single machine cluster with Kamailio 5.8.2 and Asterisk 13.38.3:

* Under the global configuration, create two machines, one for the internal IP address and FQDN and the other for the external IP and FQDN. Set only the internal address machine to accept calls as an Asterisk server.
* Under the global configuration, create domains for the internal IP address, the internal FQDN, the external IP and the external FQDN.
* Edit /etc/kamailio/kamailio.cfg as below:
<pre>
listen = udp:<internal IP>:5060 advertise <external IP>:5060
listen = tcp:<internal IP>:5060 advertise <external IP>:5060

# AWS
#!define AWS_INTERNAL_IP <internal IP>
#!define AWS_EXTERNAL_IP "<external IP>"
</pre>

* Edit /opt/enswitch/current/etc/kamailio/kamailio_58.cfg as below:
<pre>
Index: etc/kamailio/kamailio_58.cfg
===================================================================
--- etc/kamailio/kamailio_58.cfg (revision 21219)
+++ etc/kamailio/kamailio_58.cfg (working copy)
@@ -334,6 +334,11 @@
}
}
if ( is_method( "INVITE" ) ) {
+ # AWS start
+ if ( src_ip == AWS_INTERNAL_IP ) {
+ fix_nated_sdp("3",AWS_EXTERNAL_IP);
+ }
+ # AWS end
$var(pai_count) = 0;
while( defined $(hdr(P-Asserted-Identity)[$var(pai_count)]) ) {
$var(pai_count) = $var(pai_count) + 1;
@@ -359,6 +364,12 @@
if ( is_method( "BYE" ) ) {
t_on_branch( "BRANCH" );
}
+
+ # AWS start
+ if ( is_method( "SUBSCRIBE" ) ) {
+ set_advertised_address( AWS_INTERNAL_IP );
+ }
+
if ( ! t_relay() ) {
sl_reply_error();
}
@@ -368,6 +379,11 @@
onreply_route[ REPLY ] {
if ( sdp_content() ) {
$avp(ENSWITCH-CIPHERS-SAFE) = $rb;
+ # AWS start
+ if ( src_ip == AWS_INTERNAL_IP ) {
+ fix_nated_sdp("3",AWS_EXTERNAL_IP);
+ }
+ # AWS end
}

force_rport();
@@ -494,6 +510,10 @@
# enforce routing to sipd
rewritehostporttrans("127.0.0.1:5080;transport=udp");
remove_hf( "Route" );
+ # AWS start
+ set_advertised_address( AWS_INTERNAL_IP );
+ # AWS end
+
route( FORWARD );
exit;
}
</pre>

* - In /etc/asterisk/sip.conf add a local-public, a local-private, a public IP and a private IP stanza, eg:
<pre>
[enswitch-local-public]
host = <external IP>
fromdomain = <external IP>
type = friend
insecure = port,invite
context = from-internal
canreinvite = no
nat = yes
t38pt_udptl = yes

[enswitch-local-private]
host = <internal IP>
fromdomain = <internal IP>
type = friend
insecure = port,invite
context = from-internal
canreinvite = no
nat = yes
t38pt_udptl = yes

[<external IP>]
host = <external IP>
fromdomain = <external IP>
type = friend
insecure = port,invite
context = from-internal
canreinvite = no
nat = yes
t38pt_udptl = yes

[<internal IP>]
host = <internal IP>
fromdomain = <internal IP>
type = friend
insecure = port,invite
context = from-internal
canreinvite = no
nat = yes
t38pt_udptl = yes
</pre>

Enswitch installation on AWS

2025-04-22T18:20:53Z

Vlasis: Created page with "How to set up Enswitch on a single machine cluster on AWS This set up has been tested successfully on an Enswitch 4.0 single machine cluster with Kamailio 5.8.2 and Asterisk..."

How to set up Enswitch on a single machine cluster on AWS

This set up has been tested successfully on an Enswitch 4.0 single machine cluster with Kamailio 5.8.2 and Asterisk 13.38.3:

* Under the global configuration, create two machines, one for the internal IP address and FQDN and the other for the external IP and FQDN. Set only the internal address machine to accept calls as an Asterisk server.
* Under the global configuration, create domains for the internal IP address, the internal FQDN, the external IP and the external FQDN.
* Edit /etc/kamailio/kamailio.cfg as below:
<pre>
listen = udp:<internal IP>:5060 advertise <external IP>:5060
listen = tcp:<internal IP>:5060 advertise <external IP>:5060

# AWS
#!define AWS_INTERNAL_IP <internal IP>
#!define AWS_EXTERNAL_IP "<external IP>"
</pre>

* Edit /opt/enswitch/current/etc/kamailio/kamailio_58.cfg as below:
<pre>
Index: etc/kamailio/kamailio_58.cfg
===================================================================
--- etc/kamailio/kamailio_58.cfg (revision 21219)
+++ etc/kamailio/kamailio_58.cfg (working copy)
@@ -334,6 +334,11 @@
}
}
if ( is_method( "INVITE" ) ) {
+ # AWS start
+ if ( src_ip == AWS_INTERNAL_IP ) {
+ fix_nated_sdp("3",AWS_EXTERNAL_IP);
+ }
+ # AWS end
$var(pai_count) = 0;
while( defined $(hdr(P-Asserted-Identity)[$var(pai_count)]) ) {
$var(pai_count) = $var(pai_count) + 1;
@@ -359,6 +364,12 @@
if ( is_method( "BYE" ) ) {
t_on_branch( "BRANCH" );
}
+
+ # AWS start
+ if ( is_method( "SUBSCRIBE" ) ) {
+ set_advertised_address( "172.30.14.16" );
+ }
+
if ( ! t_relay() ) {
sl_reply_error();
}
@@ -368,6 +379,11 @@
onreply_route[ REPLY ] {
if ( sdp_content() ) {
$avp(ENSWITCH-CIPHERS-SAFE) = $rb;
+ # AWS start
+ if ( src_ip == AWS_INTERNAL_IP ) {
+ fix_nated_sdp("3",AWS_EXTERNAL_IP);
+ }
+ # AWS end
}

force_rport();
@@ -494,6 +510,10 @@
# enforce routing to sipd
rewritehostporttrans("127.0.0.1:5080;transport=udp");
remove_hf( "Route" );
+ # AWS start
+ set_advertised_address( "172.30.14.16" );
+ # AWS end
+
route( FORWARD );
exit;
}
</pre>

* - In /etc/asterisk/sip.conf add a local-public, a local-private, a public IP and a private IP stanza, eg:
<pre>
[enswitch-local-public]
host = <external IP>
fromdomain = <external IP>
type = friend
insecure = port,invite
context = from-internal
canreinvite = no
nat = yes
t38pt_udptl = yes

[enswitch-local-private]
host = <internal IP>
fromdomain = <internal IP>
type = friend
insecure = port,invite
context = from-internal
canreinvite = no
nat = yes
t38pt_udptl = yes

[<external IP>]
host = <external IP>
fromdomain = <external IP>
type = friend
insecure = port,invite
context = from-internal
canreinvite = no
nat = yes
t38pt_udptl = yes

[<internal IP>]
host = <internal IP>
fromdomain = <internal IP>
type = friend
insecure = port,invite
context = from-internal
canreinvite = no
nat = yes
t38pt_udptl = yes
</pre>

Compatibility between Enswitch components and Linux distributions

2025-03-31T15:26:33Z

Vlasis: /* Enswitch 4.2 */

The contents on this page have an informative purpose and are not exhaustive. Updates may be applied as more observations are gathered about compatible and incompatible combinations of Enswitch versions, their components and operating systems.

== Enswitch 4.2 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.2 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 24.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.8.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes, but the HTMLDOC version it uses does not compile. As an alternative, an older HTMLDOC version may be installed.
|
• Version 13.x: Yes
• Version 16.x: No (it requires ''libjansson'' >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the ''--with-jansson-bundled'' flag to the ''./configure'' command inside the Enswitch installer, which will need to be changed)
• Version 18.x: No (it requires ''libjansson'' >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the ''--with-jansson-bundled'' flag to the ''./configure'' command inside the Enswitch installer, which will need to be changed)
| Version 5.4.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Maybe. Debian 7 comes with MySQL 5.5, but Enswitch 4.0 and newer require MySQL version >= 5.7 or MariaDB >= 10.2. There are errors when trying to use MySQL 5.5.x, at least in the configuration files.
|
• Version 13.x: Yes
• Version 16.x: No (astdb requires SQLite library version >= 3.7.15, but Debian 7 comes with 3.7.13. Also, it requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
• Version 18.x: No (it does not exhibit the SQLite error observed with Asterisk 16.x, however it still requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.4.x: Yes
| MySQL 5.5.x: No (documented configuration file gives syntax errors and it is unknown if they may be fixed and if Enswitch would work fine after that). Updating MySQL to version >= 5.7 or MariaDB to version >= 10.2 may be an option.
|}

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.2 sub-systems
|-
! scope="col"| Distribution
! scope="col"| RTPEngine (for WebRTC and/or TLS server)
|-
! scope="row"| Ubuntu 24.04
| Version mr11.5.x: Yes
|-
! scope="row"| Ubuntu 22.04
| Version mr5.x or mr9.x: Yes
|}

== Enswitch 4.1 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.1 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: No (it requires ''libjansson'' >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the ''--with-jansson-bundled'' flag to the ''./configure'' command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Maybe. Debian 7 comes with MySQL 5.5, but Enswitch 4.0 and newer require MySQL version >= 5.7 or MariaDB >= 10.2.
|
• Version 13.x: Yes
• Version 16.x: No (astdb requires SQLite library version >= 3.7.15, but Debian 7 comes with 3.7.13. Also, it requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.5.x: does not fit Enswitch requirements. Updating MySQL to version >= 5.7 or MariaDB to version >= 10.2 may be an option.
|}

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.1 sub-systems
|-
! scope="col"| Distribution
! scope="col"| RTPEngine (for WebRTC and/or TLS server)
|-
! scope="row"| Ubuntu 20.04
| Version mr5.x or mr6.x, up to version mr6.5.12.2: Yes
|-
! scope="row"| Ubuntu 18.04
| Version mr5.x or mr6.x, up to version mr6.5.12.2: Yes
|-
! scope="row"| Ubuntu 16.04
| No (missing required packages ''libip6tc-dev'' and ''libxtables-dev'')
|}

== Enswitch 4.0 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.0 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 22.04)
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 20.04)
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 11.x: Yes
• Version 13.x: Yes
• Version 16.x: No (it requires libjansson >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| CentOS 7
| Yes
|
• Version 11.x: ??
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Debian 7
| Maybe. Debian 7 comes with MySQL 5.5, but Enswitch 4.0 and newer require MySQL version >= 5.7 or MariaDB >= 10.2.
|
• Version 11.x: Yes
• Version 13.x: Yes
• Version 16.x: No (astdb requires SQLite library version >= 3.7.15, but Debian 7 comes with 3.7.13. Also, it requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.5.x: does not fit Enswitch requirements. Updating MySQL to version >= 5.7 or MariaDB to version >= 10.2 may be an option.
|}

== Enswitch 3.15 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 3.15 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 22.04)
• Version 13.x: Yes
| Version 5.0.x: No (it does not build correctly with GCC version 11 that comes with Ubuntu 22.04, as similarly reported in [https://github.com/kamailio/kamailio/issues/2293 an issue for Kamailio]. Alternatively, it may build by passing the ''-fcommon'' flag to the ''make'' command for ''Kamailio'' (e.g with ''CC_OPT="-O2 -fcommon"'') inside the Enswitch installer, which will need to be changed)
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 20.04)
• Version 13.x: Yes
| Version 5.0.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 13.x: Yes
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 11.x: Yes
• Version 13.x: Yes
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Yes
|
• Version 11.x: Yes
• Version 13.x: Yes
| Version 5.0.x: Yes
| MySQL 5.5.x: Yes
|}

== Enswitch 3.14 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 3.14 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 20.04
| Maybe, but there are syntax errors when trying to use MySQL 8.0.x.
| Not tried
| Not tried
| MySQL 8.0.x: No (documented configuration file gives syntax errors, Enswitch source code gives syntax errors (e.g with keyword ''rank'', with keywords ''identified by'' to create the ''enswitch'' database user))
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 1.8.x: No (it does not build correctly with GCC version 7 that comes with Ubuntu 18.04, as similarly reported in [https://community.asterisk.org/t/asterisk-1-8-compiling-on-deb-8-11-but-not-9-8/79393/2 an issue for Asterisk]. Alternatively, as mentioned in [https://github.com/gccxml/gccxml/issues/11] and [https://bugzilla.redhat.com/show_bug.cgi?id=476370] it may build by passing the ''-fgnu89-inline'' flag to the ''configure'' command for ''Asterisk'' (e.g with ''CFLAGS=-fgnu89-inline LDFLAGS=-fgnu89-inline'') inside the Enswitch installer, which will need to be changed, but that will not be enough because Asterisk 1.8.x requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 13.x: Yes (experimental in Enswitch 3.14. The recommendation is to use it with Enswitch 3.15 or newer)
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 1.8.x: No (it does not build correctly with GCC version 5 that comes with Ubuntu 16.04, as similarly reported in [https://asterisk-users.digium.narkive.com/wu0IWbYi/can-t-compile-asterisk-certified-11-6-cert16-on-ubuntu-16 an issue for Asterisk]. Alternatively, as mentioned in [https://github.com/gccxml/gccxml/issues/11] and [https://bugzilla.redhat.com/show_bug.cgi?id=476370] it may build by passing the ''-fgnu89-inline'' flag to the ''configure'' command for ''Asterisk'' (e.g with ''CFLAGS=-fgnu89-inline LDFLAGS=-fgnu89-inline'') inside the Enswitch installer, which will need to be changed)
• Version 11.x: Yes
• Version 13.x: Yes (experimental in Enswitch 3.14. The recommendation is to use it with Enswitch 3.15 or newer)
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Yes
| Version 11.x: Yes
| Version 5.0.x: Yes
| MySQL 5.5.x: Yes
|}

== Enswitch 3.13 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 3.13 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Debian 7
| Yes
| Version 11.x: Yes
| Version 4.2.x: Yes
| MySQL 5.5.x: Yes
|}

== Asterisk 18 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Asterisk 18 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| Yes
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Asterisk 16 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Asterisk 16 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| Yes
|-
| 4.1
| Yes
|-
| 4.0
| Yes
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Asterisk 13 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Asterisk 13 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| Yes
|-
| 4.1
| Yes
|-
| 4.0
| Yes
|-
| 3.15
| Yes
|-
| 3.14
| Yes, but it is experimental. The recommendation is to use it with Enswitch 3.15 or newer
|}

== Kamailio 5.6 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.6 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| No
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Kamailio 5.4 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.4 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| No
|-
| 4.2
| Yes
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Kamailio 5.2 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.2 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| No
|-
| 4.2
| No
|-
| 4.1
| Yes
|-
| 4.0
| Yes
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Kamailio 5.0 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.0 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| No
|-
| 4.2
| No
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| Yes
|-
| 3.14
| Yes
|}

Compatibility between Enswitch components and Linux distributions

2025-03-31T15:24:48Z

Vlasis:

The contents on this page have an informative purpose and are not exhaustive. Updates may be applied as more observations are gathered about compatible and incompatible combinations of Enswitch versions, their components and operating systems.

== Enswitch 4.2 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.2 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 24.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.8.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes, but the HTMLDOC version it uses does not compile. As an alternative, an older HTMLDOC version may be installed.
|
• Version 13.x: Yes
• Version 16.x: No (it requires ''libjansson'' >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the ''--with-jansson-bundled'' flag to the ''./configure'' command inside the Enswitch installer, which will need to be changed)
• Version 18.x: No (it requires ''libjansson'' >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the ''--with-jansson-bundled'' flag to the ''./configure'' command inside the Enswitch installer, which will need to be changed)
| Version 5.4.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Maybe. Debian 7 comes with MySQL 5.5, but Enswitch 4.0 and newer require MySQL version >= 5.7 or MariaDB >= 10.2. There are errors when trying to use MySQL 5.5.x, at least in the configuration files.
|
• Version 13.x: Yes
• Version 16.x: No (astdb requires SQLite library version >= 3.7.15, but Debian 7 comes with 3.7.13. Also, it requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
• Version 18.x: No (it does not exhibit the SQLite error observed with Asterisk 16.x, however it still requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.4.x: Yes
| MySQL 5.5.x: No (documented configuration file gives syntax errors and it is unknown if they may be fixed and if Enswitch would work fine after that). Updating MySQL to version >= 5.7 or MariaDB to version >= 10.2 may be an option.
|}

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.2 sub-systems
|-
! scope="col"| Distribution
! scope="col"| RTPEngine (for WebRTC and/or TLS server)
|-
! scope="row"| Ubuntu 22.04
| Version mr5.x or mr9.x: Yes
|}

== Enswitch 4.1 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.1 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: No (it requires ''libjansson'' >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the ''--with-jansson-bundled'' flag to the ''./configure'' command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Maybe. Debian 7 comes with MySQL 5.5, but Enswitch 4.0 and newer require MySQL version >= 5.7 or MariaDB >= 10.2.
|
• Version 13.x: Yes
• Version 16.x: No (astdb requires SQLite library version >= 3.7.15, but Debian 7 comes with 3.7.13. Also, it requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.5.x: does not fit Enswitch requirements. Updating MySQL to version >= 5.7 or MariaDB to version >= 10.2 may be an option.
|}

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.1 sub-systems
|-
! scope="col"| Distribution
! scope="col"| RTPEngine (for WebRTC and/or TLS server)
|-
! scope="row"| Ubuntu 20.04
| Version mr5.x or mr6.x, up to version mr6.5.12.2: Yes
|-
! scope="row"| Ubuntu 18.04
| Version mr5.x or mr6.x, up to version mr6.5.12.2: Yes
|-
! scope="row"| Ubuntu 16.04
| No (missing required packages ''libip6tc-dev'' and ''libxtables-dev'')
|}

== Enswitch 4.0 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.0 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 22.04)
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 20.04)
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 11.x: Yes
• Version 13.x: Yes
• Version 16.x: No (it requires libjansson >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| CentOS 7
| Yes
|
• Version 11.x: ??
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Debian 7
| Maybe. Debian 7 comes with MySQL 5.5, but Enswitch 4.0 and newer require MySQL version >= 5.7 or MariaDB >= 10.2.
|
• Version 11.x: Yes
• Version 13.x: Yes
• Version 16.x: No (astdb requires SQLite library version >= 3.7.15, but Debian 7 comes with 3.7.13. Also, it requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.5.x: does not fit Enswitch requirements. Updating MySQL to version >= 5.7 or MariaDB to version >= 10.2 may be an option.
|}

== Enswitch 3.15 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 3.15 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 22.04)
• Version 13.x: Yes
| Version 5.0.x: No (it does not build correctly with GCC version 11 that comes with Ubuntu 22.04, as similarly reported in [https://github.com/kamailio/kamailio/issues/2293 an issue for Kamailio]. Alternatively, it may build by passing the ''-fcommon'' flag to the ''make'' command for ''Kamailio'' (e.g with ''CC_OPT="-O2 -fcommon"'') inside the Enswitch installer, which will need to be changed)
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 20.04)
• Version 13.x: Yes
| Version 5.0.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 13.x: Yes
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 11.x: Yes
• Version 13.x: Yes
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Yes
|
• Version 11.x: Yes
• Version 13.x: Yes
| Version 5.0.x: Yes
| MySQL 5.5.x: Yes
|}

== Enswitch 3.14 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 3.14 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 20.04
| Maybe, but there are syntax errors when trying to use MySQL 8.0.x.
| Not tried
| Not tried
| MySQL 8.0.x: No (documented configuration file gives syntax errors, Enswitch source code gives syntax errors (e.g with keyword ''rank'', with keywords ''identified by'' to create the ''enswitch'' database user))
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 1.8.x: No (it does not build correctly with GCC version 7 that comes with Ubuntu 18.04, as similarly reported in [https://community.asterisk.org/t/asterisk-1-8-compiling-on-deb-8-11-but-not-9-8/79393/2 an issue for Asterisk]. Alternatively, as mentioned in [https://github.com/gccxml/gccxml/issues/11] and [https://bugzilla.redhat.com/show_bug.cgi?id=476370] it may build by passing the ''-fgnu89-inline'' flag to the ''configure'' command for ''Asterisk'' (e.g with ''CFLAGS=-fgnu89-inline LDFLAGS=-fgnu89-inline'') inside the Enswitch installer, which will need to be changed, but that will not be enough because Asterisk 1.8.x requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 13.x: Yes (experimental in Enswitch 3.14. The recommendation is to use it with Enswitch 3.15 or newer)
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 1.8.x: No (it does not build correctly with GCC version 5 that comes with Ubuntu 16.04, as similarly reported in [https://asterisk-users.digium.narkive.com/wu0IWbYi/can-t-compile-asterisk-certified-11-6-cert16-on-ubuntu-16 an issue for Asterisk]. Alternatively, as mentioned in [https://github.com/gccxml/gccxml/issues/11] and [https://bugzilla.redhat.com/show_bug.cgi?id=476370] it may build by passing the ''-fgnu89-inline'' flag to the ''configure'' command for ''Asterisk'' (e.g with ''CFLAGS=-fgnu89-inline LDFLAGS=-fgnu89-inline'') inside the Enswitch installer, which will need to be changed)
• Version 11.x: Yes
• Version 13.x: Yes (experimental in Enswitch 3.14. The recommendation is to use it with Enswitch 3.15 or newer)
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Yes
| Version 11.x: Yes
| Version 5.0.x: Yes
| MySQL 5.5.x: Yes
|}

== Enswitch 3.13 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 3.13 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Debian 7
| Yes
| Version 11.x: Yes
| Version 4.2.x: Yes
| MySQL 5.5.x: Yes
|}

== Asterisk 18 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Asterisk 18 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| Yes
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Asterisk 16 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Asterisk 16 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| Yes
|-
| 4.1
| Yes
|-
| 4.0
| Yes
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Asterisk 13 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Asterisk 13 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| Yes
|-
| 4.1
| Yes
|-
| 4.0
| Yes
|-
| 3.15
| Yes
|-
| 3.14
| Yes, but it is experimental. The recommendation is to use it with Enswitch 3.15 or newer
|}

== Kamailio 5.6 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.6 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| No
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Kamailio 5.4 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.4 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| No
|-
| 4.2
| Yes
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Kamailio 5.2 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.2 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| No
|-
| 4.2
| No
|-
| 4.1
| Yes
|-
| 4.0
| Yes
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Kamailio 5.0 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.0 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| No
|-
| 4.2
| No
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| Yes
|-
| 3.14
| Yes
|}

Compatibility between Enswitch components and Linux distributions

2025-03-31T14:57:25Z

Vlasis:

The contents on this page have an informative purpose and are not exhaustive. Updates may be applied as more observations are gathered about compatible and incompatible combinations of Enswitch versions, their components and operating systems.

== Enswitch 4.2 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.2 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 24.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.8.x: TBD (to be determined)
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes, but the HTMLDOC version it uses does not compile. As an alternative, an older HTMLDOC version may be installed.
|
• Version 13.x: Yes
• Version 16.x: No (it requires ''libjansson'' >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the ''--with-jansson-bundled'' flag to the ''./configure'' command inside the Enswitch installer, which will need to be changed)
• Version 18.x: No (it requires ''libjansson'' >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the ''--with-jansson-bundled'' flag to the ''./configure'' command inside the Enswitch installer, which will need to be changed)
| Version 5.4.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Maybe. Debian 7 comes with MySQL 5.5, but Enswitch 4.0 and newer require MySQL version >= 5.7 or MariaDB >= 10.2. There are errors when trying to use MySQL 5.5.x, at least in the configuration files.
|
• Version 13.x: Yes
• Version 16.x: No (astdb requires SQLite library version >= 3.7.15, but Debian 7 comes with 3.7.13. Also, it requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
• Version 18.x: No (it does not exhibit the SQLite error observed with Asterisk 16.x, however it still requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.4.x: Yes
| MySQL 5.5.x: No (documented configuration file gives syntax errors and it is unknown if they may be fixed and if Enswitch would work fine after that). Updating MySQL to version >= 5.7 or MariaDB to version >= 10.2 may be an option.
|}

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.2 sub-systems
|-
! scope="col"| Distribution
! scope="col"| RTPEngine (for WebRTC and/or TLS server)
|-
! scope="row"| Ubuntu 22.04
| Version mr5.x or mr9.x: Yes
|}

== Enswitch 4.1 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.1 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: No (it requires ''libjansson'' >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the ''--with-jansson-bundled'' flag to the ''./configure'' command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Maybe. Debian 7 comes with MySQL 5.5, but Enswitch 4.0 and newer require MySQL version >= 5.7 or MariaDB >= 10.2.
|
• Version 13.x: Yes
• Version 16.x: No (astdb requires SQLite library version >= 3.7.15, but Debian 7 comes with 3.7.13. Also, it requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.5.x: does not fit Enswitch requirements. Updating MySQL to version >= 5.7 or MariaDB to version >= 10.2 may be an option.
|}

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.1 sub-systems
|-
! scope="col"| Distribution
! scope="col"| RTPEngine (for WebRTC and/or TLS server)
|-
! scope="row"| Ubuntu 20.04
| Version mr5.x or mr6.x, up to version mr6.5.12.2: Yes
|-
! scope="row"| Ubuntu 18.04
| Version mr5.x or mr6.x, up to version mr6.5.12.2: Yes
|-
! scope="row"| Ubuntu 16.04
| No (missing required packages ''libip6tc-dev'' and ''libxtables-dev'')
|}

== Enswitch 4.0 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.0 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 22.04)
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 20.04)
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 11.x: Yes
• Version 13.x: Yes
• Version 16.x: No (it requires libjansson >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| CentOS 7
| Yes
|
• Version 11.x: ??
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Debian 7
| Maybe. Debian 7 comes with MySQL 5.5, but Enswitch 4.0 and newer require MySQL version >= 5.7 or MariaDB >= 10.2.
|
• Version 11.x: Yes
• Version 13.x: Yes
• Version 16.x: No (astdb requires SQLite library version >= 3.7.15, but Debian 7 comes with 3.7.13. Also, it requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.5.x: does not fit Enswitch requirements. Updating MySQL to version >= 5.7 or MariaDB to version >= 10.2 may be an option.
|}

== Enswitch 3.15 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 3.15 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 22.04)
• Version 13.x: Yes
| Version 5.0.x: No (it does not build correctly with GCC version 11 that comes with Ubuntu 22.04, as similarly reported in [https://github.com/kamailio/kamailio/issues/2293 an issue for Kamailio]. Alternatively, it may build by passing the ''-fcommon'' flag to the ''make'' command for ''Kamailio'' (e.g with ''CC_OPT="-O2 -fcommon"'') inside the Enswitch installer, which will need to be changed)
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 20.04)
• Version 13.x: Yes
| Version 5.0.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 13.x: Yes
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 11.x: Yes
• Version 13.x: Yes
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Yes
|
• Version 11.x: Yes
• Version 13.x: Yes
| Version 5.0.x: Yes
| MySQL 5.5.x: Yes
|}

== Enswitch 3.14 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 3.14 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 20.04
| Maybe, but there are syntax errors when trying to use MySQL 8.0.x.
| Not tried
| Not tried
| MySQL 8.0.x: No (documented configuration file gives syntax errors, Enswitch source code gives syntax errors (e.g with keyword ''rank'', with keywords ''identified by'' to create the ''enswitch'' database user))
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 1.8.x: No (it does not build correctly with GCC version 7 that comes with Ubuntu 18.04, as similarly reported in [https://community.asterisk.org/t/asterisk-1-8-compiling-on-deb-8-11-but-not-9-8/79393/2 an issue for Asterisk]. Alternatively, as mentioned in [https://github.com/gccxml/gccxml/issues/11] and [https://bugzilla.redhat.com/show_bug.cgi?id=476370] it may build by passing the ''-fgnu89-inline'' flag to the ''configure'' command for ''Asterisk'' (e.g with ''CFLAGS=-fgnu89-inline LDFLAGS=-fgnu89-inline'') inside the Enswitch installer, which will need to be changed, but that will not be enough because Asterisk 1.8.x requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 13.x: Yes (experimental in Enswitch 3.14. The recommendation is to use it with Enswitch 3.15 or newer)
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 1.8.x: No (it does not build correctly with GCC version 5 that comes with Ubuntu 16.04, as similarly reported in [https://asterisk-users.digium.narkive.com/wu0IWbYi/can-t-compile-asterisk-certified-11-6-cert16-on-ubuntu-16 an issue for Asterisk]. Alternatively, as mentioned in [https://github.com/gccxml/gccxml/issues/11] and [https://bugzilla.redhat.com/show_bug.cgi?id=476370] it may build by passing the ''-fgnu89-inline'' flag to the ''configure'' command for ''Asterisk'' (e.g with ''CFLAGS=-fgnu89-inline LDFLAGS=-fgnu89-inline'') inside the Enswitch installer, which will need to be changed)
• Version 11.x: Yes
• Version 13.x: Yes (experimental in Enswitch 3.14. The recommendation is to use it with Enswitch 3.15 or newer)
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Yes
| Version 11.x: Yes
| Version 5.0.x: Yes
| MySQL 5.5.x: Yes
|}

== Enswitch 3.13 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 3.13 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Debian 7
| Yes
| Version 11.x: Yes
| Version 4.2.x: Yes
| MySQL 5.5.x: Yes
|}

== Asterisk 18 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Asterisk 18 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| Yes
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Asterisk 16 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Asterisk 16 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| Yes
|-
| 4.1
| Yes
|-
| 4.0
| Yes
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Asterisk 13 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Asterisk 13 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| Yes
|-
| 4.1
| Yes
|-
| 4.0
| Yes
|-
| 3.15
| Yes
|-
| 3.14
| Yes, but it is experimental. The recommendation is to use it with Enswitch 3.15 or newer
|}

== Kamailio 5.6 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.6 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| No
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Kamailio 5.4 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.4 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| No
|-
| 4.2
| Yes
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Kamailio 5.2 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.2 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| No
|-
| 4.2
| No
|-
| 4.1
| Yes
|-
| 4.0
| Yes
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Kamailio 5.0 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.0 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| No
|-
| 4.2
| No
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| Yes
|-
| 3.14
| Yes
|}

Compatibility between Enswitch components and Linux distributions

2025-03-31T14:32:01Z

Vlasis:

The contents on this page have an informative purpose and are not exhaustive. Updates may be applied as more observations are gathered about compatible and incompatible combinations of Enswitch versions, their components and operating systems.

== Enswitch 4.2 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.2 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 24.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: TBD (to be determined)
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes, but the HTMLDOC version it uses does not compile. As an alternative, an older HTMLDOC version may be installed.
|
• Version 13.x: Yes
• Version 16.x: No (it requires ''libjansson'' >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the ''--with-jansson-bundled'' flag to the ''./configure'' command inside the Enswitch installer, which will need to be changed)
• Version 18.x: No (it requires ''libjansson'' >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the ''--with-jansson-bundled'' flag to the ''./configure'' command inside the Enswitch installer, which will need to be changed)
| Version 5.4.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Maybe. Debian 7 comes with MySQL 5.5, but Enswitch 4.0 and newer require MySQL version >= 5.7 or MariaDB >= 10.2. There are errors when trying to use MySQL 5.5.x, at least in the configuration files.
|
• Version 13.x: Yes
• Version 16.x: No (astdb requires SQLite library version >= 3.7.15, but Debian 7 comes with 3.7.13. Also, it requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
• Version 18.x: No (it does not exhibit the SQLite error observed with Asterisk 16.x, however it still requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.4.x: Yes
| MySQL 5.5.x: No (documented configuration file gives syntax errors and it is unknown if they may be fixed and if Enswitch would work fine after that). Updating MySQL to version >= 5.7 or MariaDB to version >= 10.2 may be an option.
|}

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.2 sub-systems
|-
! scope="col"| Distribution
! scope="col"| RTPEngine (for WebRTC and/or TLS server)
|-
! scope="row"| Ubuntu 22.04
| Version mr5.x or mr9.x: Yes
|}

== Enswitch 4.1 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.1 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: No (it requires ''libjansson'' >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the ''--with-jansson-bundled'' flag to the ''./configure'' command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Maybe. Debian 7 comes with MySQL 5.5, but Enswitch 4.0 and newer require MySQL version >= 5.7 or MariaDB >= 10.2.
|
• Version 13.x: Yes
• Version 16.x: No (astdb requires SQLite library version >= 3.7.15, but Debian 7 comes with 3.7.13. Also, it requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.5.x: does not fit Enswitch requirements. Updating MySQL to version >= 5.7 or MariaDB to version >= 10.2 may be an option.
|}

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.1 sub-systems
|-
! scope="col"| Distribution
! scope="col"| RTPEngine (for WebRTC and/or TLS server)
|-
! scope="row"| Ubuntu 20.04
| Version mr5.x or mr6.x, up to version mr6.5.12.2: Yes
|-
! scope="row"| Ubuntu 18.04
| Version mr5.x or mr6.x, up to version mr6.5.12.2: Yes
|-
! scope="row"| Ubuntu 16.04
| No (missing required packages ''libip6tc-dev'' and ''libxtables-dev'')
|}

== Enswitch 4.0 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.0 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 22.04)
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 20.04)
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 11.x: Yes
• Version 13.x: Yes
• Version 16.x: No (it requires libjansson >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| CentOS 7
| Yes
|
• Version 11.x: ??
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Debian 7
| Maybe. Debian 7 comes with MySQL 5.5, but Enswitch 4.0 and newer require MySQL version >= 5.7 or MariaDB >= 10.2.
|
• Version 11.x: Yes
• Version 13.x: Yes
• Version 16.x: No (astdb requires SQLite library version >= 3.7.15, but Debian 7 comes with 3.7.13. Also, it requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.5.x: does not fit Enswitch requirements. Updating MySQL to version >= 5.7 or MariaDB to version >= 10.2 may be an option.
|}

== Enswitch 3.15 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 3.15 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 22.04)
• Version 13.x: Yes
| Version 5.0.x: No (it does not build correctly with GCC version 11 that comes with Ubuntu 22.04, as similarly reported in [https://github.com/kamailio/kamailio/issues/2293 an issue for Kamailio]. Alternatively, it may build by passing the ''-fcommon'' flag to the ''make'' command for ''Kamailio'' (e.g with ''CC_OPT="-O2 -fcommon"'') inside the Enswitch installer, which will need to be changed)
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 20.04)
• Version 13.x: Yes
| Version 5.0.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 13.x: Yes
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 11.x: Yes
• Version 13.x: Yes
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Yes
|
• Version 11.x: Yes
• Version 13.x: Yes
| Version 5.0.x: Yes
| MySQL 5.5.x: Yes
|}

== Enswitch 3.14 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 3.14 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 20.04
| Maybe, but there are syntax errors when trying to use MySQL 8.0.x.
| Not tried
| Not tried
| MySQL 8.0.x: No (documented configuration file gives syntax errors, Enswitch source code gives syntax errors (e.g with keyword ''rank'', with keywords ''identified by'' to create the ''enswitch'' database user))
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 1.8.x: No (it does not build correctly with GCC version 7 that comes with Ubuntu 18.04, as similarly reported in [https://community.asterisk.org/t/asterisk-1-8-compiling-on-deb-8-11-but-not-9-8/79393/2 an issue for Asterisk]. Alternatively, as mentioned in [https://github.com/gccxml/gccxml/issues/11] and [https://bugzilla.redhat.com/show_bug.cgi?id=476370] it may build by passing the ''-fgnu89-inline'' flag to the ''configure'' command for ''Asterisk'' (e.g with ''CFLAGS=-fgnu89-inline LDFLAGS=-fgnu89-inline'') inside the Enswitch installer, which will need to be changed, but that will not be enough because Asterisk 1.8.x requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 13.x: Yes (experimental in Enswitch 3.14. The recommendation is to use it with Enswitch 3.15 or newer)
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 1.8.x: No (it does not build correctly with GCC version 5 that comes with Ubuntu 16.04, as similarly reported in [https://asterisk-users.digium.narkive.com/wu0IWbYi/can-t-compile-asterisk-certified-11-6-cert16-on-ubuntu-16 an issue for Asterisk]. Alternatively, as mentioned in [https://github.com/gccxml/gccxml/issues/11] and [https://bugzilla.redhat.com/show_bug.cgi?id=476370] it may build by passing the ''-fgnu89-inline'' flag to the ''configure'' command for ''Asterisk'' (e.g with ''CFLAGS=-fgnu89-inline LDFLAGS=-fgnu89-inline'') inside the Enswitch installer, which will need to be changed)
• Version 11.x: Yes
• Version 13.x: Yes (experimental in Enswitch 3.14. The recommendation is to use it with Enswitch 3.15 or newer)
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Yes
| Version 11.x: Yes
| Version 5.0.x: Yes
| MySQL 5.5.x: Yes
|}

== Enswitch 3.13 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 3.13 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Debian 7
| Yes
| Version 11.x: Yes
| Version 4.2.x: Yes
| MySQL 5.5.x: Yes
|}

== Asterisk 18 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Asterisk 18 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| Yes
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Asterisk 16 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Asterisk 16 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| Yes
|-
| 4.1
| Yes
|-
| 4.0
| Yes
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Asterisk 13 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Asterisk 13 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| Yes
|-
| 4.1
| Yes
|-
| 4.0
| Yes
|-
| 3.15
| Yes
|-
| 3.14
| Yes, but it is experimental. The recommendation is to use it with Enswitch 3.15 or newer
|}

== Kamailio 5.6 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.6 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| No
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Kamailio 5.4 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.4 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| No
|-
| 4.2
| Yes
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Kamailio 5.2 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.2 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| No
|-
| 4.2
| No
|-
| 4.1
| Yes
|-
| 4.0
| Yes
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Kamailio 5.0 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.0 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| No
|-
| 4.2
| No
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| Yes
|-
| 3.14
| Yes
|}

Compatibility between Enswitch components and Linux distributions

2025-03-31T14:07:18Z

Vlasis:

The contents on this page have an informative purpose and are not exhaustive. Updates may be applied as more observations are gathered about compatible and incompatible combinations of Enswitch versions, their components and operating systems.

== Enswitch 4.2 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.2 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 24.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: TBD (to be determined)
| Version 5.4.x: TBD
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes, but the HTMLDOC version it uses does not compile. As an alternative, an older HTMLDOC version may be installed.
|
• Version 13.x: Yes
• Version 16.x: No (it requires ''libjansson'' >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the ''--with-jansson-bundled'' flag to the ''./configure'' command inside the Enswitch installer, which will need to be changed)
• Version 18.x: No (it requires ''libjansson'' >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the ''--with-jansson-bundled'' flag to the ''./configure'' command inside the Enswitch installer, which will need to be changed)
| Version 5.4.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Maybe. Debian 7 comes with MySQL 5.5, but Enswitch 4.0 and newer require MySQL version >= 5.7 or MariaDB >= 10.2. There are errors when trying to use MySQL 5.5.x, at least in the configuration files.
|
• Version 13.x: Yes
• Version 16.x: No (astdb requires SQLite library version >= 3.7.15, but Debian 7 comes with 3.7.13. Also, it requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
• Version 18.x: No (it does not exhibit the SQLite error observed with Asterisk 16.x, however it still requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.4.x: Yes
| MySQL 5.5.x: No (documented configuration file gives syntax errors and it is unknown if they may be fixed and if Enswitch would work fine after that). Updating MySQL to version >= 5.7 or MariaDB to version >= 10.2 may be an option.
|}

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.2 sub-systems
|-
! scope="col"| Distribution
! scope="col"| RTPEngine (for WebRTC and/or TLS server)
|-
! scope="row"| Ubuntu 22.04
| Version mr5.x or mr9.x: Yes
|}

== Enswitch 4.1 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.1 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: No (it requires ''libjansson'' >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the ''--with-jansson-bundled'' flag to the ''./configure'' command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Maybe. Debian 7 comes with MySQL 5.5, but Enswitch 4.0 and newer require MySQL version >= 5.7 or MariaDB >= 10.2.
|
• Version 13.x: Yes
• Version 16.x: No (astdb requires SQLite library version >= 3.7.15, but Debian 7 comes with 3.7.13. Also, it requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.5.x: does not fit Enswitch requirements. Updating MySQL to version >= 5.7 or MariaDB to version >= 10.2 may be an option.
|}

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.1 sub-systems
|-
! scope="col"| Distribution
! scope="col"| RTPEngine (for WebRTC and/or TLS server)
|-
! scope="row"| Ubuntu 20.04
| Version mr5.x or mr6.x, up to version mr6.5.12.2: Yes
|-
! scope="row"| Ubuntu 18.04
| Version mr5.x or mr6.x, up to version mr6.5.12.2: Yes
|-
! scope="row"| Ubuntu 16.04
| No (missing required packages ''libip6tc-dev'' and ''libxtables-dev'')
|}

== Enswitch 4.0 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.0 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 22.04)
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 20.04)
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 11.x: Yes
• Version 13.x: Yes
• Version 16.x: No (it requires libjansson >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| CentOS 7
| Yes
|
• Version 11.x: ??
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Debian 7
| Maybe. Debian 7 comes with MySQL 5.5, but Enswitch 4.0 and newer require MySQL version >= 5.7 or MariaDB >= 10.2.
|
• Version 11.x: Yes
• Version 13.x: Yes
• Version 16.x: No (astdb requires SQLite library version >= 3.7.15, but Debian 7 comes with 3.7.13. Also, it requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.5.x: does not fit Enswitch requirements. Updating MySQL to version >= 5.7 or MariaDB to version >= 10.2 may be an option.
|}

== Enswitch 3.15 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 3.15 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 22.04)
• Version 13.x: Yes
| Version 5.0.x: No (it does not build correctly with GCC version 11 that comes with Ubuntu 22.04, as similarly reported in [https://github.com/kamailio/kamailio/issues/2293 an issue for Kamailio]. Alternatively, it may build by passing the ''-fcommon'' flag to the ''make'' command for ''Kamailio'' (e.g with ''CC_OPT="-O2 -fcommon"'') inside the Enswitch installer, which will need to be changed)
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 20.04)
• Version 13.x: Yes
| Version 5.0.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 13.x: Yes
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 11.x: Yes
• Version 13.x: Yes
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Yes
|
• Version 11.x: Yes
• Version 13.x: Yes
| Version 5.0.x: Yes
| MySQL 5.5.x: Yes
|}

== Enswitch 3.14 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 3.14 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 20.04
| Maybe, but there are syntax errors when trying to use MySQL 8.0.x.
| Not tried
| Not tried
| MySQL 8.0.x: No (documented configuration file gives syntax errors, Enswitch source code gives syntax errors (e.g with keyword ''rank'', with keywords ''identified by'' to create the ''enswitch'' database user))
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 1.8.x: No (it does not build correctly with GCC version 7 that comes with Ubuntu 18.04, as similarly reported in [https://community.asterisk.org/t/asterisk-1-8-compiling-on-deb-8-11-but-not-9-8/79393/2 an issue for Asterisk]. Alternatively, as mentioned in [https://github.com/gccxml/gccxml/issues/11] and [https://bugzilla.redhat.com/show_bug.cgi?id=476370] it may build by passing the ''-fgnu89-inline'' flag to the ''configure'' command for ''Asterisk'' (e.g with ''CFLAGS=-fgnu89-inline LDFLAGS=-fgnu89-inline'') inside the Enswitch installer, which will need to be changed, but that will not be enough because Asterisk 1.8.x requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 13.x: Yes (experimental in Enswitch 3.14. The recommendation is to use it with Enswitch 3.15 or newer)
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 1.8.x: No (it does not build correctly with GCC version 5 that comes with Ubuntu 16.04, as similarly reported in [https://asterisk-users.digium.narkive.com/wu0IWbYi/can-t-compile-asterisk-certified-11-6-cert16-on-ubuntu-16 an issue for Asterisk]. Alternatively, as mentioned in [https://github.com/gccxml/gccxml/issues/11] and [https://bugzilla.redhat.com/show_bug.cgi?id=476370] it may build by passing the ''-fgnu89-inline'' flag to the ''configure'' command for ''Asterisk'' (e.g with ''CFLAGS=-fgnu89-inline LDFLAGS=-fgnu89-inline'') inside the Enswitch installer, which will need to be changed)
• Version 11.x: Yes
• Version 13.x: Yes (experimental in Enswitch 3.14. The recommendation is to use it with Enswitch 3.15 or newer)
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Yes
| Version 11.x: Yes
| Version 5.0.x: Yes
| MySQL 5.5.x: Yes
|}

== Enswitch 3.13 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 3.13 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Debian 7
| Yes
| Version 11.x: Yes
| Version 4.2.x: Yes
| MySQL 5.5.x: Yes
|}

== Asterisk 18 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Asterisk 18 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| Yes
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Asterisk 16 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Asterisk 16 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| Yes
|-
| 4.1
| Yes
|-
| 4.0
| Yes
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Asterisk 13 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Asterisk 13 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| Yes
|-
| 4.1
| Yes
|-
| 4.0
| Yes
|-
| 3.15
| Yes
|-
| 3.14
| Yes, but it is experimental. The recommendation is to use it with Enswitch 3.15 or newer
|}

== Kamailio 5.6 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.6 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| No
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Kamailio 5.4 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.4 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| No
|-
| 4.2
| Yes
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Kamailio 5.2 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.2 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| No
|-
| 4.2
| No
|-
| 4.1
| Yes
|-
| 4.0
| Yes
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Kamailio 5.0 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.0 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| No
|-
| 4.2
| No
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| Yes
|-
| 3.14
| Yes
|}

Compatibility between Enswitch components and Linux distributions

2025-03-31T13:42:53Z

Vlasis:

The contents on this page have an informative purpose and are not exhaustive. Updates may be applied as more observations are gathered about compatible and incompatible combinations of Enswitch versions, their components and operating systems.

== Enswitch 4.2 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.2 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 24.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: TBD (to be determined)
• Version 18.x: TBD
| Version 5.4.x: TBD
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
• Version 18.x: Yes
| Version 5.4.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes, but the HTMLDOC version it uses does not compile. As an alternative, an older HTMLDOC version may be installed.
|
• Version 13.x: Yes
• Version 16.x: No (it requires ''libjansson'' >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the ''--with-jansson-bundled'' flag to the ''./configure'' command inside the Enswitch installer, which will need to be changed)
• Version 18.x: No (it requires ''libjansson'' >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the ''--with-jansson-bundled'' flag to the ''./configure'' command inside the Enswitch installer, which will need to be changed)
| Version 5.4.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Maybe. Debian 7 comes with MySQL 5.5, but Enswitch 4.0 and newer require MySQL version >= 5.7 or MariaDB >= 10.2. There are errors when trying to use MySQL 5.5.x, at least in the configuration files.
|
• Version 13.x: Yes
• Version 16.x: No (astdb requires SQLite library version >= 3.7.15, but Debian 7 comes with 3.7.13. Also, it requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
• Version 18.x: No (it does not exhibit the SQLite error observed with Asterisk 16.x, however it still requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.4.x: Yes
| MySQL 5.5.x: No (documented configuration file gives syntax errors and it is unknown if they may be fixed and if Enswitch would work fine after that). Updating MySQL to version >= 5.7 or MariaDB to version >= 10.2 may be an option.
|}

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.2 sub-systems
|-
! scope="col"| Distribution
! scope="col"| RTPEngine (for WebRTC and/or TLS server)
|-
! scope="row"| Ubuntu 22.04
| Version mr5.x or mr9.x: Yes
|}

== Enswitch 4.1 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.1 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 13.x: Yes
• Version 16.x: No (it requires ''libjansson'' >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the ''--with-jansson-bundled'' flag to the ''./configure'' command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Maybe. Debian 7 comes with MySQL 5.5, but Enswitch 4.0 and newer require MySQL version >= 5.7 or MariaDB >= 10.2.
|
• Version 13.x: Yes
• Version 16.x: No (astdb requires SQLite library version >= 3.7.15, but Debian 7 comes with 3.7.13. Also, it requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.5.x: does not fit Enswitch requirements. Updating MySQL to version >= 5.7 or MariaDB to version >= 10.2 may be an option.
|}

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.1 sub-systems
|-
! scope="col"| Distribution
! scope="col"| RTPEngine (for WebRTC and/or TLS server)
|-
! scope="row"| Ubuntu 20.04
| Version mr5.x or mr6.x, up to version mr6.5.12.2: Yes
|-
! scope="row"| Ubuntu 18.04
| Version mr5.x or mr6.x, up to version mr6.5.12.2: Yes
|-
! scope="row"| Ubuntu 16.04
| No (missing required packages ''libip6tc-dev'' and ''libxtables-dev'')
|}

== Enswitch 4.0 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 4.0 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 22.04)
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 20.04)
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 11.x: Yes
• Version 13.x: Yes
• Version 16.x: No (it requires libjansson >= 2.11, which is not packaged with Ubuntu before 18.04. Alternatively, it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| CentOS 7
| Yes
|
• Version 11.x: ??
• Version 13.x: Yes
• Version 16.x: Yes
| Version 5.2.x: Yes
| MySQL 8.0.x: Yes
|-
! scope="row"| Debian 7
| Maybe. Debian 7 comes with MySQL 5.5, but Enswitch 4.0 and newer require MySQL version >= 5.7 or MariaDB >= 10.2.
|
• Version 11.x: Yes
• Version 13.x: Yes
• Version 16.x: No (astdb requires SQLite library version >= 3.7.15, but Debian 7 comes with 3.7.13. Also, it requires libjansson >= 2.11, but Debian 7 comes with 2.3; it may be installed by passing the --with-jansson-bundled flag to the ./configure command inside the Enswitch installer, which will need to be changed)
| Version 5.2.x: Yes
| MySQL 5.5.x: does not fit Enswitch requirements. Updating MySQL to version >= 5.7 or MariaDB to version >= 10.2 may be an option.
|}

== Enswitch 3.15 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 3.15 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 22.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 22.04)
• Version 13.x: Yes
| Version 5.0.x: No (it does not build correctly with GCC version 11 that comes with Ubuntu 22.04, as similarly reported in [https://github.com/kamailio/kamailio/issues/2293 an issue for Kamailio]. Alternatively, it may build by passing the ''-fcommon'' flag to the ''make'' command for ''Kamailio'' (e.g with ''CC_OPT="-O2 -fcommon"'') inside the Enswitch installer, which will need to be changed)
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 20.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 20.04)
• Version 13.x: Yes
| Version 5.0.x: Yes, but Ubuntu 20.04 should be avoided because it ships with a version of Perl that has a known problem with Kamailio
| MySQL 8.0.x: Yes
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 13.x: Yes
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 11.x: Yes
• Version 13.x: Yes
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Yes
|
• Version 11.x: Yes
• Version 13.x: Yes
| Version 5.0.x: Yes
| MySQL 5.5.x: Yes
|}

== Enswitch 3.14 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 3.14 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Ubuntu 20.04
| Maybe, but there are syntax errors when trying to use MySQL 8.0.x.
| Not tried
| Not tried
| MySQL 8.0.x: No (documented configuration file gives syntax errors, Enswitch source code gives syntax errors (e.g with keyword ''rank'', with keywords ''identified by'' to create the ''enswitch'' database user))
|-
! scope="row"| Ubuntu 18.04
| Yes
|
• Version 1.8.x: No (it does not build correctly with GCC version 7 that comes with Ubuntu 18.04, as similarly reported in [https://community.asterisk.org/t/asterisk-1-8-compiling-on-deb-8-11-but-not-9-8/79393/2 an issue for Asterisk]. Alternatively, as mentioned in [https://github.com/gccxml/gccxml/issues/11] and [https://bugzilla.redhat.com/show_bug.cgi?id=476370] it may build by passing the ''-fgnu89-inline'' flag to the ''configure'' command for ''Asterisk'' (e.g with ''CFLAGS=-fgnu89-inline LDFLAGS=-fgnu89-inline'') inside the Enswitch installer, which will need to be changed, but that will not be enough because Asterisk 1.8.x requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 11.x: No (it requires a version of libssl older than the one provided by Ubuntu 18.04)
• Version 13.x: Yes (experimental in Enswitch 3.14. The recommendation is to use it with Enswitch 3.15 or newer)
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Ubuntu 16.04
| Yes
|
• Version 1.8.x: No (it does not build correctly with GCC version 5 that comes with Ubuntu 16.04, as similarly reported in [https://asterisk-users.digium.narkive.com/wu0IWbYi/can-t-compile-asterisk-certified-11-6-cert16-on-ubuntu-16 an issue for Asterisk]. Alternatively, as mentioned in [https://github.com/gccxml/gccxml/issues/11] and [https://bugzilla.redhat.com/show_bug.cgi?id=476370] it may build by passing the ''-fgnu89-inline'' flag to the ''configure'' command for ''Asterisk'' (e.g with ''CFLAGS=-fgnu89-inline LDFLAGS=-fgnu89-inline'') inside the Enswitch installer, which will need to be changed)
• Version 11.x: Yes
• Version 13.x: Yes (experimental in Enswitch 3.14. The recommendation is to use it with Enswitch 3.15 or newer)
| Version 5.0.x: Yes
| MySQL 5.7.x: Yes
|-
! scope="row"| Debian 7
| Yes
| Version 11.x: Yes
| Version 5.0.x: Yes
| MySQL 5.5.x: Yes
|}

== Enswitch 3.13 ==

{| class="wikitable" style="text-align: center;"
|+ Enswitch 3.13 main components
|-
! scope="col"| Distribution
! scope="col"| Enswitch core
! scope="col"| Asterisk
! scope="col"| Kamailio
! scope="col"| Database server
|-
! scope="row"| Debian 7
| Yes
| Version 11.x: Yes
| Version 4.2.x: Yes
| MySQL 5.5.x: Yes
|}

== Asterisk 18 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Asterisk 18 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| Yes
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Asterisk 16 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Asterisk 16 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| Yes
|-
| 4.1
| Yes
|-
| 4.0
| Yes
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Asterisk 13 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Asterisk 13 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| Yes
|-
| 4.1
| Yes
|-
| 4.0
| Yes
|-
| 3.15
| Yes
|-
| 3.14
| Yes, but it is experimental. The recommendation is to use it with Enswitch 3.15 or newer
|}

== Kamailio 5.6 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.6 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| Yes
|-
| 4.2
| No
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Kamailio 5.4 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.4 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| No
|-
| 4.2
| Yes
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Kamailio 5.2 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.2 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| No
|-
| 4.2
| No
|-
| 4.1
| Yes
|-
| 4.0
| Yes
|-
| 3.15
| No
|-
| 3.14
| No
|}

== Kamailio 5.0 ==

{| class="wikitable" style="text-align: center;"
|+ Availability of Kamailio 5.0 in the Enswitch installer
|-
! scope="col"| Enswitch version
! scope="col"| Available
|-
| 4.3
| No
|-
| 4.2
| No
|-
| 4.1
| No
|-
| 4.0
| No
|-
| 3.15
| Yes
|-
| 3.14
| Yes
|}

Upgrading MySQL to 5.7 or MariaDB to 10.2

2023-05-29T23:35:36Z

Vlasis: Vlasis moved page Upgrading MySQL to 4.7 or MariaDB to 10.2 to Upgrading MySQL to 5.7 or MariaDB to 10.2: Corrected title

* Make sure that 'mysql_upgrade' command is run
* Check if the following tables are created: innodb_index_stats, innodb_table_stats, slave_master_info, slave_relay_log_info, slave_worker_info

If one or some of the above tables are missing, create them manually using the below queries:

<pre>
USE mysql;
CREATE TABLE `innodb_index_stats` (
`database_name` varchar(64) COLLATE utf8_bin NOT NULL,
`table_name` varchar(64) COLLATE utf8_bin NOT NULL,
`index_name` varchar(64) COLLATE utf8_bin NOT NULL,
`last_update` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
`stat_name` varchar(64) COLLATE utf8_bin NOT NULL,
`stat_value` bigint(20) unsigned NOT NULL,
`sample_size` bigint(20) unsigned DEFAULT NULL,
`stat_description` varchar(1024) COLLATE utf8_bin NOT NULL,
PRIMARY KEY (`database_name`,`table_name`,`index_name`,`stat_name`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin STATS_PERSISTENT=0;
</pre>

<pre>
USE mysql;
CREATE TABLE `innodb_table_stats` (
`database_name` varchar(64) COLLATE utf8_bin NOT NULL,
`table_name` varchar(64) COLLATE utf8_bin NOT NULL,
`last_update` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
`n_rows` bigint(20) unsigned NOT NULL,
`clustered_index_size` bigint(20) unsigned NOT NULL,
`sum_of_other_index_sizes` bigint(20) unsigned NOT NULL,
PRIMARY KEY (`database_name`,`table_name`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin STATS_PERSISTENT=0;
</pre>

<pre>
USE mysql;
CREATE TABLE `slave_master_info` (
`Number_of_lines` int(10) unsigned NOT NULL COMMENT 'Number of lines in the file.',
`Master_log_name` text CHARACTER SET utf8 COLLATE utf8_bin NOT NULL COMMENT 'The name of the master binary log currently being read from the master.',
`Master_log_pos` bigint(20) unsigned NOT NULL COMMENT 'The master log position of the last read event.',
`Host` char(64) CHARACTER SET utf8 COLLATE utf8_bin NOT NULL DEFAULT '' COMMENT 'The host name of the master.',
`User_name` text CHARACTER SET utf8 COLLATE utf8_bin COMMENT 'The user name used to connect to the master.',
`User_password` text CHARACTER SET utf8 COLLATE utf8_bin COMMENT 'The password used to connect to the master.',
`Port` int(10) unsigned NOT NULL COMMENT 'The network port used to connect to the master.',
`Connect_retry` int(10) unsigned NOT NULL COMMENT 'The period (in seconds) that the slave will wait before trying to reconnect to the master.',
`Enabled_ssl` tinyint(1) NOT NULL COMMENT 'Indicates whether the server supports SSL connections.',
`Ssl_ca` text CHARACTER SET utf8 COLLATE utf8_bin COMMENT 'The file used for the Certificate Authority (CA) certificate.',
`Ssl_capath` text CHARACTER SET utf8 COLLATE utf8_bin COMMENT 'The path to the Certificate Authority (CA) certificates.',
`Ssl_cert` text CHARACTER SET utf8 COLLATE utf8_bin COMMENT 'The name of the SSL certificate file.',
`Ssl_cipher` text CHARACTER SET utf8 COLLATE utf8_bin COMMENT 'The name of the cipher in use for the SSL connection.',
`Ssl_key` text CHARACTER SET utf8 COLLATE utf8_bin COMMENT 'The name of the SSL key file.',
`Ssl_verify_server_cert` tinyint(1) NOT NULL COMMENT 'Whether to verify the server certificate.',
`Heartbeat` float NOT NULL,
`Bind` text CHARACTER SET utf8 COLLATE utf8_bin COMMENT 'Displays which interface is employed when connecting to the MySQL server',
`Ignored_server_ids` text CHARACTER SET utf8 COLLATE utf8_bin COMMENT 'The number of server IDs to be ignored, followed by the actual server IDs',
`Uuid` text CHARACTER SET utf8 COLLATE utf8_bin COMMENT 'The master server uuid.',
`Retry_count` bigint(20) unsigned NOT NULL COMMENT 'Number of reconnect attempts, to the master, before giving up.',
`Ssl_crl` text CHARACTER SET utf8 COLLATE utf8_bin COMMENT 'The file used for the Certificate Revocation List (CRL)',
`Ssl_crlpath` text CHARACTER SET utf8 COLLATE utf8_bin COMMENT 'The path used for Certificate Revocation List (CRL) files',
`Enabled_auto_position` tinyint(1) NOT NULL COMMENT 'Indicates whether GTIDs will be used to retrieve events from the master.',
PRIMARY KEY (`Host`,`Port`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 STATS_PERSISTENT=0 COMMENT='Master Information';
</pre>

<pre>
USE mysql;
CREATE TABLE `slave_relay_log_info` (
`Number_of_lines` int(10) unsigned NOT NULL COMMENT 'Number of lines in the file or rows in the table. Used to version table definitions.',
`Relay_log_name` text CHARACTER SET utf8 COLLATE utf8_bin NOT NULL COMMENT 'The name of the current relay log file.',
`Relay_log_pos` bigint(20) unsigned NOT NULL COMMENT 'The relay log position of the last executed event.',
`Master_log_name` text CHARACTER SET utf8 COLLATE utf8_bin NOT NULL COMMENT 'The name of the master binary log file from which the events in the relay log file were read.',
`Master_log_pos` bigint(20) unsigned NOT NULL COMMENT 'The master log position of the last executed event.',
`Sql_delay` int(11) NOT NULL COMMENT 'The number of seconds that the slave must lag behind the master.',
`Number_of_workers` int(10) unsigned NOT NULL,
`Id` int(10) unsigned NOT NULL COMMENT 'Internal Id that uniquely identifies this record.',
PRIMARY KEY (`Id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 STATS_PERSISTENT=0 COMMENT='Relay Log Information';
</pre>

<pre>
USE mysql;
CREATE TABLE `slave_worker_info` (
`Id` int(10) unsigned NOT NULL,
`Relay_log_name` text CHARACTER SET utf8 COLLATE utf8_bin NOT NULL,
`Relay_log_pos` bigint(20) unsigned NOT NULL,
`Master_log_name` text CHARACTER SET utf8 COLLATE utf8_bin NOT NULL,
`Master_log_pos` bigint(20) unsigned NOT NULL,
`Checkpoint_relay_log_name` text CHARACTER SET utf8 COLLATE utf8_bin NOT NULL,
`Checkpoint_relay_log_pos` bigint(20) unsigned NOT NULL,
`Checkpoint_master_log_name` text CHARACTER SET utf8 COLLATE utf8_bin NOT NULL,
`Checkpoint_master_log_pos` bigint(20) unsigned NOT NULL,
`Checkpoint_seqno` int(10) unsigned NOT NULL,
`Checkpoint_group_size` int(10) unsigned NOT NULL,
`Checkpoint_group_bitmap` blob NOT NULL,
PRIMARY KEY (`Id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 STATS_PERSISTENT=0 COMMENT='Worker Information';
</pre>

* Restart the service, check and make sure that there is no error in database service after restarted.

Updating the Web phone code

2023-02-25T14:02:49Z

Vlasis:

== Overview ==

To incorporate the Web phone code to Enswitch, a few changes to the code of the phone.js file of https://github.com/InnovateAsterisk/Browser-Phone were needed:

* First, handling of receiving data from the controller was added because the controller needs to get data from the server and pass that data to the web phone.

* Then, the class Phone is defined. After the class, a message is posted to the controller that the plugin is loaded.

* Next is the declaration of all the global variables which need to be accessible through the entire .js file. By default they're defined globally and assigned values, but because these are changes to an existing project, these values are assigned in the startPhone function.

* Next is the startPhone function which assigns values to global variables and also adds event listeners that initializes UI by calling InitUi and updates UI by calling UpdateUi.

When assigning values to the global variables, all var, let and const should be removed because we're only assigning values here and the variables are declared earlier. If new global variables are added, those should be added to the declaration also. This is done manually.

* Listeners that call InitUi and UpdateUi are moved from another part of the code in the phone.js file. These listeners could be updated so anyone working on this should estimate how much of the code should be moved.

* The last thing is in the getDbItem function, "var localDB = window.localStorage;" was replaced with "var localDB = phoneDevice;"

== Procedure ==

Changes to the phone.js file are marked with the following comments:

// MAIN ADDED CODE - START
// COMMUNICATION WITH THE WebPhoneController.js - START
// COMMUNICATION WITH THE WebPhoneController.js - END
// CUSTOM CLASS TO REMOVE USAGE OF LOCAL STORAGE - START
// CUSTOM CLASS TO REMOVE USAGE OF LOCAL STORAGE - END
// LET THE CONTROLLER KNOW THAT PLUGIN IS READY FOR BEING USED - START
// LET THE CONTROLLER KNOW THAT PLUGIN IS READY FOR BEING USED - END
// DECLARE ALL GLOBAL VARIABLES - START
// DECLARE ALL GLOBAL VARIABLES - END
// MAIN ADDED CODE - END (this comment is inside startPhone function)
// MOVED CODE - CODE MOVED TO BE CALLED IN INIT FUNCTION - START
// MOVED CODE - CODE MOVED TO BE CALLED IN INIT FUNCTION - END
// ADDED CODE - CLOSING OF INIT FUNCTION START
// ADDED CODE - CLOSING OF INIT FUNCTION END
// REPLACE window.localStorage with phoneDevice

Updating the Web phone code

2023-02-25T14:01:52Z

Vlasis: Created page with "== Overview == To incorporate the Web phone code to Enswitch, a few changes to the code of the phone.js file of https://github.com/InnovateAsterisk/Browser-Phone were needed:..."

Effect of role permissions on menus

2022-07-22T09:32:23Z

Vlasis:

This page lists the effect that roles have on the menus in Enswitch.

==Pseudo users==

* Under 'Default role for' section.
* Setting this role to Yes in the settings of a role means that new users that are created under that role from then onward are pseudo users.
* This option cannot be set to Yes in more than one role. This is why setting this to Yes in one role will automatically set this option to No in any other role where this was previously set to Yes.
* Note: each customer has a special user called a pseudo user and on the we interface this is shown as the customer name between square brackets, eg [Customer A]. When a user switches into a customer in the Enswitch web interface (as opposed to switching into another specific user), they switch into the pseudo user of that customer.

==Reports menu==

* Corresponds to the value 'reports' in the roles_access.privilege column.
* Up to Enswitch 3.15, renamed to 'Run reports' after version 4.0.
* Affects the appearance of the 'Reports' section on the left side menu.

==Run reports==

* Corresponds to the value 'reports' in the roles_access.privilege column.
* From Enswitch 4.0 onwards, it is only a rename of the 'Reports menu' privilege that was in effect until version 3.15.
* Affects the appearance of the 'Reports' section on the left side menu.

Effect of role permissions on menus

2022-07-16T13:00:27Z

Vlasis:

This page lists the effect that roles have on the menus in Enswitch.

==Reports menu==

* Corresponds to the value 'reports' in the roles_access.privilege column.
* Up to Enswitch 3.15, renamed to 'Run reports' after version 4.0.
* Affects the appearance of the 'Reports' section on the left side menu.

==Run reports==

* Corresponds to the value 'reports' in the roles_access.privilege column.
* From Enswitch 4.0 onwards, it is only a rename of the 'Reports menu' privilege that was in effect until version 3.15.
* Affects the appearance of the 'Reports' section on the left side menu.

Effect of role permissions on menus

2022-07-15T17:55:23Z

Vlasis:

This page lists the effect that roles have on the menus in Enswitch.

==Reports menu==

* Corresponds to the value 'reports' in the roles_access.privilege column.
* Up to Enswitch 3.15.
* Affects the appearance of the 'Reports' section on the left side menu.

==Run reports==

* Corresponds to the value 'reports' in the roles_access.privilege column.
* From Enswitch 4.0 onwards, it is only a rename of the "Reports menu" privilege.
* Affects the appearance of the 'Reports' section on the left side menu.

Effect of role permissions on menus

2022-07-15T17:55:13Z

Vlasis: Created page with "This page will list the effect that roles have on the menus in Enswitch. ==Reports menu== * Corresponds to the value 'reports' in the roles_access.privilege column. * Up to..."

This page will list the effect that roles have on the menus in Enswitch.

==Reports menu==

* Corresponds to the value 'reports' in the roles_access.privilege column.
* Up to Enswitch 3.15.
* Affects the appearance of the 'Reports' section on the left side menu.

==Run reports==

* Corresponds to the value 'reports' in the roles_access.privilege column.
* From Enswitch 4.0 onwards, it is only a rename of the "Reports menu" privilege.
* Affects the appearance of the 'Reports' section on the left side menu.

Coding Guidelines

2022-01-31T11:21:21Z

Vlasis:

When working on Integrics code, developers are encouraged to bear these guidelines in mind. They are guidelines rather than rules, and developers should use their own judgement as to when to break them.

* All development
** For normal text that will be read by humans, use sentence case without capital letters in the middle of sentences unless specifically required: This is a sample.
** A naming convention of <noun>_<verb> is preferred for exported library functions: email_send()
** Libraries should, where reasonable, keep their functions sorted alphabetically.
** Use the Unix standard of the newline character ("\n") to terminate lines.
** Comments should be limited to the following, unless there's a specific reason otherwise. Overuse of comments is discouraged.
*** A brief description at the top of files.
*** A copyright notice at the top of files.
*** A brief description of each 'paragraph' in long functions.
*** An explanation any section of code that may be counter-intuitive to someone reading the source.

* Go specific
** Run "go fmt" before checking into the repository.
** Strip executables before distribution unless symbols are specifically required for debugging.

* Perl specific
** Use $snake_case for variable names.
** Use snake_case for function names.
** Use CamelCase for package names.
** Use short variable names for hash references, particularly those created from database lookups.
** Use tabs for indentation.
** Leave a space after open brackets: if ( $variable ) {
** Leave a space before close brackets: if ( $variable ) {
** Leave a space after commas: function( $a, $b, $c );
** Leave a space after negation: if ( ! $variable ) {
** Do not leave a blank line after if, else, while, foreach, etc.
** Do not leave a blank line before solitary closing curly brackets.
** Do not leave multiple consecutive blank lines.
** Use " => " between hash array keys and values, and ", " between values and keys.
** If a list is very long, spread it across multiple lines. The last line before the closing round bracket should have a trailing comma.
** Use brackets on built-in Perl functions which can optionally have brackets: scalar( @variable )
** Use @EXPORT for library functions that are intended to be public.
** Use @EXPORT_OK for library variables that are intended to be public.
** 'use' statements should be listed at the top of each file, in case-insensitive alphabetical order, unless otherwise necessary.
** 'require' statements may be embedded within functions.
** Use the "<condition> ? <if true> : <if false>" construct if thought appropriate.
** For Enswitch versions 4.2 and newer prefer the array style syntax for SQL queries even for data with a single parameter, e.g. data => [ $a->{ 'uniqueid' } ].

* Databases
** Use snake_case for column names.

* Configuration files
** Use .ini format.
** Use single word lower-case section and key names were possible, or snake_case if multiple words are required.
** Use "true" and "false" for boolean values.

Change port of Keep Alive reply in Kamailio

2021-08-04T14:51:15Z

Vlasis: Created page with "Typically Kamailio sends the reply to a Keep Alive message to the port specified in the Contact: header. In cases where it is preferred to have the reply to the source port o..."

Typically Kamailio sends the reply to a Keep Alive message to the port specified in the Contact: header.

In cases where it is preferred to have the reply to the source port of the Keep Alive message, the following part of Kamailio configuration can be changed from:

<pre>
# Catch typical keep alive requests from SIP devices
if(is_method("OPTIONS") && uri==myself && $rU==$null) {
sl_send_reply("200", "Keepalive");
exit;
}
</pre>

to

<pre>
# Catch typical keep alive requests from SIP devices
if(is_method("OPTIONS") && uri==myself && $rU==$null) {
force_rport();
sl_send_reply("200", "Keepalive");
exit;
}
</pre>

Asterisk configuration for multihomed Kamailio

2021-07-27T14:46:56Z

Vlasis: Created page with "On systems where Kamailio listens on multiple IP addresses each one of those addresses must have an entry in sip.conf on the Asterisk servers. It is recommended to make a cop..."

On systems where Kamailio listens on multiple IP addresses each one of those addresses must have an entry in sip.conf on the Asterisk servers.

It is recommended to make a copy of the [enswitch-local] stanza in as many stanzas as needed and add a suffix to each stanza's name.

For example, on a system where Kamailio is listening on IP addresses 1.2.3.4 and 5.6.7.8:

<pre>
[enswitch-local]
host = 1.2.3.4
fromdomain = 1.2.3.4
type = friend
insecure = port,invite
context = from-internal
canreinvite = no
nat = yes
t38pt_udptl = no

[enswitch-local-1]
host = 5.6.7.8
fromdomain = 5.6.7.8
type = friend
insecure = port,invite
context = from-internal
canreinvite = no
nat = yes
t38pt_udptl = no
</pre>

and so forth. All stanzas must have enswitch-local as a prefix in their name.

Useful Corosync and Pacemaker Commands

2020-10-13T09:49:11Z

Vlasis:

List of useful commands for Corosync and Pacemaker clusters.

* View the real-time status of nodes and resources:

<pre>crm_mon</pre>

* View one-off status of nodes and resources:

<pre>crm status</pre>

* View cluster configuration:

<pre>crm configure show</pre>

* Set a node to standby mode (can also be used to simulate a node becoming unavailable):

<pre>crm node standby <node name></pre>

* Set a node's status from standby to online:

<pre>crm node online <node name></pre>

* Start a resource or a resource group:

<pre>crm resource start <resource name></pre>

* Stop a resource or a resource group:

<pre>crm resource stop <resource name></pre>

* Restart a resource or a resource group (if the resource is in a resource group then the whole group will be restarted):

<pre>crm resource restart <resource name></pre>

* Edit a resource, which allows its reconfiguration:

<pre>crm configure edit <resource name></pre>

* Delete a resource (must be stopped before it is deleted):

<pre>crm configure delete <resource name></pre>

* Migrate the enswitch resource group to another node (avoid migrating specific resources separately, migrate the whole enswitch group instead):

<pre>crm resource migrate enswitch <node name></pre>

* Configuring a cluster to not manage a resource:

<pre>crm_resource --resource <resource name> --set-parameter is-managed --meta --parameter-value false</pre>

* Clear a resource that is stuck in "(unmanaged) FAILED" state, e.g. due to a failed stop action:

<pre>crm_resource -P
crm resource cleanup <resource name></pre>

* List resource agents by type:
<pre>crm ra list lsb
crm ra list systemd
crm ra list ocf heartbeat
crm ra list ocf pacemaker</pre>

* Remove a resource from a group without disturbing the remaining resources:
<pre>crm configure property maintenance-mode=true
crm resource stop <resource> # it won't stop as it's in maintenance-mode
crm configure delete <resource>
crm configure show # very that all references to <resource> are gone
crm resource reprobe # the cluster double checks the status of declared resources and verifies that everything is in order and <resource> doesn't exist anymore
crm_mon -Arf1 # double check that everything is "started (unmanaged)" and <resource> is gone
crm_simulate -S -L -VVV # optional, to check what would happen when leaving maintenance-mode
crm configure property maintenance-mode=false</pre>

If something goes wrong while in maintenance-mode then

<pre>crm resource cleanup <resource></pre>

might be handy.

Useful Corosync and Pacemaker Commands

2020-08-03T12:03:33Z

Vlasis:

Useful Corosync and Pacemaker Commands

2020-07-08T09:10:07Z

Vlasis:

Enabling Messages

2018-11-02T08:54:00Z

Vlasis:

SMS messages are sent using:
* SIP SIMPLE messages when the destination is a phone registered with Enswitch.
* A custom script for external destinations.

Inbound SMS to the Enswitch system is not supported in versions 3.14 and older.

The custom script:
* Must be customised for each provider to match the protocol they use
* Is located at: <code>/usr/local/sbin/enswitch_message_out</code>
* Must be on the same machines as enswitch_sipd.

Here is an [[SMS_Send_Script_Example|example]] enswitch_message_out script to send requests via HTTP.

Besides customising this script, you need to:
* In System -> Configuration set "Enable text messages" (or "Enable messaging" in 3.13 and earlier) to Yes.
* Restart enswitch_sipd.
* In System -> Roles set "Actions » Send a message" to Yes for desired roles.
* In each Peer's outbound costs define the "Cost to send a message".
* In each Route define the "Peer for messages".
* In each Rate plan set:
** Relevant fields in "Default markups" and "Included in rate plan".
** Features -> "Send SMS messages".
** Outbound call cost exceptions -> "Cost to send message".
We recommend your configuration is thoroughly tested prior to making it available to users.

Useful Corosync and Pacemaker Commands

2018-04-05T16:07:01Z

Vlasis:

Useful Corosync and Pacemaker Commands

2018-04-05T16:03:06Z

Vlasis: Created page with "List of useful commands to for Corosync and Pacemaker clusters. * View the real-time status of nodes and resources: crm_mon * View one-off status of nodes and resources: c..."

List of useful commands to for Corosync and Pacemaker clusters.

* View the real-time status of nodes and resources:

crm_mon

* View one-off status of nodes and resources:

crm status

* View cluster configuration:

crm configure show

* Set a node to standby mode, which can be used to simulate a node becoming unavailable:

crm node standby <node name>

* Set a node's status from standby to online:

crm node online <node name>

* Start a resource or a resource group:

crm resource start <resource name>

* Stop a resource or a resource group:

crm resource stop <resource name>

* Edit a resource, which allows you to reconfigure it:

crm configure edit <resource name>

* Delete a resource (must be stopped before it is deleted):

crm configure delete <resource name>

* Migrate a resource to another node:

crm resource migrate <resource name> <node name>

* Configuring a cluster to not manage a resource:

crm_resource --resource <resource name> --set-parameter is-managed --meta --parameter-value false

* Clear a resource that is stuck in "(unmanaged) FAILED" state, e.g. due to a failed stop action:

crm_resource -P
crm resource cleanup <resource name>

* List resource agents by type:
crm ra list lsb
crm ra list systemd
crm ra list ocf heartbeat
crm ra list ocf pacemaker