掛載CPFS文件系統時，如果返回如下報錯信息，表示CPFS文件系統不支持該計算節點的操作系統規格，請您更換計算節點規格。CPFS客戶端支持的操作系統請參見使用限制。

[ FATAL ] You cannot add cpfs-client-001 node because it has an unsupported OS for 'X86_64' architecture.

掛載CPFS文件系統時，如果返回如下報錯信息，表示待掛載的ECS實例未安裝kernel-devel、kernel-headers軟件包或已安裝的軟件包版本不適配。

No package kernel-devel-3.10.0-957.21.3.el7.x86_64 available.

Error: Nothing to do

please make sure kernel-devel version is consistent with kernel

請您執行以下命令檢查ECS實例上軟件包的安裝情況。

rpm -qa | grep kernel-devel-`uname -r`

當返回為空時，說明ECS實例上的軟件包安裝不正確，請您在ECS實例上重新安裝軟件包。具體操作，請參見步驟一：準備環境。

掛載CPFS文件系統時，如果返回如下報錯信息，表示待掛載ECS實例與文件系統之間網絡不通。

====> start check ssh
try ssh root@a.b.c.d by /root/.ssh/id_rsa.pub

ssh: connect to host a.b.c.d port 22: Connection timed out

掛載CPFS文件系統時，如果返回如下報錯信息，表示CPFS文件系統在待掛載的ECS實例上無法啟動。

[ WARN ] GPFS is not active on: hostname. Consult the install toolkit logs for possible errors 
during install. The GPFS service can also be started manually by running GPFS command 
'mmstartup -N Node[,Node...]'

[ FATAL ] GPFS NOT ACTIVE

請篩查以下可能原因并嘗試修復：

1. 待掛載的ECS實例安全組配置錯誤或未加入qr-sg安全組。具體操作，請參見配置安全組。

2. CPFS文件系統在使用時需要待掛載的ECS實例具備4 GB以上的內存，當待掛載的ECS實例內存較低時會報錯，請您確認ECS實例的內存。

掛載CPFS文件系統時，如果返回如下報錯信息，表示ECS實例可用內存小于4 GB。請您升級對應的ECS實例內存，然后再次執行cpfs add ip命令掛載文件系統。

[ WARN ] GPFS is not active on: hostname. Consult the install toolkit logs for possible errors 
during install. The GPFS service can also be started manually by running GPFS command 
'mmstartup -N Node[,Node...]'

[ FATAL ] GPFS NOT ACTIVE

掛載CPFS文件系統時，如果返回如下報錯信息，表示存在運行中的掛載或卸載任務，請您等待一段時間后再次嘗試掛載。

cpfs.sh is running already, pid: xyz

ECS實例A掛載CPFS文件系統時，如果返回如下報錯信息，表示當前CPFS文件系統集群中存在狀態異常的ECS實例B。

# cpfs add A

connect to host B port 22: Connection timed out

B hostname is invalid

Failed to add node.

請您參考以下方式排查并修復異常的ECS實例B，之后再次嘗試掛載操作。

在管理節點qr-001上執行mmgetstate -a，檢查ECS實例B狀態是否正常（active為正常狀態）。

• 如果實例B狀態正常，請提交工單聯系CPFS團隊進一步排查。

• 如果實例B狀態異常，請判斷該實例是否繼續使用。

  • 如果繼續使用該實例，請提交工單聯系CPFS團隊修復實例狀態。

  • 如果不再使用該實例，請執行mmdelnode -N <id> --force命令清除該節點信息。

    mmdelnode -N iZuf61mhwoc9flkufs0**** --force
    
      Do you want to continue? (yes/no) yes
    
    mmdelnode: [W] Could not cleanup the following unreached nodes:
    
    iZuf61mhwoc9flkufs0****
    
    mmdelnode: Command successfully completed
    
    mmdelnode: Propagating the cluster configuration data to all affected nodes. This is an 
    asynchronous process.

    清除后，請在/etc/hosts中刪除實例B的host信息。其中，iZuf61mhwoc9flkufs0****為目標ECS實例ID。

