Merge pull request #5853 from EnterpriseDB/release-2024-07-12a

Release 2024-07-12a

advocacy_docs/edb-postgres-ai/overview/overview-and-concepts.mdx

@@ -11,25 +11,25 @@ EDB Postgres AI is composed of multiple elements which come together to deliver
 
 
 ## [EDB Postgres AI Console](/edb-postgres-ai/console)
-The Console is the gateway to EDB Postgres AI. Starting with a single pane of glass onto all your EDB Postgres AI operations, Console is there to manage your database landscape. It also lets you create and manage your databases, and provides a view of your databases' health and performance. Add to that the ability to bring up Lakehouse Analytics and AI/ML capabilities, and you have the power of ED Postgres AI at your fingertips.
+The Console is the gateway to EDB Postgres AI. Starting with a single pane of glass onto all your EDB Postgres AI operations, Console is there to manage your database landscape. It also lets you create and manage your databases, and provides a view of your databases' health and performance. Add to that the ability to bring up Lakehouse Analytics and AI/ML capabilities, and you have the power of EDB Postgres AI at your fingertips.
 * **[EDB Postgres AI Estate](/edb-postgres-ai/console/estate)**
-  * EDB Postgres AI Cloud Service databases are automatically managed on the Console. The Estate can also monitor the health of AWS RDS and S3 resources and using the Agent, on-premises databases show in the same view.
+  * EDB Postgres AI Cloud Service databases are managed on the Console. The Estate can also monitor the health of AWS RDS and S3 resources. Using the Agent, on-premises databases are shown and managed in the same view.
 * **[EDB Postgres AI Agent](/edb-postgres-ai/console/agent)**
-  * Include on premises databases under the Console's single pane of glass view with the Agent. The Agent is part of enabling EDB Postgres AI an unprecedented view of diverse deployments.
+  * Include on-premises databases under the Console's single pane of glass view with the Agent. The Agent is part of giving EDB Postgres AI an unprecedented view of diverse deployments.
 
 ## [EDB Postgres AI Cloud Service](/edb-postgres-ai/cloud-service)
 Not just databases, but driven by databases, Cloud Service provides a global platform for delivering new elements of EDB Postgres AI efficiently and effectively.
 * **[Cloud Service Hosted](/edb-postgres-ai/cloud-service/hosted)**
   * The Cloud Service Hosted environment is where you can experience the full power of EDB Postgres AI, with all the elements of the platform available to you.
 * **[Cloud Service Managed](/edb-postgres-ai/cloud-service/managed)**
-  * Bring your own cloud account to EDB and let the Managed environment take care of deploying and managing your Postgres databases in your cloud account
+  * Bring your own cloud account to EDB and let the Managed Service environment take care of deploying and managing your Postgres databases in your own cloud provider account.
 
 ## [EDB Postgres AI Databases](/edb-postgres-ai/databases)
-All of EDB's database expertise can be found in EDB Postgres Advanced Server and EDB Postgres Extended Server. Oracle compatibility, transparent data encryption and more. They provide the data fabric on which EDB Postgres AI operates. Combined with EDB Postgres Distributed, they can also provide a high availability environment for your data. 
+All of EDB's database expertise can be found in EDB Postgres Advanced Server and EDB Postgres Extended Server, including Oracle compatibility, transparent data encryption (TDE), and more. They provide the data fabric on which EDB Postgres AI operates. Combined with EDB Postgres Distributed, they can also provide a high-availability environment for your data. 
 
 All of these components are available on the EDB Postgres AI Cloud Service, and managed through the EDB Postgres AI Console.
 * **[EDB Postgres Advanced Server](/edb-postgres-ai/databases/epas)**
-  * EDB Postgres Advanced Server provides provide mission critical capabilities for your data, with EDB Postgres Advanced Server also providing Oracle compatibility.
+  * EDB Postgres Advanced Server provides mission-critical capabilities for your data along with Oracle compatibility.
 * **[EDB Postgres Extended Server](/edb-postgres-ai/databases/pge)**
   * EDB Postgres Extended Server delivers for large-scale, mission-critical enterprise workloads, providing a robust and scalable environment for your data. 
 * **[EDB Postgres Distributed](/edb-postgres-ai/databases/pgd/)**
@@ -39,10 +39,10 @@ All of these components are available on the EDB Postgres AI Cloud Service, and
 Filtering out the data noise and revealing insights and value, Lakehouse analytics brings both structured relational data in Postgres and unstructured data in object storage together for exploration.
 
 * **[Lakehouse nodes](/edb-postgres-ai/analytics/lakehouse)**
