Adding documentation content for mixed arch pod deployment in ENC

Signed-off-by: Alexandru Nemes <alexandru.nemes@enea.com>

1 files changed, 62 insertions, 0 deletions

diff --git a/book-enea-nfv-core-installation-guide/doc/mixed_arch.xml b/book-enea-nfv-core-installation-guide/doc/mixed_arch.xml
new file mode 100644
index 0000000..d0666d8
--- /dev/null
+++ b/book-enea-nfv-core-installation-guide/doc/mixed_arch.xml
@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<chapter id="mixed_arch">
+  <title>Mixed Arch Deployment</title>
+
+  <para>Mixed Arch deployment support allows a user to install Enea NFV Core
+  on a cluster containing a mixture of servers, with x86_64 and aarch64 CPU
+  families. The recommended topologies consist of deploying x86 Controllers
+  and aarch64 Compute nodes, or mixed x86_64 and aarch64 Compute nodes.</para>
+
+  <section id="launch_multiarch_env">
+    <title>Launching Instances in a Mixed Arch environment</title>
+
+    <para>Before launching an instance, the user needs to ensure certain
+    prerequisites are present:</para>
+
+    <itemizedlist>
+      <listitem>
+        <para>Have OpenStack images installed for both architectures:</para>
+
+        <programlisting>#image for x86
+glance image-create --name dpdk-image-x86 --visibility public --disk-format raw \
+--container-format bare --file dpdk-image-x86-compiled
+#image for ARM
+glance image-create --name dpdk-image-arm --visibility public --disk-format raw \
+--container-format bare --file dpdk-image-arm-compiled
+glance image-update [ID] --property hw_firmware_type=uefi</programlisting>
+      </listitem>
+
+      <listitem>
+        <para>Have Openstack configured with per-arch scheduling information.
+        The following is an example configuration:</para>
+
+        <orderedlist>
+          <listitem>
+            <para>Create a host aggregate:</para>
+
+            <programlisting>nova aggregate-create x86_64
+nova aggregate-set-metadata x86_64 arch=x86_64
+nova aggregate-add-host x86_64 node-6.domain.tld</programlisting>
+          </listitem>
+
+          <listitem>
+            <para>Create a flavor and tie it to the aggregate:</para>
+
+            <programlisting>openstack flavor create --ram 4096 --disk 4 --vcpus 4 dpdk-x86
+nova flavor-key dpdk-x86 set aggregate_instance_extra_specs:arch=x86_64
+nova flavor-key dpdk-x86 set hw:mem_page_size=any
+openstack flavor set --property hw:cpu_policy=dedicated dpdk-x86</programlisting>
+          </listitem>
+        </orderedlist>
+      </listitem>
+
+      <listitem>
+        <para>Launch the VM:</para>
+
+        <programlisting>nova boot --image dpdk-image-x86 --flavor dpdk-x86 pktgen-x86</programlisting>
+
+        <para>It will be placed on the x86 hypervisor from node-6.</para>
+      </listitem>
+    </itemizedlist>
+  </section>
+</chapter>
\ No newline at end of file