volume create
Creates a volume.
Permissions Required
cv
or fc
on the cluster.
Syntax
- CLI
-
/opt/mapr/bin/maprcli volume create -name <volume name> [ -advisoryquota <advisory quota> ] [ -ae <accounting entity> ] [ -aetype <accounting entity type> ] [ -allowgrant true|false ] [ -allowinherit true|false ] [ -allowreadforexecute Enable reads for files with execute permission. <true|false> ] [-atimeUpdateInterval <days>] [ -auditenabled true|false ] [ -autooffloadthresholdgb <offload size threshold> ] [ -cluster <cluster> ] [ -coalesce <interval in mins> ] [ -compactionoverheadthreshold <compaction_overhead> ] [ -compactionschedule <compaction_schedule_ID> ] [ -containerallocationfactor <positive integer> ] [ -createparent 0|1 ] [ -criticalrereplicationtimeoutsec ] [ -dare true|false ] [ -dataauditops <+|- operations> ] [ -dbindexlagsecalarmthresh <threshold> ] [ -dbrepllagsecalarmthresh <threshold> ] [ -ecenable true|false ] [ -eclabel ec volume label ] [ -ecscheme <ec scheme> ] [ -ectopology <path to ec volume> ] [ -enforcementmode <PolicyAceAndDataAce|PolicyAceOnly|DataAceOnly|PolicyAceAuditAndDataAce>> ] [ -enforceminreplicationforio true|false ] [ -filefilter <file filter> ] [ -forceauditenable true|false ] [ -group <list of group:allowMask> ] [ -honorrackreliability <ec-rack-reliability : true | false> ] [ -inherit <volume name> ] [ -label <data label> ] [ -localvolumehost <localvolumehost> ] [ -localvolumeport <localvolumeport> ] [ -maxinodesalarmthreshold <maxinodesalarmthreshold> ] [ -maxnssizembalarmthreshold <maxnssizembalarmthreshold> ] [ -metricsenabled true|false ] [ -minreplication <minimum replication factor> ] [ -mirrorschedule <mirror schedule ID> ] (4.0.2 only) [ -mirrorthrottle 0|1 ] [ -mount 0|1 ] [ -namecontainerdatathreshold <size> ] [ -nslabel <name cntr label>] [ -nsminreplication <minimum replication factor> ] [ -nsreplication <replication factor> ] [ -numactivecgcontainers <num active cg containers> ] [ -offloadschedule <schedule ID> ] [ -path <mount path> ] [ -quota <quota> ] [ -readAce <access control expression> ] [ -readonly <read-only status> ] [ -recallexpirytime <expiry time> ] [ -replication <replication factor> ] [ -replicationtype <type> ] [ -rereplicationtimeoutsec <seconds> ] [ -rootdirgroup <root directory group> ] [ -rootdirperms <root directory permissions> ] [ -rootdiruser <root directory user> ] [ -rootdirsecuritypolicy <comma separated security policies> ] [ -schedule <ID> [ -securitypolicy <policy1,policy2,…> ] [ -skipinherit schedule|tiername ] [ -skipwiresecurityfortierinternalops Skip Wire level security for backend volumes <true|false> ] [ -source <source> ] [ -tenantuser <tenant name> ] [ -tierencryption true|false ] [ -tieringenable true|false ] [ -tieringrule <rulename> ] [ -tierkey <tier encryption key> ] [ -tiername <tiername> ] [ -topology <topology> ] [ -type rw|mirror ] [ -user <list of user:allowMask> ] [ -wiresecurityenabled true|false ] [ -writeAce <access control expression> ]
- REST
-
Request Type POST Request URL http[s]://<host>:<port>/rest/volume/create?<parameters>
Parameters
- Parameter:
advisoryquota
- Default Value: No default value
- Parameter:
ae
- Default Value: No default value
- Parameter:
aetype
- Default Value: No default value
- Parameter:
allowgrant
- Default Value: false
- Parameter:
allowinherit
- Default Value: true
- Parameter:
allowreadforexecute
- Default Value: false
- Parameter:
auditenabled
- Default Value: true
- Parameter:
autooffloadthresholdgb
- Default Value: 1024 GB
- Parameter:
cluster
- Default Value: No default value
- Parameter:
coalesce
- Default Value: 60 minutes
- Parameter:
compactionoverheadthreshold
- Default Value: 30%
- Parameter:
compactionschedule
- Default Value: Automatic Internal Schedule
- Parameter:
containerallocationfactor
- Default Value: 5
- Parameter:
createparent
- Default Value: 1
- Parameter:
criticalrereplicationtimeoutsec
- Default Value: 0 (No timeout)
- Parameter:
dare
- Default Value: false
- Parameter:
dataauditops
- Default Value: Default enabled audit ops:
setattr,chown,chperm,chgrp,getxattr,listxattr,setxattr,removexattr,read,write,create,delete, mkdir,readdir,rmdir,createsym,lookup,rename,createdev,truncate,tablecfcreate,tablecfdelete, tablecfmodify,tablecfScan,tableget,tableput,tablescan,tablecreate,tableinfo,tablemodify,getperm, getpathforfid,hardlink,filescan,fileoffload,filerecall,filetierjobstatus,filetierjobabort
- Parameter:
dbindexlagsecalarmthresh
- Default Value: 300 seconds
- Parameter:
dbrepllagsecalarmthresh
- Default Value: 900 seconds
- Parameter:
ecenable
- Default Value: false
- Parameter:
eclabel
- Default Value: HDD
- Parameter:
ecscheme
- Default Value: 4+2
- Parameter:
ectopology
- Default Value:
/data/default-rack
- Parameter:
enforcementmode
- Default Value: No default value
- Parameter:
enforceminreplicationforio
- Default Value: false
- Parameter:
filefilter
- Possible Values: Any file filter.
- Parameter:
forceauditenable
- Default Value: false
- Parameter:
group
- Default Value: No default value
- Parameter:
honorrackreliability <ec-rack-reliability : true | false>
- Default Value: false
- Parameter:
inherit
- Default Value: No default value
- Parameter:
label
- Default Value: default
- Parameter:
localvolumehost
- Default Value: No default value
- Parameter:
localvolumeport
- Default Value: 5660
- Parameter:
maxinodesalarmthreshold
- Default Value: 50000000
- Parameter:
maxnssizembalarmthreshold
- Default Value: 500 GB
- Parameter:
metricsenabled
- Default Value: false
- Parameter:
minreplication
- Default Value: 2
- Parameter:
mirrorschedule
- Default Value: 0
- Parameter:
mirrorthrottle
- Default Value: true
- Parameter:
mount
- Default Value: true
- Parameter:
name
- Default Value: No default value
- Parameter:
namecontainerdatathreshold
- Default Value: 524288 MB
- Parameter:
nslabel
- Default Value: default
- Parameter:
nsminreplication
- Default Value: 2
- Parameter:
nsreplication
- Default Value: 3
- Parameter:
numactivecgcontainers
- Default Value: 0
- Parameter:
offloadschedule
- Default Value: No default value
- Parameter:
path
- Default Value: No default value
- Parameter:
quota
- Default Value: 0
- Parameter:
readAce
- Default Value:
p
(grant access to all users) - Parameter:
readonly
- Default Value: No default value
- Parameter:
recallexpirytime
- Default Value: 1 day
- Parameter:
replication
- Default Value: 3
- Parameter:
replicationtype
- Default Value:
high_throughput
- Parameter:
rereplicationtimeoutsec
- Default Value: 3600 seconds (1 hour)
- Parameter:
rootdirgroup
- Default Value: User who is running the command
- Parameter:
rootdirperms
- Default Value:
rwxr-xr-x
- Parameter:
rootdiruser
- Default Value: User who is running the command
- rootdirsecuritypolicy
- Default Value: None
- Parameter:
schedule
- Default Value: 0
- Parameter:
skipinherit
- Default Value: No default value
- Parameter:
source
- Default Value: No default value
- Parameter:
tenant
- Default Value: No default value
- Parameter:
tierencryption
- Default Value: false
- Parameter:
tieringenable
- Default Value: No default value
- Parameter:
tieringrule
- Default Value:
p
(all files) - Parameter:
tierkey
- Default Value: Auto generated
- Parameter:
tiername
- Default Value: No default value
- Parameter:
topology
- Default Value:
/data
- Parameter:
type
- Default Value: 0
- Parameter:
user
- Default Value: All permissions (
dump, restore, m, a, d, fc
) for the administrator who created the volume - Parameter:
wiresecurityenabled
- Default Value: true
- Parameter:
writeAce
- Default Value:
p
(grants access to all users)
Inheritance
The following table shows the list of inheritable parameters that are (Yes) and are not (No) inherited by a:
- Mirror volume from the source volume on the same cluster
- Mirror volume from the source volume on a different cluster
volume create
parameters.Inheritable Properties (which are inherited by non-mirror volumes by default) | Inherited by Mirror Volume on the same cluster as the source volume? | Inherited by Mirror Volume on a different cluster from the source volume? |
---|---|---|
advisoryquota |
Yes | Yes |
ae |
Yes | No |
aetype |
Yes | No |
allowgrant |
Yes | Yes |
allowinherit |
Yes | Yes |
auditenabled |
Yes | Yes |
coalesce |
Yes | Yes |
dare |
Yes | Yes1, No2 |
dataauditops |
Yes | Yes |
dbindexlagsecalarmthresh |
Yes | Yes |
dbrepllagsecalarmthresh |
Yes | Yes |
enforcementMode |
Yes | Yes |
ecscheme |
Yes | No |
ectopology |
Yes | No |
group |
Yes | Yes |
inherit |
Yes | Yes |
localvolumehost |
No | No |
localvolumeport |
No | No |
maxinodesalarmthreshold |
Yes | Yes |
minreplication |
Yes | Yes |
mirrorschedule |
Yes | No |
mirrorthrottle |
Yes | Yes |
nsminreplication |
Yes | Yes |
nsreplication |
Yes | Yes |
ofloadschedule |
Yes | No |
quota |
Yes | Yes |
readonly |
Yes | Yes |
recallexpirytime |
Yes | No |
replication |
Yes | Yes |
replicationtype |
Yes | Yes |
rereplicationtimeoutsec |
Yes | Yes |
rootdirperms |
Yes | Yes |
schedule |
Yes3 | No |
securitypolicy |
Yes | Yes |
source |
Yes | Yes |
tierencryption |
Yes | No |
tieringenable |
Yes | No |
tieringrule |
Yes | No |
tierkey |
Yes | No |
tiername 4 |
Yes | No |
topology |
Yes | No |
type |
Yes | Yes |
user |
Yes | Yes |
wiresecurityenabled |
Yes | Yes |
- 1 If destination cluster is also enabled for
data-at-rest encryption,
dare
setting is inherited by the mirror volume on the destination cluster. - 2 If destination cluster is not enabled for
data-at-rest encryption,
dare
setting is not inherited by the mirror volume on the destination cluster. - 3 If
schedule
keyword is specified with theskipinherit
parameter, schedule(s) are not inherited while inheriting volume properties from the source volume. - 4 If
tiername
keyword is specified with theskipinherit
parameter:- The tiering properties are not inherited by the mirror volume while inheriting volume properties from the tiering-enabled source volume.
- For volumes enabled for warm-tier, the backend erasure-coded volume is not created.
Examples
Create the volume "test-volume" mounted at "/test/test-volume" with a time of 2 days
/opt/mapr/bin/maprcli volume create -name test-volume -path /test/test-volume -type rw -atimeUpdateInterval 2 -json
{
"timestamp":1526522204072,
"timeofday":"2020-05-16 06:56:44.072 GMT-0700 PM",
"status":"OK",
"total":0,
"data":[
],
"messages":[
"Successfully created volume: 'test-volume'"
]
}
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=test-volume&path=/test/test-volume&type=rw&atimeUpdateInterval=2' --user <username>:<password>
{"timestamp":1526522305703,"timeofday":"2020-05-16 06:58:25.703 GMT-0700 PM","status":"OK","total":0,"data":[],"messages":["Successfully created volume: 'test-volume'"]}
Create the volume "test-volume" mounted at "/test/test-volume" with EC scheme "6+2+2"
/opt/mapr/bin/maprcli volume create -name test-volume -path /test/test-volume -type rw -ecscheme "6+2+2" -json
{
"timestamp":1526522204072,
"timeofday":"2018-05-16 06:56:44.072 GMT-0700 PM",
"status":"OK",
"total":0,
"data":[
],
"messages":[
"Successfully created volume: 'test-volume'"
]
}
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=test-volume&path=/test/test-volume&type=rw&ecscheme=6+2+2' --user <username>:<password>
{"timestamp":1526522305703,"timeofday":"2018-05-16 06:58:25.703 GMT-0700 PM","status":"OK","total":0,"data":[],"messages":["Successfully created volume: 'test-volume'"]}
Create Volume with a Quota and an Advisory Quota
This example creates a volume with the following parameters:
- advisoryquota: 100M
- name: volumename
- path: /volumepath
- quota: 500M
- replication: 3
- schedule: 2
- topology: /East Coast
- type: rw
/opt/mapr/bin/maprcli volume create -name volumename -path /volumepath -advisoryquota 100M -quota 500M -replication 3 -schedule 2 -topology "/East Coast" -type rw -json
{
"timestamp":1526522474660,
"timeofday":"2018-05-16 07:01:14.660 GMT-0700 PM",
"status":"OK",
"total":0,
"data":[
],
"messages":[
"Successfully created volume: 'volumename'"
]
}
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=volumename&path=/volumepath&advisoryquota=100M"a=500M&replication=3&schedule=2&type=rw' --user <username>:<password>
{"timestamp":1526522622494,"timeofday":"2018-05-16 07:03:42.494 GMT-0700 PM","status":"OK","total":0,"data":[],"messages":["Successfully created volume: 'volumename'"]}
Create the mirror volume "test-volume.mirror" from source volume "test-volume" and mount at "/test/test-volume-mirror"
/opt/mapr/bin/maprcli volume create -name test-volume.mirror -source test-volume@ksTest -path /test/test-volume-mirror -type mirror -json
{
"timestamp":1526524458615,
"timeofday":"2018-05-16 07:34:18.615 GMT-0700 PM",
"status":"OK",
"total":0,
"data":[
],
"messages":[
"Successfully created volume: 'test-volume.mirror'"
]
}
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=test-volume.mirror&path=/test/test-volume-mirror&type=mirror&source=test-volume@ksTest' --user <username>:<password>
{"timestamp":1526524637534,"timeofday":"2018-05-16 07:37:17.534 GMT-0700 PM","status":"OK","total":0,"data":[],"messages":["Successfully created volume: 'test-volume.mirror'"]}
Create volumes that inherit from a parent volume
When creating and mounting a volume, the location of the mount path is specified by the
path parameter. Volumes can be mounted via the web console, the maprcli
commands, or the REST commands. The maprcli
commands include
volume create -path
command and the maprcli volume mount
-path
command if the volume was previously created. Sub-volumes (children)
can inherit properties from their parent volume.
In the following example, a parent volume and two (2) child volumes are create where the
child volume inherit properties from the parent. When the inherit
flag
is explicitly used, the allowgrant
parameter for the parent volume is
not required.
- For child volumes, c1 and c2, inheritance is explicit because the
inherit
option is specified. Thus, p1.c1 and p1.c2 volumes will inherit all properties from volume p1 (note that p1 is not a parent of p1.c1) regardless of whether theallowgrant
option is set on p1 or not. In this case, there is an explicit inheritance ant theallowgrant
flag is ignored and volume properties are inherited. - For the child volume, c3, inheritance is implicit. Meaning, the child volume, p1.c3,
inherits all properties from the parent volume, p1, only if the
allowgrant
option is set on p1.
/opt/mapr/bin/maprcli volume create -name p1 -path /p1
/opt/mapr/bin/maprcli volume create -name p1.c1 -inherit p1
/opt/mapr/bin/maprcli volume create -name p1.c2 -path /p1/c2 -inherit p1
/opt/mapr/bin/maprcli volume create -name p1.c3 -path /p1/c3
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=p1&path=%2Fp1' --user <username>:<password>
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=p1.c1&inherit=p1' --user <username>:<password>
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=p1.c2&path=%2Fp1%2Fc2&inherit=p1' --user <username>:<password>
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=p1.c3&path=%2Fp1%2Fc3' --user <username>:<password>
In the following example, the p1.child volume normally inherits from the p1 parent
volume properties because p1.child is mounted under p1 and allowgrant
option is set to true
on the parent volume. However, if the child
volume doesn't want to inherit properties, then set the allowinherit
option to false
(default: true
).
/opt/mapr/bin/maprcli volume create -name p1 -path /p1 -allowgrant true
/opt/mapr/bin/maprcli volume create -name p1.child -path /p1/p1.child -allowinherit false
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=p1&path=%2Fp1&allowgrant=true' --user <username>:<password>
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=p1.child&path=%2Fp1%2Fp1.child&allowinherit=false' --user <username>:<password>
Create a volume with namespace container replicas
/opt/mapr/bin/maprcli volume create -name testVol -nsminreplication 2 -nsreplication 3 -json
{
"timestamp":1526525132522,
"timeofday":"2018-05-16 07:45:32.522 GMT-0700 PM",
"status":"OK",
"total":0,
"data":[
],
"messages":[
"Successfully created volume: 'testVol'"
]
}
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=testVol&path=/testVol&nsminreplication=2&nsreplication=3' --user <username>:<password>
{"timestamp":1526525257461,"timeofday":"2018-05-16 07:47:37.461 GMT-0700 PM","status":"OK","total":0,"data":[],"messages":["Successfully created volume: 'testVol'"]}
Create a volume and set ACEs
/opt/mapr/bin/maprcli volume create -name testVol -readAce p -writeAce 'g:group1&!u:user1' -json
{
"timestamp":1526525429326,
"timeofday":"2018-05-16 07:50:29.326 GMT-0700 PM",
"status":"OK",
"total":0,
"data":[
],
"messages":[
"Successfully created volume: 'testVol'"
]
}
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=testVol&readAce=p&writeAce=g%3Agroup1%26%21u%3Auser1' --user <username>:<password>
{"timestamp":1526525572035,"timeofday":"2018-05-16 07:52:52.035 GMT-0700 PM","status":"OK","total":0,"data":[],"messages":["Successfully created volume: 'testVol'"]}
Create a volume with auditing disabled for specific operations
/opt/mapr/bin/maprcli volume create -name test-volume -auditenabled true -dataauditops --lookup,-read,-write -json
{
"timestamp":1526525720308,
"timeofday":"2018-05-16 07:55:20.308 GMT-0700 PM",
"status":"OK",
"total":0,
"data":[
],
"messages":[
"Successfully created volume: 'test-volume'"
]
}
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=test-volume&path=/test/test-volume&auditenabled=true&dataauditops=%2D%2Dlookup%2C%2Dread%2C%2Dwrite' --user <username>:<password>
{"timestamp":1526525795017,"timeofday":"2018-05-16 07:56:35.017 GMT-0700 PM","status":"OK","total":0,"data":[],"messages":["Successfully created volume: 'test-volume'"]}
Create a volume and grant user permissions on the volume:
/opt/mapr/bin/maprcli volume create -name testVol1 -path /testVol1 -user user1:dump user2:fc -json
{
"timestamp":1521162402826,
"timeofday":"2018-03-15 06:06:42.826 GMT-0700 PM",
"status":"OK",
"total":0,
"data":[
],
"messages":[
"Successfully created volume: 'testVol1'"
]
}
curl -X POST 'https://10.10.82.24:8443/rest/volume/create?name=testVol&path=/testVol&user=user1%3Adump%20user2%3Afc' --user <username>:<password>
{"timestamp":1526526072608,"timeofday":"2018-05-16 08:01:12.608 GMT-0700 PM","status":"OK","total":0,"data":[],"messages":["Successfully created volume: 'testVol'"]}
/opt/mapr/bin/maprcli volume create -name testVol -path /testVol2 -user user1:dump,restore user2:a,fc -json
{
"timestamp":1521162467485,
"timeofday":"2018-03-15 06:07:47.485 GMT-0700 PM",
"status":"OK",
"total":0,
"data":[
],
"messages":[
"Successfully created volume: 'testVol2'"
]
}
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=testVol2&path=/testVol2&user=user1%3Adump%2Crestore%20user2%3Aa%2Cfc' --user <username>:<password>
{"timestamp":1526526256845,"timeofday":"2018-05-16 08:04:16.845 GMT-0700 PM","status":"OK","total":0,"data":[],"messages":["Successfully created volume: 'testVol2'"]}
Create a volume for a tenant
name
: volumenamepath
: /volumepathadvisoryquota
: 500MBquota
: 1GBreplication
: 3
/opt/mapr/bin/maprcli volume create -name tenantVol -cluster ksTest -path /egTenant -tenantuser egTenant -advisoryquota 500M -quota 1G -replication 3 -json
{
"timestamp":1526526462865,
"timeofday":"2018-05-16 08:07:42.865 GMT-0700 PM",
"status":"OK",
"total":0,
"data":[
],
"messages":[
"Successfully created volume: 'tenantVol'"
]
}
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=tenantVol&cluster=ksTest&path=/egTenant&advisoryquota=500M"a=1G&replication=3' --user <username>:<password>
{"timestamp":1526526615167,"timeofday":"2018-05-16 08:10:15.167 GMT-0700 PM","status":"OK","total":0,"data":[],"messages":["Successfully created volume: 'tenantVol'"]}
Create a volume with on-wire encryption enabled for all files and tables in the volume:
/opt/mapr/bin/maprcli volume create -name test-Volume -path /testvolume -type rw -wiresecurityenabled true -json
{
"timestamp":1526526686905,
"timeofday":"2018-05-16 08:11:26.905 GMT-0700 PM",
"status":"OK",
"total":0,
"data":[
],
"messages":[
"Successfully created volume: 'test-Volume'"
]
}
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=test-volume&path=/testVolume&type=rw&wiresecurityenabled=true' --user <username>:<password>
{"timestamp":1526526748723,"timeofday":"2018-05-16 08:12:28.723 GMT-0700 PM","status":"OK","total":0,"data":[],"messages":["Successfully created volume: 'test-volume'"]}
Create a sub-volume and do not inherit schedules from the parent volume:
/opt/mapr/bin/maprcli volume create -name p1.c2 -path /p1/p1.c2 -skipinherit schedule -json
{
"timestamp":1505196021575,
"timeofday":"2017-09-11 11:00:21.575 GMT-0700",
"status":"OK",
"total":0,
"data":[
],
"messages":[
"Successfully created volume: 'p1.c2'"
]
}
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=p1.c2&path=/p1/p1.c2&skipinherit=schedule' --user <username>:<password>
{"timestamp":1526526980643,"timeofday":"2018-05-16 08:16:20.643 GMT-0700 PM","status":"OK","total":0,"data":[],"messages":["Successfully created volume: 'p1.c2'"]}
Create a mirror volume and do not inherit the schedule(s) from the source volume:
/opt/mapr/bin/maprcli volume create -name p1.m2 -path /p1/p1.m2 -type mirror -source p1@ksTest -skipinherit schedule -json
{
"timestamp":1505196450141,
"timeofday":"2017-09-11 11:07:30.141 GMT-0700",
"status":"OK",
"total":0,
"data":[
],
"messages":[
"Successfully created volume: 'p1.m2'"
]
}
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=p1.m2&path=/p1/p1.m2&type=mirror&source=p1@ksTest&skipinherit=schedule' --user <username>:<password>
{"timestamp":1526527151925,"timeofday":"2018-05-16 08:19:11.925 GMT-0700 PM","status":"OK","total":0,"data":[],"messages":["Successfully created volume: 'p1.m2'"]}
Create a volume and enable tiering, but do not specify the tier type and do not associate an offload rule or schedule:
/opt/mapr/bin/maprcli volume create -name sampleVol -path /sampleVol -tieringenable true -json
{
"timestamp":1519922099117,
"timeofday":"2018-03-01 08:34:59.117 GMT-0800 AM",
"status":"OK",
"total":0,
"data":[
],
"messages":[
"Successfully created volume: 'sampleVol'"
]
}
curl -X POST 'https://10.10.82.24:8443/rest/volume/create?name=sampleVol&path=/sampleVol&tieringenable=true' --user <username>:<password>
{"timestamp":1519922181381,"timeofday":"2018-03-01 08:36:21.381 GMT-0800 AM","status":"OK","total":0,"data":[],"messages":["Successfully created volume: 'sampleVol'"]}
Create a volume, enable cold tiering, associate a rule and schedule for offloading data, and set the number of days to keep recalled data:
/opt/mapr/bin/maprcli volume create -name sampleVol -path /sampleVol -tieringenable true -tiername ksTestCold -tieringrule rule1 -offloadschedule 2 -recallexpirytime 2 -json
{
"timestamp":1519922642632,
"timeofday":"2018-03-01 08:44:02.632 GMT-0800 AM",
"status":"OK",
"total":0,
"data":[
],
"messages":[
"Successfully created volume: 'sampleVol'"
]
}
curl -X POST 'https://10.10.82.24:8443/rest/volume/create?name=sampleVol&path=/sampleVol&tieringenable=true&tiername=ksTestCold&tieringrule=rule1&offloadschedule=2&recallexpirytime=2' --user <username>:<password>
{"timestamp":1519922784818,"timeofday":"2018-03-01 08:46:24.818 GMT-0800 AM","status":"OK","total":0,"data":[],"messages":["Successfully created volume: 'sampleVol'"]}
Create a volume, enable warm tiering, associate a rule and schedule for offloading data, and set the number of days to keep recalled data:
/opt/mapr/bin/maprcli volume create -name sampleVol -path /sampleVol -tieringenable true -tiername ksTestEC -tieringrule testRule -ecscheme 6+3 -ectopology /ecdata -offloadschedule 2 -recallexpirytime 2 -json
{
"timestamp":1516336193635,
"timeofday":"2018-01-19 04:29:53.635 GMT+0000",
"status":"OK",
"total":0,
"data":[
],
"messages":[
"Successfully created volume: 'sampleVol'"
]
}
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=sampleVol&path=/sampleVol&tieringenable=true&tiername=testWarm&tieringrule=testRule&ecscheme=6%2B3&ectopology=/ecdata&offloadschedule=2&recallexpirytime=2' --user <username>:<password>
{"timestamp":1526521538688,"timeofday":"2018-05-16 06:45:38.688 GMT-0700 PM","status":"OK","total":0,"data":[],"messages":["Successfully created volume: 'sampleVol'"]}
/opt/mapr/bin/maprcli volume create -name sampleVol3 -path /sampleVol3 -ecenable true -json
{
"timestamp":1527690187540,
"timeofday":"2018-05-30 07:23:07.540 GMT-0700 AM",
"status":"OK",
"total":0,
"data":[
],
"messages":[
"Successfully created volume: 'sampleVol3'"
]
}
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=sampleVol3&path=/sampleVol3&ecenable=true' --user <username>:<password>
{"timestamp":1527690187540,"timeofday":"2018-05-30 07:23:07.540 GMT-0700 AM","status":"OK","total":0,"data":[],"messages":["Successfully created volume: 'sampleVol3'"]}
Create a volume with a security policy:
/opt/mapr/bin/maprcli volume create -name volTest1 -securitypolicy LabTest -enforcementmode PolicyAceOnly
/opt/mapr/bin/maprcli volume info -name volTest1 -columns enforcementMode,securityPolicyTags -json
{
"timestamp":1536160885967,
"timeofday":"2018-09-05 08:21:25.967 GMT-0700 AM",
"status":"OK",
"total":1,
"data":[
{
"securityPolicyTags":"[LabTest]",
"enforcementMode":"PolicyAceOnly"
}
]
}
curl -X POST 'https://abc.sj.us:8443/rest/volume/create?name=volTest1&securitypolicy=LabTest&enforcementmode=PolicyAceOnly' --user <username>:<password>
curl -X POST 'https://abc.sj.us:8443/rest/volume/info?name=volTest1&columns=enforcementmode;PolicyAceOnly' --user <username>:<password>