多协议、性能稳定、丰富API的流媒体服务器软件
您现在的位置:首页  >  文档  >  升级

对于2B的行业应用软件,一般意义上的"升级"是指在现有版本的基础上,安装升级包,或者执行某个升级脚本。必须指出,这是针对软件安装过程比较复杂的情况。

我们的Ti Top Streamer的安装非常简单,所以,我们更倾向于采用先卸载再全新安装新版本的方式进行"升级"。

在这里,我们把这个升级过程做一个说明:

一、备份现有版本的所有配置文件


Ti Top Streamer的配置文件都保存在安装目录下的conf目录下(默认是/usr/local/TiTopStreamer/conf)

备份的位置,可以是任意位置,比如/usr/local/mybak, 如果没有这个目录,请创建这个目录。 创建目录和备份命令如下所示:

mkdir /usr/local/mybak
cp /usr/local/TiTopStreamer/conf /usr/local/mybak -r

此外,如果您的安装目录下有其它资源文件,比如录制的视频,也请先转移到其它目录下(之所以用"转移"这个词,而不是"备份",是考虑到视频类文件比较大,多余的备份会占用更多的磁盘空间)。

二、卸载现有版本


卸载过程非常简单,我们也准备了说明文档,请看这里 卸载Ti Top Streamer软件

三、安装最新版本


一样,安装过程也非常简单,我们也准备了说明文档,请看这里 安装Ti Top Streamer软件

四、恢复之前备份的配置文件


这一步,就是将之前备份的配置文件,拷贝到现在的安装目录下的conf下,替换这个目录下的现有文件。但要注意的是"它并不是简单的拷贝回来、全盘覆盖"。 原因在于,相对于旧版本,新版本在配置文件的结构上也可能有变化,这种变化一般发生在有新功能发布导致版本差异比较大的情况。 所以,为了保险起见,我们给出如下建议:


  • 1、你最好要非常清楚每一个配置文件里面都保存了什么样的配置信息,这样你才能知道到底需不需要把它拷贝回来,在拷贝回来时,到底有没有什么风险?

    举个例子: server.license,它就是一个文本文件,里面保存的就是您的授权Key信息。所以,你肯定要把它拷贝回来。当然了,如果你早就把你的授权key做了备份了,这时候在界面上重新配置一下,也没问题。

  • 2、如果你心里对你之前的配置非常清楚,而这些配置信息非常简单,那么你就不用非得从备份文件里去拷贝回来,你只需要在新版本的软件上重新配置即可。

    举个例子: 你在原来的软件版本中只是将hls流服务的TCP端口从8080改到了80,其它都是默认配置。那你只需要在新的软件版本上做同样的操作,将端口修改为80即可,根本用不着将之前的配置文件拷贝过来。

    再举个例子:你在原来的软件版本中添加了一个叫做"live2"的Application,它的流都是拉取第三方rtmp流而来的,并且你只添加了一路流,这个路流的rtmp url,你也很清楚是什么。那么你就可以直接在新的软件版本上 重新添加这个"live2"的Application,然后添加这路rtmp流。

    我们之所以这么谨慎,没有直接拷贝和替换文件,就是担心新的版本已经调整了配置文件的数据结构,你把以前的配置文件拷贝回来,替换掉了最新的配置文件,风险自然就来了。(当然,必须说,随着软件功能日趋稳定,这种情况是非常少的)

  • 3、有些配置文件,您不需要将它们拷贝回来。前面,在第一步,我们做备份时,为了简便期间,我们备份了整个conf目录。但其实并不是这里面的每一个文件都需要备份。 大家都知道,配置文件都是文本文件,体积非常小,我们没有必要列出来哪一个文件要备份的,哪一个文件不需要备份。我们只是说把conf目录备份下来即可。

    所以,到这一步,我们就必须指出,哪些文件,你不用把它拷贝回来,而且拷贝回来,肯定会有风险。

    text_en.txt 和 text_zh.txt,这两个文件里保存的是界面上需要的菜单文字或说明性的文字,为了支持多种语言,我们为每一个语种做了同样的配置,text_en.txt就是英文的, 而text_zh.txt就是中文的。 显然,这俩个文件,你不需要把它们拷贝回来,用当前新版本的就可以了。

  • 4、有些配置文件,你肯定需要把它们拷贝回来。
    在Ti Top Streamer软件里,只有当你在某一个Application下配置了很多拉流地址,或者很多转推地址。这些url地址,你一个个重新添加很费劲。这时,当然就需要从原来的已经备份的配置文件中拷贝回来。 这些配置文件都在某个应用的目录下。它们是Ti Top Streamer中,由用户自己配置的、也是最常用的配置信息。

    举个例子,在"live2"的Application下(对应conf/live2目录下),您配置了20路rtmp拉流url (对应conf/live2/source目录下的所有.stream文件),这些配置,你要是一个个重新添加,确实有点费力, 20个还好说,如果100路呢?所以这些文件,你是完全可以拷贝过来的。(这些文件的内容是按json格式组织的,结构一般不会变化)。

五、检查和重启服务


最后一步,你需要做的就是,将之前备份的配置文件,和新版本下面的配置文件,一一做个对比,看一下字节大小,如果不一致,对比着检查一下即可(就那么几个文件,5分钟就能检查完了)。

当有不一样的地方,你要仔细看看,是因为你自己在原有版本上做了什么配置,而新版本中没有做这个配置导致的,还是因为新版本本来就发生了变化。

当然了,我们也把所有配置文件的作用做了一个说明,请看这里: 关于配置文件的说明

总之,细心一点,升级就不会有问题。

至此,升级过程完成!重启一下Ti Top Streamer服务即可。

。。。。。。

如果升级后,发现运行有问题,需要回退吗?一般不会发生这种情况,有问题,请及时联系我们即可。如果你的业务非常重要,一旦出现问题,会造成很大的影响,那么你需要做的是先在测试服务器上升级,确认没有问题了,再到正式线上系统去升级。