Skip to content

Commit 69bd300

Browse files
committed
Updates based on feedback
1 parent 1afdecd commit 69bd300

File tree

1 file changed

+8
-20
lines changed

1 file changed

+8
-20
lines changed

content/riak/kv/2.1.4/using/cluster-operations/backing-up.md

Lines changed: 8 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -23,11 +23,11 @@ aliases:
2323
[concept aae]: /riak/kv/2.1.4/learn/concepts/active-anti-entropy/
2424
[aae read repair]: /riak/kv/2.1.4/learn/concepts/active-anti-entropy/#read-repair-vs-active-anti-entropy
2525

26-
Riak KV is a [clustered][concept clusters] system built to survive a wide range of failure scenarios including the loss of nodes due to network or hardware failure. Although this is one of Riak KV's core strengths, it cannot withstand all failure scenarios.
26+
Riak KV is a [clustered][concept clusters] system built to survive a wide range of failure scenarios, including the loss of nodes due to network or hardware failure. Although this is one of Riak KV's core strengths, it cannot withstand all failure scenarios.
2727

28-
Backing up data; duplicating the database on a different long-term storage system, is a common approach to mitigating potential failure scenarios.
28+
Backing up data (duplicating the database on a different long-term storage system) is a common approach to mitigating potential failure scenarios.
2929

30-
The following document covers how to perform backups of Riak KV data.
30+
This page covers how to perform backups of Riak KV data.
3131

3232
## Overview
3333

@@ -37,9 +37,9 @@ Choosing your Riak KV backup strategy will depend on your already-established ba
3737

3838
The basic process for getting a backup of Riak KV from a node is as follows:
3939

40-
1. Stop the node with `riak stop`.
40+
1. Stop Riak KV with `riak stop`.
4141
2. Backup the appropriate data, ring, and configuration directories.
42-
3. Start the node.
42+
3. Start Riak KV.
4343

4444
Downtime of a node can be significantly reduced by using an OS feature or filesystem that supports snapshotting.
4545

@@ -53,14 +53,6 @@ Data could exist on some nodes and not others at the exact time a backup is made
5353

5454
The default Riak KV data, ring, and configuration directories for each of the supported operating systems is as follows:
5555

56-
{{% note title="Note on upgrading" %}}
57-
If you are upgrading to Riak KV version 2.0 or later from a pre-2.0 release, you can use either your old `app.config` configuration file or the newer `riak.conf` if you wish.
58-
59-
If you have installed Riak 2.0 directly, you should use only `riak.conf`.
60-
61-
More on configuring Riak KV can be found in the [configuration reference](/riak/kv/2.1.4/configuring/reference).
62-
{{% /note %}}
63-
6456
#### Debian and Ubuntu
6557

6658
Data | Directory
@@ -136,26 +128,22 @@ Cluster Metadata | `/opt/riak/cluster_meta`
136128
Search | `/opt/riak/yz`
137129
Strong consistency | `/opt/riak/data/ensembles`
138130

139-
{{% note title="Note on strong consistency directories" %}}
140-
The listings above show directories for data related to Riak's [strong consistency][use ref strong consistency] feature. This feature is purely optional, so `/ensembles` directories will not exist in your installation if this feature is not being used. For more information, see [Using Strong Consistency](/riak/kv/2.1.4/developing/app-guide/strong-consistency) and [Managing Strong Consistency](/riak/kv/2.1.4/using/cluster-operations/strong-consistency).
141-
{{% /note %}}
142-
143131
## Performing Backups
144132

145133
{{% note title="Deprecation notice" %}}
146134
In previous versions of Riak KV, there was a [`riak-admin backup`](/riak/kv/2.1.4/using/admin/riak-admin/#backup) command commonly used for
147135
backups. This functionality is now deprecated. We strongly recommend using the backup procedure documented below instead.
148136
{{% /note %}}
149137

150-
Backups can be accomplished through a variety of common methods. Standard utilities such `cp`, `rsync`, and `tar` can be used as well as any backup system already in place in your environment.
138+
Backups can be accomplished through a variety of common methods. Standard utilities such `cp`, `rsync`, and `tar` can be used, as well as any backup system already in place in your environment.
151139

152-
A simple shell command such as the following examples is sufficient for creating a backup of your Bitcask or LevelDB data, ring, and Riak KV configuration directories for a binary package-based Riak KV Linux
140+
A simple shell command, like those in the following examples, are sufficient for creating a backup of your Bitcask or LevelDB data, ring, and Riak KV configuration directories for a binary package-based Riak KV Linux
153141
installation.
154142

155143
The following examples use `tar`:
156144

157145
{{% note %}}
158-
Backups must be performed on a stopped node to prevent data loss.
146+
Backups must be performed on while Riak KV is stopped to prevent data loss.
159147
{{% /note %}}
160148

161149
### Bitcask

0 commit comments

Comments
 (0)