{% extends "admin/firmware/base_build.html" %} {% load absurl 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

The CONFINE wiki contains more information on node upgrade page.
If your node is running a firmware older than June 2015 follow specific instructions for nodes with old firmware.

Getting the firmware image

  1. Download through your computer (recommended)
    1. The firmware can be downloaded from this page into your computer.
    2. Then upload the firmware to the node:
      1. In the general case, you may use scp to copy the image into the node's temporary directory (with whatever NODE_ADDRESS reachable from your computer):
      2. {% code 'bash' False %}scp '{{ build.image_name }}' root@NODE_ADDRESS:/tmp{% endcode %}
      3. 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:
      4. {% code 'bash' False %}scp '{{ build.image_name }}' root@[{{ node.mgmt_net.addr }}]:/tmp{% endcode %}
      5. 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:
      6. {% code 'bash' False %}# 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.

  2. Direct download to the node (may be insecure)

    Maybe you want to download the firmware directly to the node to avoid uploading it using a low bandwith connection. This method is discouraged because of security concerns (see node upgrade for more details). Use it at your own risk!

    {% code 'bash' False %}ssh root@NODE_ADDRESS cd /tmp curl -u {{ request.user.username|default:request.user.email }} -k -O {% absurl build.image.url %} # It will ask for your controller account password.{% endcode %}

Installing the firmware image

You can use ssh to access the node and run the following commands, which are the recommended way for flashing the image in a node which is already running the CONFINE node system software:

{% code 'bash' False %}ssh root@NODE_ADDRESS cd /tmp confine.sysupgrade -n {{ build.image_name }}{% endcode %}

For systems lacking confine.sysupgrade, please refer to first-time installation section. {% endif %}{# end instructions #}

{% endblock %}