BRL-CAD has a newly revised (and renamed) turn-key Virtual Machine (VM for the purpose of providing an immediate, read-only access to the project and its development. The VM has not been tested by other than its author and needs to be taken for a test drive by others. The user will need to be able to work in a command-line environment and be willing to log in detail his or her experiences with the VM.
Download and install the new BRL-CAD VM. Test it for its intended purpose, keep detailed notes of actions taken, any bugs or problems encountered (be sure they are problems with the disk image and not problems with your comprehension), proposed changes, and suggested improvements. In particular: determine the adequacy of the documentation, test building (compiling) the source code, and updating the trunk with subversion.
References:
- http://sourceforge.net/projects/brlcad/files/BRL-CAD%20for%20Virtual%20Machines/
- http://sourceforge.net/projects/brlcad/files/BRL-CAD%20for%20Virtual%20Machines/README.txt/download
- http://sourceforge.net/projects/brlcad/files/BRL-CAD%20for%20Virtual%20Machines/BRL-CAD-Debian-7.2-32bit.ova/download
- http://brlcad.org/wiki/Deuces
Submit a one-page report itemizing your notes, bugs/problems, proposed changes, and suggestions for improvements. Try to identify at least three for each of those.
| File name/URL | File size | Date submitted | |
|---|---|---|---|
| virtualmachinetest.pdf | 3.7 MB | December 04 2014 14:58 UTC | |
| virtualmachinetest2.pdf | 3.2 MB | December 05 2014 06:58 UTC | |
| final.pdf | 4.4 MB | December 05 2014 07:19 UTC |
I would like to work on this task.
This task has been assigned to Marc Tannous. You have 100 hours to complete this task, good luck!
The work on this task is ready to be reviewed.
Marc, the virtual machine guide cannot be merged with installing BRL-CAD guide for the reason that one does not depend on the other.
You ve mentioned that you were confused by being presented with two terminals. Now that you've managed to use it, what do you believe would be more useful in this matter?
Regarding long compilation time, where would you mention it? In the install guide? In a note opening when VM boots? Would you write a tutorial to change VM resources(Even if it's fairly intuitive)?
I remember you asking on IRC if/how you can move files from virtual machine to your desktop, you should document that. Also, have you tried checking out our repo with svn, from the vm?(As it's stated in the task description).
Aside of what I mentioned, it looks good.
Cheers,
Andrei
One of the mentors has sent this task back for more work. Talk to the mentor(s) assigned to this task to satisfy the requirements needed to complete this task, submit your work again and mark the task as complete once you re-submit your work.
1) Regarding the two terminals, at first I thought that's how it's supposed to happen, but quickly realized that you only need one of them. If there is indeed a purpose, maybe it could be specified on the sourceforge readme, so that a first time user like me does not get confused.
2) The long compilation time is mentioned in the VM readme, but I thought that it should also be mentioned on the sourceforge readme up until you said that one does not depend on the other. Considering that's the case, things are okay as they are, maybe mention the fact that if you want to speed up the process you'd have to change the VM's resources, and people should probably know how that is done as it's really intuitive. Mention this in the readme on /home/ and it should be okay, in my opinion.
3) I checked the repo with svn, the only issue I encountered was the link found on www.brlcad.org/wiki/patches was antiquated and mentioned it over IRC, creating diff files was easy, adding/removing files to a repo is now stated in the wiki, the only feature missing is being able to apply the patch, but that's most likely intended.
4) Regarding the file movement from VM to desktop, I googled a solution before asking on IRC and the easiest way is : "You have to go to Settings--Advanced and set "Drag'nDrop" to Bidirectional. You may also have to install the VM extensions before doing so(Devices--Install guest additions mounts a cd and then you may have to go run setup if it does not autorun).".
This could be added to the readme on /home/, but the way I transfered files from my VM to desktop/mobile phone/any other device was by uploading it to a free cloud service from the built-in browser in the VM ( Chromium ) and then downloading these when I needed them on my Desktop. I considered that easier than installing extensions.
Hope this answers your questions,
Marc
The work on this task is ready to be reviewed.
Is the 2.pdf file the second page or the second version? If it's the second page, merge them into a single file. Otherwise it's ok
One of the mentors has sent this task back for more work. Talk to the mentor(s) assigned to this task to satisfy the requirements needed to complete this task, submit your work again and mark the task as complete once you re-submit your work.
The work on this task is ready to be reviewed.
Congratulations, this task has been completed successfully.