> * [依赖环境](#chapter-1)

> * [Tars C++开发环境](#chapter-2)

> * [Tars框架安装](#chapter-3)

> * [Tars-web说明](#chapter-4)

> * [框架扩容及更新](#chapter-5)

本安装文档描述在一台或多台服务器上安装搭建整个Tars框架的过程，目的是为了让用户对Tars框架的部署搭建、运行、测试等有个整体的认识。

如要用于线上环境，部署安装的原理是一样，不过需要更多考虑分布式系统下服务的部署需要有容错、容灾等的能力。若有需要，可以加入tars的qq技术交流群：579079160。

软件 |软件要求

------|--------

linux内核版本: | 2.6.18及以上版本（操作系统依赖）

gcc版本: | 4.8.2及以上版本、glibc-devel（c++语言框架依赖）

bison工具版本: | 2.5及以上版本（c++语言框架依赖）

flex工具版本: | 2.5及以上版本（c++语言框架依赖）

cmake版本： | 2.8.8及以上版本（c++语言框架依赖）

mysql版本: | 4.1.17及以上版本（框架运行依赖）

rapidjson版本: | 1.0.2版本（c++语言框架依赖）

nvm版本： | 0.35.1及以上版本（web管理系统依赖, 脚本安装过程中自动安装）

node版本： | 12.13.0及以上版本（web管理系统依赖, 脚本安装过程中自动安装）

运行服务器要求：1台普通安装linux系统的机器即可。

## 1.1. 编译包依赖下载安装介绍

源码编译过程需要安装:gcc, glibc, bison, flex, cmake

例如，在Centos7下，执行：

```

yum install glibc-devel gcc gcc-c++ bison flex cmake

```

## 1.2. Mysql安装

下面提供两种安装方式，源码安装和yum安装

### 1.2.1 源码安装

源码安装可以对数据库进行自定义。

安装前，确定系统是否安装了ncurses、zlib，若没有，可以执行：

```

yum install ncurses-devel

yum install zlib-devel

```

设置安装目录，切换至root用户

```

cd /usr/local

mkdir mysql-5.6.26

chown ${普通用户}:${普通用户} ./mysql-5.6.26

ln -s /usr/local/mysql-5.6.26 /usr/local/mysql

```

用utf8的安装方式

下载mysql源码（这里使用的是mysql-5.6.26）,用utf8的安装方式mysql，解压后编译：

下面增加了mysql-5.6.26的安装方式

```

cd ${mysql安装目录}

wget https://dev.mysql.com/get/Downloads/MySQL-5.6/mysql-5.6.26.tar.gz

tar -zxvf mysql-5.6.26.tar.gz

cmake . -DCMAKE_INSTALL_PREFIX=/usr/local/mysql-5.6.26 -DWITH_INNOBASE_STORAGE_ENGINE=1 -DMYSQL_USER=mysql -DDEFAULT_CHARSET=utf8 -DDEFAULT_COLLATION=utf8_general_ci

make

make install

```

**注意，对于用Tars的c++进行开发编译的服务，mysql建议采用静态库，源码编译，避免所有服务器都要安装mysql的动态库。**

对于在服务器用Tars的c++进行开发编译服务代码而言，经过上面步骤就可以进行编译安装Tars开发框架了。

若要是搭建Tars框架的运行环境，需要以下步骤，切换至root用户，对mysql进行配置。

```shell

yum install perl

cd /usr/local/mysql

useradd mysql

rm -rf /usr/local/mysql/data

mkdir -p /data/mysql-data

ln -s /data/mysql-data /usr/local/mysql/data

chown -R mysql:mysql /data/mysql-data /usr/local/mysql/data

cp support-files/mysql.server /etc/init.d/mysql

**如果/etc/目录下有my.cnf存在，需要把这个配置删除了**

rm -rf /etc/my.cnf

yum install -y perl-Module-Install.noarch

perl scripts/mysql_install_db --user=mysql

vim /usr/local/mysql/my.cnf

```

补充了上面删除my.cnf的命令

rm -rf /etc/my.cnf

给一个my.cnf配置实例：

```cnf

[mysqld]

# Remove leading # and set to the amount of RAM for the most important data

# cache in MySQL. Start at 70% of total RAM for dedicated server, else 10%.

innodb_buffer_pool_size = 128M

# Remove leading # to turn on a very important data integrity option: logging

# changes to the binary log between backups.

log_bin

# These are commonly set, remove the # and set as required.

basedir = /usr/local/mysql

datadir = /usr/local/mysql/data

# port = .....

# server_id = .....

socket = /tmp/mysql.sock

bind-address=${your machine ip}

# Remove leading # to set options mainly useful for reporting servers.

# The server defaults are faster for transactions and fast SELECTs.

# Adjust sizes as needed, experiment to find the optimal values.

join_buffer_size = 128M

sort_buffer_size = 2M

read_rnd_buffer_size = 2M

sql_mode=NO_ENGINE_SUBSTITUTION,STRICT_TRANS_TABLES

```

**注意将bind-address改为部署机器的IP**

启动mysql

```

service mysql start

chkconfig mysql on

```

结束mysql

```

service mysql stop

```

添加mysql的bin路径

```

vim /etc/profile

PATH=$PATH:/usr/local/mysql/bin

export PATH

```

修改root密码(采用root密码)

```

./bin/mysqladmin -u root password 'root@appinside'

./bin/mysqladmin -u root -h ${主机名} password 'root@appinside'

```

**注意${主机名}需要修改成自身机器的名称，可以通过查看/etc/hosts**

添加mysql库路径

```

vim /etc/ld.so.conf

/usr/local/mysql/lib/

ldconfig

```

mysql主从配置可以参考网上教程

master赋予权限:

```

GRANT REPLICATION SLAVE ON *.* to 'mysql-sync'@'%' identified by 'sync@appinside'

```

slave设置主备同步项

```

change master to master_host='${备机Ip}',master_user='mysql-sync',master_password='sync@appinside' ,master_log_file='iZ94orl0ix4Z-bin.000004',master_log_pos=611;

stop slave

start slave

show master status\G;

show slave status\G;

```

**注意${备机Ip}需要修改成备机数据库的Ip**

### 1.2.2 yum安装

在mysql 5.7版本之后删除了源码中的mysql_install_db.sh安装脚本，因此上述方法不适用。

yum安装相对便捷，但是没办法实现自定义安装。如果对自定义安装有需求的请使用源码安装。

#### 1.2.2.1 从yum repository安装mysql

```

wget -i -c http://dev.mysql.com/get/mysql57-community-release-el7-10.noarch.rpm

yum -y install mysql57-community-release-el7-10.noarch.rpm

yum -y install mysql-community-server

yum -y install mysql-devel

```

这样mysql就安装好了

其中wget中的库地址可以根据需要替换版本号

如果wget无法安装，可以尝试按照下述步骤将mysql repository添加到本地服务，然后再重新执行上述命令

```

sudo yum localinstall https://dev.mysql.com/get/mysql57-community-release-el7-10.noarch.rpm

```

#### 1.2.2.2 设置mysql

启动mysql并查看运行状态

```

systemctl start mysqld.service

systemctl status mysqld.service

```

mysql开始运行并通过3306端口进行连接。

通过yum安装mysql的话root账号会默认设置一个密码，可以通过下面的方式获得。

```

grep "password" /var/log/mysqld.log

```

使用这个密码登陆root的账户。mysql要求必须更改密码才能做数据库操作。

如果你安装的mysql版本是5.7及以上，mysql的密码设置有安全性要求(长度、大小写、特殊字符)，以下两种方式可以选择

1. 设置满足要求的密码

2. 通过下面的方式降低密码安全性规则

```

mysql> set global validate_password_policy=0;

mysql> set global validate_password_length=1;

```

修改之后只有6个字符的最小长度限制

接着修改密码

```

mysql> ALTER USER 'root'@'localhost' IDENTIFIED BY '${your password}';

```

**源码安装框架才需要做这一步, 如果只是用c++写服务, 只需要下载tarscpp代码即可**

下载TarsFramework源码

```

cd ${source_folder}

git clone https://github.com/TarsCloud/TarsFramework.git --recursive

```

然后进入build源码目录

```

cd ${source_folder}/TarsFramework/build

chmod u+x build.sh

./build.sh prepare

./build.sh all

```

**编译时默认使用的mysql开发库路径：include的路径为/usr/local/mysql/include，lib的路径为/usr/local/mysql/lib/**