Skip to content

Commit 7bf646d

Browse files
authored
Removal of Active Failover (#377)
* Remove AF content from 3.12 except drivers and integrations * Deprecation warning in 3.11, upgrading to cluster
1 parent e0ee542 commit 7bf646d

File tree

38 files changed

+105
-974
lines changed

38 files changed

+105
-974
lines changed

site/content/3.11/deploy/active-failover/_index.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,11 @@ An _Active Failover_ is defined as:
1818
An _Active Failover_ behaves differently from an [ArangoDB Cluster](../cluster/_index.md),
1919
please see the [limitations section](#limitations) for more details.
2020

21+
{{< warning >}}
22+
The Active Failover deployment mode is deprecated and will no longer be
23+
supported in the next minor version of ArangoDB, from v3.12 onward.
24+
{{< /warning >}}
25+
2126
![ArangoDB Active Failover](../../../images/leader-follower.png)
2227

2328
The advantage of the _Active Failover_ setup is that there is an active third party, the _Agency_,

site/content/3.11/operations/upgrading/manual-deployments/active-failover.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,11 @@ to a new hotfix version, or to perform an upgrade to a new minor version of Aran
1919
Please refer to the [Upgrade paths](../_index.md#upgrade-paths) section
2020
for detailed information.
2121

22+
{{< warning >}}
23+
The Active Failover deployment mode is deprecated and will no longer be
24+
supported in the next minor version of ArangoDB, from v3.12 onward.
25+
{{< /warning >}}
26+
2227
## Preparations
2328

2429
The ArangoDB installation packages (e.g. for Debian or Ubuntu) set up a

site/content/3.11/release-notes/version-3.11/incompatible-changes-in-3-11.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,12 @@ description: >-
77
this ArangoDB version and adjust any client applications if necessary
88
archetype: default
99
---
10+
## Active Failover deployment mode deprecation
11+
12+
Running a single server with asynchronous replication to one or more passive
13+
single servers for automatic failover is deprecated and will no longer be
14+
supported in the next minor version of ArangoDB, from v3.12 onward.
15+
1016
## Extended naming constraints for collections, Views, and indexes
1117

1218
In ArangoDB 3.9, the `--database.extended-names-databases` startup option was

site/content/3.12/about-arangodb/features/_index.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -75,9 +75,7 @@ See all [Enterprise Edition Features](enterprise-edition.md).
7575

7676
You can install ArangoDB on your local machine or run it in a Docker container
7777
for development purposes. You can deploy it on-premises as a
78-
[single server](../../deploy/single-instance/_index.md), optionally
79-
as a resilient pair with asynchronous replication and automatic failover
80-
([Active Failover](../../deploy/active-failover/_index.md)),
78+
[single server](../../deploy/single-instance/_index.md)
8179
or as a [cluster](../../deploy/cluster/_index.md)
8280
comprised of multiple nodes with synchronous replication and automatic failover
8381
for high availability and resilience. For the highest level of data safety,

site/content/3.12/about-arangodb/features/community-edition.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -67,10 +67,6 @@ see [arangodb.com/community-server/](https://www.arangodb.com/community-server/)
6767
is reached. Synchronous replication works on a per-shard basis. For each
6868
collection, you can configure how many copies of each shard are kept in the cluster.
6969

70-
- [**Active Failover**](../../deploy/active-failover/_index.md):
71-
Run a single server with asynchronous replication to one or more passive
72-
single servers for automatic failover.
73-
7470
- [**Automatic Failover Cluster**](../../deploy/cluster/_index.md#automatic-failover):
7571
If a nodes goes down, another node takes over to avoid any downtime. <!-- TODO: Can we say that? -->
7672

site/content/3.12/components/tools/arangobackup/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Hot backups rely on hard link magic performed on the database's
2323
persistence layer.
2424

2525
_arangobackup_ can be used for all ArangoDB deployment modes
26-
(Single Instance, Active Failover, Cluster). It always creates what
26+
(Single Instance, Cluster). It always creates what
2727
is most readily described as a persistence layer consistent snapshot
2828
of the entire instance. Therefore, no such thing as database or
2929
collection level hot backup exists. Consequently, unlike with

site/content/3.12/components/tools/arangodb-starter/architecture.md

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -45,10 +45,9 @@ arangod --version
4545

4646
## Starter deployment modes
4747

48-
The Starter supports 3 different modes of ArangoDB deployments:
48+
The Starter supports different modes of ArangoDB deployments:
4949

5050
1. Single server
51-
1. Active failover
5251
1. Cluster
5352

5453
Note: Datacenter replication is an option for the `cluster` deployment mode.
@@ -153,11 +152,10 @@ Running the Starter with the configuration example above and adding the
153152

154153
## Running on multiple machines
155154

156-
For the `activefailover` and `cluster` mode, it is required to run multiple
157-
Starters, as every Starter only launches a subset of all servers needed
158-
to form the entire deployment.
159-
In the `cluster` mode, for example, a single Starter launches at most one Agent,
160-
one DB-Server, and one Coordinator.
155+
For the `cluster` mode, it is required to run multiple Starters, as every Starter
156+
only launches a subset of all servers needed to form the entire deployment.
157+
For example, a single Starter launches at most one Agent, one DB-Server, and one
158+
Coordinator.
161159

162160
It is the responsibility of the user to run the Starter on multiple machines such
163161
that enough servers are started to form the entire deployment.
@@ -191,8 +189,8 @@ The `setup.json` config file must not be edited manually.
191189

192190
## Running on multiple machines (under the hood)
193191

194-
As mentioned above, when the Starter is used to create an `activefailover`
195-
or `cluster` deployment, it first creates a "cluster" of Starters.
192+
As mentioned above, when the Starter is used to create a or `cluster` deployment,
193+
it first creates a "cluster" of Starters.
196194

197195
These are the steps taken by the Starters to bootstrap such a deployment
198196
from scratch.

site/content/3.12/components/tools/arangodb-starter/options.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -42,12 +42,11 @@ for details.
4242
Start a local (test) cluster. Since all servers are running on a single machine
4343
this is really not intended for production setups.
4444

45-
- `--starter.mode=cluster|single|activefailover`
45+
- `--starter.mode=cluster|single`
4646

4747
Select what kind of database configuration you want.
48-
This can be a `cluster` configuration (which is the default),
49-
a `single` server configuration or a `activefailover` configuration with
50-
2 single services configured to take over when needed.
48+
This can be a `cluster` configuration (which is the default) or a
49+
`single` server configuration.
5150

5251
Note that when running a `single` server configuration you lose all
5352
high availability features that a cluster provides you.

site/content/3.12/components/tools/arangodump/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ If you want to export for external programs to formats like JSON or CSV, see
1414
[_arangobackup_](../arangobackup/_index.md).
1515

1616
_arangodump_ can be used for all ArangoDB deployments modes (Single Instance,
17-
Active Failover, Cluster and DC2DC) and it can backup selected collections
17+
Cluster, and DC2DC) and it can backup selected collections
1818
or all collections of a database, optionally including _system_ collections. One
1919
can backup the structure, i.e. the collections with their configuration without
2020
any data, only the data stored in them, or both. If you are using the Enterprise

site/content/3.12/components/tools/arangodump/limitations.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,5 @@ _arangodump_ has the following limitations:
1212
[Hot Backups](../../../operations/backup-and-restore.md#hot-backups) for an alternative). It is
1313
therefore recommended not to perform any data-modification operations on the
1414
cluster while _arangodump_ is running. This is in contrast to what happens on
15-
a single instance or an active failover setup, where even if
16-
write operations are ongoing, the created dump is consistent, as a snapshot
17-
is taken when the dump starts.
15+
a single instance, where even if write operations are ongoing, the created dump
16+
is consistent, as a snapshot is taken when the dump starts.

0 commit comments

Comments
 (0)