Difference between revisions of "Build Instructor Guide"

From FreekiWiki
Jump to navigation Jump to search
(fixed build-qc instructions)
(wrong link; wasn't actually migrated, until now)
 
(47 intermediate revisions by 11 users not shown)
Line 1: Line 1:
== EB Multi ==
+
{{migrated}}
# Ctl-Alt-T on a diskless terminal
+
[https://docs.google.com/document/d/1Y7mIbHpM6aXw8mf2YZbpKDCO8u2PZRiXPQfxxWQTmpw/edit?usp=sharing Link]
# env | grep -i ssh
+
==Buildteacher duties==
# ssh build@THE_IP_ADDRESS_FROM_THAT_COMMAND
 
# password is the same as on every other system
 
# mkbootfloppy
 
# the default is fine
 
  
== How to print build-qc sheets ==
+
===Before the shift begins:===
# http://wiki.freegeek.org/index.php/Dead_trees
+
*Check the database (accessed by typing "data" in the web browser address bar of any networked computer inside Free Geek) to see who's expected and how many slots are open.  There are usually walk-ins, and you should have some idea  of how many slots are available.
# find build-qc and save the ps (postscript) version (#1 for now)
+
*Check the whiteboard for today's special instructions.  Also check in with the staff Reuse Program Coordinator for any updates.
# open a terminal (Ctl-Alt-T on a diskless terminal, terminal icon on freekbox)
+
*Make sure supplies are available:
# ls (the file probably saved to your desktop, but check your current directory first, Desktop should be the only thing you see)
+
*# RAM: Replenish supplies from the Tardis.
# cd Desktop (hitting tab after cd D works)
+
*# Hard drives:  See what size hard drives will be needed for the build shift and get the appropriately sized wiped drives from the Tardis. Do imaging throughout the session as you get a chance, mark imaged drives with a red marker dot, place Freekbox and Regulars drives in the hard drive boxes for builders, and keep High-End drives either at the imaging station or in the Tardis.
# ls (make sure the file saved correctly)
+
*# Optical Drives: Look over the optical drives and try to organize their boxes if necessary.
# Type 'lpr -o raw build-qc.ps' to make sure it works right
 
# If it printed right type 'lpr -o raw -# 40 build-qc.ps' (40 is the number of copies...change it if you want)
 
  
==Buildteacher duties==
 
--[[User:Camc|Camc]] 16:50, 2 October 2007 (PDT)
 
===Before the shift begins:===
 
#*Check the signup sheet at the front desk to see who's expected today, and note how many slots are open.  Often people show up without a reservation and you should have some idea of how many stations are available.
 
#*Check the whiteboard for today's special instructions.  Also check the numbers of the various types of machines that are fully built and that need QC and encourage builders to work on the more needed tasks.
 
#*Make sure supplies are available:
 
#*# RAM in steel cabinet.  Replenish supplies from the Tardis
 
#*# Hard drives:  See what's available in the steel cabinet, what's in the tub by the cloning machines (tub may be in the Tardis or otherwise misplaced).  Fill tub with appropriate number of appropriately sized wiped drives from the Tardis, do imaging throughout the session as you get a chance, mark imaged drives with a red marker dot, place in steel cabinet.
 
#*# Make Build-QC sheets as needed. Make system numbers as needed. (See detailed instructions below).
 
#*# Button batteries if needed.  Get them from Eval.  Keeping them in neat piles rather than in a jumble greatly lessens the chance of shorting out a good battery.  Beware the digital voltmeters; when their internal 9 volt battery dies, they give false positives such as reading 3.04v for a battery that is really only 2.61. The analogue voltmeters aren't accurate enough to decide between 2.97 and 3.03 but they are useful to compare readings with the digital voltmeters.
 
#:Dave, Matteo, Martin are resources.  Try not to abuse their good natures.
 
 
===During the shift:===
 
===During the shift:===
#*'''All paperwork is to be done in pencil'''
+
* Greet people as they arrive, get their name, introduce yourself as their instructor and identify your fellow build instructor(s) and staff.
#* Greet people as they arrive, get their name, introduce yourself as their instructor.
+
* If a person is new to build, make sure they have already gone through Hardware Identification and System Evaluation by looking at their volunteer profile in the database, or confirming with a System Eval instructor. If not, direct them to the System Eval instructor.
#*If a person is new to build, make sure they have done the command line class ("What's the difference between cp and mv?" is a fair test);  a blank look means that they are really just starting pre-build and should go directly to part sorting.
+
* Persons starting their first QC should, if at all possible, start with a very ordinary box that is unlikely to have interesting problems.  We don't want total puzzlement to be the student's first experience with build.
#*# Persons starting their first QC should have their own personal record sheet available (get it at the front desk), and it should have part sorting, eval, and command line checked off.  If at all possible, start the first QC with a very ordinary box that is unlikely to have interesting problems.  Instruct that software shutdown is ''always'' to be used rather than the power switch or removal of the power cord.  A box with known keystroke to enter BIOS, preferably noted on the build sheet, is good; we don't want a total puzzlement like this to be the student's first experience with build.
+
* When graduating a volunteer from QC to assembly, consider whether the builder is comfortable moving on and has the skills to start assembling.  Also consider what Free Geek's needs are in terms of QC vs. Assembly.
#*# Persons who have finished their QC's and are starting their first build need to be shown where to find boxes in the warehouse and what to look for in the boxes: no missing case parts, not exotic.  Please have them record the BIOS entry key on the build sheet so that the beginning QC'er can find it, and record hardware details as build progresses for when support is needed in the future.
+
* Volunteers who have finished their QC's need to be orientated to the Build assembly process (refer to the Assembly Orientation Checklist, hanging on the wall between the research stations, for a complete guide.)
#*# During the session, keep an eye out for people, especially new ones, who look lost or troubled.  Help gently.  Try too, to make sure that people are going through the process (checklist and instructions on the sheets in the plastic protector envelopes) and not just drylabbing. Unless yu know the builder to be reliable, do check the box over carefully both for specs and cosmeticallyMake sure that any Microsoft certification stickers are removed or obliterated.
+
* During the session, keep an eye out for people, especially new ones, who look lost or troubled.  Help gently.  Try to make sure that people are going through the Checklists and following proper procedure.
 +
* Make sure to show builders how to problem solve instead of just fixing issues for them.  
 +
* Let builders know if you are leaving the buildroom and always encourage them to turn to their neighbors for help.   
 +
* Remember that computer knowledge does not equal intelligence. Treat '''everyone''' with respect and realize that builders will have different learning styles.
 +
* Image drives throughout the shift to keep up with hard drive demand.
 +
 
 
===At the end of the shift:===
 
===At the end of the shift:===
#* Start cleaning up for the next shift, perhaps 15 minutes in advance. This is especially important at the end of the morning session if there are no empty stations for any early arrivals for the afternoon shift, to minimize the chaos of two flows of builders moving in contrary directions. It's also important at the end of the afternoon shift to get the builders out on time so the staff can go home too.
+
* Announce when the shift is close to being over and ask builders to leave time for cleanup before the next shift arrives or before we close.  It is also a good idea to remind people to log their hours on the way out.
 +
* Start cleaning up what the builders have missed.  This includes putting tools and supplies away, bundling keyboards and mice at each station, bringing dishes to the kitchen, and throwing stickers and other trash away. 
 +
* If you are the Instructor for the afternoon shift, remember to turn off the printer, all power supplies and fans. Make sure that there are no lights left on any monitors or speakers (except for the server station).
 +
 
 +
==Howto Orient New Builders==
 +
# '''Welcome''' the Builder, introduce yourself and ask their name.
 +
# Give them a quick '''tour''' of the Build room, pointing out important things like the QC shelves, spec sheets, white board, tools/hardware locations.
 +
# Explain to them '''the Build process'''. i.e., starting to QC and then moving on to assembly.
 +
#* In QC, they are using the checklist to make sure that the computer is '''within spec''', that the hardware and software are '''functional'''.
 +
# Have the Builder grab a checklist. Ask them to read through the introductory section.
 +
#* This may be a good time to make a comparison to System Eval: “When you were in System Eval you used flow charts, while here in Build you'll use checklists.
 +
#* Explain '''useful terms''' like “spec sheet” and “printme.”
 +
# Explain that they should go through the checklist as best they can and then feel free to '''use their resources''' to problem-solve.
 +
#* Point out resources, such as the volunteer next to them, Google, the wiki, help.ubuntu.com, the research stations and the Build instructors.
 +
# '''Remind them to take it slow and that they're here to learn.'''
 +
# Have fun!
 +
 
 +
==Howto Checkout QCed Boxen==
 +
* Ask the builder how things went.
 +
* Make sure all of the slots and bays are covered.
 +
* Physically check that the case is secure opening up the case if necessary. This includes the following steps:
 +
** Press on the power supply, slot covers, hard drive enclosure, etc. to make sure they don't move.
 +
** Do the "shake test" to make sure there are no screws rolling around in the case.
 +
** Check for and secure any loose cables or other components that might impede functioning of the fans.
 +
* Check the box over carefully for cosmetics. ALL sticky residue and grime must be removed!
 +
* Make sure the following stickers are removed:
 +
** Identifications of previous ownership
 +
** Contact information for original tech support provider
 +
** Microsoft COAs or windows stickers
 +
** Hardware branding stickers listing any components not contained in the refurbished system
 +
* When checking specs, please pay close attention to the optical drives and make sure the Intel 82845 graphic chipset is not being used.
 +
* Make sure that everything necessary is included in the notes section of the printme:
 +
** Anything non-functional (troubleshoot and fix if possible!)
 +
** Anything unusual (e.g. no PS2 ports)
 +
** Anything untested (e.g. Card Reader, HDMI, etc.)
 +
** Any physical damage 
 +
* If there are 2 sound or video ports, make sure the non-functioning one is covered with electrical tape or the official plastic covers.
 +
* If you haven't seen it boot up without user intervention, check this by rebooting the system.
 +
* Be sure there is a Free Geek sticker on front and system ID# sticker on back.
 +
* Thank the builder and, for first-timers, show them how to affix the printme and where to take the finished system.
 +
 
 +
==Howto Checkout Laptop QCs==
 +
# Visually inspect the exterior of the case:
 +
#* Are there any asset tags/Microsoft stickers?  Advise the Builder to remove them if so.
 +
#* Is the case fully assembled? Screws tightened?
 +
#* Is there any cosmetic damage? (Take note and confirm it has been recorded in the Printme)
 +
#* Is there an FG-PDX/Uncovered sticker? (Take note and confirm it has been recorded in the Printme)
 +
#* Are there Free Geek, GNU/Linux, and login stickers?
 +
# Confirm that wireless works:
 +
#* Disconnect or disable the ethernet controller, and try to browse to a webpage
 +
# Inspect the Printme:
 +
#* Confirm the system is Covered/Uncovered/FG-PDX.
 +
#* Confirm that the battery test has been run and is included in the Gizmo Info section (before notes).
 +
#* Check that only one storage device is installed (e.g., see if there's any mention of a Compact Flash or SD card in addition to the Hard Drive).
 +
#* Check the notes on the PrintMe:
 +
#** Internal/External Wireless?
 +
#** Wifi switch/soft key (e.g., Fn+F5)?
 +
#** Is cosmetic damage mentioned?
 +
#** BIOS key?
 +
#** Ask the builder to explain anything else.
 +
# Reboot the system
 +
#* Confirm it can boot without error/user input.
 +
# Sign-off on the system:
 +
#* Initial the physical Printme and sign off in the FGDB,
 +
#* Fold the Printme in half and keep it inside of the laptop,
 +
#* Make sure the Keeper Label has been updated (i.e., check the QC boxes),
 +
#* Make sure the Power Adapter is neatly wrapped,
 +
#* Thank the Builder and bring it back to Laptops.
 +
 
 +
==Howto Disburse a Take-home Computer * DISBURSEMENTS SHOULD BE DONE BEFORE 5PM==
 +
#Make sure box is within FreekBox Spec,
 +
#Fill out Disbursement info on builder's Printme,
 +
#Encourage builder to QC their box, or to have someone else QC it for them (not required),
 +
#Ask builder what peripherals they want and collect them from the Warehouse and Receiving,
 +
#Encourage the builder to attend our '''New to Ubuntu class''' and give them a class flyer (if available),
 +
#Fill the builder in on our '''Tech Support policy''' and give them a copy of the policy to take with them (if available),
 +
#'''It is very important that the disbursement Printme gets to the Front Desk'''.  It is preferable to walk with the builder to the front to turn in the Printme, remind them to log their hours and let the Front Desk staff know why the builder is walking out the door with computer equipment. 
 +
#Don't forget to congratulate the builder for completing the program and taking home their FreekBox.  Ask them to take the Build survey: [http://freegeek.limequery.com/index.php?sid=48992&lang=en] and encourage them to continue building,
 +
#If the Builder is interested in a Post-Build area, have them initiate the post-build application process.
 +
 
 +
==Remember to use your resources if you get stuck!==
 +
'''There are always Reuse Program staff assigned to every shift that you can go to for help.'''
 +
 
 +
==Additional Handouts for Training==
 +
; [[Media:BuildInstructorOrientation.odt|Build Instructor Orientation]]
 +
: Checklist for new Build Instructors
  
==How to make new system numbers==
+
; [[Media:Teaching_Philosophy.odt|Build Teaching Philosophy]]
--[[User:Camc|Camc]] 10:26, 22 January 2008 (PDT)
+
: Teaching philosophy of the Build program.
Gizmo numbers for built boxen are now assigned automatically during the '''printme''' part of build-qc.  Thus this section is no longer needed.
 
  
==Howto Checkout QCed Boxen==
+
[[Category:Build]]
[[User:Ryan52|Ryan52]] 09:13, 1 March 2008 (PST)
+
[[Category:Training]]
* Make sure all of the slots and bays are covered and that the cards and slot covers are not loose
+
[[Category: Volunteer Training]]
* Check for updates (System=>Administration=>Update Manager, click check for updates, then click install updates)
 
* Check if it rattles when you shake it
 
* If you haven't seen it boot up fine, reboot it (some people see that it says press F2 to continue, so they do it with out ever fixing it)
 
* There's more :D
 

Latest revision as of 16:18, 18 July 2014

deletion

This page has been migrated to a document on Free Geek's Google Drive.

Information remaining behind may no longer be relevant.

MIGRATOR:

When you have tagged this page as migrated,
please add a link to the new document on Google Drive.

(Link to new page immediately below.)


Link

Buildteacher duties

Before the shift begins:

  • Check the database (accessed by typing "data" in the web browser address bar of any networked computer inside Free Geek) to see who's expected and how many slots are open. There are usually walk-ins, and you should have some idea of how many slots are available.
  • Check the whiteboard for today's special instructions. Also check in with the staff Reuse Program Coordinator for any updates.
  • Make sure supplies are available:
    1. RAM: Replenish supplies from the Tardis.
    2. Hard drives: See what size hard drives will be needed for the build shift and get the appropriately sized wiped drives from the Tardis. Do imaging throughout the session as you get a chance, mark imaged drives with a red marker dot, place Freekbox and Regulars drives in the hard drive boxes for builders, and keep High-End drives either at the imaging station or in the Tardis.
    3. Optical Drives: Look over the optical drives and try to organize their boxes if necessary.

During the shift:

  • Greet people as they arrive, get their name, introduce yourself as their instructor and identify your fellow build instructor(s) and staff.
  • If a person is new to build, make sure they have already gone through Hardware Identification and System Evaluation by looking at their volunteer profile in the database, or confirming with a System Eval instructor. If not, direct them to the System Eval instructor.
  • Persons starting their first QC should, if at all possible, start with a very ordinary box that is unlikely to have interesting problems. We don't want total puzzlement to be the student's first experience with build.
  • When graduating a volunteer from QC to assembly, consider whether the builder is comfortable moving on and has the skills to start assembling. Also consider what Free Geek's needs are in terms of QC vs. Assembly.
  • Volunteers who have finished their QC's need to be orientated to the Build assembly process (refer to the Assembly Orientation Checklist, hanging on the wall between the research stations, for a complete guide.)
  • During the session, keep an eye out for people, especially new ones, who look lost or troubled. Help gently. Try to make sure that people are going through the Checklists and following proper procedure.
  • Make sure to show builders how to problem solve instead of just fixing issues for them.
  • Let builders know if you are leaving the buildroom and always encourage them to turn to their neighbors for help.
  • Remember that computer knowledge does not equal intelligence. Treat everyone with respect and realize that builders will have different learning styles.
  • Image drives throughout the shift to keep up with hard drive demand.

At the end of the shift:

  • Announce when the shift is close to being over and ask builders to leave time for cleanup before the next shift arrives or before we close. It is also a good idea to remind people to log their hours on the way out.
  • Start cleaning up what the builders have missed. This includes putting tools and supplies away, bundling keyboards and mice at each station, bringing dishes to the kitchen, and throwing stickers and other trash away.
  • If you are the Instructor for the afternoon shift, remember to turn off the printer, all power supplies and fans. Make sure that there are no lights left on any monitors or speakers (except for the server station).

Howto Orient New Builders

  1. Welcome the Builder, introduce yourself and ask their name.
  2. Give them a quick tour of the Build room, pointing out important things like the QC shelves, spec sheets, white board, tools/hardware locations.
  3. Explain to them the Build process. i.e., starting to QC and then moving on to assembly.
    • In QC, they are using the checklist to make sure that the computer is within spec, that the hardware and software are functional.
  4. Have the Builder grab a checklist. Ask them to read through the introductory section.
    • This may be a good time to make a comparison to System Eval: “When you were in System Eval you used flow charts, while here in Build you'll use checklists.
    • Explain useful terms like “spec sheet” and “printme.”
  5. Explain that they should go through the checklist as best they can and then feel free to use their resources to problem-solve.
    • Point out resources, such as the volunteer next to them, Google, the wiki, help.ubuntu.com, the research stations and the Build instructors.
  6. Remind them to take it slow and that they're here to learn.
  7. Have fun!

Howto Checkout QCed Boxen

  • Ask the builder how things went.
  • Make sure all of the slots and bays are covered.
  • Physically check that the case is secure opening up the case if necessary. This includes the following steps:
    • Press on the power supply, slot covers, hard drive enclosure, etc. to make sure they don't move.
    • Do the "shake test" to make sure there are no screws rolling around in the case.
    • Check for and secure any loose cables or other components that might impede functioning of the fans.
  • Check the box over carefully for cosmetics. ALL sticky residue and grime must be removed!
  • Make sure the following stickers are removed:
    • Identifications of previous ownership
    • Contact information for original tech support provider
    • Microsoft COAs or windows stickers
    • Hardware branding stickers listing any components not contained in the refurbished system
  • When checking specs, please pay close attention to the optical drives and make sure the Intel 82845 graphic chipset is not being used.
  • Make sure that everything necessary is included in the notes section of the printme:
    • Anything non-functional (troubleshoot and fix if possible!)
    • Anything unusual (e.g. no PS2 ports)
    • Anything untested (e.g. Card Reader, HDMI, etc.)
    • Any physical damage
  • If there are 2 sound or video ports, make sure the non-functioning one is covered with electrical tape or the official plastic covers.
  • If you haven't seen it boot up without user intervention, check this by rebooting the system.
  • Be sure there is a Free Geek sticker on front and system ID# sticker on back.
  • Thank the builder and, for first-timers, show them how to affix the printme and where to take the finished system.

Howto Checkout Laptop QCs

  1. Visually inspect the exterior of the case:
    • Are there any asset tags/Microsoft stickers? Advise the Builder to remove them if so.
    • Is the case fully assembled? Screws tightened?
    • Is there any cosmetic damage? (Take note and confirm it has been recorded in the Printme)
    • Is there an FG-PDX/Uncovered sticker? (Take note and confirm it has been recorded in the Printme)
    • Are there Free Geek, GNU/Linux, and login stickers?
  2. Confirm that wireless works:
    • Disconnect or disable the ethernet controller, and try to browse to a webpage
  3. Inspect the Printme:
    • Confirm the system is Covered/Uncovered/FG-PDX.
    • Confirm that the battery test has been run and is included in the Gizmo Info section (before notes).
    • Check that only one storage device is installed (e.g., see if there's any mention of a Compact Flash or SD card in addition to the Hard Drive).
    • Check the notes on the PrintMe:
      • Internal/External Wireless?
      • Wifi switch/soft key (e.g., Fn+F5)?
      • Is cosmetic damage mentioned?
      • BIOS key?
      • Ask the builder to explain anything else.
  4. Reboot the system
    • Confirm it can boot without error/user input.
  5. Sign-off on the system:
    • Initial the physical Printme and sign off in the FGDB,
    • Fold the Printme in half and keep it inside of the laptop,
    • Make sure the Keeper Label has been updated (i.e., check the QC boxes),
    • Make sure the Power Adapter is neatly wrapped,
    • Thank the Builder and bring it back to Laptops.

Howto Disburse a Take-home Computer * DISBURSEMENTS SHOULD BE DONE BEFORE 5PM

  1. Make sure box is within FreekBox Spec,
  2. Fill out Disbursement info on builder's Printme,
  3. Encourage builder to QC their box, or to have someone else QC it for them (not required),
  4. Ask builder what peripherals they want and collect them from the Warehouse and Receiving,
  5. Encourage the builder to attend our New to Ubuntu class and give them a class flyer (if available),
  6. Fill the builder in on our Tech Support policy and give them a copy of the policy to take with them (if available),
  7. It is very important that the disbursement Printme gets to the Front Desk. It is preferable to walk with the builder to the front to turn in the Printme, remind them to log their hours and let the Front Desk staff know why the builder is walking out the door with computer equipment.
  8. Don't forget to congratulate the builder for completing the program and taking home their FreekBox. Ask them to take the Build survey: [1] and encourage them to continue building,
  9. If the Builder is interested in a Post-Build area, have them initiate the post-build application process.

Remember to use your resources if you get stuck!

There are always Reuse Program staff assigned to every shift that you can go to for help.

Additional Handouts for Training

Build Instructor Orientation
Checklist for new Build Instructors
Build Teaching Philosophy
Teaching philosophy of the Build program.