• Glossary
  • Support
  • Downloads
  • DataStax Home
Get Live Help
Expand All
Collapse All

DataStax Enterprise OpsCenter 6.8

    • About OpsCenter
      • New features
      • Key features
      • Labs features
        • Exporting and importing dashboard presets
        • Adding a Swift CLI backup location
        • Configuring named route linking
        • Viewing logs from node details
      • Architecture overview
      • OpsCenter policy for DDAC and OSS
      • Feedback about OpsCenter
    • Release notes
    • Installing OpsCenter
    • Upgrading OpsCenter
    • OpsCenter recommended settings
      • OpsCenter basic configurations
      • Cluster synchronization settings
      • Backup Service settings
      • Knowledge Base articles
    • Configuring OpsCenter
      • OpsCenter Security
        • OpsCenter SSL overview
          • Enabling/Disabling HTTPS for the OpsCenter server
          • Configuring SSL/TLS between OpsCenter and the DataStax Agents
          • Connect to DSE with client-to-node encryption in OpsCenter and the DataStax Agents
          • Editing/OpsCenter cluster connections for authentication or encryption
          • SSL configuration options for OpsCenter
        • Configuring OpsCenter role-based security
        • Encrypting sensitive configuration values
          • Activating configuration encryption
          • Creating a system key to encrypt sensitive configuration values
          • Manually encrypting a configuration value
          • Deactivating configuration encryption
        • Authenticating with LDAP
          • Configuring LDAP
          • Adding a role for an LDAP user
          • Troubleshooting OpsCenter LDAP
        • Kerberos authentication
          • Configuring OpsCenter for Kerberos authentication
          • OpsCenter Kerberos configuration options
          • Troubleshooting Kerberos in OpsCenter
        • Configuring security logging
      • Configuring alerts for events
        • SNMP alerts overview
          • Enabling SNMP alerts
        • Enabling SMTP email alerts
        • Enabling alerts posted to a URL
          • Verifying that events are posting correctly
          • Posting URL alerts to a Slack channel
      • Configuring data collection and expiration
        • Controlling data collection
        • Storing collection data on a separate cluster
      • OpsCenter DSE definitions files updates
        • Updating and configuring definitions files properties
      • Automatic failover overview
        • Enabling automatic failover
        • Failover configuration options reference
      • Backing up critical configuration data
      • Configuring named route linking
      • Configuring the OpsCenter JVM
      • Configuring the DataStax Agent JVM
        • Setting and securing the tmp directory for the DataStax Agent
        • Encrypting JMX communications
      • Changing the replication strategy for the OpsCenter keyspace
      • Configuration files for OpsCenter
        • OpsCenter configuration properties
          • Statistics reporter properties
        • Cluster configuration properties
          • Cassandra connection properties
          • Metrics Collection Properties
        • DataStax Agent configuration
        • OpsCenter logback.xml configuration
      • Customize scripts for starting and stopping DataStax Enterprise
      • Example configuration scenarios
        • Configuring for multiple regions
        • Configuring for very large clusters
    • Using OpsCenter
      • OpsCenter workspace overview
        • Ring View
        • List View
        • DataStax Agents Status View
        • Nodes Detail View
          • Node management operations
      • Configuring alerts
        • Adding an alert for agent issues
          • Troubleshooting DataStax Agent Issues
        • Adding an alert for down nodes
        • Configuring an alert for KMIP errors
        • Configuring an alert for percentage of in-memory usage
        • Configuring an alert for percentiles
      • Monitoring node operations
        • Viewing the Spark Console
        • Monitoring in-memory usage
        • Viewing logs from node details
      • Managing and maintaining nodes
        • Running cleanup
        • Performing garbage collection
        • Running compaction
        • Flushing tables
        • Decommission a node
        • Draining a node
        • Moving a node
        • Running a manual repair
        • Configure an alias for a node
      • Starting and stopping DSE
        • Starting DSE on a node
        • Stopping DSE on a node
        • Restarting DSE on a node
      • Managing keyspaces and tables
        • Keyspaces
          • Managing a keyspace
          • Managing tables
        • Browsing data deprecated
      • Cluster administration
        • Adding an existing cluster
        • Disconnecting a cluster from OpsCenter and Lifecycle Manager
        • Rebalancing a cluster overview
          • Rebalancing a cluster
          • Configuring an alert for rebalancing a cluster
        • Restarting a cluster
        • Changing the display name of a cluster
        • Downloading diagnostic data
          • Diagnostic tarball reference
          • Creating an alternate directory for diagnostic information
        • Downloading Insights diagnostic data
        • Generating a cluster report
      • OpsCenter Metrics Tooltips Reference
        • Dashboard performance metrics
        • Performance metrics overview
          • Working with metrics performance graphs
          • Organizing performance metrics presets
          • Exporting and importing dashboard presets
        • Cluster performance metrics
        • Pending task metrics
          • Pending task metrics for writes
          • Pending task metrics for reads
          • Pending task metrics for cluster operations
        • Table performance metrics
        • Tiered storage performance metrics
          • Configuring tiered storage metric graphs
          • Configuring tiered storage alerts
        • Message latency metrics
          • Adding dashboard graphs for datacenter and node messaging latency
          • Adding alerts for DC and node message latency
        • Search performance metrics
        • Graph metrics
        • NodeSync metrics
        • Thread Pool (TP) metrics
          • Viewing TP stats in Node Details
          • Enabling network backpressure
        • Dropped Messages metrics
        • Operating system performance metrics
        • Alert metrics
          • Advanced system alert metrics
    • OpsCenter 6.8 Reference
      • OpsCenter ports reference
      • Installation and configuration locations
        • Default file locations for package installations
        • Default file locations tarball installations
      • Starting, stopping, and restarting OpsCenter
        • Startup log for OpsCenter
      • Stopping, starting, and restarting DataStax Agents
    • DSE Management Services
      • Backup Service
        • Quick Video Tour: Backup Service
        • Adding a backup location
          • Adding a local file system backup location
          • Adding an Amazon S3 backup location
          • Adding an Azure backup location
        • Backing up data
          • Backing up a cluster
          • Backing up to Amazon S3
          • Backing up and restoring DataStax Graphs in OpsCenter
          • Viewing backup and restore history
          • Synchronizing backup data after an upgrade
          • Deleting backup data
        • Restoring a cluster
          • Restoring from a backup
          • Restoring a backup to a specific point-in-time
          • Monitoring sufficient disk space for restoring backups
        • Cloning cluster data
          • Cloning cluster data from a defined other location
          • Cloning cluster data from clusters managed by the same OpsCenter instance
        • Configuring the Backup Service
          • Configuring commit log backups
          • Configuring the free disk space threshold for backups
          • Configuring encryption key storage for backups
          • Configuring custom scripts to run before and after backups
          • Configuring restore to continue after a download failure
          • Backup Service configuration options
        • Troubleshooting Backup Service errors
      • NodeSync Service
        • Enabling NodeSync
        • Configuring the NodeSync refresh data interval
        • Viewing NodeSync Status
        • Configuring the NodeSync rate using LCM
        • NodeSync metrics
      • Repair Service
        • Repair Service overview
          • Subrange repairs overview
          • Distributed subrange overview
          • Incremental repairs overview
          • Repair Service behavior during environment changes
          • Estimating remaining repair time
        • Turning the Repair Service on
        • Turning the Repair Service off
        • Viewing repair status
        • Basic repair configuration
          • Configuring incremental repairs
          • Excluding keyspaces or tables from subrange repairs
          • Enabling distributed subrange repairs
          • Logging for the Repair Service
          • Basic Repair Service configuration reference
        • Advanced repair configuration
          • Adjusting or disabling the throttle for subrange repairs
          • Running validation compaction sequentially
          • Advanced Repair Service configuration reference
        • Expert repair configuration
          • Setting the maximum for parallel subrange repairs
          • Expert Repair Service configuration reference
          • Tuning Repair Service for multi-datacenter environments
        • Expedited Repair Service configuration
        • Troubleshoot Repair Service errors
        • Learn more about repairs
      • Capacity Service
        • Forecasting trends for metric graphs
        • Advanced forecast configuration
      • Best Practice Service
        • Configuring Best Practice service rules
        • Monitoring the results of Best Practice service scans
        • Best Practice Rules Reference
      • Performance Service
        • Performance Service Overview
        • Why use the OpsCenter Performance Service?
        • Enabling the OpsCenter Performance Service
        • Disabling the OpsCenter Performance Service
        • Setting permissions for the OpsCenter Performance Service
        • Tuning a database cluster with the Performance Service
          • Identifying and tuning slow queries
    • Identifying poorly performing tables
    • Monitoring node thread pool statistics
    • Troubleshooting OpsCenter
    • Lifecycle Manager
      • Overview of Lifecycle Manager
        • Supported capabilities
        • Defining the topology
        • Using configuration profiles
        • Defining repositories
        • Running jobs in LCM
          • Job types in LCM
          • Job concurrency in LCM
        • Monitoring job status
      • Installing DSE using LCM
        • Accessing OpsCenter Lifecycle Manager
        • Creating custom data directories
        • Adding SSH credentials
        • Adding a configuration profile
        • Adding a repository
        • Defining the cluster topology
          • Adding a cluster
          • Adding a datacenter
          • Adding a node
        • Running an installation job
        • Viewing job details
        • Using LCM in an offline environment
          • Required software for offline DSE installs
          • Downloading DSE in an offline environments
      • Managing SSH credentials
        • Adding SSH credentials
        • Editing SSH credentials
        • Deleting SSH credentials
        • Configuring SSH connection thresholds for LCM jobs
      • Managing configuration profiles
        • Adding a configuration profile
        • Editing a configuration profile
        • Customizing configuration profile files
        • Cloning a configuration profile
        • Deleting a configuration profile
        • Configuring an HTTP or HTTPS proxy
      • Configuring repositories
        • Adding a repository
        • Editing a repository
        • Deleting a repository
      • Defining DSE topologies
        • Managing cluster topologies
          • Adding a cluster
          • Editing a cluster
          • Deleting a cluster
          • Importing a cluster topology
        • Managing datacenter topologies
          • Adding a datacenter
          • Editing a datacenter
          • Deleting a datacenter
        • Managing node topologies
          • Adding a node
          • Editing a node
          • Deleting a node
      • Running LCM jobs
        • Running an installation job
        • Running an configure job
        • Running an upgrade job
          • Example: Upgrading DSE to a minor release using LCM
        • Aborting a job
        • Adjusting idle timeout
      • Configuring Java options
        • Choosing a Java vendor in LCM
        • Managing Java installs
        • Configuring JVM options for DSE using LCM
      • Configuring DSE security using LCM
        • Native transport authentication schemes and limitations in LCM
          • Configuring row-level access control
        • Configuring SSL/TLS for DSE
        • Configuring a JMX Connection to DSE
      • Lifecycle Manager configuration options
      • Configuration known issues and limitations
      • Using advanced configurations with LCM
        • Exporting metrics collection
        • Configuring AlwaysOn SQL
        • Configuring DSE Graph
        • Configuring the NodeSync rate
        • Configuring tiered storage
    • OpsCenter API reference for developers
      • Enable and access the Datastax Agent API
      • Authentication
      • OpsCenter configuration
      • Retrieving cluster and node information
      • Performing Cluster Operations
      • Managing Keyspaces and Tables
      • Retrieving Metric Data
      • Managing Events and Alerts
      • Schedule management
      • Backup Management and Restoring from Backups
      • Best Practice Rules
      • Hadoop
      • Spark
      • Managing Performance Service Configuration
      • User Interface
      • Agent Install and Status
      • Cluster Lifecycle Management
      • DataStax Agent API example curl commands
  • DataStax Enterprise OpsCenter 6.8
  • Release notes

