This is an automated email from the ASF dual-hosted git repository.

haonan pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/iotdb.git


The following commit(s) were added to refs/heads/master by this push:
     new cfb244b877d Add comments in docker-compose for startup hang (#16342)
cfb244b877d is described below

commit cfb244b877d49b34a0697be5319ad149e9e14e27
Author: CritasWang <[email protected]>
AuthorDate: Thu Sep 4 18:42:56 2025 +0800

    Add comments in docker-compose for startup hang (#16342)
---
 .../main/DockerCompose/docker-compose-ainode.yml    |  9 ++++++++-
 .../DockerCompose/docker-compose-cluster-1c1d1a.yml | 15 ++++++++++++---
 .../DockerCompose/docker-compose-cluster-1c2d.yml   | 21 +++++++++++++++++++++
 .../main/DockerCompose/docker-compose-host-3c3d.yml | 14 ++++++++++++++
 .../DockerCompose/docker-compose-standalone.yml     |  9 ++++++++-
 5 files changed, 63 insertions(+), 5 deletions(-)

diff --git a/docker/src/main/DockerCompose/docker-compose-ainode.yml 
b/docker/src/main/DockerCompose/docker-compose-ainode.yml
index f89862600b0..e393d9ccffe 100644
--- a/docker/src/main/DockerCompose/docker-compose-ainode.yml
+++ b/docker/src/main/DockerCompose/docker-compose-ainode.yml
@@ -43,4 +43,11 @@ services:
     volumes:
       - ainode-data:/ainode/data
       - ./logs/ainode:/ainode/logs
-      # - ./lib/ainode:/ainode/lib  # Uncomment for rolling upgrade
\ No newline at end of file
+      # - ./lib/ainode:/ainode/lib  # Uncomment for rolling upgrade
+    # Note: Some environments set an extremely high container nofile limit 
(~2^30 = 1073741824).
+    # This can make the startup step "Checking whether the ports are already 
occupied..." appear to hang (lsof slow).
+    # If you see that line for a long time, lower the nofile limit by 
uncommenting below:
+    # ulimits:
+    #   nofile:
+    #     soft: 1048576
+    #     hard: 1048576
\ No newline at end of file
diff --git a/docker/src/main/DockerCompose/docker-compose-cluster-1c1d1a.yml 
b/docker/src/main/DockerCompose/docker-compose-cluster-1c1d1a.yml
index b6a1b63c573..3be71caed7e 100644
--- a/docker/src/main/DockerCompose/docker-compose-cluster-1c1d1a.yml
+++ b/docker/src/main/DockerCompose/docker-compose-cluster-1c1d1a.yml
@@ -41,11 +41,13 @@ services:
     volumes:
         - ./data/iotdb:/iotdb/data
         - ./logs/iotdb:/iotdb/logs
-    # Enable this configuration for kylinOS
+    # Note: Some environments set an extremely high container nofile limit 
(~2^30 = 1073741824).
+    # This can make the startup step "Checking whether the ports are already 
occupied..." appear to hang (lsof slow).
+    # If you see that line for a long time, lower the nofile limit by 
uncommenting below:
     # ulimits:
     #   nofile:
-    #     soft: 20000
-    #     hard: 20000
+    #     soft: 1048576
+    #     hard: 1048576
     networks:
       iotdb:
         # ipv4_address: 127.0.0.1
@@ -62,6 +64,13 @@ services:
     networks:
       iotdb:
     #     ipv4_address: 127.0.0.1
+    # Note: Some environments set an extremely high container nofile limit 
(~2^30 = 1073741824).
+    # This can make the startup step "Checking whether the ports are already 
occupied..." appear to hang (lsof slow).
+    # If you see that line for a long time, lower the nofile limit by 
uncommenting below:
+    # ulimits:
+    #   nofile:
+    #     soft: 1048576
+    #     hard: 1048576
 
 networks:
   iotdb:
diff --git a/docker/src/main/DockerCompose/docker-compose-cluster-1c2d.yml 
b/docker/src/main/DockerCompose/docker-compose-cluster-1c2d.yml
index 0cd0f8ac78b..3303b0b6805 100644
--- a/docker/src/main/DockerCompose/docker-compose-cluster-1c2d.yml
+++ b/docker/src/main/DockerCompose/docker-compose-cluster-1c2d.yml
@@ -34,6 +34,13 @@ services:
     networks:
       iotdb:
         ipv4_address: 172.18.0.2
+    # Note: Some environments set an extremely high container nofile limit 
(~2^30 = 1073741824).
+    # This can make the startup step "Checking whether the ports are already 
occupied..." appear to hang (lsof slow).
+    # If you see that line for a long time, lower the nofile limit by 
uncommenting below:
+    # ulimits:
+    #   nofile:
+    #     soft: 1048576
+    #     hard: 1048576
 
   iotdb-datanode1:
     image: apache/iotdb:1.1.0-datanode
@@ -56,6 +63,13 @@ services:
     networks:
       iotdb:
         ipv4_address: 172.18.0.3
+    # Note: Some environments set an extremely high container nofile limit 
(~2^30 = 1073741824).
+    # This can make the startup step "Checking whether the ports are already 
occupied..." appear to hang (lsof slow).
+    # If you see that line for a long time, lower the nofile limit by 
uncommenting below:
+    # ulimits:
+    #   nofile:
+    #     soft: 1048576
+    #     hard: 1048576
 
   iotdb-datanode2:
     image: apache/iotdb:1.1.0-datanode
@@ -76,6 +90,13 @@ services:
     networks:
       iotdb:
         ipv4_address: 172.18.0.4
+    # Note: Some environments set an extremely high container nofile limit 
(~2^30 = 1073741824).
+    # This can make the startup step "Checking whether the ports are already 
occupied..." appear to hang (lsof slow).
+    # If you see that line for a long time, lower the nofile limit by 
uncommenting below:
+    # ulimits:
+    #   nofile:
+    #     soft: 1048576
+    #     hard: 1048576
 
 networks:
   iotdb:
diff --git a/docker/src/main/DockerCompose/docker-compose-host-3c3d.yml 
b/docker/src/main/DockerCompose/docker-compose-host-3c3d.yml
index 242505d9d93..e2a66dc17d5 100644
--- a/docker/src/main/DockerCompose/docker-compose-host-3c3d.yml
+++ b/docker/src/main/DockerCompose/docker-compose-host-3c3d.yml
@@ -35,6 +35,13 @@ services:
       - ./data/confignode:/iotdb/data
       - ./logs/confignode:/iotdb/logs
     network_mode: "host"
+    # Note: Some environments set an extremely high container nofile limit 
(~2^30 = 1073741824).
+    # This can make the startup step "Checking whether the ports are already 
occupied..." appear to hang (lsof slow).
+    # If you see that line for a long time, lower the nofile limit by 
uncommenting below:
+    # ulimits:
+    #   nofile:
+    #     soft: 1048576
+    #     hard: 1048576
 
   iotdb-datanode:
     image: apache/iotdb:1.1.0-datanode
@@ -55,3 +62,10 @@ services:
       - ./data/datanode:/iotdb/data/
       - ./logs/datanode:/iotdb/logs/
     network_mode: "host"
+    # Note: Some environments set an extremely high container nofile limit 
(~2^30 = 1073741824).
+    # This can make the startup step "Checking whether the ports are already 
occupied..." appear to hang (lsof slow).
+    # If you see that line for a long time, lower the nofile limit by 
uncommenting below:
+    # ulimits:
+    #   nofile:
+    #     soft: 1048576
+    #     hard: 1048576
diff --git a/docker/src/main/DockerCompose/docker-compose-standalone.yml 
b/docker/src/main/DockerCompose/docker-compose-standalone.yml
index 1c8edd94eca..5ecb169da42 100644
--- a/docker/src/main/DockerCompose/docker-compose-standalone.yml
+++ b/docker/src/main/DockerCompose/docker-compose-standalone.yml
@@ -44,7 +44,14 @@ services:
     networks:
       iotdb:
         ipv4_address: 172.18.0.6
+    # Note: Some environments set an extremely high container nofile limit 
(~2^30 = 1073741824).
+    # This can make the startup step "Checking whether the ports are already 
occupied..." appear to hang (lsof slow).
+    # If you see that line for a long time, lower the nofile limit by 
uncommenting below:
+    # ulimits:
+    #   nofile:
+    #     soft: 1048576
+    #     hard: 1048576
 
 networks:
   iotdb:
-    external: true
+    external: true
\ No newline at end of file

Reply via email to