====================================================
Installing from a SD-WAN ISO for Debian 10
====================================================


Nodes can be provisioned using the ISO images available from the
management server. These bootable images automatically install and
configure Bonding on a device. Images are available in the ISO format
and must be `written to a USB
disk <../../provisioning-nodes/creating-bootable-usb-disks-from-iso-images.html>`__ or
burned to a CD-R/CD-RW. Only 64-bit (amd64) images are
available.

Due to its simplicity, this is the recommended installation method for
small to medium-sized installations.

Not all installation packages are contained in the ISOs. Packages and
configuration are downloaded during the installation process, so you
must have Internet access while provisioning with the custom ISOs.

.. note::
    Installation media for this should be regenerated regularly to ensure that
    the most recent version of bonding is being installed.

The Debian 10 installation media will provision a device with a base image of
Debian 10 which already has bonding installed. This method will install
whichever version of bonding the installer was created with.

The installation process expects networking to be available so that it can
download the initial configuration. By default, DHCP will be performed on all
interfaces until a working network is found. If a DHCP server is not available
see :ref:`custom-networking-during-installation` to configure static
networking.

The installer will ask you to confirm you want to overwrite the existing disk
and then install the image onto the device. The installer will then ask you for
the node key. You can leave this blank to setup as a default bonder, or enter a
key to download and apply the node's configuration.

.. _installing from ISO Debian 10:

Downloading ISO files
----------------------

The provisioning ISOs are available in the Space section of the
application, under the Node Setup tab of a space page. This tab is shown
only to users who have the "node setup" permission.

First load the list of spaces:

|image0|

Then select the space whose ISO you want to download:

|image1|

Finally, load the Node Setup tab:

|image2|

If no ISOs are listed, the space has been configured not to have its own
ISO files. In this case, do one of the following:

#. `Update the space settings <../../../spaces/managing-spaces.html>`__ so that
   ISOs are created for the space, or ask an administrator to do so if
   you don't have the appropriate permissions.
#. Ask an administrator in the parent space for the URL of an ISO file
   from the parent space. The ISO can be used to image a node in your
   own space, but will have the default root password specified in the
   parent space.

Mounting the ISO
-----------------

The ISO file needs to be made available to the node hardware somehow.
After loading the ISO, you'll also need to update the BIOS so the
hardware boots from it; please refer to your hardware instructions or
review the steps for some `common bonder
hardware <../../updating-hardware-bios-serial-and-boot-settings.html>`__.

Use one of the following methods:

Virtual guest CD-ROM
+++++++++++++++++++++

When imaging a virtual guest, use your virtualization provider's console
to mount the ISO in the guest's CD drive.

.. seealso::
    See our `documentation on virtualization best practices <../../supported-environments-for-nodes.html#virtualization-best-practices>`__ for configuration requirements
    and recommendations.

USB disk
+++++++++

Create a bootable USB disk from the ISO file by following the
instructions at `Creating bootable USB disks from ISO
images <../../provisioning-nodes/creating-bootable-usb-disks-from-iso-images.html>`__.

DVD
++++

.. note::
    The  Debian 10 installation media is too large to fit on a CD.

For instructions on burning ISO images to DVD, refer to documentation from your
DVD-ROM drive manufacturer or operating system vendor.

Terminal interface
-------------------

If the installation disk or CD is not the highest boot priority, the BIOS will
have a boot menu that will let you select or reorder device boot order. Some
common keys are :code:`tab`, :code:`F12`, :code:`F10`, :code:`F8` or
:code:`F2`. Consult manufacturer documentation details.

|image3|

After selecting ``Install Bonding``, the boot menu will present the following 3 console options:

|image4|

* ``Console: Graphical``: install using a physical display and keyboard connected to the device.
* ``Console: Serial 1 (ttyS0)``: install using the first serial interface of the device,
  with 115,200 baud, no parity, 8 data bits, 1 stop bit, and no flow control.
* ``Console: Serial 2 (ttyS1)``: install using the second serial interface of the device,
  with all of the same remaining options listed above.

.. note::
    Devices come with a variety of default serial settings. You may need to
    update the serial settings of the device to 115,200 baud. To change the
    settings, refer to the manufacturer's documentation or read `these examples
    <../../updating-hardware-bios-serial-and-boot-settings.html>`__.

After the install option is selected, you are presented with the following network options:

|image5|

* ``Network: DHCP``: Setup IP on the bonder using DHCP.
* ``Network: Static``: Setup static IP on bonder, usually used when setting up aggregators. Follow :ref:`this<custom-networking-during-installation>` to set it up.
* ``Network: None``: No network will be configured and it will need to be set up manually after install.

After the network option is selected, the boot menu will present the following install options:

|image6|

* ``With node key``: the install will prompt for a node key and download the node's configuration from the management server.
* ``Default bonder``: the install will not prompt for a node key and will provision the device as a default bonder.

After selecting the install options, you will be presented with a screen that asks to confirm the options that you have selected so far. If you want to modify, press the ``ESC`` button.

|image7|

After confirmation, you may be prompted to destroy all data on the disk. Select "Yes" to continue with the bonding install.

|image8|

|image9|

.. |image0| image:: /attachments/10715533/11668216.png
.. |image1| image:: /attachments/10715533/11668218.png
.. |image2| image:: /attachments/10715533/11668219.png
.. |image3| image:: /attachments/10715533/grub-menu.png
.. |image4| image:: /attachments/10715533/console-options.png
.. |image5| image:: /attachments/10715533/network-options.png
.. |image6| image:: /attachments/10715533/install-options.png
.. |image7| image:: /attachments/10715533/install-confirm.png
.. |image8| image:: /attachments/10715533/destroy-data.png
.. |image9| image:: /attachments/10715533/install.png
.. |image10| image:: /attachments/10715533/statict-ip-setup.png

.. _custom-networking-during-installation:

Setting Static IP during installation
-----------------------------------------------------

When installing on a network that does not have a DHCP server available or if you are setting up an aggregator, static configuration can be set by choosing ``Network: Static``
during the setup process and it will present you with following screen:

|image10|

Note that the interfaces will be named according to the ISO options of the space that you set before downloading the ISO.