dse add-node

For DSE Multi-Instance, this command simplifies adding and configuring a node on a host machine.

For DSE Multi-Instance, simplifies adding and configuring a node on a host machine. When optional parameters are absent, the default values remain unchanged.

Important: The user running the command must have permissions for writing to the directories that DSE uses, or use sudo.
Restriction: DSE Multi-Instance commands are supported only on package installations.

Synopsis

dse add-node -n nodeId
[--advrep-directory advrepdirectory
[--analytics]
[--cdc-directory=cdcdirectory]
[--cluster=clustername]
[--commit-directory=commitdirectory]
[--cpus=number_of_cpus]
[--dc=datacenter_placement] 
[--data-directory=datadirectory]
[--dsefs] [--dsefs-directory=dsefsdatadirectory]
[--graph]
[--hadoop-logs=hadooplogsdirectory]
[help]
[--hints-directory=hintsdirectory]
[--jmxport=jmx_port]
[--listen-address=listen_IP_address]
[--logs-directory=alllogsdirectory]
[--max-heap-size=heapsize]
[--native-transport-address=native_transport_IP_address
[--num-tokens=number_of_tokens]
[--pig-logs=piglogdirectory]
[--rack=rack_placement]
[--rpc-address=rpc_IP_address]
[--saved-caches-directory=savedcachesdirectory]
[--search]
[--seeds=IP_address1,IP_address2,...]
[--spark-local-directory=sparklocaldirectory]
[--spark-log-directory=sparklogdirectory]
[--spark-worker-cores=number_of_cores]
[--spark-worker-directory=sparkworkerdirectory]
[--spark-worker-memory=memory]
[--tomcat-logs=tomcatlogsdirectory]
[--unix-group=groupname]
[--unix-username=username]
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.
New node configuration options:
-n=nodeId, --node-id=nodeId
Required. For DSE Multi-Instance, the alphanumeric node name for the new node. The specified node name is automatically prepended with dse- so that the resulting node ID is dse-nodeId. For example, if you specify node1, the resulting node name is dse-node1.
--advrep-directory=advrepdirectory
Optional. The DSE Advanced Replication data directory.

Default: /var/lib/dse-nodeId/advrep

--analytics
Enable DSE Analytics.
--cdc-directory=cdcdirectory
Optional. The CDC raw data directory.

Default: /var/lib/dse-nodeId/cdc_raw

--cluster=clustername
Optional. The name of the DataStax Enterprise cluster that the new node belongs to. Only non-whitespace values are supported.
--cpus=number_of_cpus
Optional. The number of cores.
--commit-directory=commitdirectory
Optional. The commit log directory.

Default: /var/lib/dse-nodeId/commitlog

--dc=datacenter_placement
Optional. The data center placement.
--data-directory=datadirectory
Optional. The root directory for storing data.

Default: /var/lib/dse-nodeId/data

--dsefs
Optional. Enable DSEFS.
--dsefs-directory=dsefsdatadirectory
Optional. The DSEFS data directory.

Default: /var/lib/dse-nodeId/dsefs

--graph
Optional. Enable DSE Graph.
--hadoop-logs=hadooplogsdirectory
Optional. The log directory for Hadoop logs.

Default: logs-directory/hadoop

--help
Optional. Send dse add-node option descriptions to standard output.
--hints-directory=hintsdirectory
Optional. The hints directory.

Default: /var/lib/dse-nodeId/hints

--jmxport=jmx_port
Optional. The DSE JMX metrics monitoring port.
--listen-address=listen_IP_address
Optional. The IP address or hostname that DSE binds to when connecting to other nodes.
--logs-directory=alllogsdirectory
Optional. The root directory for all of the logs.

Default: /var/log/dse-nodeId

--max-heap-size=heapsize
Optional. The Java heap size. If you omit MB the size is interpreted as megabytes.
--num-tokens=number_of_tokens
Optional. The number of tokens.
--pig-logs=piglogdirectory
The log directory for Pig logs.

Default: logs-directory/pig

--rack=rack_placement
Optional. The rack placement.
--rpc-address=rpc_IP_address
Optional. The IP address or hostname that DSE binds to for RPC requests.
--saved-caches-directory=savedcachesdirectory
Optional. The saved caches directory.

Default: /var/lib/dse-nodeId/saved_caches

Optional. Enable DSE Search.
--seeds=IP_address1,IP_address2,...
Optional. A comma-separated list of IP addresses of the nodes to be used as seed nodes.
--spark-local-directory=sparklocaldirectory
Optional. The local directory for Spark Worker.

Default: /var/lib/dse-nodeId/spark/rdd

--spark-log-directory=sparklogdirectory
Optional. The log directory for Spark Worker.

Default: /var/log/dse-nodeId/spark/worker

--spark-worker-cores=number_of_cores
Optional. The maximum number of cores used by Spark executors.
--spark-worker-directory=sparkworkerdirectory
Optional. The data directory for Spark Worker.

Default: /var/lib/dse-nodeId/spark/worker

--spark-worker-memory=memory
Optional. The maximum amount of memory used by Spark executors. Specify unit of measure with k (kilobytes), m (megabytes), g (gigabytes).
--tomcat-logs=tomcatlogsdirectory
Optional. The log directory for tomcat logs.

Default: logs-directory/tomcat

--unix-group=groupname
Optional. The UNIX group that owns the node configuration.

Default: cassandra

--unix-username=username
Optional. The UNIX user that owns the node configuration.

Default: cassandra

Examples

Add node1

dse add-node node1
The dse-node1 is created on the local machine.

Add a node that will join the cluster payroll on startup

dse add-node payrollnode --cluster payroll --listen-address 192.168.0.0 
--rpc-address 192.168.0.1 --seeds 192.168.0.2

The payrollnode is created with the specified configuration options.