Параметры файлов конфигурации

Материал из Oktell
Перейти к: навигация, поиск

Ряд настроек комплекса хранится в файлах конфигурации соответствующих приложений. Файл конфигурации загружается однократно в момент запуска приложения, и хранящиеся в нем настройки не могут быть изменены в ходе работы. Любые изменения файлов конфигурации применяются только при следующем запуске соответствующего приложения.

Настройки файла конфигурации клиентского приложения влияют на работу только конкретного клиента.


Файлы конфигурации находятся в том же каталоге, в котором расположен запускаемый модуль.

Файл конфигурации клиентского приложения: oktell.ClientStarter.exe.config

Файл конфигурации серверной службы: oktell.ServerService.exe.config

Файл конфигурации серверного приложения: oktell.ServerForm.exe.config


Изменять файлы необходимо в редакторах, не изменяющих кодировку (рекомендуется стандартный редактор «Блокнот»). Такие редакторы как «Microsoft Word» и «Wordpad» сбивают кодировку, в следствие чего запуск приложения системы становится невозможным. При попытке запуска с некорректным конфигурационном файлом возникает системное окно с описанием ошибки.

Конфигурационные файлы содержат ряд служебных настроек, поэтому в целях сохранения целостности и работоспособности не рекомендуется изменять формат файла и параметры, у которых нет описания.

Формат представляет собой стандартный XML-документ со специфическими элементами. Допустимые настройки находятся в разделе между тегами <appSettings> и </appSettings>. Каждый конкретный параметр представляет собой строку

 <add key="KEY_STRING" value="VALUE_STRING" />

где KEY_STRING-название параметра,VALUE_STRING-значение параметра.Комментарии располагаются между строками <!-- и -->.


Параметры файла конфигурации серверного приложения

Language. Определяет языковую схему, используемую комплексом. В основном каталоге приложения находятся файлы Lang*.xml, представляющие собой наборы текстов для отображения в клиентских интерфейсах и БД. Для выбора того или иного языка необходимо в качестве значения данного параметра выставить соответствующее расширение имени файла (*). Например для использования файла LangRus.xml необходимо прописать значение «rus».

Язык по умолчанию – русский (применяется, если в конфигурационном файле не указан язык, или если не найден файл указанного языка).

Русский также является базовым языком. То есть если какого-либо кода не найдено в файле языка, то в альтернативу будет применен русский текст, заданный в коде программы. Язык также определяется в конфигурационном файле клиентского приложения, но после подключения к серверу клиентское приложение синхронизирует язык с установленным на сервере.

Локализация программы производится компаниями-партнерами, файлы с текстами могут распространяться в открытом и шифрованном виде. В последнем случае осуществляется привязка к лицензии.

HALSeparate. Режим запуска модуля поддержки оборудования. «0» - в текущем процессе, «1» - в отдельном процессе используя взаимодействие через NET.Remoting, «2» - в отдельном процессе используя собственный альтернативный канал связи по протоколу TCP.

В случае, если оборудование в некоторых случаях вызывает критические ошибки, подгрузка модуля поддержки оборудования в отдельном процессе позволяет не терять основной работоспособности сервера. В моменты падения процесса основная служба перезапускает его, производит фоновую регистрацию и продолжает работу.

В момент перерегистрации все линии переходят в состояние «Отключена», пользователи переходят в состояние «Без телефона», все коммутации разрываются, логика резервирований очищается. Менеджер задач реагирует способом, аналогичным тому случаю, когда абоненты на внешних линиях положили трубки. Возможно файлы записей оборвавшихся разговоров будут иметь некорректный заголовок, что сделает невозможным их прослушивание стандартными средствами. Полностью процесс автоматической переинициализации занимает 5-10 секунд.

HALRemoteAddress. Адрес расположения вынесенной в отдельной процесс службы HAL. По умолчанию localhost.

HALRemotePort. Порт доступа к вынесенной в отдельный процесс службе HAL. По умолчанию 4052.

START_SERVER. Индексированные параметры, определяющие запускаемые серверы аппаратуры. Доступные серверы: Сервер CTI плат Ольха-9, Сервер CTI плат Ольха-14, сервер CTI плат Synway, сервер SIP, серверы VoIP телефонии. При установке системы параметры выставляются согласно выбранным в дистрибутиве значениям. Однако в сложных системах могут потребоваться модификации. Например, в случае если происходит замена типа платы на рабочей системе, использование нескольких разных типов плат, а также при запуске нескольких VoIP серверов, обслуживающих разные подсети. Загрузке подлежат серверы с индексами от 1 до 32 (в примере - часть строки XX).


Сервер плат «Ольха 9», «Ольха 14»:

<add key="START_SERVER_XX" value="Alder9 Server;oktell.HALAlder9Srv.dll;Alder9;_Loaders\" />

<add key="START_SERVER_XX" value="Alder14 Server;oktell.HALAlder9Srv.dll;Alder14;_Loaders\" />

Последний элемент строки после точки с запятой указывает путь к файлам-загрузчикам. По умолчанию это подкаталог серверной службы _Loaders.


Сервер плат «Synway»:

<add key="START_SERVER_XX" value="Synway Server;oktell.HALSynwaySrv.dll;ShCti;" />


Сервер плат «Yeastar»:

<add key="START_SERVER_XX" value="E1 Yeastar Server;oktell.HALYeastarSrv.dll;YeaCTI" />

