Network interfaces
------------------

.. index:: network;network interfaces
.. index:: network;network name
.. index:: network;network <interface-name>
.. index:: network;network routes
.. index:: cluster;cluster del


The command **network interfaces** will display the available network interfaces
and their configuration.  
The hostname can be set or changed with **network name <hostname>**.

A network interface can be configured or changed as follows: 

**network <interface-name> <ip> <netmask> <gateway>**

For example: **network eth0 172.29.89.100 255.255.255.0 172.29.89.1**

The IP address can be changed without affecting the netmask and gateway using:

**network <interface-name> ip <ip>**

For example, **network eth0 ip 172.29.89.100**.

The system should be rebooted after a network interface configuration or change.
In the case of a standalone single-node cluster topology, the system should be provisioned again with 
the **cluster provision** command as the final step of the change. 

.. note::

   In a clustered environment an IP address change may show the following message:

   ::

      $ network eth0 178.29.21.253 255.255.255.0 176.29.22.1
      This change will require a reprovision. Do you wish to continue [y/n] ?y
      Unable to change IP address while clustered.
      Please remove host from cluster before changing IP address

   To remove the host from the cluster, run the command below
   *on the primary unified node*:
  
   **cluster del <IP address of node to be changed>**


Network routes can be displayed with **network routes**.  

* A new network route can be configured with **network routes <network-address> <netmask> <gateway>**.  
* Network routes can be deleted with **network routes del <network-address>**.


.. |VOSS Automate| replace:: VOSS Automate
.. |Unified CM| replace:: Unified CM