Unattended DataStax Enterprise 4.8 installer

Install DataStax Enterprise using the command line or properties file.

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

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

Prerequisites

  • Be sure your platform is supported.
  • Root or sudo access when installing as a system service, or if installing missing system dependencies.
  • 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.

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.

Procedure

From 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
    
  2. Change the permission on the file to executable:
    $ chmod +x DataStaxEnterprise-4.8.x-linux-x64-installer.run
  3. You can either use the command line or a properties file.

    Command line installation:

    $ sudo ./DataStaxEnterprise-4.8.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.8.X-linux-x64-installer.run --prefix /usr/share/dse --enable_vnodes 0 --mode unattended --prefix /usr/share/dse

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

    Properties file installation:

    $ sudo ./DataStaxEnterprise-4.8.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.8.X-linux-x64-installer.run --optionfile ../datastax/DC4-analytics.prop --mode unattended
    Property file format: option=argument. For example:
    enable-components=devcenter_linux_x86_64
    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_4.8.prop file from the DataStax Enterprise download page.
    Unattended install options
    Option Argument Description
    Install options
    prefix install_directory

    Install location. Default: /usr/share/dse

    enable-components Comma separated list of components:
    opscenter, 
    devcenter_linux_x86, 
    devcenter_linux_x86_64,
    devcenter_macosx_x86, 
    devcenter_macosx_x86_64, 
    devecenter_windows_x86, 
    devcenter_windows_x86_64, 
    dsc_x86, 
    dsc

    Components to install.

    DataStax Enterprise and the datastax_agent are installed by default. If you don't want to install the agent, use the disable-components option.

    disable-components Disables installation of default components. Use to prevent the datastax_agent from being installed.
    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.

    Attention: All nodes are DataStax Enterprise nodes and run the Cassandra database.
    • 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.
    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. Because the DataStax Agent relies on usercassandra, DataStax does not recommend changing the default. If changed, you must manually install, update, and configure the DataStax Agent.
    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_addresses

    Do not make all nodes seed nodes. See 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
    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
    The location of the cassandra.yaml file depends on the type of installation:
    Package installations /etc/dse/cassandra/cassandra.yaml
    Tarball installations install_location/resources/cassandra/conf/cassandra.yaml

Results

DataStax Enterprise is ready for additional configuration.

What's next