X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fmanual%2Finstall.xml;h=74de545b0e15b783bb3547c68504cba6657ea905;hb=130d356c840ea83c31c4724c8ae92660360eb07b;hp=a64b38462badb7135792e58c2af1173ab9fcd705;hpb=530376ceef7d0d5e4187dbf7246bd217782d9e5a;p=netatalk.git diff --git a/doc/manual/install.xml b/doc/manual/install.xml index a64b3846..74de545b 100644 --- a/doc/manual/install.xml +++ b/doc/manual/install.xml @@ -1,7 +1,7 @@ - 24.8.2012 + 4.8.2013 Installation @@ -12,8 +12,6 @@ !!! - - How to obtain Netatalk @@ -54,8 +52,7 @@ Solaris package: http://www.blastwave.org/ - + url="http://www.opencsw.org/packages/CSWnetatalk/">http://www.opencsw.org/ FreeBSD ports: http://www.freebsd.org/ports/index.html @@ -99,44 +96,36 @@ Git Downloading the Git repository can be done quickly and - easily. + easily: Make sure you have Git installed. which git should produce a path to git. - $> which git + $ which git /usr/bin/git - - If you don't have one make a source directory. - cd to this directory. - - $> mkdir /path/to/new/source/dir -$> cd /path/to/new/source/dir - - Now get the source: - $> git clone git://git.code.sf.net/p/netatalk/code netatalk-code + $ git clone -b develop git://git.code.sf.net/p/netatalk/code netatalk-code Initialized empty Git repository in /path/to/new/source/dir/netatalk/.git/ remote: Counting objects: 2503, done. ... - This will create a local directory called "netatalk-code" - containing a complete and fresh copy of the whole Netatalk source - from the Git repository. + This will create a local directory called + netatalk-code containing a complete and fresh + copy of the whole Netatalk source from the Git repository. In order to keep your repository copy updated, occasionally run: - $> git pull + $ git pull @@ -145,11 +134,13 @@ remote: Counting objects: 2503, done. configure script required in the next step. - $> ./bootstrap + $ ./bootstrap - + For futher information refer to this wiki + page. @@ -167,28 +158,9 @@ remote: Counting objects: 2503, done. Berkeley DB BDB - Berkeley DB . - - At the time of writing, the following versions are - supported: - - - - minimum 4.6.x - - - - In case Berkeley DB is not installed on your system, please - download it from: - - - http://www.oracle.com/technetwork/products/berkeleydb/downloads/index.html - - and follow the installation - instructions. + At the time of writing you need at least version 4.6. @@ -211,6 +183,18 @@ remote: Counting objects: 2503, done. it's functionality. + + Tracker for Spotlight + Spotlight + support + + Netatalk uses Tracker as the + metadata backend. Recent Linux distributions will provide the + libtracker-sparql library which is available since Tracker version + 0.7. + + mDNSresponderPOSIX or Avahi for Bonjour (aka Zeroconf) @@ -220,12 +204,6 @@ remote: Counting objects: 2503, done. Avahi must be build with DBUS support ( --enable-dbus). - - You can download Avahi from: http://www.avahi.org/. - - You can download mDNSresponder from: http://opensource.apple.com/tarballs/mDNSResponder/. @@ -237,9 +215,6 @@ remote: Counting objects: 2503, done. Security options are: access control per host, domain and/or service; detection of host name spoofing or host address spoofing; booby traps to implement an early-warning system. - - TCP Wrappers can be downloaded from: ftp://ftp.porcupine.org/pub/security/ @@ -257,10 +232,6 @@ remote: Counting objects: 2503, done. Microsystems. Linux-PAM is a suite of shared libraries that enable the local system administrator to choose how applications authenticate users. - - You can get the Linux PAM documentation and sources from - http://www.kernel.org/pub/linux/libs/pam/. @@ -271,9 +242,6 @@ remote: Counting objects: 2503, done. built in conversions for, like ISO-8859-1. On glibc systems, Netatalk can use the glibc provided iconv implementation. Otherwise you can use the GNU libiconv implementation. - - You can download GNU libiconv from: http://www.gnu.org/software/libiconv/. @@ -294,7 +262,7 @@ remote: Counting objects: 2503, done. automatically configure Netatalk for your operating system. If you have unusual needs, then you may wish to run - $> ./configure --help + $ ./configure --help to see what special options you can enable. @@ -319,25 +287,72 @@ remote: Counting objects: 2503, done. Now run configure with any options you need - $> ./configure [arguments] + $ ./configure [arguments] Configure will end up in an overview showing the settings the Netatalk Makefiles have been created with. + + + + Spotlight<indexterm> + <primary>Spotlight</primary> + </indexterm> + + Netatalk uses Gnome Tracker as the + metadata backend. The minimum required version is 0.7 as that's the + first version to support SPARQL. + + If not already installed, install the packages + tracker and tracker-devel, + on Solaris install OpenCSW and then install + the Tracker package from the OpenCSW unstable repository. + + The tracker packages are found via pkg-config, you may have to + pass the version suffix as you may have a newer version installed then + the default 0.12, eg + + $ pkg-config --list-all | grep tracker +tracker-extract-0.16 tracker-extract - Tracker : A library to develop metadata extractors for 3rd party file types. +tracker-sparql-0.16 tracker-sparql - Tracker : A library to perform SPARQL queries and updates in the Tracker Store +tracker-miner-0.16 tracker-miner - A library to develop tracker data miners + + So: - If this step fails please visit the troubleshooting - guide. + $ ./configure --with-tracker-pkgconfig-version=0.16 ... + + If you're using Solaris and Tracker from OpenCSW, then you need + to set the PKG_CONFIG_PATH environment variable, add the + --with-tracker-prefix configure option and add + LDFLAGS="-R/opt/csw/lib" + + PKG_CONFIG_PATH=/opt/csw/lib/pkgconfig LDFLAGS="-R/opt/csw/lib" ./configure --with-tracker-prefix=/opt/csw --with-tracker-pkgconfig-version=0.16 ... + + Check the configure output whether the Tracker libs were + found: + + checking for TRACKER... yes +checking for TRACKER_MINER... yes +... +Configure summary: +... + AFP: + Spotlight: yes +... + + + + Compile and install Next, running - $> make + $ make should produce the Netatalk binaries (this step can take several minutes to complete). When the process finished you can use - $> make install + $ make install to install the binaries and documentation (must be done as "root" when using default locations).