diff --git a/site/data/3.10/arangobackup.json b/site/data/3.10/arangobackup.json index eaec11ece1..d3ed05a232 100644 --- a/site/data/3.10/arangobackup.json +++ b/site/data/3.10/arangobackup.json @@ -1013,7 +1013,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, @@ -1080,7 +1080,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://", diff --git a/site/data/3.10/arangobench.json b/site/data/3.10/arangobench.json index 515dfdbc82..57b4c7acd3 100644 --- a/site/data/3.10/arangobench.json +++ b/site/data/3.10/arangobench.json @@ -1331,7 +1331,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, @@ -1398,7 +1398,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://", diff --git a/site/data/3.10/arangod.json b/site/data/3.10/arangod.json index fd5c7fee2f..3184bf3a3b 100644 --- a/site/data/3.10/arangod.json +++ b/site/data/3.10/arangod.json @@ -1109,7 +1109,7 @@ "agent", "single" ], - "default" : 7739680768, + "default" : 7739679744, "deprecatedIn" : null, "description" : "The global size limit for all caches (in bytes).", "dynamic" : true, @@ -1992,7 +1992,7 @@ "agent", "single" ], - "default" : "", + "default" : "/var/lib/arangodb3", "deprecatedIn" : null, "description" : "The path to the database directory.", "dynamic" : false, @@ -3100,7 +3100,7 @@ "coordinator", "single" ], - "default" : "./js/apps", + "default" : "/var/lib/arangodb3-apps", "deprecatedIn" : null, "description" : "The directory for Foxx applications.", "dynamic" : false, @@ -3398,7 +3398,6 @@ "single" ], "default" : [ - "./enterprise/js" ], "deprecatedIn" : null, "description" : "Additional paths containing JavaScript modules.", @@ -3477,7 +3476,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, @@ -5867,7 +5866,7 @@ "agent", "single" ], - "default" : "", + "default" : "-", "deprecatedIn" : null, "description" : "shortcut for '--log.output file://'", "dynamic" : false, @@ -7240,7 +7239,7 @@ "type" : "boolean" }, "query.global-memory-limit" : { - "base" : 33106206720, + "base" : 33106202624, "category" : "option", "component" : [ "coordinator", @@ -7248,7 +7247,7 @@ "agent", "single" ], - "default" : 26816027443, + "default" : 26816024125, "deprecatedIn" : null, "description" : "The memory threshold for all AQL queries combined (in bytes, 0 = no limit).", "dynamic" : true, @@ -7506,7 +7505,7 @@ "type" : "double" }, "query.memory-limit" : { - "base" : 33106206720, + "base" : 33106202624, "category" : "option", "component" : [ "coordinator", @@ -7514,7 +7513,7 @@ "agent", "single" ], - "default" : 19863724032, + "default" : 19863721575, "deprecatedIn" : null, "description" : "The memory threshold per AQL query (in bytes, 0 = no limit).", "dynamic" : true, @@ -8626,7 +8625,7 @@ "agent", "single" ], - "default" : 9287616921, + "default" : 9287615692, "deprecatedIn" : null, "description" : "The size of block cache (in bytes).", "dynamic" : true, @@ -9295,35 +9294,6 @@ "section" : "rocksdb", "type" : "boolean" }, - "rocksdb.force-legacy-little-endian-keys" : { - "category" : "option", - "component" : [ - "dbserver", - "agent", - "single" - ], - "default" : false, - "deprecatedIn" : null, - "description" : "Force usage of legacy little endian key encoding when creating a new RocksDB database directory. DO NOT USE IN PRODUCTION.", - "dynamic" : false, - "enterpriseOnly" : false, - "experimental" : true, - "hidden" : true, - "introducedIn" : [ - "v3.12.0" - ], - "longDescription" : "If enabled and a new RocksDB database\nis generated, the legacy little endian key encoding is used.\n\nOnly use this option for testing purposes! It is bad for performance and\ndisables a few features like parallel index generation!", - "obsolete" : false, - "os" : [ - "linux", - "macos", - "windows" - ], - "required" : false, - "requiresValue" : false, - "section" : "rocksdb", - "type" : "boolean" - }, "rocksdb.format-version" : { "base" : 1, "category" : "option", @@ -11002,7 +10972,7 @@ "agent", "single" ], - "default" : 12383489228, + "default" : 12383487590, "deprecatedIn" : null, "description" : "The maximum total size of in-memory write buffers (0 = unbounded).", "dynamic" : true, @@ -11541,7 +11511,7 @@ "agent", "single" ], - "default" : 10, + "default" : 0, "deprecatedIn" : null, "description" : "Cluster metrics polling timeout (in seconds).", "dynamic" : false, @@ -11772,33 +11742,6 @@ "section" : "server", "type" : "boolean" }, - "server.failure-point" : { - "category" : "option", - "component" : [ - "coordinator", - "dbserver", - "agent", - "single" - ], - "default" : [ - ], - "deprecatedIn" : null, - "description" : "The failure point to set during server startup (requires compilation with failure points support).", - "dynamic" : false, - "enterpriseOnly" : false, - "experimental" : false, - "hidden" : true, - "introducedIn" : null, - "obsolete" : false, - "os" : [ - "linux", - "macos", - "windows" - ], - "requiresValue" : true, - "section" : "server", - "type" : "string..." - }, "server.gid" : { "category" : "option", "component" : [ diff --git a/site/data/3.10/arangodump.json b/site/data/3.10/arangodump.json index 6afa499bff..a7a37f1e6d 100644 --- a/site/data/3.10/arangodump.json +++ b/site/data/3.10/arangodump.json @@ -1262,7 +1262,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, @@ -1329,7 +1329,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://", diff --git a/site/data/3.10/arangoexport.json b/site/data/3.10/arangoexport.json index b1c87febad..78cafd21ed 100644 --- a/site/data/3.10/arangoexport.json +++ b/site/data/3.10/arangoexport.json @@ -1110,7 +1110,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, @@ -1177,7 +1177,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://", diff --git a/site/data/3.10/arangoimport.json b/site/data/3.10/arangoimport.json index bed4722ef2..7a9ed9790b 100644 --- a/site/data/3.10/arangoimport.json +++ b/site/data/3.10/arangoimport.json @@ -1290,7 +1290,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, @@ -1357,7 +1357,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://", diff --git a/site/data/3.10/arangoinspect.json b/site/data/3.10/arangoinspect.json index f2b093a460..4346c2c70e 100644 --- a/site/data/3.10/arangoinspect.json +++ b/site/data/3.10/arangoinspect.json @@ -770,51 +770,9 @@ "section" : "javascript", "type" : "string..." }, - "javascript.run-main" : { - "category" : "option", - "default" : false, - "deprecatedIn" : null, - "description" : "Execute main function.", - "dynamic" : false, - "enterpriseOnly" : false, - "experimental" : false, - "hidden" : false, - "introducedIn" : null, - "obsolete" : false, - "os" : [ - "linux", - "macos", - "windows" - ], - "required" : false, - "requiresValue" : false, - "section" : "javascript", - "type" : "boolean" - }, - "javascript.script-parameter" : { - "category" : "option", - "default" : [ - ], - "deprecatedIn" : null, - "description" : "Script parameter.", - "dynamic" : false, - "enterpriseOnly" : false, - "experimental" : false, - "hidden" : false, - "introducedIn" : null, - "obsolete" : false, - "os" : [ - "linux", - "macos", - "windows" - ], - "requiresValue" : true, - "section" : "javascript", - "type" : "string..." - }, "javascript.startup-directory" : { "category" : "option", - "default" : "./js", + "default" : "/usr/share/arangodb3/js", "deprecatedIn" : null, "description" : "The startup paths containing the JavaScript files.", "dynamic" : false, @@ -1759,7 +1717,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://", diff --git a/site/data/3.10/arangorestore.json b/site/data/3.10/arangorestore.json index 9301f1a206..4fb85acaf9 100644 --- a/site/data/3.10/arangorestore.json +++ b/site/data/3.10/arangorestore.json @@ -417,27 +417,6 @@ "section" : "", "type" : "boolean" }, - "fail-after-update-continue-file" : { - "category" : "option", - "default" : false, - "deprecatedIn" : null, - "description" : "", - "dynamic" : false, - "enterpriseOnly" : false, - "experimental" : false, - "hidden" : true, - "introducedIn" : null, - "obsolete" : false, - "os" : [ - "linux", - "macos", - "windows" - ], - "required" : false, - "requiresValue" : false, - "section" : "", - "type" : "boolean" - }, "force" : { "category" : "option", "default" : false, @@ -1365,7 +1344,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, @@ -1432,7 +1411,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://", diff --git a/site/data/3.10/arangosh.json b/site/data/3.10/arangosh.json index dbfce9d348..8e978725d1 100644 --- a/site/data/3.10/arangosh.json +++ b/site/data/3.10/arangosh.json @@ -397,7 +397,7 @@ }, "javascript.allow-external-process-control" : { "category" : "option", - "default" : true, + "default" : false, "deprecatedIn" : null, "description" : "Allow the execution and control of external processes from within JavaScript actions.", "dynamic" : false, @@ -420,7 +420,7 @@ }, "javascript.allow-port-testing" : { "category" : "option", - "default" : true, + "default" : false, "deprecatedIn" : null, "description" : "Allow the testing of ports from within JavaScript actions.", "dynamic" : false, @@ -752,7 +752,6 @@ "javascript.module-directory" : { "category" : "option", "default" : [ - "./enterprise/js" ], "deprecatedIn" : null, "description" : "Additional paths containing JavaScript modules.", @@ -771,51 +770,9 @@ "section" : "javascript", "type" : "string..." }, - "javascript.run-main" : { - "category" : "option", - "default" : false, - "deprecatedIn" : null, - "description" : "Execute main function.", - "dynamic" : false, - "enterpriseOnly" : false, - "experimental" : false, - "hidden" : false, - "introducedIn" : null, - "obsolete" : false, - "os" : [ - "linux", - "macos", - "windows" - ], - "required" : false, - "requiresValue" : false, - "section" : "javascript", - "type" : "boolean" - }, - "javascript.script-parameter" : { - "category" : "option", - "default" : [ - ], - "deprecatedIn" : null, - "description" : "Script parameter.", - "dynamic" : false, - "enterpriseOnly" : false, - "experimental" : false, - "hidden" : false, - "introducedIn" : null, - "obsolete" : false, - "os" : [ - "linux", - "macos", - "windows" - ], - "requiresValue" : true, - "section" : "javascript", - "type" : "string..." - }, "javascript.startup-directory" : { "category" : "option", - "default" : "./js", + "default" : "/usr/share/arangodb3/js", "deprecatedIn" : null, "description" : "The startup paths containing the JavaScript files.", "dynamic" : false, @@ -1693,7 +1650,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, @@ -1760,7 +1717,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:// or vst+ssl:// as schema to connect to an SSL-secured server endpoint, otherwise http+tcp://, vst+tcp:// or unix://.", diff --git a/site/data/3.11/arangod.json b/site/data/3.11/arangod.json index 48ea56fd96..7c04afb714 100644 --- a/site/data/3.11/arangod.json +++ b/site/data/3.11/arangod.json @@ -1334,7 +1334,7 @@ "agent", "single" ], - "default" : 7739684864, + "default" : 7739679744, "deprecatedIn" : null, "description" : "The global size limit for all caches (in bytes).", "dynamic" : true, @@ -7417,7 +7417,7 @@ "type" : "boolean" }, "query.global-memory-limit" : { - "base" : 33106223104, + "base" : 33106202624, "category" : "option", "component" : [ "coordinator", @@ -7425,7 +7425,7 @@ "agent", "single" ], - "default" : 26816040714, + "default" : 26816024125, "deprecatedIn" : null, "description" : "The memory threshold for all AQL queries combined (in bytes, 0 = no limit).", "dynamic" : true, @@ -7715,7 +7715,7 @@ "type" : "double" }, "query.memory-limit" : { - "base" : 33106223104, + "base" : 33106202624, "category" : "option", "component" : [ "coordinator", @@ -7723,7 +7723,7 @@ "agent", "single" ], - "default" : 19863733863, + "default" : 19863721575, "deprecatedIn" : null, "description" : "The memory threshold per AQL query (in bytes, 0 = no limit).", "dynamic" : true, @@ -8958,7 +8958,7 @@ "agent", "single" ], - "default" : 9287621836, + "default" : 9287615692, "deprecatedIn" : null, "description" : "The size of block cache (in bytes).", "dynamic" : true, @@ -11539,7 +11539,7 @@ "agent", "single" ], - "default" : 12383495782, + "default" : 12383487590, "deprecatedIn" : null, "description" : "The maximum total size of in-memory write buffers (0 = unbounded).", "dynamic" : true, diff --git a/site/data/3.12/allMetrics.yaml b/site/data/3.12/allMetrics.yaml index 9c5979b2a8..6f9c2bd53d 100644 --- a/site/data/3.12/allMetrics.yaml +++ b/site/data/3.12/allMetrics.yaml @@ -424,6 +424,39 @@ description: | Current number of AQL queries executing. +- name: arangodb_aql_cursors_active + introducedIn: "3.12.0" + help: | + Current number of active AQL query cursors. + unit: number + type: gauge + category: AQL + complexity: simple + exposedBy: + - coordinator + - agent + - single + description: | + Current number of active AQL query cursors. + AQL query cursors are created for queries that produce + more results than specified in the `batchSize` query option + (default value: 1000). Such results can be fetched incrementally + by client operations in chunks. + As it is unclear if and when a client will fetch any remaining + data from a cursor, every cursor has a server-side timeout value + (TTL) after which it is garbage-collected. + troubleshoot: | + This number can grow temporary in case a lot of concurrent AQL queries + are executed. It should go down again however when the query results + are consumed. + If this number does not decrease a lot, it means that cursors are kept + on the server and wait for their expiry. + As active cursors can use resources (memory for query results and + potentially some collection locks), it is advisable to check the client + application code for ttl values and also check if the client application + code fully consumes query results or only fetches them partially. + + - name: arangodb_aql_global_memory_limit introducedIn: "3.8.0" help: | diff --git a/site/data/3.12/arangod.json b/site/data/3.12/arangod.json index e38b5cf13e..ced38178e8 100644 --- a/site/data/3.12/arangod.json +++ b/site/data/3.12/arangod.json @@ -1326,7 +1326,7 @@ "agent", "single" ], - "default" : 7754362880, + "default" : 7739679744, "deprecatedIn" : null, "description" : "The global size limit for all caches (in bytes).", "dynamic" : true, @@ -2788,7 +2788,7 @@ "dbserver", "single" ], - "default" : 6203490304, + "default" : 6191743795, "deprecatedIn" : null, "description" : "Maximum memory usage (in bytes) to be used by all ongoing dumps.", "dynamic" : true, @@ -7430,7 +7430,7 @@ "type" : "boolean" }, "query.global-memory-limit" : { - "base" : 33164935168, + "base" : 33106202624, "category" : "option", "component" : [ "coordinator", @@ -7438,7 +7438,7 @@ "agent", "single" ], - "default" : 26863597486, + "default" : 26816024125, "deprecatedIn" : null, "description" : "The memory threshold for all AQL queries combined (in bytes, 0 = no limit).", "dynamic" : true, @@ -7723,7 +7723,7 @@ "type" : "double" }, "query.memory-limit" : { - "base" : 33164935168, + "base" : 33106202624, "category" : "option", "component" : [ "coordinator", @@ -7731,7 +7731,7 @@ "agent", "single" ], - "default" : 19898961101, + "default" : 19863721575, "deprecatedIn" : null, "description" : "The memory threshold per AQL query (in bytes, 0 = no limit).", "dynamic" : true, @@ -8940,7 +8940,7 @@ "agent", "single" ], - "default" : 9305235456, + "default" : 9287615692, "deprecatedIn" : null, "description" : "The size of block cache (in bytes).", "dynamic" : true, @@ -11494,7 +11494,7 @@ "agent", "single" ], - "default" : 12406980608, + "default" : 12383487590, "deprecatedIn" : null, "description" : "The maximum total size of in-memory write buffers (0 = unbounded).", "dynamic" : true, diff --git a/site/data/3.12/arangorestore.json b/site/data/3.12/arangorestore.json index f0409492a5..de27cec988 100644 --- a/site/data/3.12/arangorestore.json +++ b/site/data/3.12/arangorestore.json @@ -1704,5 +1704,28 @@ "requiresValue" : true, "section" : "", "type" : "string..." + }, + "write-concern" : { + "category" : "option", + "default" : [ + ], + "deprecatedIn" : null, + "description" : "Override the `writeConcern` value (can be specified multiple times, e.g. --write-concern 2 --write-concern myCollection=3).", + "dynamic" : false, + "enterpriseOnly" : false, + "experimental" : false, + "hidden" : false, + "introducedIn" : [ + "v3.12.0" + ], + "obsolete" : false, + "os" : [ + "linux", + "macos", + "windows" + ], + "requiresValue" : true, + "section" : "", + "type" : "string..." } } diff --git a/site/data/3.12/optimizer-rules.json b/site/data/3.12/optimizer-rules.json index 6fd8673c48..9b8fb101ac 100644 --- a/site/data/3.12/optimizer-rules.json +++ b/site/data/3.12/optimizer-rules.json @@ -719,18 +719,6 @@ "enterpriseOnly": false } }, - { - "name": "async-prefetch", - "description": "Allow query execution nodes to asynchronously prefetch the\nnext batch while processing the current batch, allowing parts of the query to\nrun in parallel. This is an experimental option as not all operations are\nthread-safe.", - "flags": { - "hidden": true, - "clusterOnly": false, - "canBeDisabled": true, - "canCreateAdditionalPlans": false, - "disabledByDefault": true, - "enterpriseOnly": false - } - }, { "name": "decay-unnecessary-sorted-gather", "description": "Avoid merge-sorting results on a Coordinator if they are all\nfrom a single shard and fully sorted by a DB-Server already.", @@ -815,6 +803,18 @@ "enterpriseOnly": false } }, + { + "name": "async-prefetch", + "description": "Allow query execution nodes to asynchronously prefetch the\nnext batch while processing the current batch, allowing parts of the query to\nrun in parallel. This is only possible for certain operations in a query.", + "flags": { + "hidden": false, + "clusterOnly": false, + "canBeDisabled": true, + "canCreateAdditionalPlans": false, + "disabledByDefault": false, + "enterpriseOnly": false + } + }, { "name": "splice-subqueries", "description": "Appears if subqueries are spliced into the surrounding query,\nreducing overhead for executing subqueries by inlining the execution.\nThis mainly benefits queries which execute subqueries very often that only\nreturn a few results at a time.\n\nThis optimization is performed on all subqueries and is applied after all other\noptimizations.",