DOCS-156 fixing links

Author: Bob Grabar

source/administration/backups.txt

@@ -4,30 +4,33 @@ Backup and Restoration Strategies
 
 .. default-domain:: mongodb
 
-This document provides an inventory of database backup strategies for
+This document describes database backup strategies for
 use with MongoDB. This document contains the following sections:
 
 - :ref:`backup-overview` and :ref:`backup-considerations` describe the
   approaches for backing up your MongoDB environment.
 
-- :ref:`block-level-backup` and :ref:`database-dumps` describe specific
-  strategies.
-
 - :ref:`sharded-cluster-backups` describes considerations specific to
   :term:`sharded clusters <sharded cluster>`.
 
 - :ref:`replica-set-backups` describes considerations
   specific to :term:`replica sets <replica set>`.
 
+See also:
+
+- :doc:`/tutorial/backup-databases-with-filesystem-snapshots`
+
+- :doc:`/tutorial/backup-databases-with-binary-database-dumps`
+
 .. _backup-overview:
 
-Backup Overview
----------------
+Backup Strategies
+-----------------
 
-Production systems should always have some consideration and strategy
+For MongoDB production systems, you should implement a strategy
 for taking and restoring backups. The goal of a backup strategy is to
-produce a full and consistent copy of the data that you can use to
-bring up a new or replacement database instance. However, in some
+produce a full and consistent copy of the data to use to
+bring up a new or replacement database instance. In some
 cases, taking backups is difficult or impossible, given large data
 volumes, distributed architectures, and data transmission speeds.
 
@@ -36,15 +39,15 @@ Nevertheless, with MongoDB, there are two major approaches to backups:
 
 - Using system-level tools, like disk image snapshots.
 
-  See :ref:`block-level-backup`.
+  See :doc:`/tutorial/backup-databases-with-filesystem-snapshots`.
 
 - Using various capacities present in the :program:`mongodump` tool.
 
-  See :ref:`database-dumps`.
+  See :doc:`/tutorial/backup-databases-with-binary-database-dumps`.
 
 The methods described in this document operate by copying the data file
 on the disk level. If your system does not provide functionality for
-this kind of backup, see the section on :ref:`database-dumps`.
+this kind of backup, see :doc:`/tutorial/backup-databases-with-binary-database-dumps`.
 
 Ensuring that the state captured by the backup is consistent and usable
 is the primary challenge of producing backups of database systems.

source/administration/replication-architectures.txt

@@ -163,7 +163,7 @@ dedicated :ref:`hidden member <replica-set-hidden-members>` for the
 purpose of creating backups.
 
 If this member runs with journaling enabled, you can safely use standard
-:ref:`block level backup methods <block-level-backup>` to create a
+:doc:`block level backup methods </tutorial/backup-databases-with-filesystem-snapshots>` to create a
 backup of this member. Otherwise, if your underlying system does not
 support snapshots, you can connect :program:`mongodump` to create a
 backup directly from the secondary member. In these cases, use the

source/reference/mongodump.txt

@@ -212,7 +212,7 @@ from :term:`secondary` members of the set.
 Usage
 -----
 
-See the ":ref:`backup guide section on database dumps <database-dumps>`"
+See the :doc:`/tutorial/backup-databases-with-binary-database-dumps`
 for a larger overview of :program:`mongodump` usage. Also see the
 ":doc:`mongorestore`" document for an overview of the
 :program:`mongorestore`, which provides the related inverse

source/reference/mongorestore.txt

@@ -230,8 +230,8 @@ Options
 Usage
 -----
 
-See the ":ref:`backup guide section on database dumps
-<database-dumps>`" for a larger overview of :program:`mongorestore`
+See :doc:`/tutorial/backup-databases-with-binary-database-dumps`
+for a larger overview of :program:`mongorestore`
 usage. Also see the ":doc:`mongodump`" document for an overview of the
 :program:`mongodump`, which provides the related inverse
 functionality.

source/tutorial/backup-databases-with-binary-database-dumps.txt

@@ -4,8 +4,6 @@ Backup Databases Using Binary Database Dumps
 
 .. default-domain:: mongodb
 
-.. _database-dumps:
-
 This section describes the process for writing the entire contents of
 your MongoDB instance to a file in a binary format. If
 disk-level snapshots are not available, this approach
@@ -19,7 +17,7 @@ provides the best option for full system database backups.
    these documents.
 
    If your system has disk level snapshot capabilities, consider the
-   backup methods described in :ref:`block-level-backup`.
+   backup methods described in :doc:`/tutorial/backup-databases-with-filesystem-snapshots`.
 
 Database Dump with ``mongodump``
 --------------------------------

source/tutorial/backup-databases-with-filesystem-snapshots.txt

@@ -4,8 +4,6 @@ Backup Databases Using Block Level Backup Methods
 
 .. default-domain:: mongodb
 
-.. _block-level-backup:
-
 This section provides an overview of using disk/block level
 snapshots (i.e. :term:`LVM` or storage appliance) to backup a MongoDB
 instance. These tools make a quick block-level backup of the device

source/tutorial/backup-sharded-cluster-with-filesystem-snapshots.txt

@@ -78,7 +78,7 @@ shard.
 #. Back up the replica set members of the shards that you locked. You
    may back up the shards in parallel. For each shard, create a
    snapshot. Use the procedures in
-   :ref:`block-level-backup`.
+   :doc:`/tutorial/backup-databases-with-filesystem-snapshots`.
 
 #. Unlock all locked replica set members of each shard using the
    :method:`db.fsyncUnlock()` method in the :program:`mongo` shell.