-  * At the heart of Analytics is a custom built store for this data. Built to bring structured and unstructured data together, Lakehouse nodes support numerous formats to bring your data in from the cold, ready for analysis. 
+  * At the heart of Analytics is custom-built object storage for your data. Built to bring structured and unstructured data together, Lakehouse nodes support numerous formats to bring cold data in, ready for analysis. 
 
 ## [EDB Postgres AI AI/ML](/edb-postgres-ai/ai-ml)
-* Postgres has proven its capability as a flexible data environment, and Vector data, the core of generative AI, is already infused into EDB Postgres AI providing a platform for a range of practical and effective AI/ML solutions. A technical preview of this capability is available for the pgai extension.
+* Postgres has proven its capability as a flexible data environment. With vector data as the core of generative AI, ir's already infused into EDB Postgres AI, providing a platform for a range of practical and effective AI/ML solutions. A technical preview of this capability is available for the Postgres pgai extension.
 
 ## [EDB Postgres AI Platforms and tools](/edb-postgres-ai/tools)
 * Postgres extensions are a source of its power and popularity, and are one of the categories that fall within this element of EDB Postgres AI. 

advocacy_docs/repos/getting_started/index.mdx

@@ -0,0 +1,17 @@
+---
+title: Getting started with repositories
+navTitle: Getting Started
+description: How to download and install the EDB package you need
+navigation:
+- with_web
+- with_cli
+- troubleshooting
+---
+
+* [Using the web page](with_web): If you have an Enterprise subscription to EDB software, and want to use the web interface to guide you in downloading and installing packages, use this guide.
+
+* [Using the CLI](with_cli): For all subscriptions, you can use the CLI to install packages from EDB repositories. This guide works for all EDB repositories and is the most flexible way to install packages.
+
+!!! Note
+ If you have a Standard or Community360 subscription, or want to install packages for Postgres Distributed without using TPA, you must use the CLI. Refer to the [CLI getting started guide](with_cli) for that.
+!!!

advocacy_docs/repos/getting_started/troubleshooting.mdx

