You are viewing outdated content for BUG. If you have a BUG Y.T. edition or 2.0 series device, please visit our updated wiki: http://wiki.buglabs.net



Upgrading BUG Kernel

From BUG Wiki

Jump to: navigation, search

Contents

Overview

Please review this link before running these instructions: Keeping your kernel and rootfs up to date

These instructions are for upgrading a BUG kernel on a BUG with Redboot boot loader. They requires a BUG that is connected to a computer with SSH and SCP available. Please note the default root password on the BUG is 'root'.

AFTER upgrading your BUG kernel, you may (and for R1.3 to R1.4 you definitely do) also need to flash your SDmicro with the rootfs if a new version is available. Instructions for updating your rootfs can be found here: Update your BUG memory card

The following assumes you are upgrading from R1.3 to R1.4. If you are upgrading from R1.2 or earlier, please see Upgrading_BUG_Kernel_(1.2_to_1.3).

If you have any problems or questions, try browsing the pages for BUG developers for more resources, or contact us.

Upgrading BUG Kernel – Linux

Step 1: Getting new kernel onto the BUG

  1. Download the kernel image from the Bug Labs website. The kernel images are available at http://bugcommunity.com/downloads.
  1. Transfer the kernel to your BUG. From a terminal, shell, or other SCP program copy the kernel image into the BUG root home directory:
# scp zImage-BUG-R1.4.bin root@10.10.10.10:/home/root
root@10.10.10.10's password: 
zImage-BUG-R1.4.bin
# 

Step 2: Initializing BUG for flashing

The BUG Linux release R1.2 and later include a Linux kernel module (called bug_kflash), and an application (also called bug_kflash) that are used to upgrade the BUG.

  1. SSH to the BUG as root:
# ssh root@10.10.10.10
root@10.10.10.10's password: 
root@10.10.10.10:~#
  1. Load the bug_kflash kernel module. Note: If your BUG is running R1.4 or later skip this step
root@10.10.10.10:~# modprobe bug_kflash
root@10.10.10.10:~#

Step 3: Flashing the kernel

  1. Move the kernel image so that the bug_kflash application can find it:
root@10.10.10.10:~# ln -s /home/root/ /root
root@10.10.10.10:~# mv /root/zImage-BUG-R1.4.bin /root/new_zImage_bug
  1. Run the bug_kflash application. Please be patient, it takes several minutes to complete.

Note: If your BUG is running R1.4 or later just execute the following command: bug_kflash

root@10.10.10.10:~# /usr/bin/bug_kflash  
>>> CAUTION - ERASING FLASH (WAIT ...) <<<


>>> CAUTION - PROGRAMMING FLASH (WAIT ...) <<<

programming block at offset 0x0 ...
programming block at offset 0x10000 ...
...
programming block at offset 0x1a0000 ...

>>> CAUTION - PROGRAMMING FLASH (WAIT ...) <<<


>>> PROGRAMMING COMPLETE <<<

root@10.10.10.10:~#

Step 4: Verifying the upgrade

  1. Reboot your BUG: (Note, you may have to manually power off the BUG if it does not respond within a minute.)
root@10.10.10.10:~# /usr/bin/reboot
  1. Check the kernel version, after logging back into BUG:
root@10.10.10.10:~# cat /proc/version 
Linux version 2.6.27.2 (buildbot@darner) (gcc version 4.1.2) #104 PREEMPT Mon Mar 16 00:23:14 EDT 2009


That's it! We hope you enjoy all the new features that the kernel upgrade contains.


Upgrading BUG Kernel - Windows

Step 1: Getting new kernel onto the BUG

  1. Download the kernel image from the Bug Labs website. The kernel images are available at http://bugcommunity.com/downloads
  1. Transfer the kernel to your BUG. Windows users will need a SCP program copy the kernel image into the BUG root home directory. A good open source option is WinSCP that you can download | here.

WinSCP Graphical User Interface:

  1. Create a session to root@10.10.10.10 (password is also root):

Image:Winscp_session.JPG

  1. Drag and drop zImage-BUG-R1.4.bin into /home/root

Image:Win_scp.JPG

Step 2: Initializing BUG for flashing

The BUG Linux release R1.2 and later include a Linux kernel module (called bug_kflash), and an application (also called bug_kflash) that are used to upgrade the BUG. Putty is good SSH client which can be downloaded here.

  1. Create and connect with a Putty Session:

