[CircleCI Generated] generate-scheduled-9401

site/content/3.12/release-notes/version-3.12/whats-new-in-3-12.md

@@ -1061,6 +1061,16 @@ small requests.
 Compression for all Agency traffic is disabled regardless of the settings
 of these options.
 
+### Read-only shards metric
+
+<small>Introduced in: v3.12.1</small>
+
+The following cluster health metric has been added:
+
+| Label | Description |
+|:------|:------------|
+| `arangodb_vocbase_shards_read_only_by_write_concern` | Number of shards that are read-only due to an undercut of the write concern. |
+
 ## Client tools
 
 ### Protocol aliases for endpoints

site/content/3.13/release-notes/version-3.12/whats-new-in-3-12.md

@@ -1061,6 +1061,16 @@ small requests.
 Compression for all Agency traffic is disabled regardless of the settings
 of these options.
 
+### Read-only shards metric
+
+<small>Introduced in: v3.12.1</small>
+
+The following cluster health metric has been added:
+
+| Label | Description |
+|:------|:------------|
+| `arangodb_vocbase_shards_read_only_by_write_concern` | Number of shards that are read-only due to an undercut of the write concern. |
+
 ## Client tools
 
 ### Protocol aliases for endpoints

site/data/3.10/arangod.json

@@ -1109,7 +1109,7 @@
       "agent",
       "single"
     ],
-    "default" : 7739682816,
+    "default" : 7739681792,
     "deprecatedIn" : null,
     "description" : "The global size limit for all caches (in bytes).",
     "dynamic" : true,
@@ -1992,7 +1992,7 @@
       "agent",
       "single"
     ],
-    "default" : "/var/lib/arangodb3",
+    "default" : "",
     "deprecatedIn" : null,
     "description" : "The path to the database directory.",
     "dynamic" : false,
@@ -3100,7 +3100,7 @@
       "coordinator",
       "single"
     ],
-    "default" : "/var/lib/arangodb3-apps",
+    "default" : "./js/apps",
     "deprecatedIn" : null,
     "description" : "The directory for Foxx applications.",
     "dynamic" : false,
@@ -3398,6 +3398,7 @@
       "single"
     ],
     "default" : [
+      "./enterprise/js"
     ],
     "deprecatedIn" : null,
     "description" : "Additional paths containing JavaScript modules.",
@@ -3476,7 +3477,7 @@
       "coordinator",
       "single"
     ],
-    "default" : "/usr/share/arangodb3/js",
+    "default" : "./js",
     "deprecatedIn" : null,
     "description" : "A path to the directory containing the JavaScript startup scripts.",
     "dynamic" : false,
@@ -5866,7 +5867,7 @@
       "agent",
       "single"
     ],
-    "default" : "-",
+    "default" : "",
     "deprecatedIn" : null,
     "description" : "shortcut for '--log.output file://<filename>'",
     "dynamic" : false,
@@ -7273,15 +7274,15 @@
     "type" : "boolean"
   },
   "query.global-memory-limit" : {
-    "base" : 33106214912,
+    "base" : 33106210816,
     "category" : "option",
     "component" : [
       "coordinator",
       "dbserver",
       "agent",
       "single"
     ],
-    "default" : 26816034078,
+    "default" : 26816030761,
     "deprecatedIn" : null,
     "description" : "The memory threshold for all AQL queries combined (in bytes, 0 = no limit).",
     "dynamic" : true,
@@ -7539,15 +7540,15 @@
     "type" : "double"
   },
   "query.memory-limit" : {
-    "base" : 33106214912,
+    "base" : 33106210816,
     "category" : "option",
     "component" : [
       "coordinator",
       "dbserver",
       "agent",
       "single"
     ],
-    "default" : 19863728947,
+    "default" : 19863726489,
     "deprecatedIn" : null,
     "description" : "The memory threshold per AQL query (in bytes, 0 = no limit).",
     "dynamic" : true,
@@ -8659,7 +8660,7 @@
       "agent",
       "single"
     ],
-    "default" : 9287619379,
+    "default" : 9287618150,
     "deprecatedIn" : null,
     "description" : "The size of block cache (in bytes).",
     "dynamic" : true,
@@ -11006,7 +11007,7 @@
       "agent",
       "single"
     ],
-    "default" : 12383492505,
+    "default" : 12383490867,
     "deprecatedIn" : null,
     "description" : "The maximum total size of in-memory write buffers (0 = unbounded).",
     "dynamic" : true,

site/data/3.11/arangod.json

@@ -1400,7 +1400,7 @@
       "agent",
       "single"
     ],
