Я жажду решать большие и выдающиеся задачи, но представлять скромные задачи так, как будто они большие и выдающиеся, является обязанностью моего шефа. Мир продвигается вперед не только мощными рывками его героев, но и скромными усилиями всех честных тружеников.
В предыдущей главе мы обсудили подготовку системы к установке Asterisk. Пора браться за дело!
Asterisk можно устанавливать на многих дистрибутивах Linux[45] и различных архитектурах ПК, но в данной книге было решено сосредоточиться на одном продукте, чтобы избежать путаницы и неясностей. Мы сделали рекомендации максимально универсальными, но все равно можно заметить тяготение к структуре папок и системе утилит CentOS. CentOS (вероятно, самый популярный дистрибутив, используемый с Asterisk) был выбран потому, что его набор команд, структура папок и пр. хорошо знакомы большему числу читателей (мы обнаружили, что многие администраторы Linux знают CentOS, даже если предпочитают другой дистрибутив). Это не означает, что CentOS является единственным или даже лучшим выбором. В рассылках часто задают вопрос: «Какой дистрибутив Linux лучше всего использовать с Asterisk?» Все многообразие ответов обычно сводится к следующему: «Тот, который вам больше нравится»[46].
Большинство конфигураций Asterisk включают три основных пакета: основная программа Asterisk (asterisk), драйверы телефонии (zaptel) и PRI-библиотеки (libpri). Если планируется исключительно VoIP-сеть, единственным обязательным пакетом является asterisk, но мы рекомендуем устанавливать все три пакета; какие модули активировать - можно выбрать позже. Драйверы zaptel необходимы, если используется аналоговое или цифровое оборудование или если источником временных интервалов служит драйвер ztdummy (обсуждается в данной главе позже). Библиотека libpri обязательна, только если используются PRI- интерфейсы ISDN. Можно не загружать эту библиотеку в оперативную память и сохранить небольшой объем свободного места, но мы рекомендуем установить ее вместе с пакетом zaptel для полноты. В первом издании данной книги рекомендовалось устанавливать дополнительный пакет asterisk-sounds. Это был отдельный архив, который надо было скачать, извлечь из архива и затем установить. Теперь для Asterisk версии 1.4.0 существует два набора пакетов звуковых файлов: Core Sound и Extra Sound. Поскольку Asterisk поддерживает несколько разных аудиоформатов, эти пакеты доступны в различных звуковых форматах, таких как G.729 и GSM. Основанием для существования такого разнообразия форматов является обеспечение Asterisk возможности использовать тот звуковой формат, для которого требуется меньшее количество преобразований в ЦП. Например, если имеется большое количество соединений, поступающих по каналам VoIP, которые используют GSM, выгоднее иметь звуковые файлы в формате GSM. В окне выбора компонентов сборки (обсуждается в данной главе позже) можно выбрать один или более из предлагаемых типов звуковых файлов. Рекомендуем установить по крайней мере по одному типу из каждого пакета (Core Sound и Extra Sound). Поскольку в данной книге могут упоминаться некоторые файлы Extra Sound, предполагается, что установлен хотя бы один из этих форматов.
Для компиляции Asterisk в системе должен иметься компилятор GCC (версия 3.x или более поздняя) и все необходимые зависимости. Также для Asterisk требуется bison, программный генератор грамматического разбора, который заменяет yacc, и ncurses для обеспечения функциональности командной строки. Криптографическая библиотека в Asterisk требует наличия OpenSSL и его пакетов для разработки.
Для Zaptel необходима библиотека libnewt и ее пакеты для разработки, чтобы обеспечить компиляцию программы zttool (см. в данной главе раздел «Использование ztcfg и zttool»). Если используются PRI-интер- фейсы, Zaptel также требует установки пакета libpri (опять же, даже если линии PRI не используются, мы рекомендуем установить libpri вместе с zaptel).
Если пакеты Software Development устанавливаются на CentOS, все эти инструменты будут в наличии. Если вы стремитесь к порядку и желаете установить набор программ, только минимально необходимый для компиляции Asterisk и связанных с ней пакетов, обратитесь к табл. 3.1.
В следующей таблице использование ключа -у для приложения yum означает ответ «да» на все вопросы и обеспечит установку приложения и всех зависимостей без вывода этих вопросов на экран. Если это нежелательно, ключ -у должен быть опущен.
Если требуется установить сразу все вышеупомянутые пакеты, в командной строке можно указать несколько пакетов, например:
# yum install -у gcc ncurses-devel libtermcap-devel [...]
Таблица 3.1. Список пакетов, необходимых для компиляции libpri, zaptel и asterisk
Имя пакета | Команда установки | Примечание | Используется программами |
GCC 3.x | yum install -y gcc | Необходим для компиляции zaptel, libpri и asterisk | libpri, zaptel, asterisk |
ncurses-devel | yum install -y ncurses-devel | Необходим для menuselect | menuselect |
libtermcap-devel | yum install -y libtermcap-devel | Необходим для asterisk | asterisk |
Kernel | yum install -y kernel-devel | Необходим для компиляции zaptel | zaptel |
Development | |||
Headers | |||
Kernel Development Headers (SMP) | yum install -y kernel-smp-devel | Необходим для компиляции zaptel | zaptel |
GCC C++ 3.x | yum install -y gcc-c++ | Необходим для asterisk | asterisk |
OpenSSL (необязательный) | yum install -y openssl-devel | Зависимость OSP, шифрование IAX2, res_crypto (поддержка RSA- ключа) | asterisk |
Имя пакета | Команда установки | Примечание | Используется программами |
newt-devel | yum install -y | Зависимость zttool | zaptel |
(необязательный) | newt-devel | ||
zlib-devel | yum install -y | Зависимость | asterisk |
(необязательный) | zlib-devel | DUNDi | |
unixODBC; | yum install -y | Зависимость func_ | asterisk |
unixODBC-devel | unixODBC-devel | odbc, cdr_odbc, | |
(необязательный) | res_config_odbc, | ||
res odbc, | |||
ODBC_STORAGE | |||
libtool | yum install -y | Зависимость | asterisk |
(необязательный; | libtool | связанных с ODBC модулей | |
рекомендуемый) | |||
GNU make | yum install -y | Необходим для компиляции | asterisk |
(версия 3.80 или более поздняя)* | make | zaptel и asterisk |
Обычной ошибкой тех, кто впервые устанавливает какой-либо дистрибутив Linux, является использование программы GNU make версии 3.79 или еще более ранней. Следует учесть, что правильно сборка Asterisk может быть выполнена только при наличии версии GNU make не ниже 3.80.
Лучше всего взять исходный код для Asterisk и его пакетов прямо на веб-сайте http://www.asterisk.org или FTP-сервере.
*
Проще всего получить самую последнюю выпущенную версию с помощью программы wget.
Кодовая база Asterisk находится в процессе постоянного изменения. Для управления ею разработчики используют инструмент контроля версий Subversion (SVN)[47]. Subversion обеспечивает сообществу разработчиков возможность совместной работы над сложными проектами программного обеспечения. Существует две основных области разработки Asterisk: ветвь (Branch) и ствол (Trunk). В ствол добавляются новые функции, вносятся изменения в архитектуру и всевозможные нововведения. Это та часть кодовой базы, где содержатся все новые элементы, но которая может в любой момент оказаться в нерабочем состоянии. Ее категорически нельзя использовать для производственной эксплуатации (см. рисунок).
Подобно дереву, ствол имеет ветви. Эти ветви пронумерованы соответственно основным редакциям, например 1.0, 1.2 и 1.4 (в будущем мы, скорее всего, увидим 1.6, 1.8, 1.8.2, 1.8.4. 1.8.6, 1.8.8. 1.8.8.2... м-м... и т.д...). В ветви не вносятся большие архитектурные изменения или новые функции, здесь просто исправляются дефекты и выполняются работы по обеспечению безопасности. В среде производственной эксплуатации стабильность намного важнее, чем введение новых функциональных возможностей. Примерно каждые 14 месяцев (хотя Asterisk не следует формальному графику выпуска версий, как многие пакеты коммерческого программного обеспечения) выпускается версия Asterisk, предназначенная для использования в средах производственной эксплуатации. Начальная версия Asterisk шла под номером 1.0 и была представлена на самой первой конференции AstriCon в Атланте в сентябре 2004 года. Asterisk 1.2 была выпущена на IP4IT в ноябре 2005, а Asterisk 1.4 вышла в декабре 2006.
Обратите внимание, что извлекать из архива и компилировать исходный код Asterisk мы будем в папке /usr/src/, хотя некоторые системные администраторы, возможно, предпочитают использовать /usr/ local/src. Также помните, что для записи файлов в папку /usr/src/ и установки Asterisk и сопутствующих ей пакетов, необходимо иметь права администратора.
В главе 13 можно найти информацию о том, как запустить Asterisk, не будучи администратором. Все специалисты по безопасности рекомендуют запускать свои программы-демоны под учетной записью, не дающей права администратора, на случай возможного проникновения в систему вредоносного кода. Это снизит (но, конечно же, не устранит) риск похищения пароля для пользователя с правами администратора.
Чтобы получить самую последнюю выпущенную версию исходного кода с помощью wget, в командной строке необходимо ввести следующие команды:
# cd /usr/src/
# wget http://downloads.digium.com/pub/asterisk/asterisk-1.4-current.tar.gz
# wget http://downloads.digium.com/pub/libpri/libpri-1.4-current.tar.gz
# wget http://downloads.digium.com/pub/zaptel/zaptel-1.4-current.tar.gz
Последние версии пакетов asterisk, libpri и zaptel вполне могут идти под разными номерами.
И наоборот, при разработке и тестировании, вероятно, вы захотите иметь код самой новой ветви. Чтобы извлечь этот код из SVN, выполните следующую команду:
# svn co http://svn.digium.com/svn/asterisk/branches/1.4 asterisk-1.4 Если исходный код получен в виде файлов выпущенной версии, размещенных на FTP-сервере Digium, перед компиляцией эти файлы необходимо извлечь из архива, о чем рассказывается в следующем разделе.
Пакеты, загружаемые с FTP-сервера, являются архивами, в которых содержится исходный код; таким образом, перед компиляцией код требуется извлечь из архива. Если пакеты загружены в другую папку, не /usr/src/, их надо или перенести туда или указать полный путь к ним. Для извлечения исходного кода из архива мы будем использовать GNU-приложение tar. Это простой процесс, который выполняется с помощью следующих команд:
# cd /usr/src/
# tar zxvf zaptel-1.4-current.tar.gz
# tar zxvf libpri-1.4-current.tar.gz
# tar zxvf asterisk-1.4-current.tar.gz
В bash (и других командных оболочках, поддерживающих ее) можно использовать исключительно удобную функцию автозаполнения по нажатию клавиши Tab. Это позволяет вводить лишь часть имени файла, а все остальное система дополняет автоматически. Например, если введено tar zxvf zap
Выполнение этих команд обеспечит извлечение пакетов и исходного кода из архивов в соответствующие папки. Например, файл asterisk- 1.4-current.tar.gz будет извлечен в папку текущей версии Asterisk, то есть asterisk-1.4.4.
Желательно всегда сохранять исходный код последней рабочей версии пакета на случай необходимости выполнить «откат» при обнаружении очередного дефекта или странностей в поведении, которые не получается сразу разрешить.
В Asterisk версии 1.4.0 и связанных с ней пакетах была реализована новая система сборки autoconf. Это немного изменило процесс сборки, но предоставило больше гибкости, позволив выбирать модули, подлежащие сборке. Преимущество состоит в том, что в сборке участвуют только необходимые модули, а не весь исходный код. Вместе с системой сборки была введена новая система выбора на основе меню. Спасибо Расселу Брайанту (Russell Bryant). Эта новая система обеспечивает возможность более детального отбора подлежащих сборке модулей перед компиляцией ПО и избавляет пользователя от необходимости редактировать файлы Makefiles. Поэтому, чтобы не рассказывать, как использовать окно выбора компонентов сборки в каждом разделе «Компиляция.», обсудим это здесь, чтобы, увидев опцию make menuselect, вы знали, что должны делать с окном выбора компонентов сборки.
На рис. 3.1 представлено окно выбора компонентов сборки для программного обеспечения Asterisk. Для других пакетов оно будет прак-
*************************************
Asterisk Module Selection *************************************
Press 'h' for help.
-> l. Applications
# Call Detail Recording
# Channel Drivers
# Codec Translators
# Format Interpreters
# Dlalplan Functions
# PBX Modules
# Resource Modules
# Voicemail Build Options 1Э. Compiler Flags
# Module Embedding
# Core Sound Packages
# Music On Hold File Packages
# Extras Sound Packages
Рис. 3.1. Пример окна выбора компонентов сборки
тически таким же, но с меньшим количеством опций. Перемещение вверх и вниз по списку осуществляется с помощью клавиш со стрелками. Выбор опции меню выполняется по нажатию клавиши Enter или клавиши со стрелкой вправо. Для отмены выбора используется клавиша со стрелкой влево.
Рис. 3.2. Список модулей, подлежащих сборке
На рис. 3.2 показан список возможных приложений диалплана, сборка которых может быть выполнена для их использования в Asterisk. Модули, подлежащие сборке, отмечаются символами [*]. Модуль, сборка которого выполняться не будет, отмечается символами [ ]. Если перед модулем стоят символы XXX, значит, присутствуют не все зависимости пакета, которые являются обязательным условием для сборки данного модуля. На рис. 3.2 мы видим, что сборка модуля app_flash не может быть выполнена из-за отсутствия зависимости Zaptel (то есть модуль Zaptel не был собран и установлен в систему с момента последнего вы- полненения команды ./configure). Если требования по зависимости были удовлетворены в период после последнего выполнения команды . /configure, выполните ее снова и повторно откройте окно выбора компонентов сборки. Теперь модуль должен быть доступным для сборки. Завершив работу с окном выбора компонентов сборки, введите символ x, чтобы сохранить изменения и закрыть окно. Ввод символа q также обеспечит выход из окна выбора компонентов сборки, но при этом изменения не будут сохранены. Если вы внесли изменения и ввели q, ваши изменения будут потеряны!
На рис. 3.3 показаны уровни взаимодействия между Asterisk и ядром Linux с точки зрения управления аппаратными средствами. Со стороны Asterisk имеется модуль канала Zapata, chan_zap. Asterisk использует этот интерфейс для обмена информацией с ядром Linux, где загружаются драйверы устройств.
Интерфейс Zaptel - это загружаемый модуль ядра, представляющий абстрактный уровень между аппаратными драйверами и модулем Zapata в Asterisk. Именно такая концепция позволяет изменять драйверы устройств без внесения изменения в исходный код Asterisk. Драйверы устройств используются для непосредственной связи с оборудованием и для передачи информации между Zaptel и аппаратными средствами.
Хотя Asterisk может компилироваться на разных платформах, драйверы Zaptel специализированы для конкретных дистрибутивов Linux, они создаются для взаимодействия непосредственно с ядром Linux. Существует проект (http:// www.solarisvoip.com), обеспечивающий поддержку Zaptel для Solaris. Также есть проект разработки драйверов Zapata для BSD. Его можно найти по адресу http://www.voip-info. org/tiki-index.php?page=FreeBSD+zaptel.
Рис. 3.3. Уровни взаимодействия устройств с Asterisk
Начнем наше обсуждение с драйвера ztdummy, который используется в системах, нуждающихся в интерфейсе синхронизации, но не имеющих соответствующего оборудования. Затем перейдем к компиляции и установке драйверов. (Конфигурация драйверов Zaptel будет обсуждаться в следующей главе.)
Перед компиляцией драйверов Zaptel в системе, выполняющей ядро Linux 2.4, необходимо убедиться в наличии в папке /usr/src/ символической ссылки linux-2.4, указывающей на исходный код используемого ядра. Если символической ссылки нет, ее можно создать с помощью следующей команды (предполагая, что исходный код размещен в папке /usr/src/): # ln -s /usr/src/'uname -r' /usr/src/linux-2.4 Обычно, если на компьютере выполняется один из дистрибутивов на базе ядра Linux 2.6, символическая ссылка не требуется, поскольку эти дистрибутивы осуществляют поиск папки сборки ядра автоматически. Однако, если папка сборки помещена в нестандартное место (то есть не в папку /lib/modules/ <версия ядра>/build/), потребуется использовать символическую ссылку.
Хотя Asterisk и сопутствующие пакеты выполняются на ядрах Linux 2.4.x, их разработка ведется прежде всего на ядрах 2.6.x, и нет никакой гарантии, что ядра 2.4.x будут поддерживаться в будущем.
Определенные приложения и функции Asterisk для работы требуют наличия устройства синхронизации (Asterisk даже не скомпилирует их, если не найдет такое устройство). Все PCI-устройства производства Digium обеспечивают интерфейс синхронизации с частотой 1 кГц, что соответствует этому требованию. Если необходимых для обеспечения синхронизации PCI-устройств нет, в качестве устройства синхронизации может использоваться драйвер ztdummy. В дистрибутивах на базе ядра Linux 2.4 ztdummy должен использовать синхронизирующие сигналы, обеспечиваемые контроллером UHCI USB.
Многие более старые (и некоторые новые) системы используют чип контроллера OHCI USB, несовместимый с ztdummy. Однако, если используется ядро 2.6, неважно, какой чип контроллера USB применяется в системе.
Драйвер проверяет, загружен ли модуль usb-uhci и не является ли версия ядра ниже 2.4.5. Более старые версии ядра несовместимы с ztdummy. В дистрибутиве на базе ядра 2.6 ztdummy не требует применения USB- контроллера. (Теперь ядро версии 2.6.0 генерирует синхронизирующие сигналы частотой 1 кГц[48], которые драйвер может использовать для согласования; таким образом, аппаратный USB-контроллер больше не нужен.)
Компиляция драйверов телефонии Zapata для использования с оборудованием Digium проста; однако из-за различия сред сборки в версиях 1.2 и 1.4 для этого применяются немного разные методы. Сначала необходимо выполнить команду . /configu re, чтобы определить, какие приложения и библиотеки установлены в системе. Это позволит гарантировать наличие всего необходимого для сборки Zaptel. Выполнение следующих команд обеспечит сборку Zaptel и его модулей:
# cd /usr/src/zaptel-version
# make clean
# ./configure
# make menuselect
# make
# make install
Команда make clean не всегда является обязательной, но лучше выполнять ее перед повторной компиляцией любых модулей, поскольку она удалит скомпилированные двоичные файлы из папки исходного кода. Также ее можно использовать для очистки после установки, чтобы избавиться от двоичных файлов. Обратите внимание, что выполнение данной команды обеспечит удаление двоичных файлов только из папки исходного кода, не из системы.
Кроме исполняемых файлов, make clean удаляет также промежуточные файлы (то есть объектные файлы) после компиляции. Они не нужны и только занимают место на жестком дис-В системе, в которой используются папки /etc/rc.d/init.d/ или /etc/ init.d/ (это такие системы, как CentOS и другие дистрибутивы на базе Red Hat), можно выполнить также команду make config. Это обеспечит установку сценариев запуска и конфигурирование системы. С помощью команды chkconfig задается автоматическая загрузка модуля zaptel при запуске:
# make config
Эквивалент команды chkconfig в Debian - update-rc.d. Хотя Digium официально поддерживает только Zaptel для Linux, следует упомянуть несколько проектов по переносу Zaptel на другие платформы:
Solaris (http://www.solarisvoip.com).BSD (http://lists.digium.com/mailman/listinfo/asterisk-bsd).
Вместе с Zaptel устанавливаются еще две программы, ztcfg и zttool. Программа ztcfg считывает данные из папки /etc/zaptel.conf для конфигурации аппаратных средств. Программа zttool поможет проверить статус установленного оборудования. Например, если используется плата T1 и между конечными точками не установлена связь, пользователь увидит красный предупреждающий сигнал. Если все конфигурировано правильно и связь возможна, будет выведено сообщение «ОК». Приложение zttool также полезно для аналоговых плат, потому что сообщает об их текущем состоянии ^конфигурирована, с подключенной линией и т. д.). Использование этих программ будет подробно рассмотрено в следующей главе.
Компиляция zttool невозможна, если не установлены библиотеки libnewt и их пакеты для разработки (newt-devel в дистрибутивах на базе Red Hat).
Приложения ztcfg и zttool и другие полезные утилиты располагаются в разделе Utilities (Утилиты) окна выбора компонентов сборки Zaptel.
Для библиотек libpri не используется программа autoconf для настройки среды сборки или окно выбора компонентов сборки, поскольку они не нужны; таким образом, установка упрощается. libpri применяется различными производителями аппаратных средств мультиплексирования с разделением по времени (Time Division Multiplexing, TDM), но даже если такое оборудование не установлено, эту библиотеку можно компилировать и устанавливать. libpri должна быть скомпилирована и установлена перед установкой Asterisk, поскольку она используется при его компиляции. Вот необходимые команды (вместо версия необходимо указать используемую версию libpri):
# cd /usr/src/libpri-версия
# make clean
# make
# make install
После компиляции и установки пакетов zaptel и libpri (если они нужны), можно переходить к установке Asterisk. В этом разделе рассматривается стандартная установка и представлены некоторые альтернативные аргументы make, которые могут пригодиться.
Компиляция Asterisk выполняется с помощью компилятора gcc посредством использования GNU-программы make. Чтобы начать компиляцию Asterisk, просто выполните следующие команды (вместо версия необходимо указать используемую версию Asterisk).
# cd /usr/src/asterisk-версия
# make clean
# ./configure
# make menuselect
# make install
# make samples
Помните, что время компиляции в разных системах может быть различным. На процессорах современного поколения это не должно занять более пяти минут. На сайте AstriCon (http://www.astricon.net) есть сообщение об успешной компиляции Asterisk на процессоре Pentium с частотой 133 МГц, но это заняло около пяти часов. Считайте сами. Выполнение команды make samples обеспечивает установку стандартных конфигурационных файлов. Ее использование (вместо конфигурации каждого файла вручную) позволит намного быстрее установить и подготовить систему Asterisk к работе. Многие значения по умолчанию нет необходимости изменять, они обеспечивают нормальную работу Asterisk. Файлы, требующие редактирования, будут рассмотрены в следующих главах.
Если в папке /etc/asterisk/ уже есть конфигурационные файлы, при выполнении команды make samples к имени каждого из них будет добавлено в конце расширение .old, например, файл extensions.conf будет переименован в extensions.conf.old. Однако будьте осторожны, потому что повторное выполнение команды make samples приведет к перезаписи исходных конфигурационных файлов!
Образцы конфигурационных файлов также можно найти в под- папке configs/ папки Asterisk sources.
Для систем, которые используют папки /etc/rc.d/init.d/ или /etc/init.d/, также желательно выполнить команду make config. Это обеспечит установку сценариев запуска и конфигурацию системы (с помощью команды chkconfig) для автоматического выполнения Asterisk при запуске: # make config
Существует еще несколько дополнительных аргументов make, которые могут передаваться во время компиляции. Некоторые из них обсуждаются здесь, но остальные используются внутри файла и на самом деле не имеют никакого значения или практической пользы для конечного пользователя. (Конечно, могут быть введены новые функции, поэтому не забывайте просматривать Makefile.) Давайте рассмотрим некоторые полезные аргументы make.
make clean
Команда make clean используется для удаления скомпилированных двоичных файлов из папки исходного кода. Эта команда должна выполняться перед повторной компиляцией или если требуется удалить некоторые файлы в случае недостатка места на жестком диске.
make distclean
Команда make distclean используется для удаления скомпилированных двоичных файлов и для приведения папки исходного кода в начальное состояние, в каком она была после извлечения из архива.
make update
Команда make update используется для замены существующего кода на обновленный код с SVN-сервера Digium. Если исходный код был загружен с FTP-сервера, будет получено уведомление об этом.
make webvmail
Сценарий Asterisk Web Voicemail используется для предоставления графического интерфейса, предназначенного для управления учетной записью голосовой почты, что позволяет взаимодействовать с голосовой почтой удаленно с веб-броузера.
При выполнении команды make webvmail в папку cgi-bin/ вашего HTTP- сервера будет помещен сценарий Asterisk Web Voicemail. Если имеются специальные политики безопасности, необходимо учитывать, что эта программа использует сценарий на Perl setuid root. Установка будет выполнена только в CentOS или Fedora, поскольку в других дистрибутивах путь к папкам cgi-bin/ может быть иным. (Конечно, это можно изменить. На момент написания данной книги для этого необходимо было отредактировать переменную HTTP CFGDIR в строке 133
Makefile.)
make progdocs
По команде make progdocs с помощью программы doxygen из комментариев, внесенных в исходный код разработчиком, будет создана документация. Чтобы это было возможным, в системе должна быть установлена соответствующая программа doxygen. Заметьте, doxygen предполагает, что исходный код хорошо документирован, а это, к сожалению, не всегда так, хотя за последнюю пару лет было опубликовано очень много материалов по этому вопросу! Информация, содержащаяся в системе doxygen, будет полезна только разработчикам.
make config
По команде make config в папки /etc/rc.d/init.d или /etc/init.d, если таковые будут обнаружены, устанавливаются сценарии запуска в стиле дистрибутива Red Hat. Если эти папки существуют, сценарии устанавливаются с правами доступа к файлам 755. Если сценарий определяет, что папка /etc/rc.d/init.d/ существует, выполняется также команда chkconfig --add asterisk, по которой Asterisk будет добавлена в список автозагрузки. Однако в дистрибутивах, использующих только папку /etc/init.d/, этого сделано не будет. Выполнение команды make config никак не повлияет на уже запущенный процесс Asterisk, но запустит его, если он еще не выполняется.
В настоящее время этот сценарий полезен только в системе на базе Red Hat, хотя в папке ./contrib./init.d/ папки исходного кода Asterisk можно найти сценарии запуска и для других дистрибутивов (таких, как Gentoo, Mandrake и Slackware).
Задокументированный процесс установки Asterisk предполагает, что пользователь самостоятельно компилирует исходный код. Однако некоторые дистрибутивы Linux (такие, как Debian) включают предварительно скомпилированные двоичные файлы Asterisk. При наличии таких двоичных файлов пользователи могли бы устанавливать Asterisk с помощью диспетчеров пакетов, которые предоставляются такими дистрибутивами (например, apt-get для Debian и portage для Gentoo[49]). Но можно заметить, что многие из этих предварительно скомпилированных двоичных файлов довольно устаревшие и не соответствуют новейшим разработкам Asterisk.
Наконец, действительно существуют основные предварительно скомпилированные двоичные файлы Asterisk, которые можно загрузить и установить на любом выбранном дистрибутиве Linux. Однако применение таких двоичных файлов на самом деле не сэкономит много времени. Кроме того, мы пришли к выводу, что компиляция Asterisk при каждой установке не является слишком обременительной задачей. Мы верим, что лучший способ установки Asterisk - компиляция из исходного кода, поэтому в данной книге не уделяется много внимания предварительно скомпилированным двоичным файлам. Кроме того, разве вы не хотите быть 133[50]? В следующей главе будет рассмотрено, как с нуля конфигурировать Asterisk и несколько типов каналов.
Дополнительные голосовые сообщения устанавливаются с помощью приложения menuselect в папку исходного кода Asterisk. Существует три набора аудиопакетов: Core Sound (Основные звуки), Extra Sound (Дополнительные звуки) и Music On Hold File (Музыка при ожидании). В каждый набор пакетов включены аудиофайлы в разных форматах (и пакеты Core Sound доступны на разных языках). Используя приложение menuselect, можно выбирать комбинации аудиопакетов для среды. Доступны следующие форматы:
• WAV.
• plaw.
• alaw.
• GSM.
• G.729.
• G.722 (широкополосный, 16-разрядный).
На момент написания данной книги пакеты Core Sound доступны на следующих языках:
• Английский.
• Испанский.
• Французский.
Для любых звуков, определенных в окне выбора компонентов сборки, при установке система загрузит соответствующие файлы с FTP-сервера Digium. Размер этих файлов варьируется в диапазоне от 2 до 27 Мб, об этом следует помнить при установке в автономном режиме или загрузке по медленным и дорогим линиям
Пакет asterisk-addons содержит код, обеспечивающий возможность хранения записей параметров вызовов (Call Detail Records, CDRs) в базе данных MySQL. Также в нем имеется код, с помощью которого Asterisk может воспроизводить звуковые файлы в формате MP3 (что мы рекомендуем делать только в очень мощной системе с небольшим количеством телефонов). Кому-то также может быть интересен интерпретатор, который позволяет загружать Perl-сце- нарии в память на время активности процесса Asterisk (что может быть очень полезно при поступлении большого количества AGI- обращений к интерпретатору Perl). В asterisk-addons помещаются программы, недостаточно тщательно разработанные для интеграции с Asterisk или те, вопросы лицензирования которых не позволяют реализовать их непосредственно в исходном коде Asterisk. По адресу http://ftp.digium.com/pub/asterisk/g729/ располагаются код и программа регистрации специализированного кодека G. 729A. Если установлены аудиопакеты g729, Asterisk сможет связываться с устройствами, поддерживающими кодек G.729A, но не способна преобразовывать сигналы в другие кодеки, пока не получит лицензию на использование G.729A.
Существует множество проблем компиляции, с которыми часто сталкиваются пользователи. Далее рассматриваются некоторые самые распространенные из них и способы их решения.
Сначала давайте рассмотрим некоторые ошибки, которые могут возникнуть при выполнении сценария configure.
configure: error: no acceptable C compiler found in $PATH
Если при попытке выполнения сценария configure возникает такая ошибка, требуется установить компилятор gcc и его зависимости:
configure: error: no acceptable C compiler found in $PATH
(configure: ошибка: не найден необходимый компилятор C в $PATH)
Для gcc необходимы следующие пакеты:
• gcc
• cpp
• glibc-headers
• glibc-devel
• glibc-kernheaders
Эти пакеты могут быть установлены вручную путем копирования файлов с диска используемого дистрибутива или посредством диспетчера пакетов yum с помощью команды yum install gcc.
configure: error: C++ preprocessor "/lib/cpp" fails sanity check
Эта ошибка возникает, если в системе не обнаружен препроцессор С++. Требуется установить пакет gcc-c++ и его зависимости:
configure: error: C++ preprocessor "/lib/cpp" fails sanity check (configure: ошибка: препроцессор С++ "/lib/cpp" не проходит проверку на готовность к работе)
Препроцессор gcc-c++ требует наличия следующих пакетов; устанавливаются они путем выполнения команды yum install gcc-c++:
• gcc-c++
• libstdc++-devel
configure: error: *** termcap support not found
Следующая ошибка может возникнуть при запуске сценария configure, если не установлен пакет libtermcap-devel:
configure: error: *** termcap support not found (configure: ошибка: поддержка *** termcap не выявлена) Для компиляции Asterisk необходим следующий файл; его можно установить, выполнив команду yum install libtermcap-devel:
• libtermcap-devel
Zaptel
Ошибки могут возникать и при компиляции Zaptel. Здесь представлены некоторые наиболее распространенные проблемы и способы их решения. Если ниже вы не находите ошибки, с которой столкнулись, посмотрите предыдущий раздел, может быть, вы найдете ее там.
make: cc: Command not found
Следующее сообщение об ошибке будет получено при попытке сборки Zaptel без компилятора gcc:
make: cc: Command not found make: *** [gendigits.o] Error 127
(make: сс: Команда не найдена
make: *** [gendigits.o] Ошибка 127)
Убедитесь, что gcc и его зависимости установлены. Больше информации можно найти в подразделе «configure: error: no acceptable C compiler found in $PATH» предыдущего раздела.
FATAL: Module wctdm/fxs/fxo not found
Для плат TDM400P необходима PCI-шина версии 2.2. При попытке загрузить драйверы телефонии Zapata с более старой версией могут возникать следующие ошибки:
• При попытке загрузить драйвер wctdm может появиться такое сообщение об ошибке:
FATAL: Module wctdm not found
(ФАТАЛЬНАЯ ОШИБКА: Модуль wctdm не найден)
• При попытке загрузить драйвер wctdm или wcfxo может появиться такое сообщение об ошибке:
ZT_CHANCONFIG failed on channel 1: No such device or address (6) FATAL: Module wctdm not found
(Не удалось выполнить ZT_CHANCONFIG для канала 1: Такое устройство или адрес не обнаружены (6) ФАТАЛЬНАЯ ОШИБКА: Модуль wctdm не найден) Единственный способ исправить эти ошибки - использовать более новую системную плату, которая поддерживает PCI версии 2.2:
• Также эти ошибки могут возникнуть, если блок питания не подключен в разъем Molex на плате TDM400P.
Драйвер ztdummy требует наличия доступного контроллера UHCI USB в ядрах Linux 2.4 (USB-котроллер не является обязательным требованием для ядер Linux 2.6, потому что они способны генерировать опорный синхросигнал частотой 1 кГц). Существуют контроллеры вторичного типа, известные как OHCI-контроллеры[51], которые несовместимы с драйвером ztdummy. Если контроллер UHCI USB недоступен в ядрах Linux 2.4, возникнет следующая ошибка:
/lib/modules/2.4.22/misc/ztdummy.o: /lib/modules/2.4.22/misc/ztdummy.o: unresolved symbol unlink_td
/lib/modules/2.4.22/misc/ztdummy.o: /lib/modules/2.4.22/misc/ztdummy.o: unresolved symbol alloc_td
/lib/modules/2.4.22/misc/ztdummy.o: /lib/modules/2.4.22/misc/ztdummy.o: unresolved symbol delete_desc
/lib/modules/2.4.22/misc/ztdummy.o: /lib/modules/2.4.22/mlsc/ztdummy.o: unresolved symbol uhci_devices
/lib/modules/2.4.22/misc/ztdummy.o: /lib/modules/2.4.22/misc/ztdummy.o: unresolved symbol uhci_interrupt
/lib/modules/2.4.22/misc/ztdummy.o: /lib/modules/2.4.22/misc/ztdummy.o: unresolved symbol fill_td
/lib/modules/2.4.22/misc/ztdummy.o: /lib/modules/2.4.22/misc/ztdummy.o: unresolved symbol insert_td_horizontal
/lib/modules/2.4.22/misc/ztdummy.o: insmod /lib/modules/2.4.22/misc/ ztdummy.o failed
/lib/modules/2.4.22/misc/ztdummy.o: insmod ztdummy failed Убедиться в наличии соответствующего USB-контроллера и связанных с ним драйверов можно с помощью команды lsmod:
# lsmod
Module Size Used by
usb_uhci 26412 0
usbcore 79040 1 [hid usb-uhci]
Как можно увидеть в приведенном выше примере, мы проверяем, загружены ли модули usbcore и usb_uhci. Если эти модули не загружены, необходимо убедиться, что USB в BIOS активирован и что эти модули есть в наличии.
Если драйверы USB не загружены, все равно с помощью команды dmesg есть возможность проверить тип имеющегося USB-контроллера:
# dmesg | grep -i usb
Наличие контроллера UHCI USB подтвердят следующие строки:
uhci_hcd 0000:00:04.2: new USB bus registered, assigned bus number 1 hub 1-0:1.0: USB hub found
uhci_hcd 0000:00:04.3: new USB bus registered, assigned bus number 2 hub 2-0:1.0: USB hub found
(uhci hcd 0000:00:04.2: зарегистрирована новая USB-шина, присвоенный номер шины - 1 hub 1-0: обнаружен концентратор USB
uhci hcd 0000:00:04.3: зарегистрирована новая USB-шина, присвоенный номер шины - 2 hub 2-0:1.0: обнаружен концентратор USB)
Если во время компиляции возникают ошибки depmod, вероятнее всего, отсутствует символическая ссылка на исходные файлы ядра Linux. Если исходные файлы используемого ядра Linux не установлены, необходимо скачать их в Интернете c сайта http://kernel.org, установить и создать символическую ссылку на /usr/src/linux-2.4. Ниже представлен пример ошибки depmod: depmod: *** Unresolved symbols in /lib/modules/2.4.22/kernel/drivers/block/ loop.o
(depmod: *** Неразрешимые символы в /lib/modules/2.4.22/kernel/ drivers/block/loop.o)
Если команда make config выполняется в папках исходного кода Asterisk или Zaptel, сценарии запуска, используемые для управления Asterisk или Zaptel, будут скопированы в папку /etc/rc.d/init.d/. Используя сценарии, можно упростить загрузку Asterisk и Zaptel. Эти сценарии также выполнят команду chkconfig, что обеспечит автоматический запуск Asterisk и Zaptel при загрузке системы. Ниже представлен пример их использования:
# service zaptel start
# service asterisk start
Каждый сценарий запуска имеет несколько опций, с помощью которых можно управлять офисной АТС или драйверами. В табл. 3.2 и 3.3 приведены команды, выполняемые сценарием (но их можно было бы вводить самостоятельно в интерфейсе командной строки (Command- Line Interface, CLI)).
Таблица 3.2. Опции сценария запуска Asterisk
service asterisk <опция> | Эквивалент для ввода вручную |
start | asterisk |
stop | killproc asterisk |
restart | stop; start |
reload | asterisk -rx "reload" |
status | ps aux | grep [a]sterisk |
Таблица 3.3. Опции сценария запуска Zaptel
service zaptel <опция> | Эквивалент для ввода вручную |
start | modprobe zaptel; modprobe <модуль>; /sbin/ztcfg |
stop | rmmod ztdummy; rmmod zaptel |
restart | stop; start |
reload | /sbin/ztcfg |
В данном разделе будет кратко рассмотрена загрузка модулей zaptel и ztdummy без сценария запуска CentOS. Если модуль zaptel будет использоваться только для модуля ztdummy, он не требует никакой конфигурации. Если планируется загружать модуль ztdummy в качестве источника временных интервалов (и таким образом, в системе не будут использоваться никакие PCI-устройства), самое время загрузить оба драйвера.
В эпоху юности Linux системная папка /dev/ заполнялась списком устройств, с которыми система потенциально могла взаимодействовать. В то время в этом списке было примерно 18 000 устройств. Все изменилось с появлением devfs, обеспечившего динамическое создание файлов устройств, которые активно используются системой. Некоторые последние выпущенные дистрибутивы включают программу-демон udev для динамического заполнения папки /dev/ списками устройств. Чтобы Zaptel и другие драйверы устройств могли работать с PCI-уст- ройствами, установленными в системе, необходимо определить несколько правил. В своем любимом текстовом редакторе откройте файл правил udevd. В CentOS, например, этот файл находится по адресу /etc/udev/rules.d/50-udev.rules. В конце файла правил необходимо добавить следующие строки:
# Раздел для zaptel device
KERNEL="zapctl", NAME="zap/ctl"
KERNEL="zaptimer", NAME="zap/timer"
KERNEL="zapchannel", NAME="zap/channel"
KERNEL="zappseudo", NAME="zap/pseudo"
KERNEL="zap[0-9]*", NAME="zap/%n"
Сохраните файл и перезагрузите систему, чтобы настройки вступили в действие.
Возможно, вам не придется ничего редактировать в своей системе, потому что сценарий установки Zaptel попытается определить все правила сам; однако мы приводим эти рекомендации здесь для тех систем, которые конфигурируются не автоматически.
Модуль zaptel должен быть загружен до того, как будут загружены и использованы все остальные модули. Следует отметить, что, если модуль zaptel будет использоваться с PCI-устройствами, перед его загрузкой необходимо выполнить конфигурирование в файле /etc/zaptel. conf. (Конфигурация zaptel.conf для использования с аппаратными средствами обсуждается в главе 4.) Если zaptel предназначен только для доступа к ztdummy, его можно загрузить с помощью команды modprobe следующим образом:
# modprobe zaptel
Если все проходит нормально, на экран ничего не выводится. Проверить успешность загрузки модуля zaptel можно с помощью команды lsmod. В результате ее выполнения должна быть возвращена строка с именем модуля и указанием занимаемого им объема оперативной памяти, например:
# lsmod | grep zaptel
zaptel 201988 0
Модуль ztdummy - это интерфейс устройства, обеспечивающий генерирование временных интервалов. Благодаря ему Asterisk, в свою очередь, может предоставлять временные интервалы различным приложениям и функциям, которым это необходимо. Модуль ztdummy загружается после загрузки zaptel с помощью команды modprobe:
# modprobe ztdummy
Если загрузка ztdummy проходит успешно, на экран ничего не выводится. Проверить, что ztdummy загружен и используется модулем zaptel, можно с помощью команды lsmod. Следующий вывод получен на компьютере, выполняющем ядро 2.6:
# lsmod | grep ztdummy
Module Size Used by
ztdummy 3796 0
zaptel 201988 1 ztdummy
На компьютере, на котором выполняется ядро 2.4, в выводе, полученном в результате выполнения lsmod, будет показано, что ztdummy использует модуль usb-uhci:
# lsmod | grep ztdummy
Module Size Used by
ztdummy 3796 0
zaptel 201988 0 ztdummy
usb-uhci 24524 0 ztdummy
Библиотеки libpri не требуется загружать, как модули. Asterisk ищет libpri во время компиляции и, если находит их, конфигурируется на использование библиотек самостоятельно.
Asterisk может быть загружена по-разному. Самый простой способ - выполнение двоичного файла прямо из интерфейса командной строки
Linux. Точно так же Asterisk можно запускать и перезапускать и в системе, использующей сценарии init.d. Однако предпочтительнее запускать Asterisk с помощью сценария safe_asterisk.
Двоичный файл Asterisk по умолчанию располагается по адресу /usr/ sbin/asterisk. Если запустить файл /usr/sbin/asterisk, Asterisk загрузится как программа-демон. Существует также несколько ключей, которые позволяют (повторно) запускать CLI Asterisk, задавать степень детальности вывода CLI и создавать дампы ядра в случае сбоя Asterisk (для отладки с помощью gdb). Чтобы увидеть все возможные опции, запустите Asterisk с ключом -h:
# /usr/sbin/asterisk -h Вот список наиболее часто используемых опций:
-c
Консоль. Эта опция обеспечит запуск Asterisk как пользовательского процесса (не сервера) и предоставит окно командной строки Asterisk. Она пригодится при настройке параметров запуска, но не должна использоваться при нормальной работе системы (если Asterisk уже выполняется, эта опция не сработает и будет выдано сообщение об ошибке).
-v
Детальность сообщений. Используется для определения степени детальности сообщений, выводимых при отладке с помощью CLI. Чем выше значение v, тем более детальными будут сообщения.
-g
Дамп ядра. При неожиданном сбое Asterisk этот ключ обусловил бы создание файла ядра для последующей его трассировки с помощью gdb. Обычно этот ключ не используется в производственной эксплуатации, а применяется только в том случае, если пишется код для Asterisk и требуется отладить все возникающие сбои.
-r
Удаленный. Используется для удаленного повторного подключения к уже выполняющемуся процессу Asterisk. (Процесс является удаленным с позиции консоли, подключающейся к нему, но фактически процесс выполняется локально на том же компьютере. Это не имеет ничего общего с подключением к удаленному процессу по сети с использованием, например, протокола IP, поскольку такое взаимодействие не поддерживается.) Это самая распространенная опция. Именно она использовалась бы для соединения с Asterisk в системе, в которой она выполняется как программа-демон/сервис, запущенная в момент запуска системы.
-x "<команда CLI>"
Выполнить. Использование этой команды в сочетании с опцией -r позволяет выполнять команду CLI без необходимости подключения к CLI и ввода команды вручную. В качестве примера можно привести команду на повторный запуск, для инициации которого пришлось бы ввести в командной строке asterisk -rx "reload". Рассмотрим некоторые примеры. Запустить Asterisk как пользовательскую программу (потому что выполняется настройка конфигурационного файла и придется запускать и останавливать выполнение несколько раз) и задать уровень детальности сообщений 3 можно, используя следующую команду:
# /usr/sbin/asterisk -cvvv
Если процесс Asterisk уже выполняется (например, если Asterisk сконфигурирована как часть процесса запуска системы), используется ключ восстановления соединения:
# /usr/sbin/asterisk -vvvr
Если требуется, чтобы Asterisk выводила файл ядра после сбоя, при запуске Asterisk можно использовать ключ -g:
# /usr/sbin/asterisk -g
Чтобы выполнить команду, не подключаясь к CLI и не вводя ее (возможно, для того, чтобы использовать ее в сценарии), можно применять ключ -x в сочетании с ключом -r:
# /usr/sbin/asterisk -rx "restart now"
# /usr/sbin/asterisk -rx "database show"
# /usr/sbin/asterisk -rx "sip show peers"
Если возникают сбои и хотелось бы записывать информацию в файл отладки, используется следующая команда:
# /usr/sbin/asterisk -vvvvc | tee /tmp/debug.log
Обратите внимание, что ключ v не нужен, если не требуется, чтобы система предоставляла подробную информацию о происходящем. В сильно загруженной системе этот вывод может перекрывать другую выводимую в консоли информацию.
Asterisk использует несколько папок в системе Linux для организации различных аспектов системы, таких как запись сообщений голосовой почты, голосовые сообщения и конфигурационные файлы. В данном разделе обсуждаются необходимые папки. Все они создаются во время установки и конфигурируются в файле asterisk.conf.
/etc/asterisk/
В папке /etc/asterisk/ располагаются конфигурационные файлы Asterisk. Однако один файл, zaptel.conf, находится в папке /etc/. Аппаратные средства Zaptel изначально были разработаны Джимом Диксоном (Jim Dixon), сотрудником компании Zapata Telephony Group, как подходящее и доступное по цене оборудование для компьютерной телефонии. Asterisk использует это оборудование, но любое другое ПО также может воспользоваться устройствами и драйверами Zaptel. Поэтому конфигурационный файл zaptel.conf вынесен из папки /etc/ asterisk/.
/usr/lib/asterisk/modules/
В папке /usr/lib/asterisk/modules/ располагаются все загружаемые модули Asterisk. В этой папке находятся различные приложения, кодеки, форматы и каналы, используемые Asterisk. По умолчанию Asterisk загружает все эти модули при запуске системы. Любые неиспользуемые модули можно отключить в файле modules.conf, но при этом необходимо помнить, что некоторые модули необходимы Asterisk или являются зависимостями других модулей. Попытка загрузить Asterisk без этих модулей приведет к ошибке при запуске.
/var/lib/asterisk
В папке /var/lib/asterisk/ находится файл astdb и ряд подпапок. Файл astdb содержит информацию локальной базы данных Asterisk, что несколько напоминает реестр Microsoft Windows. База данных Asterisk - простая реализация на базе версии 1 Berkeley BD. Один из исходных файлов Asterisk, db.c, информирует, что эта версия была выбрана по следующей причине: «Реализация DB3 создана по альтернативной лицензии, несовместимой с общедоступной лицензией (General Public License, GPL). Таким образом, чтобы не усложнять лицензирование Asterisk, было решено использовать версию 1, поскольку она выпущена по лицензии BSD».
Папка /var/lib/asterisk/ включает следующие подпапки: agi-bin/
В папке agi-bin/ находятся специальные сценарии, которые могут взаимодействовать с Asterisk через различные встроенные приложения AGI. Подробнее об AGI рассказывается в главе 8. firmware/
Папка firmware/ содержит встроенное ПО для различных совместимых с Asterisk устройств. В настоящее время в этой папке имеется только подпапка iax/, в которой находится двоичное отображение встроенного ПО для IAXy производства Digium.
images/
Приложения, которые соединяются с каналами, поддерживающими изображения, ищут папку images/. Большинство каналов не поддерживают передачу изображений, поэтому эта папка используется редко. Однако если появится больше устройств, поддерживающих и использующих изображения, эта папка станет более значимой. keys/
Asterisk может использовать систему открытых/закрытых ключей для аутентификации равноправных участников сети, которые соединяются с модулем, используя цифровую подпись RSA. Если поместить открытый ключ такого участника сети в свою папку keys/, этот участник сети сможет быть аутентифицирован каналами, поддерживающими данный метод (такими, как каналы IAX2). Закрытый ключ никогда не предоставляется. Справедливо и обратное: вы можете предоставить свой открытый ключ равноправным участникам сети, что позволит вам проходить аутентификацию с использованием своего закрытого ключа. И открытый, и закрытый ключи - файлы с расширениями .pub и .key соответственно - хранятся в папке keys/. mohmp3/
Если Asterisk сконфигурирована на воспроизведение музыки при ожидании, приложения, использующие эту функцию, ведут поиск файлов в формате MP3 в папке mohmp3/. Asterisk несколько требовательна к форматированию МР3-файлов, поэтому следует использовать кодирование с постоянной скоростью передачи данных (constant bitrate, CBR) и удалять теги ID3 из файлов. sounds/
Все доступные для Asterisk голосовые сообщения находятся в папке sounds/. Основные сообщения, поставляемые с Asterisk, объединены в файл sounds.txt, размещающийся в папке исходного кода Asterisk. Дополнительные подсказки находятся в файле sounds-extra. txt, расположенном в той папке, в которую ранее в этой главе был извлечен из архива пакет asterisk-sounds.
/var/spool/asterisk/
Папка Asterisk spool имеет несколько подпапок, включая dictate/, meetme/, monitor/, outgoing/, system/, tmp/ и voicemail/ (рис. 3.4). Asterisk отслеживает папку outgoing на наличие текстовых файлов, содержащих информацию запросов вызовов. Эти файлы позволяют производить вызов, просто перемещая правильно структурированный файл в папку outgoing/.
Файлы вызовов, помещенные в папку outgoing/, могут содержать полезную информацию, такую как Context (Контекст), Extension (Расширение) и Priority (Приоритетность), соответственно которой должен начинаться ответ на вызов, или просто приложение и его аргументы.
Рис. 3.4. Структура папки /var/spool/asterisk/
Также в них можно задать переменные и определить код учетной записи для Call Detail Records (Записи параметров вызовов). Более подробная информация об использовании файлов вызовов представлено в главе 9. dictate/ - папка, в которой приложение Dictate() ищет файлы по умолчанию.
meetme/ - папка, в которой сохраняются записи конференций, организованных приложением MeetMe().
Записи, полученные с помощью любого приложения для записи «в одно касание» (флаги w и W для приложения Dial()), MixMonitor() или Monitor(), хранятся в папке monitor/.
Папка system/ используется приложением System() для временного хранения данных.
Папка tmp/, как это ни смешно, используется для хранения временной информации. Некоторым приложениям может потребоваться место для записи файлов перед копированием их окончательных версий в постоянное местоположение. Это предотвращает попытки одновременной записи и чтения файла разными процессами. Все сообщения голосовой почты и приветствия пользователя находятся в папке voicemail/. Для добавочных номеров, заданных в voicemail. conf и по крайней мере один раз зарегистрировавшихся в системе, в voicemail/ создаются подпапки.
/var/run/
Папка /var/run/ содержит идентификаторы процессов (Process ID, PID) для всех активных процессов системы, включая Asterisk (как определено в файле asterisk.conf). Обратите внимание, что в разных ОС для этих целей могут использоваться различные папки.
/var/log/asterisk/
Папка /var/log/asterisk/ является местом хранения журнала Asterisk. Редактируя файл logger.conf, находящийся в папке /etc/asterisk/, можно управлять типом информации, протоколируемой в различных файлах. Базовая конфигурация файла logger.conf рассматривается в приложении D.
/var/log/asterisk/cdr-csv
Папка /var/log/asterisk/cdr-csv используется для хранения записей параметров вызовов (CDR) в формате CSV (с разделяющими запятыми). По умолчанию информация хранится в файле Master.csv, но для отдельных учетных записей с помощью опции accountcode можно организовать хранение их CDR в отдельных файлах (подробнее об этом рассказывается в приложении А).
В следующих разделах дается последовательное введение в программный продукт AsteriskNOW, который предоставляет собой завершенную систему офисной АТС и графическое окно настройки конфигурации - все в одном!
AsteriskNOW - это программное устройство с открытым исходным кодом, специализированный дистрибутив Linux, включающий Asterisk, графический пользовательский интерфейс (GUI) Asterisk и все остальное программное обеспечение, необходимое системе Asterisk. С помощью GUI Asterisk можно без труда сконфигурировать систему Asterisk, даже не являясь техническим специалистом.
Примечание: полный дистрибутив программного продукта предоставляется по общедоступной лицензии (http:// www.gnu.org/copyleft/gpl. html) и может на законных основаниях использоваться в любых целях, в том числе и коммерческих.
Установка AsteriskNOW проста, потому что этот дистрибутив включает только компоненты, необходимые для выполнения, отладки и сборки Asterisk. Больше не надо думать о версиях ядра и зависимостях пакетов. AsteriskNOW - специальный дистрибутив Linux для Asterisk, созданный на базе rPath Linux.
• Система, в которой можно установить AsteriskNOW.
• Устройство для записи CD и соответствующее ПО.
• Соединение с Интернетом.
• Броузер Firefox.
В настоящее время GUI Asterisk для оптимальной производительности необходим броузер Firefox (доступен по адресу http://www.mozilla.com/en-US/). Более широкая поддержка броузеров будет доступна в будущих версиях.
При подготовке и установке нового дистрибутива следует выполнять все обычные меры
предосторожности. Экспресс-установка (Express Installation) удалит с жесткого диска все существующие операционные системы. Чтобы попробовать поработать с AsteriskNOW, но сохранить при этом имеющуюся систему, необходимо использовать одну из альтернативных установок (обсуждаются в разделе «Альтернативные установки»). Информация о том, где можно найти больше советов и рекомендаций по Asterisk и rPath, приведена в разделе «Дополнительные источники» в конце данной главы.
Основная установка AsteriskNOW на самом деле довольно проста и обеспечивает возможность быстро установить и получить работоспособную систему. Эта быстрая установка может использоваться, если нет возражений против принятия настроек по умолчанию. Вся справочная информация, которая может понадобиться, представлена в окнах установки. Более детальную информацию о процедуре установки можно найти в разделе «Развернутая процедура» ниже.
• Скачайте ISO-файл AsteriskNOW (http://www.asterisknow.org/ downloads) и создайте из него CD-образ. Этот шаг необходим для того, чтобы можно было начать установку. Процесс создания CD-обра- за может быть различным в зависимости от используемого ПО для записи CD.
Вставьте созданный CD AsteriskNOW в устройство CD-ROM ПК.
• Перезапустите ПК и выполните загрузку с CD. На экране появится основное меню загрузки AsteriskNOW с несколькими опциями:
• Чтобы установить или обновить систему в графическом режиме, нажмите клавишу Enter.
• Чтобы установить или обновить систему в текстовом режиме Linux, введите команду linux text и затем нажмите клавишу Enter.
Рекомендуется и используется по умолчанию графический режим. Если команда не была введена, установка продолжается в графическом режиме.
4. С этого момента действуйте согласно понятным без дополнительных объяснений подсказкам, появляющимся на экране, которые помогут выполнить установку.
5. По завершении установки система предложит выполнить перезагрузку. После перезагрузки на экран будет выведен URL для доступа к GUI Asterisk.
6. Теперь все готово для конфигурации и запуска AsteriskNOW.
1. Скачайте ISO-файл AsteriskNOW (http://www.asterisknow.org/ downloads) и создайте из него CD-образ. Этот шаг необходим для того, чтобы можно было начать установку. Процесс создания CD-обра- за может быть различным в зависимости от используемого ПО для записи CD.
2. Вставьте созданный CD AsteriskNOW в устройство CD-ROM.
3. Перезапустите ПК и выполните загрузку с CD. На экране появится основное меню загрузки AsteriskNOW с несколькими опциями:
• Чтобы установить или обновить систему в графическом режиме, нажмите клавишу Enter.
• Чтобы установить или обновить систему в текстовом режиме Linux, введите команду linux text и затем нажмите Enter.
Рекомендуется и используется по умолчанию графический режим. Если команда не была введена, установка продолжается в графическом режиме.
После недолгой обработки на экран выводится окно установки. Первое окно выглядит следующим образом:
4. В первом окне установки можно найти сведения о версии или справочную информацию. Когда будете готовы, щелкните по кнопке Next (Далее), чтобы продолжить установку.
В следующем окне установки производится выбор типа установки. Предлагаются два типа установки: Express Installation (Экспресс установка)
Экспресс-установка обеспечит установку всего ПО, необходимого для установки Asterisk. В этом случае устанавливаются инструменты отладки и разработки.
Expert (Эксперт)
Этот тип установки следует выбирать, если вы хотите полностью контролировать все опции установки. Сюда входит выбор пакета ПО, разбиение на разделы и выбор языка.
Типом установки по умолчанию является экспресс-установка. Этот тип установки предназначен для тех, кто владеет английским языком и не желает вдаваться в тонкости процесса установки. Если вы не читаете по-английски и/или хотите контролировать детали установки, выбирайте эксперт-установку. Здесь обсуждается экспресс-установка.
5. Выберите тип установки и щелкните по кнопке Next (Далее).
На экран выводится окно Automatic Partitioning (Автоматическое разбиение на разделы). В нем предлагается несколько опций, которые необходимо определить, прежде чем ПО разобьет на разделы жесткий диск. Вы можете выбрать, какие данные (если таковые имеются) будут удалены из системы и как будет разбит на разделы жесткий диск. Предлагаются следующие варианты: Remove AH Linux Partitions (Удалить все разделы Linux)
Выбор этой опции обеспечит уничтожение всех разделов Linux, созданных при предыдущих установках Linux.
Remove AH Partitions (Удалить все разделы)
Эту опцию следует выбрать, если требуется удалить все разделы системы, включая те, которые были созданы другими операционными системами (такими, как Windows).
Keep AH Partitions (Сохранить все разделы)
Эту опцию следует выбрать, если требуется сохранить все текущие данные и разделы. Для реализации Asterisk потребуется достаточно пространства на жестком диске. 20 Гб - реально возможный минимум, но действительный минимальный объем зависит от требований создаваемой системы.
В большинстве случаев выбирается вариант Remove AH Partitions (Удалить все разделы). Полностью отдать жесткий диск под реализацию Asterisk - лучший способ гарантировать максимальную производительность. Установите флажок Review (Просмотр) в окне Automatic Partitioning (Автоматическое разбиение на разделы), если хотите просмотреть или изменить разбиение на разделы.
6. В окне Automatic Partitioning (Автоматическое разбиение на разделы) отображается список доступных жестких дисков. Установите флажок напротив жесткого диска (или нескольких жестких дисков), который вы хотите использовать для системы. Щелкните по кнопке Next (Далее), чтобы продолжить установку.
• Если выбрана опция Remove All Partitions (Удалить все разделы) или Remove All Linux Partitions (Удалить все разделы Linux), на экране появится диалоговое окно с просьбой подтвердить желание продолжать установку. Щелкните по кнопке Yes (Да), чтобы продолжить, или No (Нет), чтобы изменить выбор относительно разделов.
Если в окне Automatic Partitioning (Автоматическое разбиение на разделы) была включена опция Review (Просмотр), на экран будет выведено окно с созданными разделами. В этом окне можно изменять разделы. Чтобы продолжить, щелкните по кнопке Next (Далее).
7. На экран выводится окно Network Configuration (Конфигурация сети).
• В окне Network Configuration (Конфигурация сети) можно сконфигурировать сетевые устройства, связанные с системой. Программа установки автоматически выявляет все сетевые устройства, подсоединенные к системе, и отображает их в списке Network Devices (Сетевые устройства). Можно принять автоматически выбранное программой установки устройство (либо несколько устройств) или редактировать выбор с помощью опции Edit (Редактировать).
• Задайте значение Hostname (Имя хоста). Для этого выберите вариант Automatically via DHCP (Автоматически с помощью протокола DHCP) или Manually (Вручную) и введите имя хоста для своей системы. Задав имя, щелкните по кнопке Next (Далее), чтобы продолжить.
8. На экран выводится окно Time Zone Selection (Выбор часового пояса).
Окно Time Zone Selection (Выбор часового пояса) предлагает на выбор несколько вариантов часового пояса для вашей установки. Можно воспользоваться картой мира, на которой показаны основные города, списком районов и часовых поясов или опцией System Clock Uses UTC (Системные часы используют UTC[52]), чтобы использовать системное время. Выбрав часовой пояс, щелкните по кнопке Next (Далее).
9. На экран выводится окно Administrator Password (Пароль администратора).
• Необходимо задать пароль для учетной записи администратора AsteriskNOW, admin. Этот пароль будет использоваться для входа в систему и GUI Asterisk. Задайте и подтвердите пароль администратора и затем щелкните по кнопке Next (Далее), чтобы продолжить.
• На экран выводится окно About to Install (Готов начать установку), предоставляющее возможность отложить или отменить процесс установки. Если вы готовы продолжать установку, щелкните по кнопке Next (Далее).
10. На экран выводится окно Installing Packages (Устанавливаются пакеты).
• В течение всего процесса установки AsteriskNOW на экране будет отображаться окно Installing Packages (Устанавливаются пакеты). Установка займет несколько минут.
• По завершении установки система попросит выполнить перезагрузку. Выньте из устройства созданный вами установочный диск и щелкните по кнопке Reboot (Перезагрузка). После перезагрузки на экране появится URL для доступа к GUI Asterisk.
После завершения установки и перезагрузки компьютера можно переходить к GUI Asterisk. URL, используемый для доступа к GUI Asterisk, - это IP-адрес или имя хоста, которое выводится на экран после перезагрузки компьютера. Введите этот IP-адрес в адресной строке броузера. С помощью GUI Asterisk можно улучшать и настраивать AsteriskNOW.
AsteriskNOW можно также испытать, используя образ VMware Player (http://www.vmware.com/download/player/), универсальный образ гостевого домена Xen (http:// wiki.rpath.com/wiki/Xen_Solutions_Using_ rPath_Technologies) или LiveCD (только что записанного и запущенного). Все альтернативные установки можно найти на странице для скачивания AsteriskNOW (http://www.asterisknow.org/downloads). Примечание: при использовании LiveCD имя пользователя и пароль по умолчанию - admin и password соответственно.
В настоящее время сообществом разработчиков Asterisk на форумах Asterisk создается «Руководство пользователя AsteriskNOW». Дополнительную информацию по AsteriskNOW, включая скриншоты процесса установки по шагам и конфигурирования с помощью Мастера настройки, можно найти по адресу http://www.asterisknow.org. Посетите также форумы Asterisk (http://forums.digium.com). Больше информации и справочных данных по rPath Linux представлено в разделе Википедии rPath, http://wiki.rpath.com.
В данной главе рассмотрены процедуры получения, компиляции и установки Asterisk и связанных с ней пакетов. В следующей главе мы коснемся вопроса исходной конфигурации системы с точки зрения различных каналов связи, таких как аналоговые устройства, подключенные к портам FXS и FXO, SIP-каналы и конечные точки IAX2.