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

API Gateway Data store uses Elasticsearch 7.2.0. 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 executing 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 executing sysctl -w fs.file-max=200000 or echo "fs.file-max=65536" >> /etc/sysctl.conf, then activate the new value by executing sysctl -p .

Check the 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 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 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 executing 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 executing sysctl -wvm.max_map_count=262144 or echo " vm.max_map_count=262144" >> /etc/sysctl.conf, then activate the new value by executing sysctl -p.

Check the 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 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 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: