From 977d05c7cea796ba5f2191eb1d8f8db3cdf3c001 Mon Sep 17 00:00:00 2001
From: Michal Konecny <mkonecny@redhat.com>
Date: Tue, 24 Sep 2024 14:36:58 +0200
Subject: [PATCH] Add read-only troubleshooting guide to koji SOP

As this is happening relatively often lately it would be good to add guide.

Signed-off-by: Michal Konecny <mkonecny@redhat.com>
---
 modules/sysadmin_guide/pages/koji.adoc | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/modules/sysadmin_guide/pages/koji.adoc b/modules/sysadmin_guide/pages/koji.adoc
index 6a6601b..4de068f 100644
--- a/modules/sysadmin_guide/pages/koji.adoc
+++ b/modules/sysadmin_guide/pages/koji.adoc
@@ -99,3 +99,22 @@ After restarting any `s390x` machine in `inventory/builders` `[runroot]` group s
 You need to have access to Bitwarden Vault for the password prompt.
 ====
 
+=== OSError: [Errno 30] Read-only file system: "/var/tmp/koji/tasks/xxx"
+
+For more information about this issue see link:<https://bugzilla.redhat.com/show_bug.cgi?id=2312886>[relevant bugzilla ticket].
+The issue is also reported on parent task, make sure you found the exact task that failed to find the failing host.
+Only way to deal with it currently is to disable the builder with issue in koji and reinstall it again.
+
+==== Disabling builder in koji
+
+. Generate a kerberos ticket
+. koji disable <builder_with_issue>
+
+==== Reinstalling the builder
+
+. Run `groups/buildvm.yml` ansible playbook with `--limit <builder_hostname>`
+
+[NOTE]
+====
+You need to be koji admin.
+====