From ec8d4899d74ea76c30cb394dfcda6a54cd9e6652 Mon Sep 17 00:00:00 2001 From: Tom Clegg Date: Thu, 28 Dec 2023 15:40:14 -0500 Subject: [PATCH] 20318: Add install/upgrade notes about /var/cache. Arvados-DCO-1.1-Signed-off-by: Tom Clegg --- doc/admin/upgrading.html.textile.liquid | 6 ++++++ doc/install/install-keep-web.html.textile.liquid | 9 +++++++++ 2 files changed, 15 insertions(+) diff --git a/doc/admin/upgrading.html.textile.liquid b/doc/admin/upgrading.html.textile.liquid index 81b32c1444..7b8c20fdf9 100644 --- a/doc/admin/upgrading.html.textile.liquid +++ b/doc/admin/upgrading.html.textile.liquid @@ -32,6 +32,12 @@ h2(#main). development main "previous: Upgrading to 2.7.1":#v2_7_1 +h3. WebDAV service uses @/var/cache@ for file content + +@keep-web@ now stores copies of recently accessed data blocks in @/var/cache/arvados/keep@ instead of in memory. That directory will be created automatically. The default cache size is 10% of the filesystem size. Use the new @Collections.WebDAVCache.DiskCacheSize@ config to specify a different percentage or an absolute size. + +If the previously supported @MaxBlockEntries@ config is present, remove it to avoid warning messages at startup. + h2(#2_7_1). v2.7.1 (2023-12-12) "previous: Upgrading to 2.7.0":#v2_7_0 diff --git a/doc/install/install-keep-web.html.textile.liquid b/doc/install/install-keep-web.html.textile.liquid index b3c6386129..0b051e715d 100644 --- a/doc/install/install-keep-web.html.textile.liquid +++ b/doc/install/install-keep-web.html.textile.liquid @@ -163,6 +163,15 @@ Normally, Keep-web accepts requests for multiple collections using the same host In such cases -- for example, a site which is not reachable from the internet, where some data is world-readable from Arvados's perspective but is intended to be available only to users within the local network -- the downstream proxy should configured to return 401 for all paths beginning with "/c=" {% include 'notebox_end' %} +h3. Configure filesystem cache size + +Keep-web stores copies of recently accessed data blocks in @/var/cache/arvados/keep@. The cache size defaults to 10% of the size of the filesystem where that directory is located (typically @/var@) and can be customized with the @DiskCacheSize@ config entry. + + +
  Collections:
+    WebDAVCache:
+      DiskCacheSize: 20 GiB
 + {% assign arvados_component = 'keep-web' %} {% include 'install_packages' %} -- 2.30.2