Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add support for Debian 12 to install documentation #5730

Merged
merged 28 commits into from
Jun 25, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
28 commits
Select commit Hold shift + click to select a range
3f9980c
early configuration work for Debian 12
dwicinas Jun 4, 2024
807ed92
Demonstrate how to add a new CPU architecture to install templates
josh-heyer Jun 5, 2024
817bb2e
Changes for PgBouncer
dwicinas Jun 5, 2024
cc237f4
changes for pgpool, pgpool-extensions
dwicinas Jun 5, 2024
373b94c
modified navigation entries in arm64 index
dwicinas Jun 5, 2024
27b6700
Cleanup for PgPool extensions
dwicinas Jun 6, 2024
e8257db
Added Hadoop
dwicinas Jun 6, 2024
71887d0
Adding template changes for MongoDB
dwicinas Jun 6, 2024
e87bf6f
Corrections to hadoop
dwicinas Jun 6, 2024
806fff1
correcting problem with PgPool extensions
dwicinas Jun 6, 2024
e734fde
template changes for JDBC
dwicinas Jun 6, 2024
b9af88d
template changes for OCL
dwicinas Jun 6, 2024
31cd618
template changes for ODBC
dwicinas Jun 6, 2024
2e3fa66
template changes for MySQL
dwicinas Jun 6, 2024
a0c0a2e
template changes for Migration Toolkit
dwicinas Jun 7, 2024
0306367
template changes for PGE 16
dwicinas Jun 7, 2024
3ac3b4c
template changes for EDBPlus
dwicinas Jun 7, 2024
29e49f9
template changes for Failover Manager
dwicinas Jun 7, 2024
de79a5a
template changes for PEM server and agent
dwicinas Jun 7, 2024
c75f196
template changes for PostgreSQL
dwicinas Jun 7, 2024
2b06013
template changes for Replication Server
dwicinas Jun 7, 2024
56f177a
more template changes for EPAS
dwicinas Jun 7, 2024
cb60a89
template changes for PostGIS
dwicinas Jun 7, 2024
943ec5e
Updated templates for MySQL to include comments from Ajaykumar
dwicinas Jun 13, 2024
fa55b65
Template changes to reflect QA input on PostGIS and PgBouncer
dwicinas Jun 13, 2024
4d2decf
Use config data to produce install index nav sections
josh-heyer Jun 18, 2024
274dbbc
Generated topics for Debian 12 support
dwicinas Jun 11, 2024
83fec17
Removed Debian 12 from MTK, EDB*Plus and EPRS
dwicinas Jun 24, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ navigation:
- requirements
- linux_x86_64
- linux_ppc64le
- linux_arm64
- windows
- macos
---
Expand Down Expand Up @@ -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)

Expand All @@ -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)
Expand Down
Original file line number Diff line number Diff line change
@@ -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)
Original file line number Diff line number Diff line change
@@ -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`.
Original file line number Diff line number Diff line change
Expand Up @@ -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
---
Expand Down Expand Up @@ -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)
Original file line number Diff line number Diff line change
@@ -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`.
35 changes: 34 additions & 1 deletion install_template/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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",
.
Expand All @@ -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)

Loading