University of California at Berkeley EECS Instructional Support INSTRUCTOR'S GUIDE to EECS Instructional Computing - Spring Semester, 2007 This document describes our student accounts, application software and instructional support. For many courses, the EECS Instruc- tional computers and student accounts are already set up. Instruc- tors are encouraged to contact us to insure that any special needs are met. EECS Instructional Support 378/386 Cory Hall, 333 Soda Hall, 510/643-6141 inst@eecs.berkeley.edu INFORMATION and HELP: EECS Instructional WEB site: http://inst.eecs.berkeley.edu/ EECS Instructional links for instructors: http://inst.eecs.berkeley.edu/for-instructors.html Maintaining course WEB sites: http://inst.eecs.berkeley.edu/setup.html#class_page ACCOUNTS FOR EECS STUDENTS: EECS and CS majors are provided with permanent UNIX "named" accounts on the EECS Instructional computers in Cory and Soda Hall. Students can use these accounts for much of their coursework. Qualified students who do not have an Instruc- tional UNIX account can obtain one automatically - they should read the blue bulletin boards by 199 Cory Hall, 273 Soda or 333 Soda Hall to find out how. For some classes, additional Windows or UNIX computer accounts are issued that are set for specific software and labs, and expire at the end of the semester. Instructors should arrange for class accounts with the support staff (email to "inst@eecs"). Instructors can have superuser access privileges over class accounts on the UNIX systems, using the command 'tasu'. For that reason, class accounts are still preferable for many entry-level classes on the UNIX systems. There is more detailed information about the student accounts later in this document. Many of the Instructional labs are open for "drop-in" 24 hours, 7 days a week. A cardkey is often required for access. Some labs are restricted for specific classes. Instructors may request access to specific types of computers, such as Windows NT, UNIX or Macintoshes. For information about what's in our labs, please see http://inst.eecs.berkeley.edu/clients. For information about what labs are assigned to your class, please see http://inst.eecs.berkeley.edu/for-instructors.html. CLASS ROSTERS ON-LINE: Faculty can access this data using their CalNet IDs: class enrollment lists - http://bearfacts.berkeley.edu/ student email addresses - http://bearfacts.berkeley.edu/ submit grades to Registrar - http://bearfacts.berkeley.edu/ student photos - https://courseweb.berkeley.edu/courseweb/ about CalNet IDs - http://inst.eecs.berkeley.edu/~kevinm/calnet/ DETECTING PLAGIARISM: We have copies of histok (by Paul Heckbert) and moss (by Alex Aiken), programs for comparing C source files, to detect the degree of similarities. From the output, the user can decide on the likelihood of plagiarism. These are installed in /share/b/histok and /share/b/moss on the EECS Instructional systems. Access is enabled for instructor ("class master") accounts. There is a basic help file that you can read using the commands: more /share/b/histok/README more /share/b/moss/README At your request, we can run these programs for you on specific students' files. CARD KEY ACCESS: Cory and Soda Hall Instructional labs (and the buildings them- selves) require access by cardkey on evenings and weekends. The labs are open weekdays. Students need to obtain cardkeys and to renew thir cardkeys for access to our labs each semes- ter. Cardkeys services are available in 253 Cory and 387 Soda (8:30am-noon, 1pm-4:30pm). New cardkeys cost $25 ($10 non- refundable fee + $15 refundable deposit). There is no charge for updating the authorization on an existing cardkey. Due to the volume of requests early in the semester, there is often a 2-4 day delay in activation. Students who are enrolled via TeleBears will not need faculty approval for cardkey access. Others (Concurrent Enrollment, UC Extension, etc) will need approval from the instructor. Instructors can send email to inst@eecs to notify us of additional students in the class. Students may also use our "EECS Instructional Account Request" form (from 386 Cory) to submit an instructor's signature for approval. CS Lower Division courses are given cardkey access to the labs in the second floor of Soda Hall. CS61A also gets access to 310 Davis. CS and EE Upper Division classes typically get access to the drop-in labs in the second floor of Soda Hall as well as 105, 119 amd 199 Cory. The drop-in labs are not locked during weekday hours. 349 Soda and electronics labs in Cory are generally restricted to specific classes and require a cardkey 24 hours/day. SCHEDULING INSTRUCTIONAL LABS: Instructors who wish to reserve a lab room should contact the Instructional staff ahead of time. We may have to negotiate the time with other instructors who are using the room. We encourage instructors to post information about lab schedules on the bulletin board in the lab room. CLASS NEWS GROUPS: The news system can be used to send messages to your students. Each class is allocated one news group, named ucb.class.your- class, for example, ucb.class.cs162. Please use this alterna- tive to email when sending messages to all students at once. Netscape Messenger is very convenient for reading and posting news, and it is available on all of our computers. Students should read http://inst.eecs.berkeley.edu/connecting.html for additional information, including how to read UCB newsgroups from off campus. Digests of previous articles for class newsgroups are avail- able via anonymous ftp to news.berkeley.edu, within in the directory /pub/ucb.class. See http://inst.eecs.berkeley.edu/share/b/pub/news.help . INSTRUCTIONAL LABS: The computing and electronics labs for CS and EE classes are located in Cory Hall, Soda Hall and Hearst Field Annex building C. The computers are UNIX and Windows. Students need Instructional computer accounts to login to these computers. All labs have access to laser printers. Please see http://inst.eecs.berkeley.edu/~inst/iesglabs.html for the latest list of labs and primary users. Please see http://inst.eecs.berkeley.edu/for-instructors.html for the labs, computer resources and software that we expect to provide for a given class. MODEM and HOME-IP ACCESS: Please see /http://inst.eecs.berkeley.edu/connecting.html for current information about remote access. To register for the campus modems, a student should login to the campus registry system from a networked computer account using the command "telnet home-ip.berkeley.edu" and enter "home-ip" as the login (no password is required). The user enters her SID number and is issued a login name and password. Further directions are on the screen. The modem login and password allows one to use campus modems and, optionally, home IP as well. This will become the user's permanent login to access all UCB modems. The modem login name and password are not related to any other computer login and password on campus, and temporary class account logins (such as "cs61a-zz") should not be used as modem logins. Students who are not enrolled via UC Berkeley cannot get UCB SID numbers and cannot use the HomeIP service or other UCB services that require an SID or CalNet ID. This includes UC Extension (and Concurrent Enrollment) and NTU students. APPLICATIONS SOFTWARE: We now maintain a list of current application software on our systems on http://inst.eecs.berkeley.edu/software. The help files can also be accessed directly from an Instructional UNIX computer under teh /share/b/pub directory. Typical directory locations for UNIX software are: /usr/local/bin /usr/sww/bin /usr/eesww/bin Software on Windows computers is typically installed on each local computer and can be found in the "Start/Programs" menu. NAMED ACCOUNTS: Undergraduates who are declared as EECS or L&S CS majors and EE and CS graduate students will now be given long-term named accounts on the EECS Instructional systems. The account will remain active as long as the student is in the department. It will not expire or be turned off at the end of each semester. For many courses, no other accounts will be issued - students will use their named accounts for all coursework. For undeclared and non-EECS majors, a single named account may be issued or, for certain classes, only a generic class account will be provided. This account will expire at the end of the semester. Undeclared students in CS Lower Division courses may be eligible for permanent named accounts, with the approval of the CS Advising office (Barbara Hightower, 339 Soda). To obtain one of these accounts, users should refer to instructions that are posted on large blue bulletin boards near 199 Cory and 273 Soda. For a named account, a user should login as 'newacct' (password: 'newacct') at any Inst- ructional workstation or use 'ssh cory.eecs -l newacct' from any another networked computer. The student should go to 253 Cory the following afternoon to claim the account form. For a class account, the student should obtain the account form from the instructor. INSTRUCTOR ACCESS to FILES in a NAMED ACCOUNT: Generally, if an instructor needs access to the students' files, then the students should be given class accounts for that coursework. The EECS 'grading' utility allows students with any type of account on the Instructional systems to submit assignments on-line. The teaching staff can then grade the assignments and store the grades in a local database from which the students can read their grades and comments. For information about that, please see the 'GRADE' DATABASE section below. 'Informed Consent' REQUIRED FOR DISPLAYING STUDENT IDENTITIES: Information that you display publically via University comput- ers may not include the name of a student without an "informed consent" from the student. Restricting access to WEB pages, say to the EECS or BERKELEY.EDU domains, is not sufficient: informed consent is still required. This is a requirement by federal law. An example of "informed consent" is: "I, (student name), consent to have my name posted on (webpage title & url), a paper copy template of which is attached to this consent form. My name may be posted on this webpage from (date) to (date). I understand that my consent to have my name posted on this webpage is not a condition of my participation in (name of the class), nor will it be used as a basis for grading my performance therein." Please refer to the Policy Analysts at the Office of the Registrar, 127 Sproul Hall, for further clarification about the requirement for "informed consent". 'GRADE' DATABASE: Class accounts on the Instructional UNIX systems can be set up to have a simple database of students' grades. Using the 'grading' program, students can read their own data; author- ized TAs and readers can enter and modify the data. Please see the help file in /share/b/pub/grading.help for current information. The help file can also be accessed at http://inst.eecs.berkeley.edu/cgi-bin/pub.cgi?file=grading.help DISTRIBUTION OF CLASS ACCOUNT FORMS: We give the account forms for these accounts to an instructor in a sorted pile. Instructors are expected to supervise the distribution of the class account forms, insuring that only enrolled students acquire accounts and that each student is given just one. The accounts for the class master, TAs, and readers should be issued to no one else. Students no longer have to sign and return a portion of the account forms. Instead, they will be asked for their name and student ID number the first time they login to the new account. This information is logged into the ~/grading/register/ subdirectory of the instructor account. This information initializes the "grades" database that can be used later to record and view users' grades. No special system privileges are available to TA and reader accounts. However, the owner of such an account is regarded implicitly as a trusted representative of the instructor. INSTRUCTOR ACCESS to FILES in a CLASS ACCOUNT: The class master may access the files of the students with the command /share/b/bin/tasu - {login} Please exercise this access with care. Here is an example of UNIX commands to run a command as if you were the owner of each class account (while logged into an Instructional UNIX computer): cd ~cs162/class # includes all accounts in the ./class directory foreach acct (*) # run "ls" on user's dir; could run a script or program instead tasu - $acct -c 'ls' end Please note that there is no longer a 'tapasswd' command, which was previously used to allow instructors to run 'passwd', 'chfn' and 'chsh' on a student account. We imple- mented the NIS+ password service in July 1998, which does not support the 'tapasswd' command. When students forget their passwords, they must visit a staff office to have them changed. All class accounts are set up to source the files adm/class.cshrc, adm/class.login, and adm/class.logout under the class master directory. This can be very useful if you would like to print a message or perform some class set-up whenever students log on/off. Please ask us for help if you are uncertain about the use of these special utilities. FURTHER INFORMATION: This document is stored in the file Instructors-Guide in each instructor home directory. General EECS Instructional announcements will appear in class newsgroups and on bulletin boards in the Instructional labs. We also post notices on the main Instructional WEB site: http://inst.eecs.berkeley.edu Instructors and TAs are asked to email Kevin Mullally (kevinm@eecs) and Cc: "inst@eecs". Students are expected tos sent email directly to "inst@eecs". Jan 11, 2007