Merge pull request #5730 from EnterpriseDB/docs/install/add-debian12

Add support for Debian 12 to install documentation

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

@@ -16,6 +16,7 @@ navigation:
   - requirements
   - linux_x86_64
   - linux_ppc64le
+  - linux_arm64
   - windows
   - macos
 ---
@@ -44,7 +45,7 @@ Select a link to access the applicable installation instructions:
 
 - [Ubuntu 22.04](linux_x86_64/postgresql_ubuntu_22), [Ubuntu 20.04](linux_x86_64/postgresql_ubuntu_20)
 
-- [Debian 11](linux_x86_64/postgresql_debian_11), [Debian 10](linux_x86_64/postgresql_debian_10)
+- [Debian 12](linux_x86_64/postgresql_debian_12), [Debian 11](linux_x86_64/postgresql_debian_11), [Debian 10](linux_x86_64/postgresql_debian_10)
 
 ## Linux [IBM Power (ppc64le)](linux_ppc64le)
 
@@ -56,6 +57,12 @@ Select a link to access the applicable installation instructions:
 
 - [SLES 15](linux_ppc64le/postgresql_sles_15), [SLES 12](linux_ppc64le/postgresql_sles_12)
 
+## Linux [AArch64 (ARM64)](linux_arm64)
+
+### Debian and derivatives
+
+- [Debian 12](linux_arm64/postgresql_debian_12)
+
 ## Macintosh
 
 - [Mac OS X](macos)

advocacy_docs/supported-open-source/postgresql/installing/linux_arm64/index.mdx

@@ -0,0 +1,14 @@
+---
+title: "Installing PostgreSQL on Linux AArch64 (ARM64)"
+navTitle: "On Linux ARM64"
+indexCards: none
+
+navigation:
+  - postgresql_debian_12
+---
+
+Operating system-specific install instructions are described in the corresponding documentation:
+
+### Debian and derivatives
+
+- [Debian 12](postgresql_debian_12)

advocacy_docs/supported-open-source/postgresql/installing/linux_arm64/postgresql_debian_12.mdx