OpsCenter Release Notes

Release impacts

Understand upgrade impacts, compatibility with DSE versions, and known issues.

DataStax OpsCenter 6.8.x release notes are now hosted here: OpsCenter 6.8.4 and later release notes. Release version 6.8.4 is the follow-on to 6.8.0 in order to align release versions of OpsCenter with those of DataStax Enterprise (DSE).

Before reading release notes, review the following information to understand upgrade impacts, compatibility with DataStax Enterprise (DSE) versions, and known issues for your version of OpsCenter.

Upgrade Information

Review the upgrade considerations pertinent to the release as noted in Upgrading DSE OpsCenter.

Configuration and other notable changes are provided in detail.

Compatibility

To see which versions of DataStax Enterprise (DSE) are supported with OpsCenter 6.x, see the DSE OpsCenter compatibility with DSE.

OpsCenter 6.8.0 does not support DSE 5.1.x. Support for DSE 5.1.x is available in OpsCenter 6.8.4 and later.

Known Issues

Review the list of Known and resolved issues for OpsCenter 6.8.0 and later before running a new OpsCenter version on a production DSE cluster.

OpsCenter 6.8.0 release notes

Release notes for the OpsCenter and Lifecycle Manager version 6.8.0 release.

Highlights as of 30 March 2020

  • Added support for DataStax Graph (DSG).

  • Added the ability to enable incremental NodeSync.

  • Upgraded to the new DataStax Enterprise Java driver with full support for DSE 6.8.

  • Updated DataStax Agent to be compatible with Java 11.