-    "default" : 7739682816,
+    "default" : 7739683840,
     "deprecatedIn" : null,
     "description" : "The global size limit for all caches (in bytes).",
     "dynamic" : true,
@@ -7518,15 +7518,15 @@
     "type" : "boolean"
   },
   "query.global-memory-limit" : {
-    "base" : 33106214912,
+    "base" : 33106219008,
     "category" : "option",
     "component" : [
       "coordinator",
       "dbserver",
       "agent",
       "single"
     ],
-    "default" : 26816034078,
+    "default" : 26816037397,
     "deprecatedIn" : null,
     "description" : "The memory threshold for all AQL queries combined (in bytes, 0 = no limit).",
     "dynamic" : true,
@@ -7816,15 +7816,15 @@
     "type" : "double"
   },
   "query.memory-limit" : {
-    "base" : 33106214912,
+    "base" : 33106219008,
     "category" : "option",
     "component" : [
       "coordinator",
       "dbserver",
       "agent",
       "single"
     ],
-    "default" : 19863728947,
+    "default" : 19863731405,
     "deprecatedIn" : null,
     "description" : "The memory threshold per AQL query (in bytes, 0 = no limit).",
     "dynamic" : true,
@@ -9059,7 +9059,7 @@
       "agent",
       "single"
     ],
-    "default" : 9287619379,
+    "default" : 9287620608,
     "deprecatedIn" : null,
     "description" : "The size of block cache (in bytes).",
     "dynamic" : true,
@@ -11640,7 +11640,7 @@
       "agent",
       "single"
     ],
-    "default" : 12383492505,
+    "default" : 12383494144,
     "deprecatedIn" : null,
     "description" : "The maximum total size of in-memory write buffers (0 = unbounded).",
     "dynamic" : true,

site/data/3.12/allMetrics.yaml

@@ -5928,6 +5928,29 @@
     by a server option. V8 contexts are created and destroyed as needed
     but there are never fewer than the limit shown in this metric.
 
+- name: arangodb_vocbase_shards_read_only_by_write_concern
+  introducedIn: "3.12.1"
+  help: |
+    Number of shards that are read-only due to an undercut of the write concern.
+  unit: number
+  type: gauge
+  category: Replication
+  complexity: simple
+  exposedBy:
+    - dbserver
+  description: |
+    Number of shards that are in read-only mode because there are not at least write concern many in-sync replicas.
+  troubleshoot: |
+    If this metrics has a value greater than 0, then some
+    action is indicated. During an upgrade or when some DB-Server was
+    restarted, it can happen that shard followers are out of sync and thus
+    the write concern is undercut. Normally, shards should get in sync on
+    their own, so observation and waiting is a good measure at first.
+    However, if the situation persists, something is wrong, potentially
+    some constant server crash (maybe out of memory crashes?) or another
+    situation preventing shards to get in sync.
+    Contact ArangoDB customer support in this case.
+
 - name: rocksdb_actual_delayed_write_rate
   introducedIn: "3.6.1"
   help: |

site/data/3.12/arangobackup.json

@@ -1036,7 +1036,7 @@
   },
   "server.authentication" : {
     "category" : "option",
-    "default" : false,
+    "default" : true,
     "deprecatedIn" : null,
     "description" : "Require authentication credentials when connecting (does not affect the server-side authentication settings).",
     "dynamic" : false,
@@ -1100,7 +1100,7 @@
   "server.endpoint" : {
     "category" : "option",
     "default" : [
-      "http+tcp://127.0.0.1:8529"
+      "tcp://127.0.0.1:8529"
     ],
     "deprecatedIn" : null,
     "description" : "The endpoint to connect to. Use 'none' to start without a server. Use http+ssl:// as schema to connect to an SSL-secured server endpoint, otherwise http+tcp:// or unix://",

site/data/3.12/arangobench.json

@@ -1341,7 +1341,7 @@
   },
   "server.authentication" : {
     "category" : "option",
-    "default" : false,
+    "default" : true,
     "deprecatedIn" : null,
     "description" : "Require authentication credentials when connecting (does not affect the server-side authentication settings).",
     "dynamic" : false,
@@ -1405,7 +1405,7 @@
   "server.endpoint" : {
     "category" : "option",
     "default" : [
-      "http+tcp://127.0.0.1:8529"
+      "tcp://127.0.0.1:8529"
     ],
     "deprecatedIn" : null,
     "description" : "The endpoint to connect to. Use 'none' to start without a server. Use http+ssl:// as schema to connect to an SSL-secured server endpoint, otherwise http+tcp:// or unix://",

site/data/3.12/arangod.json

@@ -2280,7 +2280,7 @@
       "agent",
       "single"
     ],
-    "default" : "",
+    "default" : "/var/lib/arangodb3",
     "deprecatedIn" : null,
     "description" : "The path to the database directory.",
     "dynamic" : false,
@@ -3435,7 +3435,7 @@
       "coordinator",
       "single"
     ],
-    "default" : "./js/apps",
+    "default" : "/var/lib/arangodb3-apps",
     "deprecatedIn" : null,
     "description" : "The directory for Foxx applications.",
     "dynamic" : false,
@@ -3710,7 +3710,6 @@
       "single"
     ],
     "default" : [
-      "./enterprise/js"
     ],
     "deprecatedIn" : null,
     "description" : "Additional paths containing JavaScript modules.",
