Individuals with personal or class ECE accounts can create, and subsequently edit, a web presence on the ECE webserver. By following the steps listed below you will be well on your way to being seen on the web!
Create a public_html folder in your AFS home directory, e.g.
MacOS X Terminal Icon
If you do not already have a website on the ECE webserver, you’ll need to create a directory in your ECE AFS space that is dedicated to the files for your site. The ECE webserver expects to see a directory called public_html when it is looking for your site.
In MacOS X you will need to be familiar with Terminal.app. To open Terminal.app you should open a Finder window, go to your Applications directory and then open the Utilities directory. Terminal.app is located within the Utilities directory.
In Windows you will need to be familiar with SSH Tectia Terminal. To open SSH Tectia Terminal you should select “Start -> All Programs -> SSH Tectia Client -> SSH Tectia – Terminal.”
Windows SSH Tectia – Terminal
In Unix/Linux you would use any available X-Terminal.
If you are creating a directory in your personal AFS space, you will need to type the following command from a terminal window.
mkdir /afs/ece/usr/<your_username>/public_html
If you are creating a directory in your course space, you will need to have access to the proper directory and then type the following command from a terminal window.
mkdir /afs/ece/class/<classname>/public_html
Name your first web page index.html.
This should be done in every directory in public_html that contains web pages. index.html is the name of the file that the webserver looks for when it isn’t supplied with a specific file to load from a location. By having such a file, you prevent users from ever seeing the “list of files” page.
Expanding on the description above, we then know that the following URLs will display the same page:
http://www.ece.cmu.edu/~username/project_14/index.html http://www.ece.cmu.edu/~username/project_14/
Continue to place additional pages, images, and other resources under your public_html directory.
For security reasons, the webserver will not have access to any AFS space outside of your public_html directory. As a result, if you have a page that isn’t under public_html, it will not be accessible via the webserver.
Restrict access rights (optional, but recommended)
Access to your AFS space is limited by permissions that you can set. To check the AFS permissions on your public_html directory you will need to issue the following command via the terminal:.
fs la /afs/ece/usr/<your_username>/public_html
After issuing this command you will get a result that looks like the following text:
Access list for /afs/ece/usr/<your_username>/public_html is: Normal rights: system:administrators rlidwka system:authuser rl system:anyuser rl <your_username> rlidwka
The entry “system:anyuser rl” gives the webserver (and anyone else) access to read the files contained within this directory. “system:authuser rl” gives any authenticated person the same rights.
To continue to allow only the webserver to access your public_html directory, but no one else, issue the following commands via the terminal.
fs sa /afs/ece/usr/<your_username>/public_html system:anyuser none fs sa /afs/ece/usr/<your_username>/public_html system:authuser none fs sa /afs/ece/usr/<your_username>/public_html system:www rl fs sa /afs/ece/usr/<your_username>/public_html system:webserver-users rl
Note that these permissions will apply to any newly-created directories under the public_html directory, but will not be applied to any pre-existing directories.
That’s it!
Your new home page address is http://users.ece.cmu.edu/~your_username.
