單機版部署

本章將介紹如何啟動IoTDB單機實例，IoTDB單機實例包括 1 個ConfigNode 和1個DataNode（即通常所說的1C1D）。

注意事項

1. 安裝前請確認系統已參照系統配置準備完成。

2. 部署時推薦優先使用hostname進行IP配置，可避免后期修改主機ip導致數據庫無法啟動的問題。設置hostname需要在目標服務器上配置/etc/hosts，如本機ip是192.168.1.3，hostname是iotdb-1，則可以使用以下命令設置服務器的 hostname，并使用hostname配置IoTDB的cn_internal_address、dn_internal_address、dn_rpc_address。

   echo "192.168.1.3  iotdb-1" >> /etc/hosts

3. 部分參數首次啟動后不能修改，請參考下方的【參數配置】章節進行設置

4. 無論是在linux還是windows中，請確保IoTDB的安裝路徑中不含空格和中文，避免軟件運行異常。

5. 請注意，安裝部署（包括激活和使用軟件）IoTDB時需要保持使用同一個用戶進行操作，您可以：

• 使用 root 用戶（推薦）：使用 root 用戶可以避免權限等問題。
• 使用固定的非 root 用戶：
  • 使用同一用戶操作：確保在啟動、激活、停止等操作均保持使用同一用戶，不要切換用戶。
  • 避免使用 sudo：盡量避免使用 sudo 命令，因為它會以 root 用戶權限執行命令，可能會引起權限混淆或安全問題。

6. 推薦部署監控面板，可以對重要運行指標進行監控，隨時掌握數據庫運行狀態，監控面板可以聯系商務獲取，部署監控面板步驟可以參考：監控面板部署。

7. 在安裝部署數據庫前，可以使用健康檢查工具檢測 IoTDB 節點運行環境，并獲取詳細的檢查結果。 IoTDB 健康檢查工具使用方法可以參考：健康檢查工具。

安裝步驟

前置檢查

為確保您獲取的IoTDB企業版安裝包完整且正確，在執行安裝部署前建議您進行SHA512校驗。

準備工作：

• 獲取官方發布的 SHA512 校驗碼：發布歷史文檔中各版本對應的"SHA512校驗碼"

校驗步驟（以 linux 為例）：

1. 打開終端，進入安裝包所在目錄（如/data/iotdb）：

      cd /data/iotdb

2. 執行以下命令計算哈希值：

      sha512sum timechodb-{version}-bin.zip

3. 終端輸出結果（左側為SHA512 校驗碼，右側為文件名）：

img

4. 對比輸出結果與官方 SHA512 校驗碼，確認一致后，即可按照下方流程執行IoTDB企業版的安裝部署操作。

注意事項：

• 若校驗結果不一致，請聯系天謀工作人員重新獲取安裝包
• 校驗過程中若出現"文件不存在"提示，需檢查文件路徑是否正確或安裝包是否完整下載

解壓安裝包并進入安裝目錄

unzip  iotdb-enterprise-{version}-bin.zip
cd  iotdb-enterprise-{version}-bin

參數配置

環境腳本配置

• ./conf/confignode-env.sh（./conf/confignode-env.bat）配置

配置項	說明	默認值	推薦值	備注
MEMORY_SIZE	IoTDB ConfigNode節點可以使用的內存總量	空	可按需填寫，填寫后系統會根據填寫的數值來分配內存	修改后保存即可，無需執行；重啟服務后生效

• ./conf/datanode-env.sh（./conf/datanode-env.bat）配置

配置項	說明	默認值	推薦值	備注
MEMORY_SIZE	IoTDB DataNode節點可以使用的內存總量	空	可按需填寫，填寫后系統會根據填寫的數值來分配內存	修改后保存即可，無需執行；重啟服務后生效

系統通用配置

打開通用配置文件（./conf/iotdb-system.properties 文件），設置以下參數：

配置項	說明	默認值	推薦值	備注
cluster_name	集群名稱	defaultCluster	可根據需要設置集群名稱，如無特殊需要保持默認即可	首次啟動后不可修改，V1.3.3及之后版本支持熱加載，但不建議手動修改該參數
schema_replication_factor	元數據副本數，單機版此處設置為 1	1	1	默認1，首次啟動后不可修改
data_replication_factor	數據副本數，單機版此處設置為 1	1	1	默認1，首次啟動后不可修改

ConfigNode配置

打開ConfigNode配置文件（./conf/iotdb-system.properties文件），設置以下參數：

