X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/ffd49a86ec939a674e141a4cab8dcb3b6baaf2e6..58e057254087f406ca4146da7031187487b0ddbc:/doc/admin/upgrading.html.textile.liquid?ds=sidebyside diff --git a/doc/admin/upgrading.html.textile.liquid b/doc/admin/upgrading.html.textile.liquid index f96e75021a..5c76f534ac 100644 --- a/doc/admin/upgrading.html.textile.liquid +++ b/doc/admin/upgrading.html.textile.liquid @@ -28,10 +28,56 @@ TODO: extract this information based on git commit messages and generate changel
-h2(#main). development main (as of 2022-12-22) +h2(#main). development main (as of 2023-04-18) + +"previous: Upgrading to 2.6.1":#v2_6_1 + +h3. UseAWSS3v2Driver option removed + +The old "v1" S3 driver for keepstore has been removed. The new "v2" implementation, which has been the default since Arvados 2.5.0, is always used. The @Volumes.*.DriverParameters.UseAWSS3v2Driver@ configuration key is no longer recognized. If your config file uses it, remove it to avoid warning messages at startup. + +h2(#v2_6_1). v2.6.1 (2023-04-17) + +"previous: Upgrading to 2.6.0":#v2_6_0 + +h3. Performance improvement for permission row de-duplication migration + +The migration which de-duplicates permission links has been optimized. We recommend upgrading from 2.5.0 directly to 2.6.1 in order to avoid the slow permission de-deplication migration in 2.6.0. + +You should still plan for the arvados-api-server package upgrade to take longer than usual due to the database schema update changing the integer id column in each table from 32-bit to 64-bit. + +h2(#v2_6_0). v2.6.0 (2023-04-06) "previous: Upgrading to 2.5.0":#v2_5_0 +h3. WebDAV InternalURLs must be reachable from controller nodes + +Ensure your internal keep-web service addresses are listed in the @Services.WebDAV.InternalURLs@ section of your configuration file, and reachable from controller processes, as noted on the "updated install page":{{site.baseurl}}/admin/config-urls.html. + +h3. Slow migration on upgrade + +Important! This upgrade includes a database schema update changing the integer id column in each table from 32-bit to 64-bit. Because it touches every row in the table, on moderate to large sized installations *this may be very slow* (on the order of hours). Plan for the arvados-api-server package upgrade to take longer than usual. + +h3. Default request concurrency, new limit on log requests + +The configuration value @API.MaxConcurrentRequests@ (the number of concurrent requests that will be accepted by a single instance of arvados-controller) now has a default value of 64, instead of being unlimited. + +New configuration value @API.LogCreateRequestFraction@ (default 0.50) limits requests that post live container logs to the API server, to avoid situations where log messages crowd out other more important requests. + +h3. New limit on concurrent workflows + +New configuration options @CloudVMs.SupervisorFraction@ (default 0.30) limits the number of concurrent workflow supervisors, to avoid situations where too many workflow runners crowds out actual workers. + +h3. Default limit for cloud VM instances + +There is a new configuration entry @CloudVMs.MaxInstances@ (default 64) that limits the number of VMs the cloud dispatcher will run at a time. This may need to be adjusted to suit your anticipated workload. + +Using the obsolete configuration entry @MaxCloudVMs@, which was previously accepted in config files but not obeyed, will now result in a deprecation warning. + +h3. Default frequency for running keep-balance has changed + +The frequency that @keep-balance@ will run (@Collections.BalancePeriod@) has been changed from every 10 minutes to every 6 hours. + h2(#v2_5_0). v2.5.0 (2022-12-22) "previous: Upgrading to 2.4.4":#v2_4_4