Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

В сборках 5.2.840 - 5.2.863 эта команда запускает WCS также от пользователя flashphoner.

Настройка переменных окружения

Подготовка запуска и переменных окружения происходит в скрипте setenv.sh. В этом скрипте могут быть заданы дополнительные параметры для WCS Core. Кроме того, здесь же задается параметр, предотвращающий утечки памяти на многопроцессорных системах:

Code Block
languagebash
themeRDark
MALLOC_ARENA_MAX=4

Запуск с выводом в stdout

В некоторых случаях, например когда сервер не стартует и не выдает никаких ошибок, требуется запуск с прямым логгированием в консоль 'stdout'. Прямой вывод в stdout не может использоваться в production т.к. при закрытии консоли или потере SSH-соединения сервер будет остановлен. Поэтому рекомендуется использовать вывод stdout только в целях отладки.

...

Code Block
languagebash
themeRDark
cd /usr/local/FlashphonerWebCallServer/bin
sudo ./webcallserver start standalone

Запуск с различными правами пользователя

Запуск в сборках 5.2.864-5.2.972

Начиная со сборки 5.2.864, права, с которыми запускается WCS, подчиняются следующей логике:

...

Code Block
languagebash
themeRDark
./webcallserver start standalone

Запуск в сборках 5.2.976 и новее

Начиная со сборки 5.2.976, права, с которыми запускается WCS, определяются только настройкой в файле /usr/local/FlashphonerWebCallServer/bin/setenv.sh:

...

При этом сервис может стартовать от пользователя root, смена пользователя для запуска Java производится автоматически.

Настройка прав доступа к каталогам при запуске от пользователя flashphoner

В сборке 5.2.976 добавлена проверка возможности записи в каталоги сервера, а также в собственные каталоги, при запуске WCS от пользователя flashphoner. Если прав на запись не хватает, WCS не стартует с выводом сообщения на консоль и в лог /usr/local/FlashphonerWebCallServer/logs/startup.log

...

Code Block
languagebash
themeRDark
sudo ./webcallserver set-permissions

Параметры JVM

Параметры задаются в файле wcs-core.properies.

...

При запуске параметры JVM проверяются на совместимость с текущей установленной версией Java. Если JVM не может стартовать с заданными параметрами, информация об этом выводится в файл /usr/local/FlashphonerWebCallServer/logs/startup.log, в соответствии с диагнозом, возвращенным Java  при попытке запуска.

Автоматическое определение версии Java и корректировка параметров запуска

В сборке 5.2.972 добавлена возможность автоматического определения версии Java и корректировки параметров запуска при старте WCS, например, после обновления JDK. Параметры запуска JVM также могут быть скорректированы командой

...

Отметим, что выбранный сборщик мусора (GC) при этом не меняется, но могут быть изменены его настройки (например, наименование ключей запуска).

Проверка работоспособности сервера при запуске

После запуска сервера, скрипт webcallserver проверяет его работоспособность, ожидая ответа 200 OK на предназначенный для этого запрос

Code Block
themeRDark
GET http://localhost:8081/health-check HTTP/1.1

В сборке 5.2.1084 добавлен ключ запуска, позволяющий указать максимальное количество попыток проверки работоспособности

Code Block
languagebash
themeRDark
sudo ./webcallserver start --health-timeout 10

По умолчанию, предпринимается 10 попыток с паузой в 1 секунду между ними. При каждой попытке скрипт ожидает ответа в течение секунды. Таким образом, максимальное время ожидания готовности сервера может составить по умолчанию до 20 секунд (10 * (1+1)).

Если процесс WCS не ответил на запрос за указанное число пыток, в лог запуска и на консоль будет выведено сообщение

Code Block
themeRDark
FlashphonerWebCallServer started, but is not healthy, please try to restart

При необходимости, проверку можно отключить, указав нулевое количество попыток

Code Block
languagebash
themeRDark
sudo ./webcallserver start --health-timeout 0