Skip to content

Commit 09a4623

Browse files
committed
2 parents 386a97d + 429315b commit 09a4623

File tree

14 files changed

+282
-129
lines changed

14 files changed

+282
-129
lines changed

site/content/arangodb/3.10/components/tools/arangorestore/fast-cluster-restore.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Version 0.3
2+
title: Fast cluster restore procedure (version 0.3)
33
menuTitle: Fast Cluster Restore
44
weight: 10
55
description: >-

site/content/arangodb/3.11/release-notes/deprecated-and-removed-features.md

Lines changed: 54 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,9 @@ menuTitle: Deprecated and removed features
44
weight: 100
55
description: >-
66
Features listed in this section should no longer be used, because they are considered obsolete and may get removed in a future release
7+
aliases:
8+
- ../develop/drivers/csharp-dotnet # 3.10 -> 3.11
9+
- ../components/tools/arangorestore/fast-cluster-restore # 3.10 -> 3.11
710
---
811
Features listed on this page should no longer be used because they have been
912
deprecated and may get removed in a future release, or have been removed already
@@ -19,13 +22,12 @@ See the [Release notes](_index.md) of the respective versions for
1922
detailed information about breaking changes before upgrading.
2023
{{< /info >}}
2124

22-
- **VelocyStream protocol**:
25+
- **VelocyStream protocol**:\
2326
ArangoDB's own bi-directional asynchronous binary protocol VelocyStream (VST)
2427
is deprecated in v3.11 and removed in v3.12.0. Use JSON or VelocyPack over the
2528
HTTP(S) protocol instead.
2629

27-
- **Little-endian on-disk key format for the RocksDB storage engine**:
28-
30+
- **Little-endian on-disk key format for the RocksDB storage engine**:\
2931
The little-endian on-disk key format for the RocksDB storage engine is
3032
deprecated and support will be removed in v3.12. Parallel index creation and
3133
the `--use-experimental-dump` arangodump option are only available in v3.11
@@ -34,7 +36,7 @@ detailed information about breaking changes before upgrading.
3436
Only deployments that were set up with the RocksDB storage engine using
3537
ArangoDB v3.2 or v3.3 and that have been upgraded since then are affected.
3638

37-
- **Pregel features**:
39+
- **Pregel features**:\
3840
The following features have been deprecated or removed from Pregel in v3.11:
3941

4042
- The experimental _Custom Pregel_ feature, also known as
@@ -48,82 +50,96 @@ detailed information about breaking changes before upgrading.
4850
- The `useMemoryMaps` option for Pregel jobs to use memory-mapped files as a
4951
backing storage for large datasets has been removed.
5052

51-
- **Cloud Migration Tool**:
53+
- **Cloud Migration Tool**:\
5254
The `arangosync-migration` tool to move from on-premises to the cloud is not
5355
available anymore.
5456

