Bug 9672 - Add documentation for package installation during runtime testing
Summary: Add documentation for package installation during runtime testing
Status: RESOLVED FIXED
Alias: None
Product: Reference
Classification: Documentation
Component: handbook (show other bugs)
Version: 2.2
Hardware: x86 Multiple
: Medium enhancement
Target Milestone: 2.2 M4
Assignee: Scott Rifenbark
QA Contact:
URL:
Whiteboard: 7 June 2016: ACCEPTED
Depends on:
Blocks: 7850
  Show dependency tree
 
Reported: 2016-05-24 20:46 UTC by Mariano Lopez
Modified: 2016-06-29 16:10 UTC (History)
5 users (show)

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


Attachments
Documentation draft (76.64 KB, application/pdf)
2016-05-24 20:46 UTC, Mariano Lopez
no flags Details

Note You need to log in before you can comment on or make changes to this bug.
Description Mariano Lopez 2016-05-24 20:46:48 UTC
Created attachment 3187 [details]
Documentation draft

The functionality introduced by the bug 7850 needs to be documented. This bug is to add such documentation. Attached you can find the draft of such documentation.
Comment 1 Joshua Lock 2016-05-25 14:09:26 UTC
The docs note that "permissions and special attributes will be lost".

Is there a plan to support permissions and attributes in exported tests? I can certainly imagine test cases that would fail if the permissions and extended attributes on files from the package weren't correct.
Comment 2 Mariano Lopez 2016-05-25 14:37:05 UTC
Yes, there is a requirement for that. I was thinking in using tar to accomplish this, the drawback is tar would be needed in the DUT. Right now I'm really open to suggestion on how to do this.
Comment 3 Mariano Lopez 2016-05-25 14:52:13 UTC
Had a conversation with Joshua, he recommends using rsync in order to solve the permission/attributes issues when using scp.
Comment 4 Mariano Lopez 2016-05-25 16:16:22 UTC
Unfortunately rsync requires the binary to be installed in both machines, so it is the same problem as having tar in the DUT.
Comment 5 Joshua Lock 2016-05-25 21:12:40 UTC
(In reply to comment #4)
> Unfortunately rsync requires the binary to be installed in both machines, so
> it is the same problem as having tar in the DUT.

Hmm, right. I think tar is probably our best option at this point, then.

I'm not sure the busybox tar is up to it, though perhaps we could first copy over a (perhaps even statically linked) tar (bsdtar, or GNU tar) and use that?
Comment 6 Scott Rifenbark 2016-06-08 01:44:42 UTC
Setting to ACCEPTED.
Comment 7 Scott Rifenbark 2016-06-27 18:10:40 UTC
See these sections:

* http://www.yoctoproject.org/docs/2.2/dev-manual/dev-manual.html#exporting-tests

* http://www.yoctoproject.org/docs/2.2/dev-manual/dev-manual.html#installing-packages-in-the-dut-without-the-package-manager

Note that in the DUT section (second link above) I did not create widowed sections.  All the information is folded into a single section.  If you don't have multiple subsections then you don't want to create a single one.

Please review and let me know if this is good.  I swear I fixed this before and put a comment in Bugzilla regarding this bug.  I don't know where it went though. 

Scott
Comment 8 Mariano Lopez 2016-06-28 15:40:54 UTC
Just two comments,

In the second section, the phrase " Furthermore, the filename must map directory to the test module name with a .json extension.", instead of directory it is directly.

And in the JSON example the first "foo" is missing.

Thanks
Comment 9 Joshua Lock 2016-06-29 08:51:44 UTC
I know this is an aside, maybe we have/need a different bugzilla entry for this?

(In reply to comment #4)
> Unfortunately rsync requires the binary to be installed in both machines, so
> it is the same problem as having tar in the DUT.

I happened to be looking over the rsync manpage earlier and it states multiple times that rsync can be used "over  any remote shell" -- what makes you think the rsync binary is required on both machines?
Comment 10 Mariano Lopez 2016-06-29 13:04:25 UTC
(In reply to comment #9)
> I know this is an aside, maybe we have/need a different bugzilla entry for
> this?

I just opened bug 9848 to track this.
Comment 11 Scott Rifenbark 2016-06-29 14:59:22 UTC
Ok - Sorry about that. 

I fixed these up - see http://www.yoctoproject.org/docs/2.2/dev-manual/dev-manual.html#installing-packages-in-the-dut-without-the-package-manager

Can we set status to RESOLVED for this bug now?

Thanks, 
Scott
Comment 12 Mariano Lopez 2016-06-29 16:08:23 UTC
Indeed, thanks Scott
Comment 13 Scott Rifenbark 2016-06-29 16:10:36 UTC
Thanks... setting to RESOLVED and sticking the doc flag at "done."

Scott