File:  [LON-CAPA] / capa / capa51 / Manual / s-install46.tex
Revision 1.1: download - view: text, annotated - select for diffs
Fri Jul 14 18:30:33 2000 UTC (23 years, 10 months ago) by albertel
Branches: MAIN
CVS tags: version_2_9_X, version_2_9_99_0, version_2_9_1, version_2_9_0, version_2_8_X, version_2_8_99_1, version_2_8_99_0, version_2_8_2, version_2_8_1, version_2_8_0, version_2_7_X, version_2_7_99_1, version_2_7_99_0, version_2_7_1, version_2_7_0, version_2_6_X, version_2_6_99_1, version_2_6_99_0, version_2_6_3, version_2_6_2, version_2_6_1, version_2_6_0, version_2_5_X, version_2_5_99_1, version_2_5_99_0, version_2_5_2, version_2_5_1, version_2_5_0, version_2_4_X, version_2_4_99_0, version_2_4_2, version_2_4_1, version_2_4_0, version_2_3_X, version_2_3_99_0, version_2_3_2, version_2_3_1, version_2_3_0, version_2_2_X, version_2_2_99_1, version_2_2_99_0, version_2_2_2, version_2_2_1, version_2_2_0, version_2_1_X, version_2_1_99_3, version_2_1_99_2, version_2_1_99_1, version_2_1_99_0, version_2_1_3, version_2_1_2, version_2_1_1, version_2_1_0, version_2_12_X, version_2_11_X, version_2_11_4_uiuc, version_2_11_4_msu, version_2_11_4, version_2_11_3_uiuc, version_2_11_3_msu, version_2_11_3, version_2_11_2_uiuc, version_2_11_2_msu, version_2_11_2_educog, version_2_11_2, version_2_11_1, version_2_11_0_RC3, version_2_11_0_RC2, version_2_11_0_RC1, version_2_11_0, version_2_10_X, version_2_10_1, version_2_10_0_RC2, version_2_10_0_RC1, version_2_10_0, version_2_0_X, version_2_0_99_1, version_2_0_2, version_2_0_1, version_2_0_0, version_1_99_3, version_1_99_2, version_1_99_1_tmcc, version_1_99_1, version_1_99_0_tmcc, version_1_99_0, version_1_3_X, version_1_3_3, version_1_3_2, version_1_3_1, version_1_3_0, version_1_2_X, version_1_2_99_1, version_1_2_99_0, version_1_2_1, version_1_2_0, version_1_1_X, version_1_1_99_5, version_1_1_99_4, version_1_1_99_3, version_1_1_99_2, version_1_1_99_1, version_1_1_99_0, version_1_1_3, version_1_1_2, version_1_1_1, version_1_1_0, version_1_0_99_3, version_1_0_99_2, version_1_0_99_1, version_1_0_99, version_1_0_3, version_1_0_2, version_1_0_1, version_1_0_0, version_0_99_5, version_0_99_4, version_0_99_3, version_0_99_2, version_0_99_1, version_0_99_0, version_0_6_2, version_0_6, version_0_5_1, version_0_5, version_0_4, version5-1-2-first_release, stable_2002_spring, stable_2002_july, stable_2002_april, stable_2001_fall, loncapaMITrelate_1, language_hyphenation_merge, language_hyphenation, conference_2003, bz6209-base, bz6209, STABLE, HEAD, GCI_3, GCI_2, GCI_1, CAPA_5-1-6, CAPA_5-1-5, CAPA_5-1-4_RC1, BZ4492-merge, BZ4492-feature_horizontal_radioresponse, BZ4492-feature_Support_horizontal_radioresponse, BZ4492-Support_horizontal_radioresponse
- added the manual

    1: % System Installation
    2: \rm
    3: \hrule 
    4: \vskip 0.2in
    5: \section{Installation of \capa{} }
    6: 
    7: \noindent This Section describes how to install the \capa{} software.  These
    8: instructions are written for an Alpha running Digital Unix 3.2D (OSF1).
    9: 
   10: \vskip 0.2in
   11: \hrule 
   12: \vskip 0.2in
   13: %
   14: \vskip 0.2in
   15: %
   16: \begin{enumerate}
   17: \item  Log in as the super-user (root).
   18: \item  Change Directory to /usr/sbin
   19: \item  Enter {\tt adduser}
   20: 
   21: \item  A prompt will appear. Follow prompt to enter information about the user.  The example
   22: used here is for the user name {\bf teacher} 
   23: in the group {\bf cai}. 
   24: 	\begin{enumerate} 		
   25: 		\item Enter login name: {\tt teacher}
   26: 		\item Enter a UID: For most cases, using the default UID is preferable.  Just
   27: 		enter $<$return$>$
   28: 		\item Enter a full name for user: {\tt Instructor for course}
   29: 		\item Enter a login group for user: {\tt cai}
   30: 		\item Enter another group that user should be a member of. \\
   31: 		($<$Return$>$ only if none): Just enter $<$return$>$
   32: 		\item Enter a parent directory for user:{\tt /usr/user3}
   33: 		\item Enter a login shell for user:{\tt  /bin/csh}
   34: 		\item Do you wish to edit the auth file entry for this user?
   35: 		{\tt n}
   36: 		\item New password: {\tt password} \\
   37: 		{\bf NOTE:} The password
   38: 		will not be echoed to the screen.
   39: 		\item Retype new password: {\tt password}
   40: 	\end{enumerate}
   41: \item The compressed files for the \capa\ system version 4.6 are to be placed in the
   42:        directory \\ 
   43:       {\tt /usr/user3/teacher/DIST46}.
   44: 
   45: \item Expand these compressed files by typing {\tt uncompress DIST46.tar.Z}
   46: 
   47: \item Untar the directories by typing {\tt tar -xvvf DIST46.tar} 
   48: The DIST46 directory will then contain the following items:
   49: \begingroup \small
   50: \begin{verbatim} 
   51: drwxr-xr-x   7 teacher  cai          512 May 21 13:41 .
   52: drwxr-xr-x   3 teacher  cai          512 May 21 13:42 ..
   53: drwxr-xr-x   4 teacher  cai          512 May 20 12:39 LinkToBin
   54: drwxr-xr-x   5 teacher  cai          512 May 20 13:05 PutInCAPA46
   55: drwxr-xr-x   2 teacher  cai          512 May 21 13:15 PutInClass
   56: drwxr-xr-x   3 teacher  cai          512 May 20 12:59 PutInPublic
   57: drwxr-xr-x   3 teacher  cai          512 May 20 12:34 PutInPublicWeb
   58: -rw-r--r--   1 teacher  cai         3673 May 21 13:41 README.txt
   59: -rw-r--r--   1 teacher  cai       880328 May 19 17:21 manual46.ps
   60: \end{verbatim}
   61: \endgroup
   62: \item Print the file name README.txt.  Follow the instructions for installation.
   63: 
   64: \item  The DIST46.tar file may be recompressed and moved to another directory if you wish.
   65: \item After completing the items included in README.txt, check the following directories for content and
   66: permissions.  File sizes may differ.
   67: 
   68: 
   69: \begingroup \small
   70: \begin{verbatim}
   71: capa2.nscl.msu.edu> pwd
   72: /usr/user3/teacher/CAPA46
   73: capa2.nscl.msu.edu> ls -la
   74: total 1277
   75: drwxr-xr-x   5 teacher  cai          512 Feb 25 14:41 .
   76: drwxr-xr-x   6 teacher  cai          512 Mar  2 11:26 ..
   77: -rw-r--r--   1 teacher  cai         2894 Feb 25 14:41 GLabel.class
   78: drwxr-xr-x   2 teacher  cai          512 Mar 25  1997 Icons
   79: drwxr-xr-x   3 teacher  cai          512 Feb 24 09:36 capa-bin
   80: -rw-r--r--   1 teacher  cai         1479 Feb 27 09:32 class.html
   81: -rw-r--r--   1 teacher  cai         1922 Feb 24 09:33 help.html
   82: \end{verbatim}
   83: \endgroup
   84: \index{GLabel.class}
   85: \item  Important: Note  that {\tt capalogin} should have permissions  
   86:        {\tt -rwsr-xr-x }. Note specifically the {\tt s} in the fourth position. 
   87:        It must be there for students to be able to login. 
   88:        If it is not there,  enter the command:
   89:        {\tt chmod u+s capalogin}. 
   90:        (You will need to login as `root' to make this change.)
   91: \item Check the following directories for content and permissions. File sizes may differ.
   92:        
   93: \begingroup \small 
   94: \begin{verbatim}
   95: capa2.nscl.msu.edu> pwd
   96: /usr/user3/teacher/PublicWeb/CAPA
   97: capa2.nscl.msu.edu> ls -lag
   98: total 11
   99: drwxrwxr-x   4 teacher  cai          1024 Apr 28 14:32 .
  100: drwxrwxr-x   3 teacher  cai          1024 Apr 28 14:32 ..
  101: -rw-rw-r--   1 teacher  cai          2894 Apr 16 09:32 GLabel.class
  102: drwxr-x--x   2 teacher  cai          1024 Apr 28 14:36 Icons
  103: drwxrwxr-x   3 teacher  cai          1024 Apr 28 14:39 capa-bin
  104: -rw-rw-r--   1 teacher  cai          1336 Apr 28 15:49 class.html
  105: -rw-rw-r--   1 teacher  cai           254 Apr 16 09:31 help.html
  106: \end{verbatim}
  107: \endgroup
  108: 
  109: 
  110: \begingroup \small 
  111: \begin{verbatim}
  112: capa2.nscl.msu.edu> pwd 
  113: /usr/user3/teacher/PublicWeb/CAPA/capa-bin
  114: capa2.nscl.msu.edu> ls -lag
  115: total 679
  116: drwxr-xr-x   3 teacher  cai          512 Feb 24 09:36 .
  117: drwxr-xr-x   5 teacher  cai          512 Feb 25 14:41 ..
  118: -rwxr-xr-x   1 teacher  cai       606208 Feb 27 17:13 capahtml
  119: -rw-r--r--   1 teacher  cai          112 Feb 27 09:32 class.conf
  120: drwxr-xr-x   2 teacher  cai          512 Feb 24 09:36 teacher
  121: -rw-rw-r--   1 teacher  cai         2986 Mar  2 12:05 web_access.log
  122: \end{verbatim}
  123: \endgroup
  124: 
  125: \begingroup \small 
  126: \begin{verbatim}
  127: capa2.nscl.msu.edu> pwd
  128: /usr/user3/teacher/PublicWeb/CAPA/capa-bin/teacher
  129: capa2.nscl.msu.edu> ls -lag
  130: total 282
  131: drwxr-xr-x   2 teacher  cai          512 May  8 16:58 .
  132: drwxr-xr-x   8 teacher  cai          512 Jun  4 12:10 ..
  133: -rwsr-xr-x   1 teacher  cai       278528 May  8 16:57 capasbin
  134: \end{verbatim}
  135: \endgroup
  136: 
  137: \item  Important: Note  that {\tt capasbin} should have permissions  
  138:        {\tt -rwsr-xr-x } Note specifically the {\tt s} in the fourth position. 
  139:        It must be there for students to be able to login. 
  140:        If it is not there,  enter the command:
  141:        {\tt chmod u+s capasbin}. 
  142:        (You will need to login as `root' to make this change.)
  143:        
  144: 
  145: \item Check the following directories for content and permissions. File sizes may differ.
  146: 
  147: {\footnotesize  \begingroup 
  148: \begin{verbatim}
  149: capa3.nscl.msu.edu> pwd
  150: /usr/user3/teacher/Public/nsc111f8
  151: capa3.nscl.msu.edu> ls -lag
  152: total 2
  153: drwxr-xr-x   2 teacher  cai  512 Feb 25 13:47 .
  154: drwxr-xr-x   5 teacher  cai  512 Feb 27 09:33 ..
  155: lrwxrwxrwx   1 teacher  cai   40 Feb 25 13:45 Links -> /usr/user3/teacher/CAPA46/nsc111f8/Links
  156: lrwxrwxrwx   1 teacher  cai   43 Feb 24 09:42 pictures -> /usr/user3/teacher/CAPA46/nsc111f8/pictures
  157: \end{verbatim}
  158: \endgroup}
  159: 
  160: {\scriptsize \begingroup  
  161: \begin{verbatim}
  162: capa3.nscl.msu.edu> cd /usr/local/bin
  163: capa3.nscl.msu.edu> ls -lag
  164: total 18080
  165: drwxr-xr-x  3 root  system   2560 Feb 27 10:48 .
  166: drwxr-xr-x 13 root  system    512 Feb 18 11:37 ..
  167: -rw-r--r--  1 root  users    9116 Feb 27 10:47 CAPAscreen.pl
  168: lrwxrwxrwx  1 root  system     32 Feb 24 09:26 allcapaid -> /usr/user3/teacher/DIST46/LinkToBin/allcapaid
  169: lrwxrwxrwx  1 root  system     39 Feb 27 10:42 capautils.pl -> /usr/user3/teacher/DIST46/LinkToBin/capautils.1.0.pl
  170: lrwxrwxrwx  1 root  system     31 Feb 24 09:20 grader -> /usr/user3/teacher/DIST46/LinkToBin/grader
  171: lrwxrwxrwx  1 root  system     32 Feb 24 09:20 quizzer -> /usr/user3/teacher/DIST46/LinkToBin/quizzer
  172: lrwxrwxrwx  1 root  system     30 Feb 24 09:27 qzparse -> /usr/user3/teacher/DIST46/LinkToBin/qzparse
  173: \end{verbatim}
  174: \endgroup}
  175: 
  176: 
  177: \item Create an account for the class which will be using
  178: \capa\ .  Do this by adding the
  179: class as a separate user with a specific login shell.  The login name for the class is the same as the class name.  In the directory
  180: /usr/sbin, enter {\tt adduser}
  181: 	\begin{enumerate} 		
  182:  		\item Enter login name: {\tt nsc111f8}
  183:  		\item Enter a UID: Using the default UID is preferable.  Just
  184:  		enter $<$return$>$
  185: 		\item Enter a full name for user: {\tt Course Name}
  186: 		\item Enter a login group for user: {\tt cai}\\ 
  187: 		{\bf NOTE:}  The
  188: 		group for the course {\bf must} be
  189: 		the same as the instructor for the course.  For all examples we use {\tt teacher} as instructor and {\tt cai} as group.
  190: 		\item Enter another group that user should be a member of. \\
  191: 		($<$Return$>$ only if none):
  192: 		Enter $<$return$>$
  193: 		\item Enter a parent directory for user:{\tt
  194: 		/usr/user3/teacher/CAPA46}
  195: 		\item Enter a login shell for user:{\tt 
  196: 		/usr/user3/teacher/CAPA46/capalogin}
  197: 		\item Do you wish to edit the auth file entry for this user?
  198: 		{\tt n}
  199: 		\item New password: {\tt password} \\ 
  200: 		{\bf NOTE:} The password
  201: 		will not be echoed to the screen.
  202: 		\item Retype new password: {\tt password}
  203: 	\end{enumerate} 		
  204: \item The password file must now be edited to remove the class password. 
  205: To do this:
  206: 	\begin{enumerate}
  207: 	\item cd to /usr/sbin 
  208: 	\item Enter {\tt vipw} \footnote{{\tt vi} editing is best left to users
  209: 	familiar with {\tt vi}} 
  210: 	\item Use the arrow keys to position the cursor over the first letter of
  211: 	the encoded password for the class
  212: 	user name.  For example, a typical password file entry looks like
  213: 	this:\\
  214: 	\hspace*{-.6in}{\tt \scriptsize 
  215: 	nsc111f8:3ou7NE4pQTMTw:4347:26:Nat.Sci.111 Fall 1997:/usr/user3/teacher/CAPA46/nsc111f8:/usr/user3/teacher/CAPA46/capalogin}
  216: 	Note that the fields are separated by colons.  The description of the
  217: 	fields is as follows:\\
  218: 	{\tt username:password:UID:GID:Full Name:/Parent/Directory:/Login/shell}
  219:         \item Remove the password from this listing.  Do this by
  220:         positioning the cursor over the
  221:         first letter (or character) of the password field, then delete by
  222:         pressing the x key.  Exit the vi
  223:         editor by typing {\tt :wq}  The modified listing should then look like: \\
  224: 	\hspace*{-.6in}{\tt \scriptsize nsc111f8::4347:26:Nat.Sci.111 Fall 1995:/usr/user3/teacher/CAPA46/nsc111f8:/usr/user3/teacher/CAPA46/capalogin}
  225: 	\end{enumerate}
  226: \item Exit the root account and login as {\tt teacher}
  227: 
  228: \item  Look in the {\tt teacher}: {\tt cd /usr/user3/teacher/CAPA46}.
  229: \item  Type: {\tt ls -lag}\\ 
  230:        The last files in the  {\tt teacher} directory,  
  231:         , will look like: (Again, file sizes may differ.)\\
  232: \begingroup \small 
  233: \begin{verbatim}
  234: drwxr-xr-x   6 teacher  cai          512 Mar  8 19:32 CAPA46
  235: drwxr-xr-x   5 teacher  cai          512 Mar  5 16:37 Public
  236: drwxr-xr-x   4 teacher  cai          512 Mar  6 09:56 PublicWeb
  237: drwxr-xr-x   4 teacher  cai          512 Mar  5 16:37 bin
  238: drwxr-xr-x  17 teacher  cai          512 Mar  5 18:30 demolibrary
  239: \end{verbatim} 
  240: \endgroup
  241: 
  242: \item  Change directory to {CAPA46}: {\tt cd /usr/user3/teacher/CAPA46}.
  243: \item  Type: {\tt ls -lag}\\ 
  244:        The last files in the  {\tt teacher/CAPA46} directory,  
  245:         , will look like: (Again, file sizes may differ.)\\
  246: \begingroup \small 
  247: \begin{verbatim}
  248: drwxr-xr-x   2 teacher  cai         3584 Mar  8 19:30 MCTools
  249: drwxr-xr-x   2 teacher  cai          512 Mar  5 20:47 Tools
  250: -rwsr-xr-x   1 teacher  cai       606208 Feb 27 17:14 capalogin
  251: drwxr-xr-x   9 teacher  cai         1536 Mar  8 21:38 nsc111f8
  252: \end{verbatim} 
  253: \endgroup
  254: 
  255:        
  256:        
  257:        
  258: \item  Change directory to the sample class: {\tt cd /usr/user3/teacher/CAPA46/nsc111f8}.
  259: \item  Type: {\tt ls -lag}\\ 
  260:        The last files in the  {\tt teacher/CAPA46/nsc111f8} directory,  
  261:         , will look like: (Again, file sizes may differ.)\\
  262: \begingroup \small 
  263: \begin{verbatim}
  264: drwxr-xr-x   9 teacher  cai         1024 Mar  2 11:00 .
  265: drwxr-xr-x   6 teacher  cai          512 Mar  1 18:03 ..
  266: drwx------   2 teacher  cai          512 Feb 25 13:52 ASCII
  267: drwx------   2 teacher  cai          512 Feb 26 19:40 HTML
  268: -rw-r--r--   1 teacher  cai         1245 Feb 26 20:23 HWTop
  269: -rw-r--r--   1 teacher  cai         4289 Mar  1 16:32 Instructions.tex
  270: drwxr-xr-x   2 teacher  cai         1024 Mar  1 13:36 TeX
  271: -rw-r--r--   1 teacher  cai           21 Feb 26 14:05 TeXfooter
  272: -rw-r--r--   1 teacher  cai          665 Feb 26 14:05 TeXheader
  273: -rw-r--r--   1 teacher  cai         6455 Mar  1 15:30 capa.config
  274: drwx------   2 teacher  cai         1024 Feb 26 09:18 capaID
  275: -rw-r--r--   1 teacher  cai          474 Feb 28 16:12 classl
  276: -rw-r--r--   1 teacher  cai           77 Mar 25  1997 goodbye.msg
  277: -rw-r--r--   1 teacher  cai          720 Mar 24  1997 help.msg
  278: -rw-r--r--   1 teacher  cai        65932 Apr 29  1997 loginWindow4.1.eps
  279: drwxr-xr-x   2 teacher  cai         1024 Feb 26 18:57 pictures
  280: drwxr-xr-x   2 teacher  cai          512 Mar  1 20:10 records
  281: -rw-r--r--   1 teacher  cai          355 Mar 24  1997 second-login.msg
  282: -rw-r--r--   1 teacher  cai         7495 Mar  2 11:58 set1.qz
  283: -rw-r--r--   1 teacher  cai          293 Sep 28  1994 third-login.msg
  284: -rw-r--r--   1 teacher  cai          233 Feb 26 19:24 welcome.msg
  285: \end{verbatim} 
  286: \endgroup
  287: {\bf Note:}  Each class added to the system must contain the records directory (created by the instructor).  The
  288: {\tt capa.config, classl, TeXheader}, and {\tt TeXfooter} are required files.  All .msg files contain useful information
  289: for the students and can be edited to suit the instructors' needs. The {\tt HWTop} is useful in formatting the
  290: assignment printed page and can also be edited.  The  {\tt pictures} directory is specific to the sample
  291: class included in this distribution.
  292: 
  293: \item  Change to the records directory: {\tt cd records}    
  294: 
  295: \item  Type:  {\tt ls -lag}\\
  296:        The directory may be empty.  However, after
  297:        you have run {\tt quizzer} and students have logged in, several database
  298:        files will be automatically created.  The last files in this directory will
  299:        eventually look like:\\
  300: \begingroup \small 
  301: \begin{verbatim}
  302: drwxr-xr-x   2 teacher  cai          512 Mar  1 20:10 .
  303: drwxr-xr-x   9 teacher  cai         1024 Mar  2 11:00 ..
  304: -rw-r--r--   1 teacher  cai         1716 Mar  2 12:10 active.log
  305: -rw-r--r--   1 teacher  cai         5254 Mar  2 12:10 duration.db
  306: -rw-r--r--   1 teacher  cai         1904 Feb 28 18:48 log1.db
  307: -rw-r--r--   1 teacher  cai         1093 Mar  1 20:26 set1.db
  308: -rw-r--r--   1 teacher  cai         1440 Feb 28 18:48 submissions1.db
  309: -rw-r--r--   1 teacher  cai         1232 Mar  1 20:26 weblog1.db
  310: -rw-r--r--   1 teacher  cai         2451 Mar  1 20:26 websubmissions1.db
  311: \end{verbatim} 
  312: \endgroup
  313: %
  314: \item  \underline{Important:}  Check that the permissions and user-ownership of the files
  315:  are the same as those in the examples above.  If the group shown is not {\tt
  316:  cai}, then change the working directory to {\tt
  317:  teacher/CAPA46} by typing: {\tt cd /usr/user3/teacher/CAPA46} and then {\tt chgrp -R cai *} 
  318:  to change the group of all the files.  Similarly,  if the owner shown is not
  319:  {\bf teacher}, then change the working directory to {\tt teacher/CAPA46} by
  320:  typing: {\tt cd /usr/user3/teacher/CAPA46} and then {\tt chown -R teacher *} to change the
  321:  owner of all the files in the {\tt CAPA46} directory and subdirectories.  Also double check that {\tt capalogin} and {\tt capasbin} have set UID permission.
  322: 
  323: \item  Note: If you have created user IDs for classes in addition to {\tt nsc111f8},
  324: they will appear as subdirectories in {\tt teacher/CAPA46/}. The ownership and group should be teacher
  325: and cai as well. The same prototype files and folders as in 
  326: {\tt teacher/CAPA46/nsc111f8} must be placed in each sub-directory ( copy and edit them as needed). 
  327: %
  328: 
  329: \item  Some notes:
  330:   \begin{enumerate}
  331:     \item  The \LaTeX{} and dvi programs must be properly installed on the host
  332:       machine in order for {\tt quizzer} to format the problem sets. 
  333:       See your system administrator for help in installing these programs.  
  334:      \item  For a broad range of terminal emulators to be able to access the
  335:       system\footnote{by G. Perkins, MSU P/A Dept.}, it is necessary to modify the
  336:       {\tt /etc/termcap} file  to accommodate the appropriate vt100 \label{vtEmul}
  337:       terminal attributes, including handling non-standard nomenclature used by
  338:       terminal emulation programs on Macs and PCs.  A notable example is the widely
  339:       used {\it tn} program that is part of FTP Software, Inc.'s PC/TCP package. This
  340:       program negotiates its terminal type with the host computer using the prefix
  341:       {\tt dec-}
  342:       for the {\tt vt} family of terminals ({\it e.g.,} it requests terminal type
  343:       {\tt dec-vt100} instead of {\tt vt100}). This prefix, if unknown to the Unix
  344:       host, may cause the negotiation to result in an incorrect terminal type or to
  345:       fail completely.  \\
  346:       The line in the standard {\tt /etc/termcap} file that reads\\ \\
  347:       {\tt d0|vt100|vt100-am|vt100am|dec vt100:$\backslash$ } \\ \\
  348:        should be edited  to read:\\ \\
  349:       {\tt d0|vt100|vt100-am|vt100am|dec-vt100|dec vt100:$\backslash$ } \\ \\
  350:       thereby establishing {\tt dec-vt100} as an official synonym for {\tt vt100}.
  351:       Note that the ``{\tt dec-vt100}'' entry is different from the ``{\tt dec vt100}''
  352:       entry.  We advise adding the new alias rather than changing the existing alias
  353:       and possibly causing other problems.
  354:       A similar change can be made on other operating systems which use the
  355:       {\tt /etc/termcap} method of terminal definition.  Unix systems using the
  356:       {\it terminfo} program instead will support similar minor changes to the
  357:       appropriate file or files in the {\tt /usr/lib/terminfo} directory tree (consult
  358:       your system administrator for details). Be prepared to make similar changes in
  359:       case other terminal emulation programs at your site use their own non-standard
  360:       terminal type nomenclature.
  361:   \end{enumerate}
  362: \item  The \capa\ system should now be completely installed.  You may start writing
  363: problem sets, but we recommend reading the system description and taking the
  364: guided tour.
  365: \end{enumerate}
  366: 
  367: \newpage
  368: 
  369: The whole package for NeXTstep Operating system is essentially the same 
  370: as described previously, the difference in applications is that
  371: Quizzer and Grader are named Quizzer.app and Grader.app respectively. 
  372: The following items describe how to create an account 
  373: on the NeXTStep Operating system, Version 3.3.
  374: 
  375: \begin{enumerate}
  376: \item  Log in as the super-user (root).
  377: \item Create a new user group called {\tt cai}. Use the menu obtained from opening the file\\ {\tt /NextAdmin/UserManager} in the File Viewer and double-clicking on  its icon.
  378: 	\begin{enumerate} 		
  379: 		\item select   {\bf Group}
  380: 		\item select   {\bf New} to create a new user group
  381: 		\item In the domain window, click {\bf OK}
  382: 		\item type  {\bf cai} in the group name field
  383: 		\item select {\bf Save} to save the user group
  384: 	\end{enumerate}
  385: \item Create an Instructor account called {\tt teacher}, using the menu of {\tt /NextAdmin/UserManager}:
  386: 	\begin{enumerate} 		
  387:  		\item select   {\bf User}
  388:  		\item select   {\bf New}
  389: 		\item select   {\bf Local}  as user type
  390: 		\item select   {\bf Groups}
  391: 		\item select  {\bf cai}  in the User Group Info window
  392: 		\item set default group as {\bf cai}
  393: 		\item select   {\bf Long Form}
  394: 	        \begin{enumerate} 		
  395:                   \item {\bf User's Full  Name}:  ( i.e., instructor's full name or another description, such as \capa\ Instructor)
  396: 	          \item{\bf Username}:  teacher 
  397: 	          \item{\bf Password}: (enter a password), case sensitive
  398: 	          \item{\bf User ID}: (A number selected by the operating system)
  399:                   \item{\bf Home Directory}:  /teacher
  400: 	          \item{\bf Login Shell}:   /bin/csh
  401: 	        \end{enumerate}
  402: 		\item  select {\bf Save} in the menu; follow the instructions, verify password. 
  403: 		\item  select  {\bf Yes}  to create a home directory, then  wait for the save to be completed.
  404: 	\end{enumerate}
  405: \item Create an account that will be used by the students in the class to login called {\bf nsc111f8}
  406:        \begin{enumerate}
  407: 	 \item Locate the file {\tt /etc/shells}  in the File Viewer.  Double-click its icon to open the file with {\tt Edit.app}.  This will enable you to edit the file, so that the code {\tt /teacher/CAPA46/capalogin} acts as a valid Login shell under UNIX.  To complete this:	
  408:          \begin{enumerate}
  409: 	   \item Add the line below to the  {\tt /etc/shells} file:\\
  410:               {\tt /teacher/CAPA46/capalogin}\\
  411:               {\footnotesize (with a $<$CR$>$ at the end)}
  412:            \item select {\bf Save} in the menu. 
  413:          \end{enumerate}
  414: 	 \item Continuing with   {\tt /NextAdmin/UserManager}
  415:          \begin{enumerate}
  416: 		\item  select   {\bf New User}
  417: 		\item  select   {\bf Local}  as user type
  418: 		\item  select   {\bf Groups}
  419: 		\item  select  {\bf cai}  in the User Group Info window
  420: 		\item  set default group as {\bf cai}
  421: 		\item  select   {\bf Long Form}
  422:              \begin{enumerate}
  423:                     \item {\bf User's Full  Name}:  ( i.e., Natural Science Students Fall 1998)
  424: 	            \item {\bf Username}: {\it classname} (here enter: nsc111f8)
  425: 	            \item {\bf Password}: (none, just hit return)
  426: 	            \item {\bf User ID}: (a number selected by the operating system)
  427:                     \item {\bf Home Directory}:  {\it teacher sub-directory} (here enter :   /teacher/CAPA46/nsc111f8)
  428: 	            \item {\bf Login Shell}:   /teacher/CAPA46/capalogin   (this specification is the one that limits student access)
  429: 	     \end{enumerate}
  430: 		\item  select {\bf Save} in the menu;  a warning message may appear
  431: 		\item  select {\bf OK}, check values. 
  432: 		\item  To the prompt:  {\bf Create User  Home Directory}, say {\bf No}.  \\ This is very important;  Students do not get file space. 
  433: 	        \item {\bf Quit} UserManager
  434: 	\end{enumerate}
  435:       \end{enumerate}
  436: \item Return to the file {\tt /etc/shells}
  437: \item Edit the file by removing the line\\ {\tt /teacher/CAPA46/capalogin}  \\ {\footnotesize Note:  This allows students to login but only under the restrictions placed by the  {\tt capalogin} code.  Otherwise,  students (i.e., user {\it nsc111f8}) could login on your computer and see or modify all the files in teacher that have group read/write permission.}
  438: \item select {\bf File/Save}
  439: \item select {\bf File/Close}
  440: \item {\bf Quit} Edit
  441: \item Several  {\bf Username}  sub-directories which students  use to login and that hold all of the necessary files 
  442:              can be placed under the teacher account, just as was done for nsc111f8 above,  i.e.,  
  443:              phy232f8, cem152f8, xph232f8, etc. 
  444: \item {\bf logout} as root.
  445: \end{enumerate}
  446: 
  447: 
  448: 
  449: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>