annotate INSTALL.OSX @ 865:debdcc1e03d2

libidn is available on OS X
author Sebastien Decugis <sdecugis@freediameter.net>
date Mon, 22 Oct 2012 08:20:04 +0200
parents 99778f1e2989
children 03d5a7892f2a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
848
6dfa8bc2e71e Added INSTALL.OSX file contributed by Moxie Dee
Sebastien Decugis <sdecugis@freediameter.net>
parents:
diff changeset
1 See INSTALL file for general instructions on building freeDiameter.
6dfa8bc2e71e Added INSTALL.OSX file contributed by Moxie Dee
Sebastien Decugis <sdecugis@freediameter.net>
parents:
diff changeset
2
6dfa8bc2e71e Added INSTALL.OSX file contributed by Moxie Dee
Sebastien Decugis <sdecugis@freediameter.net>
parents:
diff changeset
3 ------------------
6dfa8bc2e71e Added INSTALL.OSX file contributed by Moxie Dee
Sebastien Decugis <sdecugis@freediameter.net>
parents:
diff changeset
4 QUICK INSTRUCTIONS
6dfa8bc2e71e Added INSTALL.OSX file contributed by Moxie Dee
Sebastien Decugis <sdecugis@freediameter.net>
parents:
diff changeset
5 ------------------
6dfa8bc2e71e Added INSTALL.OSX file contributed by Moxie Dee
Sebastien Decugis <sdecugis@freediameter.net>
parents:
diff changeset
6
6dfa8bc2e71e Added INSTALL.OSX file contributed by Moxie Dee
Sebastien Decugis <sdecugis@freediameter.net>
parents:
diff changeset
7 1) Install Homebrew
6dfa8bc2e71e Added INSTALL.OSX file contributed by Moxie Dee
Sebastien Decugis <sdecugis@freediameter.net>
parents:
diff changeset
8
6dfa8bc2e71e Added INSTALL.OSX file contributed by Moxie Dee
Sebastien Decugis <sdecugis@freediameter.net>
parents:
diff changeset
9 ruby -e "$(curl -fsSkL raw.github.com/mxcl/homebrew/go)"
6dfa8bc2e71e Added INSTALL.OSX file contributed by Moxie Dee
Sebastien Decugis <sdecugis@freediameter.net>
parents:
diff changeset
10
6dfa8bc2e71e Added INSTALL.OSX file contributed by Moxie Dee
Sebastien Decugis <sdecugis@freediameter.net>
parents:
diff changeset
11 2) Starting from version 1.1.5, a brew is available for freeDiameter:
6dfa8bc2e71e Added INSTALL.OSX file contributed by Moxie Dee
Sebastien Decugis <sdecugis@freediameter.net>
parents:
diff changeset
12
6dfa8bc2e71e Added INSTALL.OSX file contributed by Moxie Dee
Sebastien Decugis <sdecugis@freediameter.net>
parents:
diff changeset
13 brew install freediameter-server
860
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
14
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
15
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
16 ------------
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
17 FROM SOURCES
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
18 ------------
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
19
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
20 1) Dependencies
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
21 a) install Xcode from App Store
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
22 b) install homebrew (might require to re-install perl and git also)
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
23 c) brew install the following packages:
865
debdcc1e03d2 libidn is available on OS X
Sebastien Decugis <sdecugis@freediameter.net>
parents: 864
diff changeset
24 cmake mercurial gnutls mysql postgresql libidn
860
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
25
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
26 2) Retrieve source folder
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
27 hg clone http://www.freediameter.net/hg/freeDiameter
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
28
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
29 3) Configure your build -- execute from your build folder
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
30 ccmake /path/to/freeDiameter/sources
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
31
865
debdcc1e03d2 libidn is available on OS X
Sebastien Decugis <sdecugis@freediameter.net>
parents: 864
diff changeset
32 (you have to disable SCTP at the moment, before initial configuration)
860
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
33 Example:
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
34 mkdir freeDiameter-build
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
35 cd freeDiameter-build
865
debdcc1e03d2 libidn is available on OS X
Sebastien Decugis <sdecugis@freediameter.net>
parents: 864
diff changeset
36 ccmake -DDISABLE_SCTP:BOOL=ON /path/to/freeDiameter/sources
860
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
37 /* Select 'c' then choose your options, then 'c' again and 'g' */
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
38 make
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
39
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
40 4) make
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
41
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
42 /* note: on my system I have to make a second time for compilation to complete, it seems something is wrong with swig processing order */
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
43
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
44 These instructions have been tested on Mac OS X 10.6.8 (Snow Leopard).
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
45 They should work smoothly on more recent versions as well.
0172278ddafe Updated Mac OS X documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 848
diff changeset
46
"Welcome to our mercurial repository"