Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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 @@ -108,7 +108,7 @@ See the *WarehousePG Reference Guide* for information about the WarehousePG serv

PL/Java requires a Java runtime environment on each WarehousePG host. Ensure that the same Java environment is at the same location on all hosts: masters and segments. The command `java -version` displays the Java version.

The commands that you use to install Java depend on the host system operating system and Java version. This list describes how to install OpenJDK 8 or 11 (Java 8 JDK or Java 11 JDK) on RHEL/CentOS or Ubuntu.
The commands that you use to install Java depend on the host system operating system and Java version. This list describes how to install OpenJDK 8 or 11 (Java 8 JDK or Java 11 JDK) on RHEL/CentOS.

- RHEL 7/CentOS 7 - This `yum` command installs OpenJDK 8 or 11.

Expand Down Expand Up @@ -142,23 +142,12 @@ The commands that you use to install Java depend on the host system operating sy

The second command returns some `failed to read link` errors that can be ignored.

- Ubuntu - These `apt` commands install OpenJDK 8 or 11.

```
$ sudo apt update
$ sudo apt install openjdk-<version>-jdk
```

For OpenJDK 8 the version is `8`, for OpenJDK 11 the version is `11`.

After installing OpenJDK on a RHEL or CentOS system, run this `update-alternatives` command to change the default Java. Enter the number that represents the OpenJDK version to use as the default.

```
$ sudo update-alternatives --config java
```

The `update-alternatives` command is not required on Ubuntu systems.

> **Note** When configuring host systems, you can use the [gpssh](../../../ref_guide/utility_guide/reference/gpssh.md) utility to run bash shell commands on multiple remote hosts.

<a id="topic4"></a>
Expand Down
24 changes: 0 additions & 24 deletions docs/whpg/6x/admin_guide/analytics/procedural_languages/pl_r.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,8 +30,6 @@ For information about supported PL/R versions, see the *WarehousePG Release Note

For RHEL and CentOS, installing the PL/R package installs R in `$GPHOME/ext/R-<version>` and updates `$GPHOME/greenplum_path.sh` for WarehousePG to use R.

To use PL/R on Ubuntu host systems, you must install and configure R on all WarehousePG host systems before installing PL/R.

> **Note** You can use the [gpssh](../../../ref_guide/utility_guide/reference/gpssh.md) utility to run bash shell commands on multiple remote hosts.

1. To install R, run these `apt` commands on all host systems.
Expand Down Expand Up @@ -106,7 +104,6 @@ PL/R is registered as an untrusted language.

