The following sections provide recommendations for optimizing your DataStax Enterprise installation on Linux:html
Use the latest 64-bit version of Oracle Java Platform, Standard Edition 8 (JDK) or OpenJDK 8.java
Synchronize the clocks on all nodes and application servers. Use NTP (Network Time Protocol) or other methods.node
This is required because DataStax Enterprise (DSE) overwrites a column only if there is another version whose timestamp is more recent, which can happen when machines in are different locations.git
DSE timestamps are encoded as microseconds since UNIX epoch without timezone information. The timestamp for all writes in DSE is UTC (Universal Time Coordinated). DataStax recommends converting to local time only when generating output to be read by humans.github
To handle thousands of concurrent connections used by DataStax Enterprise, DataStax recommends these settings to optimize the Linux network stack. Add these settings to /etc/sysctl.conf.session
net.core.rmem_max = 16777216 net.core.wmem_max = 16777216 net.core.rmem_default = 16777216 net.core.wmem_default = 16777216 net.core.optmem_max = 40960 net.ipv4.tcp_rmem = 4096 87380 16777216 net.ipv4.tcp_wmem = 4096 65536 16777216
To set immediately (depending on your distribution):oracle
sudo sysctl -p /etc/sysctl.conf
sudo sysctl -p /etc/sysctl.d/filename.conf
Recent Linux systems include a feature called CPU frequency scaling or CPU speed scaling. It allows a server's clock speed to be dynamically adjusted so that the server can run at lower clock speeds when the demand or load is low. This reduces the server's power consumption and heat output (which significantly impacts cooling costs). Unfortunately, this behavior has a detrimental effect on servers running DataStax Enterprise because throughput can get capped at a lower rate.app
On most Linux systems, a CPUfreq
governor manages the scaling of frequencies based on defined rules and the default ondemand
governor switches the clock frequency to maximum when the demand is high and switches to the lowest frequency when the system is idle.jvm
Do not use governors that lower the CPU frequency. To ensure optimal performance, reconfigure all CPUs to use the performance
governor, which locks the frequency at maximum. This governor will not switch frequencies, which means there will be no power savings but the servers will always run at maximum throughput. On most systems, set the governor as follows:tcp
for CPUFREQ in /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor do [ -f $CPUFREQ ] || continue echo -n performance > $CPUFREQ done
For more information, see High server load and latency when CPU frequency scaling is enabled in the DataStax Help Center.
CAUTION:
Depending on your environment, some of the following settings may not be persisted after reboot. Check with your system administrator to ensure they are viable for your environment.
The default SSD configurations on most Linux distributions are not optimal. Follow these steps to ensure the best settings for SSDs:
SysFS
rotational flag is set to false
(zero). This overrides any detection by the operating system to ensure the drive is considered an SSD.
deadline
or noop
:
noop
scheduler is the right choice when the target block device is an array of SSDs behind a high-end IO controller that performs IO optimization.readahead
value for the block device to 8 KB. This setting tells the operating system not to read extra bytes, which can increase IO time and pollute the cache with bytes that weren’t requested by the user.
For example, if the SSD is /dev/sda, in /etc/rc.local:
echo deadline > /sys/block/sda/queue/scheduler #OR... #echo noop > /sys/block/sda/queue/scheduler touch /var/lock/subsys/local echo 0 > /sys/class/block/sda/queue/rotational echo 8 > /sys/class/block/sda/queue/read_ahead_kb
The optimum readahead
setting for RAID on SSDs (in Amazon EC2) is 8KB, the same as it is for non-RAID SSDs. For details, see Optimizing SSDs.
The Linux kernel can be inconsistent in enabling/disabling zone_reclaim_mode. This can result in odd performance problems
To ensure that zone_reclaim_mode is disabled:
$ echo 0 > /proc/sys/vm/zone_reclaim_mode
For more information, see Peculiar Linux kernel performance problem on NUMA systems.
Use the ulimit -a command to view the current limits. Although limits can also be temporarily set using this command, DataStax recommends making the changes permanent:
Package and Installer-Services installations:
Ensure that the following settings are included in the /etc/security/limits.d/cassandra.conf file:
<cassandra_user> - memlock unlimited <cassandra_user> - nofile 100000 <cassandra_user> - nproc 32768 <cassandra_user> - as unlimited
Tarball and Installer-No Services installations:
: In RHEL version 6.x, ensure that the following settings are included in the /etc/security/limits.conffile:
<cassandra_user> - memlock unlimited <cassandra_user> - nofile 100000 <cassandra_user> - nproc 32768 <cassandra_user> - as unlimited
If you run DataStax Enteprise as root, some Linux distributions such as Ubuntu, require setting the limits for root explicitly instead of using cassandra_user:
root - memlock unlimited root - nofile 100000 root - nproc 32768 root - as unlimited
For RHEL 6.x-based systems, also set the nproc limits in /etc/security/limits.d/90-nproc.conf:
cassandra_user - nproc 32768
For all installations, add the following line to /etc/sysctl.conf:
vm.max_map_count = 1048575
For installations on Debian and Ubuntu operating systems, the pam_limits.so module is not enabled by default. Edit the /etc/pam.d/su file and uncomment this line:
session required pam_limits.so
This change to the PAM configuration file ensures that the system reads the files in the/etc/security/limits.d directory.To make the changes take effect, reboot the server or run the following command:
$ sudo sysctl -p
To confirm the limits are applied to the DataStax Enterprise process, run the following command where pid is the process ID of the currently running DataStax Enterprise process:
$ cat /proc/pid/limits
For more information, see Insufficient user resource limits errors.
Failure to disable swap entirely can severely lower performance. Because the database has multiple replicas and transparent failover, it is preferable for a replica to be killed immediately when memory is low rather than go into swap. This allows traffic to be immediately redirected to a functioning replica instead of continuing to hit the replica that has high latency due to swapping. If your system has a lot of DRAM, swapping still lowers performance significantly because the OS swaps out executable code so that more DRAM is available for caching disks.
If you insist on using swap, you can set vm.swappiness=1. This allows the kernel swap out the absolute least used parts.
$ sudo swapoff --all
To make this change permanent, remove all swap file entries from /etc/fstab.
For more information, see Nodes seem to freeze after some period of time.
Many modern Linux distributions ship with Transparent Hugepages enabled by default. When Linux uses Transparent Hugepages, the kernel tries to allocate memory in large chunks (usually 2MB), rather than 4K. This can improve performance by reducing the number of pages the CPU must track. However, some applications still allocate memory based on 4K pages. This can cause noticeable performance problems when Linux tries to defrag 2MB pages. For more information, see the Cassandra Java Huge Pages blog and this RedHat bug report.
To solve this problem, disable defrag for hugepages. Enter:
echo never | sudo tee /sys/kernel/mm/transparent_hugepage/defrag
For more information, including a temporary fix, see No DSE processing but high CPU usage.
The default JVM garbage collection (GC) for DataStax Enterprise 5.1 is G1.
Note: DataStax does not recommend using G1 when using Java 7. This is due to a problem with class unloading in G1. In Java 7, PermGen fills up indefinitely until a full GC is performed.
Heap size is usually between ¼ and ½ of system memory. Do not devote all memory to heap because it is also used for offheap cache and file system cache.
The easiest way to determine the optimum heap size for your environment is:
Note: This method decreases performance for the test node, but generally does not significantly reduce cluster performance.
If you don't see improved performance, contact the DataStax Services team for additional help in tuning the JVM.
There are many nuances for tuning CMS. It requires time, expertise, and repeated testing to get the best results. DataStax recommends contacting the DataStax Services team instead. Tuning Java resourcesprovides the basic information to get you started.
Typically, a readahead
of 128 is recommended.
Check to ensure setra
is not set to 65536:
sudo blockdev --report /dev/spinning_disk
To set setra:
sudo blockdev --setra 128 /dev/spinning_disk
Note: The recommended setting for RAID on SSDs is the same as that for SSDs that are not being used in a RAID installation. For details, see Optimizing SSDs.