[PATCH] Add a README (#1194155)

Martin Kolman mkolman at redhat.com
Mon Jun 15 15:13:02 UTC 2015


Add a short readme that contains instructions on how to re-enable
Firstboot and a depreciation notice. The depreciation notice includes
links to Firstboot plugin -> Anaconda/Initial Setup addon porting
resources.

Resolves: rhbz#1194155
Signed-off-by: Martin Kolman <mkolman at redhat.com>
---
 MANIFEST.in    |  2 +-
 README.txt     | 20 ++++++++++++++++++++
 firstboot.spec |  1 +
 3 files changed, 22 insertions(+), 1 deletion(-)
 create mode 100644 README.txt

diff --git a/MANIFEST.in b/MANIFEST.in
index 2723803..26babb5 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -1,4 +1,4 @@
-include Makefile firstboot.spec
+include Makefile firstboot.spec README.txt
 recursive-include init firstboot
 recursive-include po *.po *.pot Makefile
 recursive-include progs firstboot
diff --git a/README.txt b/README.txt
new file mode 100644
index 0000000..ad38e8c
--- /dev/null
+++ b/README.txt
@@ -0,0 +1,20 @@
+== How to re-enable Firstboot after first boot ==
+To re-enable Firstboot, you need to do the following:
+
+ 1. rm /etc/sysconfig/firstboot
+ 2. systemctl enable firstboot-graphical.service
+
+NOTE: /etc/reconfigSys is now (RHEL7) ignored.
+
+== Advisory to porting Firstboot plugins ==
+
+The legacy Firstboot tool is no longer in development and all current Firstboot users are advised to port their legacy Firstboot plugins to Anaconda addons, which don't have most of the limitations imposed by the Firstboot architecture.  Also unlike Firstboot plugins, Anaconda addons can be run both of during installation (by Anaconda), and after installation (by Initial Setup).
+
+A comprehensive Anaconda Addon Development Guide is available:
+https://vpodzime.fedorapeople.org/anaconda-addon-development-guide/
+
+As well as an example "Hello world" addon:
+https://github.com/vpodzime/hello-world-anaconda-addon
+
+Also the Kdump project recently successfully made the transition from a Firstboot plugin to an Anaconda addon and could be used as good reference example for a more advanced addon project:
+https://github.com/daveyoung/kdump-anaconda-addon
diff --git a/firstboot.spec b/firstboot.spec
index d28b8a0..fe3ff27 100644
--- a/firstboot.spec
+++ b/firstboot.spec
@@ -74,6 +74,7 @@ fi
 /bin/systemctl try-restart firstboot-graphical.service > /dev/null 2>&1 || :
 
 %files -f %{name}.lang
+%doc README.txt
 %defattr(-,root,root,-)
 %dir %{_datadir}/firstboot/
 %dir %{_datadir}/firstboot/modules/
-- 
2.4.2



More information about the anaconda-patches mailing list