Merge branch 'develop' into content/content-pruning

Former-commit-id: cf1327a

Author: robert-stringer

README.md

@@ -28,13 +28,13 @@ We recommend using MacOS to work with the EDB Docs application.
 
 1. Install Python 3 with `brew install python3`, if it's not already installed. (Use `python3 -V` to check that you have version 3.6 or higher.) Python is not needed for the core Gatsby system, but is required by several source scripts.
 
-1. Install Yarn with `npm i -g yarn`. Yarn is the package manager we're using for this project, instead of NPM.
+1. Install Yarn with `npm i -g yarn`. Yarn is the package manager we're using for this project, instead of NPM. NPM may fail with a permissions related issue. To fix that, ensure that your user account owns the required directory: `sudo chown -R $(whoami) /usr/local/lib/node_modules`
 
 1. Install Gatsby with `npm i -g gatsby-cli`. Gatsby is the software that powers the EDB Docs site.
 
 1. Install all required packages by running `yarn`.
 
-1. Pull the shared icon files down with `git submodule update --init`.
+1. Pull the shared icon files down with `git submodule update --init`. This needs to be run inside of the project folder, if you have cloned the repo using GitHub Desktop, ensure that you have `cd` into the project.
 
 1. And finally, you can start up the site locally with `yarn develop`, which should make it live at `http://localhost:8000/`. Huzzah!
 

README_DOCKER_VSCODE.md

