Installing DataStax Enterprise 4.8 on Linux without root permissions or on Mac OS X

Installing a cluster without root permissions on any Linux platform or Mac OS X using the DataStax Enterprise installer.

For other product installations, see Installing OpsCenter and Installing DevCenter.

Important: DataStax Enterprise 4.8 uses Cassandra 2.1 and CQL3.1.

Prerequisites

Linux installations

  • Be sure your platform is supported.
  • Latest version of Oracle Java SE Runtime Environment 7 or 8 or OpenJDK 7 is recommended.
    Note: If using Oracle Java 7, you must use at least 1.7.0_25. If using Oracle Java 8, you must use at least 1.8.0_40. In some cases, using JDK 1.8 causes minor performance degradation compared to JDK 1.7.
  • RedHat-compatible distributions require EPEL (Extra Packages for Enterprise Linux). For RHEL 5.x, see Installing EPEL on RHEL OS 5.x.
  • If installing on a 64-bit Oracle Linux distribution, first install the 32-bit versions of glibc libraries.
  • Python 2.6 (minimum); 2.7 (recommended).

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

Mac OS X installations

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

Installing under a user account (Linux only)

Without root or sudo access, the installer cannot set up support services because it does not have permission to create the services files. Root or sudo access allows the installer to set up support services on operating systems that support services, such as Debian-based or RHEL-based systems.

In GUI mode, if gksudo or pkexec, are not installed, the installer might not present a GUI sudo prompt. Subsequently the sudo prompt appears in the shell:

Procedure

In a terminal window:

Note: In the following commands, be sure to change X to an actual version number. To view the available versions, see the Release notes. The latest version of DataStax Enterprise 4.8 is 4.8.16.

  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-4.8.X-linux-x64-installer.run ##Linux only
    
    Note: For Mac OS X, get the installer from the DataStax download page.
  2. From the directory where you downloaded the install file:
    • Linux:
      1. From the directory where you downloaded the install file, change the permission to executable:
        chmod +x DataStaxEnterprise-4.8.X-linux-x64-installer.run ## Changes permission to executable
      2. To view the installer help:
        ./DataStaxEnterprise-4.8.X-linux-x64-installer.run --help
      3. Start the installation:
        $ ./DataStaxEnterprise-4.8.X-linux-x64-installer.run              ## Install in GUI mode. 
        $ ./DataStaxEnterprise-4.8.X-linux-x64-installer.run --mode text  ## Install in Text mode.
    • Mac OS X:
      1. Double-click the DataStaxEnterprise-4.8.X.dmg file.
      2. In the installer window, double-click the installer icon.

        Depending on your permissions, you may need to use Control-click.

    The installer launches.



  3. Follow the instructions in the setup wizard using the following table for guidance:
    Screen - Panel Recommendations and additional information
    Setup Welcome page.
    License Agreement DataStax Enterprise End User License Agreement
    Install Options
    Server Installation Directory Sets the location of the dse directory.
    Install Type

    Use Simple Install for default path names and options.

    Advanced Install allows you to configure additional parameters, including:
    Update System Updates some system packages and dependencies. Does not upgrade or install major components such as Java. Set to Yes when run as root user, otherwise set to No.
    Default Interface Network interface for the DataStax Enterprise server.

    Use 127.0.0.0 for single node clusters.

    Service Setup

    Linux: No ServicesNo Services - installs the DataStax Enterprise server as a stand-alone process.

    Mac:
    • Services onlyServices Only - installs the DataStax Enterprise server as a service running in the background.
    • No ServicesNo Services - installs the DataStax Enterprise server as a stand-alone process.
    Start Services After Install

    Linux: No - A non-root install doesn't use services.

    Mac: Select Yes to start all services when the installation is complete, or select No when additional configuration is needed after installation.

    Node Setup
    Node Type
    Attention: All nodes are DataStax Enterprise nodes and run the Cassandra database.
    The following types of nodes are available:
    • Cassandra node - Transactional node, also used for Bring your own Hadoop (BYOH) nodes.
    • Analytics node- Spark only and Spark + Integrated Hadoop (DSE Hadoop) nodes.
    • DSE Search (Solr) nodes - DSE Search (DataStax Enterprise Search) simplifies using search applications for data that is stored in a Cassandra database.
    Cluster Name Name of the cluster. You must use the same cluster name for each node in the cluster.
    Seeds
    Cassandra nodes use the seed node list for finding each other and learning the topology of the ring. Do not make all nodes seed nodes. See the following:
    Ring Options (Advanced installation only)
    Enable Vnodes Enable or disable Virtual nodes.
    Listen Address cassandra.yaml parameter: listen_address
    RPC Address cassandra.yaml parameter: rpc_address
    Directory Locations (Advanced installation only)
    Data Directory cassandra.yaml parameter: data_file_directories
    Commitlog Directory cassandra.yaml parameter: commitlog_directory
    Saved Caches Directory cassandra.yaml parameter: saved_caches_directory
    Logs Directory Log data for Cassandra, Spark, Hadoop, Pig, Hive, Tomcat. See the default file locations for Default file locations for Installer-No Services and tarball installations
    Ports (Advanced installation only)
    SSL Storage Port cassandra.yaml parameter: ssl_storage_port
    RPC Port cassandra.yaml parameter: rpc_port
    DataStax Agent
    OpsCenter Address The network address of the OpsCenter. The agent provides an interface between DataStax OpsCenter and DataStax Enterprise.
    Review and install
    System Configuration Configuration overview and warnings about potential issues.
    Ready to Install The install wizard installs the software.
    Setup finish Post-installation tasks.
    Note: View Configuration Recommendations And Warnings opens the Pre-flight check results.
  4. Review the installation logs to verify the installation.
    Note: If you have closed the logs, see Services or No-Services installer locations.

    Results

    DataStax Enterprise is ready for additional configuration.

  5. Optional: Single-node cluster installations only:
    1. If you haven't started DataStax Enterprise:
      • No-Services:

        $ bin/dse cassandra #optional start options

      • Services:
        sudo service dse start ## Starts the DataStax Enterprise server
        $ sudo service datastax-agent start ## Starts the DataStax Agent
    2. Verify that DataStax Enterprise is running:
      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   256     ?       40725dc8-7843-43ae-9c98-7c532b1f517e  rack1

What's next