<add key="START_SERVER_XX" value="TDM800 Yeastar Server;oktell.HALYeastarSrv.dll;TDM800" />


Сервер SIP:

<add key="START_SERVER_XX" value="SIP Server;oktell.HALSipSrv.dll;SIP;sip:*:5060" />

Последний элемент строки после точки с запятой устанавливает детальные настройки сетевого интерфейса и порта, на которых запускаемый SIP-сервер будет активен. По умолчанию «sip:*:5060», то есть сервер слушает все интерфейсы на порте 5060. При необходимости установить какой-либо конкретный интерфейс необходимо вместо «*» указать его адрес.


Серверы VoIP:

<add key="START_SERVER_XX" value="Buildin VOIP Server;;Voip;localhost:4003" />

Последний элемент строки после точки с запятой указывает сетевой интерфейс и порт слушателя регистраций локальных устройств. При необходимости использования сервера для поддержки локальных устройств разных подсетей возможно запустить несколько VoIP-серверов - несколько однотипных строчек файла конфигурации с разными индексами и разными сетевыми интерфейсами.


Сервер виртуальных каналов

<add key="START_SERVER_XX" value="Virtual Server;oktell.HALVirtualSrv.dll;VS;12/10" />

Последний элемент строки указывает количество используемых каналов - внешних/внутренних.


PBXServerPort. Порт для подключения собственных клиентских приложений через механизм NET.Remoting (устаревш.).

InternalClientPort. Порт для подключения собственных клиентских приложений и приложений на базе клиентского ядра через встроенную надстройку над протоколом TCP. По умолчанию 4054.

ExternalClientPort. Порт для подключения внешних приложений 4053.

RTP_PORT_START. Начальный порт для обмена RTP-трафиком медиа-подсистемой (SIP, VoIP). По умолчанию 9000.

RTP_PORT_COUNT. Количество портов, начиная со стартового, доступные для медиа-подсистемы (SIP, VoIP). По умолчанию 10000.

RTP_MAX_CHANNELS. Количество сокетов получения RTP-трафика на один поток-слушатель. От 1 до 32. (SIP, VoIP). По умолчанию 8.

USE_AFFINITY_MASK. «1» - использовать разделение задач по процессорам. Половина процессоров для сервера логики, другая половина для сервера HAL. «0» - значение по умолчанию. В этом случае операционная система самостоятельно занимается распределением.

JITTER_DEPTH. Значение глубины джиттер-буфера на сервере. Минимальное значение - «4», по умолчанию - «4». При увеличении значения происходит рост задержки в голосовом обмене по направлению звука к серверу, эффективнее исключая влияние проблем сети.

TIMER_TYPE. Тип используемого таймера высокой разрешающей способности для тактирования звуковых пакетов. На разных операционных системах и компьютерах различные варианты таймеров могут иметь достаточно сильную погрешность, влияющую на итоговое качество звука. Основная задача при выборе таймера состоит в обеспечении корректного среднего промежутка времени между тиками. Замечены случаи, когда некоторые из вариантов таймеров ОС тактируют постоянно увеличенные интервалы времени (например постоянно 46 мс вместо 40 положенных). Если не происходит корректировок, то такой таймер следует заменить на другой тип. Для определения значений всех вариантов таймеров можно использовать специальное тестовое приложение.

Возможные значения:

0 - Системный таймер по умолчанию. Дает более точное тактирование по сравнению с таймером на ожидании. Выдает точное тактирование в Windows Vista и некоторую погрешность в предыдущих версиях Windows. Система буферизации звука в этом случае сглаживает разброс, однако существуют компьютеры, где погрешность таймера постоянна. Это влечет пропуск пакетов и заметное ухудшение итогового качества звука. На таких компьютерах необходимо использовать другие типы таймеров. Рекомендуется мультимедийный.
1 - Системный таймер в собственном потоке приложения.
2 - Имплементация таймера в потоке с использованием функции WaitForSingleObject().
3 - Мультимедийный таймер. Дает наиболее точное тактирование, однако имеет общее ограничение на количество одновременно существующих таймеров в системе (16 объектов). Сервер Oktell использует 3 объекта таймера высокой разрешающей способности.
4 - Автоопределение. На старте системы осуществляется тестовый прогон всех вариантов таймеров и определяется средне наиболее точный. В случае, если все имеют одинаковую среднюю точность, предпочтение отдается таймеру с меньшим индексом (таймер по умолчанию, системный, таймер ожидания, мультимедийный). На прогон теста на старте системы выделяется лишняя секунда.По умолчанию «4».


TIMER_HIGHRES. Тип используемого счетчика интервалов времени. «0» - миллисекундный системный счетчик GetTickCount, «1» - Query Performance Counter. По умолчанию «1».

FORCE_BRACKETS_FOR_URI. «1» - значения заголовков To и From отправляемых SIP-пакетов размещаются в треугольных скобках. По умолчанию «0».

WORK_ROOTDIR. Устанавливает в явном виде путь к рабочей папке серверной службы. Временные файлы, сценарии, проекты, плагины, каталог по умолчанию для записи разговоров, резервные копии - все, кроме основных сборок службы, размещается именно там.

WORK_ROOTDIR_TYPE. Устанавливает один из нескольких возможных вариантов размещения рабочей папки. Используется, если не задана рабочая папка в явном виде. Возможные варианты: 0 – папка запустившего процесс выполняемого файла, 2 – Documents And Settings\All Users, 3 – Documents And Settings\CurrentUser.

