Linux Installation how-tos

app/_how-tos/install-kgw-amazon-linux.md

@@ -0,0 +1,67 @@
+---
+title: Install {{site.base_gateway}} on Amazon Linux
+content_type: how_to
+products:
+    - gateway
+
+works_on:
+    - on-prem
+
+min_version:
+  gateway: '3.4'
+
+
+tags:
+    - rate-limiting
+
+tldr:
+    q: How do I install {{site.base_gateway}} on Amazon Linux
+    a: Download the {{site.base_gateway}} package and install it using your package manager. Then configure the database.
+
+tools:
+    - deck
+
+prereqs:
+  skip_product: true
+  inline:
+    - title: Install PostgreSQL
+      content: |
+        [Install PostgreSQL](https://www.postgresql.org/download/)
+    - title: Configure environment variables
+      include_content: prereqs/install/gateway/datastore-env-variables
+      icon_url: /assets/icons/file.svg
+---
+
+{% navtabs %}
+{% navtab "Manually installation" %}
+## 1. Download the {{site.base_gateway}} RPM package
+
+   ```sh
+   curl -Lo kong-enterprise-edition-{{page.latest_release.ee_version}}.rpm $(rpm --eval https://packages.konghq.com/public/gateway-{{page.latest_release.major_minor_version}}/rpm/amzn/%{amzn}/%{_arch}/kong-enterprise-edition-{{page.latest_release.ee_version}}.aws.%{_arch}.rpm)
+   ```
+
+## 2. Install {{site.base_gateway}}:
+   ```
+   sudo yum install -y kong-enterprise-edition-{{page.latest_release.ee_version}}.rpm
+   ```
+
+{% endnavtab %}
+{% navtab "Package manager" %}
+## 1. Set up the package repository:
+   ```sh
+   curl -1sLf "https://packages.konghq.com/public/gateway-{{page.latest_release.major_minor_version}}/config.rpm.txt?distro=amzn&codename=$(rpm --eval '%{amzn}')" | sudo tee /etc/yum.repos.d/kong-gateway-{{page.latest_release.major_minor_version}}.repo > /dev/null
+   ```
+   ```
+   sudo yum -q makecache -y --disablerepo='*' --enablerepo='kong-gateway-{{page.latest_release.major_minor_version}}'
+   ```
+
+## 2. Install {{site.base_gateway}}:
+   ```
+   sudo yum install -y kong-enterprise-edition-{{page.latest_release.ee_version}}
+   ```
+{% endnavtab %}
+{% endnavtabs %}
+
+## Configure the Datastore
+
+{% include how-tos/steps/datastore.md %}

app/_how-tos/install-kgw-debian.md

@@ -0,0 +1,73 @@
+---
+title: Install {{site.base_gateway}} on Debian
+content_type: how_to
+products:
+    - gateway
+
+works_on:
+    - on-prem
+
+min_version:
+  gateway: '3.4'
+
+
+tags:
+    - rate-limiting
+
+tldr:
+    q: How do I install {{site.base_gateway}} on Debian? 
+    a: Download the {{site.base_gateway}} package and install it using your package manager. Then configure the database.
+
+tools:
+    - deck
+
+prereqs:
+  skip_product: true
+  inline:
+    - title: Install PostgreSQL
+      content: |
+        [Install PostgreSQL](https://www.postgresql.org/download/)
+    - title: Configure environment variables
+      include_content: prereqs/install/gateway/datastore-env-variables
+      icon_url: /assets/icons/file.svg
+---
+{% navtabs %}
+{% navtab "Manual installation" %}
+## 1. Download {{site.base_gateway}}:
+   ```sh
+   curl -Lo kong-enterprise-edition-{{page.latest_release.ee_version}}.deb "https://packages.konghq.com/public/gateway-{{page.latest_release.major_minor_version}}/deb/debian/pool/bullseye/main/k/ko/kong-enterprise-edition_{{page.latest_release.ee_version}}/kong-enterprise-edition_{{page.latest_release.ee_version}}_$(dpkg --print-architecture).deb"
+   ```
+
+## 2. Install {{site.base_gateway}}:
+   ```
+   sudo apt install -y ./kong-enterprise-edition-{{page.latest_release.ee_version}}.deb
+   ```
+
+{% endnavtab %}
+{% navtab "Package manager" %}
+## 1. Set up the package repository:
+   ```sh
+   curl -1sLf "https://packages.konghq.com/public/gateway-{{page.latest_release.major_minor_version}}/gpg.B9DCD032B1696A89.key" |  gpg --dearmor | sudo tee /usr/share/keyrings/kong-gateway-{{page.latest_release.major_minor_version}}-archive-keyring.gpg > /dev/null
+   ```
+
+   ```
+   curl -1sLf "https://packages.konghq.com/public/gateway-{{page.latest_release.major_minor_version}}/config.deb.txt?distro=debian&codename=$(lsb_release -sc)" | sudo tee /etc/apt/sources.list.d/kong-gateway-{{page.latest_release.major_minor_version}}.list > /dev/null
+   ```
+
+## 2. Update the package manager:
+
+    ```sh
+    sudo apt update
+    ```
+
+## 3. Install {{site.base_gateway}}:
+   ```
+   sudo apt install -y kong-enterprise-edition={{page.latest_release.ee_version}}
+   ```
+
+{% endnavtab %}
+{% endnavtabs %}
+
+## Configure the Datastore
+
+{% include how-tos/steps/datastore.md %}

app/_how-tos/install-kgw-red-hat-fips.md

@@ -0,0 +1,68 @@
+---
+title: Install {{site.base_gateway}} FIPS on Red Hat
+content_type: how_to
+products:
+    - gateway
+works_on:
+    - on-prem
+
+min_version:
+  gateway: '3.4'
+tags:
+    - rate-limiting
+
+tldr:
+    q: How do I install the {{site.base_gateway}} FIPS package on Red Hat? 
+    a: Download the {{site.base_gateway}} package and install it using your package manager. Then configure the database.
+
+tools:
+    - deck
+
+prereqs:
+  skip_product: true
+  inline:
+    - title: Install PostgreSQL
+      content: |
+        [Install PostgreSQL](https://www.postgresql.org/download/)
+    - title: Configure environment variables
+      include_content: prereqs/install/gateway/datastore-env-variables
+      icon_url: /assets/icons/file.svg
+---
+
+{% navtabs %}
+{% navtab "Manual installation" %}
+1. Download {{site.base_gateway}}:
+    ```sh
+     curl -Lo kong-enterprise-edition-fips-3.9.0.1.rpm $(rpm --eval https://packages.konghq.com/public/gateway-39/rpm/el/%{rhel}/x86_64/kong-enterprise-edition-fips-3.9.0.1.el%{rhel}.x86_64.rpm)
+    ```
+
+2. Install {{site.base_gateway}}:
+    ```
+    yum install kong-enterprise-edition-fips-3.9.1.0
+    ```
+{% endnavtab %}
+{% navtab "Package manager" %}
+1. Set up the package repository:
+    ```sh
+     curl -1sLf "https://packages.konghq.com/public/gateway-39/config.rpm.txt?distro=el&codename=$(rpm --eval '%{rhel}')" | sudo tee /etc/yum.repos.d/kong-gateway-39.repo
+    ```
+    ```
+     sudo yum -q makecache -y --disablerepo='*' --enablerepo='kong-gateway-39'
+    ```
+
+2. Install {{site.base_gateway}}:
+    ```
+    yum install kong-enterprise-edition-fips-3.9.1.0
+    ```
+{% endnavtab %}
+{% endnavtabs %}
+
+3. Enable FIPS:
+
+```sh
+export KONG_FIPS=on && kong reload
+```
+
+## Configure the Datastore
+
+{% include how-tos/steps/datastore.md %}

app/_how-tos/install-kgw-red-hat.md

@@ -0,0 +1,67 @@
+---
+title: Install {{site.base_gateway}} on Red Hat
+content_type: how_to
+products:
+    - gateway
+
+works_on:
+    - on-prem
+
+min_version:
+  gateway: '3.4'
+
+
+tags:
+    - rate-limiting
+
+tldr:
+    q: How do I install {{site.base_gateway}} on Red Hat? 
+    a: Download the {{site.base_gateway}} package and install it using your package manager. Then configure the database.
+
+tools:
+    - deck
+
+prereqs:
+  skip_product: true
+  inline:
+    - title: Install PostgreSQL
+      content: |
+        [Install PostgreSQL](https://www.postgresql.org/download/)
+    - title: Configure environment variables
+      include_content: prereqs/install/gateway/datastore-env-variables
+      icon_url: /assets/icons/file.svg
+---
+
+{% navtabs %}
+{% navtab "Manual Installation" %}
+## 1. Download {{site.base_gateway}}:
+   ```sh
+   curl -Lo kong-enterprise-edition-{{page.latest_release.ee_version}}.rpm $(rpm --eval https://packages.konghq.com/public/gateway-{{page.latest_release.major_minor_version}}/rpm/el/%{rhel}/%{_arch}/kong-enterprise-edition-{{page.latest_release.ee_version}}.el%{rhel}.%{_arch}.rpm)
+   ```
+
+## 2. Install {{site.base_gateway}}:
+   ```
+   sudo yum install -y kong-enterprise-edition-{{page.latest_release.ee_version}}.rpm
+   ```
+
+{% endnavtab %}
+{% navtab "Package manager" %}
+## 1. Set up the package repository:
+   ```sh
+   curl -1sLf "https://packages.konghq.com/public/gateway-{{page.latest_release.major_minor_version}}/config.rpm.txt?distro=el&codename=$(rpm --eval '%{rhel}')" | sudo tee /etc/yum.repos.d/kong-gateway-{{page.latest_release.major_minor_version}}.repo
+   ```
+   ```
+   sudo yum -q makecache -y --disablerepo='*' --enablerepo='kong-gateway-{{page.latest_release.major_minor_version}}'
+   ```
+
+## 2. Install {{site.base_gateway}}:
+   ```
+   sudo yum install -y kong-enterprise-edition-{{page.latest_release.ee_version}}
+   ```
+
+{% endnavtab %}
+{% endnavtabs %}
+
+## Configure the Datastore
+
+{% include how-tos/steps/datastore.md %}

app/_how-tos/install-kgw-ubuntu-fips.md

@@ -0,0 +1,60 @@
+---
+title: Install {{site.base_gateway}} FIPS package on Ubuntu
+content_type: how_to
+products:
+    - gateway
+
+works_on:
+    - on-prem
+
+min_version:
+  gateway: '3.4'
+
+tags:
+    - rate-limiting
+
+tldr:
+    q: How do I install the {{site.base_gateway}} FIPS package on Ubuntu? 
+    a: Download the {{site.base_gateway}} package and install it using your package manager. Then configure the database.
+
+tools:
+    - deck
+
+prereqs:
+  skip_product: true
+  inline:
+    - title: Install PostgreSQL
+      content: |
+        [Install PostgreSQL](https://www.postgresql.org/download/)
+    - title: Configure environment variables
+      include_content: prereqs/install/gateway/datastore-env-variables
+      icon_url: /assets/icons/file.svg
+---
+
+
+## 1. Set up the package repository:
+```sh
+curl -1sLf "https://packages.konghq.com/public/gateway-39/gpg.B9DCD032B1696A89.key" |  gpg --dearmor >> /usr/share/keyrings/kong-gateway-39-archive-keyring.gpg
+```
+```
+curl -1sLf "https://packages.konghq.com/public/gateway-38/config.deb.txt?distro=ubuntu&codename=$(lsb_release -sc)" > /etc/apt/sources.list.d/kong-gateway-39.list
+```
+## 2. Update the package manager:
+
+    ```sh
+    sudo apt update
+    ```
+
+## 3. Install {{site.base_gateway}}:
+```
+apt install -y kong-enterprise-edition-fips=3.9.1.0
+```
+
+## 4. Enable FIPS
+```sh
+export KONG_FIPS=on && kong reload
+```
+
+## Configure the Datastore
+
+{% include how-tos/steps/datastore.md %}