Difference between revisions of "MacBuild PPC Checklist"

From FreekiWiki
Jump to navigation Jump to search
m (moved batterytest in front of printme so that batterylife can be entered in printme notes section (and thus the database).)
(→‎Build: Added Roy's simplified Laptop Build checklist)
Line 139: Line 139:
 
|-
 
|-
 
| Power system down and place on the QC shelf in TARDIS ||
 
| Power system down and place on the QC shelf in TARDIS ||
 +
||
 +
 +
|}
 +
 +
What follows is Roy's simplified laptop build checklist:
 +
 +
==Build==
 +
 +
{| fontname="Helvetica" fontsize="12" border="1"
 +
|-
 +
|width="40%" align="center"|Steps
 +
|width="53%" align="center"|Notes/Detailed Instructions
 +
|width="7%"  align="center"|Done
 +
|-
 +
 +
||
 +
|-
 +
| Attach network cable and power cord ||
 +
||
 +
|-
 +
| Clear the PRAM ||
 +
While starting up, hold the '''Option+Apple+p+r''' keys.  Continue holding the keys until the system chimes three times.  Release the keys after the third chime is heard and shift quickly to the '''Option+Apple+o+f''' keys.
 +
||
 +
|-
 +
| Set the system clock and NVRAM in Open Firmware ||
 +
While starting up, hold the '''Option+Apple+o+f''' keys.  Release the keys when the Open Firmware prompt comes up.  Run the following command:
 +
decimal dev rtc [sec min hour day month year] set-time
 +
All values aside from the year should be two-digit numbers in 24-hour format.  The year should be a four-digit number.  Additionally, the clock needs to be set to UTC, so remember to add 7 hours to the current time if on regular time or 8 hours during Daylight Saving Time.  For example, to set the clock to 1:58 PM on September 18th, 2009, the command would be
 +
decimal dev rtc 00 58 20 18 09 2009 set-time
 +
To reset the NVRAM type the following commands in the specified order:
 +
reset-nvram
 +
set-defaults
 +
reset-all
 +
 +
The system will reboot after the '''reset-all''' command is entered.
 +
||
 +
|-
 +
||
 +
|-
 +
| Run badblocks to wipe the hard drive||
 +
To run badblocks we start the process as if we were doing a network installation. To access this install, hold down the '''n''' key (for network) while the computer starts. As soon as the network icon starts blinking on the screen you may release the '''n''' key.
 +
 +
# At the first boot prompt enter an '''l''' (for linux) to install the current version of Ubuntu.
 +
# The installation will stop at the keyboard selection. Accept the defaults (No or USA) for the next 3 screens and the installation will continue automatically.
 +
# When prompted for a hostname, delete the current entry and enter '''macbox''' in its place
 +
# When prompted for HD partitioning, choose "Go Back" and then select "Execute a shell" from the menu. At the prompt type "'''badblocks -wvvf -c1024 /dev/hda'''" and hit enter.  If that command fails, try "'''badblocks -wvvf -c1024 /dev/sda'''" instead. It will take about 3 hours to run badblocks.
 +
 +
If there are any bad blocks we must replace the hard drive.
 +
If there are no bad blocks, you can proceed with the installation. To do this type "exit" to leave the shell, select "Partition drives" from the list, accept the defaults and the rest of the installation will proceed automatically. The installation will take approximately 30 minutes and the computer will automatically reboot following the installation.
 +
||
 +
|-
 +
| Install Ubuntu via the network||
 +
If you have installed a tested and wiped hard drive, or if you have completed badblocks, you are ready to install Ubuntu. We are currently using a network installation of Ubuntu. To access this install, hold down the '''n''' key (for network) while the computer starts. As soon as the network icon starts blinking on the screen you may release the '''n''' key.
 +
 +
# At the first boot prompt enter an '''l''' (for linux) to install the current version of Ubuntu.
 +
# The installation will stop at the keyboard selection. Accept the defaults (No or USA) for the next 3 screens and the installation will continue automatically.
 +
# When prompted for a hostname, delete the current entry and enter '''macbox''' in its place
 +
# When prompted for HD partitioning, accept the default and the rest of the installation will proceed automatically. The installation will take approximately 30 minutes and the computer will automatically reboot following the installation.
 +
 +
||
 +
|-
 +
| Start up Ubuntu ||
 +
* Log into the system using the username '''oem''' and password '''freegeek'''.
 +
* If the system has problems starting up, refer to [http://wiki.freegeek.org/index.php/MacBuild_Laptop_Build#Special_Configurations the Special Configurations list]
 +
||
 +
|-
 +
| Set up the environment and verify hardware in the system
 +
||
 +
* Add the Terminal to the panel so it can be launched quickly. You can do this by dragging and dropping the terminal icon to the top task bar.
 +
To verify the hardware in a system, open up a terminal and run:
 +
sudo lshw
 +
This runs a command called '''lshw''' (which stands for "list hardware")  The items to pay attention to are:
 +
*Amount of system memory
 +
** You should be able to find this under the '''memory''' heading in '''lshw'''.  It should be the same as the physical amount of memory in the system.
 +
*Type of optical drive
 +
** This can be found under the '''cdrom''' heading in '''lshw'''. 
 +
*Presence of wireless card
 +
** This should be under one of the '''network''' headings.  You should look for an entry that mentions something about "Wireless interface" or "Broadcom".  If that exists, the system has a wireless card.
 +
*This is a good time to shut down the system and install additional memory or a wireless card if they are missing. Ubuntu will not run well with 256MB of memory and will sometimes generate errors that don't occur when 512MB or more memory is installed.
 +
||
 +
|-
 +
| Test CD/DVD data and sound ||
 +
# Insert, play, and eject a music CD
 +
# If machine has a CD-RW or DVD-RW, use '''brasero''' to erase a CD-RW disk, and create/burn a new data project.
 +
# If machine has a DVD drive:
 +
#* insert a data DVD, inspect directory contents
 +
||
 +
|-
 +
| Check if wireless works (if the system has a wireless card) ||
 +
Use Network Manager to see if you can connect to Free Geek's wireless network.  If you can, the wireless card works.
 +
||
 +
|-
 +
| Test battery life ||
 +
To start the battery test:
 +
# Make sure battery is fully charged
 +
# Open a web browser and go to '''''http://llama.freegeek.org/~serge/batterytest.sh'''''
 +
# Save file to disk
 +
# Insert an audio CD into optical drive
 +
# Launch audio player, play disc, set on repeat and mute the speaker.
 +
# In a terminal, navigate to the directory you saved batterytest.sh to and run:
 +
#* '''''sh batterytest.sh'''''
 +
# Disconnect power supply
 +
# Leave the system running until it powers off
 +
To check the results of the battery test
 +
# In a terminal, navigate to the directory you saved batterytest.sh to and run:
 +
#* '''''sh batterytest.sh'''''
 +
# Record the results in the notes section of the "printme" report
 +
||
 +
|-
 +
| Generate "printme" report for system ||
 +
# Make sure you are on the local wired network
 +
# Configure system so it can use network printers
 +
## From the desktop, go to System -> Administration -> Printing
 +
## In the Printer Configuration window, go to Server -> Settings...
 +
## Check the "Show printers shared by other systems" checkbox, and click the '''OK''' button. Close the printing window.
 +
# In a terminal, type '''''printme'''''
 +
#* Enter your volunteer ID in the Volunteer ID field
 +
#* Job should be changed to Builder
 +
#* System ID should be left blank
 +
#* Type should be changed to apple laptop
 +
#* Keeper label type should be set to No Sticker
 +
#* Choose whether the computer is covered or not
 +
#* Notes should include the following information:
 +
#** Results of battery test
 +
#** Version of Ubuntu installed
 +
#** Any components that show up in lshw (modems, certain wireless cards) that aren't supported by Ubuntu should be listed
 +
#** Any special issues the machine has
 +
# When asked where to print the report, select the printer '''Double'''.
 +
||
 +
|-
 +
| Power down the system, attach the printme sheet, and take to the store or place on storage shelf as appropriate.
 
||
 
||
  

Revision as of 12:04, 6 April 2010

Build

Steps Notes/Detailed Instructions Done
Install/verify RAM

Make sure the system has at least 512 MB of RAM. Keep in mind that some systems may have some RAM directly on the logic board.

Install wireless card (if not present already)

Ask the instructor

Attach network cable and power cord
Clear the PRAM

While starting up, hold the Option+Apple+p+r keys. Continue holding the keys until the system chimes three times. Release the keys after the third chime is heard.

Set the system clock and NVRAM in Open Firmware

While starting up, hold the Option+Apple+o+f keys. Release the keys when the Open Firmware prompt comes up. Run the following command: 

decimal dev rtc [sec min hour day month year] set-time

All values aside from the year should be two-digit numbers in 24-hour format. The year should be a four-digit number. Additionally, the clock needs to be set to UTC, so remember to add 7 hours to the current time if on regular time or 8 hours during Daylight Saving Time. For example, to set the clock to 1:58 PM on September 18th, 2009, the command would be 

decimal dev rtc 00 58 20 18 09 2009 set-time

To reset the NVRAM type the following commands in the specified order: 

reset-nvram
set-defaults
reset-all

The system will reboot after the reset-all command is entered.

Install Ubuntu

Please note that any values not explicitly defined here (HTTP proxies and such) should be left blank.

  1. Make sure network cable is attached
  2. Insert Ubuntu CD
    • Use 8.04 for iMac G5s
    • Use 9.04 for all other systems
  3. Start up the system while holding the C key on the keyboard
  4. At boot: prompt, press Enter; eventually the install screen will appear
  5. Select English as the language for the installation and United States as the country
  6. Enter No for keyboard detection, and select USA for all keyboard language options
  7. If prompted for which network device to use, select the wired network
  8. When prompted for a hostname, delete the current entry and enter macbox in its place
  9. Select Pacific as the time zone
  10. When prompted for HD partitioning, select the Guided - use entire disk option, and confirm the HD the changes will be made to (there should only be one option available unless there are multiple HDs in the system)
  11. When asked about writing the changes to disk, select Yes
    • At this point, the base system will begin installing, so prepare to wait for a few minutes
  12. When prompted for the user's full name, enter oem
  13. When prompted for a username for the account, enter oem
  14. When prompted for a password, enter freegeek. You will be asked to verify the password after entering it. Enter freegeek again. If the passwords don't match, it will prompt you for a password again
  15. If asked to provide a HTTP proxy, leave it blank and press Enter
  16. If asked to download additional language support, select Yes
  17. If asked to encrypt the user's home directory, select No
  18. When asked if the system clock is set to UTC, select Yes
  19. When installation is complete, select the Continue option to reboot the system
Start up Ubuntu
  • Let the system use its default options in the bootloaders during the startup process
  • If the system has problems starting up, refer to the Special Configurations list
Verify hardware in the system

To verify the hardware in a system, open up a terminal and run: 

sudo lshw|less

This runs a command called lshw (which stands for "list hardware") and sends the output to another command called less, which is a simple reader that allows you to scroll through lshw's output. The items to pay attention to are:

  • Amount of system memory
    • You should be able to find this under the memory heading in lshw. It should be the same as the physical amount of memory in the system.
  • Type of optical drive
    • This can be found under the cdrom heading in lshw. To determine the actual capability of the drive, search for the information under product in Google.
  • Presence of wireless card
    • This should be under one of the network headings. You should look for an entry that mentions something about "Wireless interface" or "Broadcom". If that exists, the system has a wireless card.
Set up the environment and install extra apps
  • Add the Terminal to the panel so it can be launched quickly
  • If the machine has a DVD drive, open up a terminal and run:
sudo apt-get install vlc
  • If the machine has a wireless card, open up a terminal and run:
sudo apt-get install b43-fwcutter
    • Restart the system after installing b43-fwcutter in order to get the change working properly.
Test USB ports

USB:

  • Plug in a USB mouse
  • See that the cursor moves and can interact with things
  • Repeat with all USB ports

If any port doesn't work, the machine should be recycled

Test CD/DVD data and sound
  1. Insert, play, and eject a music CD
  2. Insert data CD, inspect directory contents
  3. If machine has a DVD drive:
    • insert a data DVD, inspect directory contents
    • insert a video DVD and play it using vlc
  4. If machine has a CD-RW or DVD-RW, use brasero to erase a CD-RW disk, and create/burn a new data project.

Note: Brasero has problems with versions of Ubuntu before Karmic (9.10). For Hardy (8.04LTS) and Jaunty (9.04) you may want to install and use k3b instead: sudo apt-get install k3b

Check if wireless works

Use Network Manager to see if you can connect to Free Geek's wireless network. If you can, the wireless card works. Remember to write the type of wireless card (e.g. AirPort, AirPort Extreme) on the printed report at the end of the build.

Check for software updates

There are a few ways to do this:

  • From the desktop, go to System -> Administration -> Update Manager
  • From the command line, run:
sudo apt-get update
sudo apt-get upgrade

Install all updates if any are found

Generate "printme" report for system
  1. In a terminal, generate a lshw XML file for the printme process
    • sudo lshw -xml > printme.xml
  2. Open a web browser and go to http://data/spec_sheets/new
  3. Fill out the form with the following:
    • Enter your volunteer ID in the Volunteer ID field
    • Job should be changed to Builder
    • System ID should be left blank
    • Type should be changed to Laptop
    • Keeper label type should be set to No Sticker
    • Notes should include the following information:
      • Version of Ubuntu installed
      • Any components that show up in lshw (modems, certain wireless cards) that aren't supported by Ubuntu should be listed
      • Any special issues the machine has
      • Whether the computer is covered or not
  4. Upload the XML file, and print out the report
  5. When asked where to print the report, select the Print to File option at the top of the printer list in the Print window
  6. Select PDF as the output format, and save the file to the desktop as build_printme.pdf
Power system down and place on the QC shelf in TARDIS

What follows is Roy's simplified laptop build checklist:

Build

Steps Notes/Detailed Instructions Done
Attach network cable and power cord
Clear the PRAM

While starting up, hold the Option+Apple+p+r keys. Continue holding the keys until the system chimes three times. Release the keys after the third chime is heard and shift quickly to the Option+Apple+o+f keys.

Set the system clock and NVRAM in Open Firmware

While starting up, hold the Option+Apple+o+f keys. Release the keys when the Open Firmware prompt comes up. Run the following command: 

decimal dev rtc [sec min hour day month year] set-time

All values aside from the year should be two-digit numbers in 24-hour format. The year should be a four-digit number. Additionally, the clock needs to be set to UTC, so remember to add 7 hours to the current time if on regular time or 8 hours during Daylight Saving Time. For example, to set the clock to 1:58 PM on September 18th, 2009, the command would be 

decimal dev rtc 00 58 20 18 09 2009 set-time

To reset the NVRAM type the following commands in the specified order: 

reset-nvram
set-defaults
reset-all

The system will reboot after the reset-all command is entered.

Run badblocks to wipe the hard drive

To run badblocks we start the process as if we were doing a network installation. To access this install, hold down the n key (for network) while the computer starts. As soon as the network icon starts blinking on the screen you may release the n key.

  1. At the first boot prompt enter an l (for linux) to install the current version of Ubuntu.
  2. The installation will stop at the keyboard selection. Accept the defaults (No or USA) for the next 3 screens and the installation will continue automatically.
  3. When prompted for a hostname, delete the current entry and enter macbox in its place
  4. When prompted for HD partitioning, choose "Go Back" and then select "Execute a shell" from the menu. At the prompt type "badblocks -wvvf -c1024 /dev/hda" and hit enter. If that command fails, try "badblocks -wvvf -c1024 /dev/sda" instead. It will take about 3 hours to run badblocks.

If there are any bad blocks we must replace the hard drive. If there are no bad blocks, you can proceed with the installation. To do this type "exit" to leave the shell, select "Partition drives" from the list, accept the defaults and the rest of the installation will proceed automatically. The installation will take approximately 30 minutes and the computer will automatically reboot following the installation.

Install Ubuntu via the network

If you have installed a tested and wiped hard drive, or if you have completed badblocks, you are ready to install Ubuntu. We are currently using a network installation of Ubuntu. To access this install, hold down the n key (for network) while the computer starts. As soon as the network icon starts blinking on the screen you may release the n key.

  1. At the first boot prompt enter an l (for linux) to install the current version of Ubuntu.
  2. The installation will stop at the keyboard selection. Accept the defaults (No or USA) for the next 3 screens and the installation will continue automatically.
  3. When prompted for a hostname, delete the current entry and enter macbox in its place
  4. When prompted for HD partitioning, accept the default and the rest of the installation will proceed automatically. The installation will take approximately 30 minutes and the computer will automatically reboot following the installation.
Start up Ubuntu
Set up the environment and verify hardware in the system
  • Add the Terminal to the panel so it can be launched quickly. You can do this by dragging and dropping the terminal icon to the top task bar.

To verify the hardware in a system, open up a terminal and run: 

sudo lshw

This runs a command called lshw (which stands for "list hardware") The items to pay attention to are:

  • Amount of system memory
    • You should be able to find this under the memory heading in lshw. It should be the same as the physical amount of memory in the system.
  • Type of optical drive
    • This can be found under the cdrom heading in lshw.
  • Presence of wireless card
    • This should be under one of the network headings. You should look for an entry that mentions something about "Wireless interface" or "Broadcom". If that exists, the system has a wireless card.
  • This is a good time to shut down the system and install additional memory or a wireless card if they are missing. Ubuntu will not run well with 256MB of memory and will sometimes generate errors that don't occur when 512MB or more memory is installed.
Test CD/DVD data and sound
  1. Insert, play, and eject a music CD
  2. If machine has a CD-RW or DVD-RW, use brasero to erase a CD-RW disk, and create/burn a new data project.
  3. If machine has a DVD drive:
    • insert a data DVD, inspect directory contents
Check if wireless works (if the system has a wireless card)

Use Network Manager to see if you can connect to Free Geek's wireless network. If you can, the wireless card works.

Test battery life

To start the battery test:

  1. Make sure battery is fully charged
  2. Open a web browser and go to http://llama.freegeek.org/~serge/batterytest.sh
  3. Save file to disk
  4. Insert an audio CD into optical drive
  5. Launch audio player, play disc, set on repeat and mute the speaker.
  6. In a terminal, navigate to the directory you saved batterytest.sh to and run:
    • sh batterytest.sh
  7. Disconnect power supply
  8. Leave the system running until it powers off

To check the results of the battery test

  1. In a terminal, navigate to the directory you saved batterytest.sh to and run:
    • sh batterytest.sh
  2. Record the results in the notes section of the "printme" report
Generate "printme" report for system
  1. Make sure you are on the local wired network
  2. Configure system so it can use network printers
    1. From the desktop, go to System -> Administration -> Printing
    2. In the Printer Configuration window, go to Server -> Settings...
    3. Check the "Show printers shared by other systems" checkbox, and click the OK button. Close the printing window.
  3. In a terminal, type printme
    • Enter your volunteer ID in the Volunteer ID field
    • Job should be changed to Builder
    • System ID should be left blank
    • Type should be changed to apple laptop
    • Keeper label type should be set to No Sticker
    • Choose whether the computer is covered or not
    • Notes should include the following information:
      • Results of battery test
      • Version of Ubuntu installed
      • Any components that show up in lshw (modems, certain wireless cards) that aren't supported by Ubuntu should be listed
      • Any special issues the machine has
  4. When asked where to print the report, select the printer Double.
Power down the system, attach the printme sheet, and take to the store or place on storage shelf as appropriate.

QC (in progress)

Steps Notes/Detailed Instructions Done
Attach network cable and power cord
Verify that the splash screen works or that the system generates startup messages

When powering on the system, you should see the Ubuntu splash screen on most before the desktop finishes loading. It's fine if the colors are irregular, as long as something is displayed. If the splash screen doesn't work, it should at least display startup messages. If no splash screen or startup messages are displayed, go through the steps in the Special Configuration to resolve the problem.

Verify hardware in the system

To verify the hardware in a system, open up a terminal and run: 

sudo lshw|less

This runs a command called lshw (which stands for "list hardware") and sends the output to another command called less, which is a simple reader that allows you to scroll through lshw's output. The items to pay attention to are:

  • Amount of system memory
    • You should be able to find this under the memory heading in lshw. It should be the same as the physical amount of memory in the system.
  • Type of optical drive
    • This can be found under the cdrom heading in lshw. To determine the actual capability of the drive, search for the information under product in Google.
  • Presence of wireless card
    • This should be under one of the network headings. You should look for an entry that mentions something about "Wireless interface" or "Broadcom". If that exists, the system has a wireless card.
Test CD/DVD data and sound
  1. Insert, play, and eject a music CD
  2. Insert data CD, inspect directory contents
  3. If machine has a DVD drive:
    • insert a data DVD, inspect directory contents
    • insert a video DVD and play it using vlc
  4. If machine has a CD-RW or DVD-RW, use brasero to erase a CD-RW disk, and create/burn a new data project.

Note: Brasero has problems with versions of Ubuntu before Karmic (9.10). For Hardy (8.04LTS) and Jaunty (9.04) you may want to install and use k3b instead: sudo apt-get install k3b

Check if wireless works (if the system has a wireless card)

Use Network Manager to see if you can connect to Free Geek's wireless network. If you can, the wireless card works.

Check for software updates

There are a few ways to do this:

  • From the desktop, go to System -> Administration -> Update Manager
  • From the command line, run:
sudo apt-get update
sudo apt-get upgrade

Install all updates if any are found

Verify printme notes

Locate the 'build_printme.pdf file on the desktop. Open it up and make sure that the notes written on the Build printme sheet accurately reflect the components and special issues with the system. If they are not accurate, please make any necessary changes when you create the printme printout for the QC process.

Test battery life

To start the battery test:

  1. Make sure battery is fully charged
  2. Open a web browser and go to http://llama.freegeek.org/~serge/batterytest.sh
  3. Save file to disk
  4. Insert an audio CD into optical drive
  5. Launch audio player, play disc, and set on repeat
  6. In a terminal, navigate to the directory you saved batterytest.sh to and run:
    • sh batterytest.sh
  7. Disconnect power supply
  8. Leave the system running until it powers off

To check the results of the battery test

  1. In a terminal, navigate to the directory you saved batterytest.sh to and run:
    • sh batterytest.sh
  2. Record the results in the notes section of the "printme" report
Generate "printme" report for system
  1. Make sure you are on the local wired network
  2. Configure system so it can use network printers
    1. From the desktop, go to System -> Administration -> Printing
    2. In the Printer Configuration window, go to Server -> Settings...
    3. Check the "Show printers shared by other systems" checkbox, and click the OK button
  3. In a terminal, generate a lshw XML file for the printme process
    • sudo lshw -xml > printme.xml
  4. Open a web browser and go to http://data/spec_sheets/new
  5. Fill out the form with the following:
    • Enter your volunteer ID in the Volunteer ID field
    • Job should be left as Quality Checker
    • System ID should be filled in with the system ID listed in build_printme.pdf
    • Type should be changed to Laptop
    • Keeper label type should be set to No Sticker
    • Notes should include the following information:
      • Version of Ubuntu installed
      • Any components that show up in lshw (modems, certain wireless cards) that aren't supported by Ubuntu should be listed
      • Any special issues the machine has
      • Whether computer is covered or uncovered
      • Battery life
  6. Upload the printme.xml file, and print out the report
  7. Remember to add the wireless card type
Clean outside cover

Clean case monitor face, connector panel, keyboard, and trackpad as well

Attach "printme" report to system
Bundle system with power supply
Give the laptop to an instructor
Retrieved from "http://wiki.freegeek.org/index.php?title=MacBuild_PPC_Checklist&oldid=48275"