Compute Node Configuration

The compute node runs a modified version of the SmartOS operating system, which is also called ErigonOS. The base operating system without the Danube Cloud software is also called a Platform Image.

The compute node configuration is stored in the /usbkey/config file. The /usbkey folder is placed on the compute node’s primary storage (zones pool) and contains a copy of the USB installation media. After changing the /usbkey/config file the compute node should be rebooted for changes to be applied correctly.

See also

For more information about the persistent compute node configuration see

/usbkey/config options


The /usbkey/config must be source-able by bash (i.e., it can be validated by running source /usbkey/config).


MAC address setup

  • change_mac - Semicolon-separated list of MAC address pairs, which are delimited by a comma (e.g., aa:bb:cc:11:22:33,dd:ee:ff:44:55:66;f6:e5:d4:c3:b2:a1,1f:2e:3d:4c:5b:6a). Each network interface that has the first MAC address in every pair will have its MAC address changed for the second MAC address in that pair during boot. This feature can be used to free the MAC address of a physical interface for use by a VNIC.

DNS configuration

  • dns_resolvers - Comma-separated list of DNS resolvers that will be configured as nameservers in /etc/resolv.conf.
  • dns_domain - DNS search domain which will be set in /etc/resolv.conf.
  • dns_options - The value will be used as a parameter for the options keyword in /etc/resolv.conf.

NTP configuration

  • ntp_hosts - Comma-separated list of NTP servers set as time servers in ntp.conf.

NIC tag and VNIC configuration

See also

Configuration of NIC tags is described in a separate chapter.

See also

Configuration of network interfaces is described in a separate chapter.

  • headnode_default_gateway - IP address set as default gateway.

  • etherstub - Comma-separated list of etherstub names that will be created during boot.

  • overlay_rule_<name> - Overlay rule definition which will be set into /var/run/smartdc/networking/overlay_rules.json.

  • <nic_tag>_nic - Normal NIC tag definition.

  • <nic_tag>_<vnic-suffix_integer>_{ip,netmask,vlan_id,mac,mtu} - VNIC definition.


    The configuration parameters for the admin network do not contain the VNIC integer suffix.

    VNIC over normal physical interfaces or aggregations.
    # Or foobar_nic=aggr0 for VNIC/nic_tag over aggregation interface named `aggr0`
    VNIC on etherstub. The etherstub name must be listed in the appropriate setting, e.g., etherstub=test30 (see above).
    VNIC on overlay. There must be an overlay_rule_ham_eggs= setting for the overlay rule (see above).

System configuration

  • datacenter_name - Physical data center name.
  • hostname - Compute node hostname. The hostname cannot be changed after the compute node was already registered in Danube Cloud.

Virtual machines

  • vnc_listen_address - IP address that will be used as the listen address of the VNC console of a KVM virtual machine.

Danube Cloud services

The Danube Cloud service settings are automatically set by the installer and are used to deploy virtual servers in the admin virtual data center on the first compute node. Other compute nodes use only the cfgdb_admin_ip and esdc_install_password to connect and extract information from the configuration database.

  • admin_email
  • mgmt_admin_ip
  • mon_admin_ip
  • dns_admin_ip
  • img_admin_ip
  • cfgdb_admin_ip
  • esdc_install_password