{"record":{"id":"4bec84c447af4e5c","repo":"apache/cassandra","slug":"entire-sstable-inter-dc-stream-throughput-outbound-4bec84","errorCode":null,"errorMessage":"entire_sstable_inter_dc_stream_throughput_outbound: %s is too large","messagePattern":"entire_sstable_inter_dc_stream_throughput_outbound: (.+?) is too large","errorType":"validation","errorClass":"ConfigurationException","httpStatus":null,"severity":"error","filePath":"tools/sstableloader/src/org/apache/cassandra/tools/LoaderOptions.java","lineNumber":513,"sourceCode":"                    // 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 (config.stream_throughput_outbound.toMegabitsPerSecond() >= Integer.MAX_VALUE)\n                    {\n                        throw new ConfigurationException(\"stream_throughput_outbound: \" + config.stream_throughput_outbound.toString() + \" is too large\", false);\n                    }\n\n                    if (config.inter_dc_stream_throughput_outbound.toMegabitsPerSecond() >= Integer.MAX_VALUE)\n                    {\n                        throw new ConfigurationException(\"inter_dc_stream_throughput_outbound: \" + config.inter_dc_stream_throughput_outbound.toString() + \" is too large\", false);\n                    }\n\n                    if (config.entire_sstable_stream_throughput_outbound.toMebibytesPerSecond() >= Integer.MAX_VALUE)\n                    {\n                        throw new ConfigurationException(\"entire_sstable_stream_throughput_outbound: \" + config.entire_sstable_stream_throughput_outbound.toString() + \" is too large\", false);\n                    }\n\n                    if (config.entire_sstable_inter_dc_stream_throughput_outbound.toMebibytesPerSecond() >= Integer.MAX_VALUE)\n                    {\n                        throw new ConfigurationException(\"entire_sstable_inter_dc_stream_throughput_outbound: \" + config.entire_sstable_inter_dc_stream_throughput_outbound.toString() + \" is too large\", false);\n                    }\n                }\n                else\n                {\n                    config = new Config();\n                    // unthrottle stream by default\n                    config.stream_throughput_outbound = new DataRateSpec.LongBytesPerSecondBound(0);\n                    config.inter_dc_stream_throughput_outbound = new DataRateSpec.LongBytesPerSecondBound(0);\n                    config.entire_sstable_stream_throughput_outbound = new DataRateSpec.LongBytesPerSecondBound(0);\n                    config.entire_sstable_inter_dc_stream_throughput_outbound = new DataRateSpec.LongBytesPerSecondBound(0);\n                }\n\n                if (cmd.hasOption(STORAGE_PORT_OPTION))\n                    storagePort = Integer.parseInt(cmd.getOptionValue(STORAGE_PORT_OPTION));\n                else\n                    storagePort = config.storage_port;\n\n                if (cmd.hasOption(IGNORE_NODES_OPTION))","sourceCodeStart":495,"sourceCodeEnd":531,"githubUrl":"https://github.com/apache/cassandra/blob/88fd0f6a0eaed8943f05ac9e8f947882b8ddc8f1/tools/sstableloader/src/org/apache/cassandra/tools/LoaderOptions.java#L495-L531","documentation":"Guard on the cross-datacenter entire-sstable streaming throttle: if entire_sstable_inter_dc_stream_throughput_outbound converts to >= Integer.MAX_VALUE mebibytes per second, LoaderOptions.Builder throws ConfigurationException 'entire_sstable_inter_dc_stream_throughput_outbound: <value> is too large'. See tools/sstableloader/src/org/apache/cassandra/tools/LoaderOptions.java:513.","triggerScenarios":"sstableloader loading a cassandra.yaml where entire_sstable_inter_dc_stream_throughput_outbound is set above the int bound in MiB/s — a config value error detected during option building.","commonSituations":"Typo'd or machine-generated extreme values in cassandra.yaml; unit confusion (Mbps vs MiB/s) when migrating configs across Cassandra versions.","solutions":["Set entire_sstable_inter_dc_stream_throughput_outbound to a realistic rate or remove/null it in cassandra.yaml","Audit the whole throughput block of cassandra.yaml for unit mistakes","Point sstableloader at the correct --conf-path"],"exampleFix":"// before (cassandra.yaml)\nentire_sstable_inter_dc_stream_throughput_outbound: 123456789012MiB/s\n// after\nentire_sstable_inter_dc_stream_throughput_outbound: 50MiB/s","handlingStrategy":"validation","validationCode":"// pre-check config\n// grep entire_sstable_inter_dc_stream_throughput_outbound $CONF/cassandra.yaml\n// value should be a sane MiB/s rate or 0/null to disable","typeGuard":null,"tryCatchPattern":"try {\n    options = new LoaderOptions.Builder(dirs, args).build();\n} catch (ConfigurationException e) {\n    if (e.getMessage().startsWith(\"entire_sstable_inter_dc_stream_throughput_outbound\")) {\n        // fix the yaml value and retry\n    }\n    throw e;\n}","preventionTips":["Keep inter-DC entire-sstable throttle values realistic and unit-correct","Audit all four stream-throughput keys in cassandra.yaml together","Don't paste values between differently-typed throughput fields","Pin a known-good config via --conf-path"],"tags":["config","yaml","sstableloader"],"backgroundTag":"invalid-config-value","analyzedSha":"88fd0f6a0eaed8943f05ac9e8f947882b8ddc8f1","analyzedAt":"2026-09-10T07:29:22.284Z","contentChangedAt":"2026-09-10T07:29:22.284Z","schemaVersion":2},"datasetVersion":"2026-09-17T15:17:12.973Z"}