From: Ward Vandewege <wvandewege@veritasgenetics.com>
Date: Fri, 1 Feb 2019 15:39:16 +0000 (-0500)
Subject: 9945: Merge branch 'master' into 9945-make-python-package-dependency-free
X-Git-Tag: 1.4.0~167^2~2
X-Git-Url: https://git.arvados.org/arvados.git/commitdiff_plain/2666c3b726d190511f072db9e6606a1a99936968

9945: Merge branch 'master' into 9945-make-python-package-dependency-free

Arvados-DCO-1.1-Signed-off-by: Ward Vandewege <wvandewege@veritasgenetics.com>
---

2666c3b726d190511f072db9e6606a1a99936968
diff --cc doc/admin/upgrading.html.textile.liquid
index 74e0357537,6a3e000ca0..fc4ccac5f1
--- a/doc/admin/upgrading.html.textile.liquid
+++ b/doc/admin/upgrading.html.textile.liquid
@@@ -30,32 -30,14 +30,40 @@@ Note to developers: Add new items at th
  TODO: extract this information based on git commit messages and generate changelogs / release notes automatically.
  {% endcomment %}
  
 +h3. current master branch
 +
 +h4. Python packaging change
 +
 +As part of story "#9945":https://dev.arvados.org/issues/9945, the distribution packaging (deb/rpm) of our Python packages has changed. These packages now include a built-in virtualenv to reduce dependencies on system packages. We have also stopped packaging and publishing backports for all the Python dependencies of our packages, as they are no longer needed.
 +
 +One practical consequence of this change is that the use of the Arvados Python SDK (aka "import arvados") will require a tweak if the SDK was installed from a distribution package. It now requires the loading of the virtualenv environment from our packages. The "Install documentation for the Arvados Python SDK":/sdk/python/sdk-python.html reflects this change. This does not affect the use of the command line tools (e.g. arv-get, etc.).
 +
 +Python scripts that rely on the distribution Arvados Python SDK packages to import the Arvados SDK will need to be tweaked to load the correct Python environment.
 +
 +This can be done by activating the virtualenv outside of the script:
 +
 +<notextile>
 +<pre>~$ <code class="userinput">source /usr/share/python2.7/dist/python-arvados-python-client/bin/activate</code>
 +(python-arvados-python-client) ~$ <code class="userinput">path-to-the-python-script</code>
 +</pre>
 +</notextile>
 +
 +Or alternatively, by updating the shebang line at the start of the script to:
 +
 +<notextile>
 +<pre>
 +#!/usr/share/python2.7/dist/python-arvados-python-client/bin/python
 +</pre>
 +</notextile>
 +
+ h3. v1.3.0 (2018-12-05)
+ 
+ This release includes several database migrations, which will be executed automatically as part of the API server upgrade. On large Arvados installations, these migrations will take a while. We've seen the upgrade take 30 minutes or more on installations with a lot of collections.
+ 
+ The @arvados-controller@ component now requires the /etc/arvados/config.yml file to be present. See <a href="{{ site.baseurl }}/install/install-controller.html#configuration">the @arvados-controller@ installation instructions</a>.
+ 
+ Support for the deprecated "jobs" API is broken in this release.  Users who rely on it should not upgrade.  This will be fixed in an upcoming 1.3.1 patch release, however users are "encouraged to migrate":upgrade-crunch2.html as support for the "jobs" API will be dropped in an upcoming release.  Users who are already using the "containers" API are not affected.
+ 
  h3. v1.2.1 (2018-11-26)
  
  There are no special upgrade notes for this release.