IBM Cloud Private 2.1.0.2 CE多节点集群安装卡在Cloudant启动求助

我之前帮不少用户排查过ICP安装卡Cloudant启动的问题，结合你的环境（CentOS 7.2、Docker 17.09、3节点集群），给你整理几个针对性的排查步骤：

1. 先查看Cloudant容器的状态与日志 #

首先在主节点上定位Cloudant相关的容器，判断是否存在启动失败或循环重启的情况：

docker ps -a | grep cloudant

如果容器状态显示Exited或Restarting，立刻查看日志找错误根源：

docker logs <cloudant-container-id>

常见的权限不足、端口占用、配置错误等问题，都会在日志里有明确提示。

2. 检查存储卷的权限与可用空间 #

Cloudant依赖本地存储卷持久化数据，默认路径为/var/lib/icp/datastore/cloudant：

• 检查目录权限：确保所有者为root或容器运行用户（通常是UID 1001），权限至少设置为755：

  ls -ld /var/lib/icp/datastore/cloudant
  

• 确认/var/lib/docker所在分区的可用空间：总存储足够不代表Docker存储分区没被其他镜像占满，执行以下命令检查：

  df -h /var/lib/docker
  

3. 验证网络连通性与端口占用 #

Cloudant默认使用5984端口，端口被占用或节点间网络不通都会导致启动卡住：

• 检查主节点上5984端口是否被其他进程占用：

  ss -tulpn | grep 5984
  

• 在代理和工作节点上测试能否访问主节点的5984端口：

  curl http://<master-node-ip>:5984
  

• 临时关闭防火墙和SELinux排查（测试用，之后记得恢复）：

  systemctl stop firewalld
  setenforce 0
  

4. 确认icp-datastore镜像的正确性 #

即使你已经拉取了镜像，也需要确认镜像tag是否匹配ICP 2.1.0.2 CE：

docker images | grep icp-datastore

正确的镜像应为ibmcom/icp-datastore:2.1.0.2，如果镜像损坏，重新拉取：

docker pull ibmcom/icp-datastore:2.1.0.2

删除之前的Cloudant容器后，重新启动安装流程。

5. 检查安装配置文件并清理残留状态 #

• 打开cluster/config.yaml，确认datastore相关配置（如persistence、storage_class）未被误修改，保持与官方默认配置一致。
• 如果之前安装失败留下残留数据，先彻底清理：

  # 使用ICP官方清理脚本
  sudo docker run -e LICENSE=accept --net=host --rm -v /opt/icp:/data ibmcom/icp-inception:2.1.0.2-ce clean
  # 手动删除Cloudant数据目录
  rm -rf /var/lib/icp/datastore/cloudant
  

  之后重新执行安装命令：

  sudo docker run -e LICENSE=accept --net=host --rm -v $(pwd)/cluster:/installer/cluster ibmcom/icp-inception:2.1.0.2-ce install
  

如果以上步骤都无法解决问题，把Cloudant容器的错误日志贴出来，能更精准定位问题。

内容的提问来源于stack exchange，提问作者Priya Nair