Skip to content

Commit 24e969c

Browse files
authored
adding nmcli commands to configure Oracle Linux host (#570)
Add initial nmcli examples for KVM host setup, including Oracle Linux. Current docs lack references to NetworkManager usage, and with most Linux distros moving to NetworkManager by default, these commands provide a starting point for users.
1 parent 851b10e commit 24e969c

File tree

1 file changed

+64
-0
lines changed
  • source/installguide/hypervisor

1 file changed

+64
-0
lines changed

source/installguide/hypervisor/kvm.rst

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -876,6 +876,38 @@ although a reboot is recommended to see if everything works properly.
876876
in case you made a configuration error and the network stops functioning!
877877

878878

879+
Configure Oracle Linux for Basic Networks using nmcli
880+
'''''''''''''''''''''''''''''''''''''''''''''''''''''
881+
All the required packages were installed when you installed libvirt, so
882+
we only have to configure the network.
883+
884+
Disable IP settings on physical NIC first
885+
886+
.. parsed-literal::
887+
nmcli con mod eth0 ipv4.method disabled ipv6.method ignore
888+
889+
Configure cloudbr0 and include the Management IP of the hypervisor.
890+
891+
.. parsed-literal::
892+
nmcli con add type bridge ifname cloudbr0 con-name cloudbr0
893+
nmcli con add type ethernet ifname eth0 master cloudbr0 slave-type bridge con-name cloudbr0-eth0
894+
nmcli con modify cloudbr0 ipv4.addresses 192.168.42.11/24 ipv4.gateway 192.168.42.1 ipv4.method manual ipv6.method ignore
895+
896+
897+
Configure cloudbr1 as a plain bridge without an IP address
898+
899+
.. parsed-literal::
900+
nmcli con add type bridge ifname cloudbr1 con-name cloudbr1 ipv4.method disabled ipv6.method ignore
901+
nmcli con add type vlan ifname eth0.20 dev eth0 id 20 master cloudbr1 con-name vlan20
902+
903+
With this configuration you should be able to restart the network,
904+
although a reboot is recommended to see if everything works properly.
905+
906+
.. warning::
907+
Make sure you have an alternative way like IPMI or ILO to reach the machine
908+
in case you made a configuration error and the network stops functioning!
909+
910+
879911

880912
Network Example for Advanced Networks
881913
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -1182,6 +1214,38 @@ although a reboot is recommended to see if everything works properly.
11821214
in case you made a configuration error and the network stops functioning!
11831215

11841216

1217+
Configure Oracle Linux for Advance Networks using nmcli
1218+
'''''''''''''''''''''''''''''''''''''''''''''''''''''
1219+
All the required packages were installed when you installed libvirt, so
1220+
we only have to configure the network.
1221+
1222+
Disable IP settings on physical NICs first
1223+
1224+
.. parsed-literal::
1225+
nmcli con mod eth0 ipv4.method disabled ipv6.method ignore
1226+
nmcli con mod eth1 ipv4.method disabled ipv6.method ignore
1227+
1228+
Configure cloudbr0 and include the Management IP of the hypervisor.
1229+
1230+
.. parsed-literal::
1231+
nmcli con add type bridge ifname cloudbr0 con-name cloudbr0 ipv4.addresses 192.168.42.11/24 ipv4.gateway 192.168.42.1 ipv4.method manual ipv6.method ignore
1232+
nmcli con add type ethernet ifname eth0 master cloudbr0 slave-type bridge con-name cloudbr0-eth0
1233+
1234+
Configure cloudbr1 as a plain bridge without an IP address
1235+
1236+
.. parsed-literal::
1237+
nmcli con add type bridge ifname cloudbr1 con-name cloudbr1 ipv4.method disabled ipv6.method ignore
1238+
nmcli con add type ethernet ifname eth1 master cloudbr1 slave-type bridge con-name cloudbr1-eth1
1239+
1240+
With this configuration you should be able to restart the network,
1241+
although a reboot is recommended to see if everything works properly.
1242+
1243+
.. warning::
1244+
Make sure you have an alternative way like IPMI or ILO to reach the machine
1245+
in case you made a configuration error and the network stops functioning!
1246+
1247+
1248+
11851249
Configure the network using OpenVswitch
11861250
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
11871251

0 commit comments

Comments
 (0)