[Ida-cvs] htdocs/documentation avapdtut.php,NONE,1.1 daaptut.php,NONE,1.1 fscantut.php,NONE,1.1

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 422-6466

Update of /cvsroot/ida/htdocs/documentation
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv6403/documentation

Added Files:
	avapdtut.php daaptut.php fscantut.php 
Log Message:
added tutorials for ida-fscan, avapd and mDNSResponder.
removed HowTos section
added mailinglistsection for ida-fscan
added News-entry

--- NEW FILE: daaptut.php ---
<? include "header.inc"; ?>

<body>
 <br><br>
 <h1>DAAP compatibility Tutorial</h1>
 <br><br><br>
<p>If you want to use iTunes with the AVAP-Daemon you need the mDNS-Responder which you can download <a href="http://darwinsource.opendarwin.org/tarballs/apsl/mDNSResponder-66.3.tar.gz">here</a>. To extract the archive type</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ tar xvzf mDNSResponder-66.3.tar.gz<br>
 </td></tr>
</table>
<p>Enter the directory mDNSPosix and compile the Responder for linux, you don't need a "./configure"!</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ cd mDNSResponder-66.3/mDNSPosix<br>
 $ make os=linux<br>
 </td></tr>
</table>
<p>To start the mDNSResponder run the following command</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ cd build<br>
 $ ./mDNSResponderPosix -p 3689 -t _daap._tcp. -n 'NAME'&<br>
 </td></tr>
</table>
<p>For NAME you set the name you want the server to appear in iTunes!</p>
<br><br>
<p align="center"><a href="tutorials.php">back</a></p>
</body>

<? include "footer.inc"; ?> 

--- NEW FILE: fscantut.php ---
<? include "header.inc"; ?>

<body>
 <br><br>
 <h1>Ida fscan Tutorial</h1>
 <br><br><br>
 <p>With this programm you can scan a directory for music files and add them into a database. First you have to install postgreSQL and create a database. Ensure that you have "Posix message queues" enabled in your kernel! It's needed to run PostgreSQL. (Normaly it is...) If you are using Debian-Linux get root and install postgresql this way:</p>
 <table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 # apt-get install postgresql postgresql-dev<br>
 </td></tr>
</table>
<p>Then you must give your user the privilege to create databases and create one called avdb.</p>
 <table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 # su postgres<br>
 $ createuser YOURUSER<br>
 $ su YOURUSER<br>
 $ createdb avdb<br>
 </td></tr>
</table>
 <p>For YOURUSER you have to set the name of your normal user with that you later scan the music and start your server.</p>
 <p>Next you need libid3tag that you can download <a href="http://sourceforge.net/project/showfiles.php?group_id=12349" target="_blank">here<a>. To extract it use</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ tar xvzf libid3tag-0.15.1b.tar.gz<br>
 </td></tr>
</table> 
<p>Then enter the new directory and run these commands to compile it</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ cd libid3tag-0.15.1b<br>
 $ ./configure && make<br>
 </td></tr>
</table>
<p>For the installation you need root privileges!</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ su<br>
 Password:<br>
 # make install<br>
 </td></tr>
</table>  
  <p> Now you must download the scanner, for example <a href="http://sourceforge.net/project/showfiles.php?group_id=112400" target="_blank">here</a>. You can choose between a debian package, a bz2-compressed tar archive or a gz-compressed tar archive. To extract the tar.bz2 archive type</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ tar xvjf ida-fscan-0.0.1.tar.bz2<br>
 </td></tr>
</table>
<p>and for the tar.gz archive</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ tar xvzf ida-fscan-0.0.1.tar.gz<br>
 </td></tr>
</table>
<p>Before you can compile the scanner, check that your version of gcc is 3.0 or higher!</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ gcc -v<br>
 gcc version 3.3.4 20040623 (Gentoo Linux 3.3.4-r1, ssp-3.3.2-2, pie-8.7.6)<br>
 </td></tr>
</table>
<p>Then enter the new directory and run these commands to compile the scanner</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ cd ida-fscan-0.0.1<br>
 $ ./configure && make<br>
 </td></tr>
</table>
<p>For the installation you need root privileges again!</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ su<br>
 Password:<br>
 # make install<br>
 </td></tr>
</table>
<p>If you are running a Debian system and don't want to compile the scanner yourself, you can download the debian package and install it (you have to be root).</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 # dpkg -i ida-fscan_0.0.1-1_i386.deb<br>
 </td></tr>
</table>
<p>Now the scanner is installed and executable with the command "ida-fscan".<br>To scan your music postgres must be running and you must have permission to change the database! If you want a short overview of the parameters for ida-fscan type</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ ida-fscan --help<br>
 </td></tr>
</table>
<p>The following command would scan the directory /path/of/my/music and clear the database befor</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ ida-fscan -c /path/of/my/music<br>
 </td></tr>
</table>
<p>This process can take a few minutes!! How long depends on how many files you have to scan!</p>
<br><br>
<p align="center"><a href="tutorials.php">back</a></p>

</body>

<? include "footer.inc"; ?> 

--- NEW FILE: avapdtut.php ---
<? include "header.inc"; ?>

<body>
 <br><br>
 <h1>Ida server daemon Tutorial</h1>
 <br><br><br>
