Merge pull request #3571 from EnterpriseDB/release/2023-01-25

Release: 2023-01-25

advocacy_docs/supported-open-source/postgresql/installer/02_installing_postgresql_with_the_graphical_installation_wizard/index.mdx

@@ -1,27 +1,24 @@
 ---
-title: "Installing PostgreSQL with the Graphical Installation Wizard"
+title: "Installing PostgreSQL"
 legacyRedirects:
   - "/edb-docs/d/postgresql/installation-getting-started/installation-guide/13.0/installing_postgresql_with_the_graphical_installation_wizard.html"
   - "/edb-docs/d/postgresql/installation-getting-started/installation-guide-installers/11/PostgreSQL_Installation_Guide.1.07.html"
   - "/edb-docs/d/postgresql/installation-getting-started/installation-guide-installers/12/installing_postgresql_with_the_graphical_installation_wizard.html"
   - "/edb-docs/d/postgresql/installation-getting-started/installation-guide-installers/9.5/PostgreSQL_Installation_Guide.1.07.html"
   - "/edb-docs/d/postgresql/installation-getting-started/installation-guide-installers/9.6/PostgreSQL_Installation_Guide.1.07.html"
   - "/edb-docs/d/postgresql/installation-getting-started/installation-guide-installers/10/PostgreSQL_Installation_Guide.1.08.html"
+navigation:
+  - windows
+  - macos
 ---
 
-The graphical installation wizard provides a quick and easy way to install PostgreSQL on a Mac or Windows system. As the installation wizard’s easy-to-follow dialogs lead you through the installation process, specify information about your system. When the dialogs are complete, the setup wizard will perform an installation based on the selections made during the setup process.
+EDB installation wizards provide an easy way to install PostgreSQL on a Mac or Windows system. A series of dialogs lead you through the installation process, allowing you to specify information about your system. When the dialogs are complete, the wizard performs an installation based on the selections made during the setup process.
 
 !!! Note
-    If you are invoking the graphical installer to perform a system upgrade, the installer will preserve the configuration options specified during the previous installation.
+    If you are invoking the graphical installation wizard to perform a system upgrade, the installer will preserve the configuration options specified during the previous installation.
 
-When the PostgreSQL installation finishes, you will be offered the option to invoke the Stack Builder package manager. Stack Builder provides an easy-to-use graphical interface that downloads and installs applications, drivers and utilities and their dependencies. See [Using Stack Builder](../03_using_stackbuilder) for more information.
+When the PostgreSQL installation finishes, you are given the option to invoke the Stack Builder package manager. Stack Builder provides an easy-to-use graphical interface that downloads and installs applications, drivers, utilities, and their dependencies. See [Using Stack Builder](../03_using_stackbuilder) for more information.
 
