github.com/ranjib/nomad@v0.1.1-0.20160225204057-97751b02f70b/website/source/docs/upgrade/index.html.md (about)

     1  ---
     2  layout: "docs"
     3  page_title: "Upgrade Nomad"
     4  sidebar_current: "docs-upgrade-upgrading"
     5  description: |-
     6    Learn how to upgrade Nomad.
     7  ---
     8  
     9  # Upgrading Nomad
    10  
    11  Both Nomad Clients and Servers are meant to be long-running processes that
    12  maintain communication with each other. Nomad Servers maintain quorum with other
    13  Servers and Clients are in constant communication with Servers. As such, care
    14  should be taken to properly upgrade Nomad to ensure minimal service disruption.
    15  
    16  This page documents how to upgrade Nomad when a new version is released.
    17  
    18  ## Standard Upgrades
    19  
    20  For upgrades we strive to ensure backwards compatibility. For most upgrades, the
    21  process is simple. Assuming the current version of Nomad is A, and version B is
    22  released.
    23  
    24  1. On each server, install version B of Nomad.
    25  
    26  2. Shut down version A, restart with version B on one server at a time.
    27  
    28      3. You can run `nomad server-members` to ensure that all servers are
    29         clustered and running the version B.
    30  
    31  4. Once all the servers are upgraded, begin a rollout of clients following
    32     the same process.
    33  
    34     5. Done! You are now running the latest Nomad version. You can verify all
    35        Clients joined by running `nomad node-status` and checking all the clients
    36        are in a `ready` state.