<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugzilla.yoctoproject.org/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.6"
          urlbase="https://bugzilla.yoctoproject.org/"
          
          maintainer="it-coreprojects-helpdesk@linuxfoundation.org"
>

    <bug>
          <bug_id>10351</bug_id>
          
          <creation_ts>2016-09-30 02:50:06 +0000</creation_ts>
          <short_desc>Add documentation regarding RPM postinstall failures on the host</short_desc>
          <delta_ts>2016-12-06 17:40:23 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>Reference</product>
          <component>handbook</component>
          <version>2.2</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>VERIFIED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard>29 Nov 2016: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Medium+</priority>
          <bug_severity>enhancement</bug_severity>
          <target_milestone>2.3 M1</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Stephano Cetola">stephano</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>jose.perez.carranza</cc>
    
    <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</cc>
    
    <cc>Qi.Chen</cc>
    
    <cc>srifenbark</cc>
    
    <cc>stephano</cc>
          
          <qa_contact name="Jose Perez C">jose.perez.carranza</qa_contact>
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>Done (doc changes complete)</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>66741</commentid>
    <comment_count>0</comment_count>
    <who name="Stephano Cetola">stephano</who>
    <bug_when>2016-09-30 02:50:06 +0000</bug_when>
    <thetext>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.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>66742</commentid>
    <comment_count>1</comment_count>
    <who name="Stephano Cetola">stephano</who>
    <bug_when>2016-09-30 02:52:37 +0000</bug_when>
    <thetext>I&apos;ll come up with some wording for this and reassign it to Scott when it&apos;s ready.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>66815</commentid>
    <comment_count>2</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-10-03 16:53:53 +0000</bug_when>
    <thetext>Sounds good Stephano.

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>68462</commentid>
    <comment_count>3</comment_count>
      <attachid>3542</attachid>
    <who name="Stephano Cetola">stephano</who>
    <bug_when>2016-11-21 18:24:52 +0000</bug_when>
    <thetext>Created attachment 3542
text changes for documentation

See the attachment for the text changes. Let me know if you have any questions.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>68475</commentid>
    <comment_count>4</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-11-22 00:49:49 +0000</bug_when>
    <thetext>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 &quot;it&quot;.  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</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>68486</commentid>
    <comment_count>5</comment_count>
    <who name="Stephano Cetola">stephano</who>
    <bug_when>2016-11-22 14:39:05 +0000</bug_when>
    <thetext>Looks perfect! It&apos;s handy that we have that note feature.

Thanks for the edits and polishing.

--S</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>68658</commentid>
    <comment_count>6</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-11-28 22:29:45 +0000</bug_when>
    <thetext>Thanks, 

I am putting the bug to RESOLVED now and setting the doc flag to &quot;done.&quot;

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>68872</commentid>
    <comment_count>7</comment_count>
    <who name="Jose Perez C">jose.perez.carranza</who>
    <bug_when>2016-12-06 17:40:23 +0000</bug_when>
    <thetext>Verified, &apos;note&apos; for RPM installation is placed on the documentation successfully</thetext>
  </long_desc>
      
          <attachment
              isobsolete="0"
              ispatch="0"
              isprivate="0"
          >
            <attachid>3542</attachid>
            <date>2016-11-21 18:24:52 +0000</date>
            <delta_ts>2016-11-21 18:27:02 +0000</delta_ts>
            <desc>text changes for documentation</desc>
            <filename>Post-Installation-Scripts-doc-change.txt</filename>
            <type>text/plain</type>
            <size>786</size>
            <attacher name="Stephano Cetola">stephano</attacher>
            
              <data encoding="base64">VGhlIHNjcmlwdCBkZWZpbmVkIGluIHRoZSBwb3N0LWluc3RhbGxhdGlvbiBmdW5jdGlvbiBpcyBj
YWxsZWQgd2hlbiB0aGUgcm9vdCBmaWxlc3lzdGVtIGlzIGNyZWF0ZWQuIElmIHRoZSBzY3JpcHQg
c3VjY2VlZHMsIHRoZSBwYWNrYWdlIGlzIG1hcmtlZCBhcyBpbnN0YWxsZWQuIElmIHRoZSBzY3Jp
cHQgZmFpbHMsIHRoZSBwYWNrYWdlIGlzIG1hcmtlZCBhcyB1bnBhY2tlZCBhbmQgdGhlIHNjcmlw
dCBpcyBleGVjdXRlZCB3aGVuIHRoZSBpbWFnZSBib290cyBhZ2Fpbi4KCkl0IHNob3VsZCBiZSBu
b3RlZCB0aGF0IGFueSBSUE0gcG9zdGluc3RhbGwgc2NyaXB0IHRoYXQgcnVucyBvbiB0aGUgdGFy
Z2V0IHNob3VsZCByZXR1cm4gYSAwIGV4aXQgY29kZS4gUlBNIGRvZXMgbm90IGFsbG93IG5vbi16
ZXJvIGV4aXQgY29kZXMgZm9yIHRoZXNlIHNjcmlwdHMsIGFuZCBpdCB3aWxsIGNhdXNlIHRoZSBw
YWNrYWdlIHRvIGZhaWwgaW5zdGFsbGF0aW9uIG9uIHRoZSB0YXJnZXQuCgpTb21ldGltZXMgaXQg
aXMgbmVjZXNzYXJ5IGZvciB0aGUgZXhlY3V0aW9uIG9mIGEgcG9zdC1pbnN0YWxsYXRpb24gc2Ny
aXB0IHRvIGJlIGRlbGF5ZWQgdW50aWwgdGhlIGZpcnN0IGJvb3QuIEZvciBleGFtcGxlLCB0aGUg
c2NyaXB0IG1pZ2h0IG5lZWQgdG8gYmUgZXhlY3V0ZWQgb24gdGhlIGRldmljZSBpdHNlbGYuIFRv
IGRlbGF5IHNjcmlwdCBleGVjdXRpb24gdW50aWwgYm9vdCB0aW1lLCB1c2UgdGhlIGZvbGxvd2lu
ZyBzdHJ1Y3R1cmUgaW4gdGhlIHBvc3QtaW5zdGFsbGF0aW9uIHNjcmlwdDoK
</data>

          </attachment>
      

    </bug>

</bugzilla>