Home
6.0 Administration
This section describes how to manage the nodes and services that make up a cluster.
Administrator's Reference
This section contains in-depth reference information for the administrator.
maprcli and REST API Syntax
This section provides information about the MapR command API. Most commands can be run on the command-line interface (CLI), or by making REST requests programmatically or in a browser.
node
Manages nodes in the cluster
node maintenance
Places a node into a maintenance mode for a specified timeout duration.

6.0 Administration
This section describes how to manage the nodes and services that make up a cluster.
- Administering Users and Clusters
- Administering Nodes
- Administering Volumes
  This section provide information about how to organize and manage data using volumes, a unique feature of MapR clusters.
- Administering Files and Directories
- Administering Tables
  Administration of the MapR-DB is done primarily via the command line (maprcli) or with the MapR Control System (MCS). Regardless of whether the MapR-DB table is used for binary files or JSON documents, the same types of commands are used with slightly different parameter options. MapR-DB administration is associated with tables, columns and column families, and table regions.
- Administering Streams
- Administering MapR Gateways
  A MapR gateway mediates one-way communication between a source MapR cluster and a destination cluster. You can replicate MapR-DB tables (binary and JSON) and MapR-ES streams. MapR gateways also apply updates from JSON tables to their secondary indexes and propagate Change Data Capture (CDC) logs.
- Administering Services
- Monitoring the Cluster
  This section describes how to monitor the health and performance of a MapR cluster.
- Configuring Security
  Describes how to configure MapR security and manage secure clusters.
- Managing Secure Clusters
  Provides procedures that will enable you to use MapR clusters securely.
- 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.
- Planning for High Availability
- Administrator's Reference
  This section contains in-depth reference information for the administrator.
  - maprcli and REST API Syntax
    This section provides information about the MapR command API. Most commands can be run on the command-line interface (CLI), or by making REST requests programmatically or in a browser.
    - Overview
      Each command reference page includes the command syntax, a table that describes the parameters, and examples of command usage.
    - acerole validate
      Verifies given user roles for ACEs exists in the /opt/mapr/conf/m7_permissions_roles_refimpl.conf file.
    - acl
      Describes the acl commands used to access control lists (ACLs).
    - alarm
      Describes the alarm commands that perform functions related to system alarms.
    - audit
      Describes commands used to audit operations related to cluster management and data access.
    - blacklist
      Describes commands used to blacklist and to list blacklisted users.
    - cluster
      Manages cluster features, gateways, and cluster-wide settings.
    - config
      Manages configuration values for the MapR cluster.
    - dashboard info
      Displays a summary of information about the cluster.
    - dialhome
    - disk
      Describes command for working with disks.
    - dump
      Returns key information about volumes, containers, storage pools, and MapR cluster services for debugging and troubleshooting.
    - entity
      Manages entities (users and groups).
    - fid
      Displays information about MapR-DB or file-system components that are identified by a FID.
    - job
      Manages Hadoop jobs running on the cluster.
    - license
      Manages MapR licenses.
    - nfsmgmt
      Refreshes NFS exports and server cache.
    - node
      Manages nodes in the cluster
      - node allow-into-cluster
        Allows host IDs to join the cluster after duplicates have been resolved.
      - node cldbmaster
        Returns the address of the master CLDB node.
      - node failover
        Fails over master containers and VIPs to another node.
      - node heatmap
        Displays a heatmap for the specified nodes.
      - node list
        Lists nodes in the cluster.
      - node listcldbs
        Returns the hostnames of the nodes in the cluster that are running the CLDB service.
      - node listcldbzks
        Returns the hostnames of the nodes in the cluster that are running the CLDB service and the IP addresses and port numbers for the nodes in the cluster that are running the ZooKeeper service.
      - node listzookeepers
        Returns the hostnames of the nodes in the cluster that are running the zookeeper service.
      - node maintenance
        Places a node into a maintenance mode for a specified timeout duration.
      - node metrics
        Retrieves metrics information for nodes in a cluster.
      - node move
        Moves one or more nodes to a different topology. Permissions required: fc or a.
      - node remove
        Removes one or more server nodes from the system. Permissions required: fc or a.
      - node services
        Starts, stops, or restarts services on one or more server nodes. Permissions required: ss, fc or a.
      - node topo
        Lists cluster topology information.
    - rlimit
      Manages resource usage limits for the cluster.
    - schedule
      Manages schedules.
    - service list
      Lists all services on the specified node, the memory allocated for each service, the state of each service, and log path for each service.
    - setloglevel
      Sets log level on individual services.
    - stream
      Manages stream functionality.
    - table
      Performs functions related to MapR-DB tables.
    - trace
      Lets you view and modify the trace buffer, and the trace levels for the system modules.
    - urls
      Displays the status page URL for the specified service.
    - virtualip
      Manages virtual IP addresses for NFS nodes.
    - volume
      Manages volumes, snapshots and mirrors.
  - Utilities
    This section contains information about various scripts and utilities.
  - Configuration Files
    This section contains reference information about various configuration files.
  - Alarms Reference
    The pages in this section provide details about all of the types of alarms.
  - MapR Environment
    This section provides information associated with the MapR environment.
- Troubleshooting Cluster Administration
- Best Practices for Backing Up MapR Information

node maintenance

Places a node into a maintenance mode for a specified timeout duration.

For the duration of the timeout, the cluster's CLDB does not consider this node's data as lost and does not trigger a resync of the data on this node. See Administering Nodes for more information.

Syntax

CLI

maprcli node maintenance
    [ -cluster <cluster> ]
    [ -serverids <serverids> ]
    -nodes <node names>
    -timeoutminutes <timeout in minutes>

REST

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

Parameters

Parameter	Description
`cluster`	The cluster on which to run the command.
`serverids`	List of server IDs
`nodes`	List of nodes, space separated.
`timeoutminutes`	Duration of timeout in minutes

Examples

maprcli node maintenance -nodes centos22.lab -timeoutminutes 20

https://abc.sj.us:8443/rest/node/maintenance?nodes=centos22.lab&timeoutminutes=20