Описание конфигурационного файла server.ini:
s.1.Секция Server:
s.1.1. Параметр PresentServerAddress - адрес, который сервер будет передавать FRN-System-Manager как адрес сервера в неавтономных режимах; именно по этому адресу FRN-System-Manager будет проверять работоспособность сервера;
s.1.2. Параметр PresentServerPort - номер порта, который сервер будет передавать FRN-System-Manager как номер порта сервера в неавтономных режимах; именно по этому номеру порта FRN-System-Manager будет проверять работоспособность сервера;
s.1.3. Параметр ServerOwnerEMail - адрес е-почты владельца сервера;
s.1.4. Параметр ServerCharsetName - имя ANSI кодировки FRN для всего сервера, в которую будут перекодироваться национальные имена сетей(комнат) из списка в файле networks.cfg для последующей передачи списка сетей(комнат) для FRN-клиентов с поддержкой только кодировки ANSI; FRN-клиенты с поддержкой UNICODE будут всегда получать список сетей(комнат) в кодировке UTF-8; для каждой из сетей(комнат) по желанию может быть назначена своя собственная кодировка; для своего языка имя кодировки ANSI следует устанавливать по имени текущей кодировки ANSI в операционной системе Windows с вашим языком; это связано с тем, что оригинальные клиент и сервер FRN работают только под Windows и пользуются ее текущими кодировками ANSI; таким образом, например, в для русского языка в FRN при передаче национальных символов в оригинальном протоколе используется кодировка WINDOWS-1251 - текушая ANSI кодировка на русскоязычных Windows; имя кодировки ANSI для FRN для вашего языка следует смотреть на компьютере Windows c вашим языком командой сервера ansi (s.0.14);
s.1.5. Параметр BackupServerAddress - адрес резервного сервера для FRN-клиента;
s.1.6. Параметр BackupServerPort - номер порта резервного сервера для FRN-клиента;
s.1.7. Параметр ListenServerPorts - [ревизия 4210+] список номеров фактически прослушиваемых портов для входящих соединений от FRN-клиентов; может быть несколько через пробел; по умолчанию используется значение из серверного параметра PresentServerPort (s.1.2);
s.1.8. Параметр DefaultNetworkName - [ревизия 4210+] имя сети(комнаты), в которую будут подключаться FRN-клиенты, пытающиеся подключиться в отсутствующую на сервере сеть(комнату); не рекомендуется назначать комнату с ограниченным доступом;
s.1.9. Параметр IPVersion - [ревизия 4210+] используемые для ожидания входящих клиентских соединений версии протокола IP: "4" - IPv4; "6" - IPv6; "46" - оба, используется по умолчанию;
s.1.10. Параметр ManagerMode - [ревизия 4630+] режим взаимодействия с FRN-System-Manager для всего сервера целиком; до ревизии 4630 этот параметр находился в секции Manager; каждой сети(комнате) в файле networks.cfg может быть назначен свой собственный режим; допустимые значения:
s.1.10.1. - значение Standalone или S - автономный режим, взаимодействие с FRN-System-Manager не производится; по умолчанию;
s.1.10.2. - значение Notify или N - сервер делает попытку уведомить FRN-System-Manager о подключающемся FRN-клиенте, однако отрицательные ответы от FRN-System-Manager игнорируются, а клиент допускается в сеть(комнату) с учетом прав доступа к конкретной сети(комнате);
s.1.10.3. - значение Light или L - в случае, если FRN-System-Manager недоступен, то сервер допускает подключающегося FRN-клиента с учетом прав доступа к конкретной сети(комнате), при восстановлении работоспособности FRN-System-Manager клент будет проверен и отключен при получении отрицательного ответа от FRN-System-Manager; если же FRN-System-Manager работоспособен, то подключающийся FRN-клиент допускается с учетом ответа от FRN-System-Manager и прав доступа к конкретной сети(комнате);
s.1.10.4. - значение FRN или F - в случае, если FRN-System-Manager недоступен, то сервер не допускает подключающихся клиентов; если же FRN-System-Manager работоспособен, то подключающийся FRN-клиент допускается с учетом ответа от FRN-System-Manager и прав доступа к конкретной сети(комнате);
s.1.10.5. Примечание: сервер не ведет список (кэш) корректных паролей клиентов; эта функция заменена режимом Light (s.1.10.3);
s.1.11. Параметр MaxTotalConnections [ревизия 4630+] - общее максимальное число входящих соединений на весь сервер; по умолчанию - 1000;
s.1.12. Параметр ClientHandshakeTimeout [ревизия 4630+] - время в секундах, за которое клиент должен авторизоваться после подключения к серверу; минимальное - 1 секунд; максимальное - 20 секунд; по умолчанию - 2 секунды;
s.1.13. Параметр ClientActivityTimeout [ревизия 4630+] - время в секундах, через которое соединение с клиентом будет разорвано в случае, если клиент не отвечает на какие-либо команды протокола, например, из-за плохого сетевого соединения; минимальное - 3 секунды; максимальное - 30 секунд; по умолчанию - 8 секунд;
s.1.14. Параметр MaxSpeechTime - [ревизия 4690+] - максимальная длительность одного включения (разговора) корреспондента в секундах для всего сервера; минимальное - 10 секунд; максимальное - 1800 секунд (30 минут); по умолчанию - 300 секунд (5 минут); для каждой сети(комнаты) можно установить свое собственное максимальное время разговора атрибутом сети(комнаты) MaxSpeechTime (n.3); смотри также серверный параметр SpeechLimit (s.1.19)
s.1.15. Параметр SpeechPause - [ревизия 4690+] - принудительная пауза между включениями корреспондентров для всего сервера в миллисекундах; минимальная и по умолчанию - 0 мс; максимальная - 10000 мс (10 секунд); для каждой сети(комнаты) можно установить свою собственную принудительную паузу атрибутом сети(комнаты) SpeechPause (n.13);
s.1.16. Параметр ClientSessionMaxTime - [ревизия 5059+] - максимальная для всего сервера длительность клиентского подключения в секундах, по истечении которого клиент будет отключен от сервера и должен будет выполнить повторное подключение; по умолчанию 0 - нет ограничения длительности подключения; для каждой сети(комнаты) можно установить свое собственное ограничение длительности клиентского подключения атрибутом сети(комнаты) ClientSessionMaxTime (n.15);
s.1.17. Параметр ManagerInvalidPasswordScript - [ревизия 5115+, только UNIX/Linux ] - внешняя программа (скрипт) для запуска в случае получения от FRN System Manager ошибки "Неверный пароль"; эта внешняя программа (скрипт) может [пере]запросить новый статический пароль с помощью команды register (0.4.12) клиента AlterFRN; далее е-почта с новым статическим паролем может быть автоматически получена каким-нибудь сборщиком почты, например, fetchmail, а сам новый пароль может быть применен командами setmanpassidx (s.0.9), setmanpassaddr (s.0.10), dsetmanpassidx (s.0.12) и dsetmanpassaddr (s.0.13) сервера AlterFRN. Каждая секция [Manager], [Manager1] и [Manager2] может содержать свой собственный параметр ManagerInvalidPasswordScript (s.2.6) для задания индивидуального обработчика неверного пароля для конкретного FRN System Manager; Смотри также возможный пример такого скрипта.
s.1.18. Параметр MaxWaitConnections - [ревизия 5170+] - максимальное количество входящих соединений, одновременно ожидающих обработку сервером - параметр backlog для вызова listen; по умолчанию - 5;
s.1.19. Параметр SpeechLimit - [ревизия 5170+] - включить или выключить ограничение максимальной длительности одного звукового сообщения от корреспондента; допустимые значения: No, Yes; по умолчанию: Yes - ограничение включено; для каждой комнаты можно отдельно включить или выключить ограничение длительности разговора атрибутом сети (комнаты) SpeechLimit (n.16); смотри также серверный параметр MaxSpeechTime (s.1.14);
s.1.20. Параметр ShortFrames - управление поддержкой коротких звуковых пакетов по 40 мс для всего сервера; допустимые значения: No, Yes; по умолчанию: Yes - поддержка включена; для каждой комнаты можно отдельно управлять поддержкой коротких пакетов атрибутом сети (комнаты) ShortFrames (n.17);
s.1.21. Параметр QuarantineTime - [ревизия 6075+] - время задержки в миллисекундах между техническим подключением клиента и его появлением в списке подключенных клиентов; карантин предназначен для исключения появления подергивания списка подключенных клиентов при тестировании работоспособности сервера оригинальным FRN-клиентом; по умолчанию 0; каждая комната может иметь свою собственную установку времени карантина;
s.1.22. Параметр MaxConnectionsPerAddress - [ревизия 6075+] - максимальное количество соединений с одного IP адреса; по умолчанию 7;
s.1.23. Параметр ManagerEmptyDescription - [ревизия 6701+] -- глобальный для всего сервера -- активирует отправку на FRN System Manager пустое значение поля "Описание" (Description) вместо фактически полученного от клиента. Допустимые значения: No, Yes; по умолчанию: No - будет отправляется настоящее описание от клиента.
s.2. Секция Manager [ревизия 4210+] и секции Manager1, Manager2 [ревизия 4642+] и секция Manager3 [ревизия 6701+]:
s.2.1. Параметр ManagerEnabled - разрешение использовать конкретную секцию подключения к FRN System Manager; допустимые значения: No, Yes; по умолчанию No;
s.2.2. Параметр ManagerAddress - доменное имя или IP-адрес желаемого FRN System Manager; по умолчанию sysman.lpd-net.ru;
s.2.3. Параметр ManagerPort - номер порта желаемого FRN System Manager; по умолчанию 10025;
s.2.4. Параметр ManagerAuthEMail - адрес е-почты для авторизации на желаемом FRN System Manager; по умолчанию используется значение из параметра ServerOwnerEMail (s.1.3);
s.2.5. Параметр ManagerAuthPassword - пароль для авторизации на желаемом FRN System Manager;
s.2.6. Параметр ManagerInvalidPasswordScript - [ревизия 5115+, только UNIX/Linux ] - внешняя программа (скрипт) для запуска в случае получения от этого FRN System Manager ошибки "Неверный пароль", если отличается от значения серверного параметра ManagerInvalidPasswordScript (s.1.17);
s.2.7. Параметр ManagerEmptyDescription - [ревизия 6701+] - активирует отправку на этот конкретный FRN System Manager пустое значение поля "Описание" (Description) вместо фактически полученного от клиента. Допустимые значения: No, Yes; по умолчанию используется значение серверного параметра ManagerEmptyDescription (s.1.23).
s.3. Секция [System] [ревизия 4210+]:
s.3.1. Параметр PidFile - [только UNIX/Linux] - имя файла с номером фонового процесса (демона) - PID-файла; по умолчанию /var/run/frnserver.pid; смотри также команду daemon (s.0.1);
s.3.2. Параметр LogFile - имя файла журнала событий сервера AlterFRN для комaнд daemon (s.0.1) и run (s.0.2) сервера AlterFRN; значение по умолчанию ./frnserver.log;
s.3.3. Параметр LogClientLevel - [ревизия 4642+] уроверь журналирования событий на клиентстких подключениях:
s.3.3.1. Значение 0 - не журналировать клиентских событий вообще;
s.3.3.2. Значение 1 - опасные события, например, пустые подключения или подключения неверным протоколом;
s.3.3.3. Значение 2 - предупреждения и опасные события; по умолчанию;
s.3.3.4. Значение 3 - ошибочные клиентские подключения и всё предыдущее;
s.3.3.5. Значение 4 - успешные подключения клиентов и всё предыдущее;
s.3.3.6. Значение 5 - входящие соединения и всё предыдущее;
s.3.4. Параметр LogExec - [ ревизия r5172+] - записывать в журнал старт внешних программ(скриптов) с их параметрами командной строки; допустимые значения: No, Yes; по умолчанию: No;
s.3.5. Параметр ListDelimiter -- [ ревизия r5820+] -- разделитель списка клиентов в командах list (s.0.16) и listnet (s.0.17); по умолчанию - ";" - точка с запятой;
s.3.6. Параметр DataChangeScript -- [ только Linux/UNIX, ревизия r6333+] -- имя внешней программы(скрипта), который будет вызываться при любом изменении файлов данных (*.dat-файлов) сервера AlterFRN; параметрами командной строки этому скрипту передается тип измененных данных и полное имя файла данных; может быть использован для синхронизации баз данных основного и резервных серверов совместно с freread*-командами сервера AlterFRN;
s.3.7. Параметр DataDir -- [ ревизия r6333+] -- имя каталога, в котором сервер будет сохранять рабочие файлы данных (*.dat-файлы); по умолчанию это каталог, в котором расположен исполняемый файл самого сервера;
s.6. Секция [Command] -- [ревизия 5817+] -- внутренний командный интерфейс сервера AlterFRN; используется для внутреннего (локального) управления сервером владельцем.
s.6.1. Параметр CommandEnabled - разрешение на работу коммандного интерфейса сервера AlterFRN, запускается прослушивание коммандного порта на локальном интерфейсе localhost; допустимые значения: No, Yes; по умолчанию: No(запрещено);
s.6.2. Параметр CommandPort - номер порта коммандного интерфейса сервера AlterFRN; по умолчанию: 10023. При использовании нескольких работающих копий AlterFRN-сервера для избежания конфликтов необходимо использовать различные номера коммандного порта для каждой работающей копии.
s.6.3. Параметр CommandIPVersion - используемые для ожидания входящих коммандных соединений версии протокола IP: "4" - IPv4, по умолчанию; "6" - IPv6; "46" - оба IPv6 и IPv4;
s.6.4. Параметр CommandPreferIPv4 - предпочитать коммандное соединение по протоколу IPv4; допустимые значения: No, Yes; по умолчанию: Yes - предпочитается выполнять коммандное соединение по IPv4;