Autoreinstallation image/lang-es

Imagen de Reinstalación Automática

  Esta página está supervisada por el equipo de OLPC.

This is an on-going translation

Hemos trabajado muy duro para hacer lo más fácil posible la actualización de una máquina en el terreno. Hasta que el booteo y actualización vía red este disponible, esta es la forma más fácil.

La imagen de Autoreinstalación consiste de un script Open Firmware que actualiza la memoria flash NAND y el firmware con las últimas versiones estables, sin otro requerimiento excepto el instertar una llave USB previamente preparada y prender la máquina.

NOTA

este procedimiento crea una llave o disco USB que al ser booteado en una laptop OLPC, actualiza su BIOS e instala (SOBRE-ESCRIBE) la imagen del sistema operativo sobre la memoria flash NAND. NUNCA bootee desde esta llave o disco USB a menos que desee actualizar el sistema, que borrará totalmente la memoria flash del mismo.

We've worked very hard to make it as easy as possible to update a machine in the field. Until network boot and update is available, this is as easy as it can get.

The Autoreinstallation image consists of an Open Firmware script that updates the NAND flash and firmware with the latest stable images, without requiring the user to do more than insert a prepared USB disk and turn on the machine.

NOTE: this procedure creates a USB flash key or disk that when booted on an OLPC laptop, updates its BIOS and installs (OVERWRITES) an operating system image onto NAND flash. NEVER boot this USB flash key or disk unless you intend to update your system, which will entirely erase anything you had on the flash memory of the system.

Este procedimiento funciona para todos los tipos de hardware OLPC, incluyendo las placas A-Test y la mayoría de los B1 (ver más abajo para los B1 viejos) y todos los B2. Si todavía utiliza la BIOS Insyde, se deberá primero actualizar el firmware siguiendo las instrucciones de como actualizar a LinuxBIOS.

Las Notas de Lanzamiento de Software documentan el estado de los puntos más relevantes de este software.

