|
||
| Spring Quarter 1997 | Project Team: | |
| Project Sponsor: | Alp Sendil | (Manager) |
| Gregory Abowd | Enda Sullivan | (Architect) & (QA) |
| Bob Sumner | (Programmer) | |
| Lynn Bacher | (Technical Writer) | |
As outlined in the Requirements Document the following platforms are needed to implement the DNA project. The installation is split into three sections; Learning Process/Fractal Generation, CGI Script, and Web Interface. Each section has a separate installation process.
The install directory which can be found at ~www/classes/cs3302_97_spring/projects/team8/install/ contains the following files:
This section contains instructions on how to install the Learning Process/Fractal Generation part of the system. This code is contained learn.tar.gz . The following instructions are also included in a file called learn.README.
You will need to know:
Note:
:0
* FRACTAL_VOTE
| rsh COMPUTER LEARNHOME/doit
replacing COMPUTER with the name of the computer on which you
want to render the fractals (an SGI), and replacing LEARNHOME
with the directory in which you are installing the learning
part of the code (i.e., the learn.tar.gz directory).
PATH=/usr/bin:/usr/ucb:/bin:/usr/local/bin:.
:0
* FRACTAL_VOTE
| rsh COMPUTER LEARNHOME/doit
replacing COMPUTER with the name of the computer on which you
want to render the fractals (an SGI), and replacing LEARNHOME
with the directory in which you are installing the learning
part of the code (i.e., the learn.tar.gz directory).
"|IFS=' ' && exec /usr/local/bin/procmail -f- || exit 75 #USERNAME"
where USERNAME is replaced with your username. If procmail is
installed in a directory other than /usr/local/bin, change that
to the directory in which procmail is installed.
This section contains instructions on how to install the CGI Script part of the system. This code is contained cgi.tar.gz . The following instructions are also included in a file called cgi.README.
To install this application, you will need 2 directories. Each of the 2 directories has a different URL's. One directory is specifically for the CGI part of the project. The other is for the actual files which the CGI script is using.
The INSTALL program which you will run in a moment, will configure all of the necessary variables in the scripts. In general its paths are specified in the top of the scripts, and then variables are joined to those definitions to create full paths. So for example, both CGI scripts have a variable called WWW_HOME which is the path to the directory which contains the root of the web pages.
If necessary, you can modify these variables at a later time. In addition there are other variables which are defined at the top of each file. These variables modify the behavior of the scripts. For example, in showpage, you will find the MAX_VOTES variable, which tells the page when it is busy. If you change MAX_VOTES to 0, then the page will always show busy. This variable is also defined in the count.votes script. If you plan to change how many votes it will take to generate new images, BOTH of these variables must be changed.
Other variables of interest in the count.votes script include,
To install this part of the application, you will first make a directory where your CGI files will be kept. Note that this directory must be able to get to the main web space. The web page files ( web.tar.gz ) and these files ( cgi.tar.gz ) must be on a machine where both directories can be mounted via NSF or some other method.
Once you have found the directory, and it has permission to run CGI off the server, make a directory and copy the cgi.tar.gz file into it. Then type:
gunzip -c cgi.tar.gz | tar xf -
Once this is complete you should have the following files / directories:
INSTALL - Setup program to install this part README - A copy of this installation guide section count.votes - This is the script which runs each time votes are submitted on the web page. filelock.pl - This is a library which allows the scripts to lock the voting files to prevent 2 users from messing up the same file. showpage - This is the script which actually shows the page. Or generates a error message if the page is currently turned off.
Next run INSTALL. Follow the instructions and it will guide you through the installation process.
This section contains instructions on how to install the Web Interface part of the system. This code is contained web.tar.gz . The following instructions are also included in a file called web.README.
The INSTALL program in this directory will prompt you for the new full URL to the location of your files. It will then go through all necessary web pages and modify the hardwired URL's.
You may wonder why we didn't just use relative URL's. Since the CGI is actually on a different machine from the pages that would be impossible.
You will need the full URL to the location of the files.
To install this part of the application, you will first make a directory where your web files will be kept. Typically this will be a directory which the CGI web server can mount. You will make a directory there, and you will copy the archive to that directory. Next you will unarchive all files into that directory. You do this by typing:
gunzip -c web.tar.gz | tar xf -Once this is complete you should have the following files / directories:
INSTALL - Setup program to install this part README - A copy of this installation guide section graphics - Directory which contains all the pictures in the page. index.html - Main index.html - just a forward link to cgi/showpage instructions.html - Instructions page. old - Directory which contains all old generations voting - Directory where all data files are stored winner.html - The winning image.Next run INSTALL. Follow the instructions and it will guide you through the installation process.
The DNA project pages can be viewed from the following systems that are running Netscape 3.0 or Internet Explorer 3.0 and above:
You access the DNA project via a web page. Currently the main page is located on the College of Computing's internal web server. Type the following URL into your browser's Location bar:
http://www-int.cc.gatech.edu/cgi-bin/projects/DNA-cgi/showpage
The initial web page is the voting page. On the voting page, the you will see nine fractal images. From these images you are able to choose your top three favorites. You are only allowed to make three selections. You can cast all of your votes toward one image. In Figure 1, a screen shot of the voting page is shown.
Figure 1.
You then choose your favorites by selecting the image you like under the "First Choice", "Second Choice", and "Third Choice" list boxes. When finished, click on the "submit" button. You will then see a new screen pop up. This screen tells you how many more votes are needed until a new generation of images is created.
After five sets of votes have been received, the image generation process starts. A screen appears preventing you from submitting votes. As soon as the generation is complete, the main window will reappear.
While you are waiting for the new images to generate, you can also view the history page. This page shows previous generations and the winning images from each. By clicking on a smaller image, you can view the entire generation.
Once the generation is complete, the main voting page returns with new selections available to be judged. You can now cast votes again. At the same time, the "winning" image (the one with the most votes) is sent to a separate webpage where it can be displayed for viewing. This image is currently displayed at the following URL:
http://www-int.cc.gatech.edu/projects/DNA/winner.html
There is also a tool bar at the bottom of the main voting page. See below. The buttons can be clicked on to go to other locations. The first button is the "Help" button. Click on this button to view more detailed instructions.
The second button is the Reload button. By clicking you reload the current page.
The third button takes you to the "winning page". At this location, you can view a large version of the image that received the most votes.
The fourth and last button takes you to the History page when you click on it.
We envision a framed screen that hangs on the wall. The image is constantly being refreshed so that you will always see the new images as they are generated.
DNA Home Page
Last Modified 5/30/97 -- C. Lynn Bacher
(lynn@cc.gatech.edu)
