DataStax Enterprise 4.5

Installing DataStax Enterprise using Text mode

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

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

Prerequisites

  • Root or sudo access to the install machine.
  • Latest version of Oracle Java SE Runtime Environment 7, not OpenJDK. See Installing the Oracle JRE.
  • RedHat-compatible distributions require EPEL (Extra Packages for Enterprise Linux). See Installing EPEL.
  • Python 2.6+ (needed if installing OpsCenter).
  • If installing on a 64-bit Oracle Linux distribution, first install the 32-bit versions of glibc libraries.
  • Some RedHat-compatible distributions do not contain the Linux Standard Base Core module (redhat-lsb-core) by default. If your distribution does not have this package, you must install it.
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.

The installer sets some but not all cassandra.yaml parameters. You can set additional parameters after installation. The unattended install allows you to copy complete cassandra.yaml and dse.yaml files containing all the parameters. Upgrading from DataStax community requires additional preparation.

You can run the installer as root or under a user account. If you run the installer as root, you can install system services on operating systems that support services, such as RHEL-based systems. If you run the installer under a user account, you cannot set up services because the installer does not have permission to create the services files. For production user-account installations, DataStax recommends that you use the tarball installation.

Procedure

  1. Download the installer for your computer from the DataStax download page.
    • Linux 32 - DataStaxEnterprise-4.5.x-linux-installer.run
    • Linux 64 - DataStaxEnterprise-4.5.x-linux-x64-installer.run
    • Mac OS X (Non-production installations only.) See the instructions for installing Mac OS X in the Getting started.
  2. From the directory where you downloaded the install file.
    $ chmod +x DataStaxEnterprise-4.5.x-linux-x64-installer.run ## Changes permission to executable
    $ sudo ./DataStaxEnterprise-4.5.x-linux-x64-installer.run --mode text
    Note: Although you can install without sudo or root privileges, it is highly recommended. For production installations, install from the binary tarball.

    The installer launches.

  3. Press [Enter] to continue and follow the instructions in the installer using the following table for guidance.

    If you want to use the default value, leave the entry empty and press the Enter key.

    Note: The installer also provides information about install options.
    Panel Recommendations and additional information
    Welcome  
    License Agreement DataStax Enterprise End User License Agreement
    Components

    If installing DataStax Enterprise, you must also install the DataStax Agent.

    For production installations, DataStax recommends installing the OpsCenter separate from the cluster. See the OpsCenter documentation. The DataStax Agent is not required on the OpsCenter machine.

    Install Options
    Server Installation 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 Oracle Java. Set to Yes when run as root user, otherwise set to No.
    Default Interface Host 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, sstable2json, 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 if additional configuration is needed after installation.
    Installation Directories
    Agent Installation Directory For more information about the Agent, see the DataStax Agent configuration documentation.
    OpsCenter Installation Directory For more information, see the OpsCenter documentation.
    DevCenter Installation Directory For more information, see the DevCenter documentation.
    Node Setup
    Node Type
    The following types of nodes are available:
    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. See the following:
    User Setup
    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
    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
    Storage Port cassandra.yaml parameter: storage_port
    SSL Storage Port cassandra.yaml parameter: ssl_storage_port
    RPC Port cassandra.yaml parameter: rpc_port
    DataStax Agent The agent provides an interface between DataStax OpsCenter and DataStax Enterprise.
    System Configuration Issues are listed for production systems.
    Ready to Install The install wizard installs the software.
    Setup finish Post-installation tasks. To see the Pre-flight check results, select View Configuration Recommendations And Warnings

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.

Show/hide