MapR 5.1 is at End of Life (EOL) and no longer supported. Please see the latest documentation. This documentation is not being updated.

Home
5.1 Reference
This section provides information about development content including MapR-FS and MapReduce development topics and reference content.
Reference Guide
maprcli and REST API Syntax
virtualip
Manages virtual IP addresses for NFS nodes.
virtualip add
Adds a virtual IP address. Permissions required: fc or a.

MapR 5.1 Documentation

5.1 Reference
This section provides information about development content including MapR-FS and MapReduce development topics and reference content.
- Development Guide
- Reference Guide
  - MapR Control System
  - Hadoop Commands
  - HBase Shell for MapR-DB
    You can manage MapR-DB tables using HBase shell commands and additional HBase shell commands included in the MapR distribution of Hadoop.
  - YARN commands
  - maprcli and REST API Syntax
    - Overview
      Each command reference page includes the command syntax, a table that describes the parameters, and examples of command usage.
    - 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.
    - nagios generate
      Generates a Nagios Object Definition file that describes the cluster nodes and the services running on each.
    - nfsmgmt
      Refreshes NFS exports and server cache.
    - node
      Manages nodes in the cluster
    - 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.
    - task
      Manipulates information about the Hadoop jobs that are running on your cluster.
    - 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.
      - virtualip add
        Adds a virtual IP address. Permissions required: fc or a.
      - virtualip edit
        Edits a virtual IP (VIP) range. Permissions required: fc or a.
      - virtualip list
        Lists the virtual IP addresses in the cluster.
      - virtualip move
        Reassigns a virtual IP or a range of virtual IP addresses to a specified Media Access Control (MAC) address.
      - virtualip remove
        Removes a virtual IP (VIP) or a VIP range. Permissions required: fc or a.
    - volume
      Manages volumes, snapshots and mirrors.
  - Alarms Reference
  - Utilities
  - Default MapR Configurations
  - Configuration Files
  - MapR Environment
  - MapR Parameters
  - Best Practices
  - Language Support for MapR-DB Tables
  - Glossary
    This section contains defintions for commonly used terms in MapR Converged Data Platform environments.
  - Source Code for MapR Software
- Glossary
  This section contains defintions for commonly used terms in MapR Converged Data Platform environments.

virtualip add

Adds a virtual IP address. Permissions required: fc or a.

Syntax

CLI

maprcli virtualip add
    [ -cluster <cluster> ]
    [ -gateway <gateway> ]
    [ -macs <MAC address> ]
    -netmask <netmask>
    -virtualip <virtualip>
    [ -virtualipend <virtual IP range end> ]
    [ -preferredmac <MAC address> ]

REST

http[s]://<host>:<port>/rest/virtualip/add?<parameters>

Parameters

Parameter	Description
cluster	The cluster on which to run the command.
gateway	The NFS gateway IP or address
macs	A list of the MAC addresses that represent the NICs on the nodes that the VIPs in the VIP range can be associated with. Use this list to limit VIP assignment to NICs on a particular subnet when your NFS server is part of multiple subnets.
netmask	The netmask of the virtual IP.
virtualip	The virtual IP, or the start of the virtual IP range.
virtualipend	The end of the virtual IP range.
preferredmac	The preferred MAC for this virtual IP. When an NFS server restarts, the MapR system attempts to move all of the virtual IP addresses that list a MAC address on this node as a preferred MAC to this node. If the new value is null, this parameter resets the preferred MAC value.

Example

CLI

maprcli virtualip add   -cluster mycluster.402.source  -macs "09:0C:29:3C:47:AB 03:3C:34:76:CF:21"  -netmask 255.255.255.0  -virtualip  10.1.1.5 -preferredmac "02:0E:22:71:AD:34"

REST

https://r1n1.sj.us:8443/rest/virtualid/add?cluster=mycluster.402.source&macs="09%3A0C%3A29%3A3C%3A47%3AAB 03%3A3C%3A34%3A76%3ACF%3A21"&netmask=255.255.255.0&virtualid=10.1.1.5&preferredmac="02%3A0E%3A22%3A71%3AAD%3A34"