ManualHostAddress. Устанавливает уникальное имя сервера для идентификации в карте сети на старте службы. В случае, если в качестве адреса сервера в карте сети указано это значение - позволяет устранить зависимость от смены DNS-имени, а также смены и назначения динамических адресов сервера.

Следует обратить внимание, что сервер может являться также и клиентской рабочей станцией. В этом случае необходимо в файл конфигурации клиентского приложения на сервере задать аналогичный параметр тем же значением, либо создать в карте сети отдельный компьютер с указанным реальным адресом или любой другой уникальной строкой (в случае использования на клиенте аналогичной схемы подмены адреса).

ProcessPriority. Приоритет серверного процесса. По умолчанию «0» - Нормальный. «1» - выше среднего, «2» - высокий, «3» - реального времени.

ThreadCountLowLimit. Количество потоков в пуле системы, свободно доступных службе сервера. По умолчанию 700.

ThreadCountHighLimit. Максимально допустимое количество потоков в пуле системы, доступных службе сервера. Потоки, находящиеся в разнице между нижним и верхним ограничениями, выделяются системой с запаздыванием. По умолчанию 900.

DBServerName. Адрес сервера, на котором находится база данных MSSQL. По умолчанию «(local)».

DBName. Имя основной оперативной базы данных, к которой производится подключение. По умолчанию «oktell».

DBNameCC. Имя базы данных статистики call-центра. По умолчанию «oktell_cc_temp».

DBNameSettings. Имя базы данных с настройками системы. По умолчанию «oktell_settings».

DBLogin. Имя пользователя, учетной записью которого пользуется система. По умолчанию «AutelService».

DBInstanceName. Имя экземпляра сервера MSSQL. По умолчанию «MSSQLSERVER». Для доступа к службе, обеспечивающей работу БД. В момент запуска службы Oktell осуществляется проверка доступности БД. Если SQLServer, обслуживающий БД коммуникационного сервера, находится на том же компьютере, что и служба Oktell, то при невозможности обращения к БД Oktellпроверяет и перезапускает локальную службу SQLServer (указанный instance).

Если работа SQLServer осуществляется на другом компьютере, то во избежании запуска службы SQLServer на локальной машине в значение поля можно поставить «0». Октелл будет осуществлять бесконечное ожидание корректного подключения к БД перед началом загрузки, а сервер баз данных не будет загружать в ОЗУ свои данные, тем самым коммуникационный сервер будет гарантирован от кэширования данных на диск, и, как следствие, временных приостановок операционной системой работы всех служб и приложений в ожидании завершения операции, что достаточно критично при активных коммутациях.

DBConnectionString. Строка подключения, задаваемая явно. Используется при настройке подключения к службам SQL с индивидуальными параметрами, при которых не подходят параметры по умолчанию. При отсуствии этого свойства, или пустом его значении, подставляется строка:

"server=(local);database=oktell;uid=AutelService;pwd=[pwd];pooling=true",

где значения параметров server, database и uid подставляются из вышеописанных свойств. При явном указании строки подключения пароль может быть указан явно, либо использована последовательность символов «[pwd]», указывающая системе на необходимость подстановки пароля для логина AutelService.

DBTransactionLogSize_1, DBTransactionLogSize_2. Размеры транзакционных лог-файлов баз данных - основной и пространственной. По умолчанию по 500 МБ.

DBBackupDir. Путь к каталогу на сервере баз данных, в котором осуществляется создание резервных копий баз данных. По умолчанию это Backup в рабочей папке сервера. Однако в случае, если сервер баз данных работает на отдельном компьютере, путь должен существовать именно на нём.

DBAutoDailyBackup. «1» - устанавливает режим автоматического ежедневного резервного копирования баз данных одновременно с оптимизацией используемых баз данных. Режим оптимизации сам по себе настраивается в разделе Администрирование. Общие настройки. Управление базами данных. Если режим ежедневной оптимизации отключен, то вне зависимости от значения описываемого параметра резервная копия создана не будет. Cоздание файлов резервных копий производится на компьютере, где установлен текущий используемый MSSQLServer. Файлы размещаются в каталоге, установленном параметром DBBackupDir, а при его отсутствии в каталоге, путь к которому совпадает с рабочей папкой службы сервера в подкаталоге \Backup. Файлы резервных копий баз имеют названия db_ok.bak, db_okcc.bak, db_okset.bak, при ежедневном автоматическом создании резервных копий предыдущие резервные копии автоматически заменяются новыми. При необходимости осуществлять хранение нескольких копий за некоторый промежуток времени необходимо налаживать схему бэкапа или копирования файлов самостоятельно.

ScrBackupDir. Путь к каталогу на сервере АТС, в котором осуществляется создание резервных архивов со сценариями. По умолчанию это каталог Backup в рабочей папке сервера.

RepUpdateDir. Каталог с обновлениями отчетов call-центра.

DBUpdateDir. Каталог с обновлениями для БД.

DBUpdateDirExtern. Каталог с внешними обновлениями для БД. Расположенные здесь файлы с текстом, представляющим собой один совокупность нескольких SQL-batch, исполняются в БД по очередности их имен в момент запуска сервера. После успешного исполнения файлы удаляются. В случае возникновения ошибок их описание можно обнаружить в лог-журнале Exception.

