config save

Saves configuration information, specified as key/value pairs. Permissions required: fc or a.

WARNING

Changing the cluster configuration may impact the way the cluster functions. Make sure you understand the change well, or else make the change under the guidance of Data Fabric support.

Syntax

CLI

maprcli config save
         [ -cluster cluster name ]
         [-test test only. default: 0]
         -values JSON Object to comprise all config properties to save

REST

Request Type	POST
Request URL	`http[s]://<host>:<port>/rest/config/save?<parameters>`

Parameters

Parameter	Description
`cluster`	(Optional) The cluster on which to run the command.
`values`	(Required) A JSON object containing configuration fields; see the Configuration Fields table.
`test`	(Optional) Set this to 1 to test the SMTP configuration without actually saving the values. The system sends a test email to check if the configuration is correct. This parameter is applicable only for SMTP configuration. The default value is `0`.

Examples

Configure Data Fabric SMTP settings:

CLI

maprcli config save -values '{"mapr.smtp.provider":"gmail","mapr.smtp.server":"smtp.gmail.com","mapr.smtp.sslrequired":"true","mapr.smtp.port":"465","mapr.smtp.sender.fullname":"Ab  Cd","mapr.smtp.sender.email":"xxx@gmail.com","mapr.smtp.sender.username":"xxx@gmail.com","mapr.smtp.sender.password":"abc"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"mapr.smtp.provider":"gmail","mapr.smtp.server":"smtp.gmail.com","mapr.smtp.sslrequired":"true","mapr.smtp.port":"465","mapr.smtp.sender.fullname":"Ab  Cd","mapr.smtp.sender.email":"xxx@gmail.com","mapr.smtp.sender.username":"xxx@gmail.com","mapr.smtp.sender.password":"abc"}

Define the maximum number of configured security policies:

CLI

maprcli config save -values '{"cldb.max.security.policies":"2048"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"cldb.max.security.policies":"2048"}

Set the master security policy cluster:

CLI

maprcli config save -values '{"cldb.pbs.global.master":"1"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"cldb.pbs.global.master":"1"}

Set the number of volumes to balance at a time:

CLI

maprcli config save -values '{"cldb.tier.gw.balance.num.vols.per.batch":"500"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"cldb.tier.gw.balance.num.vols.per.batch":"500"}

NOTE

The maximum number of volumes that can be balanced at a time is 1000.

Allocate CLDB memory for mirroring:

CLI

maprcli config save -values '{"cldb.mirror.memory.factor":"60"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"cldb.mirror.memory.factor":"60"}

Set the maximum number of concurrent web server sessions permissible for a Data Fabric user:

IMPORTANT

If you wish to restrict the maximum number of concurrent user sessions permissible for a Data Fabric user, DO NOT configure spring security concurrency control in session-management. For example, DO NOT use code similar to the following:
```
<session-management>
     <concurrency-control max-sessions="2" />
</session-management>
```
If you change the value for the apiserver.max.concurrent.user.sessions field when the apiserver service is running on your cluster nodes, you must restart the apiserver service on all relevant cluster nodes after changing the value for the apiserver.max.concurrent.user.sessions field.

CLI

maprcli config save -values '{"apiserver.max.concurrent.user.sessions":"1"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"apiserver.max.concurrent.user.sessions":"1"}

Allocate CLDB memory for mirroring:

CLI

maprcli config save -values '{"cldb.mirror.memory.factor":"60"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"cldb.mirror.memory.factor":"60"}

Set the buffer size for the insight service to 2048 records:

CLI

maprcli config save -values '{"cldb.insight.buffer.size":"2048"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"cldb.insight.buffer.size":"2048"}

Set the time interval for committing insight data to 2 minutes:

CLI

maprcli config save -values '{"cldb.insight.commit.interval.mins":"2"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"cldb.insight.commit.interval.mins":"2"}

Enable debugging for insights:

CLI

maprcli config save -values '{"cldb.insight.debug.enabled":"true"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"cldb.insight.debug.enabled":"true"}

Set the heartbeat for insight service to 10 seconds:

CLI

maprcli config save -values '{"cldb.insight.heartbeat.seconds":"10"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"cldb.insight.heatbeat.seconds":"10"}

Set secure communication with the Hive Metastore for the insight service:

CLI

maprcli config save -values '{"cldb.insight.hivemetastore.sasl.enabled":"true"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"cldb.insight.hivemetastore.sasl.enabled":"true"}

Set SSL communication with the Hive Metastore for the insight service:

CLI

maprcli config save -values '{"cldb.insight.hivemetastore.ssl.enabled":"true"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"cldb.insight.hivemetastore.ssl.enabled":"true"}

Set the insight summarization interval to 1 minute:

CLI

maprcli config save -values '{"cldb.insight.summarization.minutes":"1"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"cldb.insight.summarization.minutes":"1"}

Set the purge frequency of the insight records to 5 hours:

CLI

maprcli config save -values '{"cldb.insight.purge.frequency.hours":"5"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"cldb.insight.purge.frequency.hours":"5"}

Enable automatic logout from user session when a user closes the browser without logging out of the Control System, the Object Store UI, or the Data Fabric UI (or the user refreshes the web browser window) :

CLI

maprcli config save -values '{"dfui.security.securedtabwindow":"true"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"dfui.security.securedtabwindow":"true"}

Set the summary table purge frequency to 5 hours:

CLI

maprcli config save -values '{"cldb.insight.summarytable.purge.hours":"5"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"cldb.insight.summarytable.purge.frequency":"5"}

Set the Zeppelin port for the insight service to 8000:

CLI

maprcli config save -values '{"cldb.insight.zeppelin.port":"8000"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"cldb.insight.zeppelin.port":"8000"}

Enable the insight service on the Data Fabric UI

CLI

maprcli config save -values '{"dfui.insight.enable":"true"}'

REST

NOTE

When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.

curl -k -u <username> -X POST https://abc.sj.us:8443/rest/config/save?values={"dfui.insight.enable":"true"}

HPE Ezmeral Data Fabric 7.10.0 Documentation
Abstract	This site contains documentation for the customer-managed platform of the HPE Ezmeral Data Fabric version 7.10.0 including installation, configuration, administration, and reference content, as well as content for the associated bundled ecosystem components and drivers.
Published	June 2025
Edition	7.10.0
Topic last updated	2025-06-11