Review the list of new features in OpsCenter to see the latest additions and compare across versions.

Changes in 6.8.0

The following changes are included in this release.

Core

  • Fixed an issue that caused a 404 error when retrieving an xref:configure/agentAddressConfiguration.adoc value of false from the DSE Agent.

  • Fixed vulnerabilities in the OpsCenter user interface. (OPSC-16221)

  • Updated c3p0 library to prevent vulnerabilities in OpsCenter. (OPSC-16109)

  • Updated dependency of JGroup to prevent vulnerabilities in OpsCenter. (OPSC-16105)

  • Updated DataStax Agent to be compatible with Java 11. (OPSC-15278)

  • Fixed a logging issue related to querying the status of the Performance Service while DataStax Agents are not connected. (OPSC-13014)

  • Removed phone home feature from OpsCenter. (OPSC-8756)

  • Added an authentication plugin framework to allow custom authentication strategies. (OPSC-14507)

  • Changed default user interface timeout from 10 seconds to 30 seconds. (OPSC-15554)

  • Added hostname verification for LDAP SSL/TLS connections by default. (OPSC-16354)

  • Fixed an issue where OpsCenter metrics storage would limit queries incorrectly to a subset of nodes. (OPSC-12413)

Backup Service

  • Fixed an issue that caused a restore to fail when working with tens of thousands of SSTables for a single node and keyspace. (OPSC-16463)

  • Fixed an issue causing unneeded checks of remote file sizes during restore. (OPSC-16431)

  • Fixed an Azure backup issue where not all data was being returned when a container had more than 5000 items. (OPSC-16409)

  • When running a backup for select datacenters, the disk space check no longer queries nodes not included in the backup. (OPSC-16407)

  • Fixed issues preventing a sstableloader bypass restore of a single datacenter. This works with only new backups of the datacenter. (OPSC-16341)

  • Corrected an issue that prevented a datacenter snapshot from being taken when nodes outside of that datacenter had problems with their DataStax Agents. (OPSC-16338)

  • Corrected a performance problem with the keyspace selector for clusters with a large number of keyspaces or tables. (OPSC-16331)

  • Added support for Swift S3 backup and restore. (OPSC-16240)

  • Improved error message when a node does not have access to the data required for a restore. (OPSC-16042)

  • Fixed an issue which could cause a StackOverflowException during backups, restores, and metrics gathering. (OPSC-15977)

  • Optimized how commit logs are transferred to destinations when the DataStax Agent starts. (OPSC-14023)

  • Added support for DataStax Graph (DSG) backups. (OPSC-14699)

  • Reduced instances of thread death. (OPSC-10385)

  • Added commit log archiving failures as alerts in the OpsCenter event log. (OPSC-14020)

  • Added support to configure the backup storage directory (backup_storage_dir) using the commit log backup settings. (OPSC-14496)

  • Fixed an issue when using multi-level prefix paths as locations for the Backup Service. (OPSC-14687)

  • Fixed an issue where a restore would fail if the backup was taken shortly after dropping a column from a table. (OPSC-13029)

