Bug 10351 - Add documentation regarding RPM postinstall failures on the host
Summary: Add documentation regarding RPM postinstall failures on the host
Status: VERIFIED FIXED
Alias: None
Product: Reference
Classification: Documentation
Component: handbook (show other bugs)
Version: 2.2
Hardware: x86 Multiple
: Medium+ enhancement
Target Milestone: 2.3 M1
Assignee: Scott Rifenbark
QA Contact: Jose Perez C
URL:
Whiteboard: 29 Nov 2016: RESOLVED
Depends on:
Blocks:
 
Reported: 2016-09-30 02:50 UTC by Stephano Cetola
Modified: 2016-12-06 17:40 UTC (History)
6 users (show)

See Also:
OS type for building Yocto: ---
Type of Regression: ---
Verified:
Documentation change: Done (doc changes complete)


Attachments
text changes for documentation (786 bytes, text/plain)
2016-11-21 18:24 UTC, Stephano Cetola
no flags Details

Note You need to log in before you can comment on or make changes to this bug.
Description Stephano Cetola 2016-09-30 02:50:06 UTC
In Bug 10264, it was discovered that RPM will fail to install packages properly on the host if a postinstall script returns a non-zero exit code.

Since we allow for postinstall to return non-zero exit codes at build time, as documented here:

http://www.yoctoproject.org/docs/latest/mega-manual/mega-manual.html#new-recipe-post-installation-scripts

We should add a note that postinstall scripts intended to run on the host should never return a nonzero exit code, or the package will fail to install properly.
Comment 1 Stephano Cetola 2016-09-30 02:52:37 UTC
I'll come up with some wording for this and reassign it to Scott when it's ready.
Comment 2 Scott Rifenbark 2016-10-03 16:53:53 UTC
Sounds good Stephano.

Thanks, 
Scott
Comment 3 Stephano Cetola 2016-11-21 18:24:52 UTC
Created attachment 3542 [details]
text changes for documentation

See the attachment for the text changes. Let me know if you have any questions.
Comment 4 Scott Rifenbark 2016-11-22 00:49:49 UTC
Stephano, 

Thanks for the suggested text in your comment.  I put it in as is with the exception of calling out the RPM package manager instead of "it".  So check it out at http://www.yoctoproject.org/docs/2.3/dev-manual/dev-manual.html#new-recipe-post-installation-scripts.  You will notice too that I formatted the thing as a Note since it seemed to be something to note :)

Let me know if this works for you. 

Thanks, 
Scott
Comment 5 Stephano Cetola 2016-11-22 14:39:05 UTC
Looks perfect! It's handy that we have that note feature.

Thanks for the edits and polishing.

--S
Comment 6 Scott Rifenbark 2016-11-28 22:29:45 UTC
Thanks, 

I am putting the bug to RESOLVED now and setting the doc flag to "done."

Scott
Comment 7 Jose Perez C 2016-12-06 17:40:23 UTC
Verified, 'note' for RPM installation is placed on the documentation successfully