Image:Putty_example.JPG

  1. Load the bug_kflash kernel module. Note: If your BUG is running R1.4 or later skip this step
root@10.10.10.10:~# modprobe bug_kflash
root@10.10.10.10:~#

Step 3: Flashing the kernel

  1. Move the kernel image so that the bug_kflash application can find it:
root@10.10.10.10:~# ln -s /home/root/ /root
root@10.10.10.10:~# mv /root/zImage-BUG-R1.4.bin /root/new_zImage_bug
  1. Run the bug_kflash application. Please be patient, it takes several minutes to complete.

Note: If your BUG is running R1.4 or later just execute the following command: bug_kflash

root@10.10.10.10:~# /usr/bin/bug_kflash  

>>> CAUTION - ERASING FLASH (WAIT ...) <<<
 

>>> CAUTION - PROGRAMMING FLASH (WAIT ...) <<<

programming block at offset 0x0 ...
programming block at offset 0x10000 ...
...
programming block at offset 0x1a0000 ...

>>> CAUTION - PROGRAMMING FLASH (WAIT ...) <<<


>>> PROGRAMMING COMPLETE <<<

root@10.10.10.10:~#

Step 4: Verifying the upgrade

  1. Reboot your BUG: (Note, you may have to manually power off the BUG if it does not respond within a minute.)
root@10.10.10.10:~# /usr/bin/reboot
  1. Check the kernel version, after logging back into BUG:
root@10.10.10.10:~# cat /proc/version 
Linux version 2.6.27.2 (buildbot@darner) (gcc version 4.1.2) #104 PREEMPT Mon Mar 16 00:23:14 EDT 2009


That's it! We hope you enjoy all the new features that the kernel upgrade contains.


Upgrading BUG Kernel – Mac OS X

Step 1: Getting new kernel onto the BUG

  1. Download the kernel image from the Bug Labs website. The kernel images are available at http://bugcommunity.com/downloads.
  1. Transfer the kernel to your BUG. From a terminal, shell, or other SCP program copy the kernel image into the BUG root home directory:
# scp zImage-BUG-R1.4.bin root@10.10.10.10:/home/root
root@10.10.10.10's password: 
zImage-BUG-R1.4.bin
# 

Step 2: Initializing BUG for flashing

The BUG Linux release R1.2 and later include a Linux kernel module (called bug_kflash), and an application (also called bug_kflash) that are used to upgrade the BUG.

  1. SSH to the BUG as root:
# ssh root@10.10.10.10
root@10.10.10.10's password: 
root@10.10.10.10:~#
  1. Load the bug_kflash kernel module. Note: If your BUG is running R1.4 or later skip this step
root@10.10.10.10:~# modprobe bug_kflash
root@10.10.10.10:~#

Step 3: Flashing the kernel

  1. Move the kernel image so that the bug_kflash application can find it:
root@10.10.10.10:~# ln -s /home/root/ /root
root@10.10.10.10:~# mv /root/zImage-BUG-R1.4.bin /root/new_zImage_bug
  1. Run the bug_kflash application. Please be patient, it takes several minutes to complete.

Note: If your BUG is running R1.4 or later just execute the following command: bug_kflash

root@10.10.10.10:~# /usr/bin/bug_kflash  

>>> CAUTION - ERASING FLASH (WAIT ...) <<<


>>> CAUTION - PROGRAMMING FLASH (WAIT ...) <<<

programming block at offset 0x0 ...
programming block at offset 0x10000 ...
...
programming block at offset 0x1a0000 ...

>>> CAUTION - PROGRAMMING FLASH (WAIT ...) <<<


>>> PROGRAMMING COMPLETE <<<

root@10.10.10.10:~#


Step 4: Verifying the upgrade

  1. (If you are upgrading from R1.3 to R1.4, first upgrade your root FS AND then follow these steps to verify your upgrade) Reboot your BUG: (Note, you may have to manually power off the BUG if it does not respond within a minute.)
root@10.10.10.10:~# /usr/bin/reboot
  1. Check the kernel version, after logging back into BUG:
root@10.10.10.10:~# cat /proc/version 
Linux version 2.6.27.2 (buildbot@darner) (gcc version 4.1.2) #104 PREEMPT Mon Mar 16 00:23:14 EDT 2009


That's it! We hope you enjoy all the new features that the kernel upgrade contains.