You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@james.apache.org by GitBox <gi...@apache.org> on 2021/05/10 04:12:53 UTC

[GitHub] [james-project] Arsnael commented on a change in pull request #417: JAMES-3578 Drop Cassandra schema support prior version 8

Arsnael commented on a change in pull request #417:
URL: https://github.com/apache/james-project/pull/417#discussion_r629035446



##########
File path: docs/modules/servers/pages/distributed/operate/index.adoc
##########
@@ -24,4 +24,38 @@ distributed James operators.
 
 We also included a guide for xref:distributed/operate/migrating.adoc[migrating existing data] into the distributed server.
 
-Read more about xref:distributed/operate/cassandra-migration.adoc[Cassandra data migration].
\ No newline at end of file
+Read more about xref:distributed/operate/cassandra-migration.adoc[Cassandra data migration].
+
+== Upgrading
+
+This section sum up and links upgrade instructions for people willing to upgrade their Distributed server to newer versions.

Review comment:
       ```suggestion
   This section sums up and links upgrade instructions for people willing to upgrade their Distributed server to newer versions.
   ```

##########
File path: docs/modules/servers/pages/distributed/operate/cassandra-migration.adoc
##########
@@ -17,13 +17,8 @@ Note that currently the progress can be tracked by logs.
 
 Here are the implemented migrations:
 
-* *From V5 to V6* : Goal is to no longer rely on an UDT partition key for mailboxPath tables. Entries will be migrated
-to mailboxPathV2 table relying on a composite primary key.
-* *From V6 to V7* : Goal is to populate mapping_sources projection table. This table allows finding the source of a given redirection, which is
-handy for things like mail aliases (I want to list aliases rewritting things to bob). Without this projection table being available,
-(ie we rely on schema version 6 or less) such information is obtained through a full table scan, unoptimized. From schema version 7,
-the optimized projection can safely be used.
-* *From V7 to V8* : Add UID_VALIDITY to mailboxPath table in order not to mandate mailbox table reads.

Review comment:
       Hmmm did we ever test versioning in our antora doc yet? That could be a good candidate to start :)

##########
File path: docs/modules/servers/pages/distributed/operate/index.adoc
##########
@@ -24,4 +24,38 @@ distributed James operators.
 
 We also included a guide for xref:distributed/operate/migrating.adoc[migrating existing data] into the distributed server.
 
-Read more about xref:distributed/operate/cassandra-migration.adoc[Cassandra data migration].
\ No newline at end of file
+Read more about xref:distributed/operate/cassandra-migration.adoc[Cassandra data migration].
+
+== Upgrading
+
+This section sum up and links upgrade instructions for people willing to upgrade their Distributed server to newer versions.
+
+.dnsservice.xml content

Review comment:
       That's your table description? dnsservice.xml? 

##########
File path: upgrade-instructions.md
##########
@@ -14,6 +14,23 @@ Note: this section is in progress. It will be updated during all the development
 
 Changes to apply between 3.5.x and 3.6.x will be reported here.
 
+Change list:
+
+ - [Drop Cassandra schema version prior version 8](#drop-cassandra-schema-version-prior-version-8)
+
+### Drop Cassandra schema version prior version 8
+
+Date 05/05/2021
+
+JIRA: https://issues.apache.org/jira/browse/JAMES-3578
+
+Concerned products: Distributed James, Cassandra-guice James server
+
+In an effort to simplify the code base, we dropped support for Cassandra schema version prior version 8.
+
+Installation running older schema version than version 5 needs to rely on releases 3.6.x to upgrade to schema version 8,
+before upgrading to an eventual newer version.

Review comment:
       ah actually you mention it here :) But I guess we need to mention it in the Antora doc too, probably safer... 




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



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