EPC User's Guide
Contents
1. 2 yang openair4G eur openair4G eur 0 1 ng40 erc openair4G eur openair4G eur 0 3 ABEILLE openair4G eur openair4G eur 0 Page 22 of 32 Table pdn This table contains mainly the association between a user and a APN and its QOS parameters Structure Field Type Null Key Default Extra sd 1nt 11 NO PRI NULL auto_increment apn varchar 60 NO NULL pdn_type enum IPv4 IPv6 IPv4v6 IPv4_or_IPv6 NO NULL pdn_ipv4 varchar 15 YES NULL 0 0 0 0 pdn ipv6 varchar 45 YES NULL 0 0 0 0 0 0 0 0 aggregate ambr ul int 10 unsigned YES 50000000 aggregate ambr dl int 10 unsigned YES 100000000 pgw id int 11 NO PRI NULL users_imsi varchar 15 NO PRI aci tinyint 3 unsigned NO 9 priority_level tinyint 3 unsigned NO 15 pre emp cap enum ENABLED DISABLED YES DISABLED pre emp vul enum ENABLED DISABLED YES DISABLED LIPA Permissions enum LIPA prohibited LIPA only LIPA YES LIPA only conditional Table 14 SQL Table structure pdn Column id is the primary key of a pdn entry Column pdn_type contains the type of PDN actually only IPv4 is supported Column pdn_ipv4 contains the IPv4 address of the PDN unused Column pdn ipv6 contains the IPv6 address of the PDN unused Column aggregate_ambr_ul TODO Column aggregate_ambr_dl TODO Column pgw_id TODO Column users_imsi TODO Column qci TODO Column priority_level TODO Colu2. senarenrnonvnenvnenvvrnvnnnvnnvnvnenrnenrarnraserasevasenesenensnvnsnvnsnvensnene 27 5 3 Routing Area Update procedures 27 5 4 Service Request procedures snnranvnnnvnnnvvnnvnnnnnnenrarnrarvrnserasensssnansnensnvnsnnnsnvennvensnnnneneneesvresen 27 5 4 L UE triggered Service REQUEST 27 5 4 2 Network triggered Service Request rrnrnonvnonvnnnvvnnvvnnvnnenrnenrarnraserasersssnsrenensnveenneenvennuene 27 Page 4 of 32 5 5 SL R le s procedure smse espn in lid 27 5 6 GUTI Reallocation procedure ornini e E E R E EEA 27 5 7 Detach proce dE vocacion pee aeri ae aiia p e Ra E ae EE pe ede Sa 27 5 7 1 UE Initiated Detach procedure for E UTIRAN A 27 5 7 2 MME Initiated Detach procedure for E UTRAN AAA 27 5 7 3 HSS Initiated Detach procedure for E UTRAN AAA 27 5 8 HSS User Profile management function procedure ssrnnnvnvnrnvnvnrnrarerarenanenenenenenvesnvnsnvensvene 27 5 9 Bearer de activatlON decided DESEN te NEE AE 27 5 9 1 PDN GW initiated bearer deactivation ronvronvronvvnnvvnnvvnnnrnrnvernrnsersserasenrrsnnrsnvesnvnenvenneeee 27 5 9 2 MME initiated Dedicated Bearer Deactivation eee eeseessecseceseceseceseceeceseeeseeeeeeeenes 27 5 10 Intra E UTRAN handover is istede diante dei dida 28 6 Annex A Tools for observing debugging cooonoconoccconnnoncconnnonnnonononanononono nono nono nono no cnc cnn cnnncnnn ninas 29 6 1 itti analyzers id RA cs 29 GT Insta A A A A eedetice 29 6 1 2 EXECCUlOM EE 29 6 2 W
3. user host openair4G trunk cmake_targets tools build_hss debug transport sctp only optional parameters clean operator key 11111111111111111111111111111111 for example 4 1 3 Running EPC In a shell go to your openair root directory openair4G trunk or openair4G releases rel_xxxxx If MME GW and the HSS run on the same host execute the following commands user host openair4G trunk cmake_targetsS tools run epc 1 userfihost openair4G trunk cmake_targets tools run bas Page 25 of 32 Else execute the following command On HSS host user host openair4G trunk cmake_targets tools run bas On MME GW host userfihost openair4G trunk cmake_targets tools run epc Have a look at all these executables options h option Page 26 of 32 5 Supported scenarios in EPC 5 1 E UTRAN Initial attach 5 1 1 Attach with IMSI TBD 5 1 2 Attach with GUTI TBD 5 2 Tracking Area Update procedures TBD 5 3 Routing Area Update procedures Not supported yet 5 4 Service Request procedures 5 4 1 UE triggered Service Request TBD 5 4 2 Network triggered Service Request Not supported yet 5 5 S1 Release procedure TBD 5 6 GUTI Reallocation procedure 5 7 Detach procedure 5 7 1 UE Initiated Detach procedure for E UTRAN 5 7 2 MME Initiated Detach procedure for E UTRAN 5 7 3 HSS Initiated Detach procedure for E UTRAN Not supported 5 8 HSS User Profile management function procedure Not supported 5 9 Bearer d
4. Mscgen is a small program that parses Message Sequence Chart descriptions and produces PNG SVG EPS or server side image maps ismaps as the output Message Sequence Charts MSCs are a way of representing entities and interactions over some time period Mscgen aims to provide a simple text language that is clear to create edit and understand which can also be transformed into common image formats for display or printing Openair use mscgen to offer another view of events SDUs timers etc that happens inside an executable and also still under development PDUs exchanged between protocol entities Openair HSS do not have the msgen feature Important Check that mscgen traces are configured for being generated CFLAG MESSAGE_CHART_GENERATOR set to true in OPENAIR_DIR cmake_targets epc_build_oai CMakeLists template Page 30 of 32 You have to instruct the openair mme gw executable to dump the ITTI messages to a file with the argument m path_to_directory The mscgen files will be located under the specified directory in a directory containing the time of the generated traces text and png files Example SJAP ENB GIPU SGW MINE APP NAS MME NAS EM NAS ESN SP GW ME E HSS 110 S1Setup Originating messano re id 21 stream O y I e 16101515 eu duer pesos AS 1710 rit all E Mos sage Originating rrossage assoc ld 23 stream 1 017659720 1 MME_APP_CONNECTION I o ESTABLISHMENT
5. a S GW and a P GW configuration section This configuration files follow the libconfig file syntax http www hyperrealm com libconfig These sections are described below Configuration file mme_fd conf This configuration file is the input file for configuring the diameter protocol instance of the MME_GW 3 2 MME Empty section will be updated when a standalone MME will be released 3 3 SP_GW Empty section will be updated when a standalone S P GW will be released 3 4 MME configuration content Parameter Type REALM String Diameter realm of the MME MAXENB Num Integer Maximum number of eNB that can connect to MME MAXUE Num Integer For debug purpose used to restrict the number of served UEs the MME can handle RELATIVE_CAPACITY Num Integer Even though this parameter is not used by the MME for controlling the MME load balancing within a pool at least for now the parameter has to be forwarded to the eNB during association procedure Values going from 0 to 255 Default value is 15 MME STATISTIC TIMER Num Integer Displayed statistic stdout period EMERGENCY ATTACH SUPPORTED String UNAUTHENTICATED IMSI SUPPORTED String IP CAPABILITY String Choice between IPV4 IPV4V6 IPV40RV6 Table 1 MME configuration main section 3 4 1 GUMMEI section Parameter Type MME CODE Array of Num Integer List of a maximum of 256 values can be provided MME code range is 0 255 MME GID Array of Num Integer L
6. IND lo EMMAS ESTABUSH REQ ue d 73902630 tac 1 JA AUTH INFO REO IMS 208 00001 vlt simn 209F93 re nco gt A AUT INFO ANS imsi 2 een DIAMETER SUCCESS 290 NAS_AUTHENTICATION PARAM RSP us id JeocgE3o ne_vectors 1 r CATION PARAM RSP ue WA 25 0 MACH AUTHENTICATION PARAM RES 280 EMMAS SECURITY REQued VS MAS DOWNLINK OATA AEQ ve kl 7R002E 30 len 36 1250 down rkNAS Transport intiatingMossng9 ua ld Ox73002E30 mme ue lm ld 0178002830 ONS vo au I 2D nas length 36 2010 EMVRGG OMMON PROC AFO tse id 7002490 aurhortication 3110 uplink NAS Transport Cranatng mers nag mme uP slap 1d Ox7OCZEIG oNB_ue_s1ap H 01066920 nas len 11 320 NAS UPLINK DATA IND vo id 0178002630 lon 11 gt 3910 EMMAS DATA IND ue id 78003690 len 11 aan EMMREG_COMMON_PROC_CNF ue d 79002000 3810 EMMAS SECURITY REQue d 73002830 ECT HODET OMMAND tue ECH J AS DOWNENX DATA Ai ved lez 926 20 len 2 1380 down rktNAS Transport rbiatingassage us id 0x79002 30 mme ue de 2 nas length 13 78002E3O ONS vo s13p k 990 EMUREG_COMMON_PROC_REO ue id 78022000 security mode corra 20 n s len a GEN Ba bie H 0x0 40 0 pr SECH HEEN message mene ue siap ki Ox7e 41 0 NAS UPLINK DATA IND vo dor 10 F MAS DATA IND so id 72002690 len A PA RE 43101 Eege COMMON PROG CNF ue la 78002000 securty moce completo 44 0
7. 4_ADDRESS_FOR_S5_S8_UP String CIDR notation Binded address for S5 or S8 0 0 0 0 xx because unused Table 9 S GW configuration main section Page 17 of 32 3 6 P GW configuration content 3 6 1 Main section Parameter Type DEFAULT_DNS_1_IPV4_ADDRESS String IPv4 dot decimal IPv4 address of primary default DNS that can be queried by UEs DEFAULT_DNS_2_IPV4_ADDRESS String IPv4 dot decimal IPv4 address of secondary default DNS that can be queried by UEs Table 10 P GW configuration main section 3 6 2 Network interfaces section Parameter PGW INTERFACE NAME _FOR_S5_S8 String Interface name for S5 or S8 none because unused PGW_IPV4_ADDRESS_FOR_S5_S8 String CIDR notation Binded address for S5 or S8 0 0 0 0 xx because unused PGW_INTERFACE_NAME_FOR_SGI String Interface name for SGi PGW_IPV4_ADDRESS_FOR_SGI String CIDR notation Used IPv4 address for SGi useful if UE traffic is masqueraded PGW_MASQUERADE_SGI String Should outgoing UE IPv4 traffic be masqueraded source NAT yes or Table 11 P GW configuration subsection Network Interfaces 3 6 3 IP Address Pool section Parameter IPV4 LIST String CIDR notation List of IPv4 netmasks that designate a list of available IPv4 addresses for UEs IPV6 LIST String CIDR notation List of IPv6 netmasks that designate a list of available IPv6 addresses for UEs Table 12 P GW configuration subsection IP Address Pool Selection Pa
8. 75 yin openair4G eur hss yin 3 1 2 Configuration files Here is view of the build process of MME_GW we can see there when and how configuration files are generated Inputs files and parameters are on the left part of the figure the build process is in the center part and output configuration files are on the right of the figure Build process OPENAIR_DIR cmake_targets tools build_epc Start DIR cmake_targets epc_build_oai CMakeLists template OPENAIR_DIR cmake_targets CMakeLists txt usr etc freeDiameter mme cakey pem usr etc freeDiameter mme cert pem OPENAIR_DIR cmake_targets tools check_mme_s6a_certificate LS conf T OPENAIR_DIR cmake_targets epc_build_oai build Makefile Refer to OPENAIR_DIR ke_t t build_oai CMakeLists txt DiR cmake_targets ape build _oal CMakeListe tir Cmake Makefile generation gt Cmake variable substitution MME S6a conf section refer to OPENAIR_DIR cmake_targets tool c conf in de e e Sa d Ge emeng OPENAIR_DIR targets bin epc conf PENAIR DII e targets tool End Figure 9 MME_GW configuration files generation Configuration file Epc conf and epc local enb conf Page 14 of 32 O These configuration files since MME_GW is an aggregation of a MME a S GW and a P GW aggregate three configuration sections a MME
9. ACH set MYSQL admin root CACH set MYSQL admin pass linux CACH set MYSQL user hssadmin CACH set MYSQL pass admin CACH set MYSQL db oai db CACH set TRANSPORT option No_TCP CACH FreeDiameter config option set TRANSPORT PREFER TCP option FreeDiameter config option set AppServThreads 2 option set OPERATOR key VS example 11111111111111111111111111111111 set RANDOM_boolean true 0 else random as usual set REMOTE PEER WHITELIST REALM CACHE STRING spaces for freediameter acl conf config hss_fd conf in content aa Lodalen as returned by hostname fqdn dentity RHSS_FODNG the framework uses the part of the Realm GQGREALMQ Page 20 of 32 Prefer TCP CACHE STRING CACHE STRING CACHE STRING CACHE STRING LTE operator clear text key Remote peer whitelist file The first parameter in this section is Identity which will be used to identify this peer in the Diameter network The Diameter protocol mandates that the Identity used is a valid FODN for the peer This parameter can be omitted in that case the framework will attempt to use system default value In Diameter all peers also belong to a Realm If the realm is not specified dentity after the first dot This parameter is mandatory even if it is possible to disable TLS for peers connections A valid certificate for this Diameter Identity is expected TLS_Cred FREEDIAMETER_PAT
10. EPC User s Guide Editor EURECOM Deliverable nature Public Due date July 2015 Delivery date June 2015 Version 0 2 Total number of pages 32 Reviewed by Keywords EPC LTE MME S GW HSS S1AP DIAMETER Abstract The deliverable presents the EPC developed by EURECOM The document presents the deployment scenarios of the EPC its configuration installation and running List of authors Company Authors EURECOM Christian BONNET Lionel GAUTHIER Rohit GUPTA Florian KALTENBERGER Raymond KNOPP Navid NIKAIEN Cedric ROUX Laurent THOMAS Page 2 of 32 History Modified by Date Version Comments Lionel GAUTHIER 09 06 2015 0 1 Initial Draft Lionel GAUTHIER 11 06 2015 0 2 Minor corrections Page 3 of 32 Table of Contents A A NN 3 Table of Contentsitierici ill talca 4 List OF PIQUTES liada li citado aa atlas AG ete ii 6 istot tabl Ssnan nen neset 7 Abbreviations a A rene 8 TO INTO LUCO cn A A edda 9 1 1 E MEET 9 1 2 Deployment scenarios ii A A dere 9 1 2 1 Separate EPC plato MM oi ii 9 1 22 All mm one EPC platformie masa Ook aes Meinl hae 10 2 EPCIAStal ton duna snertne er e 11 2 1 Operating Mini iii 11 2 2 IS ee 11 2 3 Additional software initial Steps ooooonnncnnoconococonoconcconnconnnonn nono nono nono nono nc nn nono nono nc conc cnnncnnncnnss 11 2 3 1 Mysql server installation details 0 eee cesceseceseceseeeeee
11. H etc freeDiameter hss cert pem FREEDIAMETER_PATH etc freeDiameter hss key pem TLS CA FREEDIAMETER_PATH etc freeDiameter hss cacert pem Prefer_TCP or comment s FreeDiameter AppServThreads config If false random function returns separated E STRING Database server IP address E STRING Database admin login E STRING Database admin password E STRING Database username login E STRING Database username password E STRING Database name E STRING No_TCP or No_SCTP or comment string tring bytes always Oy Disable use of TCP protocol only listen and connect in SCTP Default TCP enabled TRANSPORT_option This option is ignored if freeDiameter is compiled with DISABLE_SCTP option Prefer TCP instead of SCTP for establishing new connections This setting may be overwritten per peer in peer configuration blocs Default SCTP is attempted first TRANSPORT_PREFER_TCP_option Disable use of IPv6 addresses only IP Default IPv6 enabled No IPv6 Overwrite the number of SCTP streams This value should be kept low especially if you are using TLS over SCTP because it consumes a lot of resources in that case See tickets 19 and 27 for some additional details on this Limit the number of SCTP streams SCTP_streams 3 By default freeDiameter acts as a Diameter Relay Agent by forwarding all messages it cannot handle locally This parameter disables this behavior
12. NAS_PDN_CONNECTIVITY REO ue id 78002630 IMSI 70 _PON_COANECTNVITY AEQ us id 79005 440 SEA UPDATE LOCATION REO sei 20h030000300001 gt Figure 13 Mscgen output example 6 4 S1AP scenario replay Not released under development The aim of this tool is for debug purpose when replaying a scenario is needed it can also be used for non regression tests This tool takes as input the pcap record of S1AP exchanges between eNB and MME and also some records of the HSS database then generate C code that replays the scenario To make this possible it is necessary to configure the HSS not to randomize the keys build_hss your options random no Steps 6 4 1 Capture a scenario 1 Configure your EPC environment 2 Start a pcap capture of slap protocol on S1 interface with wireshark or tshark 3 Capture a snapshot of the database with the tool xxxx 4 Play the scenario with the EPC eNB s UE s 5 Save the pcap trace and the snapshot of the database Page 31 of 32 6 4 2 build a SIAP scenario from pcap trace TODO 6 4 3 Replay a S1AP scenario TODO Page 32 of 32
13. NoRelay TLS_old_method Number of parallel threads that will handle incoming application messages This parameter may be deprecated later in favor of a dynamic number of threads depending on the load AppServThreads AppServThreads Specify the addresses on which to bind the listening server This must be specified if the framework is unable to auto detect these addresses or if the auto detected values are incorrect Note that the list of addresses is sent in CER or CEA message so one should pay attention to this parameter if some adresses should be kept hidden ListenOn DIAMETER_PORT DIAMETER_SEC_PORT See RSE Extensions 2 Uncomment and create rtd conf to specify routing table for this peer LoadExtension rt_default fdx rtd conf Uncomment and create acl conf to allow incoming connections from other peers LoadExtension acl wl fdx FREEDIAMETER_PATH etc freeDiameter acl conft Uncomment to display periodic state information LoadExtension dbg_monitor fdx Uncomment to enable an interactive Python interpreter session see doc dbg_interactive py sample for more information LoadExtension dbg_interactive fdx Load the RFC4005 dictionary objects LoadExtension dict_nasreq fdx LoadExtension dict_nas_mipv6 fdx LoadExtension dict_s6a fdx Load RFC4072 dictionary objects LoadExtension dict_eap fdx Load the Diameter EAP server extensi
14. aireshark tshark osc site A enee ee 30 6 3 MSC Mi A A A rer 30 6 4 SLAP scenario replay da a an ease 31 6 4 1 Capture Scenario EE 31 6 4 2 build a SIAP scenario from pcap face 32 6 4 3 Replay a SIAP scenario srrrrereneersessrrrresrrrssennesennsenpsersannsssrnrvenprerennssennsesnsnesennsseennesnene 32 Page 5 of 32 List of Figures Fis re EE EE 9 Figure 2 EPC Deployment in MME SP OW 9 Figure 3 EPC Deployment in MME OW 10 Figure 4 Mysql installation root D ssword nono nono nocn noc nn cnn cnn nnnnnnnn cnn cra nrnn nano 12 Figure 5 Phpmyadmin installation conf DD 12 Figure 6 Phpmyadmin installation DB password seoenvonnnvnnnvnenrnrvrnreraserarenrnenensnvnsnvnsnnnsnvrnsvensnenenensnseee 13 Figure 7 Phpmyadmin installation app password soennvvnvnrnvnvnrnvnrvrarerarevrsevenenensnvnsnvnsnvennnennnennenenensnseee 13 Figure 8 Phpmyadmin installation web server selecton crac nrnn nono nora ncnnnos 13 Figure 9 MME GW configuration files generatton cra cra cra nono 14 Figure 10 HSS configuration files generaton cnn cra crac 19 Figure 11 ITTI Analyzer main Window cooccoccconccnonnnnnnnnnnnnnnnnnnonnncnn conoce nono cn noc nn cnn cnn nennn ran n rn non crac 29 Figure 12 ITTI Analizer select filter meng 30 Figure 13 Mscgen output ex ample ccoo ccoo A E E E i E e eE 31 Page 6 of 32 List of tables Table I MME configuration main section ooooonocnnonononoconoconaconaconnconnnonn nono ncnn nono n con n cnn no nn
15. ation Equipment Identity International Mobile Station Equipment Identity Software Version Long Term Evolution Mobility Management Entity Mobile Station International Subscriber Directory Number Network PDN Gateway Packet Data Network Gateway Packet Data Network Quality of Service Stream Control Transmission Protocol Serving Gateway Subscriber Identity Module Transmission Control Protocol Universal Subscriber Identity Module 1 Introduction 1 1 Overview The EURECOM EPC is a bundle of software components that provides the MME S P GW HSS functions of the LTE core EPC architecture http www 3gpp org DynaReport 23002 htm Actually the SGW and the PGW are merged together there is no S5 or S8 interface between the two functional entities a Teen s11 S1 U Sfj INTERNET Figure 1 EPC overview 1 2 Deployment scenarios Two deployment scenarios are considered with the EURECOM EPC 1 2 1 Separate EPC platform Actually this deployment scenario is under development and cannot be demonstrated yet EPC mme executable eNB 11 EPC sp_gw bee kernel module S1 U SGi INTERNET Figure 2 EPC Deployment in MME SP GW Page 9 of 32 1 2 2 All in one EPC platform The following picture depicts a EURECOM EPC providing MME and GW functions and interact with the EURECOM HSS In this deployment scenario the S11 interface is v
16. d all parameters passed to the build_hss executable and also its default parameters are substituted in the right place in this config file hss conf in content MySQL mandatory options MYSQL server MYSOL servere MYSQL_user MYSOL_user MYSQL_pass MYSQL passe MYSQL db MYSQL _dbe HSS options OPERATOR_key OPERATOR_key Page 19 of 32 RANDOM RANDOM_boolean Freediameter options FD conf FREEDIAMETER_PATH etc fr Diameter hss fd conf The following is an example of the resulting config file hss conf MySQL mandatory options MYSQL_server 127 0 0 1 MYSQL_user hssadmin MYSQL_pass admin MYSQL_db oai_db HSS options OPERATOR_key 11111111111111111111111111111111 RANDOM FALSE Freediameter options FD_conf usr lib etc freeDiamet r hss_fd conf Configuration file hss_fd conf in This configuration file is the input file for configuring the diameter protocol instance of the HSS All parameters values between 0 are filled by the cmake process These parameters are set with the help of input parameters passed to the build_hss executable and with the help of default values set in the cmake_targets hss_build CMakeLists txt file You can see here what are default values defined in cmake_targets hss_build CMakeLists txt and set your own set MYSQL server TZ Hr Er LR C
17. ding on what is recommended on the openair mailing list openair4g devel O eurecom fr you should use the trunk or the latest release Tf svn is not installed on your computer execute in a shell the following command user host sudo apt get install subversion Then to retrieve the source code if you have read only access execute in a shell the following command user host svn co http svn eurecom fr openair4G trunk or user host svn co http svn eurecom fr openair4G releases rel_x y_dd mm yyyy If you have write access user host svn co http svn eurecom fr openairsvn openair4G username mysvnlogin The source code in a release directory or in the trunk directory is organized as follow cmake_targets Openair build system latest common Common code to all layers openair1 Physical layer source code openair2 Layer 2 MAC RLC RRC PDCP source code openair3 Middleware code mainly unused openair cn Core network protocols source code targets Specific code for executables may contains unsupported old build system Important In this document OPENAIR DIR is the path to the openair working directory may be trunk or rel_x y_dd mm yyyy 2 3 Additional software initial steps Some software installations have to be done prior to build the EURECOM EPC and the EURECOM HSS Page 11 of 32 In OPENAIR_DIR cmake_targets directory execute the following command user host
18. eactivation 5 9 1 PDN GW initiated bearer deactivation Not supported 5 9 2 MME initiated Dedicated Bearer Deactivation TBD Page 27 of 32 5 10 Intra E UTRAN handover Not supported yet Page 28 of 32 6 Annex A Tools for observing debugging 6 1 Itti_analyzer Itti_analyzer takes a dump of messages exchanges between the executable mme_gw or eNB UE tasks as input and display these messages in a human readable and comprehensible way This tool can take as input a file whose content is the XML dump of ITTI messages exchanged between tasks or can act as a server and listen on a socket that a openair executable connects and dump messages in pseudo real time Trace messages are also displayed with the tool but in a second view that means not interlaced with ITTI messages Important Prior to use itti_analyzer you have to instruct the openair executable to dump the ITTI messages to a file with the argument K path to file 6 1 1 Installation In OPENAIR_DIR common utils itti_analyzer directory execute the following command user host autoreconf i user host configure user host make user host sudo make install The itti_analyzer executable is now installed on the computer usr local bin 6 1 2 Execution In a shell execute the following command user host itti_analyzer The GUI displayed itti_analyzer e a Message COGE K gt Auto ip 127 0 0 1 port 10006 Terminal Filters M
19. eeseeeaeecseecsaecaecssecsseeseeeseeeseeeees 12 2 3 2 Phpmyadmin installation details srorornrnronnvnrenrvrrrrrvennrneenneneerressnrssennnnsersnserrrsennrssennesernn 12 30 EPC EE Le 14 3 1 MMEG Wasser 14 3 1 1 Fully Qualified Domain name 14 3 1 2 Configuration ile cvs cin ici Get steel Aten eines Leta te enact ees 14 3 2 MMB wine atstagetiavni tively cata ti elias ete tl is 15 3 3 A E EE EE Esc 15 3 4 MME configuration content iii A A AA AD 15 SAF GUMMET RE EE 15 SE SSC PPSECH OM E Hessa GSE 16 3 4 3 SLAP sections ini AA eee ea ea 16 S44 le EE 16 3 4 5 UNAS A A O aes isen 16 3 4 6 INTERTASK INTERFACE section 16 34 71 Network interfaces Se Ct Om idee EEN ebe 16 3 5 S GW configuration content nossa nni rni i a i a a ideea i 17 3 6 P GW configuration content 18 36 1 Main secre iia atada 18 3 6 2 Network interfaces Secon aonet teen ien anipse ta eA ER E ea NRR o EED 18 3 6 3 IP Address Pool section iii A T a wc te 18 3 7 FISS tirita lic E A 19 3 7 1 Fully Qualified Domain name 19 3 7 2 Configuration Mesias 19 34 3 HSS database e EE 22 A een re 25 4 1 MME GW EE 25 KO WEE Configuration alene eke niet santana 25 412 Building BRC 2 set eles heh a 25 413 Running EPC scission dies Gee nite ie ae aoe ee ee ene 25 5 supported scenarios IMEF Greina iii ee SEENEN 27 5 1 E UTRAN Initial attach TT 27 e Attach Wik IMSI A ee 27 5 2 Attach with GUT Li ASA 27 5 2 Tracking Area Update procedures
20. essages li MN LTETime Message From To Ins 1 Select filter types 2a Select dumped ITTI message file or 2b Wait for remote connection on specified IP port Figure 11 ITTI Analyzer main window Page 29 of 32 For filter selection please use filters_mme xml L yang openair4G trunk common utils itti analyzer Places Name a Size Modified O Recent common 31 03 2015 fi Home e libbuffers 31 03 2015 i Desktop libparser 31 03 2015 Documents libresolver 31 03 2015 ne libui 31 03 2015 y ownioads eg filters xml 9 2kB 31 03 2015 dd Musie B filters_mme xml 8 8kB 31 03 2015 E Pictures filters_ue_enb xml 12 8kB 31 03 2015 H videos lmcmake targets Devices Filters files v Cancel OK Figure 12 ITTI Analizer select filter menu You can also use options for fastest operations user host itti_analyzer h Usage itti_analyser options Options d DISSECT write DISSECT file with message types parse details f FILTERS read filters from FILTERS file h display this help and exit i IP set ip address to IP 1 LEVEL set log level to LEVEL in the range of 2 to 7 m MESSAGES read messages from MESSAGES file p PORT set port to PORT 6 2 Wireshark tshark You can launch wireshark instances on Sl filter slap gtpu S6A filter diameter 1f TCP is the undelying protocol you can select a TCP packet relative to the DIAMETER exchange and the select decode as DIAMETER 6 3 Mscgen Extract from http www mcternan me uk mscgen
21. ge 18 of 32 O 3 7 HSS 3 7 1 Fully Qualified Domain name A FQDN has to be set for the HSS An easy way to do that is to fill this FQDN in the etc hosts file Example yin yin cat etc hosts 127 0 0 1 localhost 1270 11 yin openair4G eur yin 3 7 2 Configuration files Here is partial view of the build process of HSS we can see there when and how configuration files are generated Inputs files and parameters are on the left part of the figure the build process is in the center part and output configuration files are on the right of the figure Build process OPENAIR_DIR cmake_targets tools build_hss Start OPENAIR_DIR cmake_targets hss_build build Makefile Cmake Makefile generation Se usr etc freeDiameter hss cakey pem OPENAIR_DIR cmake_targets hss_build CMakeLists txt OPENAIR_DIR cmake_targets usr etc freeDiameter hss cert pem tools check_hss_s6a_certificate TLS conf Refer to OPENAIR_DIR cmake_targets hss_build hss_fd conf in usr etc freeDiameter hss fd conf Cmake variable substitution S6a configuration section refer to OPENAIR_DIR targets bin hss conf End Figure 10 HSS configuration files generation Configuration file hss conf in This configuration file is the top configuration file containing all necessary parameters and links to other configuration files This file do not need to be edite
22. hpnyadatn with dbconflg common Figure 5 Phpmyadmin installation conf DB Enter here the root password of your host Page 12 of 32 Configuring phpmyadmin 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 Lo lt Cancel gt Figure 6 Phpmyadmin installation DB password Accordingly with the content of openair configuration files please enter here admin Configuring phpmyadmin 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 kok gt lt Cancel gt Figure 7 Phpmyadmin installation app password Configuring phpmyadmin Password confirmation kok gt lt Cancel gt Choose the web server that has to be configured Apache Configuring phpmyadmin Please choose the web server that should be automatically configured to run phpMyAdmin Web server to reconfigure automatically apache2 lighttpd lt Cancel gt Figure 8 Phpmyadmin installation web server selection Page 13 of 32 3 EPC Configuration 3 1 MME_GW 3 1 1 Fully Qualified Domain name A FQDN has to be set for the MME_GW An easy way to do that is to fill this FODN in the etc hosts file Example yang yang cat etc hosts 127 0 0 1 localhost 127 011 yang openair4G eur yang 192 168 12 1
23. irtual in the sense that S11 messages do not go through the network layer but through an inter task interface message passing middleware ITT eNB S1 U S1 C EPC mme gw executable GTP kernel module S6a s11 Figure 3 EPC Deployment in MME_GW SGi _______ INTERNET The EPC can be deployed on the same EURECOM eNB host or on its own host The HSS can be deployed on the same EPC host EURECOM eNB host or on its own host Any combination of deployment with one two or three host s is possible with the EURECOM eNB If a third party eNB is used then it is preferable to run the EPC and HSS on one or two other hosts indifferently Page 10 of 32 2 EPC Installation 2 1 Operating system The EPC software has only been tested on UBUNTU 14 04x64 and UBUNTU 14 10x64 LINUX distributions on Intel x86 64 bits platforms If you want to try another LINUX distribution it is mandatory to have a 64 bits LINUX distribution 2 2 EPC source code The OpenAirInterface software can be obtained from our svn server You will need an svn client to get the sources on Ubuntu Linux the client can be install using the command apt get install subversion The openair4G repository is currently used for main developments It can be accessed in read only mode from the URL http svn eurecom fr openair4G If you have full access to our SVN you should use the URL http svn eurecom fr openairsvn openair4G Depen
24. ist of maximum 65536 values MME group id range is 0 65535 TAI Array of TAI PLMN TAC List of maximum 32 TAI TAI MCC MNC TAC Table 2 MME configuration subsection GUMMEI Page 15 of 32 O 3 4 2 SCTP section Parameter SCTP_INSTREAMS Num Integer Num streams for UE association signaling note that stream with id 0 is reserved for non Ue associated signaling At least two streams should be used by the MME Default value 64 SCTP_OUTSTREAMS Num Integer Idem above Table 3 MME configuration subsection SCTP 3 4 3 SLAP section Parameter SIAP OUTCOME TIMER Num Integer Once an outcome is sent from MME to eNB the MME locally starts a timer to abort the procedure and release UE context if the expected answer to this outcome is not received at the expiry of this timer This timer is expressed in seconds Default value 5 seconds Table 4 MME configuration subsection SLAP 3 4 4 S6A section Parameter S6A CONF S6A config file path HSS HOSTNAME String HSS hostname Table 5 MME configuration subsection S6a 3 4 5 NAS section Parameter ORDERED SUPPORTED INTEGRITY ALGORITHM LIST Array of String Preference list in decreasing order of supported integrity algorithms actually supported integrity algorithms are EIAO EIA1 EJA2 ORDERED SUPPORTED CIPHERING ALGORITHM LIST Array of String Preference list in decreasing order of supported integr
25. ity algorithms actually supported integrity algorithms are EEAO EEA1 EEA2 Table 6 MME configuration subsection NAS 3 4 6 INTERTASK_INTERFACE section Parameter ITTIQUEUE_SIZE Num Integer Upper bound for the message queue size expressed in bytes all messages exchanged by tasks have the same size Restrict the number of messages in queues or detect a possible MME overload Table 7 MME configuration subsection ITTI 3 4 7 Network interfaces section Parameter MME_INTERFACE_NAME_FOR_S1_MME Interface name for S1 MME S1 C Page 16 of 32 O MME_IPV4_ADDRESS_FOR_S1_MME String CIDR Binded address for S1 MME MME INTERFACE NAME FOR SU MME String Interface name for S11 none if S11 unused MME IPV4 ADDRESS FOR S11 MME String CIDR Binded address for S11 0 0 0 0 xx if S11 unused Table 8 MME configuration subsection Network Interfaces 3 5 S GW configuration content Parameter Type SGW INTERFACE NAME FOR S11 String Interface name for S11 none if S11 unused SGW IPV4 ADDRESS FOR S11 String CIDR notation Binded address for S11 0 0 0 0 xx if S11 unused SGW INTERFACE NAME FOR SIU S12 S4 UP String Interface name for S1 U SGW IPV4 ADDRESS FOR SIU S12 S4 UP String CIDR notation Binded address for S1 U SGW IPV4 PORT FOR SIU S12 S4 UP Num Integer Port number for S1 U IANA Should be 2152 SGW INTERFACE NAME FOR Ss Sg UP String Interface name for S5 or S8 none because unused SGW_IPV
26. makes the network capture of S1 MME traffic easier Depending if EPC and EURECOM eNB run on the same host or not for convenience two different configuration files are provided one for each situation We recommend to follow the step described below unless you know what you are doing 4 1 MME_GW Your EURECOM MME_GW host and your EURECOM HSS host may be the same host 4 1 1 Configuration files Configuration files have to be filled prior to compilation If the MME_GW and the eNB run on the same host fill OPENAIR_DIR cmake_targets tools epc local enb conf in configuration file else fill OPENAIR_DIR cmake_targets tools epc conf in configuration file 4 1 2 Building EPC In a shell go to your openair root directory openair4G trunk or openair4G releases rel_xxxxx If MME_GW and the HSS run on the same host execute the following commands user host openair4G trunk cmake_targets S tools build epc debug s6a server transport tep only transport prefer tcp optional parameter clean user host openair4G trunk cmake_targets tools build_hss debug connect to mme yourmmefqdn transport tcp only transport prefer tcp optional parameters clean operator key 11111111111111111111111111111111 for example Else execute the following command On MME GW host user host openair4G trunk cmake_targets tools build_epc debug hss yourhssfgdn transport sctp only optional parameter clean On HSS host
27. mn pre_emp_capability TODO Column pre_emp_vulnerability TODO Column LIPA_Permissions TODO Table users Structure Field Type Null Key Default Extra imsi varchar 15 NO PRI NULL msisdn varchar 46 YES NULL imei varchar 15 YES NULL imei_sv varchar 2 YES NULL Page 23 of 32 ms_ps_status enum PURGED NOT_PURGED YES PURGED rau_tau_timer int 10 unsigned YES 120 ue_ambr_ul bigint 20 unsigned YES 50000000 ue_ambr_dl bigint 20 unsigned YES 100000000 access_restriction int 10 unsigned YES 60 mme_cap int 10 unsigned zerofill YES NULL mmeidentity_idmmeidentity At TL NO PRI 0 key varbinary 16 NO 0 RFSP Index smallint 5 unsigned NO 1 urrp_mme tinyint 1 NO 0 sqn bigint 20 unsigned zerofill NO NULL rand varbinary 16 NO NULL OPc varbinary 16 YES NULL TODO column description Page 24 of 32 Table 15 SQL Table structure users 4 Building and running The EURECOM EPC interact mainly with two other entities the eNB and the HSS Depending on the location of these entities on the same host or not the building and running options differ When EPC and HSS run on the same host TCP must be selected as the underlying protocol for DIAMETER on the S6a interface If EPC and HSS run on separate hosts SCTP can be selected as the underlying protocol for DIAMETER on the S6a interface Choosing SCTP instead of TCP
28. nero ner nn cnn cnnncnnnes 15 Table 2 MME configuration subsection OGUMMPI AAA 15 Table 3 MME configuration subsection SCT 16 Table 4 MME configuration subsection SA 16 Table 5 MME configuration subsection Spa 16 Table 6 MME configuration subsection NASA 16 Table 7 MME configuration subsection TITTEN 16 Table 8 MME configuration subsection Network Interfaces A 17 Table 9 S GW configuration main section 0 0 ee eeeeeseeeseeeseeceecssecssecsecsaeceseceseesseeseneeeneseaeeeaeeenaeenaes 17 Table 10 P GW configuration main Section ee eee eeseeereeeseeceecssecsecsecaeceseceseeeeeeseeseaeecaeeeaeeeaaeenaes 18 Table 11 P GW configuration subsection Network Interfaces AAA 18 Table 12 P GW configuration subsection IP Address Pool Selection ooooonnncnnncnnocinncnnocnnacnnncncnnncnnnos 18 Table 13 SQL Table structure mmeidentity eee ee eeeeseeseecseecsseceseceseceseceseceseesseeeseeeseeeeaeeeaeeeaaeenaes 22 Table 14 SQL Table struictutepdnt iic s3 2 steve ENEE ANEREN aaa tenes 23 Table 15 SOE Table structure USCIS coimas aia aa 24 Page 7 of 32 Abbreviations 3GPP APN CIDR eNB EPC EPS FQDN HSS IMEI IMEISV LTE MME MSISDN NW P GW PDN QoS SCTP S GW SIM TCP USIM Page 8 of 32 Third Generation Partnership Project Access Point Name Classless Inter Domain Routing e Node B Evolved Packet Core Evolved Packet System Fully qualified domain name Home Subscriber Server International Mobile St
29. on requires diameap conf LoadExtension app_diameap fdx diameap conf Page 21 of 32 Load the Accounting Server extension requires app_acct conf LoadExtension app_acct fdx app_acct conf The framework will actively attempt to establish and maintain a connection with the peers listed here For only accepting incoming connections see the acl_wl fx extension ConnectPeer ubuntu localdomain ConnectTo 127 0 0 1 No_TLS ConnectPeer MME_FODN ConnectTo MME_IP Realm REALM No_IPv6 No_TLS port 3870 Configuration file acl conf in TODO 3 7 3 HSS database content SQL operations display update export etc can be done easily with the help of phpMyAdmin you have to open the following URL with your browser http yourhsshost phpmyadmin Otherwise you can use any other MySQL tool script compatible with MySQL Table mmeidentity Structure Field Type Null Key Default Extra idmmeidentity intill NO PRI NULL auto increment mmehost varchar 255 YES NULL mmerealm varchar 200 YES NULL UE Reachability tinyint 1 NO NULL Table 13 SQL Table structure mmeidentity Column idmmeldentity is the primary key of a MME Column mmehost contains the FQDN of a MME Column mmerealm contains the realm of a MME Example of content idmmeidentity mmehost mmerealm UE Reachability
30. openair4G trunk cmake_targets tools build_epe i This command will update the software source list of your Ubuntu installation It will install miscellaneous software packages mainly an openair version patched of freeDiameter an openair version patched of asnlc and particularly mysql server and phpmyadmin software which steps are described below 2 3 1 Mysql server installation details Enter here the root password of your host Configuring mysql server 5 5 While not mandatory it is highly recommended that you set a password for the MySQL administrative root user If this field is left blank the password will not be changed New password for the MySQL root user Ok Figure 4 Mysql installation root password Configuring mysql server 5 5 Repeat password for the MySQL root user The mysql server installation process ends here 2 3 2 Phpmyadmin installation details You should prefer the easiest way The phpmyadnin package must have a database installed and configured before it can be used This can be optionally handled with dbconfig common If you are an advanced database administrator and know that you want to perform this configuration manually or if your database has already been installed and configured you should refuse this option Details on what needs to be done should most Likely be provided in usr share doc php yeadnin Otherwise you should probably choose this option Configure database for p
Download Pdf Manuals
Related Search