Congratulations on your purchase of the WInSAR Data Archive Software System. When properly
cared for, you system will deliver years of faithful service.

In order to properly configure your WInSAR Data Archive Software System, there are
8 simple steps you must take:


1) untar the winsar software and database, and install components to the proper directories
2) untar the thumbnails folder and place it in your data directory
3) edit the db.inc file to point to your winsar server
4) start your MySQL Database Server
5) add a user to the MySQL Database for the website to use
6) install the fast download server
7) start the fast download server
8) configure and restart Apache

The following are detailed instructions on completing these steps:

1) untarring the winsar database

First download the winsar tarball to the root directory of your webserver (this is
most likely /var/www/html/). Once the tar ball is in place, untar it with:

$ tar -xvzf winsar.tar.gz


Next, make sure you have MySQL installed on your computer - this is necessary before
proceeding. On a Redhat system with apt-get, check if it's installed with:

$ rpm -qa | grep mysql

make sure both the 'mysql' and 'mysql-server' packages are in the resulting package list.
if one or both are missing, install them with:

$ apt-get install mysql 
or
$ apt-get install mysql-server

If you are running another Unix OS, installtion instructions may differ.

If both mysql and mysql-server are installed, proceed.

Now, copy the winsar mysql files to your mysql server directory 
(this should be /var/lib/mysql/). These files are stored in the folder labelled 
"winsar" (do not change the name of this folder, as it will break the mysql server):

If the mysql database directory does not exist, create it with

$ mkdir /var/lib/mysql

Now copy the database files:

$ cp -r winsar /var/lib/mysql/


2) untarring the thumbnails folder

Next download the thumbnails tarball. Copy this tarball into your /data directory:

$ cp thumbnails.tar.gz /data

and extract the tarball:

$ tar -xvzf thumbnails.tar.gz


3) editing the db.inc file for configuration of the server

If necessary, move back to your webserver's root directory, where you untarred the winsar database:

$ cd /var/www/html

edit the db.inc file (if you use the emacs editor, the command is) :

$ emacs db.inc

Look for the following line:

  $hostName = "winsar.stanford.edu";

change "winsar.stanford.edu" to reflect your own domain (ie, winsar.caltech.edu). 
Save the file and close it.


4) starting your MySQL database

If you are running redhat, you should be able to start your mysql server with a single
command: 

$ service mysqld start


5) adding the 'php_user' user to the mysql database

Once the mysql database is running, log into it with the following command:

$ mysql -u root mysql

Once logged into the mysql database, add the user 'php_user' with the following
command:

mysql> INSERT INTO user (Host,User,Password,Select_priv,Insert_priv) VALUES 
('yourhost.yourdomain.xxx','php_user',PASSWORD('aaaa'),'Y','Y'); 

where you replace yourhost.yourdomain.xxx with the server running winsar, for 
example: winsar.stanford.edu

after running this mysql command, exit mysql by typing 

mysql> exit; 

then restart the mysqld daemon with:

$ service mysqld restart


6) installing the fast download server

Move back into the winsar database folder:

$ cd /var/www/html

In this folder you will find a subdirectroy named 'PFTLinuxServer'. Move into this 
directory:

$ cd PFTLinuxServer

To learn more about the server, read the INSTALL document included with the server.
Otherwise, follow these quick install instructions. 

First, run the install script:

$ ./install-script

Then, if desired, edit the 'pft.conf' file in /etc:

$ emacs /etc/pft.conf

The default settings should be fine - you can turn on md5 file verification if you
wish, or change the base directory to match the document root of your webserver.
(but once again, the defaults should be fine for winsar)


7) starting the fast download server

Once you've checked over the pft.conf config file, start the fast download client
as you would any other service:

$ service pftserverd start

You can stop the server with 

$ service pftserverd stop

and restart it with

$ service pftserverd restart


8) once all the server components have been installed, make sure apache is 
properly configured to use .htaccess files (which are used to control access to 
some winsar pages). Open /etc/httpd/conf/httpd.conf with your favorite text editor
(I like emacs =)

$ emacs /etc/httpd/conf/httpd.conf

find the directive '<Directory "/var/www/html">  Within this directive tag there
should be an entry like so:

AllowOverride None

change this entry to read:

AllowOverride AuthConfig Limit Options

save the file and exit.

then restart the apache server with the following command:

$ service httpd reload

if it complains that the httpd service isn't running, start it with:

$ service httpd start





That's it! After these steps are complete, WInSAR should be up and running.