.. _node-setup:

===========
Node setup
===========

Nodes are typically configured during installation from the customized openSUSE
Leap or Debian 10 ISOs. See `Creating bootable USB disks from ISO images
<../nodes/provisioning-nodes/creating-bootable-usb-disks-from-iso-images.html>`__
for more information on using these custom ISOs. The node setup page
offers links to customized ISOs and offers options for generating the
customized ISOs.

Changing the settings does not change the values on already-installed
nodes; it only changes the initial settings for nodes that are installed
with ISO files downloaded after the settings are changed.

After changing any of these values, you need to download a new version
of the ISO.

Root password
--------------

The password of the node's root user account.

Timezone
---------

The node's timezone.

DNS servers
------------

Specify one, two, or three DNS servers used during the provisioning
process.

Network interface names
------------------------

Specify which interface naming scheme will be used for nodes provisioned with this ISO.

There are 2 options:

Predictable network interface naming
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Generally used as the naming scheme for interfaces on modern Linux
distributions, these interface names are called predictable as they are based
off of hardware information such as which PCI device they are attached to.

These interface names tend to look like ``ens3``, ``enp37s0``, or ``enp42s0f1``.

Legacy network interface naming
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Sometimes referred to as "persistent interface names", these names are
determined when the network card is first detected and the network interfaces
will be renamed to be consistent between boots of the system.

These interface names tend to look like ``eth0``, ``eth1``, or ``eth2``

These interfaces can start to have issues when many interfaces are present,
especially from things like USB devices. You may end up seeing interfaces named
like ``rename0`` instead of the intended name. As the default behaviour is
predictable network interface names and there are problems with these interface
names, predictable interface names should be preferred when possible.

Manual installation
--------------------

Nodes may also be installed manually by following the instructions on the node
setup page. As of version 6.8, nodes can be installed on devices running
openSUSE Leap 15.6, 15.5, or 15.4, or Debian 12, 11, or 10.