- [Remove PL/R Support for a Database](#topic7)
- [Uninstall the Extension Package](#topic8)
- [Uninstall R (Ubuntu)](#topic_ifv_tsf_w3b)

When you remove PL/R language support from a database, the PL/R routines that you created in the database will no longer work.

Expand All @@ -130,27 +127,6 @@ If no databases have PL/R as a registered language, uninstall the WarehousePG PL

On RHEL and CentOS systems, uninstalling the extension uninstalls the R software that was installed with the extension.

For Ubuntu systems, remove the `R_HOME` environment variable from `greenplum_path.sh` on all WarehousePG host systems.

Source the file `$GPHOME/greenplum_path.sh` and restart the database.

```
$ gpstop -r
```

<a id="topic_ifv_tsf_w3b"></a>

#### Uninstall R (Ubuntu)

For Ubuntu systems, remove R from all WarehousePG host systems. These commands remove R from an Ubuntu system.

```
$ sudo apt remove r-base
$ sudo apt remove r-base-core
```

Removing `r-base` does not uninstall the R executable. Removing `r-base-core` uninstalls the R executable.

<a id="topic9"></a>

### Examples
Expand Down
141 changes: 35 additions & 106 deletions docs/whpg/6x/admin_guide/manage_access/client_auth/index.md

Large diffs are not rendered by default.

22 changes: 8 additions & 14 deletions docs/whpg/6x/install_guide/config_os.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ If you choose to enable SELinux in `Enforcing` mode, then WarehousePG processes

## Deactivate or Configure Firewall Software

You should also deactivate firewall software such as `iptables` (on systems such as RHEL 6.x and CentOS 6.x ), `firewalld` (on systems such as RHEL 7.x and CentOS 7.x and later), or `ufw` (on Ubuntu systems, deactivated by default). If firewall software is not deactivated, you must instead configure your software to allow required communication between WarehousePG hosts.
You should also deactivate firewall software such as `iptables` (on systems such as RHEL 6.x and CentOS 6.x) or `firewalld` (on systems such as RHEL 7.x and CentOS 7.x and later). If firewall software is not deactivated, you must instead configure your software to allow required communication between WarehousePG hosts.

To deactivate `iptables`:

Expand Down Expand Up @@ -344,7 +344,7 @@ XFS is the preferred data storage file system on Linux platforms. Use the `mount
rw,nodev,noatime,nobarrier,inode64
```

The `nobarrier` option is not supported on RHEL 8 or Ubuntu systems or later. Use only the options:
The `nobarrier` option is not supported on RHEL 8 systems or later. Use only the options:

```
rw,nodev,noatime,inode64
Expand Down Expand Up @@ -425,7 +425,7 @@ The XFS options can also be set in the `/etc/fstab` file. This example entry fro
<tbody>
<tr>
<td>Non-Volatile Memory Express (NVMe)</td>
<td>RHEL 7<br />RHEL 8<br />RHEL 9<br />Ubuntu</td>
<td>RHEL 7<br />RHEL 8<br />RHEL 9</td>
<td><code>none</code></td>
</tr>
<tr>
Expand All @@ -434,7 +434,7 @@ The XFS options can also be set in the `/etc/fstab` file. This example entry fro
<td><code>noop</code></td>
</tr>
<tr>
<td>RHEL 8<br />RHEL 9<br />Ubuntu</td>
<td>RHEL 8<br />RHEL 9</td>
<td><code>none</code></td>
</tr>
<tr>
Expand All @@ -443,7 +443,7 @@ The XFS options can also be set in the `/etc/fstab` file. This example entry fro
<td><code>deadline</code></td>
</tr>
<tr>
<td>RHEL 8<br />RHEL 9<br />Ubuntu</td>
<td>RHEL 8<br />RHEL 9</td>
<td><code>mq-deadline</code></td>
</tr>
</tbody>
Expand Down Expand Up @@ -479,7 +479,7 @@ The XFS options can also be set in the `/etc/fstab` file. This example entry fro

Refer to your operating system documentation for more information about the `grubby` utility. If you used the `grubby` command to configure the disk scheduler on a RHEL or CentOS 7.x system and later and it does not update the kernels, see the [Note](#grubby_note) at the end of the section.

For additional information about configuring the disk scheduler, refer to the RedHat Enterprise Linux documentation for [RHEL 7](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/performance_tuning_guide/sect-red_hat_enterprise_linux-performance_tuning_guide-storage_and_file_systems-configuration_tools#sect-Red_Hat_Enterprise_Linux-Performance_Tuning_Guide-Configuration_tools-Setting_the_default_IO_scheduler), [RHEL 8](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/monitoring_and_managing_system_status_and_performance/setting-the-disk-scheduler_monitoring-and-managing-system-status-and-performance), or [RHEL 9](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/monitoring_and_managing_system_status_and_performance/setting-the-disk-scheduler_monitoring-and-managing-system-status-and-performance). The Ubuntu wiki [IOSchedulers](https://wiki.ubuntu.com/Kernel/Reference/IOSchedulers) topic describes the I/O schedulers available on Ubuntu systems.
For additional information about configuring the disk scheduler, refer to the RedHat Enterprise Linux documentation for [RHEL 7](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/performance_tuning_guide/sect-red_hat_enterprise_linux-performance_tuning_guide-storage_and_file_systems-configuration_tools#sect-Red_Hat_Enterprise_Linux-Performance_Tuning_Guide-Configuration_tools-Setting_the_default_IO_scheduler), [RHEL 8](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/monitoring_and_managing_system_status_and_performance/setting-the-disk-scheduler_monitoring-and-managing-system-status-and-performance), or [RHEL 9](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/monitoring_and_managing_system_status_and_performance/setting-the-disk-scheduler_monitoring-and-managing-system-status-and-performance).

<a id="networking"></a>

Expand Down Expand Up @@ -518,12 +518,6 @@ On systems that use `grub2` such as RHEL 7.x or CentOS 7.x and later, use the sy

After adding the parameter, reboot the system.

For Ubuntu systems, install the `hugepages` package and run this command as root:

```
# hugeadm --thp-never
```

This cat command checks the state of THP. The output indicates that THP is deactivated.

```
Expand All @@ -537,7 +531,7 @@ For more information about Transparent Huge Pages or the `grubby` utility, see y

### IPC Object Removal

Deactivate IPC object removal for RHEL 7.2 or CentOS 7.2, or Ubuntu. The default `systemd` setting `RemoveIPC=yes` removes IPC connections when non-system user accounts log out. This causes the WarehousePG utility `gpinitsystem` to fail with semaphore errors. Perform one of the following to avoid this issue.
Deactivate IPC object removal for RHEL 7.2 or CentOS 7.2. The default `systemd` setting `RemoveIPC=yes` removes IPC connections when non-system user accounts log out. This causes the WarehousePG utility `gpinitsystem` to fail with semaphore errors. Perform one of the following to avoid this issue.

- When you add the `gpadmin` operating system user account to the coordinator node in [Creating the WarehousePG Administrative User](#topic23), create the user as a system account.
- Deactivate `RemoveIPC`. Set this parameter in `/etc/systemd/logind.conf` on the WarehousePG host systems.
Expand Down Expand Up @@ -700,7 +694,7 @@ The following steps show how to set up the `gpadmin` user on a host, set a passw

1. Create the `gpadmin` group and user.

> **Note** If you are installing WarehousePG on RHEL 7.2 or CentOS 7.2 and want to deactivate IPC object removal by creating the `gpadmin` user as a system account, provide both the `-r` option (create the user as a system account) and the `-m` option (create a home directory) to the `useradd` command. On Ubuntu systems, you must use the `-m` option with the `useradd` command to create a home directory for a user.
> **Note** If you are installing WarehousePG on RHEL 7.2 or CentOS 7.2 and want to deactivate IPC object removal by creating the `gpadmin` user as a system account, provide both the `-r` option (create the user as a system account) and the `-m` option (create a home directory) to the `useradd` command.

This example creates the `gpadmin` group, creates the `gpadmin` user as a system account with a home directory and as a member of the `gpadmin` group, and creates a password for the user.

Expand Down
13 changes: 4 additions & 9 deletions docs/whpg/6x/install_guide/install_whpg.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,9 +45,9 @@ See [Example Ansible Playbook](ansible-example.md) for an example script that sh

Follow these instructions to install WarehousePG from a pre-built binary.

> **Important** You require sudo or root user access to install from a pre-built RPM or DEB file.
> **Important** You require sudo or root user access to install from a pre-built RPM file.

1. Download and copy the WarehousePG package to the `gpadmin` user's home directory on the coordinator, standby coordinator, and every segment host machine. The distribution file name has the format `greenplum-db-<version>-<platform>.rpm` for RHEL, CentOS, and Oracle Linux systems, or `greenplum-db-<version>-<platform>.deb` for Ubuntu systems, where `<platform>` is similar to `rhel7-x86_64` (Red Hat 7 64-bit).
1. Download and copy the WarehousePG package to the `gpadmin` user's home directory on the coordinator, standby coordinator, and every segment host machine. The distribution file name has the format `greenplum-db-<version>-<platform>.rpm` for RHEL, CentOS, and Oracle Linux systems, where `<platform>` is similar to `rhel7-x86_64` (Red Hat 7 64-bit).

> **Note** For Oracle Linux installations, download and install the `rhel7-x86_64`distribution files.

Expand All @@ -58,13 +58,8 @@ Follow these instructions to install WarehousePG from a pre-built binary.
```
$ sudo yum install ./greenplum-db-<version>-<platform>.rpm
```
- For Ubuntu systems, run the `apt` command:

```
$ sudo apt install ./greenplum-db-<version>-<platform>.deb
```

The `yum` or `apt` command automatically installs software dependencies, copies the WarehousePG software files into a version-specific directory under `/usr/local`, `/usr/local/greenplum-db-<version>`, and creates the symbolic link `/usr/local/greenplum-db` to the installation directory.
The `yum` command automatically installs software dependencies, copies the WarehousePG software files into a version-specific directory under `/usr/local`, `/usr/local/greenplum-db-<version>`, and creates the symbolic link `/usr/local/greenplum-db` to the installation directory.

3. Change the owner and group of the installed files to `gpadmin`:

Expand All @@ -83,7 +78,7 @@ Follow these instructions to install WarehousePG to a specific directory.

> **Important** You require sudo or root user access to install from a pre-built RPM file.

1. Download and copy the WarehousePG package to the `gpadmin` user's home directory on the coordinator, standby coordinator, and every segment host machine. The distribution file name has the format `greenplum-db-<version>-<platform>.rpm` for RHEL and CentOS systems, or `greenplum-db-<version>-<platform>.deb` for Ubuntu systems, where `<platform>` is similar to `rhel7-x86_64` (Red Hat 7 64-bit).
1. Download and copy the WarehousePG package to the `gpadmin` user's home directory on the coordinator, standby coordinator, and every segment host machine. The distribution file name has the format `greenplum-db-<version>-<platform>.rpm` for RHEL and CentOS systems, where `<platform>` is similar to `rhel7-x86_64` (Red Hat 7 64-bit).

2. Manually install the WarehousePG dependencies to each host system:

Expand Down
2 changes: 1 addition & 1 deletion docs/whpg/6x/install_guide/migrate-linux.md
Original file line number Diff line number Diff line change
Expand Up @@ -375,7 +375,7 @@ When you prepare your operating system environment for WarehousePG software inst

### XFS Mount Options

XFS is the preferred data storage file system on Linux platforms. Use the mount command with the following recommended XFS mount options. The `nobarrier` option is not supported on EL 8/9 or Ubuntu systems. Use only the options `rw,nodev,noatime,inode64`.
XFS is the preferred data storage file system on Linux platforms. Use the mount command with the following recommended XFS mount options. The `nobarrier` option is not supported on EL 8/9 systems. Use only the options `rw,nodev,noatime,inode64`.

<a id="diskio"></a>

Expand Down
38 changes: 3 additions & 35 deletions docs/whpg/6x/install_guide/platform-requirements.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,6 @@ WarehousePG 6 runs on the following operating system platforms:
- Rocky Linux 8.7 or later
- CentOS 64-bit 7.x
- CentOS 64-bit 6.x
- Ubuntu 18.04 LTS
- Oracle Linux 64-bit 7, using the Red Hat Compatible Kernel (RHCK)

<a id="rhel-issues"></a>
Expand All @@ -37,7 +36,7 @@ RHEL 7.3 and CentOS 7.3 resolves the issue.

> **Caution** A kernel issue in Red Hat Enterprise Linux 8.5 and 8.6 can cause I/O freezes and synchronization problems with XFS filesystems. This issue is fixed in RHEL 8.7. See [RHEL8: xfs_buf deadlock between inode deletion and block allocation](https://access.redhat.com/solutions/6984334).

WarehousePG server supports TLS version 1.2 on RHEL/CentOS systems, and TLS version 1.3 on Ubuntu systems.
WarehousePG server supports TLS version 1.2 and TLS version 1.3 on RHEL/CentOS systems.

<a id="topic_i4k_nlx_zgb"></a>

Expand Down Expand Up @@ -91,36 +90,6 @@ WarehousePG 6 client software requires these operating system packages:
- openssh
- zlib

On Ubuntu systems, WarehousePG 6 requires the following software packages, which are installed automatically as dependencies when you install WarehousePG with the Debian package installer:

- bash
- bzip2
- iproute2
- iputils-ping
- krb5-multidev
- libapr1
- libaprutil1
- libcurl3-gnutls
- libcurl4
- libevent-2.1-6
- libldap-2.4-2
- libreadline7 or libreadline8
- libuuid1
- libxml2
- libyaml-0-2
- less
- locales
- net-tools
- openssh-client
- openssh-server
- openssl
- perl
- rsync
- sed
- tar
- zip
- zlib1g

WarehousePG 6 uses Python 2.7.18, which is included with the product installation (and not installed as a package dependency).

> **Important** SSL is supported only on the WarehousePG coordinator host system. It cannot be used on the segment host systems.
Expand Down Expand Up @@ -162,8 +131,7 @@ This table lists the versions of the WarehousePG Extensions that are compatible
<tr class="row">
<td class="entry nocellnorowborder" style="vertical-align:top;" headers="d78288e683"><a class="xref" href="../admin_guide/analytics/procedural_languages/pl_r.md">PL/R</a></td>
<td class="entry nocellnorowborder" style="vertical-align:top;" headers="d78288e686">3.0.3</td>
<td class="entry cell-norowborder" style="vertical-align:top;" headers="d78288e689">(CentOS) R 3.3.3<p class="p"> (Ubuntu) You install R 3.5.1+.</p>
</td>
<td class="entry cell-norowborder" style="vertical-align:top;" headers="d78288e689">R 3.3.3</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" style="vertical-align:top;" headers="d78288e683"><a class="xref" href="../admin_guide/analytics/madlib.md">MADlib Machine Learning</a></td>
Expand Down Expand Up @@ -272,7 +240,7 @@ The disk settings for cloud deployments are the same as on-premise with a few mo
```
rw,noatime,nobarrier,nodev,inode64
```
> **Note** The `nobarrier` option is not supported on RHEL 8 or Ubuntu nodes.
> **Note** The `nobarrier` option is not supported on RHEL 8 nodes.
- Use mq-deadline instead of the deadline scheduler for the R5 series instance type in AWS
- Use a swap disk per VM (32GB size works well)

Expand Down
10 changes: 2 additions & 8 deletions docs/whpg/6x/install_guide/upgrading.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,21 +51,15 @@ Starting from WarehousePG 6.27.4, the default installation directory is `/usr/ed

3. Copy the new WarehousePG software installation package to the `gpadmin` user's home directory on each coordinator, standby, and segment host.

4. *If you used `yum` or `apt` to install WarehousePG to the default location*, run these commands on each host to upgrade to the new software release.
4. *If you used `yum` to install WarehousePG to the default location*, run this command on each host to upgrade to the new software release.

For RHEL/CentOS systems:

```
$ sudo yum upgrade ./greenplum-db-<version>-<platform>.rpm
```

For Ubuntu systems:

```
# apt install ./greenplum-db-<version>-<platform>.deb
```

The `yum` or `apt` command installs the new WarehousePG software files into a version-specific directory under `/usr/edb/whpg6` and updates the symbolic link `/usr/local/greenplum-db` to point to the new installation directory.
The `yum` command installs the new WarehousePG software files into a version-specific directory under `/usr/edb/whpg6` and updates the symbolic link `/usr/local/greenplum-db` to point to the new installation directory.

5. *If you used `rpm` to install WarehousePG to a non-default location on RHEL/CentOS systems*, run `rpm` on each host to upgrade to the new software release and specify the same custom installation directory with the `--prefix` option. For example:

Expand Down
14 changes: 0 additions & 14 deletions docs/whpg/7x/admin_guide/analytics/procedural_languages/pl_r.md
Original file line number Diff line number Diff line change
Expand Up @@ -103,7 +103,6 @@ PL/R is registered as an untrusted language.
### Uninstalling PL/R

- [Remove PL/R Support for a Database](#topic7)
- [Uninstall R (Ubuntu)](#topic_ifv_tsf_w3b)

When you remove PL/R language support from a database, the PL/R routines that you created in the database will no longer work.

Expand All @@ -119,19 +118,6 @@ $ psql -d testdb -c 'DROP EXTENSION plr;'

The default command fails if any existing objects (such as functions) depend on the language. Specify the `CASCADE` option to also drop all dependent objects, including functions that you created with PL/R.

<a id="topic_ifv_tsf_w3b"></a>

#### Uninstall R (Ubuntu)

For Ubuntu systems, remove R from all WarehousePG host systems. These commands remove R from an Ubuntu system.

```
$ sudo apt remove r-base
$ sudo apt remove r-base-core
```

Removing `r-base` does not uninstall the R executable. Removing `r-base-core` uninstalls the R executable.

<a id="topic9"></a>

### Examples
Expand Down
Loading