@@ -7,14 +7,15 @@ If you cannot or do not wish to install the prerequisite versions of Python, Nod
 1. [Docker](https://docs.docker.com/get-docker/) (for MacOS or Windows, that'll be Docker Desktop)
 2. [Visual Studio Code](https://code.visualstudio.com/docs/setup/setup-overview)
 3. The [Remote Development Extension Pack](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack) for VSCode
+4. [Git](https://git-scm.com/download)
 
 If you intend to edit using VSCode, I also recommend installing the [MDX extension](https://marketplace.visualstudio.com/items?itemName=silvenon.mdx) - this is not required, but it is handy!
 
 ## Installation
 
 1. In VSCode, from the command pallet select the `Remote-Containers: Clone Repository in Container Volume...` command
 2. Paste in the URL of this repository, or a GitHub branch URL, or a GitHub PR URL 
-3. Choose "isolated volume" (in most cases this will be what you want) 
+3. Choose "unique volume" (in most cases this will be what you want) 
 4. Wait for VSCode to build the container, then open a terminal
 8. Run the site locally with `yarn develop`. VSCode will remap port 8000 used within the container to a free port on your machine, which you can view from the Remote Explorer panel in the left sidebar - or ctrl+click the URL that Gatsby prints in the terminal to open directly.
 

product_docs/docs/bart/2.6/bart_inst/02_installing_bart.mdx

@@ -1,9 +1,5 @@
 ---
 title: 'Installing BART'
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.6.1/installing_bart.html"
 ---
 
 This section will walk you through performing a fresh installation of BART on a host. Installation instructions are organized into the following platform/installer specific sections:

product_docs/docs/bart/2.6/bart_inst/03_configuring_bart.mdx

@@ -1,9 +1,5 @@
 ---
 title: "Configuring BART"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.6.1/configuring_bart.html"
 ---
 
 <div id="configuration" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_inst/04_upgrading_bart.mdx

@@ -1,9 +1,5 @@
 ---
 title: "Upgrading BART"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.6.1/upgrading_bart.html"
 ---
 
 <div id="upgrade" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_inst/05_uninstalling_bart.mdx

@@ -1,9 +1,5 @@
 ---
 title: "Uninstalling BART"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.6.1/uninstalling_bart.html"
 ---
 
 <div id="uninstallation" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_inst/index.mdx

@@ -1,14 +1,6 @@
 ---
 navTitle: Installation Guide
 title: "EDB Postgres Backup and Recovery Installation Guide"
-legacyRedirects:
-  - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.6.1/requirements_overview.html"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.6.1/conclusion.html"
-  - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.6.1/genindex.html"
-  - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.6.1/index.html"
 ---
 
 This guide provides information about how to install and configure the EDB Backup and Recovery Tool (BART) 2.6.

product_docs/docs/bart/2.6/bart_qs_7/index.mdx

@@ -1,10 +1,5 @@
 ---
 title: "Quick Start Guide for RHEL/CentOS 7"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/quick-start/quick-start-guide-for-rhelcentos-7/2.6.1/genindex.html"
-  - "/edb-docs/d/edb-backup-and-recovery-tool/quick-start/quick-start-guide-for-rhelcentos-7/2.6.1/index.html"
 ---
 
 This tutorial demonstrates using `yum` to [install](#installing) and [configure](../bart_qs_8/#configuring) Backup and Recovery Tool (BART) 2.6 on a CentOS 7 host with minimal configuration settings.  The tutorial assumes that the user has some knowledge of installation and system administration procedures, and has administrative privileges on the host.

product_docs/docs/bart/2.6/bart_qs_8/index.mdx

@@ -1,10 +1,5 @@
 ---
 title: "Quick Start Guide for RHEL/CentOS 8"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/quick-start/quick-start-guide-for-rhelcentos-8/2.6.1/genindex.html"
-  - "/edb-docs/d/edb-backup-and-recovery-tool/quick-start/quick-start-guide-for-rhelcentos-8/2.6.1/index.html"
 ---
 
 This tutorial demonstrates using the `dnf` command to install and configure the EDB Backup and Recovery Tool (BART) 2.6 on a CentOS 8 host with minimal configuration settings.  The tutorial assumes that the user has some knowledge of installation and system administration procedures and has administrative privileges on the host.

product_docs/docs/bart/2.6/bart_ref/01_bart_subcommands_examples/01_backup.mdx

@@ -1,9 +1,5 @@
 ---
 title: "BACKUP"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.6.1/backup.html"
 ---
 
 Use the `BACKUP` subcommand to create a full or incremental backup.

product_docs/docs/bart/2.6/bart_ref/01_bart_subcommands_examples/02_check_config.mdx

@@ -1,9 +1,5 @@
 ---
 title: "CHECK-CONFIG"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.6.1/check_config.html"
 ---
 
 The `CHECK-CONFIG` subcommand checks the global parameter settings as well as the database server configuration in the BART configuration file.

product_docs/docs/bart/2.6/bart_ref/01_bart_subcommands_examples/03_delete.mdx

@@ -1,9 +1,5 @@
 ---
 title: "DELETE"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.6.1/delete.html"
 ---
 
 The `DELETE` subcommand removes the subdirectory and data files from the BART backup catalog for the specified backups along with archived WAL files.

product_docs/docs/bart/2.6/bart_ref/01_bart_subcommands_examples/04_init.mdx

@@ -1,9 +1,5 @@
 ---
 title: "INIT"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.6.1/init.html"
 ---
 
 <div id="init" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_ref/01_bart_subcommands_examples/05_manage.mdx

@@ -1,9 +1,5 @@
 ---
 title: "MANAGE"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.6.1/manage.html"
 ---
 
 The `MANAGE` subcommand can be invoked to:

product_docs/docs/bart/2.6/bart_ref/01_bart_subcommands_examples/06_restore.mdx

@@ -1,9 +1,5 @@
 ---
 title: "RESTORE"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.6.1/restore.html"
 ---
 
 The `RESTORE` subcommand restores a backup and its archived WAL files for the designated database server to the specified directory location.

product_docs/docs/bart/2.6/bart_ref/01_bart_subcommands_examples/07_show_servers.mdx

@@ -1,9 +1,5 @@
 ---
 title: "SHOW-SERVERS"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.6.1/show_servers.html"
 ---
 
 The `SHOW-SERVERS` subcommand displays information for the managed database servers listed in the BART configuration file.

product_docs/docs/bart/2.6/bart_ref/01_bart_subcommands_examples/08_show_backups.mdx

@@ -1,9 +1,5 @@
 ---
 title: "SHOW-BACKUPS"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.6.1/show_backups.html"
 ---
 
 The `SHOW-BACKUPS` subcommand displays the backup information for the managed database servers.

product_docs/docs/bart/2.6/bart_ref/01_bart_subcommands_examples/09_verify_chksum.mdx

@@ -1,9 +1,5 @@
 ---
 title: "VERIFY-CHKSUM"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.6.1/verify_chksum.html"
 ---
 
 The `VERIFY-CHKSUM` subcommand verifies the MD5 checksums of the full backups and any user-defined tablespaces for the specified database server or for all database servers. The checksum is verified by comparing the current checksum of the backup against the checksum when the backup was taken.

product_docs/docs/bart/2.6/bart_ref/01_bart_subcommands_examples/10_running_the_bart_wal_scanner.mdx

@@ -1,9 +1,5 @@
 ---
 title: "Running the BART WAL Scanner"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.6.1/running_the_bart_wal_scanner.html"
 ---
 
 The BART WAL scanner is used to process each WAL file to find and record modified blocks in a corresponding MBM file. As a BART account user, use the BART WAL scanner to invoke the `bart-scanner` program located in the `<BART_HOME>/bin` directory.

product_docs/docs/bart/2.6/bart_ref/01_bart_subcommands_examples/index.mdx

@@ -1,9 +1,5 @@
 ---
 title: "BART Subcommand Syntax and Examples"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.6.1/bart_subcommands_examples.html"
 ---
 
 <div id="using_bart_subcommands" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_ref/02_additional_examples.mdx

@@ -1,9 +1,5 @@
 ---
 title: "Additional Examples"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.6.1/additional_examples.html"
 ---
 
 <div id="examples" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_ref/03_sample_bart_system_with_local_and_remote_database_servers.mdx

@@ -1,9 +1,5 @@
 ---
 title: "Sample BART System with Local and Remote Database Servers"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.6.1/sample_bart_system_with_local_and_remote_database_servers.html"
 ---
 
 <div id="a_sample_bart_system_with_local_and_remote_database_servers" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_ref/index.mdx

@@ -1,12 +1,6 @@
 ---
 navTitle: Reference Guide
 title: "EDB Postgres Backup and Recovery Reference Guide"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.6.1/genindex.html"
-  - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.6.1/conclusion.html"
-  - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.6.1/index.html"
 ---
 
 This guide acts as a quick reference for BART subcommands and provides comprehensive examples of the following BART operations:

product_docs/docs/bart/2.6/bart_user/01_introduction.mdx

@@ -1,9 +1,5 @@
 ---
 title: "Introduction"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.6.1/introduction.html"
 ---
 
 The EDB Backup and Recovery Tool (BART) is an administrative utility that provides simplified backup and recovery management for multiple local or remote EDB Advanced Server and PostgreSQL database servers.

product_docs/docs/bart/2.6/bart_user/02_overview/01_block-level_incremental_backup/01_incremental_backup_limitations_and_requirements.mdx

@@ -1,9 +1,5 @@
 ---
 title: "Incremental Backup Limitations and Requirements"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.6.1/incremental_backup_limitations_and_requirements.html"
 ---
 
 <div id="incremental_backup_limitations_and_requirements" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_user/02_overview/01_block-level_incremental_backup/02_concept_overview.mdx

@@ -1,9 +1,5 @@
 ---
 title: "Concept Overview"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.6.1/concept_overview.html"
 ---
 
 <div id="concept_overview" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_user/02_overview/01_block-level_incremental_backup/03_wal_scanning_preparation_for_an_incremental_backup.mdx

@@ -1,9 +1,5 @@
 ---
 title: "WAL Scanning – Preparation for an Incremental Backup"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.6.1/wal_scanning_preparation_for_an_incremental_backup.html"
 ---
 
 <div id="wal_scanning_preparation_for_an_incremental_backup" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_user/02_overview/01_block-level_incremental_backup/04_performing_an_incremental_backup.mdx

@@ -1,9 +1,5 @@
 ---
 title: "Performing an Incremental Backup"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.6.1/performing_an_incremental_backup.html"
 ---
 
 <div id="performing_an_incremental_backup" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_user/02_overview/01_block-level_incremental_backup/05_restoring_an_incremental_backup.mdx

@@ -1,9 +1,5 @@
 ---
 title: "Restoring an Incremental Backup"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.6.1/restoring_an_incremental_backup.html"
 ---
 
 <div id="restoring_an_incremental_backup" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_user/02_overview/01_block-level_incremental_backup/index.mdx

@@ -1,9 +1,5 @@
 ---
 title: "Block-Level Incremental Backup"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.6.1/block-level_incremental_backup.html"
 ---
 
 <div id="block-level_incremental_backup" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_user/02_overview/02_creating_a_backup_chain.mdx

@@ -1,9 +1,5 @@
 ---
 title: "Creating a Backup Chain"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.6.1/creating_a_backup_chain.html"
 ---
 
 <div id="creating_a_backup_chain" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_user/02_overview/index.mdx

@@ -1,9 +1,5 @@
 ---
 title: "Overview"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.6.1/overview.html"
 ---
 
 <div id="overview" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_user/03_using_bart/01_bart_management_overview/01_performing_a_restore_operation.mdx

@@ -1,9 +1,5 @@
 ---
 title: "Performing a Restore Operation"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.6.1/performing_a_restore_operation.html"
 ---
 
 <div id="performing_a_restore_operation" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_user/03_using_bart/01_bart_management_overview/02_point_in_time_recovery_operation.mdx

@@ -1,9 +1,5 @@
 ---
 title: "Point-In-Time Recovery Operation"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.6.1/point_in_time_recovery_operation.html"
 ---
 
 <div id="point_in_time_recovery_operation" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_user/03_using_bart/01_bart_management_overview/index.mdx

@@ -1,9 +1,5 @@
 ---
 title: "BART Management Overview"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.6.1/bart_management_overview.html"
 ---
 
 <div id="bart_management_overview" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/01_overview_managing_backups_using_a_retention_policy.mdx

@@ -1,9 +1,5 @@
 ---
 title: "Overview - Managing Backups Using a Retention Policy"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.6.1/overview_managing_backups_using_a_retention_policy.html"
 ---
 
 <div id="overview_managing_backups_using_a_retention_policy" class="registered_link"></div>

product_docs/docs/bart/2.6/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/02_marking_the_backup_status.mdx

@@ -1,9 +1,5 @@
 ---
 title: "Marking the Backup Status"
-
-legacyRedirectsGenerated:
-  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
-  - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.6.1/marking_the_backup_status.html"
 ---
 
 <div id="marking_the_backup_status" class="registered_link"></div>