Recommended practices for

Course Web Pages


Table of Contents

  1. Introduction
  2. Recommendations
  3. How To...
    1. Open your Departmental Account
    2. Create the Web Document Directory
    3. Create a Course Directory
    4. Give (or Take Away) Instructors' Write Access to a Course Directory
    5. Link to a conference or bulletin board
  4. Other Security Measures
  5. References


Introduction

The World Wide Web can be a good way to distribute course-related information, such as syllabi, homework assignments, and homework solutions. In this document, LTS recommends practices for organizing and administering course-related web pages.

This document addresses the following questions:

Back to top


Recommendations

  1. We recommend that a department named dept (that is, a department whose abbreviation in course listings is dept) use an account with the name indept.
    How to Open your Departmental Account
  2. We recommend that a department store all of its course related web pages in the www-data directory of its indept AFS account. This way, the URL for the department's pages starts with http://www.lehigh.edu/~indept
    How to Create the Web Document Directory
  3. We recommend that directories for courses be subdirectories in the www-data directory. This way, for example, pages for course dept001 will have a URL which starts with http://www.lehigh.edu/~indept/dept001
    How to Create a Course Directory
  4. We recommend that professors, instructors and teaching assistants be placed in an AFS group which has write permissions to the course directories. This is preferrable to granting permissions directly to individuals, and to having multiple individuals logging directly into the departmental account.
    How to Give (or Take Away) Instructors' Write Access to a Course Directory

Information Resources offers these recommendations to suggest a uniform organization for course web pages. If all course web pages were organized in this manner, students and faculty would know where to look for a given course web page without having to ask the instructor.

Back to top


How To...

Following are steps for carrying out the recommendations listed above.

Back to top


How to Open your Departmental Account

A form must be filled out and signed. This form can be found in the Information Resources Client Services office (8-3990), or can be found online.

The form gives a choice for the name of the account. Again, our recommendation is that a department named dept (that is, a department whose abbreviation in course listings is dept) use an account with the name indept.

Naturally, if your account is already open, you need not do this.

Back to top


How to Create the Web Document Directory

If the web document directory www-data already exists, you need not do this.

Log into http://www.lehigh.edu/account using your departmental account, and click on the option W3Setup. You will be asked to enter the account password again, and then the script will post its results to the top of the page.

Creating/checking web directory ...
Done.
Setting AFS permissions ...
Done.
Creating default home page ...
Done.
Default home page created.
Your home page is the file:
/afs/cc.lehigh.edu/home/indept/public/www-data/indept.html.
The URL for this page is:
http://www.lehigh.edu/~indept/indept.html.

Back to top


How to Create a Course Directory

Log into one of the Compute Servers using your departmental account and run the command courseweb adddir directory, where directory specifies the directory to be created for the course. (This command can also be run from a shell prompt on the Network Server.)

After logging in as indept:
CS4:/home/indept>courseweb adddir dept001
Permissions set in directory public/www-data so that
only the web server and administrators can read files...
Subdirectory dept001 of public/www-data created...
Permissions set in directory dept001...
group indept:dept001 has id -457
AFS group indept:dept001 created or verified...
AFS group indept:dept001 given write access to dept001...
Subdirectory closed of dept001 created...
AFS group indept:dept001 given write access to directory
dept001/closed...
Web access to directory dept001/closed restricted
to members of AFS group indept:dept001.
Script completed.
CS4:/home/indept>

If the directory already exists, courseweb will not overwrite it, but it will change permissions to make the directory secure. courseweb also plays some other tricks which are mentioned in the printout above, and are described later in this document.

Back to top


How to Give (or Take Away) Instructors' Write Access to a Course Directory

Log into one of the Compute Servers using your departmental account. To give an instructor write access to a course directory, use the command courseweb adduser user directory

After logging in as indept:
CS4:/home/indept>courseweb adduser abc0 dept001
User abc0 added to AFS group indept:dept001...
User abc0 given write access to directory dept001...
User abc0 given web access to closed subdirectory of dept001...
Script completed.
CS4:/home/indept>

To list who has access to a course directory, use the command courseweb showusers directory

After logging in as indept:
CS4:/home/indept>courseweb showusers dept001
Members of indept:dept001 (id: -457) are:
abc0
Script completed.
CS4:/home/indept>

To take away an instructor's write access to the course directory, remove the instructor from the group using the command courseweb removeuser user directory

After logging in:
CS4:/home/indept>courseweb removeuser abc0 dept001
User abc0 removed from AFS group indept:dept001...
Write access to directory dept001 taken away from user abc0...
Web access to closed subdirectory of dept001 taken away from
user abc0...
Script completed.
CS4:/home/indept>

Other options are available with the courseweb command. Usage information is provided if the courseweb command is run without options specified. Back to top


Other Security Measures

You may want to restrict access to certain areas in your web page, to Lehigh computers, to valid Lehigh Users (ones with valid Lehigh IDs and passwords), or by using class passwords. To do this, see the instructions in Technical Bulletin 15: Restricted Access....

On-Campus only

Create a file called .htaccess in the directory you wish to limit. In that file should be the following code:

<Limit GET>
order deny,allow
deny from all
allow from 128.180
</Limit>

To Require AFS ID & password

Create a file called .htaccess in the directory you wish to limit. In that file, put the following code:

<Limit GET>
order deny,allow
deny from all
AuthExternal afs
AuthName AFSauthentication
AuthType Basic
require valid-user
</Limit>

Students will be prompted for their AFS (Network Server) ID and password to get access. (Note: this cannot be used to limit access to specific students.)

To require AFS ID & Password for Off-campus use only.

Create a file called .htaccess in the directory you wish to limit. In that file, put the following code:

<Limit GET>
order deny,allow
deny from all
allow from 128.180
AuthExternal afs
AuthName AFSauthentication
AuthType Basic
require valid-user
satisfy all
</Limit>

Back to top


Linking to a Conference or Bulletin Board

To provide interactive discussion and/or online announcements within your web site, you can link to a discussion conference or moderated bulletin board on the Lehigh Server.

To request that such a conference be set up for your class, contact Client Services (x3990) for the appropriate form. Once your class has been created, it can be reached on the web (and linked to) using the LUNA web interface: http://luna.cc.lehigh.edu:80/INFO or http://luna.cc.lehigh.edu:81/INFO

The difference between the http://luna.cc.lehigh.edu:80/INFO and the http://luna.cc.lehigh.edu:81/INFO servers is that on 80, the user is not asked for id and password, and so cannot post to the forums. However, on 81, the user is asked for a Lehigh ID and password and CAN post to the forums.

To link directly to your discussion group, you probably want to provide access to http://luna.cc.lehigh.edu:81/YOURBOARD
where YOURBOARD is the name assigned to your conference or bulletin board.

Note: the contents of your bulletin board or course discussion will be available on the web unless you specifically request that the discussion be limited to certain users.


References

  1. Technical Bulletin 15: Extraordinary Web Documents: Restricting Access and Serving Nonstandard Document Types
  2. Introduction to World Wide Web Authoring
  3. Advanced World Wide Web Authoring
  4. Redirecting URL's from your Web Space

Back to top


Written by Dean Batten.
Last modified 20 March 98 by Jennifer Heise jahb@lehigh.edu