{"record":{"id":"65fe75c7f6caf0f5","repo":"apache/cassandra","slug":"configured-configname-intf-caused-an-excep","errorCode":null,"errorMessage":"Configured ${configName} \"${intf}\" caused an exception","messagePattern":"Configured (.+?) \"(.+?)\" caused an exception","errorType":"exception","errorClass":"ConfigurationException","httpStatus":null,"severity":"critical","filePath":"src/java/org/apache/cassandra/config/DatabaseDescriptor.java","lineNumber":562,"sourceCode":"            if (!addrs.hasMoreElements())\n                throw new ConfigurationException(\"Configured \" + configName + \" \\\"\" + intf + \"\\\" was found, but had no addresses\", false);\n\n            /*\n             * Try to return the first address of the preferred type, otherwise return the first address\n             */\n            InetAddress retval = null;\n            while (addrs.hasMoreElements())\n            {\n                InetAddress temp = addrs.nextElement();\n                if (preferIPv6 && temp instanceof Inet6Address) return temp;\n                if (!preferIPv6 && temp instanceof Inet4Address) return temp;\n                if (retval == null) retval = temp;\n            }\n            return retval;\n        }\n        catch (SocketException e)\n        {\n            throw new ConfigurationException(\"Configured \" + configName + \" \\\"\" + intf + \"\\\" caused an exception\", e);\n        }\n    }\n\n    @VisibleForTesting\n    public static void setConfig(Config config)\n    {\n        conf = config;\n    }\n\n    private static void applyAll() throws ConfigurationException\n    {\n        applyCompatibilityMode();\n\n        applySSTableFormats();\n\n        applyCompressorProviders();\n\n        applyCryptoProvider();","sourceCodeStart":544,"sourceCodeEnd":580,"githubUrl":"https://github.com/apache/cassandra/blob/88fd0f6a0eaed8943f05ac9e8f947882b8ddc8f1/src/java/org/apache/cassandra/config/DatabaseDescriptor.java#L544-L580","documentation":"While resolving the configured interface's addresses, a java.net.SocketException was raised (e.g. I/O error querying the network stack); DatabaseDescriptor wraps it in a ConfigurationException indicating the interface caused an exception.","triggerScenarios":"NetworkInterface.getInetAddresses() throwing SocketException during DatabaseDescriptor initialization — caused by network stack issues, restricted /proc or namespace permissions, or unusual socket state on the host.","commonSituations":"Containers with restricted network namespaces, SELinux/AppArmor restrictions, or hosts with broken virtual networking (docker/veth issues) at Cassandra startup.","solutions":["Check the wrapped SocketException cause in the stack trace for the underlying OS error","Verify the host network stack is healthy ('ip addr', 'ip link') and restart networking if needed","Bypass interface resolution by using explicit listen_address/rpc_address IPs in cassandra.yaml"],"exampleFix":"# before\nlisten_interface: eth0\n# after\nlisten_address: 10.0.0.5","handlingStrategy":"try-catch","validationCode":"try { NetworkInterface.getByName(intf).getInetAddresses(); } catch (SocketException e) { log.error(\"network stack query failed for {}: {}\", intf, e); }","typeGuard":null,"tryCatchPattern":"catch (ConfigurationException e) { if (e.getCause() instanceof SocketException) { log.error(\"network stack failure on {}\", intf, e.getCause()); } throw e; }","preventionTips":["Inspect the wrapped cause for the OS-level socket error","Check SELinux/AppArmor and container network permissions","Fall back to explicit address configuration when interface enumeration is unreliable"],"tags":["cassandra","config","network","socket"],"backgroundTag":"network-request-failed","analyzedSha":"88fd0f6a0eaed8943f05ac9e8f947882b8ddc8f1","analyzedAt":"2026-09-10T07:29:22.284Z","contentChangedAt":"2026-09-10T07:29:22.284Z","schemaVersion":2},"datasetVersion":"2026-09-14T16:17:12.679Z"}