v5.1.1
Dataverse 5.1.1
This minor release adds important scaling improvements for installations running on AWS S3. It is recommended that 5.1.1 be used in production instead of 5.1.
Release Highlights
Connection Pool Size Configuration Option, Connection Optimizations
Dataverse 5.1 improved the efficiency of making S3 connections through use of an http connection pool. This release adds optimizations around closing streams and channels that may hold S3 http connections open and exhaust the connection pool. In parallel, this release increases the default pool size from 50 to 256 and adds the ability to increase the size of the connection pool, so a larger pool can be configured if needed.
Major Use Cases
Newly-supported use cases in this release include:
- Administrators of installations using S3 will be able to define the connection pool size, allowing better resource scaling for larger installations (Issue #7309, PR #7313)
Notes for Dataverse Installation Administrators
5.1.1 vs. 5.1 for Production Use
As mentioned above, we encourage 5.1.1 instead of 5.1 for production use.
New JVM Option for Connection Pool Size
Larger installations may want to increase the number of open S3 connections allowed (default is 256). For example, to set the value to 4096:
./asadmin create-jvm-options "-Ddataverse.files.<id>.connection-pool-size=4096"
(where <id>
is the identifier of your S3 file store (likely "s3"
). The JVM Options section of the Configuration Guide has more information.
Complete List of Changes
For the complete list of code changes in this release, see the 5.1.1 Milestone in Github.
For help with upgrading, installing, or general questions please post to the Dataverse Google Group or email [email protected].
Installation
If this is a new installation, please see our Installation Guide
Upgrade Instructions
-
These instructions assume that you've already successfully upgraded to Dataverse 5.1 following the instructions in the Dataverse 5.1 Release Notes.
-
Undeploy the previous version.
<payara install path>/bin/asadmin list-applications
<payara install path>/bin/asadmin undeploy dataverse<-version>
- Stop payara and remove the generated directory, start.
service payara stop
- remove the generated directory:
rm -rf <payara install path>/glassfish/domains/domain1/generated
service payara start
-
Deploy this version.
<payara install path>/bin/asadmin deploy dataverse-5.1.1.war
-
Restart payara