ECS實例A掛載CPFS文件系統時，如果返回如下報錯信息，表示當前CPFS文件系統集群中存在安裝中斷的ECS實例B且在安裝配置中有殘留。

[ FATAL ] ssh: connect to host B port 22: Connection timed out

[ FATAL ] B: Could not connect to B via ssh.

• 2.2.0以前的版本

  請您在/usr/lpp/mmfs/5.0.5.0/installer/configuration/clusterdefinition.txt文件中，刪除ECS實例B的殘留配置信息。

  [node4]
  fqdn = B
  
  os = rhel7
  arch = x86_64
  
  ip_address = 192.168.6.37
  is_admin_node = False
  
  is_object_store = False
  
  is_nfs = False
  is_smb = False
  
  is_hdfs = False
  is_protocol_node = False
  is_nsd_server = False
  access_ips =
  is_quorum_node = False
  
  is_manager_node = False
  is_gui_server = False
  is_ems_node = False
  
  is_callhome_node = False
  
  is_broker_node = False
  
  is_node_offline = False
  
  is_node_reachable = True
  
  is_node_excluded = False
  
  is_mestor_node = False

• 2.2.0及以后的版本

  請您在/usr/lpp/mmfs/5.1.2.0/ansible-toolkit/ansible/ibm-spectrum-scale-install-infra/vars/scale_clusterdefinition.json文件中，刪除ECS實例B的殘留配置信息。

     {
        "fqdn": "iZuf6hn0blj1g377w4xxxxZ",
        "os": "rhel7",
        "arch": "x86_64",
        "ip_address": "172.19.0.100",
        "is_admin_node": false,
        "is_object_store": false,
        "is_nfs": false,
        "is_smb": false,
        "is_hdfs": false,
        "is_protocol_node": false,
        "is_nsd_server": false,
        "is_quorum_node": false,
        "is_manager_node": false,
        "is_gui_server": false,
        "is_ems_node": false,
        "is_callhome_node": false,
        "is_broker_node": false,
        "is_node_offline": false,
        "is_node_reachable": true,
        "is_node_excluded": false,
        "is_mestor_node": false,
        "scale_daemon_nodename": "iZuf6hn0blj1g377w4xxxxZ"
      }

掛載CPFS文件系統時，如果返回如下報錯信息，表示您執行命令的節點錯誤。

[ FATAL ] No GPFS admin node specified. specify an admin node using 'spectrumscale node add <node name or IP> -a'.

請確認您是否是在qr-001節點上執行的CPFS命令。

掛載CPFS文件系統時，如果返回如下報錯信息，表示CentOS 8的YUM源配置失效。

Errors during downloading metadata for repository 'appstream':
Status code: 404 for http://mirrors.cloud.aliyuncs.com/centos/8/AppStream/x86_64/os/repodata/repomd.xml (IP: 100.100.XX.XX)
Error: Failed to download metadata for repo 'appstream': Cannot download repomd.xml: Cannot download repodata/repomd.xml: All mirrors were tried

首先，請您再次確認ECS實例已卸載CPFS文件系統。具體操作，請參見卸載文件系統。然后執行mmdelnode -N <id> --force命令，清理已卸載ECS實例的殘留配置信息，示例如下：

mmdelnode -N iZuf61mhwoc9flkufs0**** --force
  Do you want to continue? (yes/no) yes
mmdelnode: [W] Could not cleanup the following unreached nodes:

iZuf61mhwoc9flkufs0****

mmdelnode: Command successfully completed

mmdelnode: Propagating the cluster configuration data to all affected nodes. This is an 
asynchronous process.

其中，iZuf61mhwoc9flkufs0****為目標ECS實例ID。