How to: Configuring a ByteBlower server
Posted by Vincent De Maertelaere, Last modified by Craig Godbold on 05 January 2022 09:39 AM
Each ByteBlower Server is installed, configured and tested before being shipped out. So your ByteBlower server is ready to use when it arrives at the customer premises. However, sometimes some additional configuration is required before the server can be used. For example, the server is shipped with DHCP enabled on its management interfaces. If the management network requires static configuration, this article will explain how to do this.
Getting the server ready for configuration
When a ByteBlower server boots up, it will use the “factory-default” configuration. This is the configuration as stated in the order and DHCP on its management interfaces. This allows the server to boot up correctly and when these defaults are good for the management network, to be ready out of the box.
When configuration is needed, one needs access to the server. This can be done in various ways:
The first 2 methods require physical access to the server, the last 2 methods require knowledge of the IP address of the physical interface. These addresses usually can be obtained through the logging of the DHCP server.
When the initial connection is made, a login is required. The username is “root” and the default password is “excentis”.
Through the various software releases of ByteBlower, a few base operating systems are used. Since configuration is different on different operating systems or even between operating system releases, a configuration tool is added to the ByteBlower software. This tool goes by the name ByteBlower Configurator
The ByteBlower Configurator allows a user to configure various items on the operating system and for the ByteBlower server implementation:
It can be invoked through:
After a welcome screen, the main menu is shown.
This menu divides the configuration in 2 parts:
As seen in the screenshot above, saving and applying the new settings only happens at exit. In a few cases, this statement is not true. In that case it will be noted in the relevant section.
When selecting “System configuration” in the main menu, the following window is shown:
After entering the network configuration, the various parts of the network configuration are listed. Select an item by using the up and down arrows and press <enter> to enter the item.
The form allows the user to configure the hostname. Enter/edit the hostname and use <TAB> to switch between the input field and the OK/Cancel buttons
After selecting an interface, one can review the current state of the interface or edit the connectivity parameters.
When static is selected, the following form is shown:
This form allows a single IPv4 address to be configured in a specific subnet. Also the default gateway for this interface is configured here.
Multiple IPv6 addresses are allowed in the CIDR notation.
The DNS configuration can be configured in 2 modes:
Static DNS configuration allows the user to configure other DNS servers instead of obtaining one through DHCP.
Multiple values can be given by separating them by a comma (,)
When multiple network interfaces are configured or the default gateway cannot be used to reach a specific network, additional routes can be added to the network configuration.
When an existing route is selected, the option is offered to edit or remove the selected route. The “Add route” option and the “Edit route” option open the following dialog:
When closed with “OK”, the any existing route will be updated or a new route will be added to the table. This configuration is applied when exiting the ByteBlower Configurator
To perform certain tasks, the ByteBlower server needs HTTP access to the Excentis Download Server for ByteBlower. These tasks are:
Some lab environments do not have access to the internet, but allow updates to be downloaded through an HTTP proxy. The HTTP proxy configuration allows to configure this.
Please note: this is only the HTTP proxy configuration. Username and password are only needed when required by the proxy server.
Root password password
The ByteBlower server’s default root password is set to “excentis”. It is generally a good idea to change this password.
The server will request to enter the password twice. Any entered text will be masked by an asterisk (*).
WARNING: please note the new password will be applied immediately. This keeps the password no longer in memory as needed, preventing it to leak into any logs.
Date & Time
The ByteBlower time management configuration consists of 2 blocks:
The first option (“Configure date and time”) allows the user to configure the current date and time or the mechanism to configure the time synchronisation technique.
The second option (“Configure timezone”), allows the user to configure the time zone of the system. This makes processing log files a little more handy. The default time zone is UTC.
The ByteBlower support 3 time synchronisation techniques:
Note: PTP is only available on the ByteBlower 2100 and ByteBlower 4100 series servers.
When NTP or PTP is configured, the appropriate parameters are requested:
When using NTP, the NTP servers are requested. Multiple values can be given separated by a comma (,)
When using PTP, 2 parameters are requested:
ByteBlower supports PTP through: PTP over ethernet and PTP over IP (optionally through a VLAN). Only PTP over IP is configurable through this tool.
Configuring the time zone is not a requirement, but eases the interpretation of log files. The Timezone module in the configurator requests 2 parameters:
Non-region configurations (like UTC) are listed in the ‘Etc’ region
ByteBlower server (up till v2.13.4)
The ByteBlower server has its own section in the ByteBlower configurator.
The information below is valid up till ByteBlower v2.13.4. Starting from v2.14, the server configuration is different to offer more flexibility in configuring the traffic interfaces. More details are found in this article.
This menu allows the user to dig into 2 parts of the server settings:
Traffic interface configuration
The Port configuration menu lists all known interfaces.
ByteBlower has 4 categories for a network interface:
When selecting an interface in the menu, the targeted use for the interface is requested.
When selecting “Trunking”, the trunking configuration for this interface will be entered. The other options return to the previous screen.
When “trunking” was selected, the trunk configuration menu pops up.
The “custom ...” option first displays the current configuration of the trunk:
The top section lists the ByteBlower port number and the switch configuration (e.g. trunk-1-1 to trunk-1-48 are connected to a 48 port 1 Gbit/s switch)
The second part allows the user to add a switch to the configuration. This will be added at the end of the current configuration:
The last item resets the configuration, leaving an empty trunking configuration.
The ByteBlower software itself has some configuration options itself. These are called preferences: