Bug 1995064 - [Docs][Install Guide] State that the `nodectl init` command must come at the end of the %post section
Summary: [Docs][Install Guide] State that the `nodectl init` command must come at the ...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Virtualization Manager
Classification: Red Hat
Component: Documentation
Version: 4.4.7
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: ovirt-4.4.10-1
: ---
Assignee: Donna DaCosta
QA Contact: cshao
URL:
Whiteboard:
: 1842484 (view as bug list)
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2021-08-18 11:39 UTC by Steve Goodman
Modified: 2022-02-16 20:02 UTC (History)
13 users (show)

Fixed In Version:
Doc Type: No Doc Update
Doc Text:
Clone Of:
Environment:
Last Closed: 2022-02-16 20:02:47 UTC
oVirt Team: Integration
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Issue Tracker RHV-43064 0 None None None 2021-08-19 07:43:08 UTC
Red Hat Knowledge Base (Solution) 5603731 0 None None None 2021-08-19 07:42:10 UTC

Description Steve Goodman 2021-08-18 11:39:51 UTC
Based on a customer case, we need to state that the `nodectl init` command must come at the end of the %post section.

We can add the following note at the end of 6.1.3.3.3. Creating and running a Kickstart file [1], after step 2.

[NOTE]
====
Ensure that the `nodectl init` command is at the very end of the %post section, so that it is the last command executed in that section. 
====

This note is based on [2].

[1] https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html-single/installing_red_hat_virtualization_as_a_self-hosted_engine_using_the_command_line#Creating_and_Running_a_Kickstart_File

[2] See also https://bugzilla.redhat.com/show_bug.cgi?id=1842484#c32

Comment 1 Lev Veyde 2021-08-18 11:47:57 UTC
(In reply to Steve Goodman from comment #0)
> Based on a customer case, we need to state that the `nodectl init` command
> must come at the end of the %post section.
> 
> We can add the following note at the end of 6.1.3.3.3. Creating and running
> a Kickstart file [1], after step 2.
> 
> [NOTE]
> ====
> Ensure that the `nodectl init` command is at the very end of the %post
> section, so that it is the last command executed in that section. 
> ====
> 
> This note is based on [2].
> 
> [1]
> https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/
> html-single/installing_red_hat_virtualization_as_a_self-
> hosted_engine_using_the_command_line#Creating_and_Running_a_Kickstart_File
> 
> [2] See also https://bugzilla.redhat.com/show_bug.cgi?id=1842484#c32

Just a small note - though it may be obvious - it must come at the end of the %post section, but *before* the reboot code, if any.

Comment 2 Steve Goodman 2021-08-18 11:53:58 UTC
(In reply to Lev Veyde from comment #1)
> Just a small note - though it may be obvious - it must come at the end of
> the %post section, but *before* the reboot code, if any.


Like this?

[NOTE]
====
Ensure that the `nodectl init` command is at the very end of the %post
section, so that it is the last command executed in that section. For example:

----
%post --log=/root/ks.post.log --erroronfail

...

nodectl init

sync
systemctl reboot
%end
----
====

Comment 3 Lev Veyde 2021-08-18 12:07:44 UTC
(In reply to Steve Goodman from comment #2)
> (In reply to Lev Veyde from comment #1)
> > Just a small note - though it may be obvious - it must come at the end of
> > the %post section, but *before* the reboot code, if any.
> 
> 
> Like this?
> 
> [NOTE]
> ====
> Ensure that the `nodectl init` command is at the very end of the %post
> section, so that it is the last command executed in that section. For
> example:
> 
> ----
> %post --log=/root/ks.post.log --erroronfail
> 
> ...
> 
> nodectl init
> 
> sync
> systemctl reboot
> %end
> ----
> ====

I'm wondering if it's a good idea to actually include the reboot code in the sample, as I would like to prevent it from being included by default, as most customers should not use it like that.
Thus I think it's better to just add a warning, or have it part of of the explanation i.e. that the nodectl init should be added at the very end of the %post section, before the reboot code if any.

Comment 4 Lev Veyde 2021-08-18 12:20:03 UTC
(In reply to Lev Veyde from comment #3)
> (In reply to Steve Goodman from comment #2)
> > (In reply to Lev Veyde from comment #1)
> > > Just a small note - though it may be obvious - it must come at the end of
> > > the %post section, but *before* the reboot code, if any.
> > 
> > 
> > Like this?
> > 
> > [NOTE]
> > ====
> > Ensure that the `nodectl init` command is at the very end of the %post
> > section, so that it is the last command executed in that section. For
> > example:
> > 
> > ----
> > %post --log=/root/ks.post.log --erroronfail
> > 
> > ...
> > 
> > nodectl init
> > 
> > sync
> > systemctl reboot
> > %end
> > ----
> > ====
> 
> I'm wondering if it's a good idea to actually include the reboot code in the
> sample, as I would like to prevent it from being included by default, as
> most customers should not use it like that.
> Thus I think it's better to just add a warning, or have it part of of the
> explanation i.e. that the nodectl init should be added at the very end of
> the %post section, before the reboot code if any.


To clarify - normally customers should not include the commands to reboot the machine after the installation in the %post section.

Instead they should use the "reboot" instruction in the kickstart file, to order the installation to reboot at the end of the installation.

So adding the command to reboot in the %post section is actually a bad practice.

Comment 5 Sandro Bonazzola 2021-08-19 07:42:10 UTC
*** Bug 1842484 has been marked as a duplicate of this bug. ***

Comment 10 Richard Hoch 2021-10-04 14:53:40 UTC
I'm on it.

Comment 11 Richard Hoch 2021-10-04 15:00:30 UTC
One minor note -- otherwise, LGTM.

Comment 15 cshao 2021-10-12 07:58:19 UTC
Verify this bug according above comments.

Comment 18 cshao 2022-02-14 09:20:02 UTC
Verify this bug according above comments.

Comment 19 ctomasko 2022-02-16 20:02:47 UTC
LGTM, ready to close. Looks like this bug was reopened to test by QE. Testing done and verified on 14-Feb-2022. The content is live in the 4.4 documentation https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html-single/installing_red_hat_virtualization_as_a_self-hosted_engine_using_the_command_line/index#Creating_and_Running_a_Kickstart_File


Note You need to log in before you can comment on or make changes to this bug.