Try it free

Change storage location

  • How-to guide
  • 6-min read

Dynatrace Managed stores multiple types of monitoring data that vary depending on the use case. There are default storage locations, as listed in Dynatrace Managed hardware and system requirements.

You might need to change existing paths for the storage locations if:

  • The volume storage is full and you must migrate to a larger volume.
  • Current storage location is on a temporary volume and you must migrate it to another volume.
  • Current storage location is on a shared volume and you want to move the data to a dedicated volume.

Change the paths to the storage locations

  1. Back up your data.

    An error in this procedure can result in data loss. Back up all the storage files to a safe location before you proceed and, if possible, run this procedure on a test deployment first.

  2. Stop all Dynatrace services on the node.
    By default, the script is located at <PRODUCT_PATH>/launcher/. Verify that the dynatrace.sh script has executable permissions. After you run the script, wait for it to finish and verify that no Dynatrace services remain active.

    [root@host]# <PRODUCT_PATH>/launcher/dynatrace.sh stop
  3. Move the data store to the new location.
    Keep in mind that you cannot nest datastores within each other. For example, Cassandra storage cannot be a subdirectory of session storage.

    [root@host]# cp -pR /old_location/cassandra/* /new_location/cassandra
  4. Ensure that the user dynatrace:dynatrace is the owner of this new directory.

    [root@host]# chown -R dynatrace:dynatrace /new_location
  5. Update the new data location in /etc/dynatrace.conf.
    The location must be either an absolute path or a value based on predefined variables. It must be a directory, and it cannot be a symlink.
    Update the following section:

    # Paths to directories with component's data
    DATASTORE_PATH = /var/opt/dynatrace-managed
    CASSANDRA_DATASTORE_PATH = DATASTORE_PATH/CASSANDRA_DIR
    ELASTICSEARCH_DATASTORE_PATH = DATASTORE_PATH/ELASTICSEARCH_DIR
    SERVER_DATASTORE_PATH = DATASTORE_PATH/SERVER_DIR
    SERVER_REPLAY_DATASTORE_PATH = SERVER_DATASTORE_PATH/replayData
    NODEKEEPER_DATASTORE_PATH = DATASTORE_PATH/NODEKEEPER_DIR
  6. Run the reconfigure via the installer. Use the nohup command to prevent interruption of script execution (such as session disconnect) during important operations.

    [root@host]# nohup <PRODUCT_PATH>/installer/reconfigure.sh --no-start &

    This step is crucial to propagating the changes from /etc/dynatrace.conf to all relevant configuration files. The --no-start flag will allow you to make a final verification of the changes before starting any of the Dynatrace services.

    The script output should look similar to the following:

    Reconfiguration completed successfully after 1 minute 9 seconds.
    Dynatrace binaries are located in directory /opt/dynatrace-managed
    Dynatrace data is located in directory /new_location
    Dynatrace metrics repository is located in directory /new_location/cassandra
    Dynatrace Elasticsearch store is located in directory /new_location/elasticsearch
    Dynatrace server store is located in directory /new_location/sessionstorage
    Dynatrace session replay store is located in directory /new_location/replayData
    Don't forget to start Dynatrace Server and log in at https://<your_ip>
  7. Start all Dynatrace services.

    [root@host]# <PRODUCT_PATH>/launcher/dynatrace.sh start
  8. Check the logs to make sure all services started without issues.

Default directory paths and required free disk space for installing and upgrading

The directory paths included in the following table are the default paths. Actual paths might vary if you've installed to a custom directory.

Custom directories

If you customized the storage locations, place SERVER_DATASTORE_PATH, CASSANDRA_DATASTORE_PATH, and ELASTICSEARCH_DATASTORE_PATH in separate directories, and make none of them a subdirectory of another.

Directory symbolDirectory pathDescriptionRequired free disk space for installingRequired free disk space for upgrading

SELFMON_AGENT_INSTALL_PATH
Also see, Disk space for OneAgent

/opt/dynatrace

Main directory for self-monitoring OneAgent binaries

3 GB 1

1.8 GB 1

PRODUCT_PATH

/opt/dynatrace-managed

Main directory for Dynatrace Managed binaries

12 GB 1

10 GB 1

DATASTORE_PATH

/var/opt/dynatrace-managed

Main directory for Dynatrace Managed data

24 GB

3 GB

LOG_PATH

DATASTORE_PATH
/log

Logs of all Dynatrace Managed components, services, and tools

2 GB

1 GB

Not configurable (fixed path)

/var/log/dynatrace

Logs of the installer, upgrade, and configurator, such as install.log, install-status.log, and configurator.log; shared with OneAgent, which uses the oneagent subdirectory

1 MB 2

1 MB 2

CASSANDRA_DATASTORE_PATH

DATASTORE_PATH
/cassandra

Metrics repository

25 GB

1 GB

ELASTICSEARCH_DATASTORE_PATH

DATASTORE_PATH
/elasticsearch

Elasticsearch store

3 GB

1 GB

SERVER_DATASTORE_PATH

DATASTORE_PATH
/server/tenantData

Transactions store

14 GB

1 GB

SERVER_REPLAY_DATASTORE_PATH

DATASTORE_PATH
/server/replayData

Session Replay store

14 GB

1 GB

AGENT_BUILD_UNITS_PATH

DATASTORE_PATH
/agents

OneAgent and ActiveGate installation packages (if downloaded by Dynatrace Server or installed from standalone packages)

20 GB

1 GB

SERVER_BUILD_UNITS_PATH

DATASTORE_PATH
/installer

Dynatrace Managed installer for adding nodes to a Managed Cluster, prepared during installation or upgrade

2 GB

1 GB

1

This value is part of a total value required for the /opt directory. Total required free disk space is the sum of the required disk space for /opt/dynatrace-managed and /opt/dynatrace.

2

The installer verifies the free space on the filesystem that holds /var/log. Requirements for paths located on the same filesystem are added together.

/var/log/dynatrace must be writable

The installer writes its own logs to /var/log/dynatrace, a fixed path that cannot be changed and that OneAgent shares through the /var/log/dynatrace/oneagent subdirectory. If /var/log/dynatrace is a symbolic link or carries restrictive POSIX ACLs, verify that the Dynatrace product user has write access to the effective target directory, including the ACL mask.

Not supported

Nested mount points are not supported in the DATASTORE_PATH/server location for /tenantData or /replayData.

Extend the size of the storage volume

To extend the size of the storage volume, you need to follow the disk extension procedure from your storage provider. If you use dynamic storage, you most likely can adjust the disk parameters (size, bandwidth, type) and the host will automatically apply it. Otherwise, a disk re-mounting might be necessary. If you've increased the size of your volume, then you must also extend the volume's partition to use the additional storage capacity. Dynatrace Managed services should automatically discover any changes to this.

Managed Cluster is out of free disk space

If there's insufficient disk space on any of your used mount points, the Managed Cluster generates a Managed Cluster event like this:

Insufficient disk space on <mountPoint> on <path>

You need at least <required MB> free for <storage type>. Currently, only <current free disk space> of a total of <disk size> is available.

Providing enough disk space is vital to the health of your Managed Cluster and ensures your monitoring data is safe, consistent, and available. Ignoring that message might cause data loss.

If the transaction data storage is affected, you'll see an additional Managed Cluster event that automatically truncates the data and adapts the data retention period. To read more, see Adaptive data retention.