A Collection stick is a USB drive with a program on it that collects data in order to request developer keys. Developer keys are the unique cryptographic signatures for XO laptops that permit access to the system firmware.
What you will need:
- a USB drive, preferably FAT formatted, does not need to be empty,
- a computer with Internet access, and;
- the group of XO laptops, which may be nearby or distant.
What you do is:
- make a collection stick,
- use the collection stick on the group of XO laptops,
- request the keys using the data on the collection stick,
- receive the keys,
- make an unlock stick using the files received,
- use the unlock stick on the group of XO laptops.
On the computer with Internet access:
- Insert the USB drive,
- Delete any file with name left over from previous use,
- Delete any directory with name ,
- Create a new directory with name in the top level of your USB drive.
- Download Actos.zip and Runos.zip into that directory.
You should now have a USB drive containing a directorywhich contains two files , and . This is a collection stick ready to use.
For each XO in the group:
- make sure the laptop is off, (e.g. check for a blinking power indicator),
- plug the USB drive into the laptop,
- turn on the laptop,
- wait about ten seconds for a short message that looks like this:
SHC016013D1 20150126T064008Z Laptop data recorded successfully. Powering off ...
- wait for the laptop to turn off,
- remove the USB drive from the laptop.
(The collection stick may do nothing if the laptop is unlocked already, hold the '×' game pad key to force "secure" booting.)
When you have done this on all the XOs you need keys for, move to the next step below.
Plug the USB drive into the computer with Internet access and then either:
- for individuals and small groups, open OLPC Activation Service, and follow the instructions there to generate each developer key, saving them as separate files, , treat the first number as a serial number and the second as UUID, and enter them on
- for larger groups, attach the file from the USB drive to an email to your OLPC or deployment contact. This may take several days.
You will receive back one or two files from OLPC after submitting yourfile.
- If you requested a developer key: You will get a file called . It contains a developer key for each laptop.
- If you requested an activation key: You will get a file called . It contains an activation key for each laptop.
You are now ready to make an unlock stick.
- Insert a USB drive (this can be the Collection stick; but you must rename the directory to something else like . If you don't do this, your laptop will just re-run the collection.)
- If you have a file called , make a directory called at the top of your USB drive and copy this file into it.
- If you have a file called , copy this file into the top of your USB drive.
You should now have a USB drive containing either a directorywhich contains , or in the top of the drive. This is an unlock stick ready to use.
For each XO in the group:
- Make sure the XO is powered off.
- Plug the USB drive into the XO, then power it on.
That's it! Note that this process only unlocks your XO for one boot - if you want to unlock your XO permanently without needing to plug in the USB drive every time you boot, see #Permanently unlocking with an Unlock stick.
No action is required. Activation keys are automatically copied toon your XO. Keep the activation key around (or copy it to your School Server) in case you later need to reflash the XO.
When the XO boots the first time, you should see a textual prompt, which you will see within the first few seconds of booting (along with a short countdown to give you time to hit the , Escape key). This is your indication that the Developer key on the Unlock stick has been found.
Permanently unlocking with an Unlock stick
To permanently disable secure booting on each laptop, add this text to a filein the directory on the Unlock stick:
\ Open Firmware disable-security
Then insert the USB drive into each laptop and turn it on. Watch. The laptop will reboot once or twice. Wait for the Ok prompt to appear on screen. The laptop is now unlocked permanently.
It works like this; when the laptop turns on, it searches for the Ok prompt appears.file, validates it, then switches to unsecure mode, then searches for the file and runs it. The contains the command, which disables the security system and reboots. One the second boot, with the security system already disabled, does nothing, and so the
Once you do this, you will not need the Developer key on the laptop, but you can keep it in case security is ever enabled.
When providing remote support for the owner of a laptop, properly creating directories and files may be a challenge. To alleviate this, prepare afile for them to unpack onto their USB drive:
- make a directory to work in,
- make the directories and files that they would have to make,
- make a of the working directory,
- check the file carefully,
- send the file and ask the owner to expand it on a USB drive, insert it in the laptop, power on, and tell you what happens.
Unlocking only until the next reinstall or upgrade
The firmware checks for the Developer key on all available storage, which is why an Unlock stick works the way it does. But this means you would need to keep the Unlock stick handy to use it.
Alternatively, you can copy Developer key to your laptop's internal flash memory. Copy Terminal activity type:from the USB drive into on the XO. In a
sudo cp /run/media/olpc/USBDRIVE/security/develop.sig /security/develop.sig
Where USBDRIVE is the volume label of the USB drive.
- (Note that was used instead of before 12.1.0).