【FATE联邦学习】Fateboard的安装和使用Fateboard 帮助debug

fateboard文档 https://fate.fedai.org/fateboard/
github Fateboard文档 https://github.com/FederatedAI/FATE-Board/blob/master/README-CN.md

背景

Fateboard是FATE框架的任务看板。
在配置FATE时，Fateboard一般是被安装好了的，安装过程查看[这里]()
ATEBoard代码使用spring-boot框架并嵌入在tomcat容器中，默认的网络端口是8080，所以还要稍微懂点java。
我自己并没有深究springboot，按我的理解，

启动fateboard服务

因为我是standalone安装的FATE，已经直接安装好了，根据文档https://fate.fedai.org/fateboard/
输入以下可启动Fateboard

java -Dspring.config.location=FATE/fateboard/src/main/resources/application.properties -DFATE_DEPLOY_PREFIX=FATE/logs/ -Dssh_config_file=FATE/fateboard/src/main/resources/ -Xmx2048m -Xms2048m -XX:+PrintGCDetails -XX:+PrintGCDateStamps -Xloggc:gc.log -XX:+HeapDumpOnOutOfMemoryError -jar FATE/fateboard/target/fateboard-1.0.jar >/dev/null 2>&1 &

一些参数解释

-Dspring.config.location     path of application.properties of fateboard
-Dssh_config_file     path of directory which ssh.properties lies in
-DFATE_DEPLOY_PREFIX     path of logs directory which produced by fate_flow

所以看上去挺长，其实就是输入了一些路径，有点长。
拆解一下就是用java启动了springboot的一个服务，

java -A a -B b

还有一些杂项，列在下面了，基本上是java的相关的一些参数（我不是很熟悉java，有错请评论指出

• -Xms2048m ：代表最小堆要2048MiB
• -XX:+PrintGCDetails ：开启了jvm的Garage Collector的日志输出
• -XX:+PrintGCDateStamps ：输出GC的时间戳（以日期的形式，如 2013-05-04T21:53:59.2）参考这个
• -Xloggc:gc.log : 输出GC日志到文件
• -XX:+HeapDumpOnOutOfMemoryError : 表示当JVM发生OOM时，自动生成DUMP文件。啥是DUMP文件？
• -jar FATE/fateboard/target/fateboard-1.0.jar

• /dev/null 2>&1 & ： 这些就是linux运维基本知识了，直接把输出的信息不要了，把stderr错误信息输出给到stdout来，参考这个

停止服务

ps -ef|grep java|grep fateboard-1.1.jar|grep -v grep|awk ‘{print $2}’
kill -9 ${pid}

启动服务后，网页访问

http://{fateboard-ip}:8080，一般就可以了，如果8080端口没有被别人占了的话。想要直接换端口应该可以在启动的时候往java那命令里加参数就可以。standalone的话一般是127.0.0.1:8080
不过搞笑的是访问后竟然还要登录……默认是账密是admin和admin。
接下来都是可视化操作了。

Debug

每次job failed后，FATE只会在Fateboard上显示任务的计算图和失败。
哪里红了，就是哪里有错误了，可以查对应函数的文档。右上角JOBS是查看所有经由FATE框架经手的任务；右下角可以看到view the outputs，点开后能每一个计算图的步骤的输出（数据、模型等）；左下角还有一个dashboard（我没有圈出来），打开后能看到本次任务的各种error、log、output，优点是能看到很多，缺点是要自己挨个找。