Merge branch 'master' of https://github.com/kmcdonell/pcp into kenj-merge
[pcp.git] / OSXReadme.md
blob94134cee33039df1b7332ecd241a6a7c0c670ba9
1 # OSX Vagrant boxes
3 There is an `osxsierra` Vagrant box defined, but it has some restrictions on use.
4 _Only_ if the underlying hardware is detected as Apple Mac and you've checked the licensing agreement is valid and explictly acknowledged this by touching a file.
6 The Vagrantfile will not allow launching the `osxsierra` box until you do.
8 Please read [the licensing agreement](http://images.apple.com/legal/sla/docs/macOS1012.pdf).
10 # #protips
12 * Getting the PCP build log from the guest.  First install this plugin:
15     # will allow you to scp a file from the guest
16     # very useful to grab the PCP build log
17     vagrant plugin install vagrant-scp
19   then you can grab the build log from the guest via:
21      vagrant scp osxsierra:/vagrant/Logs/pcp .
23 # Caveats/Known Issues
25 * The first time you run `vagrant up osxsierra` you will get an `rsync` error. This can be safely ignored for now, just run `vagrant provision osxsierra` to continue past this.  Honestly the `rsync` error is probably a real issue, but there's more issues to battle through first..
27 # TODO
28 * During the `Makepkg` build of PCP there are errors occuring around `tar` failures.