Upgrading to main » History » Version 5
Brett Smith, 03/30/2016 12:57 PM
Add note about "Getting Started" default change.
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 | 5 | Brett Smith | 2015-01-05: commit:e1276d6e disables Workbench's "Getting Started" popup by default. |
18 | * If you want new users to continue seeing this popup, set @enable_getting_started_popup: true@ in Workbench's @application.yml@ configuration. |
||
19 | |||
20 | 4 | Tom Clegg | 2015-12-03: commit:5590c9ac makes a Keep-backed writable scratch directory available in crunch jobs (see #7751) |
21 | 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 |
22 | * 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. |
||
23 | |||
24 | 2 | Tom Clegg | 2015-11-11: commit:1e2ace5 changes recommended config for keep-web (see #5824) |
25 | * proxy/dns/ssl config should be updated to route "https://download.uuid_prefix.arvadosapi.com/" requests to keep-web (alongside the existing "collections" routing) |
||
26 | * keep-web command line adds @-attachment-only-host download.uuid_prefix.arvadosapi.com@ |
||
27 | * Workbench config adds @keep_web_download_url@ |
||
28 | * More info on the (still beta/non-TOC-linked) "keep-web doc page":http://doc.arvados.org/install/install-keep-web.html |
||
29 | |||
30 | 1 | Tom Clegg | 2015-11-04: commit:1d1c6de removes stopped containers (see #7444) |
31 | * 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. |
||
32 | |||
33 | 2015-11-04: commit:21006cf adds a keep-web service (see #5824) |
||
34 | * 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). |