http://git-wip-us.apache.org/repos/asf/james-site/blob/0e4c47ea/content/server/manage-cli.html ---------------------------------------------------------------------- diff --git a/content/server/manage-cli.html b/content/server/manage-cli.html index f072f27..19c14fc 100644 --- a/content/server/manage-cli.html +++ b/content/server/manage-cli.html @@ -18,7 +18,7 @@ under the License. --> - + @@ -36,7 +36,7 @@ - + @@ -76,7 +76,7 @@
- Last Published: 2017-06-15 + Last Published: 2017-08-09
Home | @@ -107,7 +107,7 @@ -
  • +
  • Server
  • +
    +

    Cassandra Schema upgrades

    +

    Cassandra upgrades implies the creation of a new table. Thus restarting James is needed, as new tables are created on restart.

    +

    Once done, we ship code that tries to read from new tables, and if not possible backs up to old tables. You can thus safely run without running additional migrations.

    +

    On the fly migration can be enabled. However, one might want to force the migration in a controlled fashion, and update automatically current schema version used (assess in the database old versions is no more used, as the corresponding tables are empty). Note that this process is safe: we ensure the service is not running concurrently on this James instance, that it does not bump version upon partial failures, that race condition in version upgrades will be idempotent, etc…

    +

    These schema updates can be triggered by webadmin using the Cassandra backend.

    +

    Note that currently the progress can be tracked by logs.

    +
    +

    Retrieving current Cassandra schema version

    + +
    +
    curl -XGET http://ip:port/cassandra/version
    +
    +

    Will return:

    + +
    +
    2
    +
    +

    Where the number corresponds to the current schema version of the database you are using.

    +

    Response codes:

    + +
    +
    +

    Retrieving latest available Cassandra schema version

    + +
    +
    curl -XGET http://ip:port/cassandra/version
    +
    +

    Will return:

    + +
    +
    3
    +
    +

    Where the number corresponds to the latest available schema version of the database you are using. This means you can be migrating to this schema version.

    +

    Response codes:

    + +
    +
    +

    Upgrading to a specific version

    + +
    +
    curl -XPOST http://ip:port/cassandra/version/upgrade -d '3'
    +
    +

    Will run the migrations you need to reach schema version 3.

    +

    Response codes:

    + + +

    Note that several calls to this endpoint will be run in a sequential pattern.

    +

    If the server restarts during the migration, the migration is silently aborted.

    +
    +

    Upgrading to the latest version

    + +
    +
    curl -XPOST http://ip:port/cassandra/version/upgrade/latest
    +
    +

    Will run the migrations you need to reach the latest schema version.

    +

    Response codes:

    + + +

    Note that several calls to this endpoint will be run in a sequential pattern.

    +

    If the server restarts during the migration, the migration is silently aborted.

    http://git-wip-us.apache.org/repos/asf/james-site/blob/0e4c47ea/content/server/manage.html ---------------------------------------------------------------------- diff --git a/content/server/manage.html b/content/server/manage.html index c9508e1..1281ea6 100644 --- a/content/server/manage.html +++ b/content/server/manage.html @@ -18,7 +18,7 @@ under the License. --> - + @@ -37,7 +37,7 @@ - + @@ -77,7 +77,7 @@
    - Last Published: 2017-06-15 + Last Published: 2017-08-09
    Home | @@ -108,7 +108,7 @@ -
  • +
  • Server
    • @@ -117,7 +117,7 @@
    • Objectives
    • -
    • +
    • User Manual
      • 2. Packaging
      • -
      • +
      • - +
      • http://git-wip-us.apache.org/repos/asf/james-site/blob/0e4c47ea/content/server/metrics.html ---------------------------------------------------------------------- diff --git a/content/server/metrics.html b/content/server/metrics.html index b8a560e..ee9d4be 100644 --- a/content/server/metrics.html +++ b/content/server/metrics.html @@ -18,7 +18,7 @@ under the License. --> - + @@ -37,7 +37,7 @@ - + @@ -77,7 +77,7 @@
        - Last Published: 2017-06-15 + Last Published: 2017-08-09
        Home | @@ -108,7 +108,7 @@
      • -
      • +
      • Server
        • @@ -117,7 +117,7 @@
        • Objectives
        • -
        • +
        • User Manual
          • 2. Packaging
          • -
          • +
          • - +
          • http://git-wip-us.apache.org/repos/asf/james-site/blob/0e4c47ea/content/server/monitor-folders.html ---------------------------------------------------------------------- diff --git a/content/server/monitor-folders.html b/content/server/monitor-folders.html index 6544a23..36faaca 100644 --- a/content/server/monitor-folders.html +++ b/content/server/monitor-folders.html @@ -18,7 +18,7 @@ under the License. --> - + @@ -37,7 +37,7 @@ - + @@ -77,7 +77,7 @@
            - Last Published: 2017-06-15 + Last Published: 2017-08-09
            Home | @@ -108,7 +108,7 @@
          • -
          • +
          • Server
            • @@ -117,7 +117,7 @@
            • Objectives
            • -
            • +
            • User Manual
              • 2. Packaging
              • -
              • +
              • - + -
              • +
              • Server
                • @@ -117,7 +117,7 @@
                • Objectives
                • -
                • +
                • User Manual
                  • 2. Packaging
                  • -
                  • +
                  • - + -
                  • +
                  • Server
                    • @@ -117,7 +117,7 @@
                    • Objectives
                    • -
                    • +
                    • User Manual
                      • 2. Packaging
                      • -
                      • +
                      • - + -
                      • +
                      • Server