Запуск скрипта-сервиса на Python для непрерывной работы через systemd

Для примера далее рассматривается скрипт "/home/korolev/autocall_process.py"
Скрипт Python должен работать в бесконечном цикле примерно так:
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
import subprocess
from psycopg2 import sql
from datetime import datetime, time
<... функция work() и другие ...>
def main():
    while True:
        work()
        # Пауза перед следующей итерацией
        time.sleep(CHECK_INTERVAL)
if __name__ == "__main__":
    main()

После отладки, делаем сам скрипт исполняемым:
# chmod +x /home/korolev/autocall_process.py
Создаем unit системы systemd:
# nano /etc/systemd/system/autocall.service
[Unit]
Description=AutoCall Dialer Service Freeswitch
After=network.target postgresql.service freeswitch.service
Wants=postgresql.service freeswitch.service
[Service]
Type=simple
User=korolev
Group=korolev
WorkingDirectory=/home/korolev
Environment=PYTHONUNBUFFERED=1
ExecStart=/usr/bin/python3 /home/korolev/autocall_process.py
Restart=always
RestartSec=10
StandardOutput=journal
StandardError=journal
SyslogIdentifier=autocall
[Install]
WantedBy=multi-user.target

Так как скрипт работает от пользователя korolev, но должен обращаться к ПО Freeswitch, работающее под пользователем freeswitch, добавляем пользователя korolev в группу freeswitch
# usermod -aG freeswitch korolev

Запускаемся:
# systemctl daemon-reload
# systemctl start autocall.service
# systemctl enable autocall.service

Следить за логами теперь можно через системный журнал так:
# journalctl -u autocall.service -f

Модули mod_xml_curl, mod_httapi и mod_xml_rpc FREESWITCH

Модуль mod_xml_curl
Этот модуль используется для динамической генерации XML-конфигураций FreeSWITCH через внешний HTTP-сервер.
Загрузка выполняется при старте freeswitch и при выполнении команды reloadxml.
Freeswitch отправялет запрос о том, какую секцию загрузить, например directory или dialplan. В отввет ожидается XML документ куска конфигурации.
По умолчанию модуль не включен в конфигурацию Freeswitch. Проверка:
# fs_cli -x "module_exists mod_xml_curl"
Команда должна вывести "false"
Для установки модуля сначало необходимо его скомпилировать. Заходим в директорию с исходными кодами freeswitch, проводим сборку и установку.
# cd /usr/src/freeswitch
# cd src/mod/xml_int/mod_xml_curl
# make install
Проверка установки модуля:
# ls -l /usr/lib64/freeswitch/mod/ | grep curl
Теперь модуль нужно минимально сконфигурить. Открываем конфигурационный файл:
# nano /etc/freeswitch/autoload_configs/xml_curl.conf.xml
Для проерки достаточно прописать один параметр, определяющий URL, откуда сервер Freeswitch будет подтягивать конфигурацию.
Это параметр gateway-url:
    <binding name="example">
        <param name="gateway-url" value="http://127.0.0.1:8081/fsapi" bindings="dialplan|configuration|directory|phrases"/>
...
</binding>
Теперь проверяем загрузку модуля:
# fs_cli
> load mod_xml_curl
Ответ должен быть "+OK"
Для включения модуля в конфигурацию открываем файл загружаемых модулей:
# nano /etc/freeswitch/autoload_configs/modules.conf.xml
Раскомментируем строчку
<load module="mod_xml_curl"/>

Модуль mod_httapi.
Модуль позволяет интегрировать FreeSWITCH с внешними HTTP-сервисами для обработки вызовов через API.
Запрос на внешний сервер может отправляться при каждом вызове. Freeswitch отправляет на внешний HTTP сервер запрос содержащий, например переменные:
caller_id_number (Номер звонящего), destination_number (Набранный номер).
В ответ Freeswitch должен получить набор инструкций, описывающий обработку вызова. Или набор переменных, которые используются для обработки вызова в диалплане.
По умолчанию модуль включен в конфигурацию Freeswitch. Проверка:
# fs_cli -x "module_exists mod_httapi"
Команда должна вывести "true"
Файл настроек модуля:
# nano /etc/freeswitch/autoload_configs/httapi.conf.xml

Модуль mod_xml_rpc.
Модуль mod_xml_rpc в FreeSWITCH позволяет использовать XML-RPC интерфейс для управления сервером через внешние приложения.
По умолчанию модуль не включен в конфигурацию Freeswitch. Проверка:
# fs_cli -x "module_exists mod_xml_rpc"
Команда должна вывести "false"
Для установки модуля сначала необходимо его скомпилировать. Заходим в директорию с исходными кодами freeswitch, проводим сборку и установку.
# cd /usr/src/freeswitch
# cd src/mod/xml_int/mod_xml_rpc
# make install
Проверка установки:
# ls -l /usr/lib64/freeswitch/mod/ | grep mod_xml_rpc
# fs_cli
> load mod_xml_rpc
Отет должен быть "+OK"
Включаем модуль в загрузку при старте Freeswitch:
# nano /etc/freeswitch/autoload_configs/modules.conf.xml
Раскомментируем строку:
<load module="mod_xml_rpc"/>
Файл настроек модуля:
# nano /etc/freeswitch/autoload_configs/xml_rpc.conf.xml
Тут можно указать логин-пароль для доступа к сервису XML-RPC (по умолчанию freeswitch/works), сменить прослушиваемый порт (по умолчанию 8080) и выставить IP адрес, на котором сервис слушает сеть (по умолчанию 0.0.0.0, установить конкретный IP можно директивой <param name="listen-ip" value="127.0.0.1"/>)
Рестартуем Freeswitch
# systemctl restart freeswitch
Проверка прослушивания порта 8080:
# netstat -ltupn | grep 8080
Проверка выполнения команд
# curl -X GET http://127.0.0.1:8080/webapi/sofia?status%20profile%20internal -u freeswitch:works                          
Name                    internal
Domain Name             N/A
Auto-NAT                false
DBName                  sofia_reg_internal
Pres Hosts              10.0.1.53,10.0.1.53
Dialplan                XML
Context                 public
Challenge Realm         auto_from
.....

Библиотека Event Socket Library (ESL) для Freeswitch

