跳到主要内容
版本: 最新版本-3.5

部署

本主题提供有关部署的一些常见问题解答。

如何在 fe.conf 文件中使用 priority_networks 参数绑定固定 IP 地址？​

问题描述​

例如，如果您有两个 IP 地址：192.168.108.23 和 192.168.108.43。您可以提供如下 IP 地址：

  • 如果您将地址指定为 192.168.108.23/24，StarRocks 将识别它们为 192.168.108.43。
  • 如果您将地址指定为 192.168.108.23/32，StarRocks 将识别它们为 127.0.0.1。

解决方案​

以下有两种方法可以解决此问题

  • 不要在 IP 地址的末尾添加“32”或将“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 的 Web 服务端口被占用。尝试修改 be.conf 文件中的端口并重新启动 BE。

当出现错误时我该怎么办：ERROR 1064 (HY000): Could not initialize class com.starrocks.rpc.BackendServiceProxy？​

当您在 Java 运行时环境 (JRE) 中运行程序时，会发生此错误。要解决此问题，请将 JRE 替换为 Java 开发工具包 (JDK)。我们建议您使用 Oracle 的 JDK 1.8 或更高版本。

FE 和 BE 配置文件可以修改后生效，而无需重启集群吗？​

是的。执行以下步骤以完成 FE 和 BE 配置项的修改

  • FE：您可以通过以下方式之一完成 FE 的修改

    • SQL
    ADMIN SET FRONTEND CONFIG ("key" = "value");

    示例

    ADMIN SET FRONTEND CONFIG ("enable_statistic_collect" = "false");
    • Shell
    curl --location-trusted -u username:password \
    http://<ip>:<fe_http_port/api/_set_config?key=value>

    示例

    curl --location-trusted -u <username>:<password> \
    http://192.168.110.101:8030/api/_set_config?enable_statistic_collect=true

  • BE：您可以通过以下方式完成 BE 的修改

curl -XPOST -u username:password \
http://<ip>:<be_http_port>/api/update_config?key=value

注意：确保用户有远程登录的权限。如果不是，您可以按以下方式授予用户权限

CREATE USER 'test'@'%' IDENTIFIED BY '123456';

GRANT SELECT ON . TO 'test'@'%';

为什么会发生错误“Fe type:unknown,is ready:false.” 当我在集群重启期间启动 FE 时？​

检查 leader FE 是否正在运行。如果不是，请逐个重启集群中的 FE 节点。

为什么在部署集群时会出现错误“failed to get service info err.”？​

检查 OpenSSH Daemon (sshd) 是否已启用。如果未启用，请运行 /etc/init.d/sshd`` status 命令以启用它。

为什么在启动 BE 时会出现错误“Fail to get master client from cache. ``host= port=0 code=THRIFT_RPC_ERROR”？​

运行 netstat -anp |grep port 命令检查 be.conf 文件中的端口是否被占用。如果是，请将占用的端口替换为空闲端口，然后重新启动 BE。

为什么 StarRocks Manager 诊断页面上的 FE 节点日志对于新部署的 FE 节点（运行正常）显示“搜索日志失败。”？​

默认情况下，StarRocks Manager 在 30 秒内获取新部署的 FE 的路径配置。当 FE 启动缓慢或由于其他原因在 30 秒内未响应时，会发生此错误。通过路径检查 Manager Web 的日志

/starrocks-manager-xxx/center/log/webcenter/log/web/``drms.INFO（您可以自定义路径）。然后查找日志中是否显示消息“Failed to update FE configurations”。如果是，请重新启动相应的 FE 以获取新路径配置。

为什么在启动 FE 时会出现错误“exceeds max permissable delta:5000ms.”？​

当两台机器之间的时间差超过 5 秒时，会发生此错误。要解决此问题，请对齐这两台机器的时间。

如果 BE 中有多个磁盘用于数据存储，如何设置 storage_root_path 参数？​

在 be.conf 文件中配置 storage_root_path 参数，并用 ; 分隔此参数的值。例如：storage_root_path=/the/path/to/storage1;/the/path/to/storage2;/the/path/to/storage3;

为什么在将 FE 添加到我的集群后会出现错误“invalid cluster id: 209721925.”？​

如果您在首次启动集群时没有为此 FE 添加 --helper 选项，则两台机器之间的元数据不一致，因此会发生此错误。要解决此问题，您需要清除元目录下的所有元数据，然后添加带有 --helper 选项的 FE。

为什么 Alive 为 false 当 FE 正在运行时并打印日志 transfer: follower？​

当 Java 虚拟机 (JVM) 的内存使用超过一半且未标记检查点时，会发生此问题。通常，系统在累积 50,000 条日志后会标记一个检查点。我们建议您修改每个 FE 的 JVM 参数，并在这些 FE 未重载时重新启动它们。