{"record":{"id":"291978aa3639b84a","repo":"apache/cassandra","slug":"parameters-have-been-deprecated-they-have-new","errorCode":null,"errorMessage":"{} parameters have been deprecated. They have new names and/or value format; For more information, please refer to NEWS.txt","messagePattern":"(.+?) parameters have been deprecated\\. They have new names and/or value format; For more information, please refer to NEWS\\.txt","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"src/java/org/apache/cassandra/config/YamlConfigurationLoader.java","lineNumber":563,"sourceCode":"                    root = null;\n                    break;\n                }\n                root = root == null ? prop : Properties.andThen(root, prop);\n                type = root.getType();\n            }\n            return root != null ? root : new MissingProperty(name);\n        }\n\n        public void check() throws ConfigurationException\n        {\n            if (!nullProperties.isEmpty())\n                throw new ConfigurationException(\"Invalid yaml. Those properties \" + nullProperties + \" are not valid\", false);\n\n            if (!missingProperties.isEmpty())\n                throw new ConfigurationException(\"Invalid yaml. Please remove properties \" + missingProperties + \" from your cassandra.yaml\", false);\n\n            if (!deprecationWarnings.isEmpty())\n                logger.warn(\"{} parameters have been deprecated. They have new names and/or value format; For more information, please refer to NEWS.txt\", deprecationWarnings);\n        }\n    }\n\n    public static LoaderOptions getDefaultLoaderOptions()\n    {\n        LoaderOptions loaderOptions = new LoaderOptions();\n        loaderOptions.setCodePointLimit(64 * 1024 * 1024); // 64 MiB\n        loaderOptions.setWarnOnDuplicateKeys(false);\n        return loaderOptions;\n    }\n}\n","sourceCodeStart":545,"sourceCodeEnd":575,"githubUrl":"https://github.com/apache/cassandra/blob/88fd0f6a0eaed8943f05ac9e8f947882b8ddc8f1/src/java/org/apache/cassandra/config/YamlConfigurationLoader.java#L545-L575","documentation":"Cassandra's YamlConfigurationLoader warns when cassandra.yaml contains parameters that have been renamed or had their value format changed between releases. The deprecated names are still mapped internally, but operators should migrate to the new names. The authoritative list of renames is in NEWS.txt for the target version.","triggerScenarios":"Starting Cassandra (or loading config via Config.load) with a cassandra.yaml that still lists pre-4.x property names (e.g. commitlog_sync_period_in_ms, endpoint_snitch formats, changed timeout keys) so PropertiesChecker flags them as deprecationWarnings.","commonSituations":"Upgrading Cassandra in place while carrying over an old cassandra.yaml; copying a yaml from an older cluster; following outdated tutorials or Helm charts with legacy config keys.","solutions":["Check the logged list of deprecated parameters and rename each to its new name per NEWS.txt for your Cassandra version","Diff your cassandra.yaml against conf/cassandra.yaml shipped with the new version and adopt the current keys","Restart and confirm the warning no longer appears in the log"],"exampleFix":"// before (old yaml)\ncommitlog_sync_period_in_ms: 10000\n// after (renamed per NEWS.txt)\ncommitlog_sync_period: 10000ms","handlingStrategy":"validation","validationCode":"// Before deploying cassandra.yaml, grep for known-removed keys\nconst REMOVED = ['commitlog_sync_period_in_ms','read_request_timeout_in_ms'];\nconst deprecated = REMOVED.filter(k => yamlText.includes(k));\nif (deprecated.length) throw new Error('Deprecated yaml keys: ' + deprecated.join(','));","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Keep cassandra.yaml regenerated from the conf/ template of your target version on each upgrade","Automate a config-lint step in deployment that checks NEWS.txt renames","Track Cassandra upgrade notes for renamed config parameters"],"tags":["configuration","deprecation","yaml"],"backgroundTag":"deprecated-api-usage","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"}