Print Email PDF

Replication: NFS ID Mapping


Outlines how to configure NFS ID mapping for a replication relationship in Qumulo Core


  • Qumulo Core 2.12.6 or higher
  • NFS IDs configured on the Users & Groups page


In Qumulo Core 2.12.6 and above, you can replicate locally-owned files using NFS ID mapping for a replication relationship. If you have configured NFS UID and GID mappings for local users and groups, you can easily enable this feature in the UI or QQ CLI to ensure that files owned by a local identity are replicated under the local user’s mapped NFS IDs.

NOTE: Replicating locally-owned files using NFS IDs can only be configured on the source cluster and will need to be re-enabled after reversing a relationship before you reconnect.

Enable NFS ID Mapping via the Web UI

  1. On the the source cluster, hover over the Cluster menu and click Replication.
  2. Click Create Relationship or select Edit Relationship using the ellipsis.png menu in the action column for the relationship you want to modify.


  3. Click Enabled under the Map Local User/Group IDs to Associated NFS IDs section.
  4. Click Save Relationship.

Enable NFS ID Mapping via the QQ CLI

To create a new replication relationship on the source cluster with NFS ID mapping, specify the target and include the optional argument as shown in the following command:

qq replication_create_source_relationship --target-path TARGET_PATH --map-local-ids-to-nfs-ids true

Use the following command to enable NFS ID mapping on an existing replication relationship using the unique ID of the source cluster and optional argument:

qq replication_modify_source_relationship --id SOURCE_ID --map-local-ids-to-nfs-ids true

NOTE: To disable NFS ID mapping on an existing replication relationship, specify false instead of true in the command above.

Additional Considerations

  • Local users and groups in ACLs on the source cluster will be mapped to NFS UID and GIDs on the target cluster. These may not necessarily be mapped to an equivalent local user and group on the target.
  • If NFS ID mapping is disabled or any local identities are not mapped, replication jobs will encounter an irreplicable identity error.


You should now be able to successfully configure NFS ID mapping for a replication relationship in Qumulo Core


Replication: Continuous Replication with 2.11.2 and above

Create Users and Groups

QQ CLI: Replication


Like what you see? Share this article with your network! 

Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.

Have more questions?
Open a Case
Share it, if you like it.