1. User accounts

Users to have accounts on the VMs must have EECIS accounts. See https://accounts.eecis.udel.edu to apply. Users logging in to the virutal machines are authenticated through EECIS NIS. A user must be specifically allowed on a virtual machine.

1.1 Adding user accounts

Users can be individually allowed on a particular VM by running the script (with sudo or as root):

auth-user.sh [username]

This will add a line to /etc/passwd and /etc/group to enable access for the user, as well as set up his local /home/username directory.

1.2 Elevating privileges

Users can gain root privileges through the sudo command. Locate the sudo group in /etc/groups and add usernames here as needed.

2. SVN Server

/var/svn has been set up to store SVN repositories. The following page will describe how to create and administer repositories using this location: http://svnbook.red-bean.com/en/1.7/svn.reposadmin.create.html

3. Web Server

Apache is installed to host web sites. The default document root, the place where pages are served from, is /var/www/html . See the 'index.html' file there to get started.

If desired, Apache can be configured to serve pages from user's home directories. See http://httpd.apache.org/docs/2.2/howto/public_html.html

4. Setting up a trac project

Trac is set up to be served by Apache. Trac projects are configured to live in /var/www/trac

4.1 Creating a new trac project

To create a trac project called newproject, try the following, with root-privileges

trac-admin /var/www/trac/newproject initenv
chown -R www-data:www-data /var/www/trac/newproject

Note that the trac projects must be readable by the user Apache runs as. On Ubuntu, this is www-data.

4.2 Authenticating users to trac

An .htpasswd file can be used to authenticate to trac projects. To add a user to the trac site:

htpasswd /var/www/trac/trac.htpasswd [username]

The command will prompt for a new password. This password does not have to be your regular account password, and will provide you access to login to a trac project's web interface to post tickets, edit the wiki, etc.

Please see http://10.10.31.238/trac/test/wiki/TracModWSGI#ConfiguringAuthentication for more information

5. Misc

Files that might be customized by users should be saved to departmental storage (as opposed to the VM root disks that will eventually be destroyed). /home, /var/www, /var/svn, and /etc/apache2 are currently saved on the persistent, network drive. Feel free to move anything else there. It is mounted at /eecis/nfs.acad/

mkdir -p /eecis/nfs.acad/your/path
mv /your/path/yourfileordirectory /eecis/nfs.acad/your/path
ln -s /eecis/nfs.acad/your/path/yourfileordirectory /your/path/

CISC475-14F