ExternalVendorCode/corda
1
0
Fork 0
mirror of https://github.com/corda/corda.git synced 2025-03-14 08:16:32 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

ENT-2191 - Add version compatibility and platform support matrices (#1195)

Browse Source 
* ENT-2191 - Add version compatibility and platform support matrices

* ENT-2191 - Add note re compatibility commitments
This commit is contained in:
Tommy Lillehagen 2018-07-05 11:22:14 +01:00 committed by GitHub
parent 9b3044186d
commit 9fa9521ae8
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
6 changed files with 126 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
docs/source/_static/css/custom.css
View File

@ -210,3 +210,7 @@ a:visited {
border-radius: 4px;
border-color: #263673;
}
.grey {
color: #808080;
}

2
docs/source/hot-cold-deployment.rst
View File

@ -1,7 +1,7 @@
.. highlight:: kotlin
.. raw:: html
Hot-cold deployment
Hot-Cold Deployment
===================
Overview

4
docs/source/index.rst
View File

@ -28,6 +28,9 @@ application development please continue to refer to `the main project documentat
:caption: Corda Enterprise
:maxdepth: 1
release-notes.rst
version-compatibility.rst
platform-support-matrix.rst
hot-cold-deployment
database-management
corda-firewall
@ -65,7 +68,6 @@ application development please continue to refer to `the main project documentat
:caption: Other documentation
deterministic-modules.rst
release-notes.rst
changelog.rst
.. only:: htmlmode

57
docs/source/platform-support-matrix.rst Normal file
View File

@ -0,0 +1,57 @@
Platform Support Matrix
=======================
Our supported Operating System platforms are a subset of those supported by Java `8u172 <http://www.oracle.com/technetwork/java/javase/certconfig-2095354.html>`_. Production use of Corda Enterprise 3.0 is only supported on Linux OS, see details below.
Operating systems supported in production
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+-------------------------------+------------------+-----------+
| Platform | CPU Architecture | Versions |
+===============================+==================+===========+
| Red Hat Enterprise Linux | x86-64 | 7.x, |
| | | 6.x |
+-------------------------------+------------------+-----------+
| Suse Linux Enterprise Server | x86-64 | 12.x, |
| | | 11.x |
+-------------------------------+------------------+-----------+
| Ubuntu Linux | x86-64 | 16.10, |
| | | 16.04 |
+-------------------------------+------------------+-----------+
| Oracle Linux | x86-64 | 7.x, |
| | | 6.x |
+-------------------------------+------------------+-----------+
Operating systems supported in development
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+-------------------------------+------------------+-----------+
| Platform | CPU Architecture | Versions |
+===============================+==================+===========+
| Microsoft Windows | x86-64 | 10, |
| | | 8.x |
+-------------------------------+------------------+-----------+
| Microsoft Windows Server | x86-64 | 2016, |
| | | 2012 R2, |
| | | 2012 |
+-------------------------------+------------------+-----------+
| Apple macOS | x86-64 | 10.9 and |
| | | above |
+-------------------------------+------------------+-----------+
Databases
~~~~~~~~~
+-------------------------------+------------------+------------------+--------------------+
| Vendor | CPU Architecture | Versions | JDBC Driver |
+===============================+==================+==================+====================+
| Microsoft | x86-64 | Azure SQL, | Microsoft JDBC |
| | | SQL Server 2017 | Driver 6.2 |
+-------------------------------+------------------+------------------+--------------------+
| Oracle | x86-64 | 11gR2 | Oracle JDBC 6 |
+-------------------------------+------------------+------------------+--------------------+
| Oracle | x86-64 | 12cR2 | Oracle JDBC 8 |
+-------------------------------+------------------+------------------+--------------------+
| PostgreSQL | x86-64 | 9.6 | PostgreSQL JDBC |
| | | | Driver 42.1.4 |
+-------------------------------+------------------+------------------+--------------------+

2
docs/source/release-notes.rst
View File

@ -1,4 +1,4 @@
Release notes
Release Notes
=============
|release|

60
docs/source/version-compatibility.rst Normal file
View File

@ -0,0 +1,60 @@
Corda and Corda Enterprise Compatibility
========================================
Corda Enterprise 3.0 provides a baseline for wire stability and compatibility with future versions of Corda Enterprise, and open-source releases of Corda starting from version 3.0.
Future versions of Corda Enterprise will be backward compatible with Corda Enterprise 3.0:
* Corda Enterprise 3.0 nodes can be upgraded to future version of Corda Enterprise. The upgrade will preserve transaction, configuration and other data.
* Corda Enterprise 3.0 nodes will be able to transact with nodes running future versions of Corda Enterprise, providing the CorDapp is compatible with and between platform versions.
* Future versions of Corda Enterprise will be able to run CorDapps developed for, and packaged on Corda Enterprise 3.0.
Corda Enterprise 3.0 can be used in mixed-version/mixed-distribution networks seamlessly transacting with nodes running Corda 3.x and future versions.
* Corda Enterprise 3.0 nodes can transact with nodes running Corda 3.0 and future versions, providing the CorDapp is compatible with and between platform versions and distributions.
* CorDapps originally written for Corda 3.x are API compatible with Corda Enterprise 3.0 and future versions, developers can switch their IDE to Corda Enterprise 3.0 without any code changes in their CorDapp.
* Corda Enterprise 3.0 nodes can run, without recompilation, CorDapps developed on and packaged for Corda 3.x.
.. note:: These compatibility commitments are subject to the standard Corda Enterprise software support policy.
.. role:: grey
+------------------------------------------------+-------------+---------------+---------------+------------------+-----------------+-----------------+---------------------+
| Compatibility with Corda Enterprise 3.0 | :grey:`DP3` | :grey:`DP2` | :grey:`DP1` | Corda 3.x | :grey:`Corda 2` | :grey:`Corda 1` | :grey:`Corda pre 1` |
+================================================+=============+===============+===============+==================+=================+=================+=====================+
| **API compatibility**, i.e. CorDapps developed | :grey:`Yes` | :grey:`Yes` | :grey:`Yes` | Yes | :grey:`Yes` | :grey:`Yes` | :grey:`No` |
| for this Corda version can be compiled and run | | | | | | | |
| on Corda Enterprise 3.0 nodes | | | | | | | |
+------------------------------------------------+-------------+---------------+---------------+------------------+-----------------+-----------------+---------------------+
| **Binary compatibility**, i.e. CorDapps | :grey:`Yes` | :grey:`Yes` | :grey:`Yes` | Yes | :grey:`Yes` | :grey:`Yes` | :grey:`No` |
| compiled on this Corda version can be run on | | | | | | | |
| Corda Enterprise 3.0 nodes | | | | | | | |
+------------------------------------------------+-------------+---------------+---------------+------------------+-----------------+-----------------+---------------------+
| **Network compatibility**, i.e., nodes running | :grey:`No*` | :grey:`Yes` | :grey:`Yes` | Yes | :grey:`No` | :grey:`No` | :grey:`No` |
| this Corda version can transact with Corda | | | | | | | |
| Enterprise 3.0 nodes | | | | | | | |
+------------------------------------------------+-------------+---------------+---------------+------------------+-----------------+-----------------+---------------------+
| **RPC compatibility**, i.e, a client | :grey:`Yes` | :grey:`Yes` | :grey:`Yes` | No | :grey:`No` | :grey:`No` | :grey:`No` |
| application developed for this Corda version | | | | | | | |
| can interact via RPC with a CorDapp running on | | | | | | | |
| the Corda Enterprise 3.0 node | | | | | | | |
+------------------------------------------------+-------------+---------------+---------------+------------------+-----------------+-----------------+---------------------+
| Samples and community apps from | :grey:`Yes` | :grey:`Yes` | :grey:`Yes` | Yes | :grey:`Yes` | :grey:`Yes` | :grey:`No` |
| https://www.corda.net/samples/ for this Corda | | | | | | | |
| version can be compiled and run on Corda | | | | | | | |
| Enterprise 3.0 nodes | | | | | | | |
+------------------------------------------------+-------------+---------------+---------------+------------------+-----------------+-----------------+---------------------+
| Bootstrapper tool from this Corda version can | :grey:`No*` | :grey:`Yes` | :grey:`Yes` | No | :grey:`No` | :grey:`No` | :grey:`No` |
| be used to build Corda Enterprise 3.0 test | | | | | | | |
| networks | | | | | | | |
+------------------------------------------------+-------------+---------------+---------------+------------------+-----------------+-----------------+---------------------+
.. note:: Greyed out releases are out of support.
Cells denoted with asterisk (*) refer to development-mode only. The incompatibility is caused by a change to the truststore for development-mode certificates between
Developer Preview 3 (DP3) and Corda Enterprise 3.0. In other words, DP3 is network compatible with Corda Enterprise 3.0 provided that development-mode is disabled.