system-config/roles/openafs-client/README.rst
Ian Wienand 65991cf92e openafs-client: add service timeout override
Starting the openafs-client service is an intensive operation as it
walks the cache registering various things.  We've seen on our
production ARM64 mirror this can take longer than the 1:30 default
timeout.  This is a fatal issue, as the module will try to unload
while afsd is still spinning and working resulting in completely
corrupt kernel state.

This is about double the longest time we've seen, so should give
plenty of overhead.

Change-Id: I37186494b9afd72eab3a092279579f1a5fa5d22c
2021-06-16 11:50:53 +10:00

53 lines
1.8 KiB
ReStructuredText

An ansible role to configure an OpenAFS client
.. note:: This role uses system packages where available, but for
platforms or architectures where they are not available will
require external builds. Defaults will pick external
packages from OpenStack Infra builds, but you should
evaluate if this is suitable for your environment.
This role configures the host to be an `OpenAFS
<https://www.openafs.org>`__ client. Because OpenAFS is very reliant
on distribution internals, kernel versions and host architecture this
role has limited platform support. Currently supported are
* Debian family with system packages available
* Ubuntu LTS family with external 1.8 series packages
* CentOS 7 and 8 with external packages
**Role Variables**
.. zuul:rolevar:: openafs_client_cell
:default: openstack.org
The default cell.
.. zuul:rolevar:: openafs_client_cache_size
:default: 500000
The OpenAFS client cache size, in kilobytes.
.. zuul:rolevar:: openafs_client_cache_directory
:default: /var/cache/openafs
The directory to store the OpenAFS cache files.
.. zuul:rolevar:: openafs_client_yum_repo_url
:default: ``https://tarballs.openstack.org/project-config/package-afs-centos7``
The URL to a yum/dnf repository with the OpenAFS client RPMs.
These are assumed to be created from the ``.spec`` file included in
the OpenAFS distribution.
.. zuul:rolevar:: openafs_client_yum_repo_gpg_check
:default: no
Enable or disable gpg checking for ``openafs_yum_repo_url``
.. zuul:rolevar:: openafs_client_service_timeout_sec
:default: 480
The TimeoutSec for service start. Accounting for the cache
during startup can cause a high load which may necessitate
a longer startup timeout on some platforms.