3 This page contains notes on how to build and install the software necessary to run Moonshot clients on a computer running Max OS X 10.6 Snow Leopard and 10.7 Lion.
5 It also contains instructions for creating an installer package allowing the Moonshot software to be installed on other machines running Mac OS X.
7 These notes are also in the file mac-client-installer/README.MacOsBuildInstructions
9 There are three components that need to be built and installed:
10 1: the Cyrus SASL2 library, along with the SASL GS2 Library which implements the GS2 GSS-API->SASL bridge mechanism.
11 2: the Moonshot GSS EAP library, implements the EAP mechanism for use by the GSS API. This library depends on having a recent version of Kerberos. Mac OS X ships with Kerberos 5 release 1.7-prerelease which is not recent enough. So. for the installer at least, we will get and build the latest stable release (1.9.2) from [MIT](from http://web.mit.edu/kerberos/dist/index.html).
12 3: the Moonshot Identity Selector/Manager software which...
13 ToDo: Complete this section
16 ###Getting the Moonshot source code
18 Follow the instructions at http://www.project-moonshot.org/developers/repository, cloning the repo in $HOME
20 Working in $HOME/moonshot/mac-client-installer
22 ###Building the Cyrus SASL2 library
24 $ cd $HOME/moonshot/cyrus_sasl
27 You will see the following message
29 configure.in:14 error: possibly undefined macro: AC_DEFINE
30 If this token and others are legitimate, please use m4_pattern_allow.
31 See the Autoconf documentation
36 To install to /usr/local in your build machine
40 Create the link from /usr/lib/sasl2 (where the library looks for the plugins)->/usr/local/lib/sasl2 (where the plugins will be installed)
43 $ ln -fs ../local/lib/sasl2
45 Or, if you are making the installer
47 $ make install DESTDIR=$HOME/moonshot/mac-client-installer/sasl
49 Create the link from /usr/lib/sasl2 (where the library looks for the plugins)->/usr/local/lib/sasl2 (where the plugins will be installed)
53 $ ln -fs ../local/lib/sasl2
57 The files and directories that are installed are as listed in README.saslInstalledFiles
59 ###Building the downloaded Kerberos
61 Unpack the file to $HOME/krbbuild
63 $ cd $HOME/krbbuild/krb5-1.9.2-signed/krb5-1.9.2/src
67 To install to /usr/local in your build machine
71 Or, if you are making the installer
72 $ make install DESTDIR=$HOME/moonshot/mac-client-installer/krb
74 ###Building the Moonshot GSS EAP library
76 $ cd $HOME/moonshot/moonshot
78 $ ./configure --enable-acceptor=no
80 You will see the following warnings
83 ----------------------------------------------------------------------
84 Cannot find OpenSAML libraries, building without OpenSAML support.
85 Please install OpenSAML or specify installation directory with
86 --with-opensaml=(dir).
87 ----------------------------------------------------------------------
90 ----------------------------------------------------------------------
91 Cannot find Shibboleth resolver libraries, building without
93 Please install Shibboleth or specify installation directory with
94 --with-shibresolver=(dir).
95 ----------------------------------------------------------------------
100 $ libtool --finish /usr/local/lib/gss
102 Or, if you are making the installer
104 $ ./configure --enable-acceptor=no --with-krb5=$HOME/moonshot/mac-client-installer/krb/usr/local
107 We only need to install the mech_eap library
110 $ make install DESTDIR=$HOME/moonshot/mac-client-installer/krb
112 The files and directories that are installed are as listed in README.KrbInstalledFiles
114 ###Building the Moonshot Identity Selector/Manager software
115 ToDo: Complete this section
117 ###Make the install package
118 Ideally we would divide the installer into sub-packages (sasl and krb) within a single meta package. However this seems to be possible only from the packagemaker GUI: there are a number of problems with doing this from the packagemaker command line. We are therefore building a single package, with sasl and krb as choice items within the package.
120 Ensure the permissions are correct for the files to be installed
122 $ sudo chown -R root:admin krb sasl
123 $ sudo chmod -R g+w krb sasl
127 $ /Developer/usr/bin/packagemaker --doc Moonshot\ Client\ Software.pmdoc \
128 --version 0.1 --filter "/.DS_Store" --resources ./resources/ --root-volume-only\
129 --domain system --verbose --no-relocate -l "/" --target 10.5 \
130 --id ja.net.moonshotClientSoftware --out Moonshot\ Client\ Software.pkg