TeamTalk安装部署手册
TeamTalk安装部署手册
一、部署环境
操作系统：CentOS 7 X64（由于gcc版本问题，官方推荐centos7），
CPU：2核
内存：1024M
硬盘：8G
虚拟机：VirtualBox4.3.28
用户：root
二、编译依赖环境
###编译环境
部署前须安装：gcc、gcc-c++、zip、unzip、wget、net-tools.x86_64
TeamTalk编译需要依赖一些最新的c++标准,建议使用CentOS7.0,如果使用的是CentOS6.x,需要将g++版本升至支持c++11特性,升级脚本可以使用：TeamTalk-master\auto_setup\gcc_setup.sh
###第三方库
TeamTalk使用了许多第三方库，包括protobuf,hiredis,mariadb(mysql),log4cxx等等,在第一次编译TeamTalk之前,建议先执行TeamTalk-master\server\src下的：
protobuf:make_protobuf.sh
hiredis:make_hiredis.sh
mariadb:make_mariadb.sh
log4cxx:make_log4cxx.sh
这些脚本执行完后会自动将头文件和库文件拷贝至指定的目录
注：以上脚本为一键部署脚本，想要一步步手动部署可参考网上资料：
http://www.bluefoxah.org/teamtalk/new_tt_deploy.html
若安装MariaDB*.rpm时出现错误，可自行安装MariaDB、mariadb-devel.x86_64
三、编译协议文件
所有的协议文件在pb目录下，其中有create.sh以及sync.sh两个shell脚本。
create.sh的作用是使用protoc将协议文件转化成相应语言的源码。
sync.sh是将生成的源码拷贝到server的目录下。
注：运行以上脚本时要设置环境变量：
exportPATH=/root/TeamTalk-master/server/src/protobuf/bin:$PATH
四、编译服务端
当以上步骤都完成后，可以使用TeamTalk-master\server\src下的"./build.shversion 1"编译整个TeamTalk工程,一旦编译完成，会在上级目录生成im_server_x.tar.gz包。
五、安装说明
TeamTalk整套服务提供模块部署脚本和一键部署方案，主要模块有NGINX,PHP,MARIADB(MYSQL),REDIS,IM_WEB,IM_SERVER,其中IM_WEB,IM_SERVER为自主开发模块,其余均为开源解决方案,一键部署在auto_setup目录下:
注：
将TeamTalk-master\server\im_server_x.tar.gz拷贝至TeamTalk-master\auto_setup\im_server
将TeamTalk-master\php更名为tt并打包压缩拷贝至TeamTalk-master\auto_setup\im_web，否则会报如下错误:unzip: cannot find or open tt.zip, tt.zip.zip or tt.zip.ZIP。
setup.sh是部署总入口，会分别调用二级目录下的setup.sh执行安装部署过程。
###NGINX:
无需改动
###PHP:
在conf目录下包含两个配置文件php-fpm.conf php.ini,可以自行进行优化配置,也可以选择不改动这两个文件
###MARIADB(MYSQL):
在安装脚本setup.sh中默认设置了mysqlroot用户的初始密码为12345,在安装mariadb的过程中,会提示输入密码,如果想用自定义密码,需要修改“MYSQL_PASSWORD=12345”对密码进行设置保持一致，一旦对密码进行更改,需要同时在IM_WEB与IM_SERVER中进行更改,详见IM_WEB和IM_SERVER配置说明。
如果使用的是已存在的mariadb(mysql),可以直接使用"mysql-u $USER -p$PASSWORD < ttopen.sql"进行库与表的创建。
###REDIS:
在conf目录下包含了redis.conf的配置文件,可以自行进行优化配置,也可以选择不改动这个文件使用默认配置。
建议对redis进行主从配置，避免redis的重启导致数据紊乱。
###IM_WEB:
在conf目录下包含了config.php,database.php, im.com.conf三个配置文件,其中im.com.conf为NGINX所需要的配置文件,建议不改动
config.php文件主要配置了msfs服务器的地址，修改$config['msfs_url']参数即可
dababase.php文件主要配置了链接MARIADB所需要的参数,根据自己的需求修改'hostname','username','password'这三个参数。
如果使用的是现有的nginx+php环境,可以修改setup.sh中的PHP_WEB_SETUP_PATH为nginx放置web代码的路径,
并且将PHP_NGINX_CONF_PATH修改为nginx配置文件的路径然后执行setup.sh脚本即可
###IM_SERVER:
IM_SERVER下共有8种服务器,所以也需要对这些服务器进行分别配置
1.LOGIN_SERVER:
ClientListenIP为提供给Client端监听的本地地址，走的是pb协议
HttpListenIP为提供给Client端监听的http协议本地地址(功能与ClientListenIP一样)
MsgServerListenIP为提供给MsgServer端监听的本地地址
msfs为提供客户端上传下载图片使用的msfs地址
discovery为mac,ios,android客户端中“发现”所使用的地址,此处地址填写的是php后台的地址
2.MSG_SERVER:
ListenIP为本机监听的IP,用于Client端的消息收发;
DBServerIP用于链接DB_PROXY,此处至少填两个数据库地址,也可以是同一个实例
LoginServerIP用于链接LoginServer
RouteServerIP用于链接RouteServer
FileServerIP用于链接FileServer
PushServerIP用于链接PushServer
IpAddr填写的是Client端可以直接访问的地址,对于需要公网访问的情况下,如果是路由器映射,则需要填路由器映射在公网上的地址;此处需要填写两个Client端可以访问的地址,如果只有一个,则填写相同的地址即可
aesKey为msg_server用于消息解密使用,与各个客户端保持一致
3.ROUTE_SERVER:
根据说明配置需要监听的对应IPPort即可
4.FILE_SERVER:
Address为Client端可以直接可以访问的IP地址,对于需要公网访问的情况下,如果是路由器映射,则需要填路由器映射在公网上的地址
5.MSFS_SERVER:
ListenIP和Port填写的是监听的本地IP,BaseDir为默认保存图片文件的路径,如有必要可以更改
6.DB_PROXY_SERVER
在安装配置脚本setup.sh中,DB_PROXY的默认监听Port设置为10600,如果被更改需要同时对IM_SERVER中其他服务器的配置进行更改，详见MSG_SERVER,HTTP_MSG_SERVER配置说明;
对于mariadb与redis的配置可以根据自己的mysql,redis进行设置
7.HTTP_MSG_SERVER
ListenIP为本地监听的地址，供php后台使用
DBServerIP用于链接DB_PROXY,此处至少填两个数据库地址,也可以是同一个实例
RouteServerIP用于链接RouteServer
8.PUSH_SERVER
ListenIP为本地监听的地址
CertPath,KeyPath,KeyPassword,SandBox为苹果apns服务所需要参数
###一键部署:
一台未安装过的NGINX,PHP,MySQL,REDIS,并且OS为CentOS6.X或者7.X,在安装之前可以先执行"setup.shcheck"命令进行上述环境的检查。检查通过后对各个模块进行一些配置文件的设置,其中主要设置的为IM_SERVER中的几个服务器地址设置,设置完成后运行"setup.shinstall"
###模块部署:
TeamTalk的各模块支持安装到不同的服务器上,所以部署可以根据自己的需要进行模块安装,主要修改的地方即为上述各个模块中的IP地址设置。根据自己的网络拓扑在conf文件夹下的各个配置文件中预先设置正确的IP地址,然后执行模块内的"setupinstall"即可
6.常见问题
###设置数据库远程连接访问
予任何主机访问数据的权限：
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY '12345' WITH GRANT OPTION;
修改生效：
FLUSH PRIVILEGES;
###CentOS7关闭防火墙
关闭一个服务：
systemctl stop firewalld.service
在开机时禁用一个服务：
systemctl disable firewalld.service
###关闭selinux否则浏览器访问不了
永久关闭配置：
sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config
临时关闭selinux：
setenforce 0