衡石分析平台使用手册-单机安装及启动

2024-09-09 07:44

本文主要是介绍衡石分析平台使用手册-单机安装及启动,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

单机安装及启动​

本文讲述如何在单机环境下进行 HENGSHI SENSE 安装的操作过程。

在安装前请确认网络环境,如果是隔离环境,无法连接互联网时,请先按照 离线环境安装依赖的指导进行依赖包的安装,然后按照本文的指导继续操作。如果网络环境可以连接互联网,请直接按照本文的指导进行安装。

准备工作​

  1. 请参考安装环境文档准备安装环境。

  2. 配置用户与安装目录。 在操作前请检查您是否有 sudo 权限或 root 权限,如果没有请先获取相应的权限,再进行下面的操作。 请不要使用 root 安装,推荐建立一个拥有 sudo 权限的用户安装、运行 HENGSHI SENSE,并配置安装路径。本文示例中以 hengshi 用户举例,安装路径为/opt/hengshi,下面示例中介绍如何创建 hengshi 用户及设置安装目录和权限。

    shell
    grep hengshi /etc/passwd > /dev/null || sudo useradd -m hengshi         #建立 henghsi 用户
    sudo mkdir -p /opt/hengshi && sudo chown hengshi:hengshi /opt/hengshi  #设置安装目录及权限

    1
    2

  3. 服务端 sshd 监听非22端口。 以下2种情况 需要在部署用户 ~/.ssh/config 中配置各个 host 的实际端口。 否则请忽略直接安装

    1. 如果部署 hengshi 的机器 SSH 端口不是默认的22端口
    2. 如果部署 engine 的 segments 的机器与 hengshi 服务不在一个机器上且 SSH 端口不是默认的22端口

    例如: 本机配置 hostname 为 localhost,并且 HS_ENGINE_SEGMENTS=(Node-A),对应的监听端口都为122。 在.ssh/config 配置文件中需要包含以下配置:

    shell
    Host localhostPort 122
    Host Node-APort 122

    1
    2
    3
    4

安装 HENGSHI SENSE​

执行以下步骤完成安装。

  1. 切换到执行安装的用户,示例中用户名为 hengshi。

shell

sudo su - hengshi

1

  1. 进入安装包解压后的目标目录。

shell

cd ~/pkgs/hengshi-sense-[version]

1

  1. 执行安装命令。

shell

./hs_install -p /opt/hengshi

1

提示

如果在使用服务时替换了衡石 metadb,需要确保 export HS_PG_IF_EXTERNAL=false 变量的值为 true,可在配置文件 conf/hengshi-sense-env.sh 更改,这样在升级过程中将不会要求停止此服务进行安装升级。

  1. 安装成功时,提示以下信息。

shell

SUCCESSED! installed to xxxxx

1

配置系统​

启动服务前,请阅读配置文件对相关的配置进行设置。 如内置引擎类型要求为 Doris,请阅读Doris 引擎配置。

启动服务​

请按照如下步骤启动服务。

  1. 切换到启动服务的用户,示例中的用户名为 hengshi。

shell

sudo su - hengshi

1

  1. 进入安装目录。

shell

cd /opt/hengshi

1

  1. 初始化 OS,执行前请确认用户有 sudo 权限。

shell

bin/hengshi-sense-bin init-os all

1

提示

离线环境在将依赖安装后执行 bin/hengshi-sense-bin init-os all-offline 跳过依赖包安装

  1. 初始化 HENGSHI SENSE。

shell

bin/hengshi-sense-bin init all

1

  1. 启动 HENGSHI SENSE 服务。

shell

bin/hengshi-sense-bin start all

1

  1. 当服务启动成功后,提示以下信息,模块的状态为IS ACTIVE