Monitoring

  • Added support for new DataStax Graph (DSG) metrics. (OPSC-15876)

  • Removed the following metrics to reflect definitions for DataStax Enterprise 6.8.0. (OPSC-15588)

    • active-eventloop-park

    • completed-eventloop-park

    • completed-eventloop-processed-tasks

    • active-eventloop-processed-tasks

    • active-eventloop-scheduled-tasks

    • completed-eventloop-scheduled-tasks

    • active-eventloop-selector-events

    • completed-eventloop-selector-events

    • active-eventloop-select-calls

    • completed-eventloop-select-calls

    • active-eventloop-select-now-calls

    • completed-eventloop-select-now-calls

    • active-eventloop-spin

    • completed-eventloop-spin

    • active-eventloop-yield

    • completed-eventloop-yield

    • pending-frame-decode

    • total-blocked-frame-decode

    • active-read-deferred

    • completed-read-deferred

    • pending-read-deferred

    • total-blocked-read-deferred

NodeSync

  • Added support to enable and disable incremental NodeSync introduced in DataStax Enterprise 6.8.0. (OPSC-15798)

  • Added new NodeSync Incremental Validation Covered Ages metric for incremental NodeSync. (OPSC-15654)

Provisioning

  • Added the ability to specify CASSANDRA_LOG_DIR via Lifecycle Manager by managing dse-env.sh. (OPSC-16307)

    The default location of the dse-env.sh file depends on the type of installation:

    Package installations

    /etc/dse/dse-env.sh

    Tarball installations

    installation_location/bin/dse-env.sh

  • Fixed an issue in Lifecycle Manager that caused the movement of temporary files across file systems to fail when /tmp is mounted on its own file system. (OPSC-15822)

  • Added ability to configure DSE defaults for environment variables. (OPSC-15211)

  • When editing SSH keys in Lifecycle Manager within the SSH credential form, the keys are now displayed in a monospace font. (OPSC-15087)

  • OpsCenter and DataStax Enterprise no longer require the external binary which to be installed. (OPSC-14931)

  • Lifecycle Manager does not allow for the following cluster names: opscenter, api, login, logout, rc, and keepalive. (OPSC-14119)

  • Updated logging to include additional logging from some dependencies. (OPSC-13180)

  • Made UTC the default logging time zone for OpsCenter and DataStax Agents. Added time zone specifier to log timestamps. (OPSC-15405)

