1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
2 .. SPDX-License-Identifier: CC-BY-4.0
3 .. Copyright (C) 2019 Wind River Systems, Inc.
13 This project implements a real time platform to deploy the O-CU and O-DU and it's based on Yocto/OpenEmbedded.
15 This includes a Yocto/OpenEmbedded compatible layer meta-stx-oran and wrapper scripts
16 to pull all required Yocto/OE layers to build out the reference platform.
18 To contribute on this project, basic knowledge of Yocto/OpenEmbedded is needed, please refer to the following docs if you want to learn about how to develop with Yocto/OpenEmbedded:
21 - `OpenEmbedded wiki`_
23 .. _`Yocto dev manual`: https://www.yoctoproject.org/docs/2.6.3/dev-manual/dev-manual.html
24 .. _`OpenEmbedded wiki`: http://www.openembedded.org/wiki/Main_Page
28 1. Prerequisite for build environment
29 -------------------------------------
31 * Your host need to meet the requirements for Yocto, please refer to:
33 * `Compatible Linux Distribution`_
34 * `Supported Linux Distributions`_
35 * `Required Packages for the Build Host`_
37 The recommended and tested host is Ubuntu 16.04/18.04 and CentOS 7.
39 * To install the required packages for Ubuntu 16.04/18.04:
41 .. _`Compatible Linux Distribution`: https://www.yoctoproject.org/docs/2.6.3/brief-yoctoprojectqs/brief-yoctoprojectqs.html#brief-compatible-distro
42 .. _`Supported Linux Distributions`: https://www.yoctoproject.org/docs/2.6.3/ref-manual/ref-manual.html#detailed-supported-distros
43 .. _`Required Packages for the Build Host`: https://www.yoctoproject.org/docs/2.6.3/ref-manual/ref-manual.html#required-packages-for-the-build-host
47 $ sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib \
48 build-essential chrpath socat cpio python python3 python3-pip python3-pexpect \
49 xz-utils debianutils iputils-ping make xsltproc docbook-utils fop dblatex xmlto \
52 * To install the required packages for CentOS 7:
56 $ sudo yum install -y epel-release
58 $ sudo yum install gawk make wget tar bzip2 gzip python unzip perl patch \
59 diffutils diffstat git cpp gcc gcc-c++ glibc-devel texinfo chrpath socat \
60 perl-Data-Dumper perl-Text-ParseWords perl-Thread-Queue perl-Digest-SHA \
61 python34-pip xz which SDL-devel xterm
63 2. Use wrapper script build_inf.sh to setup build env and build the INF AIO x86 image
64 -------------------------------------------------------------------------------------
68 # Get the wrapper script with either curl or wget
69 $ curl -o build_inf.sh 'https://gerrit.o-ran-sc.org/r/gitweb?p=pti/rtp.git;a=blob_plain;f=scripts/build_inf.sh;hb=HEAD'
70 $ wget -O build_inf.sh 'https://gerrit.o-ran-sc.org/r/gitweb?p=pti/rtp.git;a=blob_plain;f=scripts/build_inf.sh;hb=HEAD'
72 $ chmod +x build_inf.sh
73 $ WORKSPACE=/path/to/workspace
74 $ ./build_inf.sh -w ${WORKSPACE}
76 If all go well, you will get the ISO image in:
77 ${WORKSPACE}/prj_oran_inf_anaconda/tmp-glibc/deploy/images/intel-corei7-64/inf-image-aio-installer-intel-corei7-64.iso