Unattended DataStax Enterprise 4.7 installer

Install DataStax Enterprise 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.7 uses Cassandra 2.1.

Prerequisites

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

  1. Download the installer for your computer from the DataStax download page page or use the following command:
    • Linux 64-bit:
      curl --user dsa_email_address:password -O https://downloads.datastax.com/enterprise/DataStaxEnterprise-4.7.X-linux-x64-installer.run
    • Mac OS X (non-production installations only):
      curl --user dsa_email_address:password -O https://downloads.datastax.com/enterprise/datastaxenterprise-4.7.X-osx-installer.dmg
      Note: On some versions of Mac OS X, you might need to install readline: easy_install - readline.
  2. Change the permission on the file to executable:
    $ chmod +x DataStaxEnterprise-4.7.X-linux-x64-installer.run
  3. You can either use the command line or a properties file.

    Command line installation:

    $ sudo ./DataStaxEnterprise-4.7.XX-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.7.X-linux-x64-installer.run --prefix /usr/share/dse --enable-components dse,datastax_agent --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.7.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.7.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_4.7.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:
    • 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
    Attention: All nodes are DataStax Enterprise nodes and run the Cassandra database.
    Use one of the following:
    • cassandra
    • analytics
    • search

    Type of node. Default: cassandra.

    • Cassandra node

      Transactional node, also used for Bring your own Hadoop (BYOH) nodes.

    • Search node

      DSE Search (Solr) nodes. DSE Search (DataStax Enterprise Search) simplifies using search applications for data that is stored in a Cassandra database.

    • Analytics node

      Spark only and Spark + Integrated Hadoop (DSE Hadoop) nodes.

    analytics_type
    Use one of the following:
    • spark_only
    • spark_integrated
    Type of analytics node.
    • spark_only Enable only 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 addressesDo 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
  4. Optional: Review the installation logs to verify the installation.
    Directories Description
    /usr/share/dse/backups/log_file_dir/copied_config_files.log Show Config File Overwrites
    /usr/share/dse/backups/log_file_dir/bitrock_installer.log View Installation Log
    /usr/share/dse/backups/log_file_dir/install_dependencies.log View Dependency Installation Log
    /usr/share/dse/backups/pfc_results.txt View Configuration Recommendations and Warnings (Preflight Check Results)
    /usr/share/dse View README
    /usr/share/dse Uninstall DataStax Enterprise

Results

DataStax Enterprise is ready for additional configuration.

What's next