suggested changes to backporting policy
[openafs-wiki.git] / devel / MacOSXbuild.mdwn
1 First, if you have trouble, or what's below does not work, sign up for <https://lists.openafs.org/mailman/listinfo/port-darwin>                                           
2
3 See [this link](https://lists.openafs.org/pipermail/port-darwin/2011-August/001373.html) for some history
4
5 To build on Mountain Lion and higher, make sure you have Xcode (including the command line developer tools) and Packagemaker. PackageMaker is not included in the current version of Xcode and must be downloaded as part of an older release of XCode.
6
7 You will also need libtool, automake, and autoconf. These can be installed from [MacPorts](https://www.macports.org) via the following commands:
8
9     port install libtool
10     port install automake
11     port install autoconf
12
13 , and the following configure/build options have been reported to work:
14
15     ARCHFLAGS="-arch i386 -arch x86_64" ./configure --enable-transarc-paths \
16     --with-krb5-conf=/usr/bin/krb5-config --enable-warnings --enable-checking
17     ARCHFLAGS="-arch i386 -arch x86_64" make dest
18
19 and then the installer is created, as **root**:
20
21     ARCHFLAGS="-arch i386 -arch x86_64" make packages
22
23 Because this is not a signed package, you will need to disable Mac security protections to install and run your OpenAFS package. For Yosemite, you must disable kernel extension signing via nvram boot options:
24
25     sudo nvram boot-args kext-dev-mode=1
26
27 For El Capitan, you must either install into /usr/local (as of this writing the package scripts are not updated, yet), /opt (by modifying src/packaging/MacOS/buildpkg.sh), or turn off rootless mode (also necessary for an unsigned kernel extension to load). Boot into Recovery via CMD-R and type in:
28
29     csrutil disable