This procedure works for all types of OLPC hardware, including A-test boards and most B1 (see #Workaround for old B1 systems) and all B2 laptops. It works with both Open Firmware and Linux-as-BIOS installations - but does not work with Insyde BIOS. If you are still running Insyde BIOS, you will first have to upgrade the firmware using procedures described elsewhere.

The Software Release Notes document the status of the most important issues of this software.

Procedimiento de Actualización del Sistema

Antes de comenzar

enchufe la máquina y verifique que la batería esté cargada. Es muy importante que el proceso no sea interrumipido. Tomará solamente 2 minutos 15 segundos en total.

1. Descargue el archivo olpc406_c11.zip
   md5sum: 0de554d266e87344f8d25b7fd2cebb74 olpc406_c11.zip
2. Utilice una llave o disco USB con por lo menos 300 MiB en su partición primaria (no es necesario que esté particionado)
   • Si su sistema tiene Open Firmware, puede tener un formato FAT (de fábrica) o ext3—en cuyo caso, asegurese que el tipo de partición declarada (ej:83–Linux ext2 o ext3) sea tal y no FAT.
   • Si su sitema tiene Linux-como-BIOS, el dispositivo USB tiene que tener una partición primaria y un sistema de archivos tipo ext2 en ella, ya que el cargador (bootloader) Linux buscará en el dispositivo /dev/sda1
3. Descompacte los archivos en la raíz de la llave o disco USB, creando así el directorio boot. (De drag-n-drop de los archivos directamente del archivo .zip deberá crear dicho directorio manualmente). Para que la actualización se efectúe deben existir tres archivos en el directorio: q2c11.rom, nand406.img y olpc.fth. Un cuarto archivo bzimage debe encontrarse en la raíz.
   • No utilice un dispositivo USB para el cual se hayan reportado errores en el proceso de descompactación: los archivos pueden estar (probablemente esten) dañados. Como medida de seguridad extra, la BIOS OFW OLPC verifica la integridad de la imagen antes de flashear la BIOS.
4. Opcional - Si se desea instalar una Imagen del SO diferente al build 406, descargue la imagen JFFS2/lang-es correspondiente del repositorio, y guardelo como nandXXX.img (siendo XXX el número del build). Después edite olpc.fth, remplazando todas las ocurrencias de 406 por el número de build del archivo.
5. Inserte la llave en la máquina, y
   • Si tiene Open Firmware Q2C11 o posterior, mantenga una de las "teclas de juego" (game keys) cercanas a la pantalla mientras enciende la laptop; y suéltelo una vez que la pantalla se ilumine.
   • Si tiene Open Firmware, anterior a Q2C11 solo encienda la máquina.
   • Si tiene Linux-como-BIOS, cuando vea la barra de progreso, presione (Esc), y seleccione el icono USB, y presione (Enter).
   • Si esta utilizando un disco USB puede ser necesario interrumpir el proceso de booteo del Open Firmware presionando la tecla (Esc), esperar un momento, ingresar probe-usb2, lo cual debería proporcionar opciones extras a las iniciales. Después puede ingresar boot y la actualización debería continuar. Esto se debe a que los discos externos tardan mucho en estar listos. El último firmware debería solucionar esto.

Before you start: plug in your machine and ensure the battery is charged. It is very important that the update process not be interrupted. It will take about 2 minutes and 15 seconds total.

1. Download the file http://olpc.download.redhat.com/olpc/autoupdate/olpc406_c11.zip
   md5sum: 0de554d266e87344f8d25b7fd2cebb74 olpc406_c11.zip
2. Get a USB flash key or disk with at least 300 MiB of free space in the primary partition (it doesn't have to be partitioned at all). If your system currently has Open Firmware, the filesystem can be either FAT (like a factory-formatted device) or ext2. But it will not work if it is partitioned such that the partition type code says "83" (Linux ext2 or ext3) but the actual filesystem inside the partition is FAT. If your system has Linux-as-BIOS, the USB device must have a primary partition and an ext2 filesystem on it, as /dev/sda1 is the device that Linux as bootloader looks for.
3. Unzip the files at the root of the USB flash key or disk drive, thus creating a directory called "boot". (If you drag and drop the files from the zip archive, you'll have to create the "boot" directory manually on the flash or disk drive.) Three files must be in the directory named "boot", for the automatic update to occur: q2c11.rom; nand406.img; and olpc.fth. A fourth file, bzimage must be in the root directory. Do not use a flash key or disk for which there have been any errors reported during unzipping: the files may be (probably are) damaged. As a further safeguard, the OLPC OFW BIOS checks the integrity of any BIOS flash image before reflashing the BIOS.
4. (Optional) If you want to install an OS image besides build 406, download the appropriate jffs2 image from the image repository, and save it as nandXXX.img, where XXX is the number of the build. Then, edit olpc.fth, replacing 406 everywhere it occurs with the build number in the filename.
5. Insert the USB flash key into the machine. If you have Open Firmware Q2C11 or later, hold down one of the "game keys" next to the screen, while you press the power button to turn on the laptop; then release the game keys when the screen lights up. If you have Open Firmware before version Q2C11, just turn on the power. If you have Linux-as-BIOS, hit ESC when you see the boot progress bar, then choose the USB key icon and hit Enter.
6. If your USB device is a hard disk instead of flash, you may need to interrupt the Open Firmware boot sequence by pressing the Esc key (the upper left key on the keyboard, marked with an X in a circle), waiting a moment, then entering probe-usb2. You should see additional entries compared to the initial list that Open Firmware displayed. Then you can enter boot and the update should proceed. This is because many external hard drives take a long time to come ready. The latest firmware should fix this issue, however.

Se podrán observar una serie de mensajes como los de la siguiente sección a medida que el sistema es actualizado. La memoria flash NAND siempre tiene algun bloque malo: por lo tanto los mensajes del tipo "Skipping bad block" (salteando bloque malo) son normales, informando aquellos bloques que Linux jamás usará.

El sistema se apagará solo.

Si algo sale mal NO APAGUE LA MÁQUINA y solicite ayuda a la OLPC, preferentemente de forma inmediata vía IRC o por email.

Felicitaciones! Ha terminado! La próxima vez que encienda la máquina, tendrá la nueva imagen.

You will see messages like those in the following section as the system is updated. NAND flash always has some bad blocks: the "Skipping bad block" messages during writing NAND flash are therefore normal, informing you of the bad blocks that will never be used by Linux.

The system will automatically poweroff.

If anything goes wrong DO NOT TURN OFF THE MACHINE but please get help from OLPC, preferably immediately on IRC or by email.

Congratulations: you are finished! When you next power the machine on, you'll be running the new image.

Transcripción de una Actualización de Sistema

Release the game key to continue
OLPC B1, 256 MiB memory installed, S/N Unknown
Open Firmware CL1 Q2C08 Q2C

USB2 devices:
/pci/usb@f,5/wlan@3,0
/pci/usb@f,5/scsi@1,0
/pci/usb@f,5/scsi@1,0/disk
USB1 devices:
Type the Esc key to interrupt automatic startup
Boot device: /usb/disk:\boot\olpc.fth  Arguments:
Checking existing OS image on NAND FLASH
Existing OS build is 353

Updating OS image on NAND FLASH
Erasing...
1800
Skipping bad block at 0xc20000 = page 0x1840 = eblock 0x61
3ff40
Writing 80c blocks
80b
Done
Existing firmware version is q2c08

Updating firmware
Reading disk:\boot\q2c11.rom
Got firmware version: CL1 Q2C11 Q2C
Checking integrity ...
SPI FLASH is type 13 - Spansion, Winbond, or ST
Merging existing manufacturing data
Erasing
0
Writing
ff000
...
Done

En la mayoría de los casos, el sistema se apagará automáticamente después de haber terminado la actualización.

In most cases, the system will power-off automatically after the firmware is updated.

Posibles Problemas

• Es preferible no usar discos USB particionados. De estar particionado:
  1. El tipo de la partición debe corresponder con el tipo de sistema de archivos—un sistema de archivos FAT en una partición declarada como ext2 no funcionará.
  2. Los archivos del actualizador deben estar en la partición booteable, de no existir tal, en la primera.
• Los archivos principales (olpcboot.fth, nandNNN.img, q2bNN.rom) deben encontrarse en el subdirectorio /boot/. Esto ocurre automáticamente si se descompacta el archivo, pero si se hace hace por medio del drag-n-drop a veces disponible en el administrador de archivos (file manager), es posible que queden en cualquier otro lugar, y no va a funcionar—deben estar en /boot/. El archivo bzImage, que es necesario para la actualización de Linux-como-BIOS, va en la raíz.
• La versión actual de Open Firmware no soporta llaves USB que se auto-identifican como de clase "mass_storage/removable", en oposición a las más comunes "mass_storage/scsi", que sí son soportadas. La correción a este inconveniente está en camino, pero no está disponible por el momento. La forma de verificar es insertar la llave USB, encender el sistema y detener el proceso de booteo en la cuenta regresiva presionando la (Esc) y fijarse en la lista de "Dispositivos USB2". Si muestra un ítem similar a "/pci/usb@f,5/removable@1,0" su disco tiene dicho problema. (Si se está corriendo sobre una versión vieja de OFW que no muestra la lista de "Dispositivos USB2" automáticamente, ingrese "show-devs /usb" para verla). La solución se encuentra más abajo.
• El firmware actual tampoco puede utilizar dispositivos USB cuyo tamaño de sector de hardware no sea de 512 bytes. Para determinar el tamaño de sector de su dispositivo, se puede utilizar fdisk en Linux, que informará si el tamaño no es de 512 la primera vez que lo acceda. La solución es la misma que para el problema del "removible" más abajo.
• Varios dispositivos Multi-Función no funcionan.
• Si durante la actualización se ve el siguiente mensaje, intente renombrando el archivo olpc.7th en el directorio "/boot" de la imagen de actualización a "olpc-boot.7th".

Trying startup script disk:\boot\olpc-boot.7th
Can't open boot device

• En las placas ATest el servidor X puede no levantar. Puede ser que necesite armar una configuración personalizada.

• It is better if the USB disk is not partitioned. If it is partitioned:

1. The partition type must agree with the filesystem type - a FAT filesystem inside a partition marked ext2 won't work
2. The updater files should be in the partition that is marked as "bootable", or if there isn't one, in the first partition.

• The main files (olpcboot.fth, nandNNN.img, q2bNN.rom) must be in the boot/ subdirectory. That will happen automatically if you "unzip" the archive, but if you drag-and-drop from a file manager like file-roller, it is possible to put them anywhere, and that won't work. Those files must be in boot/ . (The bzImage file, which is needed to support upgrading from Linux-as-BIOS, goes in the root directory.)
• The current Open Firmware releases do not support USB keys that identify themselves as class "mass_storage/removable", as opposed to the more common "mass_storage/scsi", which is supported. (The fix for this problem is in the release pipeline, but that doesn't help for upgrading from existing firmware.) The way to check for this is to insert your USB key, power-on the system and stop the auto-boot by typing the Esc key (upper left key) at the countdown. Then look at the list of "USB2 devices". If you see an entry like "/pci/usb@f,5/removable@1,0", your disk has the problem. (If you are running an old version of OFW that does not display the "USB2 devices" list automatically, type "show-devs /usb" to see the list.) The workaround procedure is below.
• The current firmware also fails with USB devices whose hardware sector size is not 512 bytes. To determine the sector size of your device, you can use fdisk on the device under Linux, and it will tell you when it first accesses the device if the sector size is not 512. The workaround is the same as for the "removable" problem, i.e. the procedure below.
• Many Multi-Function devices do not work.
• If during the upgrade you see the following message, try renaming the file olpc.7th in the boot directory of the update image to olpc-boot.7th.

Trying startup script disk:\boot\olpc-boot.7th
Can't open boot device

• On an ATest board the X server may fail to start up. You may need to provide a custom configuration.

Solucion para sistemas B1 viejos

Si se tiene un sistema B1 que nunca ha sido actualizado, es muy importante que utilice el procedimiento de reinstalación en esta página primero; no intente usar la nueva herramienta "netnandwrite". La razón es que este procedimiento corrige automáticamente un error de fabricación en los datos de identificación almacenados en la FLASH del firmware, y actualiza el firmware, ninguno de los cuales es realizado por la herramienta basada en la red. También, algunos firmwares viejos no actualizarán la máquina con el script de auto-actualización. Si el procedimiento anterior no funciona, siga los siguientes pasos:

1. Inserte la llave con el auto-actualizador
2. Encienda la laptop y cuando diga "Press a key to interrupt" presiona una tecla;
3. En el cursor de 'Ok' ingrese "flash disk:\boot\q2c11.rom". La máquina se apagará cuando termine.
4. Encienda nuevamente la máquina y cargue el auto-actualizador normalmente; (Reflasheará la NAND con el nuevo build)

If you have a B1 system that has never been upgraded, it is very important to use this page's Autoreinstallation procedure for your first update; do not try to use the new "netnandwrite" tool first. The reason is that this procedure automatically fixes a manufacturing error in the identification data that was stored in the system firmware FLASH, and updates the firmware, neither of which is done by the network-based tool. Also, some old firmware will not update with the auto-update script. If the standard procedure above doesn't update, instead, follow these steps:Instead, follow these steps:

1. Insert the autoupdater key;
2. boot up the laptop and when it says "Press a key to interrupt" then press any key;
3. at the Ok prompt type "flash disk:\boot\q2c11.rom". The machine will turn off when finished.
4. power up again and boot the autoupdater normally; (It will reflash the NAND with the new build.)

Solución para "Removibles" o dispositivos con sectores grandes

• Apague el sistema
• Saque el disco USB con la imagen del actualizador
• Bootee Linux desde la NAND FLASH
• Inserte el disco USB
• Copie el archivo /bzImage del actualizador del sistema de archivos que se encuentra en el disco USB a /ofw.bzi en la raíz de la NAND FLASH de la máquina OLPC, ej:

 mount /dev/sda1 /mnt
 cp /mnt/bzImage /ofw.bzi

• Apague Linux
• Encienda, y presione la barra espaciadora en la cuenta regresiva del Open Firmware
• En el cursor 'Ok' del Open Firmware, ingrese lo siguiente, y el procedimiento de actualización debería proceder automáticamente:

 ok null$ to ramdisk  boot nand:\ofw.bzi

• Shut down the system
• Remove the USB disk that has the updater image
• Boot Linux from NAND FLASH
• Insert the USB disk
• Copy the file /bzImage from the updater filesystem on the USB disk file to /ofw.bzi in the root directory of the NAND FLASH on the OLPC machine, e.g.

 mount /dev/sda1 /mnt
 cp /mnt/bzImage /ofw.bzi

• Shutdown Linux
• Power on, and type space during the Open Firmware auto-boot countdown
• At the Open Firmware "ok" prompt, type the following, and the update procedure should then proceed automatically:

 ok null$ to ramdisk  boot nand:\ofw.bzi

Volver atrás

Si quiere cargar un build más viejo al que se encuentra en la XO, recibirá un mensaje informando que el software se encuentra actualizado. Para forzar una versión anterior, en el curosr OK ingrese:

copy-nand disk:\boot\nandXXX.img

Cuando termine, saque el USB y rebootee la XO. Puede ser necesario ejecutar el comando copy-flash.

If you are trying to load a build that is older than the one on the XO, you will get a message that the software is up to date. To force it to load an older version, at the OK prompt type:

copy-nand disk:\boot\nandXXX.img

When it completes, remove the USB and reboot the XO. You may also need to do a copy-flash command.