MapR 5.0 Documentation : MapR-FS Views

The MapR-FS group provides the following views:

Tables

The Tables view displays a list of tables in the cluster.

The New Table button displays a field where you can enter the path to a new table to create from the MCS.

Click the name of a table from the Tables view to display the table detail view.

From the table detail view, click Delete Table to delete this table.

The table detail view has the following tabs:

  • Column Families
  • Regions

The Column Families tab displays the following information:

  • Column Family Name
  • Max Versions
  • Min Versions
  • Compression
  • Time-to-Live
  • In Memory

Click the Edit Column Family button to change these values. Click the Delete Column Family button to delete the selected column families.

The Regions tab displays the following information:

  • Start Key - The first key in the region range.
  • End Key - The last key in the region range.
  • Physical Size - The physical size of the region with compression.
  • Logical Size - The logical size of the region without compression.
  • # Rows - The number of rows stored in the region.
  • Primary Node - The region's original source for storage and computation.
  • Secondary Nodes - The region's replicated sources for storage and computation.
  • Last HB - The time interval since the last data communication with the region's primary node.
  • Region Identifier - The tablet region identifier.

Volumes

The Volumes view displays the following information about volumes in the cluster:

  • Mnt - Whether the volume is mounted. ( )
  • Vol Name - The name of the volume.
  • Mount Path - The path where the volume is mounted.
  • Creator - The user or group that owns the volume.
  • Quota - The volume quota.
  • Vol Size - The size of the volume.
  • Data Size - The size of the volume on the disk before compression.
  • Snap Size - The size of the all snapshots for the volume. As the differences between the snapshot and the current state of the volume grow, the amount of data storage taken up by the snapshots increases.
  • Total Size - The size of the volume and all its snapshots.
  • Replication Factor - The number of copies of the volume.
  • Physical Topology - The rack path to the volume.

Clicking any column name sorts data in ascending or descending order by that column.

The Unmounted checkbox specifies whether to show unmounted volumes:

  • selected - show both mounted and unmounted volumes
  • unselected - show mounted volumes only

The System checkbox specifies whether to show system volumes:

  • selected - show both system and user volumes
  • unselected - show user volumes only

Selecting the Filter checkbox displays the Filter toolbar, which provides additional data filtering options.

Clicking New Volume displays the New Volume dialog.

New Volume

The New Volume dialog lets you create a new volume.

For mirror volumes, the Snapshot Scheduling section is replaced with a section called Mirror Scheduling:


The Volume Setup section specifies basic information about the volume using the following fields:

  • Volume Type - a standard volume, or a local or remote mirror volume
  • Volume Name (required) - a name for the new volume
  • Mount Path - a path on which to mount the volume (check the small box at the right to indicate the mount path for the new volume; if the box is not checked, an unmounted volume is created)
  • Topology - the new volume's rack topology
  • Read-only - if checked, prevents writes to the volume

The Permissions section lets you grant specific permissions on the volume to certain users or groups:

  • User/Group field - the user or group to which permissions are to be granted (one user or group per row)
  • Permissions field - the permissions to grant to the user or group (see the Permissions table below)
  • Delete button ( ) - deletes the current row
  • [+ Add Permission ] - adds a new row

Volume Permissions

Code

Allowed Action

dump

Dump/Back up the volume

restore

Restore/Mirror the volume

m

Edit volume properties

d

Delete the volume

fc

Full control (admin access and permission to change volume ACL)

The Usage Tracking section displays cluster usage and sets quotas for the volume using the following fields:

  • Quotas - the volume quotas:
    • Volume Advisory Quota - if selected, enter the advisory quota for the volume expressed as an integer plus the single letter abbreviation for the unit (such as 100G for 100GB). When this quota is reached, an advisory email is sent to the user or group.
    • Volume Hard Quota - if selected, enter the maximum limit for the volume expressed as an integer plus the single letter abbreviation for the unit (such as 128G for 128GB). When this hard limit is reached, no more data is written to the volume.

The Replication section contains the following fields:

  • Replication - the requested replication factor for the volume
  • Min Replication - the minimum replication factor for the volume. When the number of replicas drops down to or below this number, the volume is aggressively re-replicated to bring it above the minimum replication factor.
  • Optimize Replication For - the basis for choosing the optimum replication factor (high throughput or low latency)

The Snapshot Scheduling section (normal volumes) contains the snapshot schedule, which determines when snapshots will be automatically created. Select an existing schedule from the pop-up menu.

The Mirror Scheduling section (local and remote mirror volumes) contains the mirror schedule, which determines when mirror volumes will be automatically created. Select an existing schedule from the pop-up menu.

Buttons:

  • OK - creates the new volume
  • Cancel - exits without creating the volume

Volume Actions

You can modify a volume's properties by selecting the checkbox next to that volume and clicking the Volume Actions button. A dropdown menu of properties you can modify displays.

To apply one set of changes to multiple volumes, mark the checkboxes next to each volume.

Properties

Clicking on a volume name displays the Volume Properties dialog where you can view information about the volume, and check or change various settings. You can also remove the volume.

