Setup GiantDisc Web Interface 1.0
         =====================================

---------
Required
---------

Browser:
  * A bit DHTML
  * JavaScript
  * Flash (optional)

System:
  * Any Linux ?!
  * Standard-Package 'perl'
  * Standard-Package 'sudo'
  * Standard-Package 'findutils'
  * Apache 1.3+ with PHP 4.3+
    (optional module 'mod_rewrite')
    
---------------
Quick Install
---------------

1. Shell    
  tar -zxvf gdwebint-x.y.tar.gz
  cd gdwebint-x.y
  ./setup.pl

2. Apache (PHP, mod_rewrite & httpd.conf)  
  DocumentRoot "/home/music/public_html"
  <Directory "/home/music/public_html">
    AllowOverride All
  </Directory>

3. Sudo (visudo)  
  wwwrun  ALL = (music) NOPASSWD: /home/music/bin/gdwebint.pl

4. php.ini
  file_uploads = On
  upload_max_filesize = 6M
  allow_url_fopen = On
  
5. Launch the Web Interface in your favorite Browser at
   http://yourbox/~music/webint or where ever you installed it.

---------------
Installation
---------------

1. UNPACK & INSTALL

   Unpack the archive file to your document root
   of the webserver and change to the created directory.

       bash> tar -zxvf gdwebint-x.y.tar.gz
       bash> cd gdwebint-x.y
	
   Execute the installation script by typing the following
   command. You will be asked for some values.
       
       bash> ./setup.pl

   You can use "./setup.pl --help" to show all available options.
   
   Note: If you are running setup.pl more than once, a cache
   file is used to store selected options. User --nocache
   option to avoid the saved values.


2. CHECK YOUR SETTINGS

   Edit the data file in the inc-directory and set up
   your details with your favorite text editor.

       bash> cd /home/music/public_html
       bash> vi webint/inc/data.inc.php
	
	Info: This is not needed in normal case because the setup
	script sets all this values.
	
	
3. APACHE CONFIGURATION

   Install your Apache with PHP extension and mod_rewrite!

   Configure you Apache webserver and set a document root,
   e.g. your 'public_html'-folder. For this reason, open your 
   configuration file (usually located in /etc/httpd.conf) and 
   change the following values:

       DocumentRoot "/home/music/public_html"
       
       <Directory "/home/music/public_html">
           AllowOverride All
       </Directory>
  
   Note: To support dynamic filenames, you must enable the
   mod_rewrite-plugin for the Apache!  
       
   And of course you have to install PHP on your system.
   Required packages are:
   
   	 1) apache2, apache2-mod_php4, php4-mysql, php4-session
   	 or 2) apache, apache-mod_php4, php4-mysql, php4-session
   
   The Webint should also work on PHP5.


4. SUDO-SETTINGS

   To start/stop the GiantDisc server script via the web interface
   you need to install the "sudo" package and add the user "wwwrun",
   the web-server user, to the /etc/sudoers file. Use the visudo-command
   to edit this file (as root).
   
		bash> visudo
		
	Add the following lines to this file:

        wwwrun  ALL = (music) NOPASSWD: /home/music/bin/gdwebint.pl
		
		
5. FILE-UPLOADS FOR COVER SUPPORT	
  
   To use the cover-image file upload/download, you need
   to enable this in the php.ini.

   Check if your php.ini allows file uploads and 
   connections to other servers and if the following
   entries are set.

       ; File Uploads	
       file_uploads = On
       upload_max_filesize = 6M

       ; Fopen wrappers	
       allow_url_fopen = On
	

6. OPEN WEB INTERFACE IN BROWSER

   You can now launch the Web Interface in your Browser. After a few
   checks, you can use it to administrate your GiantDisc Music Collection.
      
================================
Philipp Heckel, Jan 2005