Creates new directory or directories.

Creates new directory or directories.


mkdir [-p] [-b size_in_bytes] [-n num_nodes] 
[-c encoder_name] [-m permission_mode]
[--no-force-sync] [--force-sync] 
new_directory_name [new_directory_name ...]
Table 1. Legend
Syntax conventions Description
UPPERCASE Literal keyword.
Lowercase Not literal.
Italics Variable value. Replace with a valid option or user-defined value.
[ ] Optional. Square brackets ( [ ] ) surround optional command arguments. Do not type the square brackets.
( ) Group. Parentheses ( ( ) ) identify a group to choose from. Do not type the parentheses.
| Or. A vertical bar ( | ) separates alternative elements. Type any one of the elements. Do not type the vertical bar.
... Repeatable. An ellipsis ( ... ) indicates that you can repeat the syntax element as often as required.
'Literal string' Single quotation ( ' ) marks must surround literal strings in CQL statements. Use single quotation marks to preserve upper case.
{ key:value } Map collection. Braces ( { } ) enclose map collections or key value pairs. A colon separates the key and the value.
<datatype1,datatype2> Set, list, map, or tuple. Angle brackets ( < > ) enclose data types in a set, list, map, or tuple. Separate the data types with a comma.
cql_statement; End CQL statement. A semicolon ( ; ) terminates all CQL statements.
[ -- ] Separate the command line options from the command arguments with two hyphens ( -- ). This syntax is useful when arguments might be mistaken for command line options.
' <schema> ... </schema> ' Search CQL only: Single quotation marks ( ' ) surround an entire XML schema declaration.
@xml_entity='xml_entity_type' Search CQL only: Identify the entity and literal value to overwrite the XML element in the schema and solrconfig files.


The short form and long form parameters are comma-separated.

Command arguments

-b, --block-size size_in_bytes

Preferred block size in bytes for files in new directory.

Default is 64 MB.

-c, --compression-encoder encoder_name
The compression encoder name. DSE ships with the LZ4 compression encoder.
New directory on DSEFS file system.
  • Explicit file system prefixes dsefs: and file: are supported.
Synchronize files in this directory with the storage device when closed. Files created in the directory inherit the option.
-m, --permission-mode permission_mode
Octal representation of permission mode for owner, group, and others:
  • 0 – no permission
  • 1 – execute
  • 2 – write
  • 3 – write and execute
  • 4 – read
  • 5 – read and execute
  • 6 – read and write
  • 7 – read, write, and execute
Do not synchronize files in this directory with the storage device when closed. Files created in the directory inherit the option.
-n, --redundancy-factor num_nodes
Set the number of replicas of file data, similar to the replication factor in the database keyspaces, but more granular.
  • Set this to one number greater than the number of nodes that are allowed to fail before data loss occurs. For example, set this value to 3 to allow 2 nodes to fail.
  • For simple replication, use a value that is equivalent to the replication factor.
  • Default value is inherited from the parent directory if set, otherwise it is 3.
-p, --parents
If needed, makes parent directories. If parent directories exist, no error.


Make new directory with 32-MB block sizes, redundancy factor or 2, files synchronize on close

dsefs dsefs:// > mkdir -b 32000000 -n 2 --force-sync file:new_directory