Network

Description

This module allows an administrator to configure the SOP network parameters.

Release notes

Show release notes
Version 1.23.2 - Early deployment
  • Bugfix: The SMP connection were not reset properly after teh network reconfiguration, causing a long reconnection time (M14596)
  • Dependency:
    • Baseline version V2 or higher
    • System Base Module v1 or higher
    • If you are using net.Desktop and you upgrade the module Network from a version lower than 1.11, please update/reinstall net.Deskop module v2.23 or higher

Version 1.23.0 - Early deployment
  • Feature: Missing IP aliases parameter for eth2 (M9960)
  • Dependency:
    • Baseline version V2 or higher
    • System Base Module v1 or higher
    • If you are using net.Desktop and you upgrade the module Network from a version lower than 1.11, please update/reinstall net.Deskop module v2.23 or higher

Version 1.22.0 - General deployment
  • Bugfix: Routes were not generated properly on standalone sops (M9262)
  • Bugfix: E-mail to fax does not work in some cases (M9201)
  • Feature: Support for eth2 (M9606)
  • Dependency:
    • Baseline version V2 or higher
    • System Base Module v1 or higher
    • If you are using net.Desktop and you upgrade the module Network from a version lower than 1.11, please update/reinstall net.Deskop module v2.23 or higher

Version 1.21.0 - Deprecated
  • Feature: Added the possibility to configure IP aliases on ethX interfaces.
  • Deprecated: Routes not correctly configured on a standalone sop (M9262)
  • Dependency:
    • Baseline version V2 or higher
    • System Base Module v1 or higher
    • If you are using net.Desktop and you upgrade the module Network from a version lower than 1.11, please update/reinstall net.Deskop module v2.23 or higher

Version 1.20.1 - General deployment
  • Bugfix: Routes were not generated properly on standalone sops (M9262)
  • Dependency:
    • Baseline version V2 or higher
    • System Base Module v1 or higher
    • If you are using net.Desktop and you upgrade the module Network from a version lower than 1.11, please update/reinstall net.Deskop module v2.23 or higher

Version 1.20.0 - Deprecated
  • Feature: Allow configuration of eth1 in case of High Availability, without a shared address (M8073)
  • Improvement: Removed obsolete cronjob for a better vSOP performance (M7975)
  • Limitation: Baseline 1 not supported (M7975)
  • Deprecated: Routes not correctly configured on a standalone sop (M9262)
  • Dependency:
    • Baseline version V2 or higher
    • System Base Module v1 or higher
    • If you are using net.Desktop and you upgrade the module Network from a version lower than 1.11, please update/reinstall net.Deskop module v2.23 or higher

Version 1.19.0 - General deployment
  • Feature: Support for optional High Availability on eth1
  • Bugfix: Routes were not taken into account when vSOP module was installed on baseline 3
  • Bugfix: Ethernet bridge was not working properly on vSOP hosts on baseline 3
  • Bugfix: Default gateway was added on both the main and the alias interfaces in case of High Availability. Routes were not added in that case (M7783)
  • Dependency:
    • System Base Module 1.0.0+
    • If you are using net.Desktop , please update/reinstall netDeskop module 2.23+

Version 1.18.1 - General deployment
  • Bugfix: ssh would only bind on localhost on first installation/upgrade
  • Dependency:
    • System Base Module 1.0.0+
    • If you are using net.Desktop , please update/reinstall netDeskop module 2.23+

Version 1.18.0 - Deprecated
  • Feature: Support for bind9 caching DNS server (M7111)
  • Improvement: Improve how we manage the sshd_config file (M7305)
  • Improvement: Don't use DNS for incoming ssh connections
  • Deprecated: When installing/upgrading for the first time, ssh always binds on localhost only
  • Dependency:
    • System Base Module 1.0.0+
    • If you are using net.Desktop , please update/reinstall netDeskop module 2.23+

Version 1.17.1 - General deployment
  • Bugfix: Packages were not cached between SOP reboots (M7066)
  • Improvement: DNS search domain is now configurable (M6925)
  • Dependency:
    • System Base Module 1.0.0+
    • If you are using net.Desktop , please update/reinstall netDeskop module 2.23+

Version 1.17.0 - General deployment
  • Improvement: Expose eth1 interface configuration to other modules (M6481)
  • Dependency:
    • System Base Module 1.0.0+
    • If you are using net.Desktop , please update/reinstall netDeskop module 2.23+

Version 1.16.0 - General deployment
  • Bugfix: cannot configure routes with a subnet mask smaller than 255.252.0.0 (M6137)
  • Bugfix: A spurious error could be shown in the event_log (M6171)
  • Dependency:
    • System Base Module 1.0.0+
    • If you are using net.Desktop , please update/reinstall netDeskop Module 2.23+

