v3_CN_LinuxService

SRS系统服务

Note: 如果觉得Github的Wiki访问太慢，可以访问 Gitee 镜像。

SRS提供多种启动的方式，包括：

在git目录直接启动，简单直接，但系统重启后需要手动启动。
系统服务，init.d脚本：SRS提供srs/trunk/etc/init.d/srs脚本，可以作为CentOS或者Ubuntu的系统服务自动启动。

可以直接下载release的binary，提供了几个常见系统的安装包，安装程序会安装系统服务，直接以系统服务启动即可。参考：Github: release或者国内镜像: release

Manual

若不需要添加到系统服务，每次重启后需要手动启动SRS，可以直接在srs的trunk目录执行脚本：

cd srs/trunk &&
./etc/init.d/srs start

init.d

SRS作为系统服务启动，需要以下几步：

安装srs：安装脚本会自动修改init.d脚本，将ROOT="./"改为安装目录。
链接安装目录的init.d/srs到/etc/init.d/srs
添加到系统服务，CentOS和Ubuntu方法不一样。

Step1: 安装SRS

编译SRS后，可执行命令安装SRS：

make && sudo make install

安装命令会将srs默认安装到/usr/local/srs中，可以在configure时指定其他目录，譬如./configure --prefix=`pwd`/_release可以安装到当前目录的_release目录（可以不用sudo安装，直接用make install即可安装。

Step2: 链接脚本：

sudo ln -sf \
    /usr/local/srs/etc/init.d/srs \
    /etc/init.d/srs

备注：若SRS安装到其他目录，将/usr/local/srs替换成其他目录。

备注：也可以使用其他的名称，譬如/etc/init.d/srs，可以任意名称，启动时也用该名称。

Step3:添加服务：

#centos 6
sudo /sbin/chkconfig --add srs

或者

#ubuntu12
sudo update-rc.d srs defaults

使用init.d脚本管理SRS

查看SRS状态：

/etc/init.d/srs status

启动SRS：

/etc/init.d/srs start

停止SRS：

/etc/init.d/srs stop

重启SRS：

/etc/init.d/srs restart

Reload SRS：

/etc/init.d/srs reload

日志切割，给SRS发送SIGUSR1信号：

/etc/init.d/srs rotate

平滑退出，给SRS发送SIGQUIT信号:

/etc/init.d/srs grace

systemctl

CentOS7使用systemctl管理服务，我们在init.d的基础上新增了systemctl的配置：

./configure && make && sudo make install &&
sudo ln -sf /usr/local/srs/etc/init.d/srs /etc/init.d/srs &&
sudo cp -f /usr/local/srs/usr/lib/systemd/system/srs.service /usr/lib/systemd/system/srs.service &&
sudo systemctl daemon-reload && sudo systemctl enable srs

Remark: 必须拷贝srs.service，否则在enable srs时会出错。

使用systemctl启动SRS服务：

sudo systemctl start srs

Gracefully Upgrade

Gracefully Upgrade是平滑升级，就是指老的连接服务完后退出，新版本的服务继续提供服务，对业务没有影响，涉及的技术包括：

解决侦听冲突的问题，新版本的服务进程也需要侦听同样的端口，才能提供服务。一定时间内，新老进程是同时提供服务的。
老进程关闭侦听，不再接受新连接。老进程上就只有已经存在的连接，等老的连接服务完后再退出。这就是Gracefully Quit平滑退出。

Note: 关于这个机制，这里#1579有更多的探讨。

SRS3主要支持Gracefully Quit平滑退出：

使用信号SIGQUIT作为平滑退出信号，也可以使用服务命令/etc/init.d/srs grace。
新增配置，grace_start_wait，等待一定时间后开始GracefullyQuit，等待Service摘除Pod，默认2.3秒，参考#1579。
新增配置，grace_final_wait，等待连接退出后，需要等待一定的时间，默认3.2秒，参考#1579。
新增配置，force_grace_quit，强制使用Gracefully Quit，而不用Fast Quit，原因参考#1579。

# For gracefully quit, wait for a while then close listeners,
# because K8S notify SRS with SIGQUIT and update Service simultaneously,
# maybe there is some new connections incoming before Service updated.
# @see https://github.com/ossrs/srs/issues/1595#issuecomment-587516567
# default: 2300
grace_start_wait 2300;
# For gracefully quit, final wait for cleanup in milliseconds.
# @see https://github.com/ossrs/srs/issues/1579#issuecomment-587414898
# default: 3200
grace_final_wait 3200;
# Whether force gracefully quit, never fast quit.
# By default, SIGTERM which means fast quit, is sent by K8S, so we need to
# force SRS to treat SIGTERM as gracefully quit for gray release or canary.
# @see https://github.com/ossrs/srs/issues/1579#issuecomment-587475077
# default: off
force_grace_quit off;