faq/13.mdwn

   1 [[!meta title="What do I need to use the service?"]]
   2 (If, at any point in this process, you become stuck or encounter a
   3 problem, feel free to contact us at scripts@mit.edu. We regularly
   4 help people get up-and-running using the service.)
   5
   6 \1. You must have an
   7  [Athena account](http://web.mit.edu/olh/Register/) and understand
   8  the
   9  [MITnet rules of use](http://web.mit.edu/olh/Welcome/rules.html).
  10  You should also understand that users of the script service are
  11  responsible for ensuring the security of their content. If you
  12  install software from the web in your account, you are responsible
  13  for keeping that software up-to-date so that it is secure. If you
  14  have any questions or concerns, feel free to contact us at
  15  scripts@mit.edu.
  16
  17 \2. Run the commands in the shell script
  18  [/afs/athena.mit.edu/contrib/scripts/bin/signup-web](http://web.mit.edu/~scripts/bin/signup-web):
  19  (you can run these commands by typing “add scripts” [enter] then
  20  “signup-web” [enter] at an Athena command prompt)
  21
  22 This script creates your web\_scripts directory and signs you up
  23 for the service.
  24
  25 Your home directory must be listable by system:anyuser in order for
  26 the script service to work properly. (All Athena accounts are
  27 created with home directories that are listable by system:anyuser,
  28 and few users change this setting).
  29
  30 \3. Place your web scripts and any supporting files in
  31  \~/web\_scripts and make sure that they follow these rules:
  32
  33 If you want your scripts to be able to write data to subdirectories
  34 of your Athena home directory, you need to grant appropriate afs
  35 access to the user “daemon.scripts”. For example,
  36 **if you want your scripts to be able to write to a directory called DIRECTORY, you should run the command “fs sa DIRECTORY daemon.scripts write”**
  37 on Athena. See
  38 [Script Service AFS Details](http://scripts.mit.edu/afs_details.shtml)
  39 for more information.
  40
  41 Looking at sample script code may help you get your scripts
  42 working:
  43 demo.pl:
  44 [see code](http://web.mit.edu/~jbarnold/web_scripts/demo/demo.pl.html)
  45 | [see output](http://scripts.mit.edu/~jbarnold/demo/demo.pl)
  46 demo.php:
  47 [see code](http://web.mit.edu/~jbarnold/web_scripts/demo/demo.php.html)
  48 | [see output](http://scripts.mit.edu/~jbarnold/demo/demo.php)
  49 demo.py:
  50 [see code](http://web.mit.edu/~jbarnold/web_scripts/demo/demo.py.html)
  51 | [see output](http://scripts.mit.edu/~jbarnold/demo/demo.py)
  52 \4. Use a URL of the form
  53  http://**scripts**.mit.edu/**\~**USER\_NAME/SCRIPT\_NAME to access
  54  your scripts. The URL must start with http://**scripts**.mit.edu
  55  (rather than http://web.mit.edu or http://www.mit.edu), and you
  56  must include the \~. You should not include web\_scripts in the URL
  57  path.
  58
  59 \5. Add yourself to the scripts-announce mailing list by going to
  60  the
  61  [scripts-announce mailman page](https://mailman.mit.edu/mailman/listinfo/scripts-announce)
  62  if you would like to receive announcements of major service changes
  63  and outages. The scripts-announce list is moderated and is
  64  low-volume.
  65
  66
  67