ContactServerName. Тип подключения к драйверу ключа по умолчанию. В случае невозможности осуществляется перебор всех возможных вариантов.

ShowServerLogAtStartUp. При использовании серверного приложения «1» включает трассировку служебного лог-журнала в окно приложения.

CheckRecordDriveEmptySpace. «1» - осуществляет слежение за объемом свободного места на диске для записи разговоров. «0» - игнорирует проверку. Игнорирование может потребоваться при использовании сетевых дисков для записи, размер свободного пространства которых системой определяется нулевым. По умолчанию «1».

EnableEmptyAdmin. «1» - активирует на сервере возможность пользования учетной записью системного администратора. По умолчанию запись доступна только на сервере, где неактивен сервер состояний или среди учетных записей пользователей которого не существует ни одной, обладающей базовой ролью администратора. Может понадобиться в случае, если пароль учетной записи администратора утерян. Для применения требуется перезапуск службы сервера. По умолчанию «0».

EnableAutoMap. «1» - активирован режим, при котором авторизация с рабочего места, не имеющего в карте сети учетной записи, приводит к автоматической временной регистрации на сервере рабочего места, снабженного USB-телефоном. «0» - доступ с неизвестных рабочих станций заблокирован.

MixerDeleteSourceRecords. «1» - удалять исходные файлы записей коммутаций после упаковки и/или микширования, «0» - оставлять на месте. По умолчанию «1».

