Analytics: Resolving "Bootstrap checks failed" error

Question & Answer

Question

The API Connect v2018.x Analytics pod may crash if map counts are not set to correct values.

Answer

IBM On Demand Consulting
Author: Sila Kissuu

A common error message that you might see looks like this:

User-added image

To resolve this error, make sure that the vm.max_map_count environment variable is set to 262144.

On Kubernetes, this error typically occurs when vm.max_mapcount is too low. See https://www.ibm.com/support/knowledgecenter/en/SSMNED_2018/com.ibm.apic.install.doc/tapic_install_Kubernetes.html

It states:

"The Analytics service depends on ElasticSearch which requires map counts higher than the operating system defaults. To change the map counts on the live system, run sudo sysctl -w vm.max_map_count=262144 on each Kubernetes node. To persist this change when node restarts occur, add the following to the /etc/sysctl.conf file: vm.max_map_count = 262144. This is the minimum recommended value. For more information see https://www.elastic.co/guide/en/elasticsearch/reference/current/vm-max-map-count.html"

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSQTW3","label":"IBM On Demand Consulting for Hybrid Cloud"},"Component":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"","label":""}}]

Was this topic helpful?

Document Information

More support for:
IBM On Demand Consulting for Hybrid Cloud

Software version:
All Versions

Document number:
748681

Modified date:
08 December 2018

UID

ibm10748681

IBM Support

Tips