From 67b9c48ee2cea2e95196cdfb9e1e39bf1db3bdf5 Mon Sep 17 00:00:00 2001
From: Ted Avery <tavery@tavery-thinkpadp16vgen1.rht.csb>
Date: Thu, 14 Aug 2025 15:35:06 -0400
Subject: [PATCH] OSDOCS-7857:RPM Uninstall Instructions

---
 _topic_maps/_topic_map_ms.yml                 |  2 +
 .../microshift-install-rpm.adoc               |  1 +
 .../microshift-uninstall-rpm.adoc             | 11 ++++++
 .../microshift-uninstall-microshift-rpms.adoc | 38 +++++++++++++++++++
 4 files changed, 52 insertions(+)
 create mode 100644 microshift_install_rpm/microshift-uninstall-rpm.adoc
 create mode 100644 modules/microshift-uninstall-microshift-rpms.adoc

diff --git a/_topic_maps/_topic_map_ms.yml b/_topic_maps/_topic_map_ms.yml
index 2d4f35e5ed2c..e0b766b214fa 100644
--- a/_topic_maps/_topic_map_ms.yml
+++ b/_topic_maps/_topic_map_ms.yml
@@ -53,6 +53,8 @@ Distros: microshift
 Topics:
 - Name: Installing with an RPM package
   File: microshift-install-rpm
+- Name: Uninstalling MicroShift
+  File: microshift-uninstall-rpm
 ---
 Name: Installing optional RPM packages
 Dir: microshift_install_rpm_opt
diff --git a/microshift_install_rpm/microshift-install-rpm.adoc b/microshift_install_rpm/microshift-install-rpm.adoc
index 4ad0495574aa..4196a6b71dc8 100644
--- a/microshift_install_rpm/microshift-install-rpm.adoc
+++ b/microshift_install_rpm/microshift-install-rpm.adoc
@@ -42,6 +42,7 @@ include::modules/microshift-accessing.adoc[leveloffset=+1]
 //additional resources for accessing module
 [role="_additional-resources"]
 .Additional resources
+
 * xref:../microshift_cli_ref/microshift-oc-cli-install.adoc#microshift-oc-cli-install[Installing the OpenShift CLI tool].
 
 include::modules/microshift-accessing-cluster-locally.adoc[leveloffset=+2]
diff --git a/microshift_install_rpm/microshift-uninstall-rpm.adoc b/microshift_install_rpm/microshift-uninstall-rpm.adoc
new file mode 100644
index 000000000000..5f8729020c19
--- /dev/null
+++ b/microshift_install_rpm/microshift-uninstall-rpm.adoc
@@ -0,0 +1,11 @@
+:_mod-docs-content-type: ASSEMBLY
+[id="microshift-uninstall-rpm"]
+include::_attributes/attributes-microshift.adoc[]
+= Uninstalling {microshift-short}
+:context: microshift-uninstall-rpm
+
+toc::[]
+
+Before you uninstall {microshift-short}, clean up all the {microshift-short} data and configuration by running the `microshift-cleanup-data` script.
+
+include::modules/microshift-uninstall-microshift-rpms.adoc[leveloffset=+1]
\ No newline at end of file
diff --git a/modules/microshift-uninstall-microshift-rpms.adoc b/modules/microshift-uninstall-microshift-rpms.adoc
new file mode 100644
index 000000000000..df71d5b4e74f
--- /dev/null
+++ b/modules/microshift-uninstall-microshift-rpms.adoc
@@ -0,0 +1,38 @@
+// Module included in the following assemblies:
+//
+// microshift_install_rpm/microshift-uninstall.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="microshift-uninstall-microshift-rpms_{context}"]
+= Uninstalling {microshift-short} from an RPM package
+
+.Prerequisites
+
+* You are logged into {microshift-short} as an administrator with root-user access.
+* You have filed a support case.
+* You have root access to the {microshift-short} cluster. 
+
+.Procedure
+
+. Clean all your data by running the following command:
++
+[source,terminal,subs="+quotes"]
+----
+$ sudo microshift-cleanup-data --all <1>
+----
+<1> When you run the script with the `--all` argument, you perform the following clean up actions:
+
+* Stop and disable all {microshift-short} services
+* Delete all {microshift-short} pods
+* Delete all container image storage
+* Reset network configuration
+* Delete the `/var/lib/microshift` data directory
+* Delete OVN-K networking configuration
++
+. Run the following command:
++
+[source,terminal,subs="+quotes"]
+----
+$ sudo dnf remove -y microshift*
+----
++