QueryWebServerPort. Устанавливает порт слушателя HTTP-запросов к серверной службе (например запрос http://localhost:4059/getlicense - команда на звонок через Oktell).

TaskListAbonentUseLikeNumber. «1» - позволяет активировать поиск абонентской строчки в таблице абонентов с фильтром "number like '%x%'". По умолчанию «0» и поиск осуществляется только по идентификатору абонента.

QueryWebServerPassword. Устанавливает пароль, проверяемый при поступлении всех HTTP-запросов к серверу. Пустое значение отменяет проверку.

EnableSipTransportFilter. «1» - активирует на сервере спам-фильтр, защищающий от атак на SIP-подсистему. При поступлении с одного IP-адреса за короткий отрезок времени чрезмерно большого количества регистрационных пакетов, завершающихся неудачей по причине неверной авторизационной информации, осуществляется блокирование адреса до момента перезапуска серверной службы. На все попытки регистрации с заблокированного IP-адреса сервер не отвечает никаким образом. «0» - режим отключен. По умолчанию «1».

FileServer_Log, FileServer_Record. Позволяет активировать сохранение соответственно лог-журналов и записей разговоров на удаленный файл-сервер. Значение задается в формате «address:port», например «192.168.0.199:4088». В качестве файлсервера может выступать любой компьютер с установленной и активированной службой oktell.FileService.exe из каталога серверной службы Oktell. О настройке и способах работы файл-сервера доступна [статья] в базе знаний.

FaceTimeLocalPort. Определяет порт локального сервиса видео-конференций. По умолчанию 4090.

FaceTimeServer. Определяет доступные серверы видео-конференций. Перечисляются через запятую с помощью алиасов, которые затем определяются отдельными ключами конфигурации. По умолчанию доступен только локальный сервер, но могут быть вместо или дополнительно настроены один или несколько обособленных серверов. Локальный сервер определяется алиасом «local». Например

<add key="FaceTimeServer" value="local, futurama, videoserver"/>

FaceTime_*. Определяет адрес и порт обособленного сервера видео-конференций. Вместо символа * подлежит указанию алиас сервера. Эта настройка должна присутствовать для каждого упомянутого алиаса кроме «local». Например

<add key="FaceTime_futurama" value="192.168.0.10:4092"/>

LicenseMode. Текущий режим лицензирования. По умолчанию «1» - использование файла сертификата.

CachedThreadFreeMode. Режим работы пула асинхронных потоков. «0» по умолчанию - использовать пул, никогда не уничтожать потоки, «1» - не использовать пул, уничтожать потоки сразу после использования, «2» - размещать в пул на 1 секунду, уничтожать по истечении в случае простоя.

RWLockType. Тип используемой критической секции читатель-писатель. «0» - стандартная System.Threading.ReaderWriterLock, «1» - переписанная на базе стандартных объектов. По умолчанию «1».

UseWlockForDynamicReg. «1» - использовать блокировку писателя при добавлении/удалении динамических рабочих мест. По умолчанию «0» - использовать блокировку читателя.

CheckReleaseRWOnAbort. По умолчанию «1» - производить дополнительную проверку блокировки критической секции сервера состояний перед освобождением асинхронного потока и освобождать в случае обнаружения. «0» - не производить.

Default_DateTime_Format. Индексированные параметры, определяющие нестандартныей варианты преобразования типа СТРОКА к типу ДАТАВРЕМЯ. Используются строки с индексами от 0 до 99, перебор в ходе работы осуществляется в порядке увеличения индексов.

SkipCloseMutexCommand. Режим автоматического закрытия сервера через мьютекс-команду необходим в целях исключения проблем с операциями обнаружения процессов. Встречаются системы, в которых отключены или недееспособны службы, необходимые для обнаружения внешнего процесса. В этом случае процесс копира не в состоянии при необходимости остановить серверный процесс перед обновлением и/или для перезапуска. «1» - пропускать команду закрытия, отданную через системные мьютексы процессом копира. «0» и другие значения - команда будет распознаваться и сервер будет реагировать на нее автоматическим закрытием.

DEBUG_incomingemail Логирование в common логе сервера принимаемых e-mail сообщений (pop3) "1" - включено. По умолчанию выключено.


Раздел LOG.

Хранит настройки лог-сервера комплекса. Среди неописываемых настроек - пути к папкам для сбора журналов.

LOG_storedays. Длительность хранения лог-журналов в днях. По умолчанию «7». По истечении указанного периода журналы удаляются системой. В некоторых случаях объем журналов может достигать нескольких гигабайтов за день.

LOG_maxfilesize. Максимальный размер одного файла лог-журнала в МБ. При достижении лог-журналом указанного размера логирование прекращается. Имеет воздействие на все лог-журналы, исключая HAL (Hardware). По умолчанию 3 ГБ.

LOG_maxpartsize. Позволяет настроить максимальный размер одного файла в МБ. По умолчанию 500 МБ. При достижении лог-журналом указанного размера формируется новый файл. Имеет воздействие на все лог-журналы, исключая HAL (Hardware).

LOG_root. Абсолютный или относительный путь к папке с лог-журналами. По умолчанию «Log», то есть относительный путь в каталоге серверной службы/приложения.


Раздел DEBUGGING.

Хранит настройки, согласно которым ведется заполнение служебного сервисного лог-журнала. По умолчанию все параметры выставлены в «1», что влечет полное логирование служб сервера. Полное или частичное отключение уменьшает размер журнала, однако не даст информации в случае возникновения сбоев и общением с технической поддержкой.


Раздел KEYREMOTE.

Хранит настройки для подключения к внешнему серверу, управляющему ключом защиты. Необходимо в редких случаях, если USB-порт на сервере не функционирует должным образом.

Параметры файла конфигурации клиентского приложения

Language. Определяет языковую схему, используемую клиентским приложением до момента подключения к соответствующему серверу. После подключения производится принудительная синхронизация языковой схемы. Фактически это происходит в момент отображения окна авторизации. Подробнее в описании ключа в разделе серверного приложения.

ServerSelectMode. Определяет, каким образом происходит выбор сервера в случае, если указано несколько адресов (нижеперечисленные ключи конфигурации). «0» - в окне авторизации отображается список серверов в соответствии с перечислением в конфигурационном файле. При автоматическом переподключении всегда берется последний активный сервер. «1» - осуществляется автоматический перебор серверов начиная с самого первого. Подключение производится к тому, который дал положительный ответ. При автоматическом подключении без окна авторизации в учет берется не только подключение, но и ответ авторизации. Таким образом будет активирован сервер, успешно подключенный и разрешивший вход. В этом случае в окне авторизации список серверов для выбора не отображается. «2» - перебор серверов осуществляется автоматически, начиная с последнего активированного. «3» - случайный выбор сервера. «4» - основной сервер единственный, при потере связи с ним подключение осуществляется к одному из резервных на основании случайного выбора. По умолчанию - 0.

ConnectBackReserve. «1» - активирует режим мониторинга за появлением основного сервера в случае, если текущее подключение установлено с резервным сервером. Применяется при настройке резервных схем с преимущественной привязкой к одному серверу.

NetConnectionName. Название подключения (сервера) для отображения в окне авторизации (при указании нескольких возможных подключений).

LogicServerAddress. Адрес для подключения к серверу логики.

LogicServerPort. Порт для подключения к серверу логики.

ConnectProtocol. Устанавливает протокол, по которому осуществляется подключение клиента к серверу. 0 - по умолчанию, 1 - Remoting, 2 - OkTCP.

NETCLIENT_SERVER_ADDRESS. Адрес для подключения к серверу аппаратуры.

NETCLIENT_SERVER_PORT. Порт на сервере для подключения к нему по сигнальному протоколу.

NETCLIENT_LOCAL_PORT. Локальный порт для обмена сигнальным трафиком по UDP.

NETCLIENT_VOICE_PORT. Локальный порт для обмена голосовым трафиком по UDP.


ВНИМАНИЕ! Вышеперечисленные параметры (NetConnectionName, ..., NETCLIENT_VOICE_PORT) определяют различные адреса и порты для организации сетевого канала подключения к серверу. Эти параметры могут присутствовать в конфигурационном файле несколько раз с добавлением к концу строки-ключа разных целочисленных индексов. Например NetConnectionName_1 и NetConnectionName_2. Индекс 0 не указывается, вместо него используется значение без индекса. В случае указания в конфигурационном файле нескольких подключений в окне авторизации будет отображен список их имен и доступен выбор одного из них. Это удобно использовать при работе с несколькими серверами с одних и тех же клиентских рабочих станций.


WORK_ROOTDIR. Устанавливает в явном виде путь к рабочей папке клиентского приложения. Временные файлы, сценарии, проекты, плагины, каталог по умолчанию для записи разговоров - все кроме основных сборок службы размещается именно там.

WORK_ROOTDIR_TYPE. Устанавливает один из нескольких возможных вариантов размещения рабочей папки. Используется, если не задана рабочая папка в явном виде. Возможные варианты: 0 – папка запустившего процесс выполняемого файла, 1 – папка размещения основных сборок приложения, 2 – Documents And Settings\All Users, 3 – Documents And Settings\CurrentUser.

AutoUpdate. «1» - обновлять клиента автоматически. «0» - не обновлять автоматически при запуске, если обнаружено отличие версий. По умолчанию «1». Настоятельно не рекомендуется оставлять рабочую версию программы со значением «0» и использовать этот режим только для отладочных целей.

AutoUpdateGateway. «1» - обновлять шлюз автоматически. «0» - не трогать. По умолчанию «0». В список шлюзов требуется добавить адрес сервера, если подключение производится к серверу с несколькими сетевыми интерфейсами через интерфейс с индексом более 1. В большинстве случаев указания не требуется.

ManualHostAddress. Альтернативный псевдо-адрес клиентского компьютера для идентификации на сервере в карте сети. Может быть использован для подключения к серверу при динамически выделяемом IP-адресе и сложностях с идентификацией по HostName. Каждый клиент должен иметь уникальное значение ключа, не совпадающее с реальными возможными адресами и именами других компьютеров сети.

TerminalAddress. Строка, определяющая уникальный адрес клиентского места. Приписывается ко всем адресам компьютера для определения клиентского места в карте офиса (например «FUTURAMA/terminal1»). Именно эту строку необходимо будет указать в карте офиса для идентификации. Решает проблему терминальных подключений, где все клиенты физически запускаются с одного компьютера. По умолчанию «».

TimeSynchronization. «1» - синхронизировать время с сервером при запуске, «0» - не синхронизировать. По умолчанию «1».

RestartApplicationWithProcess</span>. «1» - любой перезапуск клиента производится с выгрузкой процесса. «0» - выгрузка процесса производится только для применения обновлений, другие перезапуски осуществляются внутри процесса. По умолчанию «0».

ProcessPriority</span>. Приоритет процесса клиентского приложения и процесса обслуживания внешних звуковых устройств. «0» - нормальный, «1» - выше среднего, «2» - высокий, «3» - реального времени. По умолчанию «1».

HAL_skip_loading. «1» - пропускать загрузку модуля обслуживания устройств работы со звуком. «0» - нормальный режим.

Register_ocx. «1» - регистрировать библиотеки обслуживаемых устройств перед запуском, «0» - не регистрировать. По умолчанию «1».

ClientWebServerPort. Устанавливает порт слушателя HTTP-запросов к клиентскому приложению (например запрос http://localhost:4059/callto?number=184 - команда на звонок через Oktell). Доступ возможен только по локальному loopback интерфейсу.

ComAsyncEventing. Применяется для форсированной активации/отключения соответствующего режима COM-ядра без изменения кода приложения. Активирует/деактивирует режим раздачи событий COM-объекта в асинхронных служебных потоках. Применяется только в случае указания значений «1» или «0». По умолчанию применяется режим, установленный в коде внешнего интегрирующего приложения. Подробно в руководстве по интеграции (раздел «Октелл в других проектах», статья «Загрузка и выгрузка модуля»).

ComXmlFullLogging. Применяется для форсированной активации/отключения соответствующего режима COM-ядра без изменения кода приложения. Активирует/деактивирует режим полного логирования всех событий и вызовов управляющего объекта. Применяется только в случае указания значений «1» или «0». По умолчанию применяется режим, установленный в коде внешнего интегрирующего приложения. Подробно в руководстве по интеграции (раздел «Октелл в других проектах», статья «Загрузка и выгрузка модуля»).

TRACE_HARDWARE. Уровень трассировки аппаратного модуля. Битовая маска xxxx. C конца: 0 - TraceCall, 1-TraceEvents, 2-TraceVoice, 3-TraceNet. По умолчанию «1». Для полной трассировки значение «1111111111».

SEPARATE_PROCESS. «1» - запускать отдельный процесс для работы с устройствами. «0» - работать с устройствами в собственном процессе. По умолчанию «1».

JITTER_DEPTH. Значение глубины джиттер-буфера на клиенте, измеряемое в количестве пакетов по 20 мс. Минимальное значение - «0», по умолчанию - «6». При увеличении значения происходит рост задержки в голосовом обмене по направлению звука в локальное устройство, эффективнее устраняя влияние проблем сети. При указании «0» джиттер буфер не используется.

Если наблюдается поступление пакетов вперемешку с незначительным разбросом, и/или периодические задержки с последующим одновременным поступлением серии пакетов, увеличение значения может способствовать выравниванию звука. Для диагностики этого явления можно активировать логирование голосового трафика (TRACE_HARDWARE) или использовать программы-перехватчики трафика (снифферы), например WireShark.

WAVE_COUNT. Значение, определяющее количество буферов для обмена звуком со звуковым устройством. Минимальное значение - «2», по умолчанию - «2». При увеличении значения происходит рост задержки в голосовом обмене по направлению звука в локальное устройство, эффективнее устраняя влияние проблем в медлительности звукового устройства.

Если при ровно поступающем звуке из сети (диагностировать можно с помощью отладочной записи на входе - WAVE_COUNT, либо с помощью программ-перехватчиков трафика, например WireShark) наблюдается щелканье или пропадание кусков голосового потока, увеличение значения может способствовать выравниванию звука.

WRITE_VOICE. Отладочный параметр для оценки звукового потока на входе в клиентский HAL из сети до воспроизведения непосредственно в устройстве. «1» - отладочная запись в файл включена, файл с именем, соответствующим текущему времени размещается в корне клиентского приложения . «0» - отладочная запись отключена. По умолчанию «0».

WAVEIN_AUTOCLOSE. «1» - закрывать устройство ввода звука после завершения коммутации. «0» - оставлять открытым. По умолчанию «0».

WAVEOUT_AUTOCLOSE. «1» - закрывать устройство вывода звука после завершения коммутации. «0» - оставлять открытым. По умолчанию «0».

USE_DIRECTSOUND. Тип работы со звуком по умолчанию. Выбирается в клиентском интерфейсе. «1» - использовать для работы со звуком библиотеки DirectSound. «0» - обычный режим через системные функции Windows Multimedia (WMM). По умолчанию «0».

NETCLIENT_PAYLOAD. Кодек по умолчанию для обмена голосовым трафиком. Выбирается в клиентском интерфейсе. Здесь служит для задания начальной настройки. 0 - 711mulaw, 8 - 711alaw, 41 - gsm610. По умолчанию «8».

PHONEDEVICE_WAVEOUT. Устройство вывода звука (спикер) по умолчанию. Выбирается в клиентском интерфейсе. Здесь служит для задания начальной настройки.

PHONEDEVICE_WAVEIN. Устройство ввода звука (микрофон) по умолчанию. Выбирается в клиентском интерфейсе. Здесь служит для задания начальной настройки.

PHONEDEVICE. Имя устройства по умолчанию. Выбирается в клиентском интерфейсе. Здесь служит для задания начальной настройки.

SIGNAL_VOLUME. 0-100. Уровень громкости генерируемых в локальное устройство системных звуков и тонов. По умолчанию 50.

UseKeyHook. Параметр позволяет принудительно отключить режим перехвата действий клавиатуры для управления гарнитурой. Отключение может понадобиться при обнаружении проблем и конфликтов с операционной системой. «1» - режим перехвата активирован. «0» - режим перехвата деактивирован. По умолчанию «1». Выключение требуется на 64 разрядных ОС.

default_HeadSet_AutoHookUp. Определяет используемый по умолчанию режим автоподнятия трубки на гарнитуре при поступлении входящего звонка. После фактического изменения настроек пользователем в параметрах локального устройства значение из конфигурационного файла теряет актуальность. По умолчанию «1».

default_HeadSet_UseKeyBoard. Определяет используемый по умолчанию режим перехвата нажатий на клавиатуре для управления гарнитурой. После фактического изменения настроек пользователем в параметрах локального устройства значение из конфигурационного файла теряет актуальность. По умолчанию «1».

default_HeadSet_UseACM. Определяет, активен ли по умолчанию режим автодозвона для гарнитуры. После фактического изменения настроек пользователем в параметрах локального устройства значение из конфигурационного файла теряет актуальность. По умолчанию «1».

default_Phone_ShowRingPopup. Определяет используемый по умолчанию способ отображения информации о вызывающем абоненте (всплывающее окно/всплывающее уведомление). После фактического изменения настроек пользователем в параметрах локального устройства значение из конфигурационного файла теряет актуальность. По умолчанию «1».

WatcherResourceLogType. Формат логирования ресурсов. С помощью параметра можно настроить вывод в клиентский лог-журнал WATCHER информации по использованию процессом ресурсов системы. Объем используемой памяти, количество открытых дескрипторов, количество потоков, пользовательские системные ресурсы, ориентировочное среднее процессорное время по всему процессу и отдельно по всем его потокам. 0 - не логировать, 1 - информация о процессе каждую секунду, 2 - информация о процессе и активным потокам каждую секунду, 3 - информация о процессе и всем его потокам каждую секунду, 4 - информация о процессе каждую минуту. По умолчанию 4.

RestoreLastModules. «1» - осуществляет при загрузке приложения загрузку и восстановление модулей, активных перед закрытием программы. «0» - запускает приложение с пустым фоном без дополнительной загрузки модулей; это экономит время на загрузке, так как некоторые модули требуют достаточно длительного времени для полной загрузки, однако пользователь при необходимости сам может активировать модуль по стандартной схеме из главного меню. По умолчанию «1».

ShowVideoNoise. «1» - в видео-окне модуля ТЕЛЕФОН при отсутствии видео-сигнала отображается черно-белый шум, «0» - черное окно. По умолчанию «1».

CameraFrameFrequencyLimit. Устанавливает ограничение на количество передаваемых кадров из клиентского приложения в сеть в ходе видео-сессии. Может использоваться при необходимости снизить исходящий трафик при видео-коммутациях с настраиваемой клиентской рабочей станцией.

CameraJitterDepth. Глубина джиттер-буфера фреймов с камеры. Позволяет нивелировать задержку в выдаче кадров в целях выравнивания отправляемого видео-потока. По умолчанию «3». «0» - не использовать джиттер.

Phone_UseBlockedDelay. «1» - использует асинхронный отложенный механизм по выставлению заблокированного состояния модулю Телефон. «0» - заблокированное состояние выставляется сразу (может потребоваться при работе на медленных машинах, где асинхронность сказывается отрицательно с приведением телефона в недееспособное состояние. Рекомендуется изменять только при соответствующем запросе службы технической поддержки). По умолчанию «1».

Phone_ACMMode. Определяет порядок действий при нажатии на кнопку «Позвонить» в модуле Телефон. «0» - стандартная последовательность действий: сначала производится вызов абонента, потом обратный вызов пользователя. «1» - обратная последовательность: сначала производится вызов самого пользователя, потом абонента. См. раздел Телефон. Звонки.

HeadsetNonACMMode. Режим вызова с гарнитуры без использования автодозвона. «0» - поднятие трубки, таймаут, набор номера. «1» - сначала обратный вызов пользователя, потом набор абонента. По умолчанию «1».

UseAutoReconnectOnFly. При установке значения «1» в случае потери связи по каналу TCP между клиентом и сервером клиентское приложение будет пытаться переподключиться без перезагрузки. Неактуально при использовании протокола Remoting (по умолчанию порт 4050).

ShowHelpInside. Определяет, где отображать справку по системе. «0» - в отдельных процессах браузера по умолчанию, «1» - во встроенном браузере в окне клиентского приложения. По умолчанию «0».

PlugRegLoadType. Устанавливает режим загрузки при настройке plugin-программ. «1» - стандартный режим в отдельном домене с последующей выгрузкой. «2» - загрузка plugin-программ в отдельный процесс для настройки. Для загрузки plugin-библиотек используется запускающий модуль oktell.PluginStarter.exe, который может быть скопирован под другим названием. Используемая версия .NET Framework для работы плагина в отдельном процессе определяется в конфигурационном файле этого процесса (по умолчанию oktell.PluginStarter.exe.config). Сам же запускающий модуль (название файла в каталоге клиентского приложения) определяется в конфигурационном файле oktell (клиентском и возможно серверном) с ключом, зависящим от названия основной библиотеки plugin-программы. Например <add key="PluginTcp_libnamewithoutextension" value="oktell.PluginStarter2.exe"/>. Существующий модуль oktell.PluginStarter.exe может скопирован под другим именем и снабжен таким образом индивидуальным конфигурационным файлом. Это может понадобиться в частности для применения разных версий .NET Framework к разным plugin-программам.

AutoSortGroups. Устанавливает режим сортировки отделов для модуля Сотрудники по названиям. По умолчанию «1». В случае отключения ожидается, что сортировкой занимается хранимая процедура, результаты ее исполнения выводятся последовательно.

PersonalHandleDepartments. При установке значения «1» обновление состояний внутренних номеров в разделе «Сотрудники. Отделы» производится только для номеров, входящих в выделенный отдел. Имеет смысл применять для сокращения трафика.

SplitDepartmentsTreeByDot. «1» - осуществлять построение глубокого дерева вложенных отделов в модуле «Сотрудники», разбивая указанные для сотрудников отделы на категории по символу «.». «0» - одноуровневое дерево отделов. По умолчанию «0».

HandleSessionToChangeUserState. «1» - при блокировании сессии авторизованного пользователя windows производится автоматический перевод состояния авторизованного пользователя oktell в «Нет на месте». При возврате в сессию производится автоматический перевод в «На месте». При этом перевод не осуществляется, если в момент блокировки пользователь не был свободен (находился в разговоре, в резерве или в состоянии перерыва), при этом не производится и обратного перевода при входе в сессию. «0» - действие по автоматической смене состояний не применяется. По умолчанию «1».

RecordDownloadNameAddInfo. «1» - устанавливает режим выгрузки записей разговоров статистики с включением в имена файлов имен участвующих абонентов.

Memory_UseSameDialogForms. «1» - активирует режим использования одних и тех же окон в режиме операторских диалоговых форм без уничтожения и создания при каждом показе. Используется на компьютерах с минимальным объемом оперативной памяти во избежание скачкообразного роста используемой памяти. «0» - деактивирует режим. По умолчанию «0».

Debug_PingErrorRestart. «0» - отключает автоматическую перезагрузку клиентского приложения при отсутствии откликов сервера на команды Ping. Используется для отладочных режимов, в основном при отладке plugin-программ. «1» - обычный режим. По умолчанию «1».

PingTimeoutNotify. Устанавливает период в миллисекундах, при превышении которого в момент вызова метода Ping возникает уведомление о плохой связи с сервером.

ActivationServer. Ссылка на сайт активаций для режима автоматической активации тестовой версии. По умолчанию «http://activate.telsystems.ru».


Раздел LOG.

Хранит настройки лог-сервера комплекса. Среди неописываемых настроек - пути к папкам для сбора журналов.

LOG_storedays. Длительность хранения лог-журналов в днях. По умолчанию «7». По истечении указанного периода журналы удаляются системой. В некоторых случаях объем журналов может достигать нескольких гигабайтов за день.

LOG_maxfilesize. Максимальный размер одного файла лог-журнала в байтах. Имеет воздействие на все лог-журналы, исключая HAL (Hardware). По умолчанию 3 ГБ.

LOG_root. Абсолютный или относительный путь к папке с лог-журналами. По умолчанию «Log», то есть относительный путь в каталоге клиентского приложения.


helplinks. Тип используемой справки: «0» - встроенная справка в файле manual.chm, «1» - ссылка на вики. По умолчанию «1».

FaxPreperformProcess. Режим работы факса при отправке с клиентского приложения: «0» - обычный режим отправки изображений с преобразованием на сервере к необходимому виду. «1» - использование локального XPS-принтера для изготовления общего многостраничного файла TIFF из нескольких выбранных документов (для этого режима необходимы .NET Framework 3.0, установленный Microsoft Office версии 2003 или старше, установленный XPS принтер). По умолчанию «0».