<p>The AVAP-Daemon is the server daemon of Ida. First <a href="http://sourceforge.net/project/showfiles.php?group_id=112400" target="_blank">download</a> the daemon. You can choose between a debian package, a bz2-compressed or a gz-compressed tar archive. To extract the tar.bz2 archive type</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ tar xvjf avapd-0.0.1.tar.bz2<br>
 </td></tr>
</table>
<p>and for the tar.gz archive</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ tar xvzf avapd-0.0.1.tar.gz<br>
 </td></tr>
</table>
<p>Before you can compile the server, check that your version of gcc is 3.0 or higher!</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ gcc -v<br>
 gcc version 3.3.4 20040623 (Gentoo Linux 3.3.4-r1, ssp-3.3.2-2, pie-8.7.6)<br>
 </td></tr>
</table>
<p>Then enter the new directory and run these commands to compile the server</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ cd avapd-0.0.1<br>
 $ ./configure && make<br>
 </td></tr>
</table>
<p>For the installation you need root privileges!</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ su<br>
 Password:<br>
 # make install<br>
 </td></tr>
</table>
<p>If you are running a Debian system and don't want to compile the server yourself, you can download the debian package and install it (you have to be root).</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 # dpkg -i avapd_0.0.1-1_i386.deb<br>
 </td></tr>
</table>
<p>Now the server is installed and executable with the command "avapd". When you want to start the server, ensure that postgres is running and don't forget to start the mDNSResponder if you want to connect with iTunes to the server! To get a list of options use</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ avapd --help<br>
 </td></tr>
</table>
<p>It is recommended to start the server in backround and to define a logfile.</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 $ avapd -b -l LOGFILE.log<br>
 </td></tr>
</table>
<p>It's also usefull to start the server at boot time. So you need a startscript and rc-links on it. Enter the directory where the startscripts are and create a new file called "avapd". Use your favorite editor to do this (vi, vim, nano, ...).</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 # cd /etc/init.d<br>
 # vi avapd<br>
 </td></tr>
</table>
<p>Now copy in the following script.</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
<pre> 
#! /bin/sh
#
#       Written by Alexander Bauer <ale...@us...>
#

PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
DAEMON="avapd -b -v -s
#RESPONDER="/path/to/mDNSResponder-66.3/mDNSPosix/build/mDNSResponderPosix -p 3689 -t _daap._tcp. -n `hostname`&"
NAME=avapd
DESC="Ida server daemon"

case "$1" in
  start)
        echo -n "Starting $DESC: $NAME"
        su ida -c "$DAEMON"
#        su ida -c "$RESPONDER"
        echo "."
        ;;
  stop)
        echo -n "Stopping $DESC: $NAME "
#        killall mDNSResponderPosix
        killall avapd
        echo "."
        ;;
  restart|force-reload)
        #
        #       If the "reload" option is implemented, move the "force-reload"
        #       option to the "reload" entry above. If not, "force-reload" is
        #       just the same as "restart".
        #
        echo -n "Restarting $DESC: $NAME"
#        killall mDNSResponderPosix
        killall avapd
        sleep 1
        su ida -c "$DAEMON"
#        su ida -c "$RESPONDER"
        echo "."
        ;;
  *)
        N=/etc/init.d/$NAME
        # echo "Usage: $N {start|stop|restart|reload|force-reload}" >&2
        echo "Usage: $N {start|stop|restart|force-reload}" >&2
        exit 1
        ;;
esac

exit 0
</pre>
</td></tr>
</table>
<p>If you don't like to use syslog remove the "-s" option of avapd and add "-l YOUR_LOGFILE" instead. Of course you can add any options you want... And if you want the script to start the mDNSResponder for iTunes you must remove the "#" at the beginning of the following lines!</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 <pre>
 #RESPONDER="/path/to/mDNSResponder-66.3/mDNSPosix/build/mDNSResponderPosix -p 3689 -t _daap._tcp. -n `hostname`&"
 #        su ida -c "$RESPONDER"
 #        killall mDNSResponderPosix
 #        killall mDNSResponderPosix
 #        su ida -c "$RESPONDER"</pre>
 </td></tr>
</table>
<p>In the first of these lines you also have to correct the path of the Responder.</p>
<p>Finaly you can run the following command to create the links.</p>
<table border="1" bgcolor="white" cellspacing="0" width="100%">
 <tr><td>
 <pre>
 # ln -s /etc/init.d/avapd /etc/rc0.d/K10avapd &&
   ln -s /etc/init.d/avapd /etc/rc1.d/K10avapd &&
   ln -s /etc/init.d/avapd /etc/rc2.d/S50avapd &&
   ln -s /etc/init.d/avapd /etc/rc3.d/S50avapd &&
   ln -s /etc/init.d/avapd /etc/rc4.d/S50avapd &&
   ln -s /etc/init.d/avapd /etc/rc5.d/S50avapd &&
   ln -s /etc/init.d/avapd /etc/rc6.d/K10avapd</pre>
 </td></tr>
</table>
<p>Now the server is installed and starts up at boot time.</p>
<br><br>
<p align="center"><a href="tutorials.php">back</a></p>
</body>

<? include "footer.inc"; ?> 