Version 1.15.0 - General deployment
  • Improvement: Removed packages that are already installed by the System Base module (M6026)
  • Bugfix: Process the netmask for the routes correctly (M5545)
  • Dependency:
    • System Base Module 1.0.0+
    • If you are using net.Desktop , please update/reinstall netDeskop Module 2.23+

Version 1.14.0 - General deployment
  • Feature: Optionally don't restart the network interface and SMP connection
  • Feature: Use a local caching DNS server if available and correctly configured
  • Dependency:
    • SOP Base Module 1.4.0+
    • If you are using net.Desktop , please update/reinstall netDeskop Module 2.23+

Version 1.13.0 - General deployment
  • Improvement: config_network.pl script can now also be run in the foreground
  • Dependency:
    • SOP Base Module 1.4.0+
    • If you are using net.Desktop , please update/reinstall netDeskop Module 2.23+

Version 1.12.0 - General deployment
  • Improvement: Remove dependency between Database Schema and Network module. (M0004038)
  • Dependency:
    • SOP Base Module 1.4.0+
    • If you are using net.Desktop , please update/reinstall netDeskop Module 2.23+

Version 1.11.1 - General deployment
  • Bugfix: Default value of 'Bind SSH on external interface' was not set correctly if you would not save the value explicitly.
  • Dependency:
    • SOP Base Module 1.2.0+
    • If you are using net.Desktop , please update/reinstall netDeskop Module 2.23+

Version 1.11.0 - Deprecated
  • Feature: Bind SSH to localhost only (M0004124)
  • Feature: Routes are automatically set up to the right interface (M0004484)
  • Feature: Network is now able to manage network configuration for VSOPs (M0004486)
  • Deprecated: If you do not save the option 'Bind SSH on external interface' to yes, SSH will not bind to the external interface.
  • Dependency:
    • If you are using netDesktop, please update/reinstall netDeskop Module 2.23+

Version 1.10.1 - Deprecated
  • Bugfix: set autoneg correctly to allow 1000 Mbps
  • Deprecated: gateway address never generated on standby sop in case of High availability.

Version 1.10.0 - Deprecated
  • Bugfix: set default gateway only on correct interface if eth1 has static ip (M0004484)
  • Deprecated: gateway address never generated on standby sop in case of High availability.

Version 1.9.0 - General deployment
  • Feature: Added support for baseline 2.0 (M0003103)
  • Improvement: removed non relevant error messages

Version 1.8.0 - General deployment
  • Bugfix: When booting a 4U sop without network cable attached, then connecting network cable later, link doesn't come up without reboot. (M3038)

Version 1.7.0 - General deployment
  • Feature: definition of up to 4 static routes

Version 1.6.0 - General deployment
  • Configurable Ethernet speed and duplex mode

Version 1.5.0 - General deployment
  • Bug fix: Installation fails due to SOP connection loss
  • Bug fix: Prevent downgrade of ESCAUX base package

Version 1.4.0 - Deprecated
  • Improve: Upgrade ESCAUX base package
  • deprecated: reinstalling downgrades escaux-base possibly breaking unrelated modules

Version 1.3.0 - General deployment

Version 1.2.0 - General deployment

Version 1.1.0 - General deployment
  • initial version

Module configuration interface

create_resource_form: .:/usr/share/escaux/glue/lib:/usr/share/escaux/glue/bin/gen_wiki_documentation/src/lib:/usr/share/escaux/glue/bin/gen_wiki_documentation/src/lib/

eth1 dhcp
eth1 static IP
eth1 static netmask
Configure standby partition
eth0 mode
Route 1
network
mask
gateway
Route 2
network
mask
gateway
Route 3
network
mask
gateway
Route 4
network
mask
gateway
Bind SSH on external interface
Restart networking and SMP connection
DNS Search Domain
eth0 ip aliases (comma-separated)
eth1 ip aliases (comma-separated)
eth2 dhcp
eth2 static IP
eth2 static netmask
eth2 ip aliases (comma-separated)

Description

This module configures the network on the SOP. It uses the settings given in the Server Configuration. It configures the first ethernet interface (eth0), set the default gateway and one or two DNS servers.

Installing the module immediately changes this config on the SOP as well as write the system startup files so that the config is retained on next boot.

ALERT! Incorrect configuration of this module may make the SOP unreachable. In such event local console access is required to restore the situation using the Shell.

