readme.txt

Eledge开放学习管理系统.这个软件提供一个框架来创建一个用于在线教育的web网站.包括学生注册

  Also added popup windows to the Quiz, Exam and Homework servlets to avoid accidental student
  submission of web form assignments by typing a carriage return in Internet Explorer.
  Fixed some coding errors in the PeerReview servlet.

New in version 1.5:
  Fixed some minor bugs in the ManageExam, ManageHomework and ManageQuiz servlets.
  Fixed a minor HTML coding error that caused MyProfile to fail with text-only browsers
  Made better use of the CharHider class to deal with apostrophes embedded in quiz questions/answers.

New in version 1.4:
  Added a new Journal servlet that allows students to maintain an electronic journal in
  the class database.  The associated ManageJournal servlet allows the instructor to
  read and review student journal entries, and to provide comments and feedback.

New in version 1.3:
  The flexibility of user IDs has been improved.  You can either use an n-digit Student ID
  number (specify the length with the idLength parameter in Course.java), or by setting
  Course.idLength=0, the program will accept characters (usernames or email addresses) as the
  unique identifier for the students.  Several minor bug fixes were included, and the 
  operation of the ManageContent servlet's file upload utility was improved.  The PeerReview
  servlet works, but pages are large and it needs additional management functionality to work
  properly.
  
New in version 1.2:
  I added a PeerReview servlet (beta release) with associated ManagePeerReviews servlet for
  performing student peer reviews of each other's reports.  Also added a sendmail utility to
  the Email servlet (for instructor use only).  Fixed several minor bugs and started to make
  the user ID system more flexible (but this needs more work).



Setup instructions (assumes that Java 2 JDK, servlet engine and MySQL database programs 
are installed and running properly):

(NOTE: If you are running linux, you might want to check out the eledge-utils package
that has just been released. It contains a suite of shell scripts, including a 
"configure.sh" and "install.sh" script for the utils, that greatly simplify the 
process of creating, updating, and deleting courses. If you're using some other
*nix OS, the script(s) may or may not function properly; they will be expanded to
other *nix OS's later. If you're a windows user, I may eventually get around to 
writing some batch files to do the job for you, but, I'm not making any promises.)

Identify the root directory for your servlet runner.  I use Tomcat4, and on my
server I use the root directory /usr/local/tomcat/webapps/ROOT
Create the following new directories to hold static html files and servlet class files.
in this example, suppose that I am creating directories for a course called ART-1010:

  /usr/local/tomcat/webapps/ROOT/ART-1010                    (static html files)
  /usr/local/tomcat/webapps/ROOT/ART-1010/images             (image files for this course)
  /usr/local/tomcat/webapps/ROOT/ART-1010/content            (static instructional content)
  /usr/local/tomcat/webapps/ROOT/ART-1010/uploads            (student file uploads)
  /usr/local/tomcat/webapps/ROOT/WEB-INF/classes/ART-1010    (servlet class files)

Unzip the eledge distribution file and put the index.html file into the ../ROOT/ART-1010
directory.  Edit this file and replace the word Eledge with ART-1010.  This page is only
a refresh page to create a simple URL for the course: http://servername.edu/ART-1010/

Put the servlets into the ART-1010 servlet directory by extracting them from the jar file:
%> jar -xvf eledge-2.0-src.jar /usr/local/tomcat/webapps/ROOT/WEB-INF/classes/ART-1010

You should now see about 50 Java source files in this directory.  Move updateDB.java to 
/usr/local/tomcat/webapps/ROOT/WEB-INF/classes.  Edit every file (except updateDB.java) and 
replace the word Eledge in the first line (package Eledge;) with ART-1010.  This package statement links
all of the servlet class files together and creates unique instances of the servlets for
each course, e.g.,
  http://servername.edu/servlet/ART-1010.Gradebook
  http://servername.edu/servlet/CHEM1220.Gradebook

HINT: to save time editing, create a keyboard macro to do this task.  For example, if you
use the vi editor in unix or Linux, you can open all of the servlet source code files with
  %>vi *.java
Then create a recursive keystroke remapping by typing
  :map ; :s/Eledge/ART-1010^M:wn^M=
  :map = ;
The ^M character (carriage return) is created by typing the sequence CTRL-V CTRL-M.
The single keystroke ";" will then be remapped to a sequence that replaces the string Eledge
with the new string ART-1010 on the first line of the file, then writes the file, then
moves to the next open file, then runs itself again (because the "=" key is mapped to ";"
in the second map command).  When vi runs out of files, the error message causes the 
recursive macro to terminate.  The second remapping is required because vi prevents the
user from using the remapped key as the last character in the keystroke sequence.

The Course.java servlet needs some extra editing. Make certain that you have edited the
lines in this file to indicate the correct course name, webserver name, outgoing mail
server name, mysql server name, mysql username, mysql password, content directory path, 
and uploads directory path. The mysql username and password are used internally by the 
servlets to communicate with the database.  Neither the students nor the instructor will 
know or use these values. If you use SSL (recommended to keep passwords, student data and 
scores secure), edit the secureLoginURL so that it begins with https:// instead of http://

Locate the mm.mysql-2.0.7-bin.jar file (or download the most current stable version, currently 3.0, from mysql.com).
This contains the JDBC Driver class files required to make the connection between your 
Java servlets and the MySQL database server. The Java servlets make use of this Driver class 
at runtime.  Therefore, it is necessary to put this jar file into your classpath where both the
Java runtime environment (JRE) and the servlet runner program (e.g., tomcat) can find it. You
can do this by editing the $CLASSPATH environment variable (yours and the user that runs the
servlet runner, e.g., root).  Alternatively, you can sometimes place the jar file into the
.../jre/lib/ext directory to accomplish this automatically.

Compile all of the servlets by first switching to the classes directory:
%> cd /usr/local/tomcat/webapps/ROOT/WEB-INF/classes
%> javac ART-1010/*.java 

Next, you should create the class database and grant permissions to the servlets to read/write
to it.  If you specified the user/password in Course.java to be Art1010User and h8VanGho, then start the
mysql client program, connect to the MySQL database and type the commands:
mysql> CREATE DATABASE ART-1010;
mysql> GRANT ALL ON ART-1010.* TO Art1010User IDENTIFIED BY 'h8VanGho';

NEW IN VERSION 3.1.0

in the /usr/local/tomcat/webapps/ROOT/WEB-INF/classes/ directory, compile the updateDB.java file, 
and run java updateDB ART-1010

(You may safely ignore any error messages about the ManagePeerReview table not existing.
 Please report any other error messages to the help forum at http://sourceforge.net/projects/eledge)

At this point you should be ready to start building the course by pointing a browser to
http://servername.edu/ART-1010  or
http://servername.edu/servlet/ART-1010.Home

As you instantiate each servlet, it creates the database tables that it needs and usually puts
some placeholder content in each one to demonstrate typical or intended use.  If you are logged
in as the instructor, then the look and feel of each page is similar to that for students, 
except that each page has a button or link near the bottom of the page labelled 'Instructor Only'.
Pressing this will lead to another page that is used to customize the content for your course.