iotdb环境需求
环境准备
要使用iotdb,你需要:
- Java>=1.8(请确保设置了环境路径)
- 将最大打开文件num设置为65535,以避免“打开文件过多”的问题。
配置参数
为方便 IoTDB Server 的配置与管理,IoTDB Server 为用户提供三种配置项,使得用户可以在启动服务或服务运行时对其进行配置。
三种配置项的配置文件均位于 IoTDB 安装目录:$IOTDB_HOME/conf
文件夹下,其中涉及 server 配置的共有 2 个文件,分别为:iotdb-env.sh
, iotdb-engine.properties
。用户可以通过更改其中的配置项对系统运行的相关配置项进行配置。
配置文件的说明如下:
iotdb-env.sh
:环境配置项的默认配置文件。用户可以在文件中配置 JAVA-JVM 的相关系统配置项。iotdb-engine.properties
:IoTDB 引擎层系统配置项的默认配置文件。用户可以在文件中配置 IoTDB 引擎运行时的相关参数,如 JDBC 服务监听端口 (rpc_port
)、overflow 数据文件存储目录 (overflow_data_dir
) 等。此外,用户可以在文件中配置 IoTDB 存储时 TsFile 文件的相关信息,如每次将内存中的数据写入到磁盘时的数据大小 (group_size_in_byte
) ,内存中每个列打一次包的大小 (page_size_in_byte
) 等。
热修改配置项
为方便用户使用,IoTDB Server 为用户提供了热修改功能,即在系统运行过程中修改iotdb-engine.properties
中部分配置参数并即时应用到系统中。下面介绍的参数中,改后生效方式为触发生效
的均为支持热修改的配置参数。
触发方式:客户端发送load configuration
命令至 IoTDB Server。
环境配置项
环境配置项主要用于对 IoTDB Server 运行的 Java 环境相关参数进行配置,如 JVM 相关配置。IoTDB Server 启动时,此部分配置会被传给 JVM。用户可以通过查看 iotdb-env.sh
(或iotdb-env.bat
) 文件查看环境配置项内容。详细配置项说明如下:
- JMX_LOCAL
名字 | JMX_LOCAL |
---|---|
描述 | JMX 监控模式,配置为 true 表示仅允许本地监控,设置为 false 的时候表示允许远程监控。如想在本地通过网络连接JMX Service,比如nodeTool.sh会尝试连接127.0.0.1:31999,请将JMX_LOCAL设置为false。 |
类型 | 枚举 String : “true”, “false” |
默认值 | true |
改后生效方式 | 重启服务生效 |
- JMX_PORT
名字 | JMX_PORT |
---|---|
描述 | JMX 监听端口。请确认该端口是不是系统保留端口并且未被占用。 |
类型 | Short Int: [0,65535] |
默认值 | 31999 |
改后生效方式 | 重启服务生效 |
- MAX_HEAP_SIZE
名字 | MAX_HEAP_SIZE |
---|---|
描述 | IoTDB 启动时能使用的最大堆内存大小。 |
类型 | String |
默认值 | 取决于操作系统和机器配置。在 Linux 或 MacOS 系统下默认为机器内存的四分之一。在 Windows 系统下,32 位系统的默认值是 512M,64 位系统默认值是 2G。 |
改后生效方式 | 重启服务生效 |
- HEAP_NEWSIZE
名字 | HEAP_NEWSIZE |
---|---|
描述 | IoTDB 启动时能使用的最小堆内存大小。 |
类型 | String |
默认值 | 取决于操作系统和机器配置。在 Linux 或 MacOS 系统下默认值为机器 CPU 核数乘以 100M 的值与 MAX_HEAP_SIZE 四分之一这二者的最小值。在 Windows 系统下,32 位系统的默认值是 512M,64 位系统默认值是 2G。 |
改后生效方式 | 重启服务生效 |
系统配置项
系统配置项是 IoTDB Server 运行的核心配置,它主要用于设置 IoTDB Server 文件层和引擎层的参数,便于用户根据自身需求调整 Server 的相关配置,以达到较好的性能表现。系统配置项可分为两大模块:文件层配置项和引擎层配置项。用户可以通过iotdb-engine.properties
, 文件查看和修改两种配置项的内容。在 0.7.0 版本中字符串类型的配置项大小写敏感。