shell

 IS ACTIVE! : [metadb] @127.0.0.1:54320/hengshiIS ACTIVE! : [engine] @127.0.0.1:15432/hengshiIS ACTIVE! : [minio] minio server /opt/hengshi/minio-dataIS ACTIVE! : [redis] redis-server .*:6379IS ACTIVE! : [flink] /opt/hengshi/lib/flinkIS ACTIVE! : [syslog] syslog-ng --no-caps --module-path=/opt/hengshi/lib/syslog-ng/lib/syslog-ng -f /opt/hengshi/conf/syslog-ng.conf -p /opt/hengshi/logs/syslog-ng.pid -R /opt/hengshi/logs/syslog-ng.persist -c /opt/hengshi/logs/syslog-ng.ctlIS ACTIVE! : [hengshi] jar /opt/hengshi/lib/bootstrap-4.4-SNAPSHOT.jarIS ACTIVE! : [watchdog] /opt/hengshi/bin/hengshi-watchdog.sh

  1. 通过浏览器访问服务地址,默认地址: http://localhost:8080 使用 HENGSHI SENSE 服务。如果不能访问,请检查配置文件 conf/hengshi-sense-env.sh 中的服务端口 HS_HENGSHI_PORT 是否对外开放。

  2. 如需配置 nginx 请参考: 安装与启动常见 FAQ 中的1.1.3 如何通过80和443端口进行服务

启动服务后相关操作​

当 HENGSHI SENSE 服务运行时,需要定时备份数据防止数据丢失,及时清理无用日志释放存储空间。

  1. 定时备份数据

    建议每日对数据库 metadb 进行备份,可以备份到本地设备也可以备份到远程设备。定时备份建议在非业务高峰期进行,比如凌晨,避免影响用户使用服务。 下面示例是每日零时将数据备份到远程设备的执行命令,参数详细说明请参考数据备份。

    shell
    0 0 * * * /opt/hengshi/bin/dbbackup.sh -m metadb -l /BACKUP/PATH -h $REMOTE_IP -r /BACKUP/PATH

    1

  2. 定时清理日志

    运行过程中,HENGSHI SENSE 会产生运行日志,这些日志需要定时清理释放存储空间。下面示例是每日定时清理内部数据库的滚动日志的命令。

    shell
    0 0 * * * /opt/hengshi/bin/clean_engine.sh -t -r -c -g -p
    */5 * * * * /opt/hengshi/bin/clean_engine.sh -l

    1
    2

提示

在公网环境下,非必要场景中不要暴露衡石整体的服务端口,建议通过 nginx+域名对外提供服务。避免因组件原因造成被攻击的情况。在特殊情况下,可通过 IP+端口访问的形式使用 web 服务的端口(默认为8080)。

停止服务​

通过执行以下命令停止服务。

shell

sudo su - hengshi
cd /opt/hengshi
bin/hengshi-sense-bin stop all

1
2
3

服务停止成功后,提示以下信息,模块状态为"NOT ACTIVE"。

shell

 NOT ACTIVE! : [metadb] @127.0.0.1:54320/hengshiNOT ACTIVE! : [engine] @127.0.0.1:15432/hengshiNOT ACTIVE! : [minio] minio server /opt/hengshi/minio-dataNOT ACTIVE! : [redis] redis-server .*:6379NOT ACTIVE! : [flink] /opt/hengshi/lib/flinkNOT ACTIVE! : [syslog] syslog-ng --no-caps --module-path=/opt/hengshi/lib/syslog-ng/lib/syslog-ng -f /opt/hengshi/conf/syslog-ng.conf -p /opt/hengshi/logs/syslog-ng.pid -R /opt/hengshi/logs/syslog-ng.persist -c /opt/hengshi/logs/syslog-ng.ctlNOT ACTIVE! : [hengshi] jar /opt/hengshi/lib/bootstrap-4.4-SNAPSHOT.jarNOT ACTIVE! : [watchdog] /opt/hengshi/bin/hengshi-watchdog.sh

检查服务状态​

在服务运行过程中,可通过执行以下命令查看程序运行状态。

shell

sudo su - hengshi
cd /opt/hengshi
bin/hengshi-sense-bin status all

在程序运行状态的提示信息中,重点关注以下模块的状态信息,IS ACTIVE表示对应模块运行中,NOT ACTIVE表示对应模块停止服务。