-The graphical PostgreSQL installer is available on the [EDB website](http://www.enterprisedb.com/downloads/postgres-postgresql-downloads).
+The EDB graphical PostgreSQL installer is available on the [EDB website](http://www.enterprisedb.com/downloads/postgres-postgresql-downloads).
 
-The PostgreSQL installer is available on the [EDB website](https://www.enterprisedb.com/postgresql-early-experience).
-
-<div class="toctree" maxdepth="5">
-
-invoking_the_graphical_installer
-
-</div>
+The PostgreSQL installer is also available on the [EDB website](https://www.enterprisedb.com/postgresql-early-experience).

advocacy_docs/supported-open-source/postgresql/installer/02_installing_postgresql_with_the_graphical_installation_wizard/macos.mdx

@@ -0,0 +1,27 @@
+---
+title: "Installing PostgreSQL on Mac OS X"
+navTitle: "On Mac OS X"
+---
+
+EDB provides MacOS installers for PostgreSQL at the [downloads page of the EnterpriseDB website](https://www.enterprisedb.com/downloads/postgres-postgresql-downloads). These installers simplify the process of setting up a system.
+
+For a detailed walk-through of the installation process on Mac OS, see [this tutorial](https://www.enterprisedb.com/postgres-tutorials/installation-postgresql-mac-os).
+
+## Command line tools
+
+After installing PostgreSQL, you can run command line tools by referencing them in the `bin` directory under the installation path you specified during installation. For example, to run `psql` from the default installation directory, enter:
+
+```shell
+/Library/PostgreSQL/12/bin/psql -U postgres
+```
+
+For ease of use, you may want to add this directory to your PATH by adding a line to your `~/.bash_profile` (or `~/.zshrc` if using zsh):
+
+```shell
+export PATH="/Library/PostgreSQL/12/bin/:$PATH"
+```
+
+This step is *especially* important if you plan to use scripts or other software (such as Python's `psycopg2`) that rely on PostgreSQL tools. You may instead [add this directory to the system path](https://apple.stackexchange.com/questions/106355/setting-the-system-wide-path-environment-variable-in-mavericks/106814#106814).
+
+There are several other options for installing PostgreSQL on MacOS, with varying levels of flexibility, version support, add-ons, and so forth. More details can be found on [the PostgreSQL website](https://www.postgresql.org/download/macosx/).
+

advocacy_docs/supported-open-source/postgresql/installer/02_installing_postgresql_with_the_graphical_installation_wizard/01_invoking_the_graphical_installer.mdx → advocacy_docs/supported-open-source/postgresql/installer/02_installing_postgresql_with_the_graphical_installation_wizard/windows.mdx

@@ -1,23 +1,23 @@
 ---
-title: "Invoking the Graphical Installer"
+title: "Installing PostgreSQL on Windows"
+navTitle: "On Windows"
 legacyRedirects:
   - "/edb-docs/d/postgresql/installation-getting-started/installation-guide/13.0/invoking_the_graphical_installer.html"
   - "/edb-docs/d/postgresql/installation-getting-started/installation-guide-installers/11/PostgreSQL_Installation_Guide.1.08.html"
   - "/edb-docs/d/postgresql/installation-getting-started/installation-guide-installers/12/invoking_the_graphical_installer.html"
   - "/edb-docs/d/postgresql/installation-getting-started/installation-guide-installers/9.5/PostgreSQL_Installation_Guide.1.08.html"
   - "/edb-docs/d/postgresql/installation-getting-started/installation-guide-installers/9.6/PostgreSQL_Installation_Guide.1.08.html"
   - "/edb-docs/d/postgresql/installation-getting-started/installation-guide-installers/10/PostgreSQL_Installation_Guide.1.09.html"
+redirects:
+  - /supported-open-source/postgresql/installer/02_installing_postgresql_with_the_graphical_installation_wizard/01_invoking_the_graphical_installer/
 ---
+The following section describes how to use the graphical installation wizard to install PostgreSQL on Windows. For information about preparing to use command line tools after installation, see [Command line tools](#command-line-tools).
 
+## Installing PostgreSQL
 
+To perform an installation using the graphical installation wizard, you must have superuser or administrator privileges. To start the installation wizard, assume sufficient privileges and double-click the installer icon; if prompted, provide a password.
 
-To perform an installation using the graphical installation wizard, you must have superuser or administrator privileges.
-
-The following section walks you through installing PostgreSQL on a Windows host.
-
-To start the installation wizard, assume sufficient privileges and double-click the installer icon; if prompted, provide a password.
-
-Note that in some versions of Windows, to invoke the installer with Administrator privileges, you need to right-click on the installer icon and select `Run as Administrator` from the context menu.
+In some versions of Windows, to invoke the installer with Administrator privileges, you must right-click on the installer icon and select `Run as Administrator` from the context menu.
 
 The PostgreSQL setup wizard opens. Click `Next` to continue.
 
@@ -101,3 +101,21 @@ Before the setup wizard completes the PostgreSQL installation, it offers to laun
 ![The installation wizard offers to Launch Stack Builder at exit](../images/installation_complete.png)
 
 Fig. 11: The installation wizard offers to Launch Stack Builder at exit
+
+## Command line tools
+
+By default, the installer does not modify the system path. If you want to use command line tools (such as `psql`), you can add PostgreSQL to the path after installation.
+
+1.  Open the System Properties control panel and select the **Advanced** tab (or run `SystemPropertiesAdvanced.exe`)
+2.  Click **Environment Variables** to open the environment variables editor.
+3.  Find the `Path` variable under the **System variables** heading and click **Edit**.
+4.  Add the path that you specified as the installation directory during installation, with `\bin` appended (by default: `c:\program files\postgresql\15\bin`, where *15* is the version of PostgreSQL that you installed).
+
+To test your installation, open a new command prompt and run this command:
+
+```shell
+psql -U postgres
+```
+
+You are prompted for the password you provided during installation. For more information [about psql...](http://postgresguide.com/utilities/psql.html).
+

advocacy_docs/supported-open-source/postgresql/installer/04_installation_troubleshooting.mdx

@@ -9,10 +9,6 @@ legacyRedirects:
   - "/edb-docs/d/postgresql/installation-getting-started/installation-guide-installers/10/PostgreSQL_Installation_Guide.1.22.html"
 ---
 
-
-
-
-
 If you encounter any problems during installation, please consult the installation logfile. The log file is created in:
 
 -   `/tmp` on Mac OS X

advocacy_docs/supported-open-source/postgresql/installer/05_uninstalling_postgresql.mdx

@@ -9,8 +9,6 @@ legacyRedirects:
   - "/edb-docs/d/postgresql/installation-getting-started/installation-guide-installers/10/PostgreSQL_Installation_Guide.1.18.html"
 ---
 
-
-
 The PostgreSQL installer creates an uninstaller in the PostgreSQL installation directory. This section walks you through uninstalling PostgreSQL on a Windows as well as a Mac host.
 
 !!! note
@@ -68,7 +66,7 @@ Where `version` is the version of PostgreSQL you installed.
 
 Then, invoke the uninstaller with the command:
 
-`open uninstall-postgres.app`
+`open uninstall-postgresql.app`
 
 If prompted, provide a password that allows the uninstaller to make changes to your system. The uninstaller will open, asking you if you wish to uninstall the entire application or individual components.
 

advocacy_docs/supported-open-source/postgresql/installer/index.mdx

@@ -9,6 +9,12 @@ legacyRedirects:
   - "/edb-docs/d/postgresql/installation-getting-started/installation-guide-installers/9.5/toc.html"
   - "/edb-docs/d/postgresql/installation-getting-started/installation-guide-installers/9.6/toc.html"
   - "/edb-docs/d/postgresql/installation-getting-started/installation-guide-installers/10/toc.html"
+navigation:
+  - 01_requirements_overview
+  - 02_installing_postgresql_with_the_graphical_installation_wizard
+  - 03_using_stackbuilder
+  - 05_uninstalling_postgresql
+  - 04_installation_troubleshooting
 ---
 
 The PostgreSQL installers created by EnterpriseDB are designed to make it quick and simple to install PostgreSQL on your computer. The installer provides:

product_docs/docs/biganimal/release/pricing_and_billing/index.mdx

@@ -6,14 +6,16 @@ The costs include database pricing for BigAnimal and the associated costs from o
 
 ## Database pricing 
 
-Pricing is based on the number of virtual central processing units (vCPUs) provisioned for the database software offering. Consumption of vCPUs is metered hourly. A deployment is made up of either one instance or one primary and two standby replica instances of either PostgreSQL or EDB Postgres Advanced Server. When high availability is enabled, multiply the number of vCPUs per instance by three to calculate the full price for all resources used. The table shows the cost breakdown:
+Pricing is based on the number of virtual central processing units (vCPUs) provisioned for the database software offering. Consumption of vCPUs is metered hourly. A deployment is typically made up of either one instance or one primary and two standby replica instances of either PostgreSQL or EDB Postgres Advanced Server. When high availability configurations are enabled, multiply the number of vCPUs per instance by the number of replicas configured to calculate the full price for all resources used. This table shows the cost breakdown:
 
 | Database type                | Hourly price   | Monthly price\* | Subscription plan |
 | ---------------------------- | -------------- | --------------- | ----------------- |
 | PostgreSQL                   | $0.0856 / vCPU | $62.49 / vCPU  | Community 360 |
 | PostgreSQL                   | $0.1655 / vCPU | $120.82 / vCPU  | Standard |
 | EDB Postgres Advanced Server | $0.2397 / vCPU | $174.98 / vCPU  | Enterprise  |
 
+Extreme high availability powered by EDB Postgres Distributed is now available in beta! Contact Sales for additional information regarding pricing.
+
 \* The monthly cost is approximate and assumes 730 hours in a month. 
 
 

product_docs/docs/biganimal/release/reference/cli/using_features.mdx

@@ -3,7 +3,7 @@ title: Using BigAnimal features with the CLI
 navTitle: Using BigAnimal features
 ---
 
-## Managing faraway replicas
+## Faraway replicas CLI commands
 
 You can use the faraway replica-specific CLI commands to [create](#create-a-faraway-replica), [promote](#promote-a-faraway-replica), and [get information](#get-information-on-faraway-replicas) on faraway replicas. 
 
@@ -79,7 +79,7 @@ __OUTPUT__
 ```
 You are prompted to confirm you want to promote the faraway replica. After the faraway replica promotion process is completed, it generates a cluster ID.
 
-## Using IAM authentication on AWS
+## IAM authentication CLI commands
 
 To create a cluster that is enabled for IAM authentication, set the `--iam-authentication` flag on the create-cluster command or in the configuration file to `Yes` or `true`, respectively.
 

product_docs/docs/biganimal/release/using_cluster/01_postgres_access.mdx

@@ -114,7 +114,7 @@ If IAM integration is configured for your cluster, you can log in to Postgres us
 1. Connect to Postgres using your IAM credentials.
 1. When prompted for the password, enter your access key (<access key ID>:<secret access key>).
 
-### See also
+### Using IAM authentication CLI commands
 
-For information on integrating with IAM using the CLI, see the [Using IAM authentication on AWS](/biganimal/latest/reference/cli/using_features/#using-iam-authentication-on-aws) section in the [Using BigAnimal features with the CLI](/biganimal/latest/reference/cli/using_features) topic.
+For information on integrating with IAM on AWS using the CLI, see [IAM authentication CLI commands](/biganimal/latest/reference/cli/using_features/#iam-authentication-cli-commands).
 

product_docs/docs/biganimal/release/using_cluster/managing_replicas.mdx

@@ -134,6 +134,6 @@ You can restore a replica backup to a standalone cluster. A new stand alone clus
 
 
 
-## See also
+## Using the CLI to manage faraway replicas
 
-- [Managing faraway replicas using the CLI](/biganimal/latest/reference/cli/using_features/#managing-replicas)
+See [Faraway replicas CLI commands](/biganimal/latest/reference/cli/using_features/#managing-faraway-replicas-using-the-cli) for information on CLI commands for managing faraway replicas.

src/templates/doc.js

@@ -299,8 +299,9 @@ const DocTemplate = ({ data, pageContext }) => {
                       : githubEditLink) || "#"
                   }
                   className="btn btn-sm btn-primary px-4 text-nowrap"
+                  title="Navigate to the GitHub editor for this file, allowing you to propose changes for review by the EDB Documentation Team"
                 >
-                  Edit this page
+                  Suggest edits
                 </a>
               )}
               <FeedbackDropdown githubIssuesLink={githubIssuesLink} />

src/templates/learn-doc.js

@@ -93,8 +93,9 @@ const EditButton = ({ githubEditLink }) => (
   <a
     href={githubEditLink || "#"}
     className="btn btn-sm btn-primary px-4 text-nowrap"
+    title="Navigate to the GitHub editor for this file, allowing you to propose changes for review by the EDB Documentation Team"
   >
-    Edit this page
+    Suggest edits
   </a>
 );