FATE单机部署指南

1. 说明

服务器配置：

数量	1
配置	8 core / 16G memory / 500G hard disk
操作系统	Version: CentOS Linux release 7
用户	User: app owner:apps

单机版提供3种部署方式，可以根据实际情况选择：

使用Docker镜像安装FATE
在主机中安装FATE(使用已编译的安装包)
在主机中安装FATE(基于源码自行打包编译)

2. 使用Docker镜像安装FATE（推荐）

建议使用docker镜像，这样可以大大降低遇到问题的可能性

注意，如下示例中的${version}，请用实际的版本号替换，参考fate.env文件中的FATE版本！

2.1 部署前环境检查

主机需要能够访问外部网络，从公共网络中拉取安装包和docker镜像。
依赖docker, docker建议版本为18.09，您可以使用以下命令验证docker环境：docker --version,docker的起停和其他操作请参考docker --help
执行之前，请检查8080是否已被占用。如果要再次执行，请使用docker命令删除以前的容器和镜像

设置部署所需环境变量(注意, 通过以下方式设置的环境变量仅在当前终端会话有效, 若打开新的终端会话, 如重新登录或者新窗口, 请重新设置)

export version={本次部署的FATE版本号, 如1.7.0}

样例:

export version=1.7.0

2.2 拉取镜像

2.2.1 通过公共镜像服务

# Docker Hub
docker pull federatedai/standalone_fate:${version}

# 腾讯云容器镜像
docker pull ccr.ccs.tencentyun.com/federatedai/standalone_fate:${version}
docker tag ccr.ccs.tencentyun.com/federatedai/standalone_fate:${version} federatedai/standalone_fate:${version}

2.2.2 通过镜像包

   wget https://webank-ai-1251170195.cos.ap-guangzhou.myqcloud.com/fate/${version}/release/standalone_fate_docker_image_${version}_release.tar.gz
   docker load -i standalone_fate_docker_image_${version}_release.tar.gz
   docker images | grep federatedai/standalone_fate

能看到对应${version}的镜像则镜像下载成功

2.3 启动

   docker run -it --name standalone_fate -p 8080:8080 federatedai/standalone_fate:${version}

2.4 测试

   source bin/init_env.sh

测试项

3. 在主机中安装FATE(使用已编译的安装包)

注意，如下示例中的${version}，请用实际的版本号替换，参考fate.env文件中的FATE版本！

3.1 部署前环境检查

本地8080、9360、9380端口是否被占用

   netstat -apln|grep 8080;
   netstat -apln|grep 9360;
   netstat -apln|grep 9380

因为需要安装操作系统依赖包, 所以需要root权限。可以使用root用户执行后续操作, 若不使用root用户, 请使用root用户给要使用的用户赋予sudo权限:

echo "{要使用的用户名}  ALL=(ALL) NOPASSWD:ALL" | tee /etc/sudoers.d/{要使用的用户名}

3.2 获取安装包

下载安装包并解压缩

   wget https://webank-ai-1251170195.cos.ap-guangzhou.myqcloud.com/fate/${version}/release/standalone_fate_install_${version}_release.tar.gz;
   tar -xzvf standalone_fate_install_${version}_release.tar.gz

3.3 安装

进入解压后的目录并使用 bin/init.sh 进行安装

该脚本将自动完成:

安装必要的操作系统依赖包
安装python36环境
安装pypi依赖包
安装jdk环境
配置FATE环境变量脚本
配置fateflow
配置fateboard
安装fate client

   cd standalone_fate_install_${version}_release;
   bash bin/init.sh init

3.4 启动

   bash bin/init.sh status;
   bash bin/init.sh start

3.5 测试

加载环境变量

   source bin/init_env.sh

测试项

4. 测试项

4.1 Toy测试

   flow test toy -gid 10000 -hid 10000

如果成功，屏幕显示类似下方的语句:

   success to calculate secure_sum, it is 2000.0

4.2 单元测试

   fate_test unittest federatedml --yes