Annotation of capa/capa51/Manual/s-install46.tex, revision 1.1

1.1     ! albertel    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>