************************************************************************************************************************ Installation Instructions ( INDEPENDIENTE Essay Grader Final Release Dec 24,2004. ) ************************************************************************************************************************ Kindly follow these steps for hassle-free installation. A) External Software and Packages --------------------------------- This software uses Linkparser and it's Perl API Lingua::Linkparser. It also uses the Net::Google API and its corressponding allied packages. The software uses Wordnet and it's allied packages also. Following is a comprehensive list of packages used by the system. B) Obtaining softwares and packages --------------------------------- You can obtain the above from the following locations **Software/Package Source 1) URI http://search.cpan.org/ 2) Linkparser http://www.link.cs.cmu.edu/link/ftp-site/link-grammar/link-4.1a/unix/ 3) Lingua::Linkparser http://search.cpan.org/ 4) SOAP::Lite http://search.cpan.org/ 5) Net :: Google http://search.cpan.org/ 6) HTML::Strip http://search.cpan.org/ 7) Text::Context::EitherSide http://search.cpan.org/ 8) String::Similarity http://search.cpan.org/ 9) WordNet http://www.cogsci.princeton.edu/~wn/ 10) WordNet::QueryData; http://search.cpan.org/ 11) WordNet::Similarity::path; http://search.cpan.org/ 12) Lingua::EN::Tagger; http://search.cpan.org/ 13) Lingua::Stem http://search.cpan.org/ 14) Lingua::PT::Stemmer http://search.cpan.org/ 15) Lingua::Stem http://search.cpan.org/ 16) Lingua::Stem::Fr http://search.cpan.org/ 17) Lingua::Stem::It http://search.cpan.org/ 18) Lingua::Stem::Ru http://search.cpan.org/ 19) Lingua::Stem::Snowball http://search.cpan.org/ 20) Memoize::ExpireLRU http://search.cpan.org/ 21) Snowball::Norwegian http://search.cpan.org/ 22) Snowball::Swedish http://search.cpan.org/ 23) Text::German http://search.cpan.org/ 24) Text::Similarity http://search.cpan.org/ 25) HTML::Parser http://search.cpan.org/ 26) HTML::Tagset http://search.cpan.org/ --------------------------------- Note : --------------------------------- ** Depending on platform and current packages installed on a particular system these packages may have additional dependencies ( packages ). Kindly obtain the same from http://search.cpan.org/ and install them. You can manually install these or can use the CPAN installer to do the same for you. C) Installing softwares and packages --------------------------------- 1) It is important that you install the Linkparser in your web directory. Else Apache will not be able to access it. For this unzip and untar the Linkparser package in your www/cgi-bin dir and type make. * Note down this path. 2) Install all other Modules listed above and any of their dependencies in www/cgi-bin directory. IMPORTANT !!! Make sure you install all these modules at the same location in www/cgi-bin ** Note down this path. 3) Install wordnet in any directory. Make sure it has global read permissions . It should at least have a permission of 444. To ensure this you can issue the following commands. chmod -R 755 WordNet-HOME where WordNet-Home is the base directory where WordNet is installed. *** Note down this path. ------- Note:- ------- * In step D) of installation you will have to provide this absolute path when asked for LINK parser path. IMPORTANT !!! Do not specify the relative path. Give the full absolute path. For eg if you have installed the modules at this path /home/uname/www/cgi-bin/LINK enter the path as :- /home/uname/www/cgi-bin/LINK where uname = "Username". ** In step D) use this same path when you use the PREFIX variable . IMPORTANT !!! Do not specify the relative path. Give the full absolute path. eg :- /home/uname/www/cgi-bin/LIB_PATHS *** In step D) use this same path when prompted for the path to WordNet install directory. IMPORTANT !!! Do not specify the relative path. Give the full absolute path. eg :- /home/uname/www/cgi-bin/WordNet-Home D) Installing INDEPENDIENTE essay grader --------------------------------- 1) This software package ships as a single tar.gz file named INDEPENDIENTE-1.00.tar.gz. Copy it in www/cgi-bin.If cgi-bin does not exist create it using the command :- mkdir www/cgi-bin. 2) Now unzip the file using gunzip command :- gunzip INDEPENDIENTE-1.00.tar.gz 3) untar the file using following command :- tar -xvf INDEPENDIENTE-1.00.tar This will create a folder called INDEPENDIENTE-1.00 onto the system. Issue the following command to give global write permissions chmod -R 777 INDEPENDIENTE-1.00 4) Now change Directory to INDEPENDIENTE-1.00/Modules using the command :- cd INDEPENDIENTE-1.00/Modules Run the command perl Makefile.PL PREFIX=""; Note the has to be the full path name not relative.( Angular brackets not to be included) Eg perl Makefile.PL PREFIX="/home/tpederse/www/cgi-bin/LIB_PATHS"; Note :- has to be the same path used in step(C) subsection 2) 5) The script will ask you "Enter the path where Link Parser is installed: " Enter correctly the full path name of the directory in which Linkparser is installed. eg /home/uname/www/cgi-bin/LINK Note :- The path name has to be the same as used in step (C) subsection 1). 5) The script will ask you "Enter the path where WordNet is installed: " Enter correctly the full path name of the directory in which WordNet is installed. eg /home/uname/www/cgi-bin/WordNet-Home Note :- The path name has to be the same as used in step (C) subsection 3). 6) Type make. 7) Type make install. 8) After this the software should install on your system successfully. E) General Preca utions ------------------- Before running the system make sure that you have correctly set the read-write-execute permissions on the entire INDEPENDIENTE directory. Also check that Apache has all the rights to manipulate this directory. If this does not work give ownership rights to the user under which Apache is running. ( Avoiding this step make cause permission problems for file creation/deletions and would render the system defunct). ************************************************************************************************************************ Running the system ************************************************************************************************************************ 1) Goto your favourite web browser . Type in the following URL http://localhost/cgi-bin/INDEPENDIENTE-1.00/Web/createlogin.cgi "localhost" can be substituted by the hostname of the system . eg if the hostname = www.d.umn.edu/~bhumk001 then the URL will be http://www.d.umn.edu/~bhumk001/cgi-bin/INDEPENDIENTE-1.00/Web/createlogin.cgi To view the log for all the graded essays create admin login with username ="admin" 2) On pressing this URL directs you to the initial screen of the software. This screen displays a links for navigation and information about the system. To begin writing a new essay click on the Link tiltled "New Essay". 3) This would then direct you to the essay writing screen. You will be shown a prompt .Please type in your essay as you would in a normal text editor. Upon completion press . 4) This directs you to the last screen. This screen shows you the entire essay you typed and the displays those sentences which the software detects as irrelevant , gibberish.It also shows the facts identified by the system and facts which are verifiable.Your final score will also be displayed in the top left corner.( Refer to the documentation for an explanation of these terms ). 5) At the bottom of the screen is a link to developer mode output which you can use to see the descriptive developer output. ************************************************************************************************************************ Special Case ************************************************************************************************************************ Lingua::Linkparser might give a segmentation fault when the system is run for the first time. If this occurs simply re-install Lingua::Linkparser in the same location . ************************************************************************************************************************ SUPPORT ************************************************************************************************************************ Send an email to the following people in case of any problems during this process. Make sure to describe the problem in your email as comprehensively as possible. Kedar Bhumkar kedtv@rediffmail.com Saiyam Kohli saiyamkohli@gmail.com ************************************************************************************************************************