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.

1. 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.
2. From the directory where you downloaded the install file, change the permission to executable:

   chmod +x DataStaxEnterprise-5.1.20-linux-x64-installer.run

3. 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.

4. 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.

   
5. 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.
6. Select the Install Type:
   • Simple: Installs DataStax Enterprise using the default path names and options:
   • Advanced: Allows you to configure path names and options:
     • User Setup
     • Ring Options
     • Directory Locations
     • Ports
7. Set the installation directory.
8. 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: Internode communications (gossip) Initializing a single datacenter per workload type Initializing multiple datacenters per workload type
   Install developer related tools	Includes the following: Javadocs DataStax Enterprise demos DataStax Studio DSE Graph Loader

9. 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.

10. 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.

11. 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

12. 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.

13. 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.

14. 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.

15. 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

16. In System Configuration, review any warnings about potential issues.
17. 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.

18. Optional: Single-node cluster installations only:
    1. Start DataStax Enterprise from the installation directory:

       bin/dse cassandra

       where the installation directory is either:

       • /usr/share/dse
       • the directory where you installed DataStax Enterprise.

       Note: For other start options, see Starting DataStax Enterprise as a stand-alone process.
    2. 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