{% extends "admin/firmware/base_build.html" %} {% load code staticfiles %} {% block extrahead %} {{ block.super }} {% endblock %} {% block content %} {{ block.super }}
{% if build.kwargs_dict.usb_image %}{# usb plug-in #}

USB-installer instructions

Write the image to a USB drive

  1. Plug a USB stick in your computer.
  2. Write the image into the USB (Warning: change sdX for the USB device (something like sdb): {% code 'bash'%}gunzip -c | dd of=/dev/sdX bs=4M ; sync{% endcode %}

Install the firmware image

  1. Plug the USB stick in the research device
  2. Boot the RD (the installation will start automatically)
{% else %}{# standard instrucctions #}

Instructions

Upload the firmware image

The firmware can be downloaded from this page into your computer. Then upload the firmware to the node, for instance by using scp to copy the image into the node's temporary directory:

{% code 'bash' %}scp {{ build.image_name }} root@NODE_ADDRESS:/tmp{% endcode %}

Yoy may use whatever NODE_ADDRESS reachable from your computer. If the node is running the CONFINE node system software and both the node and your computer are on the testbed management network but at different locations, you may use the node's management address:

{% code 'bash' %}scp {{ build.image_name }} root@[{{ node.mgmt_net.addr }}]:/tmp{% endcode %}

If the node is running the CONFINE node system software and it is connected to the same local link as your computer, you may use the node's recovery address by first adding your computer to that network:

{% code 'bash' %}# Whatever address after "...2000:" works. ip addr add fdbd:e804:6aa9:1:2000::1234/64 dev eth0 scp {{ build.image_name }} root@[fdbd:e804:6aa9:1::2]:/tmp{% endcode %}

See Addressing in CONFINE for other addresses available in CONFINE nodes.

Install the firmware image

You can use ssh to access the node and enter its temporary directory:

{% code 'bash' %}ssh root@NODE_ADDRESS cd /tmp{% endcode %}

The following command can be used for flashing this image (remember to change the destination device).
WARNING! Be sure you execute these commands INSIDE the node, not in your own computer!

  1. If the node is already running the CONFINE node system software, using confine.sysupgrade is highly recommended: {% code 'bash' %}# This command will upgrade your node: confine.sysupgrade -n {{ build.image_name }}{% endcode %}
  2. Otherwise executing the following command may work for you: {% code 'bash' %}gunzip {{ build.image_name }} -c | dd of=/dev/sdX bs=1M; sync{% endcode %}

The CONFINE wiki contains more information on node upgrade.

{% endif %}{# end instructions #}
{% endblock %}