README.txt 5.08 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
-----------------------------------------
1) Folders and files description
-----------------------------------------

This directory contains different targets for OpenAirInterface.org implementations

ARCH/EXMIMO - Kernel driver for EXMIMO1+2 
RTAI/USER   - Target to run .11p (uses openairITS) or LTE modem (uses openair1 and openair2) for x86 in RTAI user-space
SIMU    - Simulator/Emulator target for x86
DOCS    - Doxygen documentation generation for openair1/openair2


First, you must have all four openair SW directories, openair1, openair2, openair3, and targets at the same hierarchical level as this directory.

1. The following packages must be available on your system:

17
        - ssh, python, python pexpect 
18
        - libblas and libblas-dev
gauthier's avatar
gauthier committed
19 20 21
        - libconfig++8-dev
        - libgtk-3-dev
        - libpgm-5.1 and libpgm-5.1-dev for distributed simulation with reliable multicast transmport
22
        - libxml2 and libxml2-dev and gccxml
23
        - libforms-bin libforms-dev
gauthier's avatar
gauthier committed
24 25
        - nettle-dev nettle-bin openssl libssl-dev
        - libatlas-base-dev and libatlas-headers (for Ubuntu 11.04, libatlas-dev instead of libatlas-headers)
26 27 28 29 30 31 32 33 34 35 36 37 38 39
        - asn1c and the LTE ASN1 files (for more information on how to install this and generate the required files see the README file in openair2/RRC/LITE/MESSAGES) 

----------------------------------------------------
2) Organization of the folders and their dependancies
----------------------------------------------------
The 3 folders have the following structures
   
    - EXAMPLES: there you can find some basic examples with/without the network interface
    - KERN: this folder includes the files for kernel space compilation targeting realtime operation (RF/emulation platform)
    - USER: this folder includes the files for user space compilation targeting soft realtime operation (emulation/simulation/debugging)

----------------------------------------------------------------
3)  How to use through a tutorial: run a simple experimentation
----------------------------------------------------------------
gauthier's avatar
gauthier committed
40
1. Up to know you should have created a directory: mkdir openair4G
41 42 43 44 45

2. Check out the openair4G/trunk repository:  svn co https://svn.eurecom.fr/openairsvn/openair4G/trunk openair4G

3. Now, please check the following:
   
gauthier's avatar
gauthier committed
46
   - the env variables in .bashrc the following lines, and source them if necessary :
47 48 49 50 51 52
    set OPENAIR_DIR variable and export the following:
    export OPENAIR1_DIR=$OPENAIR_DIR/openair4G/openair1
    export OPENAIR2_DIR=$OPENAIR_DIR/openair4G/openair2
    export OPENAIR3_DIR=$OPENAIR_DIR/openair4G/openair3
    export OPENAIRITS_DIR=$OPENAIR_DIR/openair4G/openairITS
    export OPENAIR_TARGETS=$OPENAIR_DIR/openair4G/targets/
53 54
    
   - checkout and compile the asn1 messages 
gauthier's avatar
gauthier committed
55
     follow the README.txt in OPENAIR2_DIR/RRC/LITE/MESSAGES to checkout the ASN.1 RRC messages
56 57
     follow the OPENAIR2_DIR/RRC/LITE/MESSAGE/asn1c/asn1c/INSTALL to install the asn1c
     go back to $OPENAIR_TARGET and "make install" if you have not used the shell script to install asn1c 
nikaeinn's avatar
nikaeinn committed
58
   - cd $OPENAIR_TARGET/SIMU/USER, and make a sanity check by doing make pre-ci (require 15 minutes)
59 60
   - Check out simple examples in $OPENAIR_TARGET/SIMU/EXAMPLES 

gauthier's avatar
gauthier committed
61
4. to automatically bring up the oai interfaces and configure the default radio bearer (useful when sending data traffic):
62 63 64 65 66 67
   - add your username into the list of sudoers
     + edit /etc/sudoers as a super user 
     + after the line: # User privilege specification, add : user_name   ALL=(ALL:ALL) ALL
     + after the line: %admin ALL=(ALL) ALL,           add : user_name   ALL=(ALL) NOPASSWD: ALL
   - include this line: alias sudo='sudo -E', to the .bashrc 
   - run oai as follows: sudo ./oaisim arg1 arg2 ....
68 69 70 71 72 73 74 75 76 77 78 79 80


----------------------------------------------------------------
4)  Detail Instructions
----------------------------------------------------------------

	Please follow the instructions given in DOCS/oaisim_walkthrough.pdf


----------------------------------------------------------------
5) OAI on virtual machine  
----------------------------------------------------------------
	you may download the image using this URL: https://emu.openairinterface.org/openairlab/openairlab.zip
gauthier's avatar
gauthier committed
81
	check that all the packages are there as some packages might be added later.
gauthier's avatar
gauthier committed
82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116


----------------------------------------------------------------
6) Installing phpmyadmin for HSS  
----------------------------------------------------------------

Step 1:

Configure database for phpmyadmin with dbconfig-common?  SELECT <Yes>


Step 2:

Please provide the password for the administrative account with which this package should create its MySQL database and user.
Password of the database's administrative user:  The mysql administrative user.


Step 3:

Please provide a password for phpmyadmin to register with the database server.  If left blank, a random password will be generated.
MySQL application password for phpmyadmin: admin


Step 4:

Password confirmation: admin


Step 5:

Please choose the web server that should be automatically configured to run phpMyAdmin.
Web server to reconfigure automatically:
        [*] apache2 
        [ ] lighttpd