Specifying a Tier

Describes how to associate a tier with a tiering-enabled volume using the Control System and the CLI.

About this task

NOTE

For a primer on Data Tiering, see Data Tiering.

Using the Control System, you can only associate an exiting tier (referred to as Remote Target in the Control System) with a volume enabled for Remote Archiving (or cold-tier). You cannot associate an existing tier with a volume enabled for Erasure Coding (or warm-tier) because the Control System allows a new tier to be automatically created when you enable a volume for erasure coding. If you want to associate an existing tier with a volume enabled for erasure coding, use the CLI or REST API to create the volume.

Specifying a Remote Target Using the Control System

About this task

You can associate a remote target with a cold-tier enabled volume when you are:
  • Creating the volume by clicking Create Volume button in the Data > Volumes page.
  • Editing the volume by clicking Edit Volume button in the volume information page.
To associate a remote target with the volume, in the Create Volume or Edit Volume page:

Procedure

  1. Click the Browse link associated with the Remote Target field to display the Browse Remote Target window.
  2. Review the name, vendor, bucket, region, and URL for each remote target and choose a remote target from the list.
  3. Click Select to associate the remote target with the volume.
  4. Complete the steps for creating or editing the volume.

Specifying a Tier Using the CLI and REST API

About this task

You can associate an existing tier with a volume when you are creating the tiering-enabled volume. You can associate an existing tier with a tiering-enabled volume when you are editing the volume only if the volume does not already have a tier associated with it. To associate an existing tier, you must specify the tiername parameter with the command.
Run a command similar to the following to associate a tier when:
  • Creating a volume: 
    maprcli volume create -name <volName> -path <mountPath> -tieringenable true -tiername <tierName> -json
    For the list of all other required and optional parameters, see volume create.
  • Editing the volume: 
    maprcli volume modify -name <volName> -tiername <tierName> -json
    For the list of all other required and optional parameters, see volume modify.
Send a request of type POST. For example, to associate a tier when:
  • Creating a volume: 
    curl -X POST 'https://<host>:8443/rest/volume/create?name=<volName>&path=<mountPath>&tieringenable=true&tiername=<tierName>&tieringrule=<ruleName>' --user <username>:<password>
    For the list of all other required and optional parameters, see volume create.
  • Editing the volume: 
    curl -X POST 'https://<host>:8443/rest/volume/modify?name=<volName>&tieringrule=<ruleName>' --user <username>:<password>
    For the list of all other required and optional parameters, see volume modify.