马哈鱼血缘分析工具安装介绍--win 10

2022-05-09

    随着大数据技术的发展与普及,数据治理和数据质量变得越来越重要,数据血缘分析在业界悄然兴起并得到了广泛流行,马哈鱼是国内少有的一款专业且易用的血缘分析工具。本文介绍如何在您的windows 10环境中快速安装部署马哈鱼。

    一、安装资料前准备

    二、组件安装

    1、JDK安装及配置

    下载JDK后直接进行安装,安装后进行环境变量配置:

    上述环境变量配置完毕后,要进行java版本和jps命令检查,否则在启动马哈鱼时会报异常;下图显示配置正常。

    注:请务必确认jps命令能够正常执行。

    2、Nginx 安装及配置

    将下载的Nginx解压到指定目录,例如:C盘根目录

    3、安装配置马哈鱼

    创建安装路径:c:\wings\sqlflow,并将下载的马哈鱼安装包解压到该目录下,解压后您会得到以下文件夹

    (1)c:\wings\sqlflow\backend

    (2)c:\wings\sqlflow\frontend

    启动 SQLFlow backend

    • 打开一个dos命令窗口
    • cd c:\wings\sqlflow\backend\bin
    • 运行 monitor.bat
    • 请等待 3-5 min确保马哈鱼全部启动成功

    配置Nginx 反向代理

    1. 配置Nginx

    进入nginx安装目录,修改Nginx.conf文件,请使用下述配置替换原文件中server部分。

    server {
    ​        listen       80;
            server_name  localhost;
    
            location / {
                root   C:\wings\sqlflow\frontend;
                index  index.html index.htm;
            }
    	
    	    location /api/ {
                proxy_pass http://127.0.0.1:8081/;
                proxy_connect_timeout 600s ;
                proxy_read_timeout 600s;
                proxy_send_timeout 600s;
            
                proxy_set_header Host $host;
                proxy_set_header X-Real-IP $remote_addr;
                proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
                proxy_set_header User-Agent $http_user_agent;  
            }
        }

    2、修改 frontend 中的配置文件 config.private.json

    • 打开配置文件 "C:\wings\sqlflow\frontend\config.private.json"
    • 修改 ApiPrefix 属性
    "ApiPrefix": "/api"

    三、马哈鱼启动与关闭

    1、启动Nginx

    进入nginx安装目录

    启动nginx.exe。

    使用命令tasklist |findstr "nginx"检查服务是否运行正常

    2、访问马哈鱼

    当马哈鱼安装完毕后,仅使用浏览器就可正常使用马哈鱼。

    打开 http://yourIp/ 浏览并使用 马哈鱼.

    打开 http://yourIp/api/gspLive_backend/doc.html?lang=en 参考马哈鱼 API 文档信息.

    3、关闭马哈鱼服务

    正确的关闭马哈鱼服务请按照以下步骤进行:

    • 首先关闭 正在运行monitor.sh的窗口.
    • cd c:\wings\sqlflow\backend\bin
    • 执行stop.bat可完整关闭马哈鱼服务

    四、常见问题

    1. 无法启动

    当你启动monitor.sh时,如果报下面的错误,说明你的JDK及环境变量path配置有问题,请参考组件安装中第一项重新检查环境变量配置并检查jps命令。

    有时需要在你配置环境变量后重启机器后才能生效。

    2. 上传大文件时报错

    这是因为 nginx 默认对上传文件的大小有限制,进行如下修改即可

    在http{}中添加一个client_max_body_size 200m;配置项;
    

    五、参考

    马哈鱼数据血缘分析器: https://sqlflow.gudusoft.com

    马哈鱼数据血缘分析器中文网站: https://www.sqlflow.cn