Библиотека ESL позволяет гибко управлять Freeswitch через сокеты.
Для сборки библиотеки необходимо предварительно установить пакеты:
# dnf groupinstall "Development Tools"
# dnf install python3-devel
# dnf install libcurl-devel openssl-devel
Переходим в каталог с исходными кодами и собираем пакет ESL для Python3:
# cd /usr/src/freeswitch/libs/esl/
# make pymod
# cp python/_ESL.so /usr/lib64/python3.9/site-packages/
# cp python/ESL.py /usr/lib64/python3.9/site-packages/
Включаем возможность работы с сокетами в Freeswitch:
# nano /etc/freeswitch/autoload_configs/modules.conf.xml
Следующая строчка должна быть раскомментирована:
<load module="mod_event_socket"/>
Конфигурационный файл модуля mod_event_socket
# nano /etc/freeswitch/autoload_configs/event_socket.conf.xml
Тут определяются пароли доступа к сервису ESL, прослушиваемый порт.
Можно все оставить по умолчанию или изменить пароль подключения.
После изменений конфигурации, нужно рестартовать Freeswitch
# systemctl restart freeswitch
Для проверки создаем файл соединения с Python:
# nano testesl.py
Содержимое:
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
import string
import sys
from ESL import ESLconnection
esl = ESLconnection("127.0.0.1","8021","ClueCon")
if esl.connected():
    print("Подключение к FreeSWITCH успешно!")
else:
    print("Не удалось подключиться к FreeSWITCH.")
if esl.connected:
    esl.events("plain", "all");
    while 1:
        event = esl.recvEvent()
        if event:
            # Выводим содержимое события
            print("Получено событие:")
            print(event.serialize())
Теперь после запуска сервера:
# python3 testesl.py
Мы будем получать все события:
Подключение к FreeSWITCH успешно!
Получено событие:
Event-Name: HEARTBEAT
Core-UUID: f78a248f-4d85-4d36-a773-424267bc7761
FreeSWITCH-Hostname: testkvs
FreeSWITCH-Switchname: testkvs
...
Получено событие:
Event-Name: RE_SCHEDULE
Core-UUID: f78a248f-4d85-4d36-a773-424267bc7761
FreeSWITCH-Hostname: testkvs
FreeSWITCH-Switchname: testkvs
...

Запись CDR файлов Freeswitch 1.10 в базу PostgreSQL 15.10. ОС Rocky Linux 9.4.

1. Подготавливаем базу данных PostgreSQL для записи данных.
Создадим базу данных fscdr. Пользователя fscdr с паролем fscdrpassword.
# sudo -i -u postgres
$ psql
postgres=# CREATE DATABASE fscdr;
postgres=# CREATE USER fscdr WITH PASSWORD 'fscdrpassword';
postgres=# GRANT ALL PRIVILEGES ON DATABASE fscdr to fscdr;
postgres=# \c fscdr
fscdr=# CREATE TABLE cdr (
    id                        serial PRIMARY KEY,
    local_ip_v4               inet NOT NULL,
    caller_id_name            VARCHAR,
    caller_id_number          VARCHAR,
    destination_number        VARCHAR NOT NULL,
    context                   VARCHAR NOT NULL,
    start_stamp               TIMESTAMP WITH TIME zone NOT NULL,
    answer_stamp              TIMESTAMP WITH TIME zone,
    end_stamp                 TIMESTAMP WITH TIME zone NOT NULL,
    duration                  INT NOT NULL,
    billsec                   INT NOT NULL,
    hangup_cause              VARCHAR NOT NULL,
    uuid                      uuid NOT NULL,
    bleg_uuid                 uuid,
    accountcode               VARCHAR,
    read_codec                VARCHAR,
    write_codec               VARCHAR,
    sip_hangup_disposition    VARCHAR,
    ani                       VARCHAR
);
fscdr=# GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO "fscdr";
fscdr=# GRANT USAGE, SELECT ON SEQUENCE cdr_id_seq TO fscdr;
Теперь разрешаем пользователю fscdr соединяться с базой по логину и паролю:
# nano /var/lib/pgsql/data/pg_hba.conf
# IPv4 local connections:
host    all             bsdb            127.0.0.1/32            md5
Рестартуем сервис PostgreSQL:
# systemctl restart postgresql-15

2. Устанавливаем расширение mod_cdr_pg_csv для Freeswitch.
В моей инсталляции Freeswitch был собран из исходных кодов, поэтому модуль нужно так же зобрать из исходных кодов.
# export PKG_CONFIG_PATH=/usr/pgsql-15/lib/pkgconfig:/usr/lib/pkgconfig
# cd /usr/src/freeswitch/src/mod/event_handlers/mod_cdr_pg_csv/
# make install
Теперь в директории с модулями Freeswitch должны появитсья файлы расширения - mod_cdr_pg_csv
# ls -l /usr/lib64/freeswitch/mod/ | grep mod_cdr_pg_csv
Проверка загрузки модуля в Freeswitch
# fs_cli
> load mod_cdr_pg_csv
+OK Reloading XML
+OK
[CONSOLE] switch_loadable_module.c:1772 Successfully Loaded [mod_cdr_pg_csv]

3. Включаем модуль mod_cdr_pg_csv для загрузки при старте Freeswitch
# nano /etc/freeswitch/autoload_configs/modules.conf.xml
Добавляем строку:
<load module="mod_cdr_pg_csv"/>
Рестартуем Freeswitch:
# systemctl restart freeswitch
Проверить, что модуль загрузился после старта можно так:
# fs_cli
> module_exists mod_cdr_pg_csv
true

4. Настраиваем связку Freeswitch и PostgreSQL:
# nano autoload_configs/cdr_pg_csv.conf.xml
Раскомментируем строки:
 <param name="db-table" value="cdr"/>
 ....
 <field var="sip_hangup_disposition"/>
 <field var="ani"/>
и правим строку с авторизационными данными:
<param name="db-info" value="host=127.0.0.1 dbname=fscdr user=fscdr password='fscdrpassword' connect_timeout=10" />

Теперь все данные о вызовах (включая не успешные) будут записываться в базу данных.

Установка Freswitch 1.10 в Rocky Linux 9.4 методом сборки из исходных кодов.

1. Выполним установку дополнительных репозитариев epel и crb

# dnf install epel-release

# /usr/bin/crb enable

2. Установим пакеты, которые потребуются для сборки 

# dnf install wget tar git gcc-c++ zlib-devel sqlite sqlite-devel libcurl libcurl-devel pcre-devel autoconf automake libtool cmake libuuid-devel libatomic openssl-devel unixODBC libedit-devel python3 python3-devel python3-click-threading python3-threadpoolctl python3-utils libvpx yasm lua-devel libsndfile-devel speexdsp-devel ldns-devel

# dnf --enablerepo=devel install unixODBC-devel opus-devel libogg-devel

3. Скачиваем пакеты spandsp и sofia-sip, которых нет в репозитариях, но которые требуются для функционирования freeswitch. Пакеты расположены на странице http://repo.okay.com.mx/?dir=centos/9/x86_64/release

# cd /usr/src

# wget http://repo.okay.com.mx/centos/9/x86_64/release/spandsp-3.0.0-1.el9.x86_64.rpm

