From 2b413d7f9982f11af84dbcc5cff5a7b71be1626d Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Tue, 26 Nov 2024 11:43:30 +0530 Subject: [PATCH] Added latest product version to few products and its install topics --- install_template/config.yaml | 16 +- .../docs/epas/17/installing/index.mdx | 8 +- .../17/installing/linux_arm64/epas_rhel_9.mdx | 157 ++++++++++++++++++ .../epas/17/installing/linux_arm64/index.mdx | 7 + .../ocl_connector/17/installing/index.mdx | 6 + .../17/installing/linux_arm64/index.mdx | 7 + .../17/installing/linux_arm64/ocl_rhel_9.mdx | 52 ++++++ product_docs/docs/pge/17/installing/index.mdx | 6 + .../pge/17/installing/linux_arm64/index.mdx | 7 + .../17/installing/linux_arm64/pge_rhel_9.mdx | 129 ++++++++++++++ 10 files changed, 386 insertions(+), 9 deletions(-) create mode 100644 product_docs/docs/epas/17/installing/linux_arm64/epas_rhel_9.mdx create mode 100644 product_docs/docs/ocl_connector/17/installing/linux_arm64/ocl_rhel_9.mdx create mode 100644 product_docs/docs/pge/17/installing/linux_arm64/pge_rhel_9.mdx diff --git a/install_template/config.yaml b/install_template/config.yaml index 54630902297..0485e53a8a4 100644 --- a/install_template/config.yaml +++ b/install_template/config.yaml @@ -41,10 +41,10 @@ products: supported versions: [42.7.3.2] - name: RHEL 9 arch: ppc64le - supported versions: [42.7.3.1] + supported versions: [42.7.3.2] - name: RHEL 9 or OL 9 arch: arm64 - supported versions: [42.7.3.1] + supported versions: [42.7.3.2] - name: AlmaLinux 9 or Rocky Linux 9 arch: x86_64 supported versions: [42.7.3.2] @@ -135,10 +135,10 @@ products: supported versions: [14, 15, 16, 17] - name: RHEL 9 or OL 9 arch: x86_64 - supported versions: [14, 15, 16] + supported versions: [14, 15, 16, 17] - name: RHEL 9 or OL 9 arch: arm64 - supported versions: [14, 15, 16] + supported versions: [14, 15, 16, 17] - name: Debian 11 arch: x86_64 supported versions: [14, 15, 16, 17] @@ -349,10 +349,10 @@ products: supported versions: [11, 12, 13, 14, 15, 16, 17] - name: RHEL 9 or OL 9 arch: x86_64 - supported versions: [11, 12, 13, 14, 15, 16] + supported versions: [11, 12, 13, 14, 15, 16, 17] - name: RHEL 9 or OL 9 arch: arm64 - supported versions: [13, 14, 15, 16] + supported versions: [13, 14, 15, 16, 17] - name: RHEL 9 arch: ppc64le supported versions: [11, 12, 13, 14, 15, 16, 17] @@ -393,10 +393,10 @@ products: supported versions: [15, 16, 17] - name: RHEL 9 or OL 9 arch: x86_64 - supported versions: [15, 16] + supported versions: [15, 16, 17] - name: RHEL 9 or OL 9 arch: arm64 - supported versions: [15, 16] + supported versions: [15, 16, 17] - name: Debian 12 arch: x86_64 supported versions: [16, 17] diff --git a/product_docs/docs/epas/17/installing/index.mdx b/product_docs/docs/epas/17/installing/index.mdx index 8b47c5d7b99..f98853d0098 100644 --- a/product_docs/docs/epas/17/installing/index.mdx +++ b/product_docs/docs/epas/17/installing/index.mdx @@ -14,8 +14,8 @@ redirects: navigation: - linux_x86_64 - - linux_ppc64le - linux_arm64 + - linux_ppc64le - windows - linux_install_details - windows_install_details @@ -57,6 +57,12 @@ Select a link to access the applicable installation instructions: ## Linux [AArch64 (ARM64)](linux_arm64) +### Red Hat Enterprise Linux (RHEL) and derivatives + +- [RHEL 9](linux_arm64/epas_rhel_9) + +- [Oracle Linux (OL) 9](linux_arm64/epas_rhel_9) + ### Debian and derivatives - [Debian 12](linux_arm64/epas_debian_12) diff --git a/product_docs/docs/epas/17/installing/linux_arm64/epas_rhel_9.mdx b/product_docs/docs/epas/17/installing/linux_arm64/epas_rhel_9.mdx new file mode 100644 index 00000000000..aa04ebba1fb --- /dev/null +++ b/product_docs/docs/epas/17/installing/linux_arm64/epas_rhel_9.mdx @@ -0,0 +1,157 @@ +--- +navTitle: RHEL 9 or OL 9 +title: Installing EDB Postgres Advanced Server on RHEL 9 or OL 9 arm64 +# This topic is generated from templates. If you have feedback on it, instead of +# editing the page and creating a pull request, please enter a GitHub issue and +# the documentation team will update the templates accordingly. + +redirects: + - /epas/17/epas_inst_linux/installing_epas_using_edb_repository/arm64/epas_rhel9_arm + - /epas/17/epas_inst_linux/installing_epas_using_edb_repository/arm/epas_rhel9_arm +--- + +## Prerequisites + +Before you begin the installation process: + +- Set up the EDB repository. + + 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: + + `dnf repolist | grep 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 EPEL repository: + + ```shell + sudo dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm + ``` + +- If you are also installing PostGIS, enable additional repositories to resolve dependencies: + + ```shell + ARCH=$( /bin/arch ) subscription-manager repos --enable "codeready-builder-for-rhel-9-${ARCH}-rpms" + ``` + + !!!note + + If you are using a public cloud RHEL image, `subscription manager` may not be enabled and enabling it may incur unnecessary charges. Equivalent packages may be available under a different name such as `codeready-builder-for-rhel-9-rhui-rpms`. Consult the documentation for the RHEL image you are using to determine how to install `codeready-builder`. + + !!! + +## Install the package + +```shell +sudo dnf -y install edb-as-server +``` + +Where `` is the version of the EDB Postgres Advanced Server you're installing. For example, if you're installing version 17, the package name is `edb-as17-server`. + +To install an individual component: + +```shell +sudo dnf -y install +``` + +Where `package_name` can be any of the available packages from the [available package list](/epas/17/installing/linux_install_details/rpm_packages/). + +Installing the server package creates an operating system user named enterprisedb. The user is assigned a user ID (UID) and a group ID (GID). The user has no default password. Use the `passwd` command to assign a password for the user. The default shell for the user is `bash`, and the user's home directory is `/var/lib/edb/as17`. + +## Initial configuration + +Getting started with your cluster involves logging in, ensuring the installation and initial configuration was successful, connecting to your cluster, and creating the user password. + +First, you need to initialize and start the database cluster. The `edb-as-17-setup` script creates a cluster in Oracle-compatible mode with the `edb` sample database in the cluster. To create a cluster in Postgres mode, see [Initializing the cluster in Postgres mode](../linux_install_details/managing_an_advanced_server_installation/specifying_cluster_options/#initializing-the-cluster-in-postgres-mode). + +```shell +sudo PGSETUP_INITDB_OPTIONS="-E UTF-8" /usr/edb/as17/bin/edb-as-17-setup initdb + +sudo systemctl start edb-as-17 +``` + +To work in your cluster, log in as the enterprisedb user. Connect to the database server using the psql command-line client. Alternatively, you can use a client of your choice with the appropriate connection string. + +```shell +sudo su - enterprisedb + +psql edb +``` + +The server runs with the `peer` or `ident` permission by default. You can change the authentication method by modifying the `pg_hba.conf` file. + +Before changing the authentication method, assign a password to the database superuser, enterprisedb. For more information on changing the authentication, see [Modifying the pg_hba.conf file](../../database_administration/01_configuration_parameters/01_setting_new_parameters/#modifying-the-pg_hbaconf-file). + +```sql +ALTER ROLE enterprisedb IDENTIFIED BY password; +``` + +## Experiment + +Now you're ready to create and connect to a database, create a table, insert data in a table, and view the data from the table. + +First, use psql to create a database named `hr` to hold human resource information. + +```sql +# running in psql +CREATE DATABASE hr; +__OUTPUT__ +CREATE DATABASE +``` + +Connect to the `hr` database inside psql: + +``` +\c hr +__OUTPUT__ +psql (17.0.0, server 17.0.0) +You are now connected to database "hr" as user "enterprisedb". +``` + +Create columns to hold department numbers, unique department names, and locations: + +``` +CREATE TABLE public.dept (deptno numeric(2) NOT NULL CONSTRAINT dept_pk +PRIMARY KEY, dname varchar(14) CONSTRAINT dept_dname_uq UNIQUE, loc +varchar(13)); +__OUTPUT__ +CREATE TABLE +``` + +Insert values into the `dept` table: + +``` +INSERT INTO dept VALUES (10,'ACCOUNTING','NEW YORK'); +__OUTPUT__ +INSERT 0 1 +``` + +``` +INSERT into dept VALUES (20,'RESEARCH','DALLAS'); +__OUTPUT__ +INSERT 0 1 +``` + +View the table data by selecting the values from the table: + +``` +SELECT * FROM dept; +__OUTPUT__ +deptno | dname | loc +--------+------------+---------- +10 | ACCOUNTING | NEW YORK +20 | RESEARCH | DALLAS +(2 rows) +``` diff --git a/product_docs/docs/epas/17/installing/linux_arm64/index.mdx b/product_docs/docs/epas/17/installing/linux_arm64/index.mdx index c1e50ddb610..10c64a6a576 100644 --- a/product_docs/docs/epas/17/installing/linux_arm64/index.mdx +++ b/product_docs/docs/epas/17/installing/linux_arm64/index.mdx @@ -3,11 +3,18 @@ title: "Installing EDB Postgres Advanced Server on Linux AArch64 (ARM64)" navTitle: "On Linux ARM64" navigation: + - epas_rhel_9 - epas_debian_12 --- Operating system-specific install instructions are described in the corresponding documentation: +### Red Hat Enterprise Linux (RHEL) and derivatives + +- [RHEL 9](epas_rhel_9) + +- [Oracle Linux (OL) 9](epas_rhel_9) + ### Debian and derivatives - [Debian 12](epas_debian_12) diff --git a/product_docs/docs/ocl_connector/17/installing/index.mdx b/product_docs/docs/ocl_connector/17/installing/index.mdx index 78a2585180f..6428feff91d 100644 --- a/product_docs/docs/ocl_connector/17/installing/index.mdx +++ b/product_docs/docs/ocl_connector/17/installing/index.mdx @@ -57,6 +57,12 @@ Select a link to access the applicable installation instructions: ## Linux [AArch64 (ARM64)](linux_arm64) +### Red Hat Enterprise Linux (RHEL) and derivatives + +- [RHEL 9](linux_arm64/ocl_rhel_9) + +- [Oracle Linux (OL) 9](linux_arm64/ocl_rhel_9) + ### Debian and derivatives - [Debian 12](linux_arm64/ocl_debian_12) diff --git a/product_docs/docs/ocl_connector/17/installing/linux_arm64/index.mdx b/product_docs/docs/ocl_connector/17/installing/linux_arm64/index.mdx index 15061e86556..23b7a315d78 100644 --- a/product_docs/docs/ocl_connector/17/installing/linux_arm64/index.mdx +++ b/product_docs/docs/ocl_connector/17/installing/linux_arm64/index.mdx @@ -3,11 +3,18 @@ title: "Installing EDB OCL Connector on Linux AArch64 (ARM64)" navTitle: "On Linux ARM64" navigation: + - ocl_rhel_9 - ocl_debian_12 --- Operating system-specific install instructions are described in the corresponding documentation: +### Red Hat Enterprise Linux (RHEL) and derivatives + +- [RHEL 9](ocl_rhel_9) + +- [Oracle Linux (OL) 9](ocl_rhel_9) + ### Debian and derivatives - [Debian 12](ocl_debian_12) diff --git a/product_docs/docs/ocl_connector/17/installing/linux_arm64/ocl_rhel_9.mdx b/product_docs/docs/ocl_connector/17/installing/linux_arm64/ocl_rhel_9.mdx new file mode 100644 index 00000000000..908f9e3faeb --- /dev/null +++ b/product_docs/docs/ocl_connector/17/installing/linux_arm64/ocl_rhel_9.mdx @@ -0,0 +1,52 @@ +--- +navTitle: RHEL 9 or OL 9 +title: Installing EDB OCL Connector on RHEL 9 or OL 9 arm64 +# This topic is generated from templates. If you have feedback on it, instead of +# editing the page and creating a pull request, please enter a GitHub issue and +# the documentation team will update the templates accordingly. + +redirects: + - /ocl_connector/17/04_open_client_library/01_installing_and_configuring_the_ocl_connector/install_on_linux_using_edb_repo/arm64/ocl_rhel9_arm +--- + +## Prerequisites + +Before you begin the installation process: + +- Install Postgres on a host that the product can connect to using a connection string. It doesn't need to be on the same host. See: + + - [Installing EDB Postgres Advanced Server](/epas/latest/installing/) + + - [Installing PostgreSQL](https://www.postgresql.org/download/) + +- Set up the EDB repository. + + 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: + + `dnf repolist | grep 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 EPEL repository: + ```shell + sudo dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm + ``` + +## Install the package + +```shell +sudo dnf -y install edb-oci +sudo dnf -y install edb-oci-devel +``` diff --git a/product_docs/docs/pge/17/installing/index.mdx b/product_docs/docs/pge/17/installing/index.mdx index 0cc88e55d5e..4883cc3bb07 100644 --- a/product_docs/docs/pge/17/installing/index.mdx +++ b/product_docs/docs/pge/17/installing/index.mdx @@ -31,6 +31,12 @@ Select a link to access the applicable installation instructions: ## Linux [AArch64 (ARM64)](linux_arm64) +### Red Hat Enterprise Linux (RHEL) and derivatives + +- [RHEL 9](linux_arm64/pge_rhel_9) + +- [Oracle Linux (OL) 9](linux_arm64/pge_rhel_9) + ### Debian and derivatives - [Debian 12](linux_arm64/pge_debian_12) diff --git a/product_docs/docs/pge/17/installing/linux_arm64/index.mdx b/product_docs/docs/pge/17/installing/linux_arm64/index.mdx index 230f6000758..04d27036fdd 100644 --- a/product_docs/docs/pge/17/installing/linux_arm64/index.mdx +++ b/product_docs/docs/pge/17/installing/linux_arm64/index.mdx @@ -3,11 +3,18 @@ title: "Installing EDB Postgres Extended Server on Linux AArch64 (ARM64)" navTitle: "On Linux ARM64" navigation: + - pge_rhel_9 - pge_debian_12 --- Operating system-specific install instructions are described in the corresponding documentation: +### Red Hat Enterprise Linux (RHEL) and derivatives + +- [RHEL 9](pge_rhel_9) + +- [Oracle Linux (OL) 9](pge_rhel_9) + ### Debian and derivatives - [Debian 12](pge_debian_12) diff --git a/product_docs/docs/pge/17/installing/linux_arm64/pge_rhel_9.mdx b/product_docs/docs/pge/17/installing/linux_arm64/pge_rhel_9.mdx new file mode 100644 index 00000000000..37ed943c9e6 --- /dev/null +++ b/product_docs/docs/pge/17/installing/linux_arm64/pge_rhel_9.mdx @@ -0,0 +1,129 @@ +--- +navTitle: RHEL 9 or OL 9 +title: Installing EDB Postgres Extended Server on RHEL 9 or OL 9 arm64 +# This topic is generated from templates. If you have feedback on it, instead of +# editing the page and creating a pull request, please enter a GitHub issue and +# the documentation team will update the templates accordingly. + +redirects: +--- + +## Prerequisites + +Before you begin the installation process: + +- Set up the EDB repository. + + 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: + + `dnf repolist | grep 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 EPEL repository: + ```shell + sudo dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm + ``` + +## Install the package + +```shell +sudo dnf -y install edb-postgresextended17-server edb-postgresextended17-contrib +``` + +## Initial configuration + +Getting started with your cluster involves logging in, ensuring the installation and initial configuration was successful, connecting to your cluster, and creating the user password. + +First, you need to initialize and start the database cluster. The `edb-pge-17-setup` script creates a cluster. + +```shell +sudo PGSETUP_INITDB_OPTIONS="-E UTF-8" /usr/edb/pge17/bin/edb-pge-17-setup initdb + +sudo systemctl start edb-pge-17 +``` + +To work in your cluster, log in as the postgres user. Connect to the database server using the psql command-line client. Alternatively, you can use a client of your choice with the appropriate connection string. + +```shell +sudo -iu postgres + +psql postgres +``` + +The server runs with the `peer` or `ident` permission by default. You can change the authentication method by modifying the `pg_hba.conf` file. + +Before changing the authentication method, assign a password to the database superuser, postgres. For more information on changing the authentication, see [Modifying the pg_hba.conf file](../../administration/01_setting_configuration_parameters/#modifying-the-pg_hbaconf-file). + +```sql +ALTER ROLE postgres with PASSWORD 'password'; +``` + +## Experiment + +Now you're ready to create and connect to a database, create a table, insert data in a table, and view the data from the table. + +First, use psql to create a database named `hr` to hold human resource information. + +```sql +# running in psql +CREATE DATABASE hr; +__OUTPUT__ +CREATE DATABASE +``` + +Connect to the `hr` database inside psql: + +``` +\c hr +__OUTPUT__ +You are now connected to database "hr" as user "postgres". +``` + +Create columns to hold department numbers, unique department names, and locations: + +``` +CREATE TABLE public.dept (deptno numeric(2) NOT NULL CONSTRAINT dept_pk +PRIMARY KEY, dname varchar(14) CONSTRAINT dept_dname_uq UNIQUE, loc +varchar(13)); +__OUTPUT__ +CREATE TABLE +``` + +Insert values into the `dept` table: + +``` +INSERT INTO dept VALUES (10,'ACCOUNTING','NEW YORK'); +__OUTPUT__ +INSERT 0 1 +``` + +``` +INSERT into dept VALUES (20,'RESEARCH','DALLAS'); +__OUTPUT__ +INSERT 0 1 +``` + +View the table data by selecting the values from the table: + +``` +SELECT * FROM dept; +__OUTPUT__ +deptno | dname | loc +--------+------------+---------- +10 | ACCOUNTING | NEW YORK +20 | RESEARCH | DALLAS +(2 rows) +```