Skip to content

Commit

Permalink
Merge pull request #2514 from EnterpriseDB/release/2022-04-01
Browse files Browse the repository at this point in the history
Release: 2022-04-01
  • Loading branch information
drothery-edb authored Apr 1, 2022
2 parents 71291a1 + 0aa04f7 commit c0f08e4
Show file tree
Hide file tree
Showing 99 changed files with 1,124 additions and 656 deletions.
2 changes: 2 additions & 0 deletions advocacy_docs/migrating/oracle/index.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
---
title: 'Oracle to EDB Postgres Advanced Server Migration Handbook'
indexCards: none
directoryDefaults:
product: "Migration Handbook"
navigation:
- "#Overview for migrating your Oracle database"
- factors_to_consider
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,15 +9,15 @@ New features, enhancements, bug fixes, and other changes in the EDB JDBC Connect

| Type | Description |
| -------------- | ------------------------------------------------------------------------------- |
| Upstream Merge | Merged with the upstream community driver version `42.3.2`. See the community [JDBC documentation](https://jdbc.postgresql.org/documentation/changelog.html#version_42.3.2) for details. |
| New Feature | `org.checkerframework.*` was previously packaged in the EDB JDBC jar file; causing conflicts with other applications utilizing `org.checkerfamework.*` with different versions. New feature is packaging the checker framework under a custom namespace in the connector using the shade plugin. [Support Ticket: #74134] |
| New Feature | JMS based API to interact with DBMS_AQ package seamlessly. This API has been made part of edb-jdbc code under com.edb.jms and com.edb.aq packages. |
| Upstream merge | Merged with the upstream community driver version `42.3.2`. See the community [JDBC documentation](https://jdbc.postgresql.org/documentation/changelog.html#version_42.3.2) for details. |
| New feature | `org.checkerframework.*` was previously packaged in the EDB JDBC jar file; causing conflicts with other applications utilizing `org.checkerfamework.*` with different versions. New feature is packaging the checker framework under a custom namespace in the connector using the shade plugin. [Support Ticket: #74134] |
| New feature | JMS based API to interact with DBMS_AQ package seamlessly. This API has been made part of edb-jdbc code under com.edb.jms and com.edb.aq packages. |
| Enhancement | New property oidTimestamp used to change default behavior of driver when using setTimeStamp method for preparedStatement. If property oidTimestamp it is set to true, sets the oid to Oid.TIMESTAMP, otherwise uses default behavior. |
| Bug Fix | Issue: Change in date format nls_date_format=’YYYY/MM/DD’ in EDB\*PLUS gives error. [Support Ticket: #75812] |
| Bug Fix | Rounding differences between EDB and Oracle. [Support Ticket: #72708] |
| Security Fix | CVE-2022-21724 as part of community merge with v42.3.2 |
| Security Fix | CVE-2021-36373 - Removed dependency for org.apache.ant |
| Security Fix | CVE-2020-15250 - junit fix for temporary folder. |
| Bug fix | Issue: Change in date format nls_date_format=’YYYY/MM/DD’ in EDB\*PLUS gives error. [Support Ticket: #75812] |
| Bug fix | Rounding differences between EDB and Oracle. [Support Ticket: #72708] |
| Security fix | CVE-2022-21724 as part of community merge with v42.3.2 |
| Security fix | CVE-2021-36373 - Removed dependency for org.apache.ant |
| Security fix | CVE-2020-15250 - junit fix for temporary folder. |



Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,4 +9,4 @@ New features, enhancements, bug fixes, and other changes in the EDB JDBC Connect

| Type | Description |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Upstream Merge | Merged with the upstream community driver version `42.2.24`. See the community [JDBC documentation](https://jdbc.postgresql.org/documentation/head/index.html) for details. |
| Upstream merge | Merged with the upstream community driver version `42.2.24`. See the community [JDBC documentation](https://jdbc.postgresql.org/documentation/head/index.html) for details. |
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ New features, enhancements, bug fixes, and other changes in the EDB JDBC Connect

| Type | Description |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Upstream Merge | Merged with the upstream community driver version `42.2.19`. See the [community JDBC documentation](https://jdbc.postgresql.org/documentation/head/index.html) for details. |
| Upstream merge | Merged with the upstream community driver version `42.2.19`. See the [community JDBC documentation](https://jdbc.postgresql.org/documentation/head/index.html) for details. |
| Enhancement | EDB JDBC Connector now supports GSSAPI encrypted connection. See [Support for GSSAPI Encrypted Connection](../09_security_and_encryption/03_support_for_gssapi_encrypted_connection). |

!!! Note
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ New features, enhancements, bug fixes, and other changes in the EDB JDBC Connect

| Type | Description |
| -------------- | ------------------------------------------------------------------------------- |
| Upstream Merge | Merged with the upstream community driver version `42.2.8`. See the community [JDBC documentation](https://jdbc.postgresql.org/documentation/head/index.html) for details. |
| Upstream merge | Merged with the upstream community driver version `42.2.8`. See the community [JDBC documentation](https://jdbc.postgresql.org/documentation/head/index.html) for details. |
| Enhancement | EDB JDBC Connector now supports EDB Postgres Advanced Server 12. |
| Enhancement | EDB JDBC Connector is now supported on the Windows Server 2019 platform. |

Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: "Release Notes"
title: "Release notes"
---

The EDB JDBC connector documentation describes the latest version of EDB JDBC connector.

These release notes describe what is new in each release. When a minor or patch release introduces new functionality, indicators in the content identify which version introduced the new feature.
These release notes describe what's new in each release. When a minor or patch release introduces new functionality, indicators in the content identify the version that introduced the new feature.

| Version | Release Date |
| ---------------------------------------- | ------------ |
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "Requirements Overview"
title: "Requirements overview"

legacyRedirectsGenerated:
# This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
Expand All @@ -22,6 +22,6 @@ This table lists the latest JDBC Connector versions and their supported correspo
| [42.2.9.1](01_jdbc_rel_notes/12_jdbc_42.2.9.1_rel_notes.mdx) | N | N | Y | Y | Y |
| [42.2.8.1](01_jdbc_rel_notes/12_jdbc_42.2.8.1_rel_notes.mdx) | N | N | Y | Y | Y |

## Supported JDK Distribution
## Supported JDK distribution

Java Virtual Machine (JVM): Java SE 8 or higher (LTS version), including Oracle JDK, OpenJDK, and IBM SDK (Java) distributions.
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "Advanced Server JDBC Connector Overview"
title: "EDB Postgres Advanced Server JDBC Connector overview"

legacyRedirectsGenerated:
# This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
Expand All @@ -11,72 +11,68 @@ legacyRedirectsGenerated:

<div id="advanced_server_jdbc_connector_overview" class="registered_link"></div>

Sun Microsystems created a standardized interface for connecting Java applications to databases known as Java Database Connectivity (JDBC). The EDB JDBC Connector connects a Java application to a Postgres database.
Sun Microsystems created a standardized interface for connecting Java applications to databases, known as Java Database Connectivity (JDBC). The EDB JDBC Connector connects a Java application to a Postgres database.

<div id="jdbc_driver_types" class="registered_link"></div>

## JDBC Driver Types
## JDBC driver types

There are currently four different types of JDBC drivers, each with their own specific implementation, use and limitations. The EDB JDBC Connector is a Type 4 driver.
There are currently four types of JDBC drivers, each with its own implementation, use, and limitations. The EDB JDBC Connector is a Type 4 driver.

Type 1 Driver
Type 1 driver

- This driver type is the JDBC-ODBC bridge.
- It is limited to running locally.
- It's limited to running locally.
- Must have ODBC installed on computer.
- Must have ODBC driver for specific database installed on computer.
- Generally can’t run inside an applet because of Native Method calls.

Type 2 Driver
Type 2 driver

- This is the native database library driver.
- Uses Native Database library on computer to access database.
- Generally can’t run inside an applet because of Native Method calls.
- Must have database library installed on client.

Type 3 Driver
Type 3 driver

- 100% Java Driver, no native methods.
- Does not require pre-installation on client.
- Doesn't require preinstallation on client.
- Can be downloaded and configured on-the-fly just like any Java class file.
- Uses a proprietary protocol for talking with a middleware server.
- Middleware server converts from proprietary calls to DBMS specific calls
- Middleware server converts from proprietary calls to DBMS specific calls.

Type 4 Driver
Type 4 driver

- 100% Java Driver, no native methods.
- Does not require pre-installation on client.
- 100% Java driver, no native methods.
- Doesn't require preinstallation on client.
- Can be downloaded and configured on-the-fly just like any Java class file.
- Unlike Type III driver, talks directly with the DBMS server.
- Unlike Type 3 driver, talks directly with the DBMS server.
- Converts JDBC calls directly to database specific calls.

## The JDBC Interface
## The JDBC interface

The following figure shows the core API interfaces in the JDBC specification and how they relate to each other. These interfaces are implemented in the `java.sql` package.

![JDBC Class Relationships](images/jdbc_class_relationships.png)

JDBC Class Relationships

## JDBC Classes and Interfaces
## JDBC classes and interfaces

The core API is composed of classes and interfaces; these classes and interfaces work together as shown below:
The core API is composed of classes and interfaces. These classes and interfaces work together as shown in the figure:

![Core Classes and Interfaces](images/core_classes_and_interfaces.png)

Core Classes and Interfaces

## The JDBC DriverManager

The figure below depicts the role of the `DriverManager` class in a typical JDBC application. The `DriverManager` acts as the bridge between a Java application and the backend database and determines which JDBC driver to use for the target database.
This figure depicts the role of the `DriverManager` class in a typical JDBC application. The `DriverManager` acts as the bridge between a Java application and the backend database and determines the JDBC driver to use for the target database.

![DriverManager/Drivers](images/drivermanager_drivers.png)

DriverManager/Drivers

## Advanced Server JDBC Connector Compatibility
## EDB Postgres Advanced Server JDBC Connector compatibility

This is the current version of the driver. Unless you have unusual requirements (running old applications or JVMs), this is the driver you should be using. This driver supports PostgreSQL 9.6 or higher versions and requires Java 8 or higher versions. It contains support for SSL and the javax.sql package.
This is the current version of the driver. Unless you have unusual requirements (running old applications or JVMs), this is the driver to use. This driver supports PostgreSQL 9.6 or higher versions and requires Java 8 or higher versions. It contains support for SSL and the `javax.sql` package.

!!! Note

Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "Installing the Connector with an RPM Package"
title: "Installing the Connector with an RPM package"

legacyRedirectsGenerated:
# This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
Expand Down Expand Up @@ -47,7 +47,7 @@ After receiving your repository credentials you can:
2. Modify the file, providing your user name and password.
3. Install `edb-jdbc`.

**Creating a Repository Configuration File**
**Creating a repository configuration file**

To create the repository configuration file, assume superuser privileges, and invoke the following command:

Expand Down Expand Up @@ -112,7 +112,7 @@ After receiving your repository credentials you can:
2. Modify the file, providing your user name and password.
3. Install `edb-jdbc`.

**Creating a Repository Configuration File**
**Creating a repository configuration file**

To create the repository configuration file, assume superuser privileges, and invoke the following command:

Expand Down Expand Up @@ -173,7 +173,7 @@ After receiving your repository credentials you can:
2. Modify the file, providing your user name and password.
3. Install `edb-jdbc`.

**Creating a Repository Configuration File**
**Creating a repository configuration file**

To create the repository configuration file, assume superuser privileges, and invoke the following command:

Expand Down Expand Up @@ -237,7 +237,7 @@ After receiving your repository credentials you can:
2. Modify the file, providing your user name and password.
3. Install `edb-jdbc`.

**Creating a Repository Configuration File**
**Creating a repository configuration file**

To create the repository configuration file, assume superuser privileges, and invoke the following command:

Expand Down Expand Up @@ -288,7 +288,7 @@ To log in as a superuser:
sudo su -
```

#### Setting up the Repository
#### Setting up the repository

1. To register with EDB to receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request).

Expand Down Expand Up @@ -328,14 +328,14 @@ sudo su -
dnf -qy module disable postgresql
```

#### Installing the Package
#### Installing the package

```shell
dnf -y install edb-jdbc
```


## Updating an RPM Installation
## Updating an RPM installation

If you have an existing JDBC Connector RPM installation, you can use yum or dnf to upgrade your repository configuration file and update to a more recent product version. To update the `edb.repo` file, assume superuser privileges and enter:

Expand Down
Loading

0 comments on commit c0f08e4

Please sign in to comment.