CGS4854 Tutorial 6

Due Friday, 6/24.

I have jury dity on 6/20, so there will be no class. To make up for the lost class time, I am assigning an extra tutorial. It will count as extra credit towards your grade.

This tutorial is an Apache tutorial. There are no servlets or JSPs.

Create the user directory

The user directory is the public HTML folder that every student can have on your server. When a request for ~username is made on your server, then your server will look for ~username/userDir. If it has the correct permissions, then it can be accessed. If there is a default file, then it will be displayed. We will define the userDir as cgs4854/group.

To access a user dir from your Apache server, use the URL

http://studentXX.cgs4854.cs.fiu.edu:99999/~some-username

Replace XX with your host number, 9999 with your port and some-username with any valid user name on ocelot, like yours (~your-usename) or one of mine (~tdowne99 or ~downeyt).

The directory index is the list of default file names that can be displayed. The server will take the first one that it finds.

This part of the tutorial redefines the user dir as cgs4854/group and sets cgs4854.html as the first option in the directory index list. It is essential that the file and folder have the correct group permission.

• Change the permission of your home directory on ocelot to 711.
• Create a folder named group under cgs4854.
  • Give the folder permission 755.
• Create a page named cgs4854.html in the group folder.
  • Give the file permission 644.
  • Add a paragraph to this page.
• Edit the srm.conf file in the conf folder of Apache.
  • Change the UserDir directive to cgs4854/group.
  • Add cgs4854.html as the first option in the DirectoryIndex directive.
• Restart or start your Apache server.
• Access the ~tdowne99 path on your server. If you see a Wrong Page heading, then you have done something wrong.
• Access the ~downeyt path on your server.
• Access the ~username path on your server. Replace username with your user name. You should see your page.
• Access the ~username path for anyone else's id that you know in the class.

Change the default icons

In the srm.conf file, there are directives that control the icons that display in directory listings.

To see a directory listing, access ~tdowne99/tutorial from your Apache server. You will see several icons for different files.

You will now change those icons to something else.

• Open the path /icons/ on your server. Be sure to include the trailing /.
  • These are all the icons that are used by Apache. You all have a link to a shared folder that contains these icons.
  • Open the icon_sheet image. It is one image that contains thumbnails of each image in the folder.
  • Pick 4 images that are different from the ones in the above index listing.
• Edit the srm.conf file.
  • Look for the AddIconByType directives for html, png and txt files. You will need to determine the correct mime type for these file extensions. (In the conf folder of your server, open the mime.types file and look for the mime type associated with each extension.)
  • in the srm.conf file, change the icon for the appropriate AddIconByType for each mime type.
  • Another directive controls that icons that are used for directories. Look for the AddIcon directive that is associated with the parent directory. (Hint: you need to know the shorthand symbol in a path that means 'parent directory').
  • Change the icon for the parent directory.
• Restart your server.
• Open the ~tdowne99/tutorial path on your server and you should see the icons that you selected. (I chose the ones listed below. You can choose different ones.)

Change the error messages

Web sites display an error message when a page cannot be found. They also display a message when a user does not have permission to access a page. An individual message can be displayed for any of the responses from the server that indicate there is an error.

We will create new error messages for 403 and 404 errors. You can follow links from ~tdowne99/ to see the new messages that you create.

• Create a new sub-folder of docRoot named errorPages.
  • Change the permission to 705
  • Create a new error page named 404.html for 404 errors. Be sure that 404 appears in the title and in the page.
  • Create a new error page named 403.html for 403 errors. Be sure that 403 appears in the title and in the page.
• Modify the srm.conf file.
  • Look for an ErrorDocument directive in the file.
  • If the line starts with a #, then remove the #. The number means that the line is a comment.
  • Modify the line so that it is for 404 errors.
  • Change the error page to your 404 error page.
  • Create a similar ErrorDocument statement for 403 errors.
• Restart your server.
• Go to the path /~tdowne99/and follow the links to a file that does not exist and a file that cannot be accessed.

Modify index.html in docRoot

Add relative hypertext links to the docRoot/index.html file to ~tdowne99 and another link to ~your-user-name. Both of these links must be relative to your Apache server.

Submitting Homework

To hand in the tutorial, zip the docRoot, serverRoot and group folders and upload them.

• Remove the old zip file.

  rm ~/username.zip

• Please use the following command to compress your cgs4854/serverRoot folder.

  zip -r username ~/cgs4854/serverRoot -x \*.jar \*.zip \*.war

  Replacing username with your user name. This will create a file named username.zip.

• Next, use the following command to compress your cgs4854/docRoot folder.

  zip -r username ~/cgs4854/docRoot -x \*.jar \*.zip \*.war

  Replacing username with your user name. This will add to username.zip file above.

• Next, use the following command to compress your cgs4854/group folder.

  zip -r username ~/cgs4854/group -x \*.jar \*.zip \*.war

  Replacing username with your user name. This will add to username.zip file above.

• Check the size of the ZIP file, it should be less than 3 MB. If it is not, then you probably have another ZIP file stored in the ZIP archive. Delete it and re-zip.
• You then have a choice for submitting the file.
  • If you are logged onto ocelot, use my uploading program to upload the file. Enter this command at the command prompt:
    ~downeyt/cs/public/webftp/webftp.pl
  • If you are using winscp, then download the zip file to your computer; then, upload the file to me: Submitting homework on-line via the Web.
• Upload the file as binary.