Step 4: Enable New Features

Describes the new features to enable after upgrading core without the Installer using a manual offline or rolling upgrade method.

This task applies to all manual upgrade methods: offline, rolling, and manual rolling upgrades. After a successful manual upgrade, administrators have the option to enable new features that are not enabled by default. During a fresh install, these features are enabled automatically.

Before Enabling New Features

Before enabling new features, review these important notes:
  • You can obtain a list of features for your currently installed software by using the following command:
    maprcli cluster feature list
  • Before enabling new features, you must upgrade all nodes in the cluster and all clients that access the cluster.
  • The maprcli config save command is no longer available for enabling features.

How to Enable New Features

You enable new features by using the maprcli cluster feature enable command. For more information about this command, see maprcli cluster commands.

Hewlett Packard Enterprise recommends that you enable all new features. Use the following command:
maprcli cluster feature enable -all

Feature Summary

The following table describes considerations for enabling some features. The table ia not a complete list of data-fabric features:

Feature Feature Name Available as of Release Description
HPE Ezmeral Data Fabric Object Store cldb.objectstore.support 7.0.0 Enables native object storage to store objects and metadata for optimized access. Provides access to data through multiple protocols, including the native S3 API, NFS, POSIX, and CSI. Object Store S3 protocols fully comply with AWS S3, including S3 Select features. For more information, see HPE Ezmeral Data Fabric Object Store.
Policy-Based Security mfs.feature.pbs 6.2 Enables a feature that administrators can use to organize security controls into a manageable number of security policies. For more information, see Policy-Based Security.
Snapshot Restore mfs.feature.snapshot.restore.support 6.2 Restores volume data from a snapshot.
Storage Labels cldb.lbs.support 6.2 Enables usage of Storage Labels on a cluster upgraded to version 6.2.
Optimize Volumes for CLDB cldb.feature.optimize.volume.kvstores 6.2 Enabling this tunable automatically optimizes the B-Tree of CLDB tables with a large number of volumes and read-write containers, and results in enhanced CLDB performance. For more information, see Optimizing CLDB Tables.
Parallel Offload mfs.feature.container.sharding.support 6.2 Enables the parallel offload feature to use multiple MAST Gateways, to offload a volume’s data in parallel. For more information, see Enabling Tiering.
Last Access Time mfs.feature.update.atime 6.2 Enables the Last Access Time feature. For more information, see Tuning Last Access Time.
Data-at-Rest Encryption mfs.feature.dare 6.1 Enables support for encrypting data at rest on the data-fabric cluster. See Enabling Encryption of Data at Rest for more information.
Data Tiering mfs.feature.storage.tiering.support 6.1 Enables support for offloading data to different storage tiers. See Enabling Tiering for more information.
Name Container Threshold mfs.feature.name.container.size.control 6.0.1 Enables support for setting a limit on the size of data stored in the name container for a volume.
Directcopy for Autosetup Replication, Change Data Capture and Secondary Index mfs.feature.db.streams.v6.support 6.0 Enables the following:
  • HPE Ezmeral Data Fabric Database tables and HPE Ezmeral Data Fabric Streams to use the directcopy option with the autosetup replication feature.
  • HPE Ezmeral Data Fabric Database table Change Data Capture (CDC) feature.
  • HPE Ezmeral Data Fabric Database Secondary Index feature.
Enforce Guaranteed Minimum Replication mfs.feature.enforce.min.replication 6.0 Enables support for enforcing minimum number of replicas for (read-write) volumes during write operations.
NOTE
Do not enable this feature before upgrading all the nodes in the cluster. If you enable this feature before upgrading all the nodes, file system shuts down on the nodes that have not yet been upgraded.
CLDB Snapshot Improvements mfs.feature.snapshotdb.lite 6.0 This feature stays disabled even after you enable it, till you perform a CLDB failover. The feature is enabled only after the CLDB failover is complete, after which you can experience significant performance improvements for snapshot create and delete operations.
External IPs for CLDB cldb.feature.external.ip 6.0 Enables support for external IP addresses and port forwarding. Set the environment variables (as described here) before enabling this feature. After enabling this feature, perform a CLDB failover to allow file system to re-register.
Container Identity Reuse cldb.feature.cid.reuse 5.2.1 Support for container identity reuse.
Fast inode Scan for Mirroring mfs.feature.fastinodescan.support 5.2.1 Enables fast mirroring when there are large numbers of files with few changes.
Streams Connect Support mfs.feature.streams.connect.support 5.2.1 Enables support for Kafka Connect in the distributed mode.
Extended Attributes mfs.feature.fileace.support 5.2 Enables support for adding, retrieving, and removing extended attributes on files and directories.
Hardlinks mfs.feature.hardlinks.support 5.2 Enables support for retrieving hard links on files.
Access Control Expressions for file system mfs.feature.fileace.support 5.1 Enables the setting of Access Control Expressions on filesystem and whole volume data.
HPE Ezmeral Data Fabric Streams and HPE Ezmeral Data Fabric Database as a document database mfs.feature.db.json.support 5.1 Enables the use of Data Fabric Streams and HPE Ezmeral Data Fabric Database as a Document Database.
Data Fabric Auditing mfs.feature.audit.support 5.0 Logs audit records of cluster-administration operations and operations on directories, files, and tables.
Data Fabric Volume Upgrade

mfs.feature.volume.upgrade

mfs.feature.rwmirror.support

5.0 Enables support for promotable mirrors on both old-format and new-format volumes.
HPE Ezmeral Data Fabric Database Table Replication mfs.feature.db.repl.support 4.1 Enables support for HPE Ezmeral Data Fabric Database table replication.
Promotable Mirror Volumes mfs.feature.rwmirror.support 4.0.2 Enables support for promotable mirror volumes.
Reduce On-Disk Container Size cldb.reduce.container.size 4.0.2 Reduces the space required on-disk for each container. The reduction of the on-disk container size takes effect after the CLDB service restarts or fails over.
NOTE
After enabling this feature on a cluster with more than a million containers, it may take some time for the initial failover to complete, as the CLDB rewrites container location tables and storage pool container map tables. However, this delay does not reoccur with any subsequent failovers.
Bulk Loading of Data to HPE Ezmeral Data Fabric Database Tables mfs.feature.db.bulkload.support 3.1.1 Enables support for bulk loading of data to HPE Ezmeral Data Fabric Database tables. Used when upgrading from MapR version 3.1 or earlier.
Access Control Expressions and Table Region Merges

mfs.feature.db.ace.support

mfs.feature.db.regionmerge.support

mfs.feature.filecipherbit.support

3.1

The following features enable support for Managing Access Control Expressions (ACEs) and table region merge. Used when upgrading from MapR version 3.0.x.

mfs.feature.db.ace.support
mfs.feature.db.regionmerge.support

These features are automatically enabled with a fresh install or when you upgrade from a version earlier than 3.0.x.

IMPORTANT
After enabling ACEs for HPE Ezmeral Data Fabric Database tables, table access is enforced by table ACEs instead of the filesystem. As a result, all newly created tables are owned by root and have their mode bits set to 777.

The following feature enables encryption of network traffic to or from a file, directory, or HPE Ezmeral Data Fabric Database table. This feature is enabled after you enable security features on your cluster.

mfs.feature.filecipherbit.support
WARNING
Clusters with active security features experience job failures until this configuration value is set.