github.com/kaituanwang/hyperledger@v2.0.1+incompatible/docs/source/upgrade.rst (about)

     1  Upgrading to the latest release
     2  ===============================
     3  
     4  If you’re familiar with previous releases of Hyperledger Fabric, you’re aware
     5  that upgrading the nodes and channels to the latest version of Fabric is, at a
     6  high level, a four step process.
     7  
     8  1. Backup the ledger and MSPs.
     9  2. Upgrade the orderer binaries in a rolling fashion to the latest Fabric version.
    10  3. Upgrade the peer binaries in a rolling fashion to the latest Fabric version.
    11  4. Update the orderer system channel and any application channels to the latest
    12     capability levels, where available. Note that some releases will have
    13     capabilities in all groups while other releases may have few or even no new
    14     capabilities at all.
    15  
    16  For more information about capabilities, check out :doc:`capabilities_concept`.
    17  
    18  For a look at how these upgrade processes are accomplished, please consult these
    19  tutorials:
    20  
    21  1. :doc:`upgrading_your_components`. Components should be upgraded to the latest
    22     version before updating any capabilities.
    23  2. :doc:`updating_capabilities`. Completed after updating the versions of all nodes.
    24  3. :doc:`enable_cc_lifecycle`. Necessary to add organization specific endorsement
    25     policies central to the new chaincode lifecycle for Fabric v2.0.
    26  
    27  As the upgrading of nodes and increasing the capability levels of channels is by
    28  now considered a standard Fabric process, we will not show the specific commands
    29  for upgrading to the newest release. Similarly, there is no script in the ``fabric-samples``
    30  repo that will upgrade a sample network from the previous release to this one,
    31  as there has been for previous releases.
    32  
    33  .. note:: It is a best practice to upgrade your SDK to the latest version as a
    34            part of a general upgrade of your network. While the SDK will always
    35            be compatible with equivalent releases of Fabric and lower, it might
    36            be necessary to upgrade to the latest SDK to leverage the latest Fabric
    37            features. Consult the documentation of the Fabric SDK you are using
    38            for information about how to upgrade.
    39  
    40  .. toctree::
    41     :maxdepth: 1
    42     :caption: Upgrading to the latest release
    43  
    44     upgrade_to_newest_version
    45     upgrading_your_components
    46     updating_capabilities
    47     enable_cc_lifecycle