# wget http://repo.okay.com.mx/centos/9/x86_64/release/spandsp-devel-3.0.0-1.el9.x86_64.rpm

# dnf install spandsp*

# wget http://repo.okay.com.mx/centos/9/x86_64/release/sofia-sip-1.13.17-1.el9.x86_64.rpm

# wget http://repo.okay.com.mx/centos/9/x86_64/release/sofia-sip-devel-1.13.17-1.el9.x86_64.rpm

# wget http://repo.okay.com.mx/centos/9/x86_64/release/sofia-sip-glib-1.13.17-1.el9.x86_64.rpm

# wget http://repo.okay.com.mx/centos/9/x86_64/release/sofia-sip-utils-1.13.17-1.el9.x86_64.rpm

# dnf install sofia-sip*

4. Далее необходимо установить определенные пакеты speex и speexdsp, рекомендуемые для Freswitch 1.10. Скачиваем и устанавливаем пакеты по инструкции с официального сайта:

# wget http://downloads.us.xiph.org/releases/speex/speex-1.2rc1.tar.gz

# wget http://downloads.us.xiph.org/releases/speex/speexdsp-1.2rc2.tar.gz

# tar -xpf speex-1.2rc1.tar.gz

# tar -xpf speexdsp-1.2rc2.tar.gz

# cd speex-1.2rc1

# ./configure --prefix=/usr --disable-static --docdir=/usr/share/doc/speex-1.2rc1

# make

# make install

# cd ../speexdsp-1.2rc2

# ./configure --prefix=/usr --disable-static --docdir=/usr/share/doc/speexdsp-1.2rc2

# make

# make install

5. Теперь необходимо установить пакет libks, который так же необходим для успешной сборки Freswitch 1.10

# cd /usr/src

# git clone https://github.com/signalwire/libks.git

# cd libks/

# cmake . -DCMAKE_INSTALL_PREFIX:PATH=/usr

# make

# make install

Данный пакет устанавливается как-то скрытно и его почему-то "не видно" другим пакетам, использующим libks. Что бы это исправить необходимо найти местоположение файла libks2.pc и путь к этому файлу прописать в переменную среды, которую используют сборщики и компиляторы - PKG_CONFIG_PATH

# find / | grep 'libks2.pc'

 /usr/lib/pkgconfig/libks2.pc
 /usr/src/libks/libks2.pc

Используем местоположение, ассоциированное с pkgconfig, то есть "/usr/lib/pkgconfig" и задаем переменную среды:

# export PKG_CONFIG_PATH=/usr/lib/pkgconfig 

6. Далее необходимо установить пакет signalwire-c, который так же устанавливается путем сборки из исходников

# cd /usr/src

# git clone https://github.com/signalwire/signalwire-c.git

# cd signalwire-c/

# cmake . -DCMAKE_INSTALL_PREFIX:PATH=/usr

# make

# make install

7. Далее необходимо установить ряд пакетов кодеков. Основные пакеты - это libavformat-dev и libswscale-dev. Но что бы совсем не иметь проблем с кодеками можно установить мощную утилиту ffmpeg с набором всех возможных кодеков.

# dnf install --nogpgcheck https://mirrors.rpmfusion.org/free/el/rpmfusion-free-release-$(rpm -E %rhel).noarch.rpm -y

# dnf install --nogpgcheck https://mirrors.rpmfusion.org/nonfree/el/rpmfusion-nonfree-release-$(rpm -E %rhel).noarch.rpm -y

# dnf install ffmpeg ffmpeg-devel

8. Современные сборки Freswitch 1.10 работают с БД Postgresql. Поэтому перед сборкой Freeswitch рекомендуется иметь пакет postgresql-devel и саму базу PostgeeSQL. Причем рекомендуется установить версию 15. Данный пункт можно пропустить, если не планируется использовать Freswitch со встроенной поддержкой postgresql. Устанавливаем репозитарий Postgresql для того, что бы иметь возможность пользоваться новыми версиями СУБД

# dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-9-x86_64/pgdg-redhat-repo-latest.noarch.rpm

Отключаем встроенный модуль postgresql в репозитариях по умолчанию.

# dnf -qy module disable postgresql

Устанавливаем последнюю версию PostgreSQL

# dnf install -y postgresql15-devel postgresql15-server

# /usr/pgsql-15/bin/postgresql-15-setup initdb

# systemctl start postgresql-15

# systemctl enable postgresql-15

9. Теперь подошла очередь установить сам Freeswitch

# cd /usr/src

# wget https://files.freeswitch.org/freeswitch-releases/freeswitch-1.10.12.-release.tar.xz

# tar -xpJf freeswitch-1.10.12.-release.tar.xz

# mv freeswitch-1.10.12.-release freeswitch

Теперь в директории /usr/src/freeswitch лежит свежий код проекта Freeswich

10. Запускаем конфигурирование и сборку.

# cd freeswitch

# ./rebootstrap.sh

Для сборки Freeswitch c поддержкой PostgreSQL необходимо обогатить PKG_CONFIG_PATH переменную путем до файла libpq.pc. (при этом путь до libks2.pc должен остаться). В моем случае файл libks2.pc лежал тут "/usr/pgsql-15/lib/pkgconfig". В руководстве по установке Freeswitch так же рекомендуют добавить путь к исполняемому файлу PostgreSQL в переменную среды PATH.

# export PKG_CONFIG_PATH=/usr/pgsql-15/lib/pkgconfig:/usr/lib/pkgconfig 

# export PATH=/usr/pgsql-15/bin:$PATH

# ./configure -C --enable-portable-binary --prefix=/usr --localstatedir=/var --sysconfdir=/etc --with-gnu-ld --with-python3 --with-openssl --enable-core-odbc-support --enable-core-pgsql-support

Конфигурирование должно завершится выводом:

-------------------------- FreeSWITCH configuration --------------------------
  Locations:
      prefix:          /usr
      exec_prefix:     /usr
      bindir:          ${exec_prefix}/bin
      confdir:         /etc/freeswitch
      libdir:          /usr/lib64
      datadir:         /usr/share/freeswitch
      localstatedir:   /var/lib/freeswitch
      includedir:      /usr/include/freeswitch
      certsdir:        /etc/freeswitch/tls
      dbdir:           /var/lib/freeswitch/db
      grammardir:      /usr/share/freeswitch/grammar
      htdocsdir:       /usr/share/freeswitch/htdocs
      fontsdir:        /usr/share/freeswitch/fonts
      logfiledir:      /var/log/freeswitch
      modulesdir:      /usr/lib64/freeswitch/mod
      pkgconfigdir:    /usr/lib64/pkgconfig
      recordingsdir:   /var/lib/freeswitch/recordings
      imagesdir:       /var/lib/freeswitch/images
      runtimedir:      /var/run/freeswitch
      scriptdir:       /usr/share/freeswitch/scripts
      soundsdir:       /usr/share/freeswitch/sounds
      storagedir:      /var/lib/freeswitch/storage
      cachedir:        /var/cache/freeswitch
