mkdir
Creates new directory or directories.
Creates new directory or directories.
Synopsis
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 ...]
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. |
Definition
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_name
- New directory on DSEFS file system.
- Explicit file system prefixes
dsefs:
andfile:
are supported.
- Explicit file system prefixes
- --force-sync
- 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
- --no-force-sync
- 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.
Examples
Make new directory with 32-MB block sizes, redundancy factor or 2, files synchronize on close
dsefs dsefs://127.0.0.1:5598/ > mkdir -b 32000000 -n 2 --force-sync file:new_directory