Prepare for webMethods API Gateway and webMethods Developer Portal (Linux System)

webMethods API Gateway and webMethods Developer Portal come with a data store, called API Data Store, in which they store core data, events, and metrics. The data store uses Elasticsearch 8.2.3. 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. IBM 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 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 | fgrep vm.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 -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.
• 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