配置項	說明	默認	推薦值	備注
cn_internal_address	ConfigNode在集群內部通訊使用的地址	127.0.0.1	所在服務器的IPV4地址或hostname，推薦使用hostname	首次啟動后不能修改
cn_internal_port	ConfigNode在集群內部通訊使用的端口	10710	10710	首次啟動后不能修改
cn_consensus_port	ConfigNode副本組共識協議通信使用的端口	10720	10720	首次啟動后不能修改
cn_seed_config_node	節點注冊加入集群時連接的ConfigNode 的地址，cn_internal_address:cn_internal_port	127.0.0.1:10710	cn_internal_address:cn_internal_port	首次啟動后不能修改

DataNode 配置

打開DataNode配置文件 ./conf/iotdb-system.properties，設置以下參數：

配置項	說明	默認	推薦值	備注
dn_rpc_address	客戶端 RPC 服務的地址	0.0.0.0	所在服務器的IPV4地址或hostname，推薦使用所在服務器的IPV4地址	重啟服務生效
dn_rpc_port	客戶端 RPC 服務的端口	6667	6667	重啟服務生效
dn_internal_address	DataNode在集群內部通訊使用的地址	127.0.0.1	所在服務器的IPV4地址或hostname，推薦使用hostname	首次啟動后不能修改
dn_internal_port	DataNode在集群內部通信使用的端口	10730	10730	首次啟動后不能修改
dn_mpp_data_exchange_port	DataNode用于接收數據流使用的端口	10740	10740	首次啟動后不能修改
dn_data_region_consensus_port	DataNode用于數據副本共識協議通信使用的端口	10750	10750	首次啟動后不能修改
dn_schema_region_consensus_port	DataNode用于元數據副本共識協議通信使用的端口	10760	10760	首次啟動后不能修改
dn_seed_config_node	節點注冊加入集群時連接的ConfigNode地址,即cn_internal_address:cn_internal_port	127.0.0.1:10710	cn_internal_address:cn_internal_port	首次啟動后不能修改

??注意：VSCode Remote等編輯器無自動保存配置功能，請確保修改的文件被持久化保存，否則配置項無法生效

啟動及激活數據庫 （V 1.3.4 及以后的 1.x 版本）

啟動 ConfigNode 節點

進入iotdb的sbin目錄下，啟動confignode

./start-confignode.sh    -d      #“-d”參數將在后臺進行啟動

如果啟動失敗，請參考常見問題。

啟動 DataNode 節點

進入iotdb的sbin目錄下，啟動datanode：

./start-datanode.sh   -d   #-d參數將在后臺進行啟動

激活數據庫

通過 CLI 激活

• 進入 CLI

 ./sbin/start-cli.sh

• 執行以下內容獲取激活所需機器碼：

  show system info

• 將返回機器碼復制給天謀工作人員：

+--------------------------------------------------------------+
|                                                    SystemInfo|
+--------------------------------------------------------------+
|                                          01-TE5NLES4-UDDWCMYE|
+--------------------------------------------------------------+
Total line number = 1
It costs 0.030s

• 將工作人員返回的激活碼輸入到CLI中，輸入以下內容
  • 注：激活碼前后需要用'符號進行標注，如所示

IoTDB> activate '01-D4EYQGPZ-EAUJJODW-NUKRDR6F-TUQS3B75-EDZFLK3A-6BOKJFFZ-ALDHOMN7-NB2E4BHI-7ZKGFVK6-GCIFXA4T-UG3XJTTD-SHJV6F2P-Q27B4OMJ-R47ZDIM3-UUASUXG2-OQXGVZCO-MMYKICZU-TWFQYYAO-ZOAGOKJA-NYHQTA5U-EWAR4EP5-MRC6R2CI-PKUTKRCT-7UDGRH3F-7BYV4P5D-6KKIA==='

啟動及激活數據庫 （V 1.3.4 之前版本）

啟動 ConfigNode 節點

進入iotdb的sbin目錄下，啟動confignode

./start-confignode.sh    -d      #“-d”參數將在后臺進行啟動

如果啟動失敗，請參考常見問題。

激活數據庫

方式一：激活文件拷貝激活

• 啟動confignode節點后，進入activation文件夾, 將 system_info文件復制給天謀工作人員
• 收到工作人員返回的 license文件
• 將license文件放入對應節點的activation文件夾下；

方式二：激活腳本激活

• 獲取激活所需機器碼，進入安裝目錄的sbin目錄，執行激活腳本:

 cd sbin
./start-activate.sh

• 顯示如下信息，請將機器碼（即該串字符）復制給天謀工作人員：

Please copy the system_info's content and send it to Timecho:
01-KU5LDFFN-PNBEHDRH
Please enter license:

• 將工作人員返回的激活碼輸入上一步的命令行提示處 Please enter license:，如下提示：

Please enter license:
Jw+MmF+AtexsfgNGOFgTm83BgXbq0zT1+fOfPvQsLlj6ZsooHFU6HycUSEGC78eT1g67KPvkcLCUIsz2QpbyVmPLr9x1+kVjBubZPYlVpsGYLqLFc8kgpb5vIrPLd3hGLbJ5Ks8fV1WOVrDDVQq89YF2atQa2EaB9EAeTWd0bRMZ+s9ffjc/1Zmh9NSP/T3VCfJcJQyi7YpXWy5nMtcW0gSV+S6fS5r7a96PjbtE0zXNjnEhqgRzdU+mfO8gVuUNaIy9l375cp1GLpeCh6m6pF+APW1CiXLTSijK9Qh3nsL5bAOXNeob5l+HO5fEMgzrW8OJPh26Vl6ljKUpCvpTiw==
License has been stored to sbin/../activation/license
Import completed. Please start cluster and excute 'show cluster' to verify activation status

啟動 DataNode 節點

進入iotdb的sbin目錄下，啟動datanode：

./start-datanode.sh   -d   #-d參數將在后臺進行啟動

驗證部署

可直接執行 ./sbin 目錄下的 Cli 啟動腳本：

./start-cli.sh  -h  ip(本機ip或域名)  -p  端口號(6667)

成功啟動后，出現如下界面顯示IOTDB安裝成功。

出現安裝成功界面后，繼續看下是否激活成功，使用show cluster命令

當看到最右側顯示ACTIVATED表示激活成功

還可在 CLI 中通過執行 show activation 命令查看激活狀態，示例如下，狀態顯示為ACTIVATED表示激活成功

IoTDB> show activation
+---------------+---------+-----------------------------+
|    LicenseInfo|    Usage|                        Limit|
+---------------+---------+-----------------------------+
|         Status|ACTIVATED|                            -|
|    ExpiredTime|        -|2026-04-30T00:00:00.000+08:00|
|  DataNodeLimit|        1|                    Unlimited|
|       CpuLimit|       16|                    Unlimited|
|    DeviceLimit|       30|                    Unlimited|
|TimeSeriesLimit|       72|                1,000,000,000|
+---------------+---------+-----------------------------+

出現ACTIVATED(W)為被動激活，表示此ConfigNode沒有license文件（或沒有簽發時間戳最新的license文件）。此時建議檢查license文件是否已放入license文件夾，沒有請放入license文件，若已存在license文件，可能是此節點license文件與其他節點信息不一致導致，請聯系天謀工作人員重新申請.

常見問題

1. 部署過程中多次提示激活失敗

   • 使用 ls -al 命令：使用 ls -al 命令檢查安裝包根目錄的所有者信息是否為當前用戶。
   • 檢查激活目錄：檢查 ./activation 目錄下的所有文件，所有者信息是否為當前用戶。

2. Confignode節點啟動失敗

   步驟 1: 請查看啟動日志，檢查是否修改了某些首次啟動后不可改的參數。

   步驟 2: 請查看啟動日志，檢查是否出現其他異常。日志中若存在異常現象，請聯系天謀技術支持人員咨詢解決方案。

   步驟 3: 如果是首次部署或者數據可刪除，也可按下述步驟清理環境，重新部署后，再次啟動。

   步驟 4: 清理環境：

   a. 結束所有 ConfigNode 和 DataNode 進程。

       # 1. 停止 ConfigNode 和 DataNode 服務
       sbin/stop-standalone.sh
   
       # 2. 檢查是否還有進程殘留
       jps
       # 或者
       ps -ef|grep iotdb
   
       # 3. 如果有進程殘留，則手動kill
       kill -9 <pid>
       # 如果確定機器上僅有1個iotdb，可以使用下面命令清理殘留進程
       ps -ef|grep iotdb|grep -v grep|tr -s '  ' ' ' |cut -d ' ' -f2|xargs kill -9

   b. 刪除 data 和 logs 目錄。

   說明：刪除 data 目錄是必要的，刪除 logs 目錄是為了純凈日志，非必需。

       cd /data/iotdb
       rm -rf data logs