1 ### Building Mac OS Installer using jhbuild
4 Install jhbuild, which Creates working folder ~/gtk
6 Need Kerberos installed in ~/gtk/inst - in the Krb5 src directory
7 $ export CFLAGS="-arch i386"
8 $ ./configure --prefix=/Users/pete/gtk/inst/
12 ## Building the moonshot SW
13 copy file moonshot/mac-client-installer/.jhbuildrc-custom to $HOME
23 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.
25 It also contains instructions for creating an installer package allowing the Moonshot software to be installed on other machines running Mac OS X.
27 These notes are also in the file mac-client-installer/README.MacOsBuildInstructions
29 There are three components that need to be built and installed:
31 1: the Cyrus SASL2 library, along with the SASL GS2 Library which implements the GS2 GSS-API->SASL bridge mechanism.
33 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).
35 3: the Moonshot Identity Selector/Manager software which...
36 ToDo: Complete this section when the client software is ported to Mac OS
39 ###Getting the Moonshot source code
41 Follow the instructions at http://www.project-moonshot.org/developers/repository, cloning the repo in $HOME
43 Working in $HOME/moonshot/mac-client-installer
45 ###Building the Cyrus SASL2 library
47 $ cd $HOME/moonshot/cyrus_sasl
50 You will see the following message
52 configure.in:14 error: possibly undefined macro: AC_DEFINE
53 If this token and others are legitimate, please use m4_pattern_allow.
54 See the Autoconf documentation
56 $ ./configure --with-gss_impl=mit
59 To install to /usr/local in your build machine
63 Create the link from /usr/lib/sasl2 (where the library looks for the plugins)->/usr/local/lib/sasl2 (where the plugins will be installed)
66 $ ln -fs ../local/lib/sasl2
68 Or, if you are making the installer
70 $ make install DESTDIR=$HOME/moonshot/mac-client-installer/sasl
72 Create the link from /usr/lib/sasl2 (where the library looks for the plugins)->/usr/local/lib/sasl2 (where the plugins will be installed)
76 $ ln -fs ../local/lib/sasl2
80 The files and directories that are installed are as listed in README.saslInstalledFiles
82 ###Building the downloaded Kerberos
84 Unpack the file to $HOME/krbbuild
86 $ cd $HOME/krbbuild/krb5-1.9.2-signed/krb5-1.9.2/src
90 To install to /usr/local in your build machine
94 Or, if you are making the installer
95 $ make install DESTDIR=$HOME/moonshot/mac-client-installer/krb
97 ###Building the Moonshot GSS EAP library
99 $ cd $HOME/moonshot/moonshot
101 $ ./configure --enable-acceptor=no
103 You will see the following warnings
106 ----------------------------------------------------------------------
107 Cannot find OpenSAML libraries, building without OpenSAML support.
108 Please install OpenSAML or specify installation directory with
109 --with-opensaml=(dir).
110 ----------------------------------------------------------------------
113 ----------------------------------------------------------------------
114 Cannot find Shibboleth resolver libraries, building without
116 Please install Shibboleth or specify installation directory with
117 --with-shibresolver=(dir).
118 ----------------------------------------------------------------------
123 $ libtool --finish /usr/local/lib/gss
125 Or, if you are making the installer
127 $ ./configure --enable-acceptor=no --with-krb5=$HOME/moonshot/mac-client-installer/krb/usr/local
130 We only need to install the mech_eap library
133 $ make install DESTDIR=$HOME/moonshot/mac-client-installer/krb
135 The files and directories that are installed are as listed in README.KrbInstalledFiles
137 ###Building the Moonshot Identity Selector/Manager software
138 ToDo: Complete this section when the client software is ported to Mac OS
140 ###Make the install package
141 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.
143 Ensure the permissions are correct for the files to be installed
145 $ sudo chown -R root:admin krb sasl
146 $ sudo chmod -R g+w krb sasl
150 $ /Developer/usr/bin/packagemaker --doc Moonshot\ Client\ Software.pmdoc \
151 --version 0.1 --filter "/.DS_Store" --resources ./resources/ --root-volume-only\
152 --domain system --verbose --no-relocate -l "/" --target 10.5 \
153 --id ja.net.moonshotClientSoftware --out Moonshot\ Client\ Software.pkg
155 Instructions in DevWiki at http://www.project-moonshot.org/devwiki//building_client_software_for_mac_os
157 ###Making the Disk Image
158 Create and mount the image - 2MB will be enough for now
160 $ hdiutil create -size 2m -fs HFS+ -volname "Moonshot Client Software" temp.dmg
161 $ hdiutil attach temp.dmg
163 Copy the package and the READMEs
164 $ cp Moonshot\ Client\ Software.pkg /Volumes/Moonshot\ Client\ Software/
165 $ cp resources/* /Volumes/Moonshot\ Client\ Software/
167 Get rid of hidden files and folders that we don't need
169 $ sudo rm -rf /Volumes/Moonshot\ Client\ Software/.fseventsd/
170 $ sudo rm -rf /Volumes/Moonshot\ Client\ Software/.Trashes/
171 $ sudo find /Volumes/Moonshot\ Client\ Software -name '.*' -type f -delete
175 $ hdiutil detach /Volumes/Moonshot\ Client\ Software
177 Convert the disk image to read-only
179 $ hdiutil convert temp.dmg -format UDZO -o moonshotclientsoftware.dmg
182 The compressed disk image containing the installer package and the READMEs is now in file *moonshotclientsoftware.dmg*