挂载访问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。