If you click on Remove Volume, the following dialog appears:

Buttons:

  • OK - removes the volume or volumes
  • Cancel - exits without removing the volume or volumes

For information about the fields in the Volume Properties dialog, see New Volume.

The Partly Out of Topology checkbox fills when containers in this volume are outside the volume's main topology.

Snapshots

The Snapshots dialog displays the following information about snapshots for the specified volume:

  • Snapshot Name - The name of the snapshot.
  • Disk Used - The total amount of logical storage held by the snapshot. Since the current volume and all of its snapshots will often have storage held in common, the total disk usage reported will often exceed the total storage used by the volume. The value reported in this field is the size the snapshot would have if the difference between the snapshot and the volume's current state is 100%.
  • Created - The date and time the snapshot was created.
  • Expires - The snapshot expiration date and time.

Buttons:

  • New Snapshot - Displays the Snapshot Name dialog.
  • Remove - When the checkboxes beside one or more snapshots are selected, displays the Remove Snapshots dialog.
  • Preserve - When the checkboxes beside one or more snapshots are selected, prevents the snapshots from expiring.
  • Close - Closes the dialog.

New Snapshot

The Create New Snapshot dialog lets you specify the name for a new snapshot you are creating.

The Snapshot Name dialog creates a new snapshot with the name specified in the following field:

  • Name For New Snapshot(s) - the new snapshot name

Buttons:

  • OK - creates a snapshot with the specified name
  • Cancel - exits without creating a snapshot

Remove Snapshots

The Remove Snapshots dialog prompts you for confirmation before removing the specified snapshot or snapshots.

Buttons

  • Yes - removes the snapshot or snapshots
  • No - exits without removing the snapshot or snapshots

Assign Cluster-Wide Provisionary Space Limit

You can modify standard volume reserve limits by clicking the Assign Cluster-Wide Provisionary Space Limit button. 

When you set a reserve limit, you provision a certain amount of space to each volume as a percentage of cluster capacity. You may want to set a reserve limit to free up space that could potentially be unused or allocate more space for replication. As data is written to the volume, available space is automatically allocated. The volume reserve increases up to the reserve limit you set.

 

Mirror Volumes

The Mirror Volumes pane displays information about mirror volumes in the cluster:

  • Mnt - whether the volume is mounted
  • Vol Name - the name of the volume
  • Src Vol - the source volume
  • Src Clu - the source cluster
  • Orig Vol -the originating volume for the data being mirrored
  • Orig Clu - the originating cluster for the data being mirrored
  • Last Mirrored - the time at which mirroring was most recently completed
  • - status of the last mirroring operation
  • % Done - progress of the mirroring operation
  • Error(s) - any errors that occurred during the last mirroring operation

 

User Disk Usage

The User Disk Usage view displays information about disk usage by cluster users:

  • Name - the username
  • Disk Usage - the total disk space used by the user
  • # Vols - the number of volumes
  • Hard Quota - the user's quota
  • Advisory Quota - the user's advisory quota
  • Email - the user's email address

Snapshots

The Snapshots view displays the following information about volume snapshots in the cluster:

  • Snapshot Name - the name of the snapshot
  • Volume Name - the name of the source volume volume for the snapshot
  • Disk Space used - the disk space occupied by the snapshot
  • Created - the creation date and time of the snapshot
  • Expires - the expiration date and time of the snapshot

Clicking any column name sorts data in ascending or descending order by that column.

Selecting the Filter checkbox displays the Filter toolbar, which provides additional data filtering options.

Buttons:

  • Remove Snapshot - when the checkboxes beside one or more snapshots are selected, displays the Remove Snapshots dialog
  • Preserve Snapshot - when the checkboxes beside one or more snapshots are selected, prevents the snapshots from expiring

Schedules

The Schedules view lets you view and edit schedules, which can then can be attached to events to create occurrences. A schedule is a named group of rules that describe one or more points of time in the future at which an action can be specified to take place.

The left pane of the Schedules view lists the following information about the existing schedules:

  • Schedule Name - the name of the schedule; clicking a name displays the schedule details in the right pane for editing
  • In Use - indicates whether the schedule is in use ( ), or attached to an action

The right pane provides the following tools for creating or editing schedules:

  • Schedule Name - the name of the schedule
  • Schedule Rules - specifies schedule rules with the following components:
    • A dropdown that specifies frequency (Once, Yearly, Monthly, Weekly, Daily, Hourly, Every X minutes)
    • Dropdowns that specify the time within the selected frequency
    • Retain For - the time for which the scheduled snapshot or mirror data is to be retained after creation
  • [ +Add Rule ] - adds another rule to the schedule

Navigating away from a schedule with unsaved changes displays the Save Schedule dialog.

Buttons:

  • New Schedule - starts editing a new schedule
  • Remove Schedule - displays the Remove Schedule dialog
  • Save Schedule - saves changes to the current schedule
  • Cancel - cancels changes to the current schedule

Remove Schedule

The Remove Schedule dialog prompts you for confirmation before removing the specified schedule.

Buttons

  • Yes - removes the schedule
  • No - exits without removing the schedule