@@ -3786,7 +3785,7 @@
       "coordinator",
       "single"
     ],
-    "default" : "./js",
+    "default" : "/usr/share/arangodb3/js",
     "deprecatedIn" : null,
     "description" : "A path to the directory containing the JavaScript startup scripts.",
     "dynamic" : false,
@@ -4249,7 +4248,7 @@
       "agent",
       "single"
     ],
-    "default" : "",
+    "default" : "-",
     "deprecatedIn" : null,
     "description" : "shortcut for '--log.output file://<filename>'",
     "dynamic" : false,

site/data/3.12/arangodump.json

@@ -1390,7 +1390,7 @@
   },
   "server.authentication" : {
     "category" : "option",
-    "default" : false,
+    "default" : true,
     "deprecatedIn" : null,
     "description" : "Require authentication credentials when connecting (does not affect the server-side authentication settings).",
     "dynamic" : false,
@@ -1454,7 +1454,7 @@
   "server.endpoint" : {
     "category" : "option",
     "default" : [
-      "http+tcp://127.0.0.1:8529"
+      "tcp://127.0.0.1:8529"
     ],
     "deprecatedIn" : null,
     "description" : "The endpoint to connect to. Use 'none' to start without a server. Use http+ssl:// as schema to connect to an SSL-secured server endpoint, otherwise http+tcp:// or unix://",

site/data/3.12/arangoexport.json

@@ -1126,7 +1126,7 @@
   },
   "server.authentication" : {
     "category" : "option",
-    "default" : false,
+    "default" : true,
     "deprecatedIn" : null,
     "description" : "Require authentication credentials when connecting (does not affect the server-side authentication settings).",
     "dynamic" : false,
@@ -1190,7 +1190,7 @@
   "server.endpoint" : {
     "category" : "option",
     "default" : [
-      "http+tcp://127.0.0.1:8529"
+      "tcp://127.0.0.1:8529"
     ],
     "deprecatedIn" : null,
     "description" : "The endpoint to connect to. Use 'none' to start without a server. Use http+ssl:// as schema to connect to an SSL-secured server endpoint, otherwise http+tcp:// or unix://",

site/data/3.12/arangoimport.json

@@ -1325,7 +1325,7 @@
   },
   "server.authentication" : {
     "category" : "option",
-    "default" : false,
+    "default" : true,
     "deprecatedIn" : null,
     "description" : "Require authentication credentials when connecting (does not affect the server-side authentication settings).",
     "dynamic" : false,
@@ -1389,7 +1389,7 @@
   "server.endpoint" : {
     "category" : "option",
     "default" : [
-      "http+tcp://127.0.0.1:8529"
+      "tcp://127.0.0.1:8529"
     ],
     "deprecatedIn" : null,
     "description" : "The endpoint to connect to. Use 'none' to start without a server. Use http+ssl:// as schema to connect to an SSL-secured server endpoint, otherwise http+tcp:// or unix://",

site/data/3.12/arangoinspect.json

@@ -768,7 +768,7 @@
   },
   "javascript.startup-directory" : {
     "category" : "option",
-    "default" : "./js",
+    "default" : "/usr/share/arangodb3/js",
     "deprecatedIn" : null,
     "description" : "The startup paths containing the JavaScript files.",
     "dynamic" : false,
@@ -1666,7 +1666,7 @@
   "server.endpoint" : {
     "category" : "option",
     "default" : [
-      "http+tcp://127.0.0.1:8529"
+      "tcp://127.0.0.1:8529"
     ],
     "deprecatedIn" : null,
     "description" : "The endpoint to connect to. Use 'none' to start without a server. Use http+ssl:// as schema to connect to an SSL-secured server endpoint, otherwise http+tcp:// or unix://",