执行Magento安装命令遇OpenSearch连接错误，求排查原因

Here are the key checks to resolve the connection issue between Magento and OpenSearch during installation:

• Verify OpenSearch Host and Port Accuracy

  • Double-check the --opensearch-host value (os-host.example.com). If OpenSearch runs on the same server as Magento, replace this with localhost or the server’s internal IP address.
  • Confirm the --opensearch-port (9200) matches the port configured in OpenSearch’s opensearch.yml file (default is 9200 for HTTP, 9201 for HTTPS).
  • Test connectivity from the Magento server with this command:

    curl http://os-host.example.com:9200
    

    A successful response returns JSON data with cluster details.

• Ensure OpenSearch Service is Running

  • Check if the OpenSearch service is active on its host:

    sudo systemctl status opensearch
    

  • If inactive, start or restart the service:

    sudo systemctl start opensearch
    # Restart if unresponsive
    sudo systemctl restart opensearch
    

  • Wait 1-2 minutes for the service to fully initialize before re-running the Magento install command.

• Check Firewall and Network Rules

  • On the OpenSearch server, open port 9200 to incoming connections from the Magento server. For UFW:

    sudo ufw allow from <magento-server-ip> to any port 9200
    sudo ufw reload
    

  • For cloud hosting (AWS, Azure, etc.), verify security groups or ACLs allow traffic between the two servers on port 9200.

• Validate OpenSearch Cluster Configuration

  • Open /etc/opensearch/opensearch.yml and check these settings:
    • network.host: Set to a value accessible by Magento (e.g., 0.0.0.0 for all interfaces, or the server’s public/private IP). Avoid localhost if Magento is on a different server.
    • discovery.type: For single-node clusters (common in development), set to single-node to prevent OpenSearch from waiting for other cluster nodes.
  • Save changes and restart OpenSearch if modifications are made.

• Check for Authentication or SSL Requirements

  • If OpenSearch uses basic authentication, add these flags to your install command:

    --opensearch-username=<your-opensearch-username> --opensearch-password=<your-opensearch-password>
    

  • If using HTTPS, update the port to 9201 (default SSL port) and add:

    --opensearch-enable-ssl=1
    

• Adjust Connection Timeout

  • The current timeout is 15 seconds. If connections are slow, increase this value:

    --opensearch-timeout=30
    

After resolving any identified issues, re-run your Magento install command.

内容的提问来源于stack exchange，提问作者Madhab Karmaker