@@ -0,0 +1,16 @@
+---
+title: Troubleshooting your repositories and downloads
+navTitle: Troubleshooting
+description: How to troubleshoot your repositories and downloads when they don't work
+---
+
+If your download doesn't work, you can try the following troubleshooting steps:
+
+* **Check your internet connection**: Make sure you are connected to the internet and that your connection is stable.
+
+* **Check for errors in the terminal**: If the curl command responded with an error or just returns immediately with no output, there may be an issue with the command. Check the command and try again.
+
+* **Check for 404 errors**: If you see a 404 error, its possible that your token doesn't entitle you to access the repository you have configured. Check the repository name and try again.
+
+If none of these steps work, please contact [EDB Support](https://www.enterprisedb.com/support-center) for further assistance.
+

advocacy_docs/repos/getting_started/with_cli/adding_edb_repositories.mdx

@@ -0,0 +1,41 @@
+---
+title: Adding EDB repositories using the command line
+navTitle: Adding EDB repositories
+description: How to add EDB repositories to your system using the command line
+---
+
+Using the command line allows you more flexibility in adding EDB repositories to your system. The website currently only supports Enterprise subscriptions, but the CLI allows you to add any EDB repository, including `community360`, `standard`, `enterprise`, and `postgres_distributed`.
+
+See the [Repositories by name](/repos/reference/repositories_by_name) page for more information and what subscriptions are able to access them.
+
+1. Get your token. If you don't have a token, [get it now](get_your_token) and return to this page when you have your token.
+
+3. Save your token in the environment variable `$EDB_SUBSCRIPTION_TOKEN`:
+
+    ```bash
+    export EDB_SUBSCRIPTION_TOKEN=your_token_here
+    ``` 
+
+4. Save your required repository name in the environment variable `$EDB_REPO`:
+
+    ```bash
+    export EDB_REPO=your_repository_name_here
+    ```
+
+5. Depending on your operating system, run the following command:
+
+    **RHEL/AlmaLinux/RockyLinux/Oracle Linux and SUSE**:
+
+    ```bash
+    curl -1sSLf "https://downloads.enterprisedb.com/$EDB_SUBSCRIPTION_TOKEN/$EDB_REPO/setup.rpm.sh" | sudo -E bash
+    ```
+
+    **Ubuntu/Debian**:
+
+    ```bash
+    curl -1sSLf "https://downloads.enterprisedb.com/$EDB_SUBSCRIPTION_TOKEN/$EDB_REPO/setup.deb.sh" | sudo -E bash
+    ```
+
+6. You can now install packages from that EDB repository. Move on to the [installing named packages](install_named_package) to install the packages you need.
+
+7. If you have any issues, check the [troubleshooting](../troubleshooting) section.

advocacy_docs/repos/getting_started/with_cli/get_your_token.mdx

@@ -0,0 +1,32 @@
+---
+title: Get your token
+navTitle: Get your token
+description: How to get the token you need to download EDB software
+---
+
+## Tokens and EDB Accounts
+
+To download EDB software, you need a token. 
+This token is a string that identifies you and your eligibility to download software from EDB. 
+If you have an account on EDB, you have already have a token. 
+We'll show you how to retrieve it.
+
+If you don't have an account, [sign up for a free EDB account](https://www.edbpostgres.com/accounts/register). 
+Signing up gives you a sixty-day trial subscription to EDB's software repositories. 
+
+## Getting your token
+
+To get your token, you need use the web interface to the EDB Repositories. This is the only place where tokens are issued. Once you have your token, you'll be able to return to the CLI and complete your work there. 
+
+1. Go to the [EDB Repos 2.0](https://edbpostgres.com/repos-downloads) page, where you can obtain your Repos 2.0 token. 
+    You may have to sign in to your EDB account to access this page. If you do have to sign in, you'll go to the account profile page. On the account profile page, select **Repo Access** to continue.
+
+2.  You'll now be on the EDB Repositories page. On your first visit to this page, select **Request Access** to generate your Repos 2.0 token. 
+
+3. Copy the token using the **Copy Token** icon, and store it safely.
+
+4. Once you’ve created your EDB account and generated your token, you can return to your CLI and configure your system to use the EDB repositories.
+
+The next step is to [add the EDB repositories to your system](adding_edb_repositories).
+
+

advocacy_docs/repos/getting_started/with_cli/index.mdx

@@ -0,0 +1,21 @@
+---
+title: Getting started using the CLI
+navTitle: with the CLI
+description: How to download and install the EDB package you need using the CLI
+navigation:
+- get_your_token
+- add_your_repository
+- install_package
+- troubleshooting
+---
+
+In this getting started section, you'll learn how to download and install the EDB package you need using the CLI. Using the CLI you can install from any EDB repository, including `community360`,`standard`,`enterprise`, and `postgres_distributed`.
+
+There are three steps to installing packages from EDB repositories using the CLI. 
+
+1. [Get your token](get_your_token)
+2. [Add your repository](adding_edb_repositories)
+3. [Install the package you need](install_named_package)
+
+Once you've mastered package installation, you can move on to [working with repositories](../../working_with_repos) where you can learn how to directly browse repositories and download packages, create local mirrors, handle air-gapped installations, and integrate with configuration management tools. 
+

advocacy_docs/repos/getting_started/with_cli/install_named_package.mdx

@@ -0,0 +1,30 @@
+---
+title: Installing a named package
+navTitle: Installing a named package
+description: How to install a named package from the EDB repository
+---
+
+1. Obtain the package name you want to install. You can find the package names through the EDB repository web interface. Package names are also listed in the [package names](/repos/reference/package_names) reference.
+
+2. Run the following command to install the package, depending on your operating system:
+
+    **RHEL/AlmaLinux/RockyLinux/Oracle Linux**:
+
+    ```bash
+    sudo dnf -y install package_name
+    ```
+
+    **SUSE**:
+
+    ```bash
+    sudo zypper install package_name
+    ```
+
+    **Ubuntu/Debian**:
+
+    ```bash
+    sudo apt-get -y install package_name
+    ```
+
+3. If you have any issues, check the [troubleshooting](../troubleshooting) section.
+

advocacy_docs/repos/getting_started/with_web/add_your_repository.mdx

@@ -0,0 +1,25 @@
+---
+title: Add your repository
+navTitle: Add your repository
+description: How to add the EDB repository to your system
+---
+
+
+1. Navigate to [https://www.enterprisedb.com/repos-downloads](https://www.enterprisedb.com/repos-downloads). Sign in if required. If you do have to sign in, you'll go to the account profile page. On the account profile page, select **Repo Access** to continue.
+
+2. Select **Access Repos 2.0**.
+
+3. On the next page, select the platform you wish to download packages to.
+
+4. Then select any software from the left hand list of EDB software.
+
+5. On the right hand side, instructions appear for the installation of that particular software.
+
+    <img src="./images/step1.png" style="border:1px solid;margin: 1em auto 1em" alt="Repos 2.0 - Step 1" />
+
+6. Go to **Step 1** and copy the Auto command. This is a ready-to-run repository installer for your system. Run alone, it only installs the EDB repositories for Repos 2.0. EDB's web site has already personalized the command by embedding your Repos token into the command, so you can run it as it.
+
+7. Once complete, your system can download packages from EDB.
+
+8. If you have any issues, check the [troubleshooting](../troubleshooting) section. 
+

advocacy_docs/repos/getting_started/with_web/get_your_token.mdx

@@ -0,0 +1,32 @@
+---
+title: Get your token
+navTitle: Get your token
+description: How to get the token you need to download EDB software
+---
+
+## Tokens and EDB Accounts
+
+To download EDB software, you need a token. 
+This token is a string that identifies you and your eligibility to download software from EDB. 
+If you have an account on EDB, your already have a token. 
+We'll show you how to retrieve it.
+
+If you don't have an account, [sign up for a free EDB account](https://www.edbpostgres.com/accounts/register). 
+Signing up gives you a sixty-day trial subscription to EDB's software repositories. 
+
+## Getting your token
+
+1. Go to the [EDB Repos 2.0](https://edbpostgres.com/repos-downloads) page, where you can obtain your Repos 2.0 token. 
+   You may have to sign in to your EDB account to access this page. If you do have to sign in, you'll go to the account profile page. 
+   On the account profile page, select **Repo Access** to continue.
+
+2. You will now be on the EDB Repositories page.
+    On your first visit to this page, select **Request Access** to generate your Repos 2.0 token. 
+
+3. Copy the token using the **Copy Token** icon, and store it safely.
+
+4. Once you’ve created your EDB account and generated your token, you can go to [edbpostgres.com/downloads](https://edbpostgres.com/repos-downloads/) and configure your system to use the EDB repositories.
+
+The next step is to [add the EDB repository to your system](add_your_repository).
+
+

advocacy_docs/repos/getting_started/with_web/index.mdx

@@ -0,0 +1,25 @@
+---
+title: Getting started using repositories on the web
+navTitle: with the web page
+description: How to download and install the EDB package you need using the Repos page on the web
+navigation:
+- get_your_token
+- add_your_repository
+- install_package
+- troubleshooting
+---
+
+To use this getting started section, you need to have an Enterprise subscription to EDB software. The web-based version of the repository system currently only supports Enterprise subscriptions.
+
+!!! Note
+If you want to install software from other EDB repositories, such as `community360` or `postgres_distributed`, you need to use the command line interface. Refer to the [CLI getting started guide](../with_cli) for that.
+!!!
+
+There are three steps to installing packages from EDB repositories using the Web. 
+
+1. [Get your token](get_your_token)
+2. [Add your repository](add_your_repository)
+3. [Install the package you need](install_package)
+
+Once you've mastered package installation, you can move on to [working with repositories](../../working_with_repos) where you can learn how to directly browse repositories and download packages, create local mirrors, handle air-gapped installations, and integrate with configuration management tools. 
+

advocacy_docs/repos/getting_started/with_web/install_package.mdx

@@ -0,0 +1,33 @@
+---
+title: Installing Packages
+navTitle: Installing Packages
+description: How to install the EDB package you need
+---
+
+Once you have added the EDB repository to your system, you can install any EDB package you need.
+
+## Finding the package name for the package you need.
+
+Installation instructions in the manuals for the EDB packages will tell you the package name you need to install.
+You can also look up the package name in the EDB Repos web page.
+
+1. Navigate to [https://www.enterprisedb.com/repos-downloads](https://www.enterprisedb.com/repos-downloads). Sign in if required. If you do have to sign in, you'll be directed to the account profile page. On the account profile page, select **Repo Access** to continue.
+
+2. Select **Access Repos 2.0**.
+
+3. On the next page, select the platform you wish to download packages to.
+
+4. Then select any software from the left hand list of EDB software.
+
+5. On the right hand side, instructions appear for the installation of that particular software. Look for Step 2, the installation step. This is step 2 to install EDB Postgres Advanced Server version 16 on Ubuntu 22.04 on x86_64
+
+    <img src="./images/step2.png" alt="Repos 2.0 - Step 2" style="border: 1px solid; margin: 1em auto 1em;"/>
+
+6. The contents of **Step 2** show you the full installation command for the package. You can copy and paste this command into your terminal to install the package. If you just need the package name, that appears at the end of the command. 
+
+If you have any issues, check the [troubleshooting](../troubleshooting) section.
+
+
+
+
+

advocacy_docs/repos/index.mdx

@@ -0,0 +1,22 @@
+---
+title: EDB Repositories and Downloading
+navTitle: Repositories and Downloading
+directoryDefaults:
+  iconName: Download
+  indexCards: simple
+  prevNext: true
+navigation:
+- getting_started
+- working_with_repos
+- migration
+- reference
+redirects:
+  - /purl/repos/docs
+---
+
+Head to [Getting Started](getting_started) if you want to start installing right now.
+
+
+Efficient distribution and installation of software is key to a successful system deployment. At EDB we create our software packages with this in mind and distribute it to you through platform specific package managers. For most purposes, following the instructions from the download portal enables you to quickly configure your operating system to also download software from the EDB repository. Once you have done this, your system can  install any EDB package you need.
+
+