安装时可同时参考官网文档、本文档、OAI安裝與協定觀察、OpenAirInterface安裝流程與設定。由于本人搭建时发现每一个文档或多或少都有点细节问题，或者就是本身手上的设备跟文档中的不太一致。
老版本安装可参考：Tutorial for Open Air Interfacephp
====如下内容99%转自OAI 彻底搭建手册，也有不少细节问题，请你们结合上述自行斟酌====html
开源软件OAI搭建终于成功，主要参照官网操做手册，并不断解决出现的各类问题，现将安装配置过程和遇到的主要问题整理在此文档，以供参考学习。前端
OAI开源代码分为两个部分：eNB模块openairinterface5g、核心网模块openair-cn，老版本代码的核心网部分包含EPC和HSS两个模块，新版本核心网包含MME、HSS、SPGW三个模块。推荐安装master branch，由于官网确保master是最稳定的版本，有其余开发兴趣的能够check develop branch。mysql
咱们的核心网安装在ThinkStation 64位主机上，系统Ubuntu 14.04，内核版本4.7；
eNB安装使用64位华硕主板，硬件要求corei5,i7，主频3.0GHz以上，USB3.0（射频前端要求），系统Ubuntu14.04.3 LTS，内核版本3.19。建议使用华硕主板，由于相关CPU frequency的配置较为容易。linux
官网连接：https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/OpenAirSystemRequirementsgit
eNB：web
1) 安装Ubuntu 14.04.3系统sql
2) 在BIOS里关掉全部功耗管理性能(sleep states, in particular C-states，CPU frequencyscaling )：
在/etc/default/grub中添加intel_pstate=disable，也能够添加processor.max_cstate=1intel_idle.max_cstate=0 idle=poll（optional）
执行update-grub。
在/etc/modprobe.d/blacklist.conf最末添加blacklistintel_powerclamp，若是文件不存在，新建一个。
最后确认在BIOS 关闭hyperthreading,CPU frequency control, C-States, P-States 和其余功耗管理。
安装 cpufrequtils:
sudo apt-get install cpufrequtils
编辑如下文件(如不存在新建一个):
sudo vi /etc/default/cpufrequtils
添加下面这行到文件中：
GOVERNOR=”performance”
保存退出
关闭ondemand daemon，防止重启后被改写.
sudo update-rc.d ondemand disable数据库
3) 安装3.19lowlatency内核：
sudo apt-get install linux-image-3.19.0-61-lowlatency linux-headers-3.19.0-61-lowlatencyapache
4) Reboot
Corenetwork：
1) 系统为Ubuntu14.04.5 LTS
2) 安装4.7.x版本内核，可选择官网pre-compile版本：
git clone https://gitlab.eurecom.fr/oai/linux-4.7.x.git
cd linux-4.7.x
sudo dpkg -i linux-headers-4.7.7-oaiepc_4.7.7-oaiepc-10.00.Custom_amd64.deb linux-image-4.7.7-oaiepc_4.7.7-oaiepc-10.00.Custom_amd64.deb
3) Reboot，从4.7.7-oaiepc内核启动
官网连接：https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/OpenAirKernelMainSetup
问题：
以前未从新安装4.7内核时，运行spgw会报错error inloading gtp kernel module；后从源码安装带有gtp module的4.7.x内核，登陆不了图形界面，缘由是xorg server不能成功运行，且spgw运行时报错相同。登陆界面问题经过crtl+alt+F1进入命令行界面，安装gnome服务解决。Gtp module加载失败的问题未解决，怀疑系统和内核未很好的安装所致，故从新安装了oai的pre-compile的4.7.x内核，gtp问题解决。
我本身装的时候，系统启动时没有BootLoader信息，因此没办法修改grub引导内核的顺序，遂直接把其余内核删了，只留下了4.7.7-oaiepc内核。
1) 安装Git：
sudo apt-get update
sudo apt-get install subversion git
2) 添加许可证：
sudo su
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
3) 下载源码：
eNB：
git clone https://gitlab.eurecom.fr/oai/openairinterface5g.git
corenetwork：
git clone https://gitlab.eurecom.fr/oai/openair-cn.git
官网连接：https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/GetSources
理论上讲，按照0x34步骤执行./build_hss –i 时会自动安装MySQL-server和phpmyadmin数据库管理软件，可是在实际安装时并无自动弹出安装mysql-server，致使phpmyadmin也不能成功安装，故须要在此以前在核心网机器上单独安装mysql-server。
Core network：
sudo apt-get install mysql-server
安装过程当中会弹出以下对话框，设置mysql的root密码。本机设置为Linux。
若是安装过程出现任何问题，没法成功配置root密码，则还可在命令行进行配置：
1) 打开my.cnf文件添加语句skip-grant-tables
cd /etc/mysql
vim my.cnf
service mysqld restart
2) 用空密码登陆，切换至mysql库
mysql –u root –p
mysql> use mysql
3) 重设密码
mysql> update user set password=PASSWORD(“new_pass”) where user=’root’;
4) 回到vim /etc/mysql/my.cnf，把刚才加入的那一行“skip-grant-tables”注释或删除掉
5) 从新启动使用新密码登陆
sudo service mysql restart
mysql –u root -p
eNB：
cd openairinterface5g #YOUR_openairinterface5g_DIRECTORY
source oaienv #Very important. It sets the correct environment variables.
cd cmake_targets
./build_oai -I –install-optional-packages #need to run only once
./build_oai –h #show help
Core network:
cd openair-cn #YOUR_openair-cn_DIRECTORY
cd SCRIPTS
./build_mme -i #Need to run only once to install missing packages
./build_hss -i #Need to run only once to install missing packages
./build_spgw -i #Need to run only once
在核心网安装此过程当中会弹出对话框进行phpmyadmin的配置：
问题：
1. 安装过程当中报错error2002：can’t connect to local mysql server through socket。
检查后发现mysql-server并无自动安装。为了不后续导入数据库出错，从新安装了系统和内核，在执行此步骤前先手动安装mysql-server，问题解决。
2. 在浏览器输入127.0.0.1/phpmyadmin,出现not found界面。
须要在Apache配置中添加phpmyadmin
打开apache.conf文件：
vim /etc/apache2/apache2.conf
添加下面语句：
include /etc/phpmyadmin/apache.conf
从新启动apache服务：
/etc/init.d/apache2 restart
官网连接：https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/AutoBuild
eNB：
1) 修改eNB配置文件，位置：~/openairinterface5g/targets/PROJECTS/GENERIC-LTE-EPC/CONF/enb.band7.tm1.usrpb210.conf
tracking_area_code = "1";
mobile_country_code = "466";
mobile_network_code = "68";
////////// MME parameters:
mme_ip_address = ( { ipv4 = "192.168.31.134";
ipv6 = "192:168:30::17";
active = "yes";
preference = "ipv4";
}
);
NETWORK_INTERFACES :
{
ENB_INTERFACE_NAME_FOR_S1_MME = "eth0";
ENB_IPV4_ADDRESS_FOR_S1_MME = "192.168.31.210/24";
ENB_INTERFACE_NAME_FOR_S1U = "eth0";
ENB_IPV4_ADDRESS_FOR_S1U = "192.168.31.210/24";
ENB_PORT_FOR_S1U = 2152; # Spec 2152
};
此文件须要更改两处，第一是与sim卡信息对应的mmc、mnc值，第二是eNB本机的网卡与ip地址与核心网MME的ip地址。咱们所使用的sim卡对应的mmc为466，mnc为68。eNB端网卡为eth0，ip address：192.168.31.210；MME的ip address为192.168.31.134.
2) 修改openairinterface5g/openair3/UTILS/mmc-mnc-itu.c文件，添加{466.68}.
Corenetwork：
1) 配置FQDN
域名须要为MME正确配置，咱们能够经过hosts查看：
$ cat /etc/hostname
openair-cn
可按照以下输出修改etc/hosts文件：
$ cat /etc/hosts
127.0.0.1 localhost
127.0.1.1 openair-cn.openair4G.eur openair-cn
127.0.1.1 hss.openair4G.eur hss
修改host后要重启机器。
在如下信息彻底符合时方可继续！
$ hostname
Openair-cn
$ hostname -f
Openair-cn.openair4G.eur
2) 修改core network配置文件
将EPC的配置文件复制到/usr/local/etc/oai目录中：
sudo mkdir -p /usr/local/etc/oai/freeDiameter
sudo cp ~/openair-cn/ETC/mme.conf /usr/local/etc/oai
sudo cp ~/openair-cn/ETC/hss.conf /usr/local/etc/oai
sudo cp ~/openair-cn/ETC/spgw.conf /usr/local/etc/oai
sudo cp ~/openair-cn/ETC/acl.conf /usr/local/etc/oai/freeDiameter
sudo cp ~/openair-cn/ETC/mme_fd.conf /usr/local/etc/oai/freeDiameter
sudo cp ~/openair-cn/ETC/hss_fd.conf /usr/local/etc/oai/freeDiameter
此后只修改此目录下的配置文件。
3) hss.conf
HSS :
{ ## MySQL mandatory options
MYSQL_server = "127.0.0.1";
MYSQL_user = "root";
MYSQL_pass = "linux"; #此处为配置mysql是设置的root密码
MYSQL_db = "oai_db";
## HSS options
OPERATOR_key = "11111111111111111111111111111111"; # OP key for oai_db.sql
RANDOM = "true";
## Freediameter options
FD_conf = "/usr/local/etc/oai/freeDiameter/hss_fd.conf";
};
此文件中注意配置好mysql的登陆名和密码，OPERATOR_key是sim卡中肯定的。本卡中为32位的1.
4) hss_fd.conf
Identity = "hss.openair4G.eur";
Realm = "openair4G.eur";
5) mme_fd.conf
Identity = "openair-cn.openair4G.eur";
Realm = "openair4G.eur";
ConnectPeer= "hss.openair4G.eur" { ConnectTo = "127.0.0.1"; No_SCTP ; No_IPv6; Prefer_TCP; No_TLS; port = 3868; realm = "openair4G.eur";};
6) mme.conf
REALM = "openair4G.eur";
S6A :
{
S6A_CONF = "/usr/local/etc/oai/freeDiameter/mme_fd.conf"; # YOUR MME freeDiameter config file path
HSS_HOSTNAME = "hss"; # THE HSS HOSTNAME
};
GUMMEI_LIST = (
{MCC="466" ; MNC="68"; MME_GID="4" ; MME_CODE="1"; } # YOUR GUMMEI CONFIG HERE
);
TAI_LIST = (
{MCC="466" ; MNC="68"; TAC = "1"; } # YOUR PLMN CONFIG HERE
);
NETWORK_INTERFACES :
{
# MME binded interface for S1-C or S1-MME communication (S1AP), can be ethernet interface, virtual ethernet interface, we don't advise wireless interfaces
MME_INTERFACE_NAME_FOR_S1_MME = "eth0"; # YOUR NETWORK CONFIG HERE
MME_IPV4_ADDRESS_FOR_S1_MME = "192.168.31.134/24"; # YOUR NETWORK CONFIG HERE
# MME binded interface for S11 communication (GTPV2-C)
MME_INTERFACE_NAME_FOR_S11_MME = "lo"; # YOUR NETWORK CONFIG HERE
MME_IPV4_ADDRESS_FOR_S11_MME = "127.0.11.1/8"; # YOUR NETWORK CONFIG HERE
MME_PORT_FOR_S11_MME = 2123; # YOUR NETWORK CONFIG HERE
};
S-GW :
{
# S-GW binded interface for S11 communication (GTPV2-C), if none selected the ITTI message interface is used
SGW_IPV4_ADDRESS_FOR_S11 = "127.0.11.2/8"; # YOUR NETWORK CONFIG HERE
};
此文件中要注意修改MCC，MNC以及MME的网卡及ip地址。
7) spgw.conf
S-GW :
{
NETWORK_INTERFACES :
{
# S-GW binded interface for S11 communication (GTPV2-C), if none selected the ITTI message interface is used
SGW_INTERFACE_NAME_FOR_S11 = "lo"; # STRING, interface name, YOUR NETWORK CONFIG HERE
SGW_IPV4_ADDRESS_FOR_S11 = "127.0.11.2/8"; # STRING, CIDR, YOUR NETWORK CONFIG HERE
# S-GW binded interface for S1-U communication (GTPV1-U) can be ethernet interface, virtual ethernet interface, we don't advise wireless interfaces
SGW_INTERFACE_NAME_FOR_S1U_S12_S4_UP = "eth0"; # STRING, interface name, YOUR NETWORK CONFIG HERE, USE "lo" if S-GW run on eNB host
SGW_IPV4_ADDRESS_FOR_S1U_S12_S4_UP = "192.168.31.134/24"; # STRING, CIDR, YOUR NETWORK CONFIG HERE
SGW_IPV4_PORT_FOR_S1U_S12_S4_UP = 2152; # INTEGER, port number, PREFER NOT CHANGE UNLESS YOU KNOW WHAT YOU ARE DOING
# S-GW binded interface for S5 or S8 communication, not implemented, so leave it to none
SGW_INTERFACE_NAME_FOR_S5_S8_UP = "none"; # STRING, interface name, DO NOT CHANGE (NOT IMPLEMENTED YET)
SGW_IPV4_ADDRESS_FOR_S5_S8_UP = "0.0.0.0/24"; # STRING, CIDR, DO NOT CHANGE (NOT IMPLEMENTED YET)
};
P-GW =
{
NETWORK_INTERFACES :
{ # P-GW binded interface for S5 or S8 communication, not implemented, so leave it to none
PGW_INTERFACE_NAME_FOR_S5_S8 = "none"; # STRING, interface name, DO NOT CHANGE (NOT IMPLEMENTED YET)
# P-GW binded interface for SGI (egress/ingress internet traffic)
PGW_INTERFACE_NAME_FOR_SGI = "eth0"; # STRING, YOUR NETWORK CONFIG HERE
PGW_MASQUERADE_SGI = "yes"; # STRING, {"yes", "no"}. YOUR NETWORK CONFIG HERE, will do NAT for you if you put "yes".
UE_TCP_MSS_CLAMPING = "no"; # STRING, {"yes", "no"}.
};
此中要注意修改网卡和ip地址。
8) 修改openair-cn/SRC/UTILS/mmc-mnc-itu.c文件，添加{466.68}.
官网连接：https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/HowToConnectCOTSUEwithOAIeNBNew
eNB：
将usrpb210插上USB3.0口进行编译
cd ~/openairinterface
source oaienv
cd cmake_targets
./build_oai -I –eNB -x –install-system-files -w USRP –install-optional-packages #for USRP
-I: installs required packages.
–eNB: installs eNB, i.e., lte-softmodem.
-x: adds a software oscilloscope feature to the producedbinaries.
–install-system-files: installs OAI required files inLinux system.
-w: adds the hardware support, which is USRP in our case.
–install-optional-packages: Installs optional packages
Corenetwork：
1) 安装许可证
cd ~/openair-cn/SCRIPTS
./check_hss_s6a_certificate /usr/local/etc/oai/freeDiameter/ hss.openair4G.eur
./check_mme_s6a_certificate /usr/local/etc/oai/freeDiameter/ openair-cn.openair4G.eur
2) 编译hss，安装数据库
cd ~/openair-cn
cd SCRIPTS
./build_hss -c
./run_hss -i ~/openair-cn/SRC/OAI_HSS/db/oai_db.sql #Run only once to install database
此处oai会经过oai_db.sql脚本安装oai_db数据库，登陆数据库可查看相关table。若是未成功安装，可后续经过此脚本进行手动添加数据库。
3) 编译mme
cd ~/openair-cn/SCRIPTS
./build_mme -c
4) 编译spgw
cd ~/openair-cn
cd SCRIPTS
./build_spgw -c
核心网本机浏览器输入127.0.0.1/phpmyadmin登陆phpmyadmin界面对oai_db数据库进行修改，以匹配sim卡信息与MME信息。
1) Table users
选中左侧数据库oai_db，打开表users。点击上方Structure标签，将key，rand，OPc三个值的类型从varbinary改成binary。再点击上方SQL标签，在打开的空白框中输入
INSERT INTO users (`imsi`, `msisdn`, `imei`, `imei_sv`, `ms_ps_status`, `rau_tau_timer`, `ue_ambr_ul`, `ue_ambr_dl`, `access_restriction`, `mme_cap`, `mmeidentity_idmmeidentity`, `key`, `RFSP-Index`, `urrp_mme`, `sqn`, `rand`, `OPc`) VALUES ('466680000000001', '33611123456', '35609204079299', NULL, 'NOT_PURGED', '120', '40000000', '100000000', '47', '0000000000', '1', 0x8BAF473F2F8FD09487CCCBD7097C6862, '1', '0', '', 0x00000000000000000000000000000000, '');
执行后成功在表中添加了此user。其中imsi为sim卡对应信息（466680000000001）；key值为sim中肯定信息（8BAF473F2F8FD09487CCCBD7097C6862）；mmeidentity设为1，要与mmeidentity中信息对应；sqn值可暂时不设，rand值随机设为32位的hex数；OPc值在鉴权中相当重要，它经过数据库中的key值与hss配置文件中设定的OP值计算得出，必需要与sim卡中此值相符，鉴权才可经过。故在配置数据库时必定要肯定本身sim卡中的key，OP值，并在数据库和hss.conf文件中正确填写。
问题：
在修改数据库时咱们遇到了一些问题，主要是所填信息与sim卡信息不符，填写方式不对等缘由形成的。
1.在phpmyadmin数据库中直接点击上方insert进行添加，报错key，rand和OPc三个值数据被截断；
2.直接修改现有的数据，报错数据被截断；
3.在mysql命令行中直接执行添加命令，有warning，缘由仍是数据被截断；
4.修改key，rand和OPc的数据长度，从varbinary16改成varbinary32，添加数据不会被截断，可是运行hss时数据会自动变化，致使鉴权依旧失败。
最终经过学习查找数据类型的不一样，将数据改成binary，而且添加时写成0x的16进制数，才添加成功，同时这也是咱们调试系统跑通前解决的最后一个问题。
2) Table mmeidentity
将表格中idmmeidentity=1的那行mmehost改成oai-cn.openair4G.eur, mmerealm改成openair4G.eur, 与mme配置文件中相符。
3) Table pdn
新添加一行或修改一行，添加数据users_imsi=466680000000001.
4) Table pgw
将表中id=3（对应table pdn中的pgw_id值）的那行ipv4改成mme本机地址192.168.31.134，ipv6写0.
在全部修改都完成后，可重复编译并运行。在全部模块中必定要先启动hss。
Corenetwork：
cd ~/openair-cn/SCRIPTS
./build_hss -c
./run_hss #Run for all subsequent runs
cd ~/openair-cn/SCRIPTS
./build_mme -c
./run_mme
cd ~/openair-cn/SCRIPTS
./build_spgw -c
./run_spgw
eNB:
cd ~/openairinterface5g/cmake_targets/lte_build_oai/build
sudo -E ./lte-softmodem -O ~openairinterface5g/targets/PROJECTS/GENERIC-LTE-EPC/CONF/enb.band7.tm1.usrpb210.conf -d
sudo -E ./lte-softmodem -h #(to see help options)
各模块运行成功后将sim卡放入HUAWEI Dongle中，断开笔记本电脑的网络链接，将dongle插入，笔记本电脑可正常上网。
当前网络性能不稳定，打开多个网页后会断开链接，还需后续调试。