Kvm networking examples with "netplan" (#341)

- Adding a section describing how CloudStack finds suitable primary storage for volume migration. - Adding netplan based interface configuration example for Ubuntu.
apache · Dec 6, 2023 · e2a9584 · e2a9584
1 parent 6ea6981
commit e2a9584
Show file tree

Hide file tree

Showing 2 changed files with 55 additions and 0 deletions.
diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst
@@ -636,6 +636,15 @@ be restarted.
       Instance's root disk is allowed from one PowerFlex/ScaleIO storage pool
       to another, without stopping the Instance.
 
+Finding Primary Storage for Migration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+When you click on migrate volume, CloudStack lists the available primary storage.  CloudStack uses its storage pool allocators to identify the primary storages that are available and returns a list that is suitable for the selected volume's migration. 
+The list also could include primary storages that are mentioned as 'Not suitable'. The criteria for which the primary storages are not suitable are: 
+	- Storage tag mismatch with the volume's Disk offering's storage tag
+	- Doesn't have enough capacity. 
+	- Reached its disable threshold
+	- Disabled. 
+	- Mismatch in the type of storage such as Shared /Local. 
 
 Resizing Volumes
 ~~~~~~~~~~~~~~~~

diff --git a/source/installguide/hypervisor/kvm.rst b/source/installguide/hypervisor/kvm.rst
@@ -1012,6 +1012,52 @@ Modify the interfaces file to look like this:
        bridge_stp off
        bridge_maxwait 1
 
+If you are using *netplan* with Ubuntu, below is a sample configuration.
+
+.. parsed-literal::
+
+   $vi /etc/netplan/01-KVM-config.yaml 
+
+Modify the *YAML* file to look like this:
+
+.. parsed-literal::
+
+   ---
+   network:
+     version: 2
+     ethernets:
+       eth0: {}
+       eth1: {}
+     bridges:
+       cloudbr0:
+         addresses:
+           - 192.168.42.11/24
+         dhcp4: false
+         routes:
+           - to: default
+             via: 192.168.42.1
+         nameservers:
+           addresses:
+             - 8.8.8.8
+             - 8.8.4.4
+           search: []
+         interfaces:
+           - eth0
+         parameters:
+           stp: true
+       cloudbr1:
+         dhcp4: false
+         interfaces:
+           - eth1
+         parameters:
+           stp: true
+
+To apply the above configuration:
+
+.. parsed-literal::
+
+   netplan apply
+
 With this configuration you should be able to restart the network,
 although a reboot is recommended to see if everything works properly.