Administering the MapR Data Access Gateway

The MapR Data Access Gateway is a service that acts as a proxy and gateway for translating requests between lightweight client applications and the MapR cluster. This section describes considerations when upgrading the service, how to modify configuration settings, and how to administer and manage the service.

Installing the Data Access Gateway Service

The MapR Data Access Gateway is installed when you install MapR-DB in the MapR installer. To manually install the service, see Installing MapR Data Access Gateway. For installation guidance, see Understanding the MapR Data Access Gateway.

Upgrading the Data Access Gateway Service

When the Data Access Gateway receives a shutdown request, it stops accepting new requests and returns an error to the client. Any in-progress requests are allowed to complete before shutting down the service. This allows you to perform rolling upgrades.

Modifying Configuration Settings for the Data Access Gateway Service

Logging Properties

The MapR Data Access Gateway uses standard Log4J configuration to control its logging. The log4j properties are in the file /opt/mapr/data-access-gateway/conf/log4j2.xml on nodes where you have installed the service. After modifying any properties on a node, restart the service. See Administering the Data Access Gateway Service for details.

The file /opt/mapr/data-access-gateway/logs/data-access-gateway.log contains the log data.

Application Properties

You can configure MapR Data Access Gateway properties by modifying the file /opt/mapr/data-access-gateway/conf/properties.cfg on nodes where you have installed the service.

The following table lists the properties you can set:

Property Name Default Description
auth.token.expiration 1800 Expiration time (in seconds) for the authentication token
rest.https.port 8243 Port number used to connect to the Data Access Gateway using HTTPS
rest.result.limit 5000 Limit on the number of documents returned in retrieval requests using the MapR-DB JSON REST API

After modifying any parameters on a node, restart the service, as described in the Administering the Data Access Gateway Service section.

Warden Configuration

The warden configuration for the MapR Data Access Gateway is in the file /opt/mapr/data-access-gateway/conf/warden.data-access-gateway.conf on nodes where you have installed the Data Access Gateway. Modify the following settings to control the amount of memory allocated to the service:

Parameter Default Description
service.heapsize.max 3000 Defines the maximum heap size (in MB) for the service
service.heapsize.min 3000 Defines the minimum heap size (in MB) for the service

After modifying the warden configuration file on a node, run configure.sh -R, and restart the service:

/opt/mapr/server/configure.sh -R
maprcli node services -nodes <node name> -name data-access-gateway -action restart

Administering the Data Access Gateway Service

The MapR Data Access Gateway is a service that you administer in the same way as other MapR services. The name of the service is data-access-gateway.

To restart the service through the CLI, run the following command:
maprcli node services -nodes <node name> -name data-access-gateway -action restart

See Managing Services for details about other operations you can perform on the service.