====== Пример настройки АТС Asterisk ======

<note tip>Эта инструкция **НЕ подходит для АТС Askozia / FreePBX / MyPBX**. </note>

<note warning>При настройке Unix машин, нужны соответствующие навыки. Предполагается, что исполнитель инструкций обладает пониманием и опытом настройки подобных серверов.</note>
<note tip>**Рекомендуем взять дистрибутив** [[http://www.turnkeylinux.org/lampstack|TurnKey LAMP Stack]].\\ 
**При использовании прочих дистрибутивов текущие инструкции могут не подойти**.
 
Будте внимательны, изучайте скрипы прежде чем их запускать. </note>
Для начала работ необходимо загрузить архив [[ http://files.miko.ru/public.php?service=files&t=c4a11b393f793970ff23c0e5790a3fe7 |dialplan_miko_ajam v2.5]], для примера возьмем директорию **/usr/src/**.

<note warning>
**Требуемые пакеты**:
  * PHP 5.3.10 / 7.0.22
  * Для PHP должен быть доступен модуль mysqli / mysql
  * MySQL mysql  Ver 15.1 Distrib 10.0.31-MariaDB
  * Apache 2.4.18
  * unixODBC
  * SoX v14.4.0
  * GPL Ghostscript 9.10
  * spandsp
  * Asterisk 1.8+
</note>

<note warning>Обязательно **выполняйте резервное копирование** перед работами!</note>
===== Подготовка окружения =====

Запускаем на исполнение скрипт **dialplan_miko_ajam/install_scripts/create_db.sh**
<code>cd /usr/src/dialplan_miko_ajam;
sh install_scripts/create_db.sh username password</code>

  * **username** - имя пользователя MySql.
  * **password** - пароль пользователя MySql.

После этих действий будет создана база данных с именем **asteriskcdrdb**. В базе данных будут созданы две таблицы **PT1C_cdr** и **cel**. При создании обязательно выполняется проверка "IF NOT EXISTS".

Опубликуем скрипты на web сервере 
<code>mkdir /var/www/admin;
mkdir -p /var/spool/asterisk/fax/;
cd /usr/src/dialplan_miko_ajam;
cp -R 1c /var/www/admin;</code>
Назначение скриптов:
  * "**1c/cdr_xml/index.php**" - получение истории звонков для модуля "Расширенный журнал звонков". 
  * "**1c/cel_xml/index.php**" - получение **расширенной** истории звонков для модуля "Расширенный журнал звонков". 
  * "**1c/download/index.php**" - скачивание с АТС файла записи разговора. 
  * "**1c/upload/index.php**" - загрузка на АТС файла факса в PDF / TIFF формате.

После этих действие указанные ресурсы должны быть опубликованы на сервере, в моем случае на порту 80.
Для проверки просто откройте ссылку:
<code>http://ip_adress_asterisk:80/admin/1c/upload/index.php</code>  
Получите ответ:
<code>Upload failed. File not found!</code>
Это вполне нормальный ответ. Для реальной проверки загрузки файла факса следует использовать команду:
<code>curl -F "file=@virtualfax.pdf" 'http://ip_adress_asterisk:80/admin/1c/upload/index.php'</code>
Должны существовать директории:
  * "**/tmp/**" - для временных файлов. Web сервер должен иметь права на чтение / запись. 
  * "**/var/spool/asterisk/fax/**" - директория файлов факсов. Web сервер должен иметь права на чтение / запись. Asterisk должен иметь правка на чтение. 
В текущей директории должен лежать файл **virtualfax.pdf**. В случае успеха будет выведено сообщение:
<code>File virtualfax.pdf upload success.</code>

<note important>Обратите внимание: ресурс "**80/admin/1c/upload/index.php**" используется как параметр **FaxSendUrl** в приложении dailplan [[astpanel:ats:asterisk:environments_v6| 10000111]] и возвращается в 1С с прочими настройками.</note>

<note important>Обратите внимание: ресурс "**80/admin/1c/download/index.php**" используется как параметр  **${port}/${path}** в приложении dailplan [[astpanel:ats:asterisk:download_file_v6|10000666]].</note>
===== Установка Asterisk =====

Пример установки для Debian 7 описан в скрипте "**install_scripts/debian_asterisk_install.sh**".
После установки Asterisk необходимо установить AGI скрипты:
<code>cd /usr/src/dialplan_miko_ajam;
cp -R agi-bin/* /var/lib/asterisk/agi-bin;
# chown -R asterisk:asterisk /var/run/asterisk; chmod +x /var/run/asterisk/*</code>

Примеры конфигурационный файлов следует смотреть в директории "**test_sample_configs**". \\
Один из важнейших файлов - "**extensions.conf**", в нем описывается служебный dialplan, необходимый для работы панели телефонии.\\
[[astpanel:dialplan_miko_ajam:configs|Перейти к описанию конфигурационный файлов.]]

Для работы Asterisk из под non-root пользователя можно использовать скрипт "**install_scripts/ast_run_nonroot_user.sh**".\\
Скрипт создает пользователя **asterisk**, назначает права и владельца на файлы / директории Asterisk, формирует файл **/etc/asterisk.conf**.
<code>cd /usr/src/dialplan_miko_ajam;
sh install_scripts/ast_run_nonroot_user.sh</code>
===== Настройка ODBC =====

[[doc:1cajam:astcastomize_v6:odbc|Пример настроек **MySQL через ODBC**]]\\

<file - odbc.ini> 
; настройка соединения
[MySQL-asteriskcdrdb]
Driver          = MySQL
Description     = MySQL connection to 'asteriskcdrdb' database
Server          = localhost
Port          = 3306
Database     = asteriskcdrdb
Option          = 3
</file>

<file - odbcinst.ini> 
[MySQL]
Description		= MySQL driver
Driver		= libmyodbc.so
Setup		= libodbcmyS.so
CPTimeout		= 
CPReuse		= 
UsageCount		= 1
</file>


===== Обязательно ознакомьтесь с описанием "Приложений" =====
  * [[ :astpanel:ats:Asterisk_v6|IP АТС Asterisk (универсальная v6)]]\\
===== Коментарии =====
~~DISQUS~~