Repair Service

  • Repair Service temporary files are cleaned up more quickly. (OPSC-15982)

Known and resolved issues for OpsCenter 6.8.0 and later

Known issues, workarounds, and resolved issues for the OpsCenter and Lifecycle Manager 6.8.0 and later versions.

The following are known issues that exist in OpsCenter 6.8.0 and later versions. Each item has a link to more details including workarounds when available. These issues will be addressed in future releases where possible. If you have any questions, contact DataStax Support for assistance.

OpsCenter 6.8.0

  • Data might not display on graph queries for graphs restored with OpsCenter. This occurs under the following conditions:

    • Using DSE 6.8.0 or later.

    • The restored graph uses DataStax Graph Classic.

    • The restore does not use sstableloader. If the graph is empty, use OpsCenter to perform a rolling restart of the cluster. After the restart, data should be visible with graph queries. (OPSC-16476)

  • When restoring materialized views, OpsCenter does not correctly wait for the cluster schema to settle, which can cause errors when data is restored to the table on which the view is based. (OPSC-13029)

  • If there are approximately 75 or more keyspaces, the DataStax Agent /tokenranges API call runs out of memory with the default heap size. As a temporary workaround, adjust the agent heap size. (OPSC-11975)

  • For DSE versions 5.1 and later, slow query data is only available since the last time the DataStax agent was restarted. (OPSC-11702)

  • Insufficient permissions on the staging directory can cause the agent to exhaust inotify watches on the system over time. (OPSC-10732)

  • Users will see an ungraceful error+stack trace in opscenterd.log if accessing a cluster through the UI/API that no longer exists. The error message contains “ERROR: Unhandled error in Deferred: There are no clusters with name or ID…​”. This error message is harmless. (OPSC-8819)

Lifecycle Manager (LCM) 6.8.0

  • Lifecycle Manager is not currently compatible with DSE Transparent data encryption. See Encrypted DSE configuration values for more details. (OPSC-7529)

  • DSE Graph properties: DSE Graph configuration in dse.yaml, which is configurable through LCM Config Profiles. All Graph properties in dse.yaml can be managed through the LCM UI with the exception of gremlin_server.serializers and gremlin_server.scriptEngines. If you are using LCM and need to customize these properties, be sure to leverage the LCM API to make the changes. Future changes to the Config Profile using the LCM UI will retain properties set through the API.

  • When configuring credentials in a Repository, special characters such as #, $, and so forth are supported, but non-ascii unicode characters are not. (OPSC-8921)

Feedback about OpsCenter Installing OpsCenter

General Inquiries: +1 (650) 389-6000 info@datastax.com

© DataStax | Privacy policy | Terms of use

DataStax, Titan, and TitanDB are registered trademarks of DataStax, Inc. and its subsidiaries in the United States and/or other countries.

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries.

Kubernetes is the registered trademark of the Linux Foundation.

landing_page landingpage