ArangoDB v3.13 is under development and not released yet. This documentation is not final and potentially incomplete.

Known Issues in ArangoDB 3.10

Important issues affecting the 3.10.x versions of the ArangoDB suite of products

Note that this page does not list all open issues.

ArangoSearch

Issue
Date Added: 2018-12-19 Component: ArangoSearch Deployment Mode: Single-server Description: Value of `_id` attribute indexed by `arangosearch` View may become inconsistent after renaming a collection Affected Versions: 3.5.x, 3.6.x, 3.7.x, 3.8.x, 3.9.x, 3.10.x Fixed in Versions: - Reference: arangodb/backlog#514 (internal)
Date Added: 2018-12-03 Component: ArangoSearch Deployment Mode: Cluster Description: Score values evaluated by corresponding score functions (BM25/TFIDF) may differ in single-server and cluster with a collection having more than 1 shard Affected Versions: 3.4.x, 3.5.x, 3.6.x, 3.7.x, 3.8.x, 3.9.x, 3.10.x Fixed in Versions: - Reference: arangodb/backlog#508 (internal)
Date Added: 2018-12-03 Component: ArangoSearch Deployment Mode: All Description: Using a loop variable in expressions within a corresponding SEARCH condition is not supported Affected Versions: 3.4.x, 3.5.x, 3.6.x, 3.7.x, 3.8.x, 3.9.x, 3.10.x Fixed in Versions: - Reference: arangodb/backlog#318 (internal)
Date Added: 2019-06-25 Component: ArangoSearch Deployment Mode: All Description: The `primarySort` attribute in `arangosearch` View definitions cannot be set via the web interface. The option is immutable, but the web interface does not allow to set any View properties upfront (it creates a View with default parameters before the user has a chance to configure it). Affected Versions: 3.5.x, 3.6.x, 3.7.x, 3.8.x, 3.9.x, 3.10.x Fixed in Versions: - Reference: N/A
Date Added: 2020-03-19 Component: ArangoSearch Deployment Mode: All Description: Operators and functions in `SEARCH` clauses of AQL queries which compare values such as `>`, `>=`, `<`, `<=`, `IN_RANGE()` and `STARTS_WITH()` neither take the server language (`--default-language`) nor the Analyzer locale into account. The alphabetical order of characters as defined by a language is thus not honored and can lead to unexpected results in range queries. Affected Versions: 3.5.x, 3.6.x, 3.7.x, 3.8.x, 3.9.x, 3.10.x Fixed in Versions: - Reference: arangodb/backlog#679 (internal)
Date Added: 2022-09-15 Component: ArangoSearch Deployment Mode: All Description: In `FILTER` operations that utilize inverted indexes, you cannot use the `<value> IN doc.<attribute>` syntax, e.g. `FILTER "string" IN doc.arr[].attr`, like with persistent array indexes (or no index). You can use `["string"] ALL IN doc.arr[].attr`, however. Affected Versions: 3.10.x Fixed in Versions: - Reference: SEARCH-382 (internal)
Date Added: 2022-09-29 Component: ArangoSearch Deployment Mode: All Description: New Views of the search-alias type may return an incorrect amount of documents or other inconsistent results if they contain nested fields. Affected Versions: 3.10.0 Fixed in Versions: 3.10.1 Reference: SEARCH-391 (internal)
Date Added: 2022-09-29 Component: ArangoSearch Deployment Mode: All Description: When using an inverted index, if the same nested field in the document is referenced multiple times and nested fields’ definitions are different, only one definition will be used. Affected Versions: 3.10.x Fixed in Versions: - Reference: SEARCH-390 (internal)
Date Added: 2022-09-29 Component: ArangoSearch Deployment Mode: Cluster Description: In a cluster deployment using the new View of the `search-alias` type, running the `arangodump`/`arangorestore` commands fails. Affected Versions: 3.10.0 Fixed in Versions: 3.10.1 Reference: SEARCH-401 (internal)
Date Added: 2023-02-08 Component: ArangoSearch Deployment Mode: Active Failover Description: ArangoSearch caching is available in some 3.9 versions but not v3.10.0 and v3.10.1. If you upgrade deployments to one of these two versions, the column cache is unavailable, but cache-related options are remembered. If you upgrade to v3.10.2 or later, the feature is automatically available again. However, an exception are Active Failover deployments. If a failover (leader change) occurs with v3.10.0 or v3.10.1, then the cache options are reset. You need to re-configure them, requiring that you recreate inverted indexes and Views as necessary as most of these options are immutable. Affected Versions: 3.10.0, 3.10.1 Fixed in Versions: 3.10.2 Reference: N/A

AQL

Issue

Issue
Date Added: 2018-09-05 Component: AQL Deployment Mode: Cluster Description: In a very uncommon edge case there is an issue with an optimization rule in the cluster. If you are running a cluster and use a custom shard key on a collection (default is `_key`) and you provide a wrong shard key in a modifying query (`UPDATE`, `REPLACE`, `DELETE`) and the wrong shard key is on a different shard than the correct one, a `DOCUMENT NOT FOUND` error is returned instead of a modification (example query: `UPDATE { _key: "123", shardKey: "wrongKey"} WITH { foo: "bar" } IN mycollection`). Note that the modification always happens if the rule is switched off, so the suggested workaround is to deactivate the optimizing rule `restrict-to-single-shard`. Affected Versions: 3.4.x, 3.5.x, 3.6.x, 3.7.x, 3.8.x, 3.9.x, 3.10.x Fixed in Versions: - Reference: arangodb/arangodb#6399

Date Added: 2018-09-05
Component: AQL
Deployment Mode: Cluster
Description: In a very uncommon edge case there is an issue with an optimization rule in the cluster. If you are running a cluster and use a custom shard key on a collection (default is _key) and you provide a wrong shard key in a modifying query (UPDATE, REPLACE, DELETE) and the wrong shard key is on a different shard than the correct one, a DOCUMENT NOT FOUND error is returned instead of a modification (example query: UPDATE { _key: "123", shardKey: "wrongKey"} WITH { foo: "bar" } IN mycollection). Note that the modification always happens if the rule is switched off, so the suggested workaround is to deactivate the optimizing rule restrict-to-single-shard.
Affected Versions: 3.4.x, 3.5.x, 3.6.x, 3.7.x, 3.8.x, 3.9.x, 3.10.x
Fixed in Versions: -
Reference: arangodb/arangodb#6399

Upgrading

Issue
Date Added: 2019-05-16 Component: arangod Deployment Mode: All Description: Bugfix release upgrades such as 3.4.4 to 3.4.5 may not create a backup of the database directory even if they should. Please create a copy manually before upgrading. Affected Versions: 3.4.x, 3.5.x, 3.6.x, 3.7.x, 3.8.x, 3.9.x, 3.10.x (Windows and Linux) Fixed in Versions: - Reference: arangodb/planning#3745 (internal)
Date Added: 2019-12-10 Component: Installer Deployment Mode: All Description: The NSIS installer for Windows may fail to upgrade an existing installation, e.g. from 3.4.a to 3.4.b (patch release), with the error message: “failed to detect whether we need to Upgrade” Affected Versions: 3.4.x, 3.5.x, 3.6.x, 3.7.x, 3.8.x, 3.9.x, 3.10.x Fixed in Versions: - Reference: arangodb/release-qa#183 (internal)
Date Added: 2020-01-07 Component: Installer Deployment Mode: All Description: The NSIS installer for Windows can fail to add the path to the ArangoDB binaries to the `PATH` environment variable, silently or with an error. Affected Versions: 3.4.x, 3.5.x, 3.6.x, 3.7.x, 3.8.x, 3.9.x, 3.10.x Fixed in Versions: - Reference: arangodb/release-qa#183 (internal)
Date Added: 2023-06-06 Component: arangod Deployment Mode: Cluster Description: During a cluster upgrade while the supervision is deactivated (maintenance mode), upgraded DB-Server nodes are incorrectly reported to still have the old server version. The versions are visible in the Agency as well as in the NODES section of the web interface. Affected Versions: 3.9.x, 3.10.x Fixed in Versions: - Reference: BTS-1409 (internal)

Hot Backup

Issue
Date Added: 2019-10-09 Component: Hot Backup API / arangobackup Deployment Mode: All Description: The Hot Backup feature is not supported in the Windows version of ArangoDB at this point in time. Affected Versions: 3.5.x, 3.6.x, 3.7.x, 3.8.x, 3.9.x, 3.10.x Fixed in Versions: - Reference: N/A
Date Added: 2019-10-09 Component: Hot Backup API / arangobackup Deployment Mode: DC2DC Description: Hot Backup functionality in Datacenter-to-Datacenter Replication setups is experimental and may not work. Affected Versions: 3.5.x, 3.6.x, 3.7.x, 3.8.x, 3.9.x, 3.10.x Fixed in Versions: - Reference: N/A
Date Added: 2019-10-09 Component: arangobackup Deployment Mode: All Description: The startup option `--operation` works as positional argument only, e.g. `arangobackup list`. The alternative syntax `arangobackup --operation list` is not accepted. Affected Versions: 3.5.x, 3.6.x, 3.7.x, 3.8.x, 3.9.x, 3.10.x Fixed in Versions: - Reference: N/A

Other

Issue
Date Added: 2019-05-16 Component: Starter Deployment Mode: All Description: The ArangoDB Starter falls back to the IP `[::1]` under macOS. If there is no entry `::1 localhost` in the `/etc/hosts` file or the option `--starter.disable-ipv6` is passed to the starter to use IPv4, then it will hang during startup. Affected Versions: 0.14.3 (macOS only) Fixed in Versions: - Reference: N/A
Date Added: 2019-05-24 Component: Web Interface Deployment Mode: Active Failover Description: The web interface shows a wrong replication mode in the replication tab in Active Failover deployments sometimes. It may display Leader/Follower mode (the default value) because of timeouts if `/_api/cluster/endpoints` is requested too frequently. Affected Versions: 3.5.x, 3.6.x, 3.7.x, 3.8.x, 3.9.x, 3.10.x Fixed in Versions: - Reference: N/A
Date Added: 2019-04-03 Component: arangod Deployment Mode: Cluster Description: Updating the properties of a collection in the cluster may return before the properties are updated consistently on all shards. This is especially visible when setting a schema for a collection with multiple shards, and then instantly starting to store non-conforming documents into the collection. These may be accepted until the properties change has been fully propagated to all shards. Affected Versions: 3.7.x, 3.8.x, 3.9.x, 3.10.x Fixed in Versions: - Reference: N/A
Date Added: 2021-04-07 Component: arangod Deployment Mode: All Description: The Batch API (HTTP endpoint `/_api/batch`) cannot be used in combination with Stream transactions to submit batched requests, because the required header `x-arango-trx-id` is not forwarded. It only processes `Content-Type` and `Content-Id`. Affected Versions: 3.5.x, 3.6.x, 3.7.x, 3.8.x, 3.9.x, 3.10.x Fixed in Versions: - Reference: arangodb/arangodb#13552
Date Added: 2021-08-06 Component: Installer Deployment Mode: Single Server Description: The Windows installer fails during database initialization with the error `failed to locate tzdata` if there are non-ASCII characters in the destination path. Affected Versions: 3.8.x, 3.9.x, 3.10.x Fixed in Versions: - Reference: BTS-531 (internal)
Date Added: 2022-09-29 Component: Web Interface Deployment Mode: All Description: In the web interface for ArangoSearch Views, it’s not possible to create a link to a collection, if the collection has only one letter in its name. Affected Versions: 3.10.0 Fixed in Versions: 3.10.1 Reference: BTS-1008 (internal)
Date Added: 2022-09-29 Component: ArangoDB Starter Deployment Mode: All Description: The ArangoDB Starter may fail to pick a Docker container name from cgroups. Affected Versions: 3.8.x, 3.9.x, 3.10.x Fixed in Versions: 3.9.9, 3.10.4 Reference: GT-207 (internal)
Date Added: 2022-10-26 Component: ArangoSync Deployment Mode: DC2DC Description: When upgrading to 3.10.0, 3.10.1, 3.10.2, the _analyzers collection cannot be replicated. Affected Versions: 3.8.8, 3.9.4, 3.10.0, 3.10.1, 3.10.2 Fixed in Versions: 3.8.9, 3.9.6, 3.10.3 Reference: BTS-1094 (internal)
Date Added: 2023-02-17 Component: ArangoDB Starter Deployment Mode: All Description: When using a Windows build with `netgo`, the `localhost` cannot be resolved. Affected Versions: 3.9.8, 3.10.3 Fixed in Versions: 3.9.9, 3.10.4 Reference: GT-330 (internal)
Date Added: 2023-06-07 Component: ArangoSync Deployment Mode: All Description: In ArangoSync v2.18.0, synchronization may be interrupted with errors like “CloneDirectMQToken failed” due to network disturbances. Affected Versions: 3.9.11, 3.10.7 Fixed in Versions: - Reference: N/A
Date Added: 2023-06-16 Component: arangod Deployment Mode: Cluster Description: If more than a certain threshold of queries on the same Coordinator get into the shutdown networking code at the same time, all of them lock up and the Coordinator does not longer process requests. Affected Versions: 3.9.x. 3.10.x Fixed in Versions: 3.9.12, 3.10.8 Reference: BTS-1486 (internal)
Date Added: 2024-03-21 Component: arangod Deployment Mode: All Description: When creating an `inverted` index with the `inBackground` option enabled, HTTP API calls like `http://localhost:8529/_api/index?collection=<coll>&withHidden=true` don’t return the `isBuilding` and `progress` attributes and the progress of the index building can thus not be observed. Affected Versions: 3.10.13 Fixed in Versions: - Reference: BTS-1788 (internal)