Storing Project Artifacts
Please read the following instructions carefully.
The quota for all the students in the class is now 50 MB on the /home/scf-team partition, which is accessible on all SCF timesharing hosts and workstations. You will be writing your project artifacts to the csci577 directory on that partition, which is owned by csci577 and is only user-writable but is world-readable and world-searchable. Your quota on the /home/scf-team partition is separate from the one your home directory.
- There are sub-directories under /home/scf-team/csci577,
one for each team. These subdirectories are owned by csci577. We
already set them up such that access to a team directory is limited to only
team members.
- Now, you should move and keep all the csci577 project-related
artifacts on the newly allocated space
- Do not keep personal files on the class account, since it will be
periodically inspected
- At the end of the semester, we will take ownership of all the files on that
partition
- There are 20 directories name teamXb (X = 1,2...16,17,...,23).
You can access your team directory by doing:
% cd
/home/scf-team/csci577/teamXb
or
%
~csci577/www/teamXb
(~csci577/www/teamXb
is a symbolic link to the actual directory /home/scf-team/csci577/teamXb)
All members (assuming that MX1, MX2, MX3, etc... are their
usernames on the SCF hosts) of teamXb have been given rwx permission to the teamXb
directory, using the setfacl command, executed by owner csci577:
setfacl -r -m
user:MX1:rwx teamXb
setfacl -r -m
user:MX2:rwx teamXb
setfacl -r -m
user:MX3:rwx teamXb
...
- So now, team members (MX1, MX2, MX3, etc...) can create sub-directories or
files under the team directory (teamXb)
Team member MX1 creates a sub-directory temp under teamXb. The
permissions would be:
drwx------ MX1 512
Oct. 17 temp
If team member MX1 wants team member MX2 and MX3 to have access to this
directory, member MX1 has to give them permission (assuming rwx permission for
MX2 and r-- permission for MX3):
setfacl -r -m
user:MX2:rwx temp
setfacl -r -m
user:MX3:r temp
then the access would look like (note the + sign):
drwx-------+ X1
512 Oct. 17 temp
Now if team member MX1 creates a file OCD.html in temp and
team member MX2 creates a file SSRD.html in temp then team member
MX1 needs to do:
setfacl -r -m
user:MX2:rwx OCD.html
setfacl -r -m
user:MX3:rwx OCD.html
and team member MX2 needs to do:
setfacl -r -m
user:MX1:rwx SSRD.html
setfacl -r -m
user:MX3:rwx SSRD.html
so that all three team members (MX1, MX2 and MX3) can now edit the file.
Note that all students in the class are in the same group. So, if you set the permissions to your files to rwx (for group) using (chmod), then any student in the class will have rwx access to your file.
For a file to be readable by the HTTP server (see below), you need to set
the permissions to rwxr-xr-x.
You can do that by running:
chmod 755 filename
You can find out more about the setfacl and getfacl commands by doing man setfacl or man getfacl (ACL stands for Access Control List). Also, you can find out more about the chmod command by doing man chmod
Troubleshooting File Permissions
If the Web server cannot access any file in the dirname directory and
returns 'File Not found' error, even though it appears as if the permissions
are correctly set to rwxr-xr-x, you may have incorrectly specified permissions.
1. Look at the permissions of the directory dirname
getfacl dirname
# file: dirname
# owner: username1
# group: csci-577
user::rwx
user:username1:rwx
#effective:rwx
user:username2:rwx
#effective:rwx
user:username3:rwx
#effective:rwx
user:username4:rwx #effective:rwx
group::---
#effective:---
mask:rwx
other:---
For the directory to be accessible by the web server, you need to have group::r-x
2. The solution is to execute (in the parent directory)
setfacl -r -m group:csci-577:r-x dirname
Note that the problem seems to happen whenever you create a directory, set
the ACL, and then try to do the chmod. You may prevent the
problem from happening by:
1. Creating the directory (mkdir dirname)
2. Setting the permissions for the Web server (chmod 755 dirname)
3. Set the ACLs for the files in the directory to give specific rwx access to
your team members,
e.g., setfacl -r -m user:username2:rwx dirname
Now that team members can now have access to each other's document, make sure that you do not overwrite each other's changes to the various documents, which may lead to a lot of wasted time and effort. You can follow a simple configuration management scheme, make up your own or use any version control tool that you may have available (no support provided for any such tool)..
If you are still working on a document, and are not done
with it yet, you can set read-only permission to your team members. Once you
are done with your changes, and want to allow your team members to modify the
document, you can give them read-write permissions to it.
When a document has read-write permissions, you might run into the problem of
having two team members download their copy of the document, work on it
independently, and then upload it back. Only the last one uploaded will be
saved, thus one team member will overwrite the other's work. As a simple
configuration management too, if you "check out" a document (e.g., OCD.html),
and you are editing it, add some agreed-upon suffix to the filename (e.g., OCD-out.html).
If your team members notice that the file has been renamed, it's probably
because you are working on it. After you are done, upload it back, under its
original name (OCD.html) and delete (OCDout.html) or rename it to
keep the older version as a back-up in case you need to undo your changes (OCD.bak.html)
Under your team directory, you have to set-up a directory
structure as indicated in the guidelines.
Failure to do so will result in severe penalties. Also remember NOT to delete
anything you do for project (winwin, prototype, documents), since now you have
enough space to store everything. Teams who do not keep project artifacts (for
both the LCO and the LCA) will be penalized.
Make sure to use ONLY relative references so that your entire team
directory structure can be moved to the archive without breaking any links.
Some Web publishing tools tend to automatically generate absolute references
instead of relative ones, unless you particularly pay attention to it.
i.e. use <ahref = "LCO/OCD/OCD.html"> instead of
<ahref ="http://www-scf.usc.edu/~csci577/teams/teamXb/LCO/OCD/OCD.html">
- As indicated in the guidelines,
every team has to setup a team homepage.
- The csci577 account administrators (currently the Teaching Assistants) are
responsible for the administration of the web server. So, if you notice that
the web server is down, please send email to the Teaching Assistants.