How to: Configuring a ByteBlower server
Posted by Vincent De Maertelaere, Last modified by Dries Decock on 03 April 2018 01:52 PM

Before being shipped to our customers, each ByteBlower Server is installed, configured and tested. So your new ByteBlower Server is ready to use when it arrives. However, sometimes a little configuring needs to be done before the server can be used. For example, by default, the management interface performs DHCP when the ByteBlower Server is booting. If this is what you want, no further configuration is needed. However, if you need a static IP address on the management interface, this article will show you how to do it.

Booting the Server

When you power up the ByteBlower Server, the ByteBlower Server software will be booted automatically. No user interaction is required. If the Server is already configured, you can just power on the Server and you are ready to go.

Interacting with the Server

If you want to configure the ByteBlower Server, you have to communicate with the Server. This can be done in three different ways. All methods will require a login and password. By default, the login is “root” and the password is “excentis”.

  • Direct connection: You can connect a screen and keyboard with the ByteBlower Server and then login.
  • Serial console: You can connect with the ByteBlower Server using a serial cable. The speed is set to 38400bps
  • SSH: If the Server is connected with the management LAN interface, you can use SSH to control the Server.

Interface naming

How interfaces are named, is dependent on the series of the server.  How this can be obtained, is explained in this article: How to: Obtaining the ByteBlower series and version.

How the interfaces are named on your model, can be found here: Background: Identifying the ByteBlower interfaces on a ByteBlower server


ByteBlower configuration GUI

You can start the ByteBlower configurator by executing this command on the server: byteblower-configurator

By running this utility, you will be shown a welcome screen, after which you will be shown the following menu:

  1. To see and change information the network interfaces choose the port configuration item in the main menu.

  2. The second option, the network configuration, will allow you to configure one or more management interfaces, routes, hostname and DNS settings.

  3. The Advanced configuration should only be changed when advised by Excentis personnel.

Defining interface types

Defining interface types in done through the Port Configuration screen:

This screens lists all interfaces, both native and dedicated, and shows their current configuration.

Each native interface (man) can be either a management interface or a spare (i.e. unused) interface. The dedicated interfaces (phy/enp) are used for ByteBlower traffic and are either a trunk or non-trunk interface. How to configure these interfaces is explained in the following sections.

 Note: Although the configurator allows setting native interfaces (man) as trunk or non-trunk interfaces, this is not supported by the ByteBlower 2000, 3000 and 4000 series !

By selecting a native interface, you can change its type like this:

You can clearly see the four different types for native interfaces: trunk, non-trunk, management and spare. A fifth option is to identify the interface. This way, a led on the interface will blink so you are sure which interface is currently selected.

Note: Although the configurator allows setting native interfaces (man) as trunk or non-trunk interfaces, this is not supported by the ByteBlower 2000, 3000 and 4000 series!

Configuring the dedicated ByteBlower interfaces

An interface on the ByteBlower Server can be used in two different modes: trunking mode and non-trunking mode. When used in a trunking mode, the interface must be connected with a well configured ByteBlower switch. In that situation, each port on the switch can be used for sending and receiving traffic. In the non-trunking mode, the interface can be used directly. The configuration for trunking and non-trunking mode of an interface can be set using the ByteBlower Configurator utility.

Main menu

Choose the “Port configuration” and press “Enter”.

Interface selection

You will now have the following menu :

In our example, interface phy-0-0 is a trunking interface, connected with a switch which has 48 ports. You can scroll down the list using the arrow keys. Be aware that trunk or non-trunking interfaces cannot have an IP address (so, the IP is set to Interfaces with an IP address can't be used as a ByteBlower interface.

Note: The dedicated interfaces are counted from Right to Left!
So, phy-0-0 is the rightmost dedicated interface. Phy-0-3 is the leftmost dedicated interface.

Interface Type

To configure an interface, select the interface and press “Enter”. You will see the following screen:

Here you can select if an interface is a trunking interface, a non-trunking interface, or is not used. The dedicated interfaces cannot act as management interfaces and don't support interface identification by lighting a led.

Number of ports

If you select a trunking interface, you still have to define the number of ports on the switch to which this interface is connected. This will be defined in the next menu:

Select the correct number of ports and press “Enter”.

You will now be back in the port configuration menu. You can configure other interfaces like we did before. Once all interface are configured, you can select “Save and exit” to store your configuration. The configuration will be active after you have rebooted the system. You can reboot the system using the following command: reboot

Configuring the hostname, domainname and DNS servers

The ByteBlower server can have a unique hostname, be part of a domain and use DNS to resolve hostnames. All these parameters can be found at the Network Configuration menu.

Network configuration

First, enter the Network Configuration menu from the main menu. The Network Configuration Menu will be presented:

You can change the hostname be selecting 'Hostname' from the menu and filling it in:

You can change the domainname in the same way.

For the DNS servers, please provide a list of valid DNS servers, separated by spaces:

Configuring a management interface

After defining one or multiple management interfaces in the 'Port Configuration', it's time to define an IP address. This can be done in the 'Management Interfaces' menu, which can be found at the 'Network Configuration' menu:

You now can select the interface under configuration:

An overview of the current configuration is shown:

You can change this by selecting 'Change':

The Basic connectivity allows you to define the IP address, netmask and default gateway. You can also choose to use DHCP:

If you don't want to use DHCP, select 'No' and the static IP, netmask and gateway will be requested.

Optionally, additional routes can be added in the 'Static Routes' menu:

You can remove and add routes using the <Remove> and <Add> buttons.

Adding a route requires three parameters. 
The first is the network address parameter:

After that, the prefix length is requested:

A last parameter is the gateway:

To save these settings, go back to the main menu and select 'Save and Exit'


If you have any question, don't hesitate to contact us at:

(1 vote(s))
Not helpful

Comments (0)

We to help you!