...

Если серверный процесс запущен и в логах нет ошибок, это означает что WCS сервер готов к работе и можно начинать тестирование.

Способы запуска

Запуск

...

как сервиса 

Запуск WCS как сервиса осуществляется командой:

sudo systemctl start webcallserver

Начиная со сборки 5.2.801, WCS запускается как сервис от пользователя flashphoner для большей безопасности.

Кроме этого запуск может быть осуществлен командой:

cd /usr/local/FlashphonerWebCallServer/bin
sudo ./webcallserver start

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

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

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

В сборке 5.2.1537 тип сервиса изменен с simple на forking. Кроме того, права доступа к файлу, содержащему PID основного процесса WCS, приведены в соответствие с требованиями systemd. Сервис помечается как active (running), и systemd, при необходимости. может послать сигнал для остановки основного процесса непосредственно ему

Image Added

Автоматический перезапуск сервиса при сбоях

В сборке 5.2.1562 добавлен автоматический перезапуск сервиса webcallserver.service  в тех случаях, когда сервис по каким-либо причинам перешел в статус failed. Предпринимается до 5 попыток перезапуска в случае, если между попытками проходит не более 2 минут.

Сервис по-прежнему может быть остановлен или  запущен вручную. Если сервис остановлен вручную, попытки перезапуска предприниматься не будут.

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

MALLOC_ARENA_MAX=4

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

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

...

cd /usr/local/FlashphonerWebCallServer/bin
sudo ./webcallserver set-service-restart disable

Запуск из командной строки

При необходимости, запуск WCS может быть осуществлен командой:

cd /usr/local/FlashphonerWebCallServer/bin
sudo ./webcallserver start

Этот способ запуска полезен при отладке и тестировании.

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

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

cd /usr/local/FlashphonerWebCallServer/bin
sudo ./webcallserver start standalone

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

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

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

1. Команда

sudo systemctl start webcallserver

запускает WCS всегда от пользователя flashphoner, если он есть в системе

2. Команда

MALLOC_ARENA_MAX=4

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

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

Для того чтобы запустить сервер в данном режиме, необходимо выполнить команду:

.cd /usr/local/FlashphonerWebCallServer/bin
sudo ./webcallserver start

...

 standalone

Запуск с выводом лога JVM в файл

В сборке 5.2.1562 добавлена возможность запустить WCS с выводом лога JVM в файл, аналогично прямому выводу в stdout 

sudocd ./webcallserver start

или от пользователя flashphoner, если запущена другим пользователем

Это касается и запуска с выводом на консоль

/usr/local/FlashphonerWebCallServer/bin
sudo ./webcallserver start standalone

...

--java-log

Весь вывод Java машины в этом случае перенаправляется в файл /usr/local/FlashphonerWebCallServer/logs/java.log. Данную возможность следует использовать только в целях отладки, но не в промышленной эксплуатации, т.к. объем вывода в этот файл будет очень большим.

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

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

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

1. Команда

WCS_NON_ROOT=true

WCS запускается от пользователя flashphoner

...

sudo systemctl start webcallserver

запускает WCS всегда от пользователя flashphoner, если он есть в системе

2. Команда

WCS_NON_ROOT=false

WCS запускается от пользователя root.

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

Параметры JVM

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

Дополнительные опции запуска могут быть также добавлены в файле bin/setenv.sh в следующие переменные:

WCS_JAVA_OPTS - список опций для WCS Core

...

./webcallserver start

запускает WCS от пользователя root, если она выполнена с правами root, например.

sudo ./webcallserver start

или от пользователя flashphoner, если запущена другим пользователем

Это касается и запуска с выводом на консоль

./webcallserver start standalone

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

Начиная со сборки 5.2.976, права, с которыми запускается WCS, определяются только настройкой в файле /usr/local/FlashphonerWebCallServer/logsbin/startup.log, в соответствии с диагнозом, возвращенным Java  при попытке запуска.

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

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

При значении по умолчанию

cd /usr/local/FlashphonerWebCallServer/bin
sudo ./webcallserver set-java-opts

При этом меняются настройки в файле wcs-core.properies, предыдущие настройки копируются в файл с расширением .backup и порядковым номером, например

[root@localhost ~]# ls -l /usr/local/FlashphonerWebCallServer/conf/wcs-core.properties.backup.*
-rw-r--r--. 1 flashphoner flashphoner 1614 Jun 23 10:15 /usr/local/FlashphonerWebCallServer/conf/wcs-core.properties.backup.0
-rw-r--r--. 1 flashphoner flashphoner 1543 Jun 23 10:17 /usr/local/FlashphonerWebCallServer/conf/wcs-core.properties.backup.1

...

WCS_NON_ROOT=true

WCS запускается от пользователя flashphoner

При

WCS_NON_ROOT=false

WCS запускается от пользователя root.

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

Изменение режима запуска

В сборке 5.2.1255 добавлена команда для изменения режимов запуска:

• переключение в режим запуска от пользователя root  

sudo ./webcallserver set-root-mode enable

• переключение в режим запуска от пользователя flashphoner 

sudo ./webcallserver set-root-mode disable

При этом WCS будет остановлен перед внесением изменений в настройки и автоматически запущен после внесения изменений

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

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

FlashphonerWebCallServer cannot be started from user flashphoner, please fix the permissions to the folders or run 'webcallserver set-permissions'!

В этом случае необходимо выполнить команду

sudo ./webcallserver set-permissions

Параметры JVM

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

Дополнительные опции запуска могут быть также добавлены в файле bin/setenv.sh в следующие переменные:

WCS_JAVA_OPTS - список опций для WCS Core

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

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

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

cd /usr/local/FlashphonerWebCallServer/bin
sudo ./webcallserver set-java-opts

При этом меняются настройки в файле wcs-core.properies, предыдущие настройки копируются в файл с расширением .backup и порядковым номером, например

[root@localhost ~]# ls -l /usr/local/FlashphonerWebCallServer/conf/wcs-core.properties.backup.*
-rw-r--r--. 1 flashphoner flashphoner 1614 Jun 23 10:15 /usr/local/FlashphonerWebCallServer/conf/wcs-core.properties.backup.0
-rw-r--r--. 1 flashphoner flashphoner 1543 Jun 23 10:17 /usr/local/FlashphonerWebCallServer/conf/wcs-core.properties.backup.1

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

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

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

GET http://localhost:8081/health-check HTTP/1.1

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

sudo ./webcallserver start --health-timeout 10

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

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

FlashphonerWebCallServer started, but is not healthy, please try to restart

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

sudo ./webcallserver start --health-timeout 0