@@ -0,0 +1,39 @@
+---
+navTitle: Debian 12
+title: Installing PostgreSQL on Debian 12 arm64
+---
+
+## Prerequisites
+
+Before you begin the installation process:
+
+- Set up the EDB repository.
+
+  !!! Note
+  Rather than use the EDB repository, you can obtain PostgreSQL installers and installation packages from the [PostgreSQL community downloads page](https://www.postgresql.org/download/).
+  !!!
+
+  Setting up the repository is a one-time task. If you have already set up your repository, you don't need to perform this step.
+
+  To determine if your repository exists, enter this command:
+
+  `apt-cache search enterprisedb`
+
+  If no output is generated, the repository isn't installed.
+
+  To set up the EDB repository:
+
+  1. Go to [EDB repositories](https://www.enterprisedb.com/repos-downloads).
+
+  1. Select the button that provides access to the EDB repository.
+  1. Select the platform and software that you want to download.
+
+  1. Follow the instructions for setting up the EDB repository.
+
+## Install the package
+
+```shell
+sudo apt-get -y install postgresql-<xx>
+```
+
+Where `<xx>` is the version of PostgreSQL you are installing. For example, if you are installing version 16, the package name would be `postgresql-16`.

advocacy_docs/supported-open-source/postgresql/installing/linux_x86_64/index.mdx

@@ -6,14 +6,15 @@ indexCards: none
 navigation:
   - postgresql_rhel_9
   - postgresql_rhel_8
+  - postgresql_rhel_7
   - postgresql_other_linux_9
   - postgresql_other_linux_8
-  - postgresql_rhel_7
   - postgresql_centos_7
   - postgresql_sles_15
   - postgresql_sles_12
   - postgresql_ubuntu_22
   - postgresql_ubuntu_20
+  - postgresql_debian_12
   - postgresql_debian_11
   - postgresql_debian_10
 ---
@@ -56,6 +57,8 @@ Operating system-specific install instructions are described in the correspondin
 
 - [Ubuntu 20.04](postgresql_ubuntu_20)
 
+- [Debian 12](postgresql_debian_12)
+
 - [Debian 11](postgresql_debian_11)
 
 - [Debian 10](postgresql_debian_10)

advocacy_docs/supported-open-source/postgresql/installing/linux_x86_64/postgresql_debian_12.mdx

@@ -0,0 +1,39 @@
+---
+navTitle: Debian 12
+title: Installing PostgreSQL on Debian 12 x86_64
+---
+
+## Prerequisites
+
+Before you begin the installation process:
+
+- Set up the EDB repository.
+
+  !!! Note
+  Rather than use the EDB repository, you can obtain PostgreSQL installers and installation packages from the [PostgreSQL community downloads page](https://www.postgresql.org/download/).
+  !!!
+
+  Setting up the repository is a one-time task. If you have already set up your repository, you don't need to perform this step.
+
+  To determine if your repository exists, enter this command:
+
+  `apt-cache search enterprisedb`
+
+  If no output is generated, the repository isn't installed.
+
+  To set up the EDB repository:
+
+  1. Go to [EDB repositories](https://www.enterprisedb.com/repos-downloads).
+
+  1. Select the button that provides access to the EDB repository.
+  1. Select the platform and software that you want to download.
+
+  1. Follow the instructions for setting up the EDB repository.
+
+## Install the package
+
+```shell
+sudo apt-get -y install postgresql-<xx>
+```
+
+Where `<xx>` is the version of PostgreSQL you are installing. For example, if you are installing version 16, the package name would be `postgresql-16`.

install_template/README.md

@@ -240,7 +240,7 @@ In particular, avoid the trap of setting a flag in a leaf template and then chec
    arch: x86_64
    supported versions: [<supported_versions>]
    
-1. In **templates/platformBase_deploymentConstants.njk**, update the `map_platform` and `map_platform_old` blocks. For example, for RHEL 9, the following lines were added to both blocks of code:
+1. In **templates/platformBase/_deploymentConstants.njk**, update the `map_platform` and `map_platform_old` blocks. For example, for RHEL 9, the following lines were added to both blocks of code:
 
 "AlmaLinux 9 or Rocky Linux 9": "other_linux9",
 .
@@ -266,3 +266,36 @@ In particular, avoid the trap of setting a flag in a leaf template and then chec
    - In each file, update the entry for `platformBaseTemplate` so it points to the appropriate template, either in the **templates/platformBase** folder or in the current **templates/products** folder. 
    - Check content to determine if other references require updating. 
    - The number of topics that need to be updated will vary depending on the platform being added. For RHEL 9, two new topics were created: **rhel-9-or-ol-9.njk** and **almalinux-9-or-rocky-linux-9.njk**.
+
+#### Adding a new architecture
+
+Similar to adding a new platform (above). Depending on what customizations are necessary for the new architecture, may involve adding specializations for platform *and* arch for each affected product.
+
+1. Modify **config.yaml**. For example, when adding the arm64 platform for Debian 12, the following entries were made to each product:
+
+   ```
+   - name: Debian 12
+      arch: arm64
+      supported versions: [<supported versions>]
+   ```
+
+2. In **templates/platformBase/_deploymentConstants.njk**, update the `expand_arch` block. For example, for arm64, the following line was added:
+
+   ```
+    arm64: "arm64"
+   ```
+
+   (This is only necessary to avoid build errors when generating redirects, although any redirects so-generated are initially useless as by definition we don't have any old paths for new architecture documentation)
+
+3. Add a new architecture index template to platformBase, e.g. `arm64_index.njk`. Copy an existing index template and edit to reflect the new arch.
+
+4. Add a call to the macro for the new arch in platformBase/index.njk, e.g.
+
+   ```
+   {{archInstall("AArch64 (ARM64)", "arm64", ["Debian"])}}
+   ```
+
+   The last parameter is a list of base platforms (without versions) to render; you should list all of them that will use the new architecture. 
+
+5. Add new architecture-specific index templates (e.g. `arm64_index.njk`) to the affected products (this is done to set `productShortname` - so you can just copy an existing index verbatim unless there are other customizations needed)
+