Skip to content

Commit

Permalink
chore: update the driver version for 1.1.2 release (#316)
Browse files Browse the repository at this point in the history
  • Loading branch information
karenc-bq authored Nov 23, 2022
1 parent 5e0b1cf commit d85fd00
Show file tree
Hide file tree
Showing 3 changed files with 46 additions and 27 deletions.
19 changes: 19 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,23 @@ All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/#semantic-versioning-200).

## [1.1.2] - 2022-11-22

### Added
* Upstream changes from MySQL 8.0.31 community driver.
* A new `enableFailoverStrictReader` parameter so the driver only reconnects to reader nodes after a failover.

### Changed
* Upgraded dependency versions

### Fixed
* Update FailoverConnectionPlugin license.
* Fixed plugin factories package names in the README.
* Resolved an issue where the driver attempts to query for the topology during a prepared transaction.[Issue 292](https://github.com/awslabs/aws-mysql-jdbc/issues/292)
* Resolved an issue where distinct ClientPreparedStatement objects incorrectly have the same hashCode.[Issue 308](https://github.com/awslabs/aws-mysql-jdbc/issues/308)
* Fixed the writer failover process where the driver reconnects to a reader node due to outdated topology information.
* Fixed some incorrect log messages.
* Enhanced logging to avoid unnecessary String format calls.

## [1.1.1] - 2022-09-22

Expand Down Expand Up @@ -81,6 +98,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
### Added
* This driver is based on the MySQL 8.0.21 community driver. The driver is cluster aware for Amazon Aurora MySQL. It takes advantage of Amazon Aurora's fast failover capabilities, reducing failover times from minutes to seconds.

[1.1.2]: https://github.com/awslabs/aws-mysql-jdbc/compare/1.1.1...1.1.2
[1.1.1]: https://github.com/awslabs/aws-mysql-jdbc/compare/1.1.0...1.1.1
[1.1.0]: https://github.com/awslabs/aws-mysql-jdbc/compare/1.0.0...1.1.0
[1.0.0]: https://github.com/awslabs/aws-mysql-jdbc/compare/0.4.0...1.0.0
[0.4.0]: https://github.com/awslabs/aws-mysql-jdbc/compare/0.3.0...0.4.0
Expand Down
52 changes: 26 additions & 26 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,18 +29,18 @@ The AWS JDBC Driver for MySQL can be installed from pre-compiled packages that c

**Example - Direct download with wget**
```bash
wget https://github.com/awslabs/aws-mysql-jdbc/releases/download/1.1.1/aws-mysql-jdbc-1.1.1.jar
cp aws-mysql-jdbc-1.1.1.jar /home/userx/libs/
export CLASSPATH=$CLASSPATH:/home/userx/libs/aws-mysql-jdbc-1.1.1.jar
wget https://github.com/awslabs/aws-mysql-jdbc/releases/download/1.1.2/aws-mysql-jdbc-1.1.2.jar
cp aws-mysql-jdbc-1.1.2.jar /home/userx/libs/
export CLASSPATH=$CLASSPATH:/home/userx/libs/aws-mysql-jdbc-1.1.2.jar
```

**Upgrading to a newer version with wget**

To upgrade the driver, replace the .jar file of your earlier driver with the new `.jar` file. After replacing the `.jar` file, update the CLASSPATH to include the name of the new file. For example, to upgrade to version 1.1.1:
To upgrade the driver, replace the .jar file of your earlier driver with the new `.jar` file. After replacing the `.jar` file, update the CLASSPATH to include the name of the new file. For example, to upgrade to version 1.1.2:
```bash
wget https://github.com/awslabs/aws-mysql-jdbc/releases/download/1.1.1/aws-mysql-jdbc-1.1.1.jar
cp aws-mysql-jdbc-1.1.1.jar /home/userx/libs/
export CLASSPATH=$CLASSPATH:/home/userx/libs/aws-mysql-jdbc-1.1.1.jar
wget https://github.com/awslabs/aws-mysql-jdbc/releases/download/1.1.2/aws-mysql-jdbc-1.1.2.jar
cp aws-mysql-jdbc-1.1.2.jar /home/userx/libs/
export CLASSPATH=$CLASSPATH:/home/userx/libs/aws-mysql-jdbc-1.1.2.jar
```

#### As a Maven dependency
Expand All @@ -52,20 +52,20 @@ You can use [Maven's dependency management](https://search.maven.org/search?q=g:
<dependency>
<groupId>software.aws.rds</groupId>
<artifactId>aws-mysql-jdbc</artifactId>
<version>1.1.1</version>
<version>1.1.2</version>
</dependency>
</dependencies>
```

**Upgrading to a newer version with Maven**

To upgrade to a newer version of the driver, replace the version number identified in the `pom.xml` file with the newer driver version. For example, to upgrade to version 1.1.1, modify the file to include:
To upgrade to a newer version of the driver, replace the version number identified in the `pom.xml` file with the newer driver version. For example, to upgrade to version 1.1.2, modify the file to include:
```xml
<dependencies>
<dependency>
<groupId>software.aws.rds</groupId>
<artifactId>aws-mysql-jdbc</artifactId>
<version>1.1.1</version>
<version>1.1.2</version>
</dependency>
</dependencies>
```
Expand All @@ -76,16 +76,16 @@ You can use [Gradle's dependency management](https://search.maven.org/search?q=g
**Example - Gradle**
```gradle
dependencies {
implementation group: 'software.aws.rds', name: 'aws-mysql-jdbc', version: '1.1.1'
implementation group: 'software.aws.rds', name: 'aws-mysql-jdbc', version: '1.1.2'
}
```

**Upgrading to a newer version with Gradle**

To upgrade to a newer version of the driver, replace the version number identified in the application's ```build.gradle``` file with the newer driver version. For example, to upgrade to version 1.1.1:
To upgrade to a newer version of the driver, replace the version number identified in the application's ```build.gradle``` file with the newer driver version. For example, to upgrade to version 1.1.2:
```gradle
dependencies {
implementation group: 'software.aws.rds', name: 'aws-mysql-jdbc', version: '1.1.1'
implementation group: 'software.aws.rds', name: 'aws-mysql-jdbc', version: '1.1.2'
}
```

Expand All @@ -95,9 +95,9 @@ To use the driver with an IDE (for example, IntelliJ), download the `.jar` file
**Example - IntelliJ**

```bash
wget https://github.com/awslabs/aws-mysql-jdbc/releases/download/1.1.1/aws-mysql-jdbc-1.1.1.jar
cp aws-mysql-jdbc-1.1.1.jar /home/userx/libs/
export CLASSPATH=$CLASSPATH:/home/userx/libs/aws-mysql-jdbc-1.1.1.jar
wget https://github.com/awslabs/aws-mysql-jdbc/releases/download/1.1.2/aws-mysql-jdbc-1.1.2.jar
cp aws-mysql-jdbc-1.1.2.jar /home/userx/libs/
export CLASSPATH=$CLASSPATH:/home/userx/libs/aws-mysql-jdbc-1.1.2.jar
```

After downloading the `.jar` file and updating the CLASSPATH, add the driver information to your `Project`:
Expand All @@ -117,9 +117,9 @@ After downloading the `.jar` file and updating the CLASSPATH, add the driver inf
To upgrade to a newer version of the driver, download the updated driver, and add it to your CLASSPATH:

```bash
wget https://github.com/awslabs/aws-mysql-jdbc/releases/download/1.1.1/aws-mysql-jdbc-1.1.1.jar
cp aws-mysql-jdbc-1.1.1.jar /home/userx/libs/
export CLASSPATH=$CLASSPATH:/home/userx/libs/aws-mysql-jdbc-1.1.1.jar
wget https://github.com/awslabs/aws-mysql-jdbc/releases/download/1.1.2/aws-mysql-jdbc-1.1.2.jar
cp aws-mysql-jdbc-1.1.2.jar /home/userx/libs/
export CLASSPATH=$CLASSPATH:/home/userx/libs/aws-mysql-jdbc-1.1.2.jar
```

Then, follow the steps listed above to update your project to the latest version.
Expand All @@ -131,9 +131,9 @@ To use the driver with the DBeaver database client, download the `.jar` file, co
**Example - DBeaver**

```bash
wget https://github.com/awslabs/aws-mysql-jdbc/releases/download/1.1.1/aws-mysql-jdbc-1.1.1.jar
cp aws-mysql-jdbc-1.1.1.jar /home/userx/libs/
export CLASSPATH=$CLASSPATH:/home/userx/libs/aws-mysql-jdbc-1.1.1.jar
wget https://github.com/awslabs/aws-mysql-jdbc/releases/download/1.1.2/aws-mysql-jdbc-1.1.2.jar
cp aws-mysql-jdbc-1.1.2.jar /home/userx/libs/
export CLASSPATH=$CLASSPATH:/home/userx/libs/aws-mysql-jdbc-1.1.2.jar
```

After downloading the .jar file and adding it to your CLASSPATH, add the driver information to the DBeaver client:
Expand Down Expand Up @@ -169,9 +169,9 @@ After adding driver information, you can create new connections that use the AWS
To upgrade to a newer version of the driver, download the updated driver, and add it to your CLASSPATH:

```bash
wget https://github.com/awslabs/aws-mysql-jdbc/releases/download/1.1.1/aws-mysql-jdbc-1.1.1.jar
cp aws-mysql-jdbc-1.1.1.jar /home/userx/libs/
export CLASSPATH=$CLASSPATH:/home/userx/libs/aws-mysql-jdbc-1.1.1.jar
wget https://github.com/awslabs/aws-mysql-jdbc/releases/download/1.1.2/aws-mysql-jdbc-1.1.2.jar
cp aws-mysql-jdbc-1.1.2.jar /home/userx/libs/
export CLASSPATH=$CLASSPATH:/home/userx/libs/aws-mysql-jdbc-1.1.2.jar
```
Then, follow the steps listed above to update your DBeaver client settings.

Expand All @@ -184,7 +184,7 @@ If there is an unreleased feature you would like to try, it may be available in
<dependency>
<groupId>software.aws.rds</groupId>
<artifactId>aws-mysql-jdbc</artifactId>
<version>1.1.1</version>
<version>1.1.2</version>
<scope>system</scope>
<systemPath>path-to-snapshot-jar</systemPath>
</dependency>
Expand Down
2 changes: 1 addition & 1 deletion gradle.properties
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ spotbugs.version=4.0.0
# Build properties
com.mysql.cj.build.driver.version.major=1
com.mysql.cj.build.driver.version.minor=1
com.mysql.cj.build.driver.version.subminor=1
com.mysql.cj.build.driver.version.subminor=2
com.mysql.cj.build.driver.displayName=Amazon Web Services (AWS) JDBC Driver for MySQL
com.mysql.cj.build.driver.name=aws-mysql-connector-java
com.mysql.cj.build.licenseType=GPLv2
Expand Down

0 comments on commit d85fd00

Please sign in to comment.