StarRocks安装常见错误整理
👉 本文共约3103个字，系统预计阅读时间或需12分钟。
本页目录 隐藏
Error: Could not find or load main class com.starrocks.StarRocksFE
请使用下载地址：https://www.mirrorship.cn/zh-CN/download/community进行下载二进制包，大小为2.2G
不要使用github上的地址进行下载，github上的是源码包，编译才能使用，大小为50MB。
二进制安装包已经包括了文件starrocks-fe.jar：
1 2 | [root@starrocks253 soft]# find / -name starrocks-fe.jar /usr/local/StarRocks-2.5.3/fe/lib/starrocks-fe.jar |
java.net.ConnectException: Connection refused (Connection refused)
添加BE节点后，不能启动，查询“show backends;”，列ErrMsg显示：java.net.ConnectException: Connection refused (Connection refused)
1 2 3 4 5 6 7 8 | mysql> show backends; +-----------+--------------+---------------+--------+----------+----------+---------------------+---------------------+-------+----------------------+-----------------------+-----------+------------------+---------------+---------------+---------+----------------+--------------------------------------------------------------------+---------------+--------------------------------------------------------+-------------------+-------------+----------+-------------------+------------+------------+ | BackendId | IP | HeartbeatPort | BePort | HttpPort | BrpcPort | LastStartTime | LastHeartbeat | Alive | SystemDecommissioned | ClusterDecommissioned | TabletNum | DataUsedCapacity | AvailCapacity | TotalCapacity | UsedPct | MaxDiskUsedPct | ErrMsg | Version | Status | DataTotalCapacity | DataUsedPct | CpuCores | NumRunningQueries | MemUsedPct | CpuUsedPct | +-----------+--------------+---------------+--------+----------+----------+---------------------+---------------------+-------+----------------------+-----------------------+-----------+------------------+---------------+---------------+---------+----------------+--------------------------------------------------------------------+---------------+--------------------------------------------------------+-------------------+-------------+----------+-------------------+------------+------------+ | 10272 | 192.18.0.137 | 9050 | -1 | -1 | -1 | NULL | NULL | false | false | false | 0 | 0.000 | 1.000 B | 0.000 | 0.00 % | 0.00 % | java.net.ConnectException: Connection refused (Connection refused) | | {"lastSuccessReportTabletsTime":"N/A"} | 0.000 | 0.00 % | 0 | 0 | 0.00 % | 0.0 % | | 10007 | 192.18.0.138 | 9050 | 9060 | 8040 | 8060 | 2023-03-29 15:37:36 | 2023-03-29 15:52:52 | true | false | false | 39 | 2.595 KB | 285.514 GB | 494.971 GB | 42.32 % | 42.32 % | | 2.5.3-46bf084 | {"lastSuccessReportTabletsTime":"2023-03-29 15:52:36"} | 285.514 GB | 0.00 % | 4 | 0 | 1.03 % | 0.2 % | +-----------+--------------+---------------+--------+----------+----------+---------------------+---------------------+-------+----------------------+-----------------------+-----------+------------------+---------------+---------------+---------+----------------+--------------------------------------------------------------------+---------------+--------------------------------------------------------+-------------------+-------------+----------+-------------------+------------+------------+ 2 rows in set (0.04 sec) |
查看日志：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | I0329 15:51:01.494788 31548 backend_options.cpp:77] localhost 192.18.0.137 I0329 15:51:01.496893 31548 exec_env.cpp:421] Set storage page cache size 2698684563 I0329 15:51:01.497128 31558 daemon.cpp:188] Current memory statistics: process(28953072), query_pool(0), load(0), metadata(0), compaction(0), schema_change(0), column_pool(0), page_cache(0), update(0), chunk_allocator(0), clone(0), consistency(0) I0329 15:51:01.498107 31560 data_dir.cpp:113] path: /usr/local/starrocks/be/storage, hash: 8442776031408076163 I0329 15:51:01.526329 31627 data_dir.cpp:237] start to load tablets from /usr/local/starrocks/be/storage I0329 15:51:01.526365 31627 data_dir.cpp:243] begin loading rowset from meta I0329 15:51:01.527894 31627 data_dir.cpp:261] load rowset from meta finished, data dir: /usr/local/starrocks/be/storage I0329 15:51:01.527917 31627 data_dir.cpp:266] begin loading tablet from meta I0329 15:51:01.528043 31627 data_dir.cpp:302] load tablet from meta finished, loaded tablet: 0, error tablet: 0, path: /usr/local/starrocks/be/storage I0329 15:51:01.537509 31693 fragment_mgr.cpp:516] FragmentMgr cancel worker start working. I0329 15:51:01.546819 31548 exec_env.cpp:173] [PIPELINE] Exec thread pool: thread_num=4 W0329 15:51:01.770228 31548 stack_util.cpp:128] 2023-03-29 15:51:01.770140, query_id=00000000-0000-0000-0000-000000000000, fragment_instance_id=00000000-0000-0000-0000-000000000000 throws exception: std::system_error, trace: @ 0x2a33ce0 std::__throw_system_error() @ 0x7cabc59 std::thread::_M_start_thread() @ 0x46f1534 starrocks::RuntimeFilterWorker::RuntimeFilterWorker() @ 0x464de29 starrocks::ExecEnv::_init() @ 0x464ed42 starrocks::ExecEnv::init() @ 0x2a36ea1 main @ 0x7f0cb60d6555 __libc_start_main @ 0x2b5172f (unknown) @ (nil) (unknown) |
不能启动的原因是：可用内存不足，请保证可用内存有10G以上。
查询资源：
1 2 3 4 | [root@PT-Test-12 storage]# free -h total used free shared buff/cache available Mem: 15G 5.7G 801M 802M 9.0G 8.7G Swap: 4.0G 503M 3.5G |
杀掉部分占用内存的资源后：
1 2 3 4 | [root@PT-Test-12 ~]# free -h total used free shared buff/cache available Mem: 15G 839M 5.6G 802M 9.1G 13G Swap: 4.0G 31M 4.0G |
重新启动后正常：/usr/local/starrocks/be/bin/start_be.sh --daemon
1 2 3 4 5 6 7 8 | mysql> show backends; +-----------+--------------+---------------+--------+----------+----------+---------------------+---------------------+-------+----------------------+-----------------------+-----------+------------------+---------------+---------------+---------+----------------+--------+---------------+--------------------------------------------------------+-------------------+-------------+----------+-------------------+------------+------------+ | BackendId | IP | HeartbeatPort | BePort | HttpPort | BrpcPort | LastStartTime | LastHeartbeat | Alive | SystemDecommissioned | ClusterDecommissioned | TabletNum | DataUsedCapacity | AvailCapacity | TotalCapacity | UsedPct | MaxDiskUsedPct | ErrMsg | Version | Status | DataTotalCapacity | DataUsedPct | CpuCores | NumRunningQueries | MemUsedPct | CpuUsedPct | +-----------+--------------+---------------+--------+----------+----------+---------------------+---------------------+-------+----------------------+-----------------------+-----------+------------------+---------------+---------------+---------+----------------+--------+---------------+--------------------------------------------------------+-------------------+-------------+----------+-------------------+------------+------------+ | 10272 | 192.18.0.137 | 9050 | 9060 | 8040 | 8060 | 2023-03-29 16:10:59 | 2023-03-29 16:17:05 | true | false | false | 20 | 10.985 KB | 240.805 GB | 494.971 GB | 51.35 % | 51.35 % | | 2.5.3-46bf084 | {"lastSuccessReportTabletsTime":"2023-03-29 16:16:59"} | 240.805 GB | 0.00 % | 4 | 0 | 1.13 % | 0.2 % | | 10007 | 192.18.0.138 | 9050 | 9060 | 8040 | 8060 | 2023-03-29 15:37:36 | 2023-03-29 16:17:05 | true | false | false | 28 | 11.006 KB | 278.962 GB | 494.971 GB | 43.64 % | 43.64 % | | 2.5.3-46bf084 | {"lastSuccessReportTabletsTime":"2023-03-29 16:16:36"} | 278.962 GB | 0.00 % | 4 | 0 | 1.10 % | 0.4 % | +-----------+--------------+---------------+--------+----------+----------+---------------------+---------------------+-------+----------------------+-----------------------+-----------+------------------+---------------+---------------+---------+----------------+--------+---------------+--------------------------------------------------------+-------------------+-------------+----------+-------------------+------------+------------+ 2 rows in set (0.05 sec) |
如何在配置文件 fe.conf 中 priority_networks 参数下配置固定 IP？
问题描述
假设当前节点有两个 IP 地址：192.168.108.23 和 192.168.108.43。
- 如果您将
priority_networks设定为192.168.108.23/24，StarRocks 会将该地址识别为192.168.108.43。 - 如果您将
priority_networks设定为192.168.108.23/32，启动后 StarRocks 会出错，并将该地址识别为127.0.0.1。
解决方案
以上问题有以下两种解决方案：
- 删去 CIDR 后缀
32或者将其改为28。 - 将 StarRocks 升级至 2.1 或更新版本。
安装 BE 节点后启动失败，并返回错误 "StarRocks BE http service did not start correctly, exiting"。我该如何解决？
如果在安装 BE 后启动报错 StarRocks Be http service did not start correctly,exiting，该问题是 BE 节点 webserver_port 端口被占用导致。您需要修改 BE 配置文件 be.conf 中的 webserver_port 配置项并重启 BE 服务使配置生效。如果多次修改为未被占用的端口，系统仍然重复报错，您需要检查节点是否装有 Yarn 等程序，确认监听端口选择修改监听规则，或者 BE 的端口选取范围绕过。
在部署企业版 StarRocks 的过程当中，配置节点时报错：“Failed to Distribute files to node”。我该如何解决？
以上错误是由于 FE 节点间 setuptools 版本不匹配导致。您需要使用 root 权限在集群的所有机器上执行以下命令：
1 2 3 | yum remove python-setuptools rm /usr/lib/python2.7/site-packages/setuptool* -rf wget https://bootstrap.pypa.io/ez_setup.py -O - | python |
StarRocks 是否支持动态修改 FE、BE 配置项？
部分 FE 节点和 BE 节点配置项支持动态修改。具体操作参考 配置参数。
动态修改 FE 节点配置项：
- 使用 SQL 方式动态修改：
1ADMIN SET FRONTEND CONFIG ("key" = "value");示例：
12--示例：ADMIN SET FRONTEND CONFIG ("enable_statistic_collect" = "false");- 使用命令行方式动态修改：
12curl --location-trusted -u username:password \'http://<ip>:<fe_http_port>/api/_set_config?key=value'示例：
12curl --location-trusted -u root:root \'http://192.168.110.101:8030/api/_set_config?enable_statistic_collect=true'动态修改 BE 节点配置项：
- 使用命令行方式动态修改：
12curl -XPOST -u username:password \'http://<ip>:<be_http_port>/api/update_config?key=value'
注意
使用以上方式修改参数时，请确保当前用户拥有远程登录权限。
以下示例创建了用户 test 并赋予其相应权限。
1 2 | CREATE USER 'test'@'%' IDENTIFIED BY '123456'; GRANT SELECT_PRIV ON . TO 'test'@'%'; |
为 BE 节点增加磁盘空间后，数据存储无法均衡负载且报错 “Failed to get scan range, no queryable replica found in tablet: xxxxx”。我该如何解决？
问题描述
该错误发生在使用 Flink 导入数据时，BE 节点磁盘空间不足。扩容磁盘后，数据存储无法负载均衡。
解决方案:
该问题目前仍在修复当中，目前您可以通过以下两种方式解决：
- 手动均衡数据存储负载。
- 如果当前磁盘中的数据非重要数据，建议您直接删除掉磁盘并修改相应磁盘路径。如果系统继续报错，您需要通过
TRUNCATE TABLE命令清除当前表中的数据。
重启集群时，FE 启动失败并报错 “Fe type:unknown ,is ready :false”。我该如何解决？
请确认 Leader FE 节点是否已启动。如果未启动，请尝试逐台重启集群中的 FE 节点。
安装集群时报错 “failed to get service info err”。我该如何解决？
请检查当前机器是否开启了 OpenSSH Daemon（SSHD）。
您可以通过以下命令查看 SSHD 状态。
本人提供Oracle(OCP、OCM)、MySQL(OCP)、PostgreSQL(PGCA、PGCE、PGCM)等数据库的培训和考证业务，私聊QQ646634621或微信db_bao，谢谢！
1 | /etc/init.d/sshd status |
BE 启动失败并报错 “Fail to get master client from cache. host= port=0 code=THRIFT_RPC_ERROR“。我该如何解决？
请通过以下命令检查 be.conf 中指定的端口是否被占用。
1 | netstat -anp |grep port |
如果被占用，请更换其他空闲端口后重启。
通过 StarRocks Manager 升级集群时报错 “Failed to transport upgrade files to agent host. src:…”。我该如何解决？
以上错误由部署路径的磁盘空间不足所导致。在升级集群时，StarRocks Manager 会将新版本的二进制文件分发至各个节点，若部署目录的磁盘空间不足，则文件无法被分发，出现上述报错。
请检查对应的磁盘的存储空间。如存储空间不足，请扩展相应磁盘空间。
新扩容节点的 FE 状态正常，但是在 StarRocks Manager 的 诊断页面下，该 FE 节点日志展示报错 “Failed to search log“。我该如何解决？
默认设置下，StarRocks Manager 会在 30 秒内去获取新部署 FE 节点路径配置。如果当前 FE 节点启动较慢或由于其他原因导致 30 秒内未响应就会出现上述问题。请通过 /starrocks-manager-xxx/center/log/webcenter/log/web/drms.INFO 路径检查 StarRocks Manager Web 日志，检索日志中是否含有 “Failed to update fe configurations” 报错。若有，请重启对应的 FE 服务，StarRocks Manager 会重新获取路径配置。
启动 FE 失败并报错 “exceeds max permissable delta:5000ms”。我该如何解决？
以上错误由于集群内不同机器的时差超过 5 秒导致。您需要通过校准机器时间解决该问题。
如果 BE 节点有多块磁盘做存储，如何设置 storage_root_path 配置项？
该配置项位于 BE 配置文件 be.conf 中。您可以使用 ; 分隔多个磁盘路径。
添加新的 FE 节点至集群后报错 “invalid cluster id: xxxxxxxx”。我该如何解决？
以上错误是由于第一次启动集群时未使用 --helper 选项添加该 FE 节点，从而导致不同节点的元数据不一致。您需要将相应目录下的所有元数据清空，并通过 --helper 选项重新添加该 FE 节点至集群。
当前 FE 节点已经启动，且状态为 transfer：follower，但是调用 show frontends 命令返回 isAlive 状态为 false。我该如何解决？
以上问题是由于超过半数的 Java Virtual Machine（JVM）内存被使用且未标记 checkpoint。通常情况下，每积累 50,000 条日志，系统便会标记一个 checkpoint。建议您在业务低峰期修改各 FE 节点的 JVM 参数并重启 FE 使修改生效。
查询报错 “could not initialize class com.starrocks.rpc.BackendServiceProxy”。我该如何解决？
- 请确认环境变量
$JAVA_HOME是否为正确的 JDK 路径。 - 请确认所有节点的 JDK 是否是同一个版本，所有节点需要使用相同版本的 JDK。
