Using the DataStax Installer to install (root permissions not required)
Instructions for installing or upgrading DataStax Enterprise 5.1 on any Linux-based platform using the DataStax Installer when you do not have root permissions or want to install in a custom directory.
Instructions for installing or upgrading DataStax Enterprise 5.1 on any Linux-based platform using the DataStax Installer when you do not have root permissions or want to install in a custom directory. If you have root permissions, use Using the DataStax Installer to install (root permissions required).
cassandra
user in the database and runs as this user. It also
creates a cassandra
user in the operating system. Do not use the
cassandra
user in production. Using the
cassandra
user is a security risk. See Adding a superuser login.Prerequisites
- A supported platform.
- Configure your operating system to use the latest version of Java
8:
- Recommended. The latest build of a TCK (Technology Compatibility Kit) Certified OpenJDK version 8. For example, OpenJDK 8 (1.8.0_151 minimum). DataStax's recommendation changed due to the end of public updates for Oracle JRE/JDK 8. See Oracle Java SE Support Roadmap.
- Supported. Oracle Java SE 8 (JRE or JDK) (1.8.0_151 minimum)
- Python 2.7.x (For older RHEL distributions, see Installing Python 2.7 on older RHEL-based package installations.)
Hardware requirements
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.
- Manually after installation.
- To specify pre-configured cassandra.yaml and dse.yaml files, use the unattended install with either command line or property file.
Procedure
In a terminal window:
-
Download the installer for your computer from the DataStax download page or use
the following command:
curl -O https://downloads.datastax.com/enterprise/DataStaxEnterprise-5.1.20-linux-x64-installer.run
Note: 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, change the permission
to executable:
chmod +x DataStaxEnterprise-5.1.20-linux-x64-installer.run
-
To view the installer help:
./DataStaxEnterprise-5.1.20-linux-x64-installer.run --help
Help displays a list of the available options and their default settings.
-
Start the installation:
- No configuration
parameters:
./DataStaxEnterprise-5.1.20-linux-x64-installer.run
./DataStaxEnterprise-5.1.20-linux-x64-installer.run --mode text
- Configuration
parameters:
./DataStaxEnterprise-5.1.20-linux-x64-installer.run --enable_vnodes 0 ## Command line option.
./DataStaxEnterprise-5.1.20-linux-x64-installer.run --optionfile ../datastax/DC4-analytics.prop ## Property file option.
For configuration parameter information, see the installer options described in Using the DataStax Installer to install using command line or properties file commands.
The installer launches.
- No configuration
parameters:
-
After accepting the License Agreement, select the type of install. In
Service Setup, select No
Services.
- Services and Utilities: Sets up DataStax Enterprise as a service. It installs DataStax Enterprise in system locations.
- No Services: Sets up DataStax Enterprise as a standalone process. It does not require root or sudo access.
-
Select the Install Type:
- 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: -
Set up the node type:
Table 2. 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. -
If an installation of DataStax Enterprise already exists, the installer
displays upgrade information and installs DSE in the following locations:
- Installer-Services installations: /usr/share/dse
- No Services installations: Previous installation location
Important: Before upgrading an existing cluster, see the DataStax Upgrade Guide.The important files to review for upgrade are dse.yaml, cassandra.yaml, and for service installs /etc/default/dse.
If dse.in.sh or cassandra.in.sh have been modified, make modifications to the cassandra-env.sh or the dse-env.sh instead. Changing these files is not recommended.
-
Set the ring options:
Table 3. 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 - Transactional nodes:
-
Set up the miscellaneous options:
Table 4. Misc Options Update Operating System Update some system packages and dependencies. Does not upgrade or install major components such as Java. 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.
- Optional:
Set up the Preflight Check (Advanced Installations only):
Table 5. Preflight Check Options Run Preflight Check A collection of tests that can detect and fix a node's configuration. The tool can detect and fix many invalid or suboptimal configuration settings. It is not available in No Services installations. Attempt to Fix Issues Enable DataStax Enterprise to attempt to fix invalid or suboptimal configuration settings. SSD Drives Enter the paths to the Solid State Drives. Separate the drives by a comma. Drives Enter the paths to the hard drives. Separate the drives by a comma. Time to run Disk Benchmarks Set to simulate a normal load. Threads per Disk Benchmark Set to simulate a normal load. -
Change the default directory locations (Advanced Installations only):
Table 6. Directory Locations 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-No Services and tarball installations. -
Change the default ports (Advanced Installations only):
Table 7. 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.
DataStax Enterprise is ready for additional configuration.
- Optional:
Single-node cluster installations only:
What's next
- You must change or delete the
cassandra
user created on installation. See Creating superuser accounts. - Configure startup options: service | stand-alone.
- If performing an upgrade, go to the next step in the Upgrade Guide.
- Configuring DataStax Enterprise - Settings for DSE Advanced Security, In-Memory, DSE Advanced Replication, DSE Multi-Instance, DSE Tiered Storage, and more.
- Configuration and log file locations - Services and package installations.
- Configuration and log file locations - No Services and tarball installations.
- Changing logging locations after installation.
- Starting and stopping DataStax Enterprise.
- Preparing DataStax Enterprise for production.
- Recommended production settings.
- Planning and testing DSE and Apache Cassandra cluster deployments.
- Configuring the heap dump directory to avoid server crashes.
- DataStax Studio documentation.