Project

General

Profile

Edit History

Wiki » Hacking »

Upgrading to main » History » Version 4

Tom Clegg, 01/07/2016 02:42 PM

1 1 Tom Clegg 
h1. Upgrading to master
2 





    3
    
    
    
What you need to know and do in order to upgrade your Arvados site to the latest master.





    4
    
    
    





    5
    
    
    
h2. Basics





    6
    
    
    





    7
    
    
    
    apt-get dist-upgrade





    8
    
    
    





    9
    
    
    
(TODO: best order to upgrade? other best practices?)





    10
    
    
    





    11
    
    
    
h2. Notable changes





    12
    
    
    





    13
    
    
    
Some versions introduce changes that require special attention when upgrading: e.g., there is a new service to install, or there is a change to the default configuration that you might need to override in order to preserve the old behavior.





    14
    
    
    





    15
    
    
    
(Note to developers: Add new items at the top. Include a relevant commit hash (probably a merge), date, issue number/link, and considerations/instructions for those about to upgrade.)





    16
    
    
    





    17
    4
    Tom Clegg
    
2015-12-03: commit:5590c9ac makes a Keep-backed writable scratch directory available in crunch jobs (see #7751)





    18
    3
    Tom Clegg
    
* All compute nodes must be upgraded to arvados-fuse >= 0.1.2015112518060 because crunch-job uses some new arv-mount flags (--mount-tmp, --mount-by-pdh) introduced in merge commit:346a558





    19
    
    
    
* Jobs will fail if the API server (in particular crunch-job from the arvados-cli gem) is upgraded without upgrading arvados-fuse on compute nodes.





    20
    
    
    





    21
    2
    Tom Clegg
    
2015-11-11: commit:1e2ace5 changes recommended config for keep-web (see #5824)





    22
    
    
    
* proxy/dns/ssl config should be updated to route "https://download.uuid_prefix.arvadosapi.com/" requests to keep-web (alongside the existing "collections" routing)





    23
    
    
    
* keep-web command line adds @-attachment-only-host download.uuid_prefix.arvadosapi.com@





    24
    
    
    
* Workbench config adds @keep_web_download_url@





    25
    
    
    
* More info on the (still beta/non-TOC-linked) "keep-web doc page":http://doc.arvados.org/install/install-keep-web.html





    26
    
    
    





    27
    1
    Tom Clegg
    
2015-11-04: commit:1d1c6de removes stopped containers (see #7444)





    28
    
    
    
* arvados-docker-cleaner removes _all_ docker containers as soon as they exit, effectively making @docker run@ default to @--rm@. If you run arvados-docker-cleaner on a host that does anything other than run crunch-jobs, and you still want to be able to use @docker start@, read the "new doc page":http://doc.arvados.org/install/install-compute-node.html to learn how to turn this off before upgrading.





    29
    
    
    





    30
    
    
    
2015-11-04: commit:21006cf adds a keep-web service (see #5824)





    31
    
    
    
* Nothing relies on it yet, but early adopters can install it now by following http://doc.arvados.org/install/install-keep-web.html (it is not yet linked in the TOC).