|
|
---+ The <a target="_self" href="OpenAirInterface">OpenAirInterface </a>repository
|
|
|
|
|
|
The OpenAirInterface software can be obtained from our gitLab server. You will need a git client to get the sources. The repository is currently used for main developments.
|
|
|
|
|
|
---++ Prerequisite
|
|
|
|
|
|
<span style="background-color: transparent;">You need to install the subversion/git using the following commands</span>
|
|
|
|
|
|
=%BROWN%sudo apt-get update%ENDCOLOR%=
|
|
|
|
|
|
=%BROWN%sudo apt-get install subversion git%ENDCOLOR%=
|
|
|
---++ Using EURECOM Gitlab
|
|
|
|
|
|
The <a href="https://gitlab.eurecom.fr/oai/openairinterface5g.git" title="opeairinterface5g repository">openairinterface5g repository</a> holds the source code for (eNB RAN + UE RAN).
|
|
|
|
|
|
For legal issues (licenses), the core network (EPC) source code is now moved away from the above openairinterface5g git repository. This EPC code is now splitted into 2 git projects (<a href="https://gitlab.eurecom.fr/oai/openair-cn.git" title="openair-cn">openair-cn</a> with apache license and <a href="https://gitlab.eurecom.fr/oai/xtables-addons-oai.git" title="xtables-addons-oai">xtables-addons-oai</a> <span style="background-color: transparent;">with GPL license)</span>
|
|
|
|
|
|
*Configure git with your name/email address (only important if you are developer and want to checkin code to Git)*
|
|
|
|
|
|
<span style="background-color: transparent;"> </span>
|
|
|
|
|
|
%BROWN%
|
|
|
|
|
|
=git config --global user.name "Your Name"=
|
|
|
|
|
|
=git config --global user.email "Your email address"=
|
|
|
%ENDCOLOR%
|
|
|
|
|
|
<span style="background-color: transparent;"> </span>
|
|
|
|
|
|
*Add a certificate from gitlab.eurecom.fr to your Ubuntu 14.04 installation (you need to be root user)*
|
|
|
|
|
|
=echo -n | openssl s_client -showcerts -connect gitlab.eurecom.fr:443 2>/dev/null | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' >> /etc/ssl/certs/ca-certificates.crt=
|
|
|
|
|
|
*In order to checkout the Git repository (for OAI Users without login to gitlab server)*
|
|
|
|
|
|
*Checkout RAN repository (eNB RAN + UE RAN)*
|
|
|
|
|
|
%BROWN%%BROWN% git clone https://gitlab.eurecom.fr/oai/openairinterface5g.git%ENDCOLOR%%ENDCOLOR%
|
|
|
|
|
|
%BROWN%%BROWN%<br />%ENDCOLOR%%ENDCOLOR%
|
|
|
|
|
|
*Checkout EPC (Core Network) repository*
|
|
|
|
|
|
%BROWN% git clone%ENDCOLOR% https://gitlab.eurecom.fr/oai/openair-cn.git
|
|
|
|
|
|
optionally (openair-cn build script can install it for you):
|
|
|
|
|
|
<span style="color: #a52a2a;">git clone</span> https://gitlab.eurecom.fr/oai/xtables-addons-oai.git
|
|
|
|
|
|
*In order to checkout the Git repository (for OAI Developers/admins with login to gitlab server)*
|
|
|
|
|
|
Please send email to {openair_tech (AT) eurecom (DOT) fr} to be added to the repository as a developer (only important for users who want to commit code to the repository). If you do not have account on gitlab.eurecom.fr, please register yourself to gitlab.eurecom.fr.
|
|
|
|
|
|
* <span style="background-color: transparent;">Checkout with using ssh keys:</span>
|
|
|
* <span style="background-color: transparent;">You will need to put your ssh keys in </span><span style="background-color: transparent;">https://gitlab.eurecom.fr/profile/keys</span><span style="background-color: transparent;"> to access to the git repo. Once that is done, checkout the git repository using:</span>
|
|
|
* <span style="font-family: 'Courier New', courier, monaco, monospace; font-size: 12pt; background-color: transparent;"> =%BROWN%git clone [[mailto:git@gitlab.eurecom.fr:oai/openairinterface5g.git][git@gitlab.eurecom.fr:oai/openairinterface5g.git]]%ENDCOLOR%= </span>
|
|
|
* <span style="background-color: transparent;">Checkout with user name/password prompt:</span>
|
|
|
* =%BROWN%<span style="color: #b22222;" class="WYSIWYG_COLOR">git clone https://YOUR_USERNAME@gitlab.eurecom.fr/oai/openairinterface5g.git </span>%ENDCOLOR%=
|
|
|
* =%BROWN%git clone%ENDCOLOR%= =https://YOUR_USERNAME@gitlab.eurecom.fr/oai/openair-cn.git=
|
|
|
* =%BROWN% git clone%ENDCOLOR%= =https://YOUR_USERNAME@gitlab.eurecom.fr/oai/xtables-addons-oai.git= =(optional, openair-cn build script can do it for you)=
|
|
|
|
|
|
---++ <span style="font-size: 19.89px; line-height: 1em; color: #630000; background-color: transparent;">Which branch to checkout?</span>
|
|
|
|
|
|
*master*: We will ensure that master branch is most stable branch<br /><strong>develop</strong>: This branch contains recent commits that are tested on our test bench.
|
|
|
|
|
|
<span style="font-weight: normal;">We recommend using master branch or develop(if you want to work on most recent changes). We will try to keep both the branches tested and stable. In case you encounter bugs, please send email to the mailing list fir discussion. You can also send us email at {openair_tech (AT) eurecom (DOT) fr} to add you as a developer in <a href="gitlab.eurecom.fr" title="gitlab.eurecom.fr">gitlab.eurecom.fr</a> so you can collaborate with us to fix <a href="OpenAirCriticalIssues" title="bugs">bugs </a>or work on <a href="OpenAirReleases" title="future releases">future releases</a> of OAI. After that, follow the workflow for contribution from here, <a href="GitLabWorkFlow" title="https://twiki.eurecom.fr/twiki/bin/view/OpenAirInterface/GitLabWorkFlow">https://twiki.eurecom.fr/twiki/bin/view/OpenAirInterface/GitLabWorkFlow</a></span>
|
|
|
|
|
|
<span style="font-weight: normal;"><br /></span>
|
|
|
---++ <span style="font-weight: normal;"><span style="color: #630000; font-size: 19.89px; line-height: 1em; background-color: #f6f6f6;">Older SVN Release (deprecated and not RECOMMENDED for end user)</span></span>
|
|
|
|
|
|
[[OldSVNRelease][Old SVN Release]]
|
|
|
|
|
|
---++ GitLab Migration Notes
|
|
|
|
|
|
Note that git repository does not contain any branches/tags from SVN. Only [[https://svn.eurecom.fr/openair4G/trunk][http://svn.eurecom.fr/openair4G/trunk]] is migrated from r4000 to Git to reduce the size of the repository.
|
|
|
---++ |