Using the DataStax Installer to install (root permissions required)

Instructions for installing DataStax Enterprise 5.0 using the DataStax Installer when you have root permissions. You can install or upgrade on any Linux-based platform using this installer.

Instructions for installing DataStax Enterprise using the DataStax Installer when you have root permissions. You can install or upgrade on any Linux-based platform using this installer. If you don't have root permissions, use Using the DataStax Installer to install (root permissions not required). To install earlier versions, see Installing DataStax Enterprise 5.0.x patch releases.

Important: DataStax Enterprise 5.0 uses Apache Cassandra 3.0 and CQL 3.3.

Prerequisites

Also see Recommended production settings and the DataStax Enterprise Reference Architecture white paper.

Hardware requirements
Requirement Minimum Production
CPUs 2 16
Memory 8 GB 24 GB
Data directory 20 GB 200 GB
Commit log directory 20 GB 200 GB
Saved caches directory 20 GB 200 GB
Logs directory 20 GB 200 GB
Production requirements depend on the volume of data and workload.

About the installer

The DataStax installer installs DataStax Enterprise. It does not install OpsCenter or DevCenter. 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:

Procedure

Note: The latest version of DataStax Enterprise is 5.0.11.

In a terminal window:

  1. Download the installer for your computer from the DataStax download page or use the following command:
    $ curl --user dsa_email_address:password -O https://downloads.datastax.com/enterprise/DataStaxEnterprise-5.0.11-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.
  2. From the directory where you downloaded the install file, change the permission to executable:
    $ chmod +x DataStaxEnterprise-5.0.11-linux-x64-installer.run
  3. To view the installer help:
    $ ./DataStaxEnterprise-5.0.11-linux-x64-installer.run --help

    Help displays a list of the available options and their default settings.

  4. Start the installation:
    • No configuration parameters:
      $ sudo ./DataStaxEnterprise-5.0.11-linux-x64-installer.run
      $ sudo ./DataStaxEnterprise-5.0.11-linux-x64-installer.run --mode text
    • Configuration parameters:
      $ sudo ./DataStaxEnterprise-5.0.11-linux-x64-installer.run --prefix /usr/share/dse --enable_vnodes 0 ## Command line option.
      $ sudo ./DataStaxEnterprise-5.0.11-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.

  5. After accepting the License Agreement, select Services and Utilities:
  6. Set up the node:
    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.

    Developer Related Tools Includes the following:
  7. If an installation of DataStax Enterprise already exists, the installer displays upgrade information and installs DataStax Enterprise in the following locations:
    • Installer-Services installations: /usr/share/dse
    • No Services installations: previous installation location
    Important: Before upgrading an existing cluster, see the 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.

  8. Set up the node type:
    DSE Setup
    DSE Analytics Spark or Spark + Integrated Hadoop (DSE Hadoop).
    DSE Search DSE Search (Solr) simplifies using search applications for data that is stored in a Cassandra database.
    DSE Graph DSE Graph is a graph database for managing, analyzing, and searching highly-connected data.
    DSE Advanced Replication DSE Advanced Replication supports one-way, distributed-data replication from remote clusters that might experience periods of network or internet downtime.
  9. Set up remaining options:

    The available options depend on the type of installation, permissions, and your previous selections.

    Misc Setup
    Update Operating System Update some system packages and dependencies. Does not upgrade or install major components such as Java.
    Start services Select Yes to start all services when the installation is complete, or select No when additional configuration is needed after installation.
    Type of analytics Spark only and Spark + Integrated Hadoop (DSE Hadoop).
    OpsCenter Address Launches OpsCenter in your default browser.
    Run PFC Enable or disable the Preflight check.
  10. Optional: Set up the Preflight Check:

    The Preflight tool is 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 tarball or No Services installations.

    Preflight Check Options. These options appear when Run PFC is selected.
    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.
  11. Change the default user and user group (Advanced Installations only):
    User Setup
    OS User ID for Service Default: cassandra. Because the DataStax Agent relies on user cassandra, DataStax does not recommend changing the default. If changed, you must manually install, update, and configure the DataStax Agent.
    OS User Group for Service Default: cassandra. See above.
  12. Change default cluster settings (Advanced Installations only):
    Ring Options
    Enable Virtual node (vnodes) Enable or disable Virtual nodes.
    Number of tokens Token recommendations for vnodes:
    • Cassandra (transactional) nodes: 128
    • Analytical nodes (Spark): 128
    • Analytical nodes (DSE Hadoop, BYOH): not recommended.
    • Search nodes: 16 or 32
    • DSE Graph: 128 or when used with DSE Search: 16 or 32
    Listen Address cassandra.yaml parameter: listen_address
    RPC Address cassandra.yaml parameter: rpc_address
  13. Change the default directory locations (Advanced Installations only):
    Directory Locations
    Commitlog Directory cassandra.yaml parameter: commitlog_directory
    Saved Caches Directory cassandra.yaml parameter: saved_caches_directory
    Hints Directory cassandra.yaml parameter: hints_directory
    Logs Directory Log data for Cassandra, Spark, Hadoop, Pig, Hive, and Tomcat. See the default file locations for Installer-Services and package installations or Installer-No Services and tarball installations.
  14. Change the default ports (Advanced Installations only):
    Ports
    Storage Port cassandra.yaml parameter: storage_port
    SSL Storage Port cassandra.yaml parameter: ssl_storage_port
    RPC Port cassandra.yaml parameter: rpc_port
  15. In System Configuration, review any warnings about potential issues.
  16. After the installation completes, review the installation logs to verify the installation.
    Note: If you have closed the logs, see Services or No-Services installer locations.

    DataStax Enterprise is ready for additional configuration.

  17. Optional: Single-node cluster installations only:
    1. If DataStax Enterprise is not already running:
      $ sudo service dse start
      Note: For other start options, see Starting DataStax Enterprise as a service.
    2. Verify that DataStax Enterprise is running:
      Using vnodes:
      $ nodetool status
      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
      Not using vnodes:
      $ nodetool status
      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

What's next

The location of the cassandra.yaml file depends on the type of installation:
Installer-Services /etc/dse/cassandra/cassandra.yaml
Package installations /etc/dse/cassandra/cassandra.yaml
Installer-No Services install_location/resources/cassandra/conf/cassandra.yaml
Tarball installations install_location/resources/cassandra/conf/cassandra.yaml
The location of the dse.yaml file depends on the type of installation:
Installer-Services /etc/dse/dse.yaml
Package installations /etc/dse/dse.yaml
Installer-No Services install_location/resources/dse/conf/dse.yaml
Tarball installations install_location/resources/dse/conf/dse.yaml