Starting, Stopping, and Restarting API Gateway Data Store on LINUX

Elasticsearch cannot be run as the root user on a Linux system, so you must create a data store user and install and run the data store as that user.

Elasticsearch does several checks before starting up. Software AG recommends that you review the bootstrap checks and important system configuration settings before starting the data store. In particular, you may need to adjust these settings:

Check the settings for the system-wide maximum number of file descriptors (kernel parameter fs.file-max) by running the command sysctl -a | fgrep fs.file-max . If the value is less than 65536, log on as the root user and increase the value by running sysctl -w fs.file-max=200000 or echo "fs.file-max=65536" >> /etc/sysctl.conf, then activate the new value by running sysctl -p .

Check the data store user settings for the maximum number of open file descriptors by running 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 data store user and increase the value to at least 65536 by running ulimit -n 65536. To permanently save this setting for the user, run the following:

echo "user_name soft nofile 65536" >> /etc/security/limits.conf
echo "user_name hard nofile 65536" >> /etc/security/limits.conf

Check the setting for the system-wide maximum map count (kernel parametervm.max_map_count) by running the command sysctl -a | fgrepvm.max_map_count. If the value is less than 262144, log on as the rootuser and increase the value to at least 262144 by running sysctl -wvm.max_map_count=262144 or echo " vm.max_map_count=262144" >> /etc/sysctl.conf, then activate the new value by running sysctl -p.

Check the data store user settings for the maximum number of processes by running the command ulimit -u. If the value is less than 4096, log on as the data store user and increase the value to at least 4096 by running ulimit -n 4096. To permanently save this setting for the user, run the following:

echo "user_name soft nproc 4096" >> /etc/security/limits.conf
echo "user_name hard nproc 4096" >> /etc/security/limits.conf

You can start, stop, and restart API Gateway Data Store by running the following commands on LINUX: