Research Administration Tasks

• Adding users
  • As root on yamato, run
    /usr/local/sbin/diradm.superadduser '$username' '$email' '$Fullname'
  • Note that a file named '$username' is created in your current directory with the template filled out for mailing (the same file is displayed onscreen).
• Adding groups
  • As root on hood, diradm groupadd
  • same syntax as groupadd(8).
• Adding or removing users from a group
  • same syntax as gpasswd(8)
  • As root on hood, diradm gpasswd (-a|-d) USERNAME GROUP
• Adding projects
  • As root on hood:
    diradm amadd -O $mapbase $key $src
  • EG (CVS):
    diradm amadd -O auto.cvs foobar 209.87.56.240:/export/cvs/foobar
  • EG (SVN):
    diradm amadd -O auto.svn foobar 209.87.56.240:/export/svn/foobar
  • '-O' means the default mount options for automount.
  • As root on yamato: create the $src directory now, and give it the approriate permissions. chgrp -R it, and chmod 2771 it.
  • Make the directory. mkdir -p $src
  • Set ownership. chgrp -R $group $src
  • Set permissions. chmod 2771 $src
  • If web content is being served: mkdir -p $src/htdocs ; chmod 2775 $src/htdocs

Adding CVS repositories

• • On hood, run diradm amadd -O auto.cvs ${foobar} 209.87.56.240:/export/cvs/${foobar}
    • Replace ${foobar} with the name of the repository
  • On yamato, run (assuming there's a previously created group called ${foobar}:
    • cvs -d /export/cvs/${foobar} init
    • chmod -R 2770 /export/cvs/${foobar}
    • chgrp foobar /export/cvs/${foobar}
    • The chgrp command can instead be a chown command for a single user repository; group name and cvs repository name don't have to match, either.

Adding SVN repositories

• • On hood, run diradm amadd -O auto.svn ${foobar} 209.87.56.240:/export/svn/${foobar}
    • Replace ${foobar} with the name of the repository
  • On yamato, run (assuming there's a previously created group called ${foobar}:
    • chmod -R 2770 /export/cvs/${foobar}
    • chgrp foobar /export/cvs/${foobar}
  • On nelson, run svnadmin create /var/svnroot/${foobar} --fs-type fsfs

General user management

• • diradm offers almost all regular POSIX commands, sometimes with a few extra frills. The only commands NOT completely implemented are gpasswd and passwd.
• Gentoo update procedures (eg, how to update without ever messing up a machine).
  • TODO
• Welcoming new users; email template or typical wording you've used
  • This is in the diradm.superadduser script, as it fills out the template.

To: $FULLNAME <$EMAIL>
Subject: Research account created - $NEWUSER

Hello $FULLNAME,

Your research account has been created.
Username: $NEWUSER
Password: $NEWPASS

Please visit http://research.iat.sfu.ca/network/changepassword.php to change
your password when you receive this email.

For support with the research network, please email:
help@research.iat.sfu.ca

And include a good description of the entire problem and a suitable subject
line.

Please note that this username/password pair is only valid for the SFU Surrey
Research Network, and is NOT tied into the main SFU authentication systems.

• quotas
  • TODO