------------------------------------------------------------------------------

Запускаем сборку:

# make

Нормальный вывод после сборки:

 +---------- FreeSWITCH Build Complete ----------+
 + FreeSWITCH has been successfully built.       +
 + Install by running:                           +
 +                                               +
 +                make install                   +
 +                                               +
 + While you're waiting, register for ClueCon!   +
 + https://www.cluecon.com                       +
 +                                               +
 +-----------------------------------------------+

.=======================================================================================================.
|       _                            _    ____ _             ____                                       |
|      / \   _ __  _ __  _   _  __ _| |  / ___| |_   _  ___ / ___|___  _ __                             |
|     / _ \ | '_ \| '_ \| | | |/ _` | | | |   | | | | |/ _ \ |   / _ \| '_ \                            |
|    / ___ \| | | | | | | |_| | (_| | | | |___| | |_| |  __/ |__| (_) | | | |                           |
|   /_/   \_\_| |_|_| |_|\__,_|\__,_|_|  \____|_|\__,_|\___|\____\___/|_| |_|                           |
|                                                                                                       |
|    ____ _____ ____    ____             __                                                             |
|   |  _ \_   _/ ___|  / ___|___  _ __  / _| ___ _ __ ___ _ __   ___ ___                                |
|   | |_) || || |     | |   / _ \| '_ \| |_ / _ \ '__/ _ \ '_ \ / __/ _ \                               |
|   |  _ < | || |___  | |__| (_) | | | |  _|  __/ | |  __/ | | | (_|  __/                               |
|   |_| \_\|_| \____|  \____\___/|_| |_|_|  \___|_|  \___|_| |_|\___\___|                               |
|                                                                                                       |
|     ____ _             ____                                                                           |
|    / ___| |_   _  ___ / ___|___  _ __         ___ ___  _ __ ___                                       |
|   | |   | | | | |/ _ \ |   / _ \| '_ \       / __/ _ \| '_ ` _ \                                      |
|   | |___| | |_| |  __/ |__| (_) | | | |  _  | (_| (_) | | | | | |                                     |
|    \____|_|\__,_|\___|\____\___/|_| |_| (_)  \___\___/|_| |_| |_|                                     |
|                                                                                                       |
.=======================================================================================================.

make[2]: Leaving directory '/usr/src/freeswitch/build'
Making all in tests/unit
make[2]: Entering directory '/usr/src/freeswitch/tests/unit'
  CC       switch_eavesdrop.o
  CCLD     switch_eavesdrop
  CC       switch_event.o
  CCLD     switch_event
  CC       switch_hash.o
  CCLD     switch_hash
  CC       switch_ivr_originate.o
  CCLD     switch_ivr_originate
  CC       switch_utils.o
  CCLD     switch_utils
  CC       switch_core.o
  CCLD     switch_core
  CC       switch_console.o
  CCLD     switch_console
  CC       switch_vpx.o
  CCLD     switch_vpx
  CC       switch_core_file.o
  CCLD     switch_core_file
  CC       switch_ivr_play_say.o
  CCLD     switch_ivr_play_say
  CC       switch_core_codec.o
  CCLD     switch_core_codec
  CC       switch_rtp.o
  CCLD     switch_rtp
  CC       switch_xml.o
  CCLD     switch_xml
  CC       switch_core_video.o
  CCLD     switch_core_video
  CC       switch_core_db.o
  CCLD     switch_core_db
  CC       switch_vad.o
  CCLD     switch_vad
  CC       switch_packetizer.o
  CCLD     switch_packetizer
  CC       switch_core_session.o
  CCLD     switch_core_session
  CC       test_sofia.o
  CCLD     test_sofia
  CC       switch_ivr_async.o
  CCLD     switch_ivr_async
  CC       switch_core_asr.o
  CCLD     switch_core_asr
  CC       switch_log.o
  CCLD     switch_log
  CC       switch_hold.o
  CCLD     switch_hold
  CC       switch_sip.o
  CCLD     switch_sip
make[2]: Leaving directory '/usr/src/freeswitch/tests/unit'
make[1]: Leaving directory '/usr/src/freeswitch'

Запускаем установку

# make install

Установка завершается выводом:

 +---------- FreeSWITCH install Complete ----------+
 + FreeSWITCH has been successfully installed.     +
 +                                                 +
 +       Install sounds:                           +
 +       (uhd-sounds includes hd-sounds, sounds)   +
 +       (hd-sounds includes sounds)               +
 +       ------------------------------------      +
 +                make cd-sounds-install           +
 +                make cd-moh-install              +
 +                                                 +
 +                make uhd-sounds-install          +
 +                make uhd-moh-install             +
 +                                                 +
 +                make hd-sounds-install           +
 +                make hd-moh-install              +
 +                                                 +
 +                make sounds-install              +
 +                make moh-install                 +
 +                                                 +
 +       Install non english sounds:               +
 +       replace XX with language                  +
 +       (ru : Russian)                            +
 +       (fr : French)                             +
 +       ------------------------------------      +
 +                make cd-sounds-XX-install        +
 +                make uhd-sounds-XX-install       +
 +                make hd-sounds-XX-install        +
 +                make sounds-XX-install           +
 +                                                 +
 +       Upgrade to latest:                        +
 +       ----------------------------------        +
 +                make current                     +
 +                                                 +
 +       Rebuild all:                              +
 +       ----------------------------------        +
 +                make sure                        +
 +                                                 +
 +       Install/Re-install default config:        +
 +       ----------------------------------        +
 +                make samples                     +
 +                                                 +
 +                                                 +
 +       Additional resources:                     +
 +       ----------------------------------        +
 +       https://www.freeswitch.org                +
 +       https://freeswitch.org/confluence         +
 +       https://freeswitch.org/jira               +
 +       http://lists.freeswitch.org               +
 +                                                 +
 +       irc.freenode.net / #freeswitch            +
 +                                                 +
 +       Register For ClueCon:                     +
 +       ----------------------------------        +
 +       https://www.cluecon.com                   +
 +                                                 +
 +-------------------------------------------------+
.=======================================================================================================.
|       _                            _    ____ _             ____                                       |
|      / \   _ __  _ __  _   _  __ _| |  / ___| |_   _  ___ / ___|___  _ __                             |
|     / _ \ | '_ \| '_ \| | | |/ _` | | | |   | | | | |/ _ \ |   / _ \| '_ \                            |
|    / ___ \| | | | | | | |_| | (_| | | | |___| | |_| |  __/ |__| (_) | | | |                           |
|   /_/   \_\_| |_|_| |_|\__,_|\__,_|_|  \____|_|\__,_|\___|\____\___/|_| |_|                           |
|                                                                                                       |
|    ____ _____ ____    ____             __                                                             |
|   |  _ \_   _/ ___|  / ___|___  _ __  / _| ___ _ __ ___ _ __   ___ ___                                |
|   | |_) || || |     | |   / _ \| '_ \| |_ / _ \ '__/ _ \ '_ \ / __/ _ \                               |
|   |  _ < | || |___  | |__| (_) | | | |  _|  __/ | |  __/ | | | (_|  __/                               |
|   |_| \_\|_| \____|  \____\___/|_| |_|_|  \___|_|  \___|_| |_|\___\___|                               |
|                                                                                                       |
|     ____ _             ____                                                                           |
|    / ___| |_   _  ___ / ___|___  _ __         ___ ___  _ __ ___                                       |
|   | |   | | | | |/ _ \ |   / _ \| '_ \       / __/ _ \| '_ ` _ \                                      |
|   | |___| | |_| |  __/ |__| (_) | | | |  _  | (_| (_) | | | | | |                                     |
|    \____|_|\__,_|\___|\____\___/|_| |_| (_)  \___\___/|_| |_| |_|                                     |
|                                                                                                       |
.=======================================================================================================.
Checking module integrity in target [/usr/lib64/freeswitch/mod]
make[2]: Leaving directory '/usr/src/freeswitch/build'
Making install in tests/unit
make[2]: Entering directory '/usr/src/freeswitch/tests/unit'
make[3]: Entering directory '/usr/src/freeswitch/tests/unit'
 /bin/mkdir -p '/usr/bin'
  /bin/sh /usr/src/freeswitch/libtool   --mode=install /bin/install -c switch_eavesdrop '/usr/bin'
libtool: install: /bin/install -c .libs/switch_eavesdrop /usr/bin/switch_eavesdrop
make[3]: Nothing to be done for 'install-data-am'.
make[3]: Leaving directory '/usr/src/freeswitch/tests/unit'
make[2]: Leaving directory '/usr/src/freeswitch/tests/unit'
make[1]: Leaving directory '/usr/src/freeswitch'

Теперь осталось установить звуки:

# make cd-sounds-install

# make cd-moh-install

# make cd-sounds-ru-install

11. Freeswitch установлен. Теперь перед первым запуском нужно немного подрехтовать систему.

Сначала отключаем поддержку IPv6

# mv /etc/freeswitch/sip_profiles/internal-ipv6.xml /etc/freeswitch/sip_profiles/internal-ipv6.xml.removed

# mv /etc/freeswitch/sip_profiles/external-ipv6.xml /etc/freeswitch/sip_profiles/external-ipv6.xml.removed

12. Выполняем первый запуск. При первом запуске Freeswitch создаст необходимые для работы каталоги.

# /usr/bin/freeswitch

Запуск завершается выводом:

.=============================================================.
|   _____              ______        _____ _____ ____ _   _   |
|  |  ___| __ ___  ___/ ___\ \      / /_ _|_   _/ ___| | | |  |
|  | |_ | '__/ _ \/ _ \___ \\ \ /\ / / | |  | || |   | |_| |  |
|  |  _|| | |  __/  __/___) |\ V  V /  | |  | || |___|  _  |  |
|  |_|  |_|  \___|\___|____/  \_/\_/  |___| |_| \____|_| |_|  |
|                                                             |
.=============================================================.
|   Anthony Minessale II, Michael Jerris, Brian West, Others  |
|   FreeSWITCH (http://www.freeswitch.org)                    |
|   Paypal Donations Appreciated: paypal@freeswitch.org       |
|   Brought to you by ClueCon http://www.cluecon.com/         |
.=============================================================.
.=======================================================================================================.
|       _                            _    ____ _             ____                                       |
|      / \   _ __  _ __  _   _  __ _| |  / ___| |_   _  ___ / ___|___  _ __                             |
|     / _ \ | '_ \| '_ \| | | |/ _` | | | |   | | | | |/ _ \ |   / _ \| '_ \                            |
|    / ___ \| | | | | | | |_| | (_| | | | |___| | |_| |  __/ |__| (_) | | | |                           |
|   /_/   \_\_| |_|_| |_|\__,_|\__,_|_|  \____|_|\__,_|\___|\____\___/|_| |_|                           |
|                                                                                                       |
|    ____ _____ ____    ____             __                                                             |
|   |  _ \_   _/ ___|  / ___|___  _ __  / _| ___ _ __ ___ _ __   ___ ___                                |
|   | |_) || || |     | |   / _ \| '_ \| |_ / _ \ '__/ _ \ '_ \ / __/ _ \                               |
|   |  _ < | || |___  | |__| (_) | | | |  _|  __/ | |  __/ | | | (_|  __/                               |
|   |_| \_\|_| \____|  \____\___/|_| |_|_|  \___|_|  \___|_| |_|\___\___|                               |
|                                                                                                       |
|     ____ _             ____                                                                           |
|    / ___| |_   _  ___ / ___|___  _ __         ___ ___  _ __ ___                                       |
|   | |   | | | | |/ _ \ |   / _ \| '_ \       / __/ _ \| '_ ` _ \                                      |
|   | |___| | |_| |  __/ |__| (_) | | | |  _  | (_| (_) | | | | | |                                     |
|    \____|_|\__,_|\___|\____\___/|_| |_| (_)  \___\___/|_| |_| |_|                                     |
|                                                                                                       |
.=======================================================================================================.
2024-12-19 20:18:17.238152 100.00% [INFO] switch_core.c:2503
FreeSWITCH Version 1.10.12-release~64bit (-release 64bit)
FreeSWITCH Started
Max Sessions [1000]
Session Rate [30]
SQL [Enabled]
2024-12-19 20:18:17.238155 100.00% [CONSOLE] switch_core.c:2511
[This app Best viewed at 160x60 or more..]
freeswitch@pbx.smarts.ru> 2024-12-19 20:18:18.657140 99.83% [NOTICE] mod_signalwire.c:401 Go to https://signalwire.com to set up your Connector now! Enter connection token aa6eadd9-0a85-45db-9fcc-466f7beddbe1
2024-12-19 20:18:18.657140 99.83% [INFO] mod_signalwire.c:1125 Next SignalWire adoption check in 1 minutes
2024-12-19 20:19:18.737283 99.57% [NOTICE] mod_signalwire.c:401 Go to https://signalwire.com to set up your Connector now! Enter connection token aa6eadd9-0a85-45db-9fcc-466f7beddbe1

Что бы убедиться, что все работает вводим команду "sofia status"

freeswitch@pbx.domen.ru> sofia status

                     Name          Type                                       Data      State
=================================================================================================
               172.31.0.3         alias                                   internal      ALIASED
                 external       profile             sip:mod_sofia@1.3.20.5:5080      RUNNING (0)
    external::example.com       gateway                    sip:joeuser@example.com      NOREG
                 internal       profile             sip:mod_sofia@1.3.20.5:5060      RUNNING (0)
=================================================================================================
2 profiles 1 alias

Выход из системы по команде «shutdown».

Во всех современых сборках Freeswitch есть модуль mod_signalwire, который пытается установить связь с сервером компании SignalWire, спонсирующей разработку Freeswitch. Компания SignalWire предлагает услуги VoIP телефонии, но для РФ это не актуально. Для отключения этой навязчивой рекламы нужно отключить модуль mod_signalwire из загрузки.

Для этого открываем

# nano /etc/freeswitch/autoload_configs/modules.conf.xml

и комментируем строчку

<load module="mod_signalwire"/>  

превращая ее в

<!--<load module="mod_signalwire"/>-->

Теперь Freeswitch будет запускаться без функционала SignalWire.

13. Создаем системного пользователя от имени которого будет в дальнейшем работать freeswitch

# useradd --system freeswitch

# passwd -l freeswitch

Увеличиваем количество лимитов на открытие файлов и обращений к жесткому диску для пользователя freeswitch

# nano /etc/security/limits.conf

Вписываем в конец файла перед строкой

# End of file

Следующее строки:

freeswitch         hard    nofile      500000

freeswitch         soft    nofile      500000

14. Назначаем права на папки freeswitch

# chown -R freeswitch:freeswitch /etc/freeswitch/ /var/lib/freeswitch /var/log/freeswitch /run/freeswitch

15. Добавляем freeswitch в автозапуск системы systemd

# nano /usr/lib/systemd/system/freeswitch.service

Содержимое файла:

[Unit]
Description=freeswitch
After=syslog.target network.target postgresql-15.service httpd.service local-fs.target

[Service]
Type=forking
RuntimeDirectory=freeswitch
RuntimeDirectoryMode=0750
PIDFile=/run/freeswitch/freeswitch.pid
PermissionsStartOnly=true
ExecStart=/usr/bin/freeswitch -nc -nonat
ExecReload=/usr/bin/kill -HUP $MAINPID
TimeoutSec=45s
Restart=always
WorkingDirectory=/run/freeswitch
User=freeswitch
Group=freeswitch
UMask=0007

[Install]
WantedBy=multi-user.target

Рестартуем демон systemd:

# systemctl daemon-reload

Теперь можно запустить сервис freeswitch командой:

# systemctl start freeswitch

# systemctl enable freeswitch

К запущенному сервису Freeswitch можно подключится командой fs_cli

# fs_cli

.=======================================================.
|            _____ ____     ____ _     ___              |
|           |  ___/ ___|   / ___| |   |_ _|             |
|           | |_  \___ \  | |   | |    | |              |
|           |  _|  ___) | | |___| |___ | |              |
|           |_|   |____/   \____|_____|___|             |
|                                                       |
.=======================================================.
| Anthony Minessale II, Ken Rice,                       |
| Michael Jerris, Travis Cross                          |
| FreeSWITCH (http://www.freeswitch.org)                |
| Paypal Donations Appreciated: paypal@freeswitch.org   |
| Brought to you by ClueCon http://www.cluecon.com/     |
.=======================================================.
.=======================================================================================================.
|       _                            _    ____ _             ____                                       |
|      / \   _ __  _ __  _   _  __ _| |  / ___| |_   _  ___ / ___|___  _ __                             |
|     / _ \ | '_ \| '_ \| | | |/ _` | | | |   | | | | |/ _ \ |   / _ \| '_ \                            |
|    / ___ \| | | | | | | |_| | (_| | | | |___| | |_| |  __/ |__| (_) | | | |                           |
|   /_/   \_\_| |_|_| |_|\__,_|\__,_|_|  \____|_|\__,_|\___|\____\___/|_| |_|                           |
|                                                                                                       |
|    ____ _____ ____    ____             __                                                             |
|   |  _ \_   _/ ___|  / ___|___  _ __  / _| ___ _ __ ___ _ __   ___ ___                                |
|   | |_) || || |     | |   / _ \| '_ \| |_ / _ \ '__/ _ \ '_ \ / __/ _ \                               |
|   |  _ < | || |___  | |__| (_) | | | |  _|  __/ | |  __/ | | | (_|  __/                               |
|   |_| \_\|_| \____|  \____\___/|_| |_|_|  \___|_|  \___|_| |_|\___\___|                               |
|                                                                                                       |
|     ____ _             ____                                                                           |
|    / ___| |_   _  ___ / ___|___  _ __         ___ ___  _ __ ___                                       |
|   | |   | | | | |/ _ \ |   / _ \| '_ \       / __/ _ \| '_ ` _ \                                      |
|   | |___| | |_| |  __/ |__| (_) | | | |  _  | (_| (_) | | | | | |                                     |
|    \____|_|\__,_|\___|\____\___/|_| |_| (_)  \___\___/|_| |_| |_|                                     |
|                                                                                                       |
.=======================================================================================================.
Type /help <enter> to see a list of commands
[This app Best viewed at 160x60 or more..]
+OK log level  [7]
freeswitch@pbx.domen.ru>

Выход из консоли командой CTRL+D

Использование Event Socket Library в Freeswitch.

Различные практики.

Общие сведения.

Модуль mod_event_socket представляет собой интерфейс управления FreeSWITCH
По умолчанию прослушивается локальный интерфейс 127.0.0.1, порт 8021.
Пароль для доступа по умолчанию "ClueCon".
Модуль работает в двух режимах inbound и outbound.
В inbound режиме мы подключаемся к Freeswitch с помощью скриптов и выдаем команды / получаем события. В outbound режиме мы должны иметь скрипт-демон, к которому будет подключаться Freeswitch при обработке вызовов.

Включаем возможность работы с сокетами.

# nano /usr/local/freeswitch/conf/autoload_configs/modules.conf.xml
Следующая строчка должна быть раскомментирована:
<load module="mod_event_socket"/>
Затем открываем файл непосредственного конфигурации модуля mod_event_socket:
# nano  /usr/local/freeswitch/conf/autoload_configs/event_socket.conf.xml
Конфиг для приема всех соединений с любого интерфейса на порт 8021 с паролем ClueCon выглядит так:
<configuration name="event_socket.conf" description="Socket Client">
  <settings>
    <param name="nat-map" value="false"/>
    <param name="listen-ip" value="0.0.0.0"/>
    <param name="listen-port" value="8021"/>
    <param name="password" value="ClueCon"/>
    <!--<param name="apply-inbound-acl" value="loopback.auto"/>-->
    <!--<param name="stop-on-bind-error" value="true"/>-->
  </settings>
</configuration>
Рестартуем систему:
# systemctl restart freeswitch.service
Убеждаемся, что порт 8021 слушается системой:
# netstat -ltupn | grep freesw
tcp      0    0 0.0.0.0:8021       0.0.0.0:* LISTEN  9543/freeswitch
tcp      0    0 10.200.16.214:5060 0.0.0.0:* LISTEN  9543/freeswitch
udp      0    0 10.200.16.214:5060 0.0.0.0:*         9543/freeswitch
Не забываем в Iptables прописать дополнительные ip адреса для доступа к сокетам Freeswitch по сети.

Проверяем работу сокетов в режиме inbound с использованием скриптов на PHP.

Для проверки, что сокеты работают, создадим скрипт и запустим его:
# nano /var/www/html/callyshek.php
Содержание файла:
<?php
date_default_timezone_set('Etc/GMT-3');

 $password = "ClueCon";
 $port = "8021";
 $host = "127.0.0.1";

 function event_socket_create($host, $port, $password) {
     $fp = fsockopen($host, $port, $errno, $errdesc) 
       or die("Connection to $host failed");
     socket_set_blocking($fp,false);
     
     if ($fp) {
         while (!feof($fp)) {
            $buffer = fgets($fp, 1024);
            usleep(100); //allow time for reponse
            if (trim($buffer) == "Content-Type: auth/request") {
               fputs($fp, "auth $password\n\n");
               break;
            }
         }
         return $fp;
     }
     else {
         return false;
     }           
 }


 function event_socket_request($fp, $cmd) {
    
     if ($fp) {    
         fputs($fp, $cmd."\n\n");    
         usleep(100); //allow time for reponse
         
         $response = "";
         $i = 0;
         $contentlength = 0;
         while (!feof($fp)) {
            $buffer = fgets($fp, 4096);
            if ($contentlength > 0) {
               $response .= $buffer;
            }
            
            if ($contentlength == 0) { //if contentlenght is already don't process again
                if (strlen(trim($buffer)) > 0) { //run only if buffer has content
                    $temparray = split(":", trim($buffer));
                    if ($temparray[0] == "Content-Length") {
                       $contentlength = trim($temparray[1]);
                    }
                }
            }
            
            usleep(100); //allow time for reponse
            
            //optional because of script timeout //don't let while loop become endless
            if ($i > 10000) { break; } 
            
            if ($contentlength > 0) { //is contentlength set
                //stop reading if all content has been read.
                if (strlen($response) >= $contentlength) {  
                   break;
                }
            }
            $i++;
         }
         
         return $response;
     }
     else {
       echo "no handle";
     }
 }

 $fp = event_socket_create($host, $port, $password);
 $cmd = "api help";
  //$cmd = "show channels";
 $response = event_socket_request($fp, $cmd);
 echo $response; 
 fclose($fp); 
?> 
Запускаем файл так:
# php -f /var/www/html/callyshek.php 
На выход должны получить справочную информацию описания api Freeswitch
Valid Commands:
...,,Shutdown,mod_commands
acl,<ip> <list_name>,Compare an ip to an acl list,mod_commands
alias,[add|stickyadd] <alias> <command> | del [<alias>|*],Alias,mod_commands
banner,,Return the system banner,mod_commands
bg_system,<command>,Execute a system command in the background,mod_commands
bgapi,<command>[ <arg>],Execute an api command in a thread,mod_commands
break,<uuid> [all],uuid_break,mod_commands
cdr_csv,parameters,cdr_csv controls,mod_cdr_csv
chat,<proto>|<from>|<to>|<message>|[<content-type>],chat,mod_dptools
coalesce,[^^<delim>]<value1>,<value2>,...,Return first nonempty parameter,mod_commands
complete,add <word>|del [<word>|*],Complete,mod_commands
cond,<expr> ? <true val> : <false val>,Evaluate a conditional,mod_commands
… <………> …
xml_locate,[root | <section> <tag> <tag_attr_name> <tag_attr_val>],Find some xml,mod_commands
xml_wrap,<command> <args>,Wrap another api command in xml,mod_commands

Библиотека Event Socket Library (ESL)

Библиотека Event Socket Library (ESL) предназначена для использования взаимодействия с Freeswitch в различных языках программирования.
Сборка базовой библиотеки Event Socket Library (ESL):
# yum install libxml2-devel pcre-devel bzip2-devel curl-devel gmp-devel aspell-devel libtermcap-devel gdbm-devel db4-devel 
# cd /usr/local/src/freeswitch/libs/esl/
# make
Затем для включения модулей для конкретных языков программирования выполняем:

Для языка php:
# yum install php-devel
# make phpmod-install
ПРИМЕЧАНИЕ:
Если во время установки возникнет следующая ошибка
esl_wrap.cpp:730:18: фатальная ошибка: zend.h: Нет такого файла или каталога
 #include "zend.h"
                  ^
компиляция прервана.
make[1]: *** [esl_wrap.o] Ошибка 1
make[1]: Выход из каталога `/usr/local/src/freeswitch/libs/esl/php'
make: *** [phpmod] Ошибка 2
Необходимо выполнить следующее:
# cd /usr/local/src/freeswitch
# ./configure
Затем повторяем:
# cd /usr/local/src/freeswitch/libs/esl/
# make phpmod-install
Теперь сборка происходит без ошибок.
Теперь после инсталляции ESL для PHP
Конфигурация библиотеки здесь - /etc/php.d/esl.ini
Модуль ESL прописался в /usr/lib64/php/modules и /usr/share/pear
Файл библиотеки здесь  - /usr/share/pear/ESL.php
Его можно использовать в разработке программ ESL.php

Для языка python:
# yum install python-devel
# make pymod-install
Модуль PYTHON прописался в /usr/lib64/python2.7/site-packages/ESL.py

В заключении рестартуем apache:
# systemctl restart httpd.service

Проверяем работу сокетов в режиме inbound с использованием скриптов на PHP и библиотеки ESL.

Для проверки работы библиотеки ESL в языке php создаем файл /var/www/html/callyshek2.php
# touch /var/www/html/callyshek2.php
Его содержимое будет такое:
<?php
require_once('ESL.php');

if ($argc > 1) {
array_shift($argv);
$command = sprintf('%s', implode(' ', $argv));
printf("Command to run is: %s\n", $command);
$sock = new ESLconnection('127.0.0.1', '8021', 'ClueCon');
$res = $sock->api($command);
printf("%s\n", $res->getBody());
} else {
printf("ERROR: You Need To Pass A Command\nUsage:\n\t%s <command>", $argv[0]);
}?>
Запуск для проверки:
# php -f /var/www/html/callyshek2.php status
На выходе должны получить что-то такое:
Command to run is: status
UP 0 years, 0 days, 2 hours, 13 minutes, 46 seconds, 695 milliseconds, 497 microseconds
FreeSWITCH (Version 1.6.9 git d574870 2016-06-13 18:10:44Z 64bit) is ready
0 session(s) since startup
0 session(s) - peak 0, last 5min 0
0 session(s) per Sec out of max 30, peak 0, last 5min 0
1000 session(s) max
min idle cpu 0.00/99.80
Current Stack Size/Max 240K/8192K

Проверка работы Freeswitch в режиме outbound.

В качестве сокет-сервера для проверки будет выступать утилита netcat.

Для того что бы передать управление внешнему серверу и использовать режим outbound прописываем в плане набора:
  <extension name="call_in">
    <condition field="destination_number" expression="^(8459938103)$|^(9938103)$">
        <action application="socket" data="10.200.16.214:8022 async full"/>
    </condition>
  </extension>
Порт 8021, указанный в конфигурации мы использовать не можем, так как этот порт уже занят самим Freeswitch и не может выступать в качестве порта сокет-сервера. Используем здесь порт 8022.
Затем проводим рестарт:
# systemctl restart freeswitch

Запускаем сервер сокет на порту 8022 и ждем:
# nc -k -v -l 10.200.16.214 8022
Ncat: Version 6.40 ( http://nmap.org/ncat )
Ncat: Listening on 10.200.16.214:8022
При вызове на номер 8459938103 Freeswitch передаст управление сокет-серверу:
Ncat: Connection from 10.200.16.214.
Ncat: Connection from 10.200.16.214:39806.
Вводим в консоли команду connect и два раза ENTER:
# connect\n\n
Получаем ответ от сервера с данными о поступившем вызове:
Event-Name: CHANNEL_DATA
Core-UUID: 77af8caf-af88-42ab-81ed-b7287794de01
FreeSWITCH-Hostname: callpeg.svttk.ru
FreeSWITCH-Switchname: callpeg.svttk.ru
FreeSWITCH-IPv4: 10.200.16.214
FreeSWITCH-IPv6: %3A%3A1
Event-Date-Local: 2016-07-13%2017%3A11%3A07
Event-Date-GMT: Wed,%2013%20Jul%202016%2014%3A11%3A07%20GMT
Event-Date-Timestamp: 1468419067842618
Event-Calling-File: mod_event_socket.c
Event-Calling-Function: parse_command
Event-Calling-Line-Number: 1996
….<….>….
variable_endpoint_disposition: DELAYED%20NEGOTIATION
variable_DP_MATCH: ARRAY%3A%3A8469938103%7C%3A8469938103
variable_call_uuid: ae37202f-c4ab-41dd-b109-8fde03c56223
variable_current_application_data: 10.200.16.214%3A8022%20async%20full
variable_current_application: socket
variable_socket_host: 10.200.16.214
Content-Type: command/reply
Reply-Text: %2BOK%0A
Socket-Mode: async
Control: full
Значит все работает.

Проверка работы Freeswitch в режиме outbound с использованием сокет-сервера на PYTHON.

Создадим файл servcall.py на основе примера, имеющегося в дистрибутиве ESL:
/usr/local/src/freeswitch/libs/esl/python/server.py
Содержимое файла:
#!/usr/bin/env python
# -*- coding: utf-8 -*-
import SocketServer
from ESL import *

class ESLRequestHandler(SocketServer.BaseRequestHandler ):
def setup(self):
print self.client_address, 'connected!'

fd = self.request.fileno()
print fd

con = ESLconnection(fd)
print "Connected: ", con.connected()
if con.connected():

info = con.getInfo()

uuid = info.getHeader("unique-id")
print uuid
con.execute("answer", "", uuid)
con.execute("playback", "ttk/fon.wav", uuid);

#server host is a tuple ('host', port)
server = SocketServer.ThreadingTCPServer(('10.200.16.214', 8022), ESLRequestHandler)
server.serve_forever()
В этом файле описывается логика работы сервера. Сервер запускается и прослушивает Ip 10.200.16.214 и порт 8022. При установлении соединения, запрашивается информация о соединении и серверу Freeswitch дается команда проигрывать абоненту звуковой файл ttk/fon.wav.
Файл должен быть помещен в папку: /usr/local/freeswitch/sounds/en/us/callie/ttk/ (папка ttk должна быть создана).
Для работоспособности схемы, необходимо запустить сервер командой:
# ./servcall.py

Вывод событий Freeswitch в stdout linux, используя ESL и PYTHON и подключаясь к Freeswitch в режиме inbound.

В дистрибутиве ESL Freeswitch существует скрипт-сервер, написанный на PYTHON, который подключается к серверу, подписывается на события и выводит все поступившие события в консоль. Скрипт лежит здесь - /usr/local/src/freeswitch/libs/esl/python/events.py
На его основе создадим свой файл-скрипт-сервер events2.py.
Содержимое файла:
#!/usr/bin/env python
# -*- coding: utf-8 -*-
import string
import sys

from ESL import *

con = ESLconnection("127.0.0.1","8021","ClueCon")
#are we connected?

if con.connected:

  con.events("plain", "all");

  while 1:
  #my $e = $con->recvEventTimed(100);
    e = con.recvEvent()

    if e:
      print e.serialize()
При запуске этого скрипта все, произойдет подключение к Freeswitch на ip 127.0.0.1 и порт 8021. Устанавливается режим получения сообщений – plain. Параметр all говорит о том, что мы хотим получать все сообщения. Затем все полученные события будут выводиться в консоль.
Пример:
#./events2.py
При поступлении вызова мы увидим множество сообщений:
Event-Name: HEARTBEAT
…
Event-Name: RE_SCHEDULE
…
Event-Name: CHANNEL_STATE
…
Event-Name: CHANNEL_CALLSTATE
…
Event-Name: PRESENCE_IN
…
Event-Name: CHANNEL_EXECUTE
…
Event-Name: API
…
Event-Name: CHANNEL_OUTGOING
…
Event-Name: CHANNEL_CREATE
…
Event-Name: CHANNEL_ORIGINATE
…
Event-Name: CHANNEL_PROGRESS
…
Event-Name: CHANNEL_HANGUP
…
Event-Name: CHANNEL_EXECUTE_COMPLETE
…
Event-Name: CHANNEL_HANGUP_COMPLETE
…
Event-Name: CHANNEL_DESTROY
…