Creating an alternate directory for diagnostic information

About this task

When a request is issued for diagnostic information, OpsCenter requests each DataStax Agent to run diagnostic commands, and collect logs and configuration files. Each DataStax Agent reports diagnostic data to OpsCenter, which temporarily places that data in the /tmp directory to construct a compressed tarball.

Depending on the OpsCenter server configuration, the /tmp directory might not have capacity to store the collected data from the DataStax Agents. Errors caused by lack of space in temporary file system can cause the diagnostic collection to fail.

Complete the following steps to provide an alternate working directory for OpsCenter to use for diagnostic data collection.


  1. Create a new directory on the file system, other than /tmp.

    mkdir diagnostic_directory
  2. Grant the OpsCenter user full read and write permissions to the directory. In some cases, it might be necessary to grant permissions on the parent directory as well.

    sudo chmod -R 660 diagnostic_directory
  3. Open the opscenter script in a terminal or text editor.

    • Package installs: /usr/share/opscenter/bin

    • Tarball installs: install_location/bin

      vim opscenter
  4. Add the following line before the line indicating RUN_IN_BACKGROUND=1.

    export TMPDIR="path_to/diagnostic_directory"
  5. Save and close the opscenter script.

  6. Restart OpsCenter for the changes to take effect.

  7. Download diagnostic data as a compressed tarball.

Errors caused by lack of space in temporary file system

Depending on the version of OpsCenter installed, the following errors can display if insufficient space is available to generate the diagnostic tarball.

Not enough space to store all data for diagnostic tarball
Can't write out diagnostic file for OpsCenter machine, because it will fill up a disk

In addition to the previous error messages being displayed in the OpsCenter console, the following messages can be reported in opscenterd.log.

Not enough space to store all data for diagnostic tarball
Not enough space to write the diagnostic file out on OpsCenter machine

Was this helpful?

Give Feedback

How can we improve the documentation?

© 2024 DataStax | Privacy policy | Terms of use

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.

General Inquiries: +1 (650) 389-6000,