Capsule server installation fails with error: 'Error: Unable to communicate with the Capsule: ERF12-2530 [ProxyAPI::ProxyException]: Unable to detect features ([RestClient::Exceptions::OpenTimeout]: Timed out connecting to server).

Solution Verified - Updated

Environment

  • Red Hat Satellite 6

Issue

  • Capsule server installation failed and the following logs have been observed in /var/log/foreman-installer/capsule.log :

     Proxy capsule.example.com cannot be registered: Unable to communicate with the Capsule: ERF12-2530 [ProxyAPI::ProxyException]: Unable to detect features ([RestClient::Exceptions::OpenTimeout]: Timed out connecting to server) for Capsule https://capsule.example.com:9090/features Please check the Capsule is configured and running on the host.

Resolution

  • Make sure the port number 9090 is open on the Capsule server.

     # firewall-cmd --list-all
 # firewall-cmd --add-port="9090/tcp"
 # firewall-cmd --runtime-to-permanent

  • Refer to the documentation.

  • In case a proxy is used between the Satellite and the Capsule, ensure it is properly configured in Administer -> Settings -> HTTP(S) proxy

  • Connectivity issues between the satellite and to capsule over port 9090 may also result in a similar failure. Hence check internally in your organization to fix this issue.

  • For more KB articles/solutions related to Red Hat Satellite 6.x Installation/Upgrade/Update Issues, please refer to the Red Hat Satellite Consolidated Troubleshooting Article for Red Hat Satellite 6.x Installation/Upgrade/Update Issues.

Root Cause

  • Port 9090 was not opened with firewalld on Red Hat Capsule server.
  • Connectivity issue between satellite and capsule.

Diagnostic Steps

  • Check port 9090 is enabled on the Capsule server using the below command :

     # firewall-cmd --list-all

  • Check connectivity between the Red Hat Satellite and Capsule by running the below command:

    # echo|openssl s_client -connect capsule-server-ip:9090      [ Replace capsule-server-ip with the ip for the capsule server ]
socket: Bad file descriptor
connect:errno=9

  • From the Red Hat Satellite server:

        # nc -v capsule.example.com 443  

    # nc -v capsule.example.com 9090

  • From the External Capsule server:

        # nc -v satellite.example.com 443

    # nc -v satellite.example.com 9090
SBR
Product(s)
Components
Category
Tags

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.