X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=docs%2Fdeveloper-guide.rst;h=a3b501507c045d1ec15f01c8438a15538def6ea3;hb=refs%2Fchanges%2F45%2F4645%2F1;hp=bbfceb571260b2131c86a2708d85638ceb89ab91;hpb=7ed3560f2741c1e5ea814592eca2d8e1a81dcc1e;p=pti%2Frtp.git diff --git a/docs/developer-guide.rst b/docs/developer-guide.rst old mode 100644 new mode 100755 index bbfceb5..a3b5015 --- a/docs/developer-guide.rst +++ b/docs/developer-guide.rst @@ -24,11 +24,9 @@ To contribute on this project, basic knowledge of Yocto/OpenEmbedded is needed, .. _`OpenEmbedded wiki`: http://www.openembedded.org/wiki/Main_Page -Processes ---------- 1. Prerequisite for build environment -````````````````````````````````````` +------------------------------------- * Your host need to meet the requirements for Yocto, please refer to: @@ -63,18 +61,56 @@ Processes python34-pip xz which SDL-devel xterm -2. Use wrapper script build_oran.sh to setup build env and build the image -`````````````````````````````````````````````````````````````````````````` +2. Use wrapper script build_inf.sh to setup build env and build the INF AIO x86 image +------------------------------------------------------------------------------------- + +:: + + # Get the wrapper script with either curl or wget + $ 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' + $ 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' + + $ chmod +x build_inf.sh + $ WORKSPACE=/path/to/workspace + $ ./build_inf.sh -w ${WORKSPACE} + +If all go well, you will get the ISO image in: +${WORKSPACE}/prj_oran_inf_anaconda/tmp-glibc/deploy/images/intel-corei7-64/inf-image-aio-installer-intel-corei7-64.iso + +3. (Optional) Use wrapper script build_oran.sh to setup build env and build the lagecy x86 image +------------------------------------------------------------------------------------------------ + +Note: The lagecy image is the Kubernetes Cluster image as the same one in Amber (1.0) release. :: # Get the wrapper script with either curl or wget $ curl -o build_oran.sh 'https://gerrit.o-ran-sc.org/r/gitweb?p=pti/rtp.git;a=blob_plain;f=scripts/build_oran.sh;hb=HEAD' $ wget -O build_oran.sh 'https://gerrit.o-ran-sc.org/r/gitweb?p=pti/rtp.git;a=blob_plain;f=scripts/build_oran.sh;hb=HEAD' - + $ chmod +x build_oran.sh - $ WORKSPACE=/path/to/workspace + $ WORKSPACE=/path/to/workspace_lagecy $ ./build_oran.sh -w ${WORKSPACE} If all go well, you will get the ISO image in: -${WORKSPACE}/prj_wrl1018_oran/tmp-glibc/deploy/images/intel-x86-64/oran-image-inf-host-intel-x86-64.iso +${WORKSPACE}/prj_oran_inf/tmp-glibc/deploy/images/intel-x86-64/oran-image-inf-host-intel-x86-64.iso + +4. (Optional) Use wrapper script build_oran.sh to setup build env and build the ARM Kubernetes Cluster image +------------------------------------------------------------------------------------------------------------ + +Note: + * the ARM Kubernetes Cluster image only supports the BSP nxp-lx2xxx and is verified with the board NXP LX2160ARDB + * The ISO image is supported yet. + +:: + + # Get the wrapper script with either curl or wget + $ curl -o build_oran.sh 'https://gerrit.o-ran-sc.org/r/gitweb?p=pti/rtp.git;a=blob_plain;f=scripts/build_oran.sh;hb=HEAD' + $ wget -O build_oran.sh 'https://gerrit.o-ran-sc.org/r/gitweb?p=pti/rtp.git;a=blob_plain;f=scripts/build_oran.sh;hb=HEAD' + + $ chmod +x build_oran.sh + $ WORKSPACE=/path/to/workspace_arm + $ ./build_oran.sh -w ${WORKSPACE} -b nxp-lx2xxx + +If all go well, you will get the rootfs image in: +${WORKSPACE}/prj_oran_inf/tmp-glibc/deploy/images/nxp-lx2xxx/oran-image-inf-host-nxp-lx2xxx.tar.bz2