Connect Easysearch to Kibana in Two Simple Steps

Background

Kibana checks the Elasticsearch version string; Easysearch reports versions like 1.x.x or 2.x.x, causing Kibana to reject the connection with the error "Unable to retrieve version information from Elasticsearch nodes".

Environment

INFINI Easysearch 2.x.x at 192.168.147.130:9200 Kibana OSS 7.10.2 at 192.168.147.130:5601 (OSS edition required)

Step 1 – Enable version compatibility in Easysearch

Edit easysearch.yml and append the following lines:

# Enable ES API compatibility mode
elasticsearch.api_compatibility: true
# Pretend to be ES 7.10.2
elasticsearch.api_compatibility_version: "7.10.2"

Restart Easysearch and verify with curl:

curl -ku admin:YOUR_PASSWORD https://192.168.147.130:9200

The response should contain "number" : "7.10.2", confirming the version mask is active.

Step 2 – Configure Kibana

Edit config/kibana.yml with the essential settings:

# Kibana listening port and host
server.port: 5601
server.host: "192.168.147.130"

# Point to Easysearch (HTTPS required)
elasticsearch.hosts: ["https://192.168.147.130:9200"]

# Easysearch credentials
elasticsearch.username: "admin"
elasticsearch.password: "changeme"

# Disable SSL verification for testing (use proper certificates in production)
elasticsearch.ssl.verificationMode: none

Start Kibana:

./bin/kibana --allow-root

If the log shows [info][listening] Server running at http://0.0.0.0:5601, Kibana is up.

Verification

Open a browser at http://192.168.147.130:5601, go to Dev Tools → Console and run a simple query:

GET _search
{
  "query": { "match_all": {} }
}

The query succeeds, confirming the connection. In Stack Management the UI displays "Welcome to Stack Management 7.10.2", showing that Kibana fully recognizes the masqueraded version.

Common pitfalls

Kibana must be the OSS edition. The commercial version enforces stricter license checks that block Easysearch.

SSL verification. If Easysearch uses a self‑signed certificate, set elasticsearch.ssl.verificationMode: none (or configure proper certificates for production).

Special characters in passwords. Characters such as #, &, ^ must be wrapped in double quotes in the YAML file, otherwise parsing fails.

Summary

The essential configuration consists of two lines in easysearch.yml that make Easysearch present itself as Elasticsearch 7.10.2 at the API level, allowing Kibana OSS to interact transparently for data queries and index management.

elasticsearch.api_compatibility: true
elasticsearch.api_compatibility_version: "7.10.2"