You are viewing a plain text version of this content. The canonical link for it is here.
Posted to server-dev@james.apache.org by bt...@apache.org on 2020/01/13 09:55:49 UTC

[james-project] 03/10: JAMES-2921 HybridBlobStore upgrade instructions

This is an automated email from the ASF dual-hosted git repository.

btellier pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git

commit bf918b61e58dccec0a6aebd0e30eb6fb7fd8b10b
Author: Benoit Tellier <bt...@linagora.com>
AuthorDate: Mon Jan 6 10:56:11 2020 +0700

    JAMES-2921 HybridBlobStore upgrade instructions
    
    Users of the Union blobStore needs to be using the Hybrid blobStore
---
 .../destination/conf/blob.properties               |  4 ++--
 .../destination/conf/blob.properties               |  4 ++--
 upgrade-instructions.md                            | 22 +++++++++++++++++++++-
 3 files changed, 25 insertions(+), 5 deletions(-)

diff --git a/dockerfiles/run/guice/cassandra-rabbitmq-ldap/destination/conf/blob.properties b/dockerfiles/run/guice/cassandra-rabbitmq-ldap/destination/conf/blob.properties
index b7085a1..f00fb5d 100644
--- a/dockerfiles/run/guice/cassandra-rabbitmq-ldap/destination/conf/blob.properties
+++ b/dockerfiles/run/guice/cassandra-rabbitmq-ldap/destination/conf/blob.properties
@@ -2,8 +2,8 @@
 # Read https://james.apache.org/server/config-blobstore.html for further details
 
 # Choose your BlobStore implementation
-# Mandatory, allowed values are: cassandra, objectstorage, union
-# union is using both objectstorage as the current BlobStore & cassandra as the legacy BlobStore
+# Mandatory, allowed values are: cassandra, objectstorage, hybrid
+# hybrid is using both objectstorage for unfrequently read or big blobs & cassandra for small, often read blobs
 implementation=objectstorage
 
 # ============================================== ObjectStorage ============================================
diff --git a/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/blob.properties b/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/blob.properties
index b7085a1..f00fb5d 100644
--- a/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/blob.properties
+++ b/dockerfiles/run/guice/cassandra-rabbitmq/destination/conf/blob.properties
@@ -2,8 +2,8 @@
 # Read https://james.apache.org/server/config-blobstore.html for further details
 
 # Choose your BlobStore implementation
-# Mandatory, allowed values are: cassandra, objectstorage, union
-# union is using both objectstorage as the current BlobStore & cassandra as the legacy BlobStore
+# Mandatory, allowed values are: cassandra, objectstorage, hybrid
+# hybrid is using both objectstorage for unfrequently read or big blobs & cassandra for small, often read blobs
 implementation=objectstorage
 
 # ============================================== ObjectStorage ============================================
diff --git a/upgrade-instructions.md b/upgrade-instructions.md
index f647ae3..dd9c470 100644
--- a/upgrade-instructions.md
+++ b/upgrade-instructions.md
@@ -24,7 +24,27 @@ Change list:
  - [JAMES-2703 Post 3.4.0 release removals](#james-2703-post-340-release-removals)
  - [Health checks routes return code changes](#health-checks-routes-return-code-changes)
  - [User mailboxes reIndexing endpoint change](#user-mailboxes-reindexing-endpoint-change)
- 
+ - [Hybrid blobStore replaces Union blobStore](#hybrid-blobstore-replaces-union-blobstore)
+
+### Hybrid blobStore replaces Union blobStore
+
+Date 6/01/2020
+
+SHA-1 XXX
+
+Concerned products: Guice distributed James server
+
+Union blobStore, allowing to store older blobs within Cassandra while storing new blobs into object storage, had been removed.
+
+Hybrid blobStore had been replacing it, allowing to store blobs either in a low cost blobStore or in a high performance blobStore, allowing thus some performance 
+improvement for small, often read blobs while big or unfrequently read blobs keeps being stored cheaply.
+
+Users relying on the Union blobStore will need to adopt Hybrid blobStore. Please adjust "blob.properties" accordingly:
+
+```
+implementation=hybrid
+```
+
 ### User mailboxes reIndexing endpoint change
  
 Date 16/12/2019


---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org