shell

 NOT ACTIVE! : [metadb] @127.0.0.1:54320/hengshiNOT ACTIVE! : [engine] @127.0.0.1:15432/hengshiNOT ACTIVE! : [minio] minio server /opt/hengshi/minio-dataNOT ACTIVE! : [redis] redis-server .*:6379NOT ACTIVE! : [flink] /opt/hengshi/lib/flinkNOT ACTIVE! : [syslog] syslog-ng --no-caps --module-path=/opt/hengshi/lib/syslog-ng/lib/syslog-ng -f /opt/hengshi/conf/syslog-ng.conf -p /opt/hengshi/logs/syslog-ng.pid -R /opt/hengshi/logs/syslog-ng.persist -c /opt/hengshi/logs/syslog-ng.ctlNOT ACTIVE! : [hengshi] jar /opt/hengshi/lib/bootstrap-4.4-SNAPSHOT.jarNOT ACTIVE! : [watchdog] /opt/hengshi/bin/hengshi-watchdog.sh

这篇关于衡石分析平台使用手册-单机安装及启动的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1150570

相关文章

Nexus安装和启动的实现教程

《Nexus安装和启动的实现教程》:本文主要介绍Nexus安装和启动的实现教程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、Nexus下载二、Nexus安装和启动三、关闭Nexus总结一、Nexus下载官方下载链接:DownloadWindows系统根

MyBatis Plus 中 update_time 字段自动填充失效的原因分析及解决方案(最新整理)

《MyBatisPlus中update_time字段自动填充失效的原因分析及解决方案(最新整理)》在使用MyBatisPlus时,通常我们会在数据库表中设置create_time和update... 目录前言一、问题现象二、原因分析三、总结:常见原因与解决方法对照表四、推荐写法前言在使用 MyBATis

Python主动抛出异常的各种用法和场景分析

《Python主动抛出异常的各种用法和场景分析》在Python中,我们不仅可以捕获和处理异常,还可以主动抛出异常,也就是以类的方式自定义错误的类型和提示信息,这在编程中非常有用,下面我将详细解释主动抛... 目录一、为什么要主动抛出异常?二、基本语法:raise关键字基本示例三、raise的多种用法1. 抛

Java中实现线程的创建和启动的方法

《Java中实现线程的创建和启动的方法》在Java中,实现线程的创建和启动是两个不同但紧密相关的概念,理解为什么要启动线程(调用start()方法)而非直接调用run()方法,是掌握多线程编程的关键,... 目录1. 线程的生命周期2. start() vs run() 的本质区别3. 为什么必须通过 st

Java SWT库详解与安装指南(最新推荐)

《JavaSWT库详解与安装指南(最新推荐)》:本文主要介绍JavaSWT库详解与安装指南,在本章中,我们介绍了如何下载、安装SWTJAR包,并详述了在Eclipse以及命令行环境中配置Java... 目录1. Java SWT类库概述2. SWT与AWT和Swing的区别2.1 历史背景与设计理念2.1.

github打不开的问题分析及解决

《github打不开的问题分析及解决》:本文主要介绍github打不开的问题分析及解决,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、找到github.com域名解析的ip地址二、找到github.global.ssl.fastly.net网址解析的ip地址三

Oracle修改端口号之后无法启动的解决方案

《Oracle修改端口号之后无法启动的解决方案》Oracle数据库更改端口后出现监听器无法启动的问题确实较为常见,但并非必然发生,这一问题通常源于​​配置错误或环境冲突​​,而非端口修改本身,以下是系... 目录一、问题根源分析​​​二、保姆级解决方案​​​​步骤1:修正监听器配置文件 (listener.

MySQL版本问题导致项目无法启动问题的解决方案

《MySQL版本问题导致项目无法启动问题的解决方案》本文记录了一次因MySQL版本不一致导致项目启动失败的经历,详细解析了连接错误的原因,并提供了两种解决方案:调整连接字符串禁用SSL或统一MySQL... 目录本地项目启动报错报错原因:解决方案第一个:第二种:容器启动mysql的坑两种修改时区的方法:本地

安装centos8设置基础软件仓库时出错的解决方案

《安装centos8设置基础软件仓库时出错的解决方案》:本文主要介绍安装centos8设置基础软件仓库时出错的解决方案,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐... 目录安装Centos8设置基础软件仓库时出错版本 8版本 8.2.200android4版本 javas

Mysql的主从同步/复制的原理分析

《Mysql的主从同步/复制的原理分析》:本文主要介绍Mysql的主从同步/复制的原理分析,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录为什么要主从同步?mysql主从同步架构有哪些?Mysql主从复制的原理/整体流程级联复制架构为什么好?Mysql主从复制注意