Bug 10351

Summary:

Add documentation regarding RPM postinstall failures on the host

Product:

[Documentation] Reference

Reporter:

Stephano Cetola <stephano>

Component:

handbook

Assignee:

Scott Rifenbark <srifenbark>

Status:

VERIFIED FIXED

QA Contact:

Jose Perez C <jose.perez.carranza>

Severity:

enhancement

Priority:

Medium+

CC:

jose.perez.carranza, poky.doc.watcher, poky.watcher, Qi.Chen, srifenbark, stephano

Version:

2.2

Target Milestone:

2.3 M1

Hardware:

x86

OS:

Multiple

Whiteboard:

29 Nov 2016: RESOLVED

OS type for building Yocto:

---

Type of Regression:

---

Verified:

Documentation change:

Done (doc changes complete)

Attachments:

Description	Flags
text changes for documentation	none

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