Installing DataStax Enterprise 4.7 using GUI or Text mode

DataStax Enterprise production installation or upgrade on any Linux-based platform using a graphical or text interface.

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

For a complete list of supported platforms, see DataStax Enterprise Supported Platforms.

About the installer 

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
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 installer installs DataStax Enterprise and the DataStax Agent. It does not install OpsCenter or DevCenter. The installer sets some but not all cassandra.yaml parameters described in the table below. It does not set dse.yaml properties. You can set the remaining parameters in the following ways:

  • Manually after installation.
  • Use the unattended install with either command line or the property file options. These options allow you to specify pre-configured cassandra.yaml and dse.yaml files using --cassandra_yaml_template filename and --dse_yaml_template filename.

Installing under a user account

  • 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.
  • Without root or sudo access, the installer cannot set up support services because it does not have permission to create the services files.

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

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. (Linux only) From the directory where you downloaded the install file, change the permission to executable:
    $ chmod +x DataStaxEnterprise-4.7.X-linux-x64-installer.run
  3. To view the installer help:
    $ ./DataStaxEnterprise-4.7.x-linux-x64-installer.run --help
  4. Start the installation:
    $ sudo ./DataStaxEnterprise-4.7.X-linux-x64-installer.run             ## Install in GUI mode.
    $ sudo ./DataStaxEnterprise-4.7.X-linux-x64-installer.run --mode text ## Install in Text mode.

    Using the install command to set configuration parameters:

    To add configuration parameters to the installation, use the installer options described in Unattended DataStax Enterprise 4.7 installer. For example:

    $ sudo ./DataStaxEnterprise-4.7.X-linux-x64-installer.run --prefix /usr/local/dse --enable_vnodes 0 ## Command line option.
    $ sudo ./DataStaxEnterprise-4.7.X-linux-x64-installer.run --optionfile ../datastax/DC4-analytics.prop ## Property file option.

    The installer launches.

  5. 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 If you use the No Services option, you can change the location of the dse directory. If you install as a service, DataStax Enterprise can only be installed in the /usr/share/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.
    Service Setup

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

    Services Only - installs the DataStax Enterprise server as a service running in the background.

    Services and Utilities (Linux only) - installs the DataStax Enterprise server as a service running in the background and Cassandra utilities, such as cqlsh, sstableloader, sstablescrub, and sstableupgrade to the system path.

    Start Services After Install Select Yes to start all services when the installation is complete, or select No when additional configuration is needed after installation.
    Installation Directories (Advanced installation only)
    Agent Installation Directory For more information about the Agent, see the DataStax Agent configuration documentation.
    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.

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

    Ring Name Name of 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:
    User Setup (Advanced installation only)
    OS User ID for Service When starting DataStax Enterprise as a service, the Cassandra and Hadoop tracker services run as this user and group. The service initialization script is located in /etc/init.d/dse. Run levels are not set by the package.
    OS User Group for Service
    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
    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.
    Ports (Advanced installation only)
    Storage Port cassandra.yaml parameter: storage_port
    SSL Storage Port cassandra.yaml parameter: ssl_storage_port
    RPC Port cassandra.yaml parameter: rpc_port
    Setup
    DataStax Agent The network address of the OpsCenter. The agent provides an interface between DataStax OpsCenter and DataStax Enterprise.
    System Configuration Configuration overview and warnings about potential issues.
    Ready to Install The install wizard installs the software.
    Setup finish Post-installation tasks. View Configuration Recommendations And Warnings opens the Pre-flight check results.
  6. 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