Installation Guide
 

Student Records Software has three tier architecture.
Main Requirements to run the software are as following;

Front End : Secure Web server suporting Java Servlets,
Middle Tier : Student Records Package, i.e. studentrecords.tar.gz
Back End : Relational Database such as Oracle or mSQL. A JDBC bridge, such as mSQL JDBC Bridge is required)

After finding necceassary web server and database with JDBC bridge follow the below instructions.

  1. Download Student Records package, i.e. studentrecords.tar.gz (Temporarily available here.)

  2. On Unix platform run the following commands on unix command line;
    
      gunzip studentrecords.tar.gz
      tar xvf studentrecords.tar
    
    On PC use an unzip utility program to open the files.

  3. Move the directory studentrecords whereever you want to put in your web server

  4. This part depends how you are configuring servlets in your web server. When defining your web server servlet definitions, include studentrecords/classes directory in the Java CLASSPATH before running servlets. In other words, gs package in the classes directory is the servlet to be defined in your web server.Also include JDBC bridge classes in your CLASSPATH.

  5. Before running servlets, Student Records Classes, through your web server, edit the YOUR_ROOT_PATH/ studentrecords/classes/conf/configuration.dat file.
    This is the only file you need to edit to run the software depending on package. In this file you may define many files for logs, errors, accesses, JDBC bridges, database passwords, etc. Please note that the format of the file is as following. Each tag is followed by its value in the next line. If you do not want to enter any value for a tag, leave the next line blank; do not type another tag in this line.

    Note that the HTDOCS' default value, which is "HtdocsGrdSys/", should be kept for the current templates.

    Please get the licence key from Mehmet Sen and include it in the configuration file before running the system.

  6. Define database tables. ( See table specifications here)

  7. Run the web server.

    Run your servlet with the definition of configuration file in the command line, e.g.,

    java -Dconf=~/studentrecords/classes/conf/configuration.dat servlet.class ...
    (This will provide student record classes to find the necessary configuration file)

  8. Edit the line following the line "REPLACE ACTION URL AT BELOW LINE" in studentrecords/HtdocsGrdSys/grading.html The form's action line should start with your your web server address followed by servlet name you defined. An example is "https://class-server.npac.syr.edu:8888/myservlet/gs.admin .gAdmin/HtdocsGrdSys/admin/access.html?"

    Edit the line following the line "REPLACE LINK URL AT BELOW LINE" in studentrecords/HtdocsGrdSys/students.html The form's action line should start with your your web server address followed by servlet name you defined. An example is "https://class-server.npac.syr.edu:8888/myservlet/gs.admin .gCourses/HtdocsGrdSys/admin/courseselectionSTUDENT .html?comm=STUDENT&unum=student&title=none"

  9. Point your URL to

    studentrecords/HtdocsGrdSys/grading.html for instructur use (as default in configuration.dat file) or
    studentrecords/HtdocsGrdSys/students.html for students use (as default in configuration.dat file)

  10. Change the administrator password, which is previously defined in the configuration.dat file.

Please send the problems with installation to msen7@npac.syr.edu


[home]