Cloud Parallel File Storage：掛載訪問FAQ

掛載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。