Unattended DataStax Enterprise installer

Installs DataStax Enterprise 4.5 using the command line or properties file.

For a complete list of supported platforms, see DataStax Enterprise Supported Platforms. For other product installations, see Installing OpsCenter and Installing DevCenter.

Important: DataStax Enterprise 4.5 uses Cassandra 2.0.

Prerequisites

  • Root or sudo access when installing as a system service, and if installing missing system dependencies.
  • Latest version of Oracle Java SE Runtime Environment 7, not OpenJDK. See Installing Oracle JDK.
  • 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.

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

Hardware requirements
Requirement Minimum Production
CPUs 2 16
Memory 8GB 24GB
Data directory 20GB 200GB
Commit log directory 20GB 200GB
Saved caches directory 20GB 200GB
Logs directory 20GB 200GB

Procedure

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.5 is 4.5.9.

  1. Download the installer for your computer from the DataStax download page.
  2. Change the permission on the file to executable: 
    $ chmod +x DataStaxEnterprise-4.5.X-linux-x64-installer.run
  3. You can either use the command line or a properties file.

    Command line installation:

    $ sudo ./DataStaxEnterprise-4.5.X-linux-x64-installer.run --option argument --option argument ... --option argument --mode unattended

    For available options, see the table below. Be sure to add "--" to the option. For example: 

    $ sudo ./DataStaxEnterprise-4.5.X-linux-x64-installer.run --prefix /usr/local/dse --enable-components dse,datastax_agent --enable_vnodes 0 --mode unattended --prefix /usr/local/dse

    The installer uses the default value for any --option that is not specified.

    Properties file installation:

    $ sudo ./DataStaxEnterprise-4.5.X-linux-x64-installer.run --optionfile option_file_name --mode unattended
    where option_file_name is the name of the file containing the installation options. For example:
    $ sudo ./DataStaxEnterprise-4.5.X-linux-x64-installer.run --optionfile ../datastax/DC4-analytics.prop --mode unattended
    Property file format: option=argument. For example: 
    enable-components=dse,datastax_agent
install_type=simple
update_system=1

    The property file options are the same as the command line options (without the --).

    Note: You can download a sample_install.prop file from the DataStax Enterprise download page.
    Unattended install options
    Option Argument Description
    Install options
    prefix install_directory

    Install location. Default: /usr/local/dse
    enable-components Comma separated list of components:
    • dse
    • datastax_agent

    Components to install. Default: dse,datastax_agent
    cassandra_yaml_template file name Use this cassandra.yaml file as the template for the node's cassandra.yaml file.
    dse_yaml_template file name Use this dse.yaml file as the template for the node's dse.yaml file.
    cassandra_logs_dir directory Directory for log files.
    do_drain 0 (no) or 1 (yes) Drain the node before installing. Default: 1
    install_type simple or advanced Default: simple
    system_install
    Use one of the following:
    • no_services
    • services_only
    • services_and_utilities

    Install system services. Default: services_and_utilities for root user, no_services for others.
    update_system 0 (no) or 1 (yes)

    Upgrade any missing system files. Does not upgrade or install major components such as Oracle Java. Default: 1 for root user, 0 for others.
    installdir_agent directory Directory where agent is installed.
    node_type
    Use one of the following:
    • cassandra
    • analytics
    • search

    Type of node. Default: cassandra.
    analytics_type
    Use one of the following:
    • spark_only
    • spark_integrated
    Type of Analytics node.
    • spark_only - only enable Spark.
    • spark_integrated- enable Spark + Integrated Hadoop (DSE Hadoop).

    cassandra_user

    		user name User name for running service. Start-up scripts are provided in /etc/init.d.
    cassandra_group group name Group name for running service. Start-up scripts are provided in /etc/init.d.
    start_services 0 (no) or 1 (yes)

    Start services. Default: 1.
    OpsCenter options
    opscenter_address IP address Address for the OpsCenter server.
    cassandra.yaml options (These values override options set in the cassandra.yaml template file. See the cassandra_yaml_template above.)
    ring_name name Name of ring.
    enable_vnodes 0 (no) or 1 (yes)

    Enable or disable virtual nodes (vnodes). Default: 1 for Cassandra nodes, 0 for others.

    seeds Comma separated list of seed IP addressesDo not make all nodes seed nodes. Please read Internode communications (gossip). Seed list for this node.
    interface IP address Default interface to use for listening on all services.
    listen_address IP address listen_address
    rpc_address IP address rpc_address
    cassandra_data_dir directory data_file_directories
    cassandra_commitlog_dir directory commitlog_dir
    cassandra_saved_caches_dir directory saved_caches_directory
    rpc_port port number rpc_port
    storage_port port number storage_port
    ssl_storage_port port number ssl_storage_port

Results

DataStax Enterprise is ready to start or for additional configuration.

What's next

Please send any feedback or suggestions about this installer to dse-installer@datastax.com.