TJ Website Adding Subsite Guide

This guide should be followed when creating new websites for the various TJ domains, such as academics.tjhsst.edu, activities.tjhsst.edu, etc. For all AFS steps, you must be an AFS administrator.

= Make an AFS Volume =

As a general convention, the volume is named web. , regardless of the subdomain that the particular page will be under. The group name should be rather short, as there is a limit on the number of characters in a volume name. For instance, the senior computer team's volume is named.

To create an AFS volume:

vos create -server  -partition  -name -maxquota 

The quota for web volumes should be set at 100 MB (102400 KB). New web volumes should be placed on adelie, vicepa.

For example, to create an AFS volume for a club called magic:

vos create -server adelie -partition vicepa -name web.magic -maxquota 102400

In addition, a read-only copy of the volume should be created:

vos addsite -server  -partition  -id

The read-only copy should be added to the same server and partition used when initially creating the volume.

= Make an AFS Group =

The name of the AFS group should be the same as the volume, web. .

To make an AFS group:

pts creategroup -name 

To add users to the new AFS group:

pts adduser -user -group 

= Create an AFS Mountpoint =

To create the mount:

fs mkmount -dir -vol

Directory should, in general, be /afs/csl/web/ /, where subdomain is the category under which the website will live, and group name is the name of the group (the same group name used in the volume and AFS group names, web. ).

= Apply AFS permissions =

All web volumes should be readable by the webserver (user www-data). In addition, the group with permissions for the particular website, web. , should have all AFS permissions on the directory.

Add the permissions with:

fs sa

For the webserver read permissions:

fs sa www-data read

For the web. group: fs sa web. all

The path to the volume is the same directory used in the fs mkmount command above.