IBM Cloud部署HyperLedger Fabric 1.1：composer network install命令执行失败

我来帮你解决在IBM Cloud部署Hyperledger Fabric 1.1时，执行composer network install命令失败的问题，结合官方教程的场景，以下是常见的排查和解决步骤：

1. 验证PeerAdmin连接卡片的有效性 #

• 首先执行composer card list命令，确认PeerAdmin@fabric-network卡片是否存在且状态正常。如果该卡片不存在，需要重新创建：

  注意：创建卡片时要确保使用的证书、Peer节点地址、MSP ID完全匹配IBM Cloud上的Fabric实例配置，尤其是远程Peer的gRPC地址（格式类似peer0.org1.example.com:7051）。

• 如果卡片存在但状态异常，可以尝试删除后重新导入：composer card delete -c PeerAdmin@fabric-network，再重新生成并导入卡片。

2. 检查BNA包的完整性 #

• 先验证业务网络归档文件（BNA）是否有效，执行命令：

  composer archive validate -a tutorial-network@0.0.1.bna
  

  如果验证失败，说明BNA包损坏或格式错误，需要回到业务网络项目目录，重新生成归档文件：

  composer archive create -t dir -n .
  

3. 确认Peer节点状态与权限 #

• 登录IBM Cloud控制台，查看目标Fabric Peer节点是否处于运行中状态，如果节点异常，先重启Peer节点再尝试安装。
• 确保PeerAdmin身份拥有安装业务网络的权限：IBM Cloud上的Fabric实例默认PeerAdmin角色具备该权限，但如果是自定义身份，需要检查其所属MSP的角色配置，以及是否加入了目标通道。

4. 排查网络连通性问题 #

• 测试本地机器与IBM Cloud Peer节点的gRPC端口（默认7051）是否连通，可以用telnet <peer-address> 7051或nc -zv <peer-address> 7051命令验证。如果不通，可能是本地防火墙、公司网络策略或IBM Cloud安全组拦截了端口，需要开放对应的端口访问权限。
• 如果使用VPN连接IBM Cloud，确保VPN连接正常，网络路由能正确指向Fabric集群。

5. 获取详细错误日志定位问题 #

• 在执行安装命令时添加-vvv参数开启调试模式，获取更详细的错误信息：

  composer network install -c PeerAdmin@fabric-network -a tutorial-network@0.0.1.bna -vvv
  

  日志中通常会明确指出失败原因，比如连接超时、证书无效、BNA格式错误等，根据具体信息针对性解决。

6. 确认版本兼容性 #

• Hyperledger Composer 0.20.x版本才与Fabric 1.1兼容，如果本地安装的Composer版本过高（比如0.21.x对应Fabric 1.2），会出现兼容性问题。可以执行composer -v查看版本，若版本不匹配，需要降级到0.20.x版本：

  npm install -g composer-cli@0.20.9
  npm install -g composer-rest-server@0.20.9
  

内容的提问来源于stack exchange，提问作者G Sreekanth