dmm initial commit

Change-Id: I049ee277cf4efdb83f9c2ac439365fcd421c159b
Signed-off-by: qchang <qing.chang1@huawei.com>

1 files changed, 109 insertions, 0 deletions

diff --git a/doc/Build_DMM.md b/doc/Build_DMM.md
new file mode 100644
index 0000000..12105de
--- /dev/null
+++ b/doc/Build_DMM.md
@@ -0,0 +1,109 @@
+# 1. Introduction : 
+ This document purpose is to build the DMM.
+
+# 2. Build DPDK:
+DPDK need to be built for DMM RTE dependency.
+
+- Steps :
+
+  download dpdk-16.04.tar.xz from DPDK release, you can get it from [http://static.dpdk.org/rel](http://static.dpdk.org/rel)
+```
+   #wget http://static.dpdk.org/rel/dpdk-16.04.tar.xz
+   #tar xvf dpdk-16.04.tar.xz
+   #vi dpdk-16.04/config/common_base #make CONFIG_RTE_BUILD_SHARED_LIB=y
+   #cd dpdk-16.04
+   #make install  T=x86_64-native-linuxapp-gcc DESTDIR=/root/dpdk_build/tmp2
+   #cd x86_64-native-linuxapp-gcc
+   #make #to install the dpdk which will generate .so inside lib folder in the path.
+```
+Make sure the path same as list up
+```
+    #mkdir -p /root/dpdk_build/tmp2/opt/uvp/evs/
+    #cp /root/dpdk/dpdk-16.04/x86_64-native-linuxapp-gcc/kmod/igb_uio.ko             /root/dpdk_build/tmp2/opt/uvp/evs/
+```
+Note:
+
+    Environment:
+        Linux ubuntu 14.04 and above.
+    Make sure you have linux-headers-4.4.0-89  linux-headers-4.4.0-89-generic and check uname -a it should have 4.4.0-89-generic header
+
+- Hugepage setting:
+
+```
+    #vi /etc/default/grub
+```
+update GRUB\_CMDLINE\_LINUX\_DEFAULT="default\_hugepagesz=1G hugepagesz=1G hugepages=8"
+
+```
+    #update-grub
+    #reboot
+```
+Check hugepage info HugePages_
+
+```
+    #cat /proc/meminfo
+```
+- Mount hugepages:
+
+``` 
+    #mount -t hugetlbfs -o pagesize=1G none /mnt/nstackhuge/
+```
+
+```
+    #mkdir /var/run/ip_module   ##if not exist
+    #export LD_LIBRARY_PATH=/root/xxxx/DMM/release/lib64/
+```
+Note:
+
+    no need LD_PRELOAD, This macro is for the same purpose.
+
+- Enable detail log of nstack
+
+```
+    #export NSTACK_LOG_ON=DBG
+```
+
+
+# 3. Build DMM:
+
+```
+    #cd DMM/build
+    #cmake -D DMM_DPDK_INSTALL_DIR=$DPDK_INSTALL_PATH ..
+	#Note: DPDK_INSTALL_PATH - the path in which DPDK has been installed
+```
+ after cmake all the makefiles and dependent .sh files will be copied under build directory.
+
+```
+    #make -j 8
+```
+ Note:
+ 
+    Sometimes compilation fails due to GLOB lib dependency, to solve this problem by following steps.
+
+```
+    #cd ../thirdparty/glog/glog-0.3.4
+    #sudo autoreconf -ivf
+    #cd 
+    #make -j 8
+    #bash -x release_tar.sh
+```
+
+Note:
+
+    Update path of DPDK install with /root/dpdk_build/tmp2 in below file 
+```
+    #vim ./release/script/nstack_var.sh    # you can change it
+```
+
+# 4. Bring up the nStackMain process:
+```
+    #rm -rf /product
+    #mkdir /product/
+    #chmod 777 /product/
+    #mkdir /mnt/nstackhuge -p
+    #goto /DMM/
+    #tar zxvf nStackServer.tar.gz
+    #cd nStackServer
+    #./start_nstack.sh
+    #ps -ef | grep nStackMain
+```
\ No newline at end of file