--- /dev/null
+# Deploy Kubernetes and SEBA on MACCHIATObin
+
+## Overview
+The Marvell MACCHIATObin is a family of cost-effective and high-performance networking community
+boards targeting ARM64bit high end networking and storage applications. With a offering that
+include a fully open source software that include U-Boot, Linux, ODP and DPDK, the Marvell
+MACCHIATObin are optimal platforms for community developers and Independent Software Vendors (ISVs)
+to develop networking and storage applications. The default kernel configuration provided by
+Marvell does not meet the container's system requirements. So need to reconfigure and compile
+the kernel to meet SEBA operation，and also u-boot. We provide a kernel configuration file that
+has been verified on the [MACCHIATObin][1] board for developers to use.
+
+## Prerequisites
+Marvell linux must apply with MUSDK provided kernel patches(see `patches/linux` in musdk repo
+and relevant documentation).
+
+U-boot version used: **u-boot-2018.03-armada-18.09**
+
+Kernel version used: **linux-4.14.22-armada-18.09**
+
+MUSDK version used: **musdk-armada-18.09**
+
+## Build and Update Bootloader
+Marvell provides detailed documentation on how to [build bootloaders from source code][2].
+Note that checkout u-boot-2018.03-armada-18.09 branch is important. [This page][3] will
+walk you through the bootloader update process via network, i.e. using the TFTP server.
+In addition, you can use the USB Flash drive to update boot as following instructions:
+```
+Marvell>> usb reset
+Marvell>> bubt flash-image.bin spi usb
+Marvell>> reset
+Marvell>> env default -a
+Marvell>> env save
+```
+**Make sure that the MACCHIATObin board does not experience power loss during the entire
+updating process, otherwise it will be bricked due to an unfinished bootloader update.**
+
+## Setting U-Boot parameters
+The U-Boot parameter for Micro SD card/USB boot can be found [here][4],but the instructions
+of the page do not fully apply to 18.09.It needs to be changed a little bit.
+
+Using Micro SD card:
+```
+Marvell>> setenv image_name boot/Image
+Marvell>> setenv fdt_name boot/armada-8040-mcbin.dtb
+Marvell>> setenv bootcmd 'mmc dev 1; ext4load mmc 1:1 $kernel_addr_r $image_name;ext4load \
+mmc 1:1 $fdt_addr_r $fdt_name;setenv bootargs $console root=/dev/mmcblk1p1 rw rootwait \
+pci=pcie_bus_safe cpuidle.off=1; booti $kernel_addr_r - $fdt_addr_r'
+Marvell>> saveenv
+Marvell>> run bootcmd
+```
+Using USB Stick:
+```
+Marvell>> setenv image_name boot/Image
+Marvell>> setenv fdt_name boot/armada-8040-mcbin.dtb
+Marvell>> setenv bootusb 'usb reset; ext4load usb 0:1 $kernel_addr_r $image_name; \
+ext4load usb 0:1 $fdt_addr_r $fdt_name;setenv bootargs $console root=/dev/sda1 \
+rw rootwait pci=pcie_bus_safe cpuidle.off=1;booti $kernel_addr_r - $fdt_addr_r'
+Marvell>> saveenv
+Marvell>> run bootusb
+```
+If U-Boot version is 17.10, you should repleace $kernel_addr_r/$fdt_addr_r by
+$kernel_addr/$fdt_addr.
+
+## Kernel compilation steps
+The procedures to build kernel from source is almost the same, but there are still
+some points you need to pay attention to on MACCHIATObin board.
+Download Kernel Source:
+```
+mkdir -p ~/kernel/4.14.22
+cd ~/kernel/4.14.22
+git clone https://github.com/MarvellEmbeddedProcessors/linux-marvell .
+git checkout linux-4.14.22-armada-18.09
+```
+Download MUSDK Package Marvell User-Space SDK(MUSDK) is a light-weight user-space I/O driver
+for Marvell's Embedded Networking SoC's. The MUSDK library provides a simple and direct access
+to Marvell's SoC blocks to networking applications and networking infrastrucutre:
+```
+mkdir -p ~/musdk
+cd ~/musdk
+git clone https://github.com/MarvellEmbeddedProcessors/musdk-marvell .
+git checkout musdk-armada-18.09
+```
+Linux Kernel needs to be patched and built in order to run MUSDK on the MACCHIATObin board:
+```
+cd ~/kernel/4.14.22/
+git am ~/musdk/patches/linux-4.14/*.patch
+```
+Replace the default kernel configuration file with defconfig-mcbin-edge which enable necessary
+kernel modules needed by running kubernetes, also calico:
+```
+cp defconfig-mcbin-edge ~/kernel/4.14.22/arch/arm64/configs/mvebu_v8_lsp_defconfig
+```
+and then compile the kernel:
+```
+export ARCH=arm64
+make mvebu_v8_lsp_defconfig
+make -j$(($(nproc)+1))
+```
+Script is provided to facilitate build of the kernel image, the developer needs to run with
+root privileges:
+```
+./setup-macbin-kernel.sh
+```
+
+## Update the Kernel
+If kernel is compiled on the MACCHIATObin board, you can easily update kernel using the
+following instructions:
+```
+cd ~/kernel/4.14.22
+make modules_install
+cp ./arch/arm64/boot/Image /boot/
+cp ./arch/arm64/boot/dts/marvell/armada-8040-mcbin.dtb /boot/
+sync
+reboot
+```
+and also refer to the wiki for MACCHIATObin to [boot from removable storage][5].
+
+## Install SEBA
+SEBA as one of the IEC use cases, you can refer to [README][6] to manually install SEBA
+on Arm servers.
+
+[1]: http://macchiatobin.net
+[2]: http://wiki.macchiatobin.net/tiki-index.php?page=Build+from+source+-+Bootloader#Build_U-Boot
+[3]: http://wiki.macchiatobin.net/tiki-index.php?page=Update+the+Bootloader
+[4]: http://wiki.macchiatobin.net/tiki-index.php?page=Boot+from+removable+storage+-+Ubuntu
+[5]: http://wiki.macchiatobin.net/tiki-index.php?page=Boot+from+removable+storage+-+Ubuntu
+[6]: ../../../src/use_cases/seba_on_arm/install/README
--- /dev/null
+#!/bin/bash
+##################################################################
+#Set up linux kernel on MACCHIATObin for Edge Infrastructure #
+#This script not support cross-compilation #
+##################################################################
+
+# Hardcoded Paths
+export ROOTDIR=${PWD}
+
+# Hardcoded Build_param
+export ARCH=arm64
+
+# Parameter Overridable Paths
+export KDIR=${ROOTDIR}/kernel/4.14.22
+export MUSDK_PATH=${ROOTDIR}/musdk
+export DEFCONFIG_MCBIN=${ROOTDIR}/defconfig-mcbin-edge
+
+echo -e "Please run shell script as root!"
+
+# Check file defconfig-mcbin-edge
+if [ ! -f "$DEFCONFIG_MCBIN" ]; then
+ echo -e "\tPlease copy defconfig-mcbin-edge to current directory!"
+ exit 1
+fi
+
+
+# Download Kernel Source
+echo -e "Download marvell linux 18.09..."
+mkdir -p $KDIR
+cd $KDIR || exit
+#touch kernel-test
+git clone https://github.com/MarvellEmbeddedProcessors/linux-marvell .
+git checkout linux-4.14.22-armada-18.09
+cd $ROOTDIR || exit
+
+# Download MUSDK Package
+echo -e "Download MUSDK package 18.09..."
+mkdir -p $MUSDK_PATH
+cd $MUSDK_PATH || exit
+#touch musdk-test
+git clone https://github.com/MarvellEmbeddedProcessors/musdk-marvell .
+git checkout musdk-armada-18.09
+
+#Patch kernel
+cd $KDIR || exit
+echo -e "Patch kernel..."
+#touch patch_kernel
+git am $MUSDK_PATH/patches/linux-4.14/*.patch
+
+# Build Kernel
+echo -e "Backup mvebu_v8_lsp_defconfig"
+mv $KDIR/arch/arm64/configs/mvebu_v8_lsp_defconfig $KDIR/arch/arm64/configs/mvebu_v8_lsp_defconfig.bac
+echo -e "Replease kernel config by defconfig-mcbin-edge"
+cp $DEFCONFIG_MCBIN $KDIR/arch/arm64/configs/mvebu_v8_lsp_defconfig
+echo -e "Build Kernel..."
+make mvebu_v8_lsp_defconfig
+make -j$(($(nproc)+1))
+
+#Install Kernel
+echo -e "Install Kernel..."
+make modules_install
+cp ./arch/arm64/boot/Image /boot/
+cp ./arch/arm64/boot/dts/marvell/armada-8040-mcbin.dtb /boot/
+sync
+
+echo -e "Success! Please reboot!"
Code Review / iec.git / commitdiff