Prepare for Internal Data Store Installation (Linux System)
Internal Data Store uses Elasticsearch 5.6.4. Elasticsearch cannot be run as the root user on a Linux system, so you must create an Internal Data Store user and install and run the Internal Data Store as that user.
Elasticsearch does several checks before starting up. Software AG recommends that you review the bootstrap checks (search on "Elasticsearch bootstrap checks") and important system configuration settings (search on "Elasticsearch important system configuration") before starting the Internal Data Store. In particular, you may need to adjust these settings:
1. Check the setting for the system-wide maximum number of file descriptors (kernel parameter fs.file-max) by executing the command sysctl -a | fgrep fs.filemax. If the value is less than 65536, log on as the root user and increase the value to at least 65536 by executing sysctl -w fs.file-max=65536 or echo "fs.file-max=65536" >> /etc/sysctl.conf, then activate the new value by executing sysctl -p.
2. Check the Internal Data Store user settings for the maximum number of open file descriptors by executing the commands ulimit -Hn and ulimit -Sn, where -Hn is the hard limit and -Sn is the soft limit. If the value is less than 65536, log on as the Internal Data Store user and increase the value to at least 65536 by executing ulimit -n 65536. To permanently save this setting for the user, execute:
echo "user_name soft nofile 65563" >> /etc/security/limits.conf
echo "user_name hard nofile 65536" >> /etc/security/limits.conf
3. Check the setting for the system-wide maximum map count (kernel parameter vm.max_map_count) by executing the command sysctl -a | fgrep vm.max_map_count. If the value is less than 262144, log on as the root user and increase the value to at least 262144 by executing sysctl -w vm.max_map_count=262144 or echo " vm.max_map_count=262144" >> /etc/sysctl.conf, then activate the new value by executing sysctl -p.
4. Check the Internal Data Store user settings for the maximum number of processes by executing the command ulimit -u. If the value is less than 4096, log on as the Internal Data Store user and increase the value to at least 4096 by executing ulimit -n 4096. To permanently save this setting for the user, execute:
echo "user_name soft nproc 4096" >> /etc/security/limits.conf
echo "user_name hard nproc 4096" >> /etc/security/limits.conf