55-
- **Leader/Follower Deployment Mode**:
57+
- **Fast cluster restore procedure**:\
58+
The procedure for speeding up _arangorestore_ in a cluster environment has been
59+
removed from the documentation because the tool supports threading more
60+
multiple collections (from version 3.3 onward) as well as single collections
61+
(from version 3.8 onward using the non-enveloped format). For even faster
62+
restoration with zero downtime, you can use _arangobackup_ for
63+
[Hot Backups](../operations/backup-and-restore.md/#hot-backups).
64+
65+
- **C# / .NET driver**:\
66+
The [arangodb-net-standard](https://github.com/ArangoDB-Community/arangodb-net-standard)
67+
driver is not an official ArangoDB driver anymore but may still be maintained
68+
by the community.
69+
70+
- **Leader/Follower Deployment Mode**:\
5671
The Leader/Follower deployment mode is deprecated and already removed from
5772
documentation. Active Failover and OneShard databases in clusters are better
5873
alternatives.
5974

60-
- **Skiplist and hash indexes**:
75+
- **Skiplist and hash indexes**:\
6176
Skiplist and hash indexes have been deprecated in 3.9 and will be removed in a
6277
future version of ArangoDB. Currently, they are an alias for a
6378
[persistent index](../indexes-and-search/indexing/basics.md#persistent-index).
6479

65-
- **Bundled NPM modules**:
80+
- **Bundled NPM modules**:\
6681
The bundled NPM modules `aqb`, `chai`, `dedent`, `error-stack-parser`,
6782
`graphql-sync`, `highlight.js`, `i` (inflect), `iconv-lite`, `joi`,
6883
`js-yaml`, `lodash`, `minimatch`, `qs`, `semver`, `sinon`, and `timezone`
6984
have been deprecated in 3.9 and will be removed in a future version of ArangoDB.
7085
If you want to use NPM modules in your Foxx service, please refer to the
7186
[Foxx guide](../develop/foxx-microservices/guides/using-node-modules.md).
7287

73-
- **Batch Requests API**:
88+
- **Batch Requests API**:\
7489
The [batch request REST API](../develop/http-api/batch-requests.md) is deprecated and will be
7590
removed in a future version. Instead of using this API, please use the
7691
[HTTP interface for documents](../develop/http-api/documents.md#multiple-document-operations)
7792
that can insert, update, replace or remove arrays of documents.
7893

79-
- **PUT method in Cursor API**:
94+
- **PUT method in Cursor API**:\
8095
The HTTP endpoint `PUT /_api/cursor/<cursor-id>` in the
8196
[Cursor REST API](../develop/http-api/queries/aql-queries.md) is deprecated and will be
8297
removed in a future version. Please use the drop-in replacement
8398
`POST /_api/cursor/<cursor-id>` instead. The POST endpoint is functionally
8499
equivalent to the PUT endpoint, but does not violate idempotency requirements
85100
prescribed by the [HTTP specification](https://tools.ietf.org/html/rfc7231#section-4.2).
86101

87-
- **Fulltext indexes**:
102+
- **Fulltext indexes**:\
88103
The fulltext index type is deprecated from version 3.10 onwards.
89104
It is recommended to use [ArangoSearch](../indexes-and-search/arangosearch/_index.md) for advanced full-text search capabilities.
90105

91-
- **Simple Queries**: Idiomatic interface in arangosh to perform trivial queries.
106+
- **Simple Queries**:\
107+
Idiomatic interface in arangosh to perform trivial queries.
92108
They are superseded by [AQL queries](../aql/_index.md), which can also
93109
be run in arangosh. AQL is a language on its own and way more powerful than
94110
*Simple Queries* could ever be. In fact, the (still supported) *Simple Queries*
95111
are translated internally to AQL, then the AQL query is optimized and run
96112
against the database in recent versions, because of better performance and
97113
reduced maintenance complexity.
98114

99-
- **Accessing collections by ID instead of by name**:
115+
- **Accessing collections by ID instead of by name**:\
100116
Accessing collections by their internal ID instead of accessing them by name
101117
is deprecated and highly discouraged. This functionality may be removed in
102118
future versions of ArangoDB.
103119

104-
- **Old metrics REST API**:
120+
- **Old metrics REST API**:\
105121
The old metrics API under `/_admin/metrics` is deprecated and replaced by
106122
a new one under `/_admin/metrics/v2` from version 3.8.0 on. This step was
107123
necessary because the old API did not follow quite a few Prometheus
108124
guidelines for metrics.
109125

110-
- **Statistics REST API**:
126+
- **Statistics REST API**:\
111127
The endpoints `/_admin/statistics` and `/_admin/statistics-description`
112128
are deprecated in favor of the new metrics API under `/_admin/metrics/v2`.
113129
The metrics API provides a lot more information than the statistics API, so
114130
it is much more useful.
115131

116-
- **Database target version REST API**:
132+
- **Database target version REST API**:\
117133
The `GET /_admin/database/target-version` endpoint is deprecated in favor of the
118134
more general version API with the endpoint `GET /_api/version`. The endpoint may be
119135
removed in a future version of ArangoDB.
120136

121-
- **Replication logger-follow REST API**:
137+
- **Replication logger-follow REST API**:\
122138
The endpoint `/_api/replication/logger-follow` is deprecated since 3.4.0 and
123139
may be removed in a future version. Client applications should use the REST
124140
API endpoint `/_api/wal/tail` instead, which is available since ArangoDB 3.3.
125141

126-
- **Loading and unloading of collections**:
142+
- **Loading and unloading of collections**:\
127143
The JavaScript functions for explicitly loading and unloading collections,
128144
`db.<collection-name>.load()` and `db.<collection-name>.unload()` and their
129145
REST API endpoints `PUT /_api/collection/<collection-name>/load` and
@@ -132,7 +148,8 @@ detailed information about breaking changes before upgrading.
132148
RocksDB storage engine. The load/unload functionality was useful only with
133149
the MMFiles storage engine, which is not available anymore since 3.7.
134150

135-
- **Actions**: Snippets of JavaScript code on the server-side for minimal
151+
- **Actions**:\
152+
Snippets of JavaScript code on the server-side for minimal
136153
custom endpoints. Since the Foxx revamp in 3.0, it became really easy to
137154
write [Foxx Microservices](../develop/foxx-microservices/_index.md), which allow you to define
138155
custom endpoints even with complex business logic.
@@ -142,7 +159,8 @@ detailed information about breaking changes before upgrading.
142159
folder). They are not actively removed, they remain on upgrade or backup
143160
restoration from previous versions.
144161

145-
- **Outdated AQL functions**: The following AQL functions are deprecated and
162+
- **Outdated AQL functions**:\
163+
The following AQL functions are deprecated and
146164
their usage is discouraged:
147165
- `IS_IN_POLYGON`
148166
- `NEAR`
@@ -151,25 +169,27 @@ detailed information about breaking changes before upgrading.
151169

152170
See [Geo functions](../aql/functions/geo.md) for substitutes.
153171

154-
- **`bfs` option** in AQL graph traversal: Using the *bfs* attribute inside
172+
- **`bfs` option** in AQL graph traversal:\
173+
Using the *bfs* attribute inside
155174
traversal options is deprecated since v3.8.0. The preferred way to start a
156175
breadth-first traversal is by using the new `order` attribute, and setting it
157176
to a value of `bfs`.
158177

159-
- **`overwrite` option**: The `overwrite` option for insert operations (either
178+
- **`overwrite` option**:\
179+
The `overwrite` option for insert operations (either
160180
single document operations or AQL `INSERT` operations) is deprecated in favor
161181
of the `overwriteMode` option, which provides more flexibility.
162182

163-
- **`minReplicationFactor` collection option**: The `minReplicationFactor`
183+
- **`minReplicationFactor` collection option**:\
184+
The `minReplicationFactor`
164185
option for collections has been renamed to `writeConcern`. If
165186
`minReplicationFactor` is specified and no `writeConcern` is set, the
166187
`minReplicationFactor` value will still be picked up and used as
167188
`writeConcern` value. However, this compatibility mode will be removed
168189
eventually, so changing applications from using `minReplicationFactor` to
169190
`writeConcern` is advised.
170191

171-
- **Outdated startup options**
172-
192+
- **Outdated startup options**:\
173193
The following _arangod_ startup options are deprecated and will be removed
174194
in a future version:
175195
- `--database.old-system-collections` (no need to use it anymore)
@@ -224,12 +244,14 @@ detailed information about breaking changes before upgrading.
224244
- `--log.use-microtime` (use `--log.time-format` instead)
225245
- `--log.performance` (use `--log.level` instead)
226246

227-
- **Obsoleted startup options**: Any startup options marked as obsolete can be
247+
- **Obsoleted startup options**:\
248+
Any startup options marked as obsolete can be
228249
removed in any future version of ArangoDB, so their usage is highly
229250
discouraged. Their functionality is already removed, but they still exist to
230251
prevent unknown startup option errors.
231252

232-
- **arangoimp** executable: ArangoDB release packages install an executable named
253+
- **arangoimp** executable:\
254+
ArangoDB release packages install an executable named
233255
_arangoimp_ as an alias for the _arangoimport_ executable. This is done to
234256
provide compatibility with older releases, in which _arangoimport_ did not
235257
yet exist and was named _arangoimp_. The renaming was actually carried out in
@@ -238,12 +260,14 @@ detailed information about breaking changes before upgrading.
238260
While the _arangoimport_ executable will remain, the _arangoimp_ alias will be
239261
removed in a future version of ArangoDB.
240262

241-
- **HTTP and JavaScript traversal APIs**: The HTTP traversal API
263+
- **HTTP and JavaScript traversal APIs**:\
264+
The HTTP traversal API
242265
is deprecated since version 3.4.0. The JavaScript traversal module
243266
`@arangodb/graph/traversal` is also deprecated since then. The preferred way
244267
to traverse graphs is via AQL.
245268

246-
- **JavaScript-based AQL graph functions**: The following JavaScript-based AQL
269+
- **JavaScript-based AQL graph functions**:\
270+
The following JavaScript-based AQL
247271
graph functions are deprecated:
248272
- `arangodb::GRAPH_EDGES`
249273
- `arangodb::GRAPH_VERTICES`
@@ -264,7 +288,7 @@ detailed information about breaking changes before upgrading.
264288

265289
These functions will be removed in ArangoDB 3.12.
266290

267-
- **Specialized index creation methods in JavaScript API**:
291+
- **Specialized index creation methods in JavaScript API**:\
268292
The following JavaScript methods for creating indexes from the ArangoShell
269293
(_arangosh_) or from within Foxx are deprecated:
270294
- `collection.ensureHashIndex(...)`

0 commit comments

Comments
 (0)