{"record":{"id":"852467f7cacb61a5","repo":"hashicorp/nomad","slug":"all-servers-must-have-raft-protocol-set-to-3-or-hi","errorCode":null,"errorMessage":"all servers must have raft_protocol set to 3 or higher to use this endpoint","messagePattern":"all servers must have raft_protocol set to 3 or higher to use this endpoint","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"nomad/operator_endpoint.go","lineNumber":409,"sourceCode":"\tif authErr != nil {\n\t\treturn structs.ErrPermissionDenied\n\t}\n\n\t// This action requires operator read access.\n\taclObj, err := op.srv.ResolveACL(args)\n\tif err != nil {\n\t\treturn err\n\t} else if !aclObj.AllowOperatorRead() {\n\t\treturn structs.ErrPermissionDenied\n\t}\n\n\t// Exit early if the min Raft version is too low\n\tminRaftProtocol, err := op.srv.MinRaftProtocol()\n\tif err != nil {\n\t\treturn fmt.Errorf(\"error getting server raft protocol versions: %s\", err)\n\t}\n\tif minRaftProtocol < 3 {\n\t\treturn fmt.Errorf(\"all servers must have raft_protocol set to 3 or higher to use this endpoint\")\n\t}\n\n\t*reply = *op.srv.GetClusterHealth()\n\n\treturn nil\n}\n\n// SchedulerSetConfiguration is used to set the current Scheduler configuration.\nfunc (op *Operator) SchedulerSetConfiguration(args *structs.SchedulerSetConfigRequest, reply *structs.SchedulerSetConfigurationResponse) error {\n\n\tauthErr := op.srv.Authenticate(op.ctx, args)\n\tif done, err := op.srv.forward(\"Operator.SchedulerSetConfiguration\", args, args, reply); done {\n\t\treturn err\n\t}\n\top.srv.MeasureRPCRate(\"operator\", structs.RateMetricWrite, args)\n\tif authErr != nil {\n\t\treturn structs.ErrPermissionDenied\n\t}","sourceCodeStart":391,"sourceCodeEnd":427,"githubUrl":"https://github.com/hashicorp/nomad/blob/482b49bf1aec006f089bcfc7e632d8f6ac303e5e/nomad/operator_endpoint.go#L391-L427","documentation":"ServerHealth rejected the request because the minimum Raft protocol version in the cluster is below 3; the health endpoint relies on features that require raft_protocol 3+ on every server.","triggerScenarios":"Thrown at nomad/operator_endpoint.go:409 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Upgrade all servers so raft_protocol is 3 or higher","Set `raft_protocol = 3` in server configs where applicable and restart","Retry once the peers cache reflects the upgraded protocol versions"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"482b49bf1aec006f089bcfc7e632d8f6ac303e5e","analyzedAt":"2026-09-04T07:54:14.808Z","contentChangedAt":"2026-09-04T07:54:14.808Z","schemaVersion":2},"datasetVersion":"2026-09-08T10:18:20.063Z"}