Module configuration parameters

  • eth1:
    • eth1 dhcp client: Enable the secondary ethernet interface and configure it using DHCP.
    • eth1 static IP: Enable the secondary ethernet interface and configure it statically using this IP address. It must be in another subnet than the one of eth0, eth2 and eth3 (see note below).
    • eth1 static netmask: netmask associated with the IP address in the previous field.
    • ALERT! Setting eth1 in the same subnet as eth0 will result in 2 default routes. This configuration is not supported.

  • Configure standby partition: this module changes the system startup files on the SOP so that it takes the network settings when the system starts. This option allows to change these files on both partitions of the SOP. Not using this option means that when switching to the standby partition, the sop will take its original network settings that were given during install. ALERT! This feature is only supported on baseline 1

  • eth0 mode: ethernet interface port speed and duplex mode. In most cases you will want to leave this to 'auto'. Consult your networking department to decide which setting is best for your environment. The following modes are accepted:
    • auto: automatic negotiation of port speed and duplex mode
    • 10baseT/Half: 10Mbps, half duplex
    • 10baseT/Full: 10Mbps, full duplex
    • 100baseT/Half: 100Mbps, half duplex
    • 100baseT/Full: 100Mbps, full duplex
    • 1000baseT/Full: 1Gbps, full duplex

  • Route 1-8: definition of up to eight static routes. To configure a static route to network 10.10.20.0/24, pointing to a next-hop router with the IP address of 192.168.100.1, enter the following values:
    • network: 10.10.20.0
    • mask: 255.255.255.0
    • gateway: 192.168.100.1
Note : it is important to note that the Network module will automatically assign the route to the network interface of the SOP that is in the same ip range than the gateway. So if the network address of eth0 is 172.16.35.2 and the network address of eth1 is 192.168.100.2, the route you just defined will be assigned to eth1.

  • Bind SSH on external interface
    • no - Binds the SSH interface to localhost only. Clients will not be able to access the SOP shell. Administrators will be able to access using the management interface.
    • yes - Binds the SSH interface to eth0. Clients might use it to access the SOP shell. Administrators will be able to access using the management interface.

  • Restart networking and SMP connection
    • yes - Restart the network interfaces and restart the SMP connection after module installation. This is the default.
    • no - Do not restart the network interface and do not restart the SMP connection. This is useful when e.g. only DNS information has changed. Do not use this if you are trying to change the IP address, netmask, gateway or routes of the SOP.

  • DNS Search Domain: Specify the domain suffix to try when a DNS query cannot be resolved. Default value if empty is "escaux.com".

  • eth0 ip aliases: Add additional alias addresses to the eth0 interface. Note that these aliases do not interfere with the aliases created by the High Availability module, but of course you need to take care to not configure the same addresses in the High Availability module and the aliases. When using these aliases in combination with the High Availability module they will only be assigned to the SOP that is in active mode, just like the primary active address.

  • eth1 ip aliases: Add additional alias addresses to the eth1 interface. Note that these aliases do not interfere with the aliases created by the High Availability module, but of course you need to take care to not configure the same addresses in the High Availability module and the aliases. When using these aliases in combination with the High Availability module they will only be assigned to the SOP that is in active mode, just like the primary active address.

  • eth2:
    • ALERT! eth2 configuration is not supported in case of an active-standby setup with the High Availability module.
    • eth2 dhcp client: Enable the third ethernet interface and configure it using DHCP.
    • eth2 static IP: Enable the third ethernet interface and configure it statically using this IP address. It must be in another subnet than the one of eth0, eth1 and eth2 . (see note above)
    • eth2 static netmask: netmask associated with the IP address in the previous field.

  • eth3:
    • ALERT! eth3 configuration is not supported in case of an active-standby setup with the High Availability module.
    • eth3 dhcp client: Enable the fourth ethernet interface and configure it using DHCP.
    • eth3 static IP: Enable the fourth ethernet interface and configure it statically using this IP address. It must be in another subnet than the one of eth0, eth1 and eth2. (see note above)
    • eth3 static netmask: netmask associated with the IP address in the previous field.

  • bond0 slaves: Comma separated list of interfaces that are slaves to the bond interface (no spaces). The IP configuration of the bond will be read from the configuration of the first interface in this list.

  • bond1 slaves: Comma separated list of interfaces that are slaves to the bond interface (no spaces). The IP configuration of the bond will be read from the configuration of the first interface in this list.

Supported configurations

Single interface: eth0

There is only one interface available on the SOP. All communication is done through this interface. Optionally, High Availability can be used on this interface.

Dual interfaces: eth0 and eth1

There are two interfaces available. One interface is used for the management connection (the connection to the SMP), and the other one is used for voice or service traffic. Optionally, High Availability can be used on this interface.

Triple interfaces: eth0, eth1 and eth2

This setup is only supported in very specific environments where it is a hard requirement. High Availability is not supported on this interface.

Quad interfaces: eth0, eth1, eth2 and eth3

This setup is only supported in very specific environments where it is a hard requirement. High Availability is not supported on this interface.

Copyright © Escaux SA