doc: trim chapters/installation.texi to move some very old
authorng0 <ng0@infotropique.org>
Thu, 7 Sep 2017 13:47:14 +0000 (13:47 +0000)
committerng0 <ng0@infotropique.org>
Thu, 7 Sep 2017 13:47:14 +0000 (13:47 +0000)
instructions into an "archive" file.

doc/Makefile.am
doc/chapters/installation.texi
doc/outdated-and-old-installation-instructions.txt [new file with mode: 0644]

index 1e5a123212c9c8459f5b3fa79c8a536c2abf6161..72c07349619cefac59d8df3616188a58f85813f8 100644 (file)
@@ -75,7 +75,8 @@ gnunet_TEXINFOS = \
 EXTRA_DIST = \
        $(gnunet_TEXINFOS) \
        $(gnunet_doc_images) \
-       $(gnunet_tutorial_examples)
+       $(gnunet_tutorial_examples) \
+       outdated-and-old-installation-instructions.txt
 
 version.texi:
        echo "@set UPDATED $(date +'%d %B %Y')" > $@
index be458981fa165ecef1eb4c8a69b006c2db2c157c..edbad84dec6aab5a7d37130b906252b52ea872e9 100644 (file)
@@ -1190,15 +1190,14 @@ and Postgres better resillience.
 This chapter contains a collection of outdated, older installation guides. They
 are mostly intended to serve as a starting point for writing up-to-date
 instructions and should not be expected to work for GNUnet 0.10.x.
+A set of older installation instructions can also be found in the
+@file{doc/outdated-and-old-installation-instructions.txt} in the source
+of GNUnet. This file covers old instructions which no longer receive
+security updates or any kind of support.
 
 
 @menu
 * Installing GNUnet 0.10.1 on Ubuntu 14.04::
-* Build instructions for FreeBSD 8::
-* Basic installation for Mac OS X::
-* Basic Installation for Fedora/PlanetLab nodes running Fedora 12::
-* Basic Installation for Fedora/PlanetLab nodes running Fedora 8 .::
-* Build instructions for Gentoo::
 * Building GLPK for MinGW::
 * GUI build instructions for Ubuntu 12.04 using Subversion::
 * Installation with gnunet-update::
@@ -1297,508 +1296,6 @@ After installing it, you need to create an empty configuration file:@
 And finally you can start GNUnet with@
 @code{$ gnunet-arm -s}
 
-
-@node Build instructions for FreeBSD 8
-@subsection Build instructions for FreeBSD 8
-
-To get GNUnet 0.9 to compile on FreeBSD (at least FreeBSD 8.0):@ in order to
-install the library @code{libiconv}, at first change the directory to your
-ports directory, e.g.@
-@code{@
- $ cd /usr/ports/@
-}@
- following that, go to the install file of @code{libiconv} and install it,@
-@code{@
- $ cd converters/libiconv,@
- $ make install@
-}
-
-after that, change the directory to where you will check out
-@code{libextractor} and GNUnet, and install latest @code{libextractor},@
- first of all, checkout @code{libextractor}, e.g.@
-@code{@
- $ svn co https://gnunet.org/svn/Extractor@
-}@
- then change the directory into which it was checked out, e.g.@
-@code{@
- $ cd Extractor@
-}@
- before the installation, you should do following steps,@
-
-@example
-$ ./bootstrap@
-$ ./configure --with-ltdl-include=/usr/local/include \
-  --with-ltdl-lib=/usr/local/lib@
-@end example
-
-if these steps complete successfully, you can install the library,@
-
-@example
-$ make install@
-@end example
-
-to check out the GNUnet, you should do the similar steps as
-@code{libextractor}, firstly, change back to starting directory, e.g.@
-@code{@
- $ cd ../@
-}@
- Set the following environmental variables:@
-@code{@
- export CPPFLAGS="-I/usr/local/include"@
- export LDFLAGS="-L/usr/local/lib"@
-}@
- next, checkout GNUnet using@
-@code{@
- $ svn co https://gnunet.org/svn/gnunet@
-}@
- then change directory into newly checked out directory,@
-@code{@
- $ cd gnunet@
-}@
- at last, start to install GNUnet,@
-
-@example
- $ ./bootstrap@
- $ ./configure --with-ltdl-include=/usr/local/include \
-   --with-ltdl-lib=/usr/local/lib --with-extractor=/usr/local
-
-## NOTE: you may not need the --with-extractor option!@
-
-$ make install
-@end example
-
-@node Basic installation for Mac OS X
-@subsection Basic installation for Mac OS X
-
-This documentation may be outdated!
-
-This page is providing guidelines for users trying to install GNUnet on Mac OS
-X.@ Mainly users trying to install GNUnet by building source code are the most
-welcome readers.@ The steps below are tested on an Intel Architecture running
-Mac OS X Tiger (10.4.11). Ideally they should work on other Mac boxes with
-different configurations as all the configuration done for it is dependent on
-@uref{http://www.macports.org/, MacPorts}
-
-For having GNUnet installed successfully, some dependencies should be firstly
-resolved:
-
-@itemize @bullet
-
-@item
-Install/Update your @uref{http://developer.apple.com/tools/xcode/, Xcode}
-version 3.2.1 or later for Snow Leopard, 3.1.4 or later for Leopard, or 2.5 for
-Tiger. 
-
-@item
-Download and install @uref{http://www.macports.org/, MacPorts}.@
-Now you are ready for installing GNunet dependencies. 
-
-@item
-First, you'd better make sure that: /opt/local/bin and /opt/local/sbin are
-available in your PATH. (For doing so, open a terminal and type:@
-
-@example 
-$ echo $PATH 
-@end example
-
-and examine the output of it). If the paths are not available in your
-environment, you have to add them (You can add them by editing your .profile
-file in your home directory, append them to the PATH line). Then type:
-@example
-$ source ~/.profile
-@end example
-
-and re-examine the echo command output.
-
-@item
-Use MacPorts to download and install the dependencies:@
-The libraries are: 
-
-@itemize @bullet
-
-@item
-@uref{http://trac.macports.org/browser/trunk/dports/www/libmicrohttpd/Portfile, libmicrohttpd.}
-
-@item
-@uref{http://trac.macports.org/browser/trunk/dports/devel/libgcrypt/Portfile, libgcrypt.}
-
-@item
-@uref{http://trac.macports.org/browser/trunk/dports/net/curl/Portfile, libcurl.}
-
-@item
-@uref{http://trac.macports.org/browser/trunk/dports/devel/libtool/Portfile, libltdl.}
-
-@item
-@uref{http://trac.macports.org/browser/trunk/dports/databases/sqlite3/Portfile, SQlite.}
-
-@item
-libunistring 
-
-@item
-glpk 
-
-@end itemize
-
-The port command is as follows:@
-@example
-port install libmicrohttpd libgcrypt curl libtool sqlite3 linunistring glpk
-@end example
-One of the dependencies, the libextractor, should be explicitly installed,
-since the version available from macports is outdated to work with GNUnet. To
-install the latest libextractor:
-@itemize @bullet
-
-
-@item
-Install the Subversion Client:@
-For more information about Subversion visit:
-@uref{http://subversion.tigris.org/, http://subversion.tigris.org/}
-
-@example
-# port install subversion
-@end example
-
-
-@item
-Use Subversion to download the latest Extractor: 
-@example
-$ svn checkout https://gnunet.org/svn/Extractor
-@end example
-
-
-@item
-Go to the installation directory of the Extractor, compile and install it: 
-@example
-$ ./bootstrap
-$ export CPPFLAGS="-I/opt/local/include"
-$ export  LDFLAGS="-L/opt/local/lib" 
-$ ./configure --prefix=/opt/local
-$ make
-# make install
-@end example
-
-@end itemize
-
-
-@item
-Now, your system is ready to install GNunet. If you downloaded GNUnet by
-checking it out from svn, you should start by running the bootstrap script.
-Open a terminal pointing to the GNUnet directory and type:@
-
-@example
-$ ./bootstrap
-@end example
-
-
-@item
-Run the configure script: 
-@example
-$ export CPPFLAGS="-I/opt/local/include" 
-$ export LDFLAGS="-L/opt/local/lib" 
-$ ./configure --prefix=/tmp/gnunet_build
-@end example
-
-
-GNUnet will be installed in the directory /tmp/gnunet_build (Of course that
-installation path can be changed).@ The CPPFLAGS and LDFLAGS are mentioned in
-order to inform the compiler and the linker to lookup headers and libraries in
-/opt/local/include and /opt/local/lib.
-
-@item
-Compile@
-
-@example
-$ make
-@end example
-
-
-@item
-Install GNUnet 
-@example
-# make install
-@end example
-
-@end itemize
-
-@node Basic Installation for Fedora/PlanetLab nodes running Fedora 12
-@subsection Basic Installation for Fedora/PlanetLab nodes running Fedora 12
-
-
-@strong{This documentation is outdated and not valid for GNUnet 0.10.0!}@
-
-GNUnet installation on Fedora 8/Planetlab nodes can be done as following:
-
-1. Install the build tools to build GNUnet@
-@example
-sudo yum -y -t --nogpgcheck install gcc make autoconf gettext-devel \
-texinfo subversion@
-@end example
-
-2. Install the GNUnet dependencies@
-@example
-sudo yum -y -t --nogpgcheck install libunistring-devel libunistring-devel \
-libgcrypt-devel zlib-devel sqlite-devel postgresql-devel mysql-devel \
-libgsf-devel libvorbis-devel@
-@end example
-
-3. Install outdated dependencies from source@
-libtool@
-@example
-wget http://ftp.gnu.org/gnu/libtool/libtool-2.4.2.tar.gz@
-tar xvfz libtool-2.4.2.tar.gz@
-cd libtool-2.4.2@
-./configure@
-sudo make install@
-@end example
-
-glpk@
-@example
-wget http://ftp.gnu.org/gnu/glpk/glpk-4.47.tar.gz@
-tar xvfz glpk-4.47.tar.gz@
-cd glpk-4.47@
-./configure@
-sudo make install@
-@end example
-
-libcurl@
-@example
-wget http://curl.haxx.se/download/curl-7.26.0.tar.gz@
-tar xvfz curl-7.26.0.tar.gz@
-cd curl-7.26.0@
-./configure@
-sudo make install@
-@end example
-
-4. Install libextractor@
-@example
-svn co https://gnunet.org/svn/libextractor@
-cd libextractor@
-libtoolize@
-./bootstrap@
-./configure@
-sudo make install@
-@end example
-
-5. Install libmicrohttpd@
-@example
-svn co https://gnunet.org/svn/libmicrohttpd@
-cd libmicrohttpd@
-libtoolize@
-./bootstrap@
-./configure@
-sudo make install@
-@end example
-
-6. Set GNUnet prefix and add to PATH@
-@example
-export GNUNET_PREFIX=@
-export PATH=$PATH:$GNUNET_PREFIX/bin@
-@end example
-
-7. Install GNUnet from svn@
-@example
-export LD_LIBRARY_PATH=/usr/local/lib@
-svn co https://gnunet.org/svn/gnunet@
-cd gnunet@
-libtoolize@
-./bootstrap@
-./configure --prefix=$GNUNET_PREFIX --with-extractor=/usr \
- --with-mysql=/usr/lib/mysql --enable-logging=verbose@
-make install@
-@end example
-
-Done!
-
-@node Basic Installation for Fedora/PlanetLab nodes running Fedora 8 .
-@subsection Basic Installation for Fedora/PlanetLab nodes running Fedora 8 .
-@c %**end of header
-
-@strong{This documentation is outdated and not valid for GNUnet 0.10.0!}@
- GNUnet installation on Fedora 8/Planetlab nodes can be done as following:
-
-1. Install the build tools to build GNUnet@
-@example
-sudo yum -y -t --nogpgcheck install gcc make automake autoconf gettext-devel \
-texinfo zlib-devel subversion@
-@end example
-
-2. Install the GNUnet dependencies@
-@example
-sudo yum -y -t --nogpgcheck install gnutls-devel gnutls-devel libgcrypt-devel \
-sqlite-devel postgresql-devel mysql-devel libgsf-devel libvorbis-devel \
-libidn-devel
-@end example
-
-3. Install outdated dependencies from source@
- libtool@
-@code{@
- wget http://ftp.gnu.org/gnu/libtool/libtool-2.4.2.tar.gz@
- tar xvfz libtool-2.4.2.tar.gz@
- cd libtool-2.4.2@
- ./configure@
- sudo make install@
-}
-
-libtool@
-@code{@
- wget http://ftp.gnu.org/gnu/libtool/libtool-2.4.2.tar.gz@
- tar xvfz libtool-2.4.2.tar.gz@
- cd libtool-2.4.2@
- ./configure@
- sudo make install@
-}
-
-glpk@
-@code{@
- wget http://ftp.gnu.org/gnu/glpk/glpk-4.47.tar.gz@
- tar xvfz glpk-4.47.tar.gz@
- cd glpk-4.47@
- ./configure@
- sudo make install@
-}
-
-libgpg-error@
-@code{@
- wget ftp://ftp.gnupg.org/gcrypt/libgpg-error/libgpg-error-1.10.tar.bz2@
- tar xvfj libgpg-error-1.10.tar.bz2@
- cd libgpg-error-1.10@
- ./configure --prefix=/usr@
- sudo make install@
-}
-
-libgcrypt@
-@code{@
- wget ftp://ftp.gnupg.org/gcrypt/libgcrypt/libgcrypt-1.5.0.tar.bz2@
- tar xvfj libgcrypt-1.5.0.tar.tar.bz2@
- cd libgcrypt-1.5.0@
- ./configure --prefix=/usr@
- sudo make install@
-}
-
-libcurl@
-@code{@
- wget http://curl.haxx.se/download/curl-7.26.0.tar.gz@
- tar xvfz curl-7.26.0.tar.gz@
- cd curl-7.26.0@
- ./configure@
- sudo make install@
-}
-
-libunistring@
-@code{@
- wget http://ftp.gnu.org/gnu/libunistring/libunistring-0.9.3.tar.gz@
- tar xvfz libunistring-0.9.3.tar.gz@
- cd libunistring-0.9.3@
- ./configure@
- sudo make install@
-}
-
-4. Remove conflicting packages@
-@code{@
- sudo rpm -e --nodeps libgcrypt libgpg-error@
-}
-
-4. Install libextractor@
-@code{@
- wget ftp://ftp.gnu.org/gnu/libextractor/libextractor-0.6.3.tar.gz@
- tar xvfz libextractor-0.6.3.tar.gz@
- cd libextractor-0.6.3@
- ./configure@
- sudo make install@
-}
-
-5. Install libmicrohttpd and dependencies
-
-nettle@
-@code{@
- wget http://ftp.gnu.org/gnu/nettle/nettle-2.5.tar.gz@
- tar xvfz nettle-2.5.tar.gz@
- cd nettle-2.5@
- ./configure@
- sudo make install@
-}
-
-GnuTLS@
-@code{@
- wget http://ftp.gnu.org/gnu/gnutls/gnutls-2.12.20.tar.bz2@
- tar xvfj gnutls-2.12.20.tar.bz2@
- cd gnutls-2.12.20@
- ./configure --without-p11-kit@
- sudo make install@
-}
-
-libmicrohttpd@
-@code{@
- wget ftp://ftp.gnu.org/gnu/libmicrohttpd/libmicrohttpd-0.9.21.tar.gz@
- tar xvfz libmicrohttpd-0.9.21.tar.gz@
- cd libmicrohttpd-0.9.21@
- ./configure@
- sudo make install@
-}
-
-6. Set GNUnet prefix and add to PATH@
-@code{@
- export GNUNET_PREFIX=@
- export PATH=$PATH:$GNUNET_PREFIX/bin@
-}
-
-7. Install GNUnet from svn@
-@example
- export LD_LIBRARY_PATH=/usr/local/lib@
- svn co https://gnunet.org/svn/gnunet@
- cd gnunet@
- libtoolize@
- ./bootstrap@
- ./configure --prefix=$GNUNET_PREFIX --with-extractor=/usr/local \
- --with-curl=/usr/local --with-mysql=/usr/lib/mysql --enable-logging=verbose@
- make install@
-@end example
-
-Done!
-
-@node Build instructions for Gentoo
-@subsection Build instructions for Gentoo
-
-
-This page describes how to install GNUnet 0.9 on Gentoo.
-
-Since the GNUnet 0.9 ebuilds are not in the official portage tree yet, we need
-to add them to the local portage overlay. All the commands below should be
-executed as root.
-
-Specify your local portage directory in the /etc/make.conf, for example:@
-@code{$ echo 'PORTDIR_OVERLAY="/usr/local/portage"' >> /etc/make.conf}
-
-Create directories for the ebuilds:@
-@code{$ mkdir -p /usr/local/portage/media-libs/libextractor /usr/local/portage/net-p2p/gnunet/files}
-
-Download the latest ebuilds, init and config files from here and put them into
-respective directories:@
-@code{$ cp libextractor-0.6.2.ebuild /usr/local/portage/media-libs/libextractor@
- $ cp gnunet-0.9.2.ebuild /usr/local/portage/net-p2p/gnunet@
- $ cp gnunet-0.9.2.conf gnunet-0.9.2.confd gnunet-0.9.2.initd /usr/local/portage/net-p2p/gnunet/files}
-
-Generate Manifest files for the ebuilds:@
-@code{$ cd /usr/local/portage/net-p2p/gnunet@
- $ ebuild gnunet-0.9.2.ebuild digest@
- $ cd /usr/local/portage/media-libs/libextractor@
- $ ebuild libextractor-0.6.2.ebuild digest}
-
-Unmask GNUnet and dependencies in the /etc/portage/package.keywords. For
-example, if you use x86-64 architecture, add the following lines:@
-@code{net-p2p/gnunet ~amd64@
- media-libs/libextractor ~amd64@
- net-libs/libmicrohttpd ~amd64@
- net-misc/curl ~amd64}
-
-Add either sqlite or mysql USE-flag in the /etc/portage/package.use:@
-@code{net-p2p/gnunet sqlite}
-
-Now everything is ready to install GNUnet:@
-@code{$ emerge -av gnunet}
-
-Use /etc/init.d/gnunet to start/stop GNUnet.
-
 @node Building GLPK for MinGW
 @subsection Building GLPK for MinGW
 
diff --git a/doc/outdated-and-old-installation-instructions.txt b/doc/outdated-and-old-installation-instructions.txt
new file mode 100644 (file)
index 0000000..f2cbe18
--- /dev/null
@@ -0,0 +1,672 @@
+# This file contains pieces from chapter/installation.texi for systems where the LTS or otherwise support
+# ended. They can be useful for people trying to write new installation instructions for those systems.
+# In particual this covers:
+# - FreeBSD 8
+# - Mac OS X Tiger
+# - Fedora 8
+# - Gentoo with GNUnet 0.9
+#
+# Sources for LTS and support ranges:
+# https://www.freebsd.org/security/security.html#sup
+# https://support.microsoft.com/en-us/help/17140/lifecycle-faq-general-policy-questions
+# Mac products, OS is supposedly similar (no official statements exist): https://web.archive.org/web/20160706101225/https://support.apple.com/en-us/HT201624
+# https://wiki.debian.org/LTS
+# https://www.ubuntu.com/info/release-end-of-life
+
+@node Build instructions for Gentoo
+@subsection Build instructions for Gentoo
+
+
+This page describes how to install GNUnet 0.9 on Gentoo.
+
+Since the GNUnet 0.9 ebuilds are not in the official portage tree yet, we need
+to add them to the local portage overlay. All the commands below should be
+executed as root.
+
+Specify your local portage directory in the /etc/make.conf, for example:@
+@code{$ echo 'PORTDIR_OVERLAY="/usr/local/portage"' >> /etc/make.conf}
+
+Create directories for the ebuilds:@
+@code{$ mkdir -p /usr/local/portage/media-libs/libextractor /usr/local/portage/net-p2p/gnunet/files}
+
+Download the latest ebuilds, init and config files from here and put them into
+respective directories:@
+@code{$ cp libextractor-0.6.2.ebuild /usr/local/portage/media-libs/libextractor@
+ $ cp gnunet-0.9.2.ebuild /usr/local/portage/net-p2p/gnunet@
+ $ cp gnunet-0.9.2.conf gnunet-0.9.2.confd gnunet-0.9.2.initd /usr/local/portage/net-p2p/gnunet/files}
+
+Generate Manifest files for the ebuilds:@
+@code{$ cd /usr/local/portage/net-p2p/gnunet@
+ $ ebuild gnunet-0.9.2.ebuild digest@
+ $ cd /usr/local/portage/media-libs/libextractor@
+ $ ebuild libextractor-0.6.2.ebuild digest}
+
+Unmask GNUnet and dependencies in the /etc/portage/package.keywords. For
+example, if you use x86-64 architecture, add the following lines:@
+@code{net-p2p/gnunet ~amd64@
+ media-libs/libextractor ~amd64@
+ net-libs/libmicrohttpd ~amd64@
+ net-misc/curl ~amd64}
+
+Add either sqlite or mysql USE-flag in the /etc/portage/package.use:@
+@code{net-p2p/gnunet sqlite}
+
+Now everything is ready to install GNUnet:@
+@code{$ emerge -av gnunet}
+
+Use /etc/init.d/gnunet to start/stop GNUnet.
+
+
+
+
+@node Basic Installation for Fedora/PlanetLab nodes running Fedora 8 .
+@subsection Basic Installation for Fedora/PlanetLab nodes running Fedora 8 .
+@c %**end of header
+
+@strong{This documentation is outdated and not valid for GNUnet 0.10.0!}@
+ GNUnet installation on Fedora 8/Planetlab nodes can be done as following:
+
+1. Install the build tools to build GNUnet@
+@example
+sudo yum -y -t --nogpgcheck install gcc make automake autoconf gettext-devel \
+texinfo zlib-devel subversion@
+@end example
+
+2. Install the GNUnet dependencies@
+@example
+sudo yum -y -t --nogpgcheck install gnutls-devel gnutls-devel libgcrypt-devel \
+sqlite-devel postgresql-devel mysql-devel libgsf-devel libvorbis-devel \
+libidn-devel
+@end example
+
+3. Install outdated dependencies from source@
+ libtool@
+@code{@
+ wget http://ftp.gnu.org/gnu/libtool/libtool-2.4.2.tar.gz@
+ tar xvfz libtool-2.4.2.tar.gz@
+ cd libtool-2.4.2@
+ ./configure@
+ sudo make install@
+}
+
+libtool@
+@code{@
+ wget http://ftp.gnu.org/gnu/libtool/libtool-2.4.2.tar.gz@
+ tar xvfz libtool-2.4.2.tar.gz@
+ cd libtool-2.4.2@
+ ./configure@
+ sudo make install@
+}
+
+glpk@
+@code{@
+ wget http://ftp.gnu.org/gnu/glpk/glpk-4.47.tar.gz@
+ tar xvfz glpk-4.47.tar.gz@
+ cd glpk-4.47@
+ ./configure@
+ sudo make install@
+}
+
+libgpg-error@
+@code{@
+ wget ftp://ftp.gnupg.org/gcrypt/libgpg-error/libgpg-error-1.10.tar.bz2@
+ tar xvfj libgpg-error-1.10.tar.bz2@
+ cd libgpg-error-1.10@
+ ./configure --prefix=/usr@
+ sudo make install@
+}
+
+libgcrypt@
+@code{@
+ wget ftp://ftp.gnupg.org/gcrypt/libgcrypt/libgcrypt-1.5.0.tar.bz2@
+ tar xvfj libgcrypt-1.5.0.tar.tar.bz2@
+ cd libgcrypt-1.5.0@
+ ./configure --prefix=/usr@
+ sudo make install@
+}
+
+libcurl@
+@code{@
+ wget http://curl.haxx.se/download/curl-7.26.0.tar.gz@
+ tar xvfz curl-7.26.0.tar.gz@
+ cd curl-7.26.0@
+ ./configure@
+ sudo make install@
+}
+
+libunistring@
+@code{@
+ wget http://ftp.gnu.org/gnu/libunistring/libunistring-0.9.3.tar.gz@
+ tar xvfz libunistring-0.9.3.tar.gz@
+ cd libunistring-0.9.3@
+ ./configure@
+ sudo make install@
+}
+
+4. Remove conflicting packages@
+@code{@
+ sudo rpm -e --nodeps libgcrypt libgpg-error@
+}
+
+4. Install libextractor@
+@code{@
+ wget ftp://ftp.gnu.org/gnu/libextractor/libextractor-0.6.3.tar.gz@
+ tar xvfz libextractor-0.6.3.tar.gz@
+ cd libextractor-0.6.3@
+ ./configure@
+ sudo make install@
+}
+
+5. Install libmicrohttpd and dependencies
+
+nettle@
+@code{@
+ wget http://ftp.gnu.org/gnu/nettle/nettle-2.5.tar.gz@
+ tar xvfz nettle-2.5.tar.gz@
+ cd nettle-2.5@
+ ./configure@
+ sudo make install@
+}
+
+GnuTLS@
+@code{@
+ wget http://ftp.gnu.org/gnu/gnutls/gnutls-2.12.20.tar.bz2@
+ tar xvfj gnutls-2.12.20.tar.bz2@
+ cd gnutls-2.12.20@
+ ./configure --without-p11-kit@
+ sudo make install@
+}
+
+libmicrohttpd@
+@code{@
+ wget ftp://ftp.gnu.org/gnu/libmicrohttpd/libmicrohttpd-0.9.21.tar.gz@
+ tar xvfz libmicrohttpd-0.9.21.tar.gz@
+ cd libmicrohttpd-0.9.21@
+ ./configure@
+ sudo make install@
+}
+
+6. Set GNUnet prefix and add to PATH@
+@code{@
+ export GNUNET_PREFIX=@
+ export PATH=$PATH:$GNUNET_PREFIX/bin@
+}
+
+7. Install GNUnet from svn@
+@example
+ export LD_LIBRARY_PATH=/usr/local/lib@
+ svn co https://gnunet.org/svn/gnunet@
+ cd gnunet@
+ libtoolize@
+ ./bootstrap@
+ ./configure --prefix=$GNUNET_PREFIX --with-extractor=/usr/local \
+ --with-curl=/usr/local --with-mysql=/usr/lib/mysql --enable-logging=verbose@
+ make install@
+@end example
+
+Done!
+
+
+@node Build instructions for FreeBSD 8
+@subsection Build instructions for FreeBSD 8
+
+To get GNUnet 0.9 to compile on FreeBSD (at least FreeBSD 8.0):@ in order to
+install the library @code{libiconv}, at first change the directory to your
+ports directory, e.g.@
+@code{@
+ $ cd /usr/ports/@
+}@
+ following that, go to the install file of @code{libiconv} and install it,@
+@code{@
+ $ cd converters/libiconv,@
+ $ make install@
+}
+
+after that, change the directory to where you will check out
+@code{libextractor} and GNUnet, and install latest @code{libextractor},@
+ first of all, checkout @code{libextractor}, e.g.@
+@code{@
+ $ svn co https://gnunet.org/svn/Extractor@
+}@
+ then change the directory into which it was checked out, e.g.@
+@code{@
+ $ cd Extractor@
+}@
+ before the installation, you should do following steps,@
+
+@example
+$ ./bootstrap@
+$ ./configure --with-ltdl-include=/usr/local/include \
+  --with-ltdl-lib=/usr/local/lib@
+@end example
+
+if these steps complete successfully, you can install the library,@
+
+@example
+$ make install@
+@end example
+
+to check out the GNUnet, you should do the similar steps as
+@code{libextractor}, firstly, change back to starting directory, e.g.@
+@code{@
+ $ cd ../@
+}@
+ Set the following environmental variables:@
+@code{@
+ export CPPFLAGS="-I/usr/local/include"@
+ export LDFLAGS="-L/usr/local/lib"@
+}@
+ next, checkout GNUnet using@
+@code{@
+ $ svn co https://gnunet.org/svn/gnunet@
+}@
+ then change directory into newly checked out directory,@
+@code{@
+ $ cd gnunet@
+}@
+ at last, start to install GNUnet,@
+
+@example
+ $ ./bootstrap@
+ $ ./configure --with-ltdl-include=/usr/local/include \
+   --with-ltdl-lib=/usr/local/lib --with-extractor=/usr/local
+
+## NOTE: you may not need the --with-extractor option!@
+
+$ make install
+@end example
+
+
+
+@node Basic installation for Mac OS X
+@subsection Basic installation for Mac OS X
+
+This documentation may be outdated!
+
+This page is providing guidelines for users trying to install GNUnet on Mac OS
+X.@ Mainly users trying to install GNUnet by building source code are the most
+welcome readers.@ The steps below are tested on an Intel Architecture running
+Mac OS X Tiger (10.4.11). Ideally they should work on other Mac boxes with
+different configurations as all the configuration done for it is dependent on
+@uref{http://www.macports.org/, MacPorts}
+
+For having GNUnet installed successfully, some dependencies should be firstly
+resolved:
+
+@itemize @bullet
+
+@item
+Install/Update your @uref{http://developer.apple.com/tools/xcode/, Xcode}
+version 3.2.1 or later for Snow Leopard, 3.1.4 or later for Leopard, or 2.5 for
+Tiger. 
+
+@item
+Download and install @uref{http://www.macports.org/, MacPorts}.@
+Now you are ready for installing GNunet dependencies. 
+
+@item
+First, you'd better make sure that: /opt/local/bin and /opt/local/sbin are
+available in your PATH. (For doing so, open a terminal and type:@
+
+@example 
+$ echo $PATH 
+@end example
+
+and examine the output of it). If the paths are not available in your
+environment, you have to add them (You can add them by editing your .profile
+file in your home directory, append them to the PATH line). Then type:
+@example
+$ source ~/.profile
+@end example
+
+and re-examine the echo command output.
+
+@item
+Use MacPorts to download and install the dependencies:@
+The libraries are: 
+
+@itemize @bullet
+
+@item
+@uref{http://trac.macports.org/browser/trunk/dports/www/libmicrohttpd/Portfile, libmicrohttpd.}
+
+@item
+@uref{http://trac.macports.org/browser/trunk/dports/devel/libgcrypt/Portfile, libgcrypt.}
+
+@item
+@uref{http://trac.macports.org/browser/trunk/dports/net/curl/Portfile, libcurl.}
+
+@item
+@uref{http://trac.macports.org/browser/trunk/dports/devel/libtool/Portfile, libltdl.}
+
+@item
+@uref{http://trac.macports.org/browser/trunk/dports/databases/sqlite3/Portfile, SQlite.}
+
+@item
+libunistring 
+
+@item
+glpk 
+
+@end itemize
+
+The port command is as follows:@
+@example
+port install libmicrohttpd libgcrypt curl libtool sqlite3 linunistring glpk
+@end example
+One of the dependencies, the libextractor, should be explicitly installed,
+since the version available from macports is outdated to work with GNUnet. To
+install the latest libextractor:
+@itemize @bullet
+
+
+@item
+Install the Subversion Client:@
+For more information about Subversion visit:
+@uref{http://subversion.tigris.org/, http://subversion.tigris.org/}
+
+@example
+# port install subversion
+@end example
+
+
+@item
+Use Subversion to download the latest Extractor: 
+@example
+$ svn checkout https://gnunet.org/svn/Extractor
+@end example
+
+
+@item
+Go to the installation directory of the Extractor, compile and install it: 
+@example
+$ ./bootstrap
+$ export CPPFLAGS="-I/opt/local/include"
+$ export  LDFLAGS="-L/opt/local/lib" 
+$ ./configure --prefix=/opt/local
+$ make
+# make install
+@end example
+
+@end itemize
+
+
+@item
+Now, your system is ready to install GNunet. If you downloaded GNUnet by
+checking it out from svn, you should start by running the bootstrap script.
+Open a terminal pointing to the GNUnet directory and type:@
+
+@example
+$ ./bootstrap
+@end example
+
+
+@item
+Run the configure script: 
+@example
+$ export CPPFLAGS="-I/opt/local/include" 
+$ export LDFLAGS="-L/opt/local/lib" 
+$ ./configure --prefix=/tmp/gnunet_build
+@end example
+
+
+GNUnet will be installed in the directory /tmp/gnunet_build (Of course that
+installation path can be changed).@ The CPPFLAGS and LDFLAGS are mentioned in
+order to inform the compiler and the linker to lookup headers and libraries in
+/opt/local/include and /opt/local/lib.
+
+@item
+Compile@
+
+@example
+$ make
+@end example
+
+
+@item
+Install GNUnet 
+@example
+# make install
+@end example
+
+@end itemize
+
+
+@node Basic Installation for Fedora/PlanetLab nodes running Fedora 12
+@subsection Basic Installation for Fedora/PlanetLab nodes running Fedora 12
+
+
+@strong{This documentation is outdated and not valid for GNUnet 0.10.0!}@
+
+GNUnet installation on Fedora 8/Planetlab nodes can be done as following:
+
+1. Install the build tools to build GNUnet@
+@example
+sudo yum -y -t --nogpgcheck install gcc make autoconf gettext-devel \
+texinfo subversion@
+@end example
+
+2. Install the GNUnet dependencies@
+@example
+sudo yum -y -t --nogpgcheck install libunistring-devel libunistring-devel \
+libgcrypt-devel zlib-devel sqlite-devel postgresql-devel mysql-devel \
+libgsf-devel libvorbis-devel@
+@end example
+
+3. Install outdated dependencies from source@
+libtool@
+@example
+wget http://ftp.gnu.org/gnu/libtool/libtool-2.4.2.tar.gz@
+tar xvfz libtool-2.4.2.tar.gz@
+cd libtool-2.4.2@
+./configure@
+sudo make install@
+@end example
+
+glpk@
+@example
+wget http://ftp.gnu.org/gnu/glpk/glpk-4.47.tar.gz@
+tar xvfz glpk-4.47.tar.gz@
+cd glpk-4.47@
+./configure@
+sudo make install@
+@end example
+
+libcurl@
+@example
+wget http://curl.haxx.se/download/curl-7.26.0.tar.gz@
+tar xvfz curl-7.26.0.tar.gz@
+cd curl-7.26.0@
+./configure@
+sudo make install@
+@end example
+
+4. Install libextractor@
+@example
+svn co https://gnunet.org/svn/libextractor@
+cd libextractor@
+libtoolize@
+./bootstrap@
+./configure@
+sudo make install@
+@end example
+
+5. Install libmicrohttpd@
+@example
+svn co https://gnunet.org/svn/libmicrohttpd@
+cd libmicrohttpd@
+libtoolize@
+./bootstrap@
+./configure@
+sudo make install@
+@end example
+
+6. Set GNUnet prefix and add to PATH@
+@example
+export GNUNET_PREFIX=@
+export PATH=$PATH:$GNUNET_PREFIX/bin@
+@end example
+
+7. Install GNUnet from svn@
+@example
+export LD_LIBRARY_PATH=/usr/local/lib@
+svn co https://gnunet.org/svn/gnunet@
+cd gnunet@
+libtoolize@
+./bootstrap@
+./configure --prefix=$GNUNET_PREFIX --with-extractor=/usr \
+ --with-mysql=/usr/lib/mysql --enable-logging=verbose@
+make install@
+@end example
+
+Done!
+
+
+@node Basic Installation for Fedora/PlanetLab nodes running Fedora 8 .
+@subsection Basic Installation for Fedora/PlanetLab nodes running Fedora 8 .
+@c %**end of header
+
+@strong{This documentation is outdated and not valid for GNUnet 0.10.0!}@
+ GNUnet installation on Fedora 8/Planetlab nodes can be done as following:
+
+1. Install the build tools to build GNUnet@
+@example
+sudo yum -y -t --nogpgcheck install gcc make automake autoconf gettext-devel \
+texinfo zlib-devel subversion@
+@end example
+
+2. Install the GNUnet dependencies@
+@example
+sudo yum -y -t --nogpgcheck install gnutls-devel gnutls-devel libgcrypt-devel \
+sqlite-devel postgresql-devel mysql-devel libgsf-devel libvorbis-devel \
+libidn-devel
+@end example
+
+3. Install outdated dependencies from source@
+ libtool@
+@code{@
+ wget http://ftp.gnu.org/gnu/libtool/libtool-2.4.2.tar.gz@
+ tar xvfz libtool-2.4.2.tar.gz@
+ cd libtool-2.4.2@
+ ./configure@
+ sudo make install@
+}
+
+libtool@
+@code{@
+ wget http://ftp.gnu.org/gnu/libtool/libtool-2.4.2.tar.gz@
+ tar xvfz libtool-2.4.2.tar.gz@
+ cd libtool-2.4.2@
+ ./configure@
+ sudo make install@
+}
+
+glpk@
+@code{@
+ wget http://ftp.gnu.org/gnu/glpk/glpk-4.47.tar.gz@
+ tar xvfz glpk-4.47.tar.gz@
+ cd glpk-4.47@
+ ./configure@
+ sudo make install@
+}
+
+libgpg-error@
+@code{@
+ wget ftp://ftp.gnupg.org/gcrypt/libgpg-error/libgpg-error-1.10.tar.bz2@
+ tar xvfj libgpg-error-1.10.tar.bz2@
+ cd libgpg-error-1.10@
+ ./configure --prefix=/usr@
+ sudo make install@
+}
+
+libgcrypt@
+@code{@
+ wget ftp://ftp.gnupg.org/gcrypt/libgcrypt/libgcrypt-1.5.0.tar.bz2@
+ tar xvfj libgcrypt-1.5.0.tar.tar.bz2@
+ cd libgcrypt-1.5.0@
+ ./configure --prefix=/usr@
+ sudo make install@
+}
+
+libcurl@
+@code{@
+ wget http://curl.haxx.se/download/curl-7.26.0.tar.gz@
+ tar xvfz curl-7.26.0.tar.gz@
+ cd curl-7.26.0@
+ ./configure@
+ sudo make install@
+}
+
+libunistring@
+@code{@
+ wget http://ftp.gnu.org/gnu/libunistring/libunistring-0.9.3.tar.gz@
+ tar xvfz libunistring-0.9.3.tar.gz@
+ cd libunistring-0.9.3@
+ ./configure@
+ sudo make install@
+}
+
+4. Remove conflicting packages@
+@code{@
+ sudo rpm -e --nodeps libgcrypt libgpg-error@
+}
+
+4. Install libextractor@
+@code{@
+ wget ftp://ftp.gnu.org/gnu/libextractor/libextractor-0.6.3.tar.gz@
+ tar xvfz libextractor-0.6.3.tar.gz@
+ cd libextractor-0.6.3@
+ ./configure@
+ sudo make install@
+}
+
+5. Install libmicrohttpd and dependencies
+
+nettle@
+@code{@
+ wget http://ftp.gnu.org/gnu/nettle/nettle-2.5.tar.gz@
+ tar xvfz nettle-2.5.tar.gz@
+ cd nettle-2.5@
+ ./configure@
+ sudo make install@
+}
+
+GnuTLS@
+@code{@
+ wget http://ftp.gnu.org/gnu/gnutls/gnutls-2.12.20.tar.bz2@
+ tar xvfj gnutls-2.12.20.tar.bz2@
+ cd gnutls-2.12.20@
+ ./configure --without-p11-kit@
+ sudo make install@
+}
+
+libmicrohttpd@
+@code{@
+ wget ftp://ftp.gnu.org/gnu/libmicrohttpd/libmicrohttpd-0.9.21.tar.gz@
+ tar xvfz libmicrohttpd-0.9.21.tar.gz@
+ cd libmicrohttpd-0.9.21@
+ ./configure@
+ sudo make install@
+}
+
+6. Set GNUnet prefix and add to PATH@
+@code{@
+ export GNUNET_PREFIX=@
+ export PATH=$PATH:$GNUNET_PREFIX/bin@
+}
+
+7. Install GNUnet from svn@
+@example
+ export LD_LIBRARY_PATH=/usr/local/lib@
+ svn co https://gnunet.org/svn/gnunet@
+ cd gnunet@
+ libtoolize@
+ ./bootstrap@
+ ./configure --prefix=$GNUNET_PREFIX --with-extractor=/usr/local \
+ --with-curl=/usr/local --with-mysql=/usr/lib/mysql --enable-logging=verbose@
+ make install@
+@end example
+
+Done!
+
+