Setting up unit directories on www2.ucsc.edu
DRAFT

Note: Please do not confuse www2 with www. The latter is managed differently with policies set by PIO and the web policy group.

User accounts

To be able to post documents on www2.ucsc.edu, people must have a CATS/Athena account. So the unit web administrator and any other unit web authors must have CATS accounts.

Setup unit lists and group

Use Moira/listmaint to create the following unit lists and group:

List names	Properties	Needed to allow...
`unitname-admin`	List only Private Visible Administrator is the web manager	...unit web managers to manage the `unitname-www` list.
`unitname-www`	List and group Private Visible Administrator is the `unitname-admin` list	...web authors to read and write in the `unitname` web directory, and to let web authors communicate easily with each other.

Setup unit web directory

Use Moira to create the unit directory file system. Enter the items in bold, accept the default values [given in square brackets] otherwise. If unitname is already taken, try unitname-www instead.

  Command: 3
  Add New Filesystem to Database
  name: unitname

  Changing Attributes of filesystem unitname.

  Filesystem's Type (AFS, ERR, FSGROUP, NFS, RVD) [NFS]: afs
  Filesystem's Cell [cats.ucsc.edu]:
  Filesystem's lockertype (? for help) [PROJECT]: www
  Filesystem's Pack Name [/afs/cats.ucsc.edu/www/unitname]:
  Filesystem's Mount Point [/cats/unitname]:
  Filesystem's Default Access (n, w) [w]:
  Comments about this Filesystem [none]: web directory for unitname
  Filesystem's owner (user) [jacques]: manager-username
  Filesystem's owners (group) [jacques]: unitname-www
  Automatically create this filesystem (y/n) [y]:

Moira will create the directory with the appropriate permissions in the next 24 hours.

Setup unit on web server

Login to coricopat.ucsc.edu, and edit the file /usr/local/apache/conf/virtual.www2. In the Alias section, enter a line such as:
```
  Alias /unitname /afs/cats.ucsc.edu/www/unitname/public_html
```
The unitname must match the name of the file system you created with moira (so use unitname-www if needed).
If the unit requested cgi-bin access, insert this line in the ScriptAlias section:
```
  ScriptAlias /taps/cgi-bin/ /afs/cats.ucsc.edu/www/taps-www/cgi-bin/
```

As root, restart apache:

  # /usr/local/apache/bin/apachectl restart

Setup unit directory info

In the directory /afs/cats.ucsc.edu/www/cstaff/adm/units, there is a file called data.all which contains information about the unit. This data is used by the search program, by the list of unit web directories, and by the mailing lists wwwadmins and www2admins.

In the directory /afs/cats.ucsc.edu/www/cstaff/adm/units, edit the file data.all, and insert 6 consecutive lines for each unit:
1. The unit name.
2. The name and <email> of the unit web administrator.
3. The full pathname of the search index file.
4. The full pathname of the directory being indexed.
5. The URL of that directory.
As an example, here is the TAPS entry:
```
  taps-unitname   Transportation And Parking Services (TAPS)
  taps-adminname  Jacob Sarasohn 
  taps-indexfile  /afs/cats.ucsc.edu/www/search/swish/taps.index
  taps-unitdir    /afs/cats.ucsc.edu/www/taps-www/public_html
  taps-uniturl    http://www2.ucsc.edu/taps
```
Go to /afs/cats.ucsc.edu/www/cstaff/adm/units, and run:
```
  % make all
```
This will:
1. run the program unitdir.pl which updates the list of unit web directories web page.
2. copy the file to the search directory.
3. run the program unitmail.pl which updates the mailing lists wwwadmins and www2admins using blanche. If you get any errors, run:
```
  % make unitmail
```
  until there is no error.

Setup unit search index

In the search web locker, go to the directory /afs/cats.ucsc.edu/www/search/swish/, and create a unit configuration file unitname.conf. The easy way is to copy an existing one, and change the appropriate entries in several places. For example, here is the TAPS configuration file.

The index itself will be created automatically at night.