Installing OpsCenter from the Debian package

Install DataStax OpsCenter using APT repositories on Debian or Ubuntu distributions.

Install DataStax OpsCenter using APT repositories on Debian or Ubuntu distributions.

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

The OpsCenter Debian and Ubuntu packaged releases runs as a service from root. The service initialization script is located in /etc/init.d.

If the OpsCenter machine reboots, OpsCenter restarts automatically. To disable restart upon reboot:
$ sudo update-rc.d opscenterd disable

Prerequisites

  • Be sure your platform is supported.
  • DataStax Academy registration email address and password.
  • Aptitude Package Management (APT) application.
  • Root or sudo access.
  • Oracle Java SE Runtime Environment 8 (JDK) (1.8.0_40 minimum) or OpenJDK 8. Earlier or later versions are not supported.
  • Python 2.7.x
  • DataStax recommends using a recent version of one of the major web browsers. OpsCenter does not support Internet Explorer or Microsoft Edge.

Also see Recommended production settings and the DataStax Enterprise Reference Architecture white paper.

Table 1. 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.
Minimum hardware requirements for the machine on which OpsCenter runs:
  • 2 CPU cores
  • 2 GB of RAM available to OpsCenter

Procedure

  1. Verify that a required version of Java is installed:
    java -version

    If not Oracle Java 8, or OpenJDK, see Installing the JDK.

    Important: Package management tools do not install Oracle Java.

In a terminal window:

  1. Modify the aptitude repository source list file (/etc/apt/sources.list.d/datastax.sources.list).
    $ echo "deb https://dsa_email_address:password@debian.datastax.com/enterprise stable main" | sudo tee -a /etc/apt/sources.list.d/datastax.sources.list

    where dsa_email_address and password are your DataStax Academy account credentials.

    Attention: Depending on your environment, you might need to URL-encode the at sign @ character in your email address by replacing it with %40. URL-encode any other characters in your username or password that are non-ASCII characters. Escape any character in your password that is used in your operating system's command line, such as bang \! or pipe \|.

    Example username:password: myname@datastax.com:pa$$word!

    Properly encoded and escaped: myname%40datastax.com:pa%24%24word\!

  2. Add the DataStax repository key to your aptitude trusted keys:
    $ curl -L https://debian.datastax.com/debian/repo_key | sudo apt-key add -
  3. Install the OpsCenter package using the APT Package Manager:
    $ sudo apt-get update
    $ sudo apt-get install opscenter

For most users, the out-of-box configuration should work just fine. If necessary, you can configure OpsCenter for your environment.

  1. Start OpsCenter:
    $ sudo service opscenterd start
  2. Connect to OpsCenter in a web browser using the following URL:
    http://opscenter-host:8888/

What's next

Add an existing cluster or provision a new cluster in Lifecycle Manager.