How to: Migrate from 1.x (EOL) environment
Posted by Vincent De Maertelaere, Last modified by Pieter Vandercammen on 02 November 2020 03:39 PM


This page is for ByteBlower servers migrating from 1.x to 2.x. If you have questions, or which to reinstall your 2.x ByteBlower servers do contact us directly at . We'll get your system up-and-running!

This article concerns the 1x00, 2x00, 3x00 or 4x00 ByteBlower series. It's not relevant for the 5100 series.

Migrating from the ByteBlower server 1.x environment to the newly released 2.x environment requires a full reinstallation. This guide will guide you through this process.

Once your 2.x server environment is installed, you can update your server software automatically over the network and switch between installed versions. Even running the legacy 1.10 server is possible from the 2.x server environment!

Please disconnect all network connections except the management interface during the installation process.

If you run into any problems, don't hesitate to contact us through this support portal. Furthermore, we can always ship an installation stick to your premises, if creating the bootable medium is not possible.

1. Download installer

To install the 2.x ByteBlower server environment, you need server installer image (an ISO file), which can be download from this support portal.

2. Create bootable installer medium

Now that you've downloaded the ISO-file it must be "burned"  to a CD or USB-key. We will use this CD or USB-key to boot the server and install ByteBlower-2.x.

Depending on your OS on your personal computer you can use the following methods to create a "bootable" USB/CD

a. Windows

USB stick

You can burn an ISO to a USB stick using the rawrite32 tool.


A free tool called CDBurnerXP is available.  A how to to burn an ISO file to a disk is available.

b. Linux

USB stick

For the following shell example, we assume:

  • the USB stick is found as /dev/sdd
  • the path to the downloaded image is /path/to/byteblower-installer.iso
  • you have root rights or have access to sudo.

$ sudo dd if=/path/to/byteblower-installer.iso of=/dev/sdd
$ sync


Any CD creating software will do.  You can use Brasero for example.

  1. Select "Burn image"
  2. Select the image to burn.
  3. Select the destination CDROM/DVD 

3. Configure BIOS to boot from installer medium

Before the ByteBlower software can be installed, the server must be configured to boot from the USB.

1100 and 1200 series servers

For 1100 and 1200 series servers, the boot order must be changed in the BIOS. This is explained in the following guides:

After the installation, the boot order must be changed back to the original order, so the (newly installed) server boots from its hard disk again.

1300, 2100, 2200, 3100 and 4100 series servers

On 1300, 2100, 2200, 3100 and 4100 series servers, you can select the device to boot from in the Boot menu. This is opened by rebooting the server and pressing F11 during startup.

From the boot menu, select your USB stick. There may be multipe USB devices in the boot menu, including the internal USB security dongle. The security dongle will have one of the following words in its name: SecuTech, Smartkey, SmartPico, Unikey, EuSec or Eutron. Make sure you do not select this USB device.

If your USB stick is not recognized as boot device, make sure that "Legacy USB Support" is set to enabled:

Using the boot menu, your system will boot from the selected device only once. Therefore, the boot order in the BIOS must not be changed.

4. Installing the ByteBlower software

Please make sure all network connections except the management interface are disconnected at this point!

  1. Boot the ByteBlower Server from the bootable install stick. When the Install Environment has finished booting, a login prompt will appear.
    The login credentials are username "root" and password "excentis".

    Installer login prompt

  2. When access is granted, start the installation with the following command:
    $ byteblower-installer

    Starting the ByteBlower installer

  3. Now the install environment is running, you will be asked a couple of questions.  

    ByteBlower installer welcome screen

  4. It will ask if the correct ByteBlower Server series is found for the current hardware.  Select No if the auto-detect was wrong.

  5. If you selected No in the previous step, you will see a selection list with supported ByteBlower Server series.  
    Please select your series. If you don't know the series, contact Excentis to assist.

  6. Next, the installation program will ask you if the detected management interface is correct.  How management interfaces are named can be found in this background article.

  7. If it's not correct, please select No.  A list will show up to select the correct interface. 

  8. After the installation program has determined its essential information, you can specifiy the hostname of your ByteBlower Server.  
    If you don't know what to do here, you can use the default (byteblower).  Press ENTER to continue.

  9. The install environment has all required the information and will install the ByteBlower software to the ByteBlower Server chassis.  Depending on your hardware this can take up to 10 minutes.

  10. When the basic installation is almost finished, the install environment will request to remove the installation medium (CD, usb-key) to finish the installation.

  11. When the installation is finished, the server will reboot to the ByteBlower update environment.  
    Please follow the guide to do an update on the ByteBlower Server

5. Running ByteBlower Server for the first time.

After the initial update after the installation, the ByteBlower server will reboot into the "ByteBlower Server environment". 

After booting, a login prompt will appear.  Please log in using username "root" and password "excentis".

6. Configuring the ByteBlower server

Since you've re-install the system you will need to run the byteblower-configurator in order to generate the default configuration files.

6.1 Port configuration

We need to configure the ports again so ByteBlower knows how many trunking switches you have. This can be done in some simple steps. 
Start the byteblower configurator ( byteblower-configurator )

Select ByteBlower Server Configuration

Port configuration

Depending on the version of server you will have 2 to 4 traffic interfaces. Depending on the license you will have 1 to 4 traffic swithces. 
A trunking port is connected to a traffic switch. the others are non-trunk ports.
To configure a port as a trunk select the interface

Select Trunking

Select the number of ports you want to assign to this trunking interface. ( usually it will be 48. If you have doubt, don't hesitate to contact us ) 

Configure the rest of the traffic ports accordingly to your license. If you are not sure, do ask us at ( )

Go back to the top level and save the configuration

6.2 other configurations

If you want to change the password or configure a fix IP for the system, then you can also use the ByteBlower-configurator. Information on how to configure the IP

(0 vote(s))
Not helpful

Comments (0)

We to help you!