{"record":{"id":"d0c817bb30a3d108","repo":"apache/cassandra","slug":"invalid-value-of-inter-dc-stream-throughput-outbou","errorCode":null,"errorMessage":"Invalid value of inter_dc_stream_throughput_outbound: ","messagePattern":"Invalid value of inter_dc_stream_throughput_outbound: ","errorType":"validation","errorClass":"ConfigurationException","httpStatus":null,"severity":"error","filePath":"src/java/org/apache/cassandra/config/DatabaseDescriptor.java","lineNumber":1309,"sourceCode":"        }\n        catch (IllegalArgumentException ex)\n        {\n            throw new ConfigurationException(ex.getMessage());\n        }\n    }\n\n    @VisibleForTesting\n    static void validateUpperBoundStreamingConfig() throws ConfigurationException\n    {\n        // below 2 checks are needed in order to match the pre-CASSANDRA-15234 upper bound for those parameters which were still in megabits per second\n        if (conf.stream_throughput_outbound.toMegabitsPerSecond() >= Integer.MAX_VALUE)\n        {\n            throw new ConfigurationException(\"Invalid value of stream_throughput_outbound: \" + conf.stream_throughput_outbound.toString(), false);\n        }\n\n        if (conf.inter_dc_stream_throughput_outbound.toMegabitsPerSecond() >= Integer.MAX_VALUE)\n        {\n            throw new ConfigurationException(\"Invalid value of inter_dc_stream_throughput_outbound: \" + conf.inter_dc_stream_throughput_outbound.toString(), false);\n        }\n\n        if (conf.entire_sstable_stream_throughput_outbound.toMebibytesPerSecond() >= Integer.MAX_VALUE)\n        {\n            throw new ConfigurationException(\"Invalid value of entire_sstable_stream_throughput_outbound: \" + conf.entire_sstable_stream_throughput_outbound.toString(), false);\n        }\n\n        if (conf.entire_sstable_inter_dc_stream_throughput_outbound.toMebibytesPerSecond() >= Integer.MAX_VALUE)\n        {\n            throw new ConfigurationException(\"Invalid value of entire_sstable_inter_dc_stream_throughput_outbound: \" + conf.entire_sstable_inter_dc_stream_throughput_outbound.toString(), false);\n        }\n\n        if (conf.compaction_throughput.toMebibytesPerSecond() >= Integer.MAX_VALUE)\n        {\n            throw new ConfigurationException(\"Invalid value of compaction_throughput: \" + conf.compaction_throughput.toString(), false);\n        }\n    }\n","sourceCodeStart":1291,"sourceCodeEnd":1327,"githubUrl":"https://github.com/apache/cassandra/blob/88fd0f6a0eaed8943f05ac9e8f947882b8ddc8f1/src/java/org/apache/cassandra/config/DatabaseDescriptor.java#L1291-L1327","documentation":"validateUpperBoundStreamingConfig enforces the same int-sized upper bound for inter-dc streaming: inter_dc_stream_throughput_outbound converted to megabits per second must be < Integer.MAX_VALUE. DatabaseDescriptor throws this ConfigurationException otherwise.","triggerScenarios":"DatabaseDescriptor static initialization with inter_dc_stream_throughput_outbound >= 2147483647 megabits per second in cassandra.yaml.","commonSituations":"Unit mistake producing an astronomically large inter-DC throttle value; copy-paste of stream_throughput_outbound with a wrong magnitude.","solutions":["Set inter_dc_stream_throughput_outbound to a realistic rate below Integer.MAX_VALUE megabits per second","Verify the duration/rate unit suffix in cassandra.yaml"],"exampleFix":"// before (cassandra.yaml)\ninter_dc_stream_throughput_outbound: 2147483647Mb/s\n// after\ninter_dc_stream_throughput_outbound: 50MiB/s","handlingStrategy":"validation","validationCode":"if (conf.inter_dc_stream_throughput_outbound.toMegabitsPerSecond() >= Integer.MAX_VALUE) throw new IllegalArgumentException(\"inter_dc_stream_throughput_outbound too large\");","typeGuard":null,"tryCatchPattern":"try { DatabaseDescriptor.daemonInitialization(); } catch (ConfigurationException e) { log.error(e.getMessage()); }","preventionTips":["Set inter-DC throughput with realistic values and explicit unit suffixes","Keep inter_dc_stream_throughput_outbound proportional to stream_throughput_outbound"],"tags":["cassandra","configuration","streaming"],"backgroundTag":"value-out-of-range","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"}