From 3bf63bd9ae01ed153b881739b15982e66b7daa00 Mon Sep 17 00:00:00 2001
From: Christian Berendt <berendt@osism.tech>
Date: Thu, 6 Feb 2025 22:10:47 +0100
Subject: [PATCH] troubleshooting-guide: move rookify (#793)

Signed-off-by: Christian Berendt <berendt@osism.tech>
---
 docs/guides/migration-guide/rook/index.md    | 31 +++++++++++++++---
 docs/guides/troubleshooting-guide/rookify.md | 34 --------------------
 2 files changed, 27 insertions(+), 38 deletions(-)
 delete mode 100644 docs/guides/troubleshooting-guide/rookify.md

diff --git a/docs/guides/migration-guide/rook/index.md b/docs/guides/migration-guide/rook/index.md
index ad93afc5aa..07bb76e148 100644
--- a/docs/guides/migration-guide/rook/index.md
+++ b/docs/guides/migration-guide/rook/index.md
@@ -1,5 +1,5 @@
 ---
-sidebar_label: Rookify
+sidebar_label: Rook
 sidebar_position: 31
 ---
 
@@ -14,7 +14,7 @@ Nevertheless, it is **strongly advised** to test Rookify in a controlled environ
 
 For a condensed summary of the information covered here, refer to the [Rookify GitHub repository](https://github.com/SovereignCloudStack/rookify).
 
-## Config.yaml
+## Configuration
 
 The primary configuration file for Rookify is `config.yaml`. The repository includes an example file for general use, as well as one specifically tailored for OSISM based setups:
 
@@ -137,6 +137,29 @@ migration_modules:
 Rookify uses a modular structure, allowing you to migrate various parts of Ceph-Ansible to Rook. The `migration_modules` section specifies which modules need to be executed for the migration. Rookify contains more modules — check the [`src/rookify/module`](https://github.com/SovereignCloudStack/rookify/tree/main/src/rookify/modules) directory to see the currently implemented modules.
 
 :::note
-  Many modules depend on each other. For example, the `analyze_ceph` module will automatically run with all other modules, so
-  there is no need to specify it. It’s included here for clarity.
+
+Many modules depend on each other. For example, the `analyze_ceph` module will automatically run with all other modules, so
+there is no need to specify it. It’s included here for clarity.
+
 :::
+
+## Troubleshooting
+
+### SSH Issues
+
+
+**"Failed to load private key"**
+
+- Ensure the `id-rsa` keys are "clean" and do not contain unexpected strings like "\<\<EOF".
+- Clean the keys manually, or use the following command to reformat the keyfile: `ssh-keygen -p -N "" -f ssh.key`.
+
+
+**"Too many authentications error"**
+
+- This can occur if too many keys are loaded by the ssh-agent.
+- Disable the ssh-agent on your machine. You can do this manually or by allowing `direnv` to use `.envrc` with the command `direnv allow`. To install `direnv` on your machine refer to [Direnv's documentation](https://direnv.net/docs/installation.html)
+
+### Frozen State
+
+- If the Rookify process freezes, check your connections.
+- In the OSISM testbed, ensure the VPN connection is active. For help to setup the VPN connection for the Testbed refer to [OSISM's documentation for testbed setup](https://osism.tech/docs/guides/other-guides/testbed/#vpn-access).
diff --git a/docs/guides/troubleshooting-guide/rookify.md b/docs/guides/troubleshooting-guide/rookify.md
deleted file mode 100644
index a0403d92f9..0000000000
--- a/docs/guides/troubleshooting-guide/rookify.md
+++ /dev/null
@@ -1,34 +0,0 @@
----
-sidebar_label: Rookify (technical preview)
-sidebar_position: 40
----
-
-# Rookify (Technical Preview)
-
-:::warning
-
-Rookify is developed to migrate from Ceph-Ansible to Rook _in place_ and _without downtime_.
-Nevertheless, it is **strongly advised** to test Rookify in a controlled environment first, such as the [OSISM testbed](https://github.com/osism/testbed). Additionally ensure that precautionary backups are made and all other necessary safety measures are in place.
-
-:::
-
-For a condensed summary of the information covered here, refer to the [Rookify GitHub repository](https://github.com/SovereignCloudStack/rookify).
-
-## SSH Issues 
-
-
-**"Failed to load private key"**
-
-- Ensure the `id-rsa` keys are "clean" and do not contain unexpected strings like "\<\<EOF".
-- Clean the keys manually, or use the following command to reformat the keyfile: `ssh-keygen -p -N "" -f ssh.key`.
-
-
-**"Too many authentications error"**
-
-- This can occur if too many keys are loaded by the ssh-agent.
-- Disable the ssh-agent on your machine. You can do this manually or by allowing `direnv` to use `.envrc` with the command `direnv allow`. To install `direnv` on your machine refer to [Direnv's documentation](https://direnv.net/docs/installation.html)
-
-## Frozen State
-
-- If the Rookify process freezes, check your connections.
-- In the OSISM testbed, ensure the VPN connection is active. For help to setup the VPN connection for the Testbed refer to [OSISM's documentation for testbed setup](https://osism.tech/docs/guides/other-guides/testbed/#vpn-access).