Migrating to FUSE-Based POSIX Clients

This section describes how to migrate from the loopbacknfs POSIX client to the FUSE-based POSIX basic client.

About this task

The FUSE-based Basic or Platinum POSIX client package is recommended for fresh installation and for all new clusters. If you are currently running the loopbacknfs POSIX client, you can migrate to the FUSE-based POSIX basic client package. By default, the system will only allow migrating the existing loopbacknfs POSIX client to the FUSE-based POSIX basic client. If you choose to upgrade using the existing loopbacknfs POSIX client licenses, by default, the system upgrades the selected nodes to the (paid) FUSE-based POSIX basic client. You cannot use existing licenses to migrate to the Platinum POSIX client package.

Before upgrading, ensure that the cluster has been upgraded to release 5.1.0 or higher because the FUSE-based POSIX client can only connect to clusters running release 5.1.0 or higher.

To migrate to the FUSE-based POSIX Basic client:

Procedure

  1. Stop the existing loopbacknfs POSIX service, unmount the mountpoint, and uninstall the mapr-loopbacknfs POSIX client.
    For more information, see MapR loopbacknfs POSIX Client.
  2. Run the following command to remove the loopbacknfs service node from the cluster: 
    /opt/mapr/bin/maprcli node remove -service nfsserver -nodes <node-name>
    If the host has multiple services, run the following command: 
    /opt/mapr/bin/maprcli node remove -hostids <service host id>
  3. Install the FUSE-based POSIX basic client package.
    For more information, see Installing a POSIX FUSE Client Package on Your Machine. When you install the FUSE-based POSIX client package, the licenses for the loopbacknfs POSIX client are automatically applied to the new client package.
  4. Verify the FUSE-based POSIX client license.
    For more information, see Configuring the HPE Ezmeral Data Fabric FUSE-Based POSIX Client.