Using the DataStax Installer to install on Mac OS X
Use these instructions for installing DataStax Enterprise 5.1 using the DataStax Installer on Mac OS X.
Prerequisites
-
Mac OS X is supported for development only.
-
Latest version of Oracle Java 8 is recommended.
-
On some versions of Mac OS X, you may need to install readline:
easy_install readline
.
About DataStax installer
The DataStax installer installs DataStax Enterprise and DataStax Agent. It does not install OpsCenter. If you select Developer Related Tools during installation, DataStax Studio is installed.
The installer sets some but not all cassandra.yaml
parameters.
It does not set dse.yaml
properties.
Set the remaining parameters in the following ways:
-
Manually after installation.
-
To specify pre-configured
cassandra.yaml
anddse.yaml
files, use the unattended install with either command line or property file.
Procedure
End User License Agreement (EULA). By downloading this DataStax product, you agree to the terms of the EULA. |
In a terminal window:
-
Download the
.dmg
file for DataStax Enterprise from the DataStax download page or use the following command:$ curl -O https://downloads.datastax.com/enterprise/DataStaxEnterprise-5.1-osx-installer.dmg
To install earlier versions, replace the version number in the above command. To view the available versions, see the Release notes.
-
From the directory where you downloaded the install file, click the
DataStaxEnterprise-5.1-osx-installer.dmg
file. -
Double-click the DataStax Enterprise installer.
Figure 1. DataStax Enterprise 5.1 installer iconThe installer launches.
Figure 2. DataStax Enterprise Setup window -
After accepting the License Agreement, select the type of installation:
Service Setup
-
No Services: This installation sets up the server as a standalone process.
-
Services and Utilities: This installation sets up the server as a service. It sets up a property (
.plist
) file to start the service on login.-
Simple: Installs DataStax Enterprise using the default path names and options:
-
Advanced: Allows you to configure path names and options:
-
-
-
Set the installation directory.
-
Set up the node:
Table 1. Node setup Default Interface
Network interface for the DataStax Enterprise server.Single node clusters: use 127.0.0.0.
Cluster Name
Name of the cluster. You must use the same cluster name for each node in the cluster.
Seeds
All nodes use the seed node list for finding each other and learning the topology of the ring. Single node clusters: Set to empty.
Multiple node clusters: List of seed nodes. (Do not make all nodes seed nodes.)
Additional information:
Install developer related tools
Includes the following:
-
Javadocs
-
DataStax Enterprise demos
-
-
If an installation of DataStax Enterprise already exists, the installer displays upgrade information and installs DSE in the previous installation location
Before upgrading an existing cluster, see the DataStax Upgrade Guide.
The important files to review for upgrade are
dse.yaml
,cassandra.yaml
, and for serviceinstalls/etc/default/dse
.If
dse.in.sh
orcassandra.in.sh
have been modified, make modifications to thecassandra-env.sh
or thedse-env.sh
instead. Changing these files is not recommended. -
Set the ring options:
Table 2. Ring options Enable Virtual Nodes (vnodes)
Enable or disable Virtual nodes.
Number of tokens
Token recommendations for vnodes:
-
Transactional nodes:
128
-
Analytical nodes (Spark):
128
-
Search nodes:
8
-
DSE Graph:
128
.
When used with DSE Search:
8
Listen Address
cassandra.yaml
:listen_address
RPC Address
cassandra.yaml
:rpc_address
-
-
Set up the node type:
Table 3. DSE setup DSE Analytics
DSE Analytics includes integration with Apache Spark™.
DSE Search
DSE Search includes integration with Apache Solr™.
DSE Graph
DSE Graph is a graph database for managing, analyzing, and searching highly-connected data.
DSE Advanced Replication
DSE Advanced Replication supports configurable distributed data replication from source clusters to destination clusters bi-directionally that can experience sporadic connectivity.
-
Set up the miscellaneous options:
Table 4. Misc options Start services
-
Yes starts all services when the installation is complete.
-
No, select when additional configuration is needed after installation.
OpsCenter Address
Optional. The server name or IP address for OpsCenter
If performing a Simple installation, go to 16.
-
-
The following steps are displayed when Advanced is selected in 4.
-
Change the default directory locations (Advanced Installations only):
Table 5. Directory locations Data Directory
cassandra.yaml
data_file_directories
Commitlog Directory
cassandra.yaml
:commitlog_directory
Saved Caches Directory
cassandra.yaml
:saved_caches_directory
Hints Directory
cassandra.yaml
:hints_directory
Logs Directory
Log data for the database, Spark, and Tomcat. See the default file locations for Installer-Services and package installations or Installer-No Services and tarball installations.
-
Change the default ports (Advanced Installations only):
Table 6. Ports Storage Port
cassandra.yaml
:storage_port
SSL Storage Port
cassandra.yaml
:ssl_storage_port
RPC Port
cassandra.yaml
:rpc_port
-
In System Configuration, review any warnings about potential issues.
-
After the installation completes, review the installation logs to verify the installation.
If you have closed the logs, see Services or No-Services installer locations.
DataStax Enterprise is ready for additional configuration.
-
Optional: Single-node cluster installations only:
-
If DataStax Enterprise is not running, start it from the installation directory:
$ bin/dse cassandra
where the installation directory is either:
-
/usr/share/dse
-
the directory where you installed DataStax Enterprise.
-
-
For other start options, see Starting DataStax Enterprise as a stand-alone process.
-
Verify that DataStax Enterprise is running from the installation directory:
$ bin/nodetool status
Results using vnodes:
Datacenter: Cassandra ===================== Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns Host ID Rack UN 127.0.0.1 82.43 KB 128 ? 40725dc8-7843-43ae-9c98-7c532b1f517e rack1
Results not using vnodes:
Datacenter: Analytics ===================== Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Owns Host ID Token Rack UN 172.16.222.136 103.24 KB ? 3c1d0657-0990-4f78-a3c0-3e0c37fc3a06 1647352612226902707 rack1
Next steps
-
Configuration and log file locations - Services and package installations.
-
Configuration and log file locations - No Services and tarball installations.
-
documentation