DataStax Enterprise 4.5

Installing DataStax Enterprise using GUI mode

DataStax Enterprise production installation or upgrade on any Linux-based platform using a graphical 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.

Installing under a user account

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

If gksudo or pkexec is not installed and you did not start the installer using sudo or root priviledges, the installer may not present a GUI sudo prompt. Subsequently the sudo prompt appears in the shell:

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
    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. Follow the instructions in the setup wizard using the following table for guidance.
    Note: The setup wizard also provides information about install options.
    Screen Recommendations and additional information
    Setup - DataStax Enterprise Welcome page.
    License Agreement DataStax Enterprise End User License Agreement
    Select 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.
    Completing the DataStax Enterprise Setup Wizard 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