rename pkgconfig

Outlining basic requirements of each network element and interfaces and how to break up the network.

configure.ac

@@ -119,8 +119,8 @@ if test x$have_srclib == xyes; then
   AC_SUBST(OGSCRYPT_CFLAGS, '-I$(top_srcdir)/lib/ogslib/src')
   AC_SUBST(OGSCRYPT_LIBS, '$(top_srcdir)/lib/ogslib/src/crypt/libogscrypt-1.0.la')
 else
-  PKG_CHECK_MODULES(OGSCORE, ogscore-1.0 >= 1.0.0)
-  PKG_CHECK_MODULES(OGSCRYPT, ogscrypt-1.0 >= 1.0.0)
+  PKG_CHECK_MODULES(OGSCORE, ogscore-1.0 >= 1.1.0)
+  PKG_CHECK_MODULES(OGSCRYPT, ogscrypt-1.0 >= 1.1.0)
 fi
 AM_CONDITIONAL([WITH_SRCLIB], [test x$have_srclib = xyes])
 

debian/changelog

@@ -1,3 +1,40 @@
+nextepc (0.5.0) unstable; urgency=medium
+
+  * CSFB Supported
+  * OGSLib package name changed
+
+ -- Sukchan Lee <acetcom@gmail.com>  Thu, 11 Jul 2019 22:26:35 +0900
+
+nextepc (0.4.4~bionic) bionic; urgency=medium
+
+  * Bug Fixed
+
+ -- Sukchan Lee <acetcom@gmail.com>  Sun, 30 Jun 2019 13:23:15 +0000
+
+nextepc (0.4.4~xenial) xenial; urgency=medium
+
+  * Bug Fixed
+
+ -- Sukchan Lee <acetcom@gmail.com>  Sun, 30 Jun 2019 13:21:59 +0000
+
+nextepc (0.4.4) unstable; urgency=medium
+
+  * Bug Fixed
+
+ -- Sukchan Lee <acetcom@gmail.com>  Sun, 30 Jun 2019 12:05:12 +0000
+
+nextepc (0.4.3~xenial) xenial; urgency=medium
+
+  * Bug Fixed
+
+ -- Sukchan Lee <acetcom@gmail.com>  Sat, 22 Jun 2019 06:57:10 +0000
+
+nextepc (0.4.3~bionic) bionic; urgency=medium
+
+  * Bug Fixed
+
+ -- Sukchan Lee <acetcom@gmail.com>  Sat, 22 Jun 2019 06:55:56 +0000
+
 nextepc (0.4.3) unstable; urgency=medium
 
   * Bug Fixed

debian/control

@@ -12,7 +12,7 @@ Build-Depends: debhelper (>= 9),
                libtool,
                flex,
                bison,
-               ogslib-dev (>= 1.0.0),
+               libogslib-dev (>= 1.1.0),
                libgnutls28-dev,
                libgcrypt-dev,
                libssl-dev,

docker/build/Dockerfile

@@ -8,10 +8,10 @@ MAINTAINER Sukchan Lee <acetcom@gmail.com>
 WORKDIR /root
 COPY setup.sh /root
 
-ARG USER=acetcom
+ARG USER=open5gs
 ARG REPO=nextepc
 ARG BRANCH=master
-RUN	git clone https://github.com/$USER/$REPO
+RUN	git clone --recursive https://github.com/$USER/$REPO
 ADD https://api.github.com/repos/$USER/$REPO/git/refs/heads/$BRANCH /root/nextepc-ver.json
 
 RUN	cd nextepc && \

docs/_config.yml

@@ -21,7 +21,7 @@ description: >- # this means to ignore newlines until "baseurl:"
 baseurl: "/nextepc" # the subpath of your site, e.g. /blog
 url: "https://open5gs.org" # the base hostname & protocol for your site, e.g. http://example.com
 author: "Sukchan Lee"
-github_username: acetcom
+github_username: open5gs
 google_analytics: UA-139225646-2
 
 # Build settings

docs/_docs/guide/03-splitting-network-elements.md

@@ -0,0 +1,189 @@
+---
+title: NextEPC Splitting Network Elements
+head_inline: "<style> .blue { color: blue; } </style>"
+---
+
+In a production network network elements would typically not all be on the same machine, as is the default example that ships with NextEPC.
+
+NextEPC is designed to be standards compliant, so in theory you can connect any core network element (MME, PGW, SGW, PCRF, HSS) from NextEPC or any other vendor to form a functioning network, so long as they are 3GPP compliant. 
+
+To demonstrate this we will cover isolating each network element onto it's on machine and connect each network element to the other. For some interfaces specifying multiple interfaces is supported to allow connection to multiple
+
+In these examples we'll be connecting NextEPC elements together, but it could just as easily be EPC elements from a different vendor in the place of any NextEPC network element.
+
+| Service        | IP           | Identity |
+| ------------- |:-------------:|:-------------:|
+| P-GW | 10.0.1.121 | pgw.localdomain |
+| S-GW | 10.0.1.122 | |
+| PCRF | 10.0.1.123 | pcrf.localdomain |
+| MME | 10.0.1.124 | mme.localdomain |
+| HSS | 10.0.1.118 | hss.localdomain |
+
+
+# External P-GW
+In it's simplest from the P-GW has 3 interfaces:
+ * S5 - Connection to home network S-GW (GTP-C)
+ * Gx - Connection to PCRF (Diameter)
+ * Sgi - Connection to external network (Generally the Internet via standard TCP/IP)
+ 
+### S5 Interface Configuration
+Edit ```/etc/nextepc/pgw.conf```and change the address to IP of the server running the P-GW for the listener on GTP-C and GTP-U interfaces.
+
+```
+
+pgw:
+
+    freeDiameter: pgw.conf
+      
+    gtpc: 
+    
+      addr:
+      
+        - 10.0.1.121
+        
+     gtpu: 
+    
+      addr:
+      
+        - 10.0.1.121
+        
+ ```
+
+
+
+
+### Gx Interface Configuration
+Edit ```/etc/nextepc/freeDiameter/pgwd.conf```
+
+Update ```ListenOn``` address to IP of the server running the P-GW:
+
+``` ListenOn = "10.0.1.121"; ``` 
+
+Update ConnectPeer to connect to the PCRF on it's IP.
+
+```ConnectPeer = "pcrf.localdomain" { ConnectTo = "10.0.1.123"; No_TLS; };```
+
+
+### Restart Services
+Restart NextEPC PGW Daemon:
+
+``` $ sudo systemctl restart nextepc-pgwd ```
+
+
+# External S-GW
+In it's simplest form the S-GW has 2 interfaces:
+ * S11 - Connection to MME (GTP-C)
+ * S5 - Connection to the home network P-GW (GTP-C)
+
+### S5 Interface Configuration
+Edit ```/etc/nextepc/sgw.conf```and change the address to IP of the server running the S-GW for the listener on GTP-C interface.
+
+```
+sgw:
+
+    freeDiameter: pgw.conf
+      
+    gtpc: 
+    
+      addr:
+      
+        - 10.0.1.122
+        
+ ```
+ 
+ Restart NextEPC SGW Daemon:
+
+``` $ sudo systemctl restart nextepc-sgwd ```
+
+
+# External PCRF
+In it's simplest from the PCRF has 1 network interface:
+ * Gx - Connection to P-GW (Diameter)
+
+### Gx Interface Configuration
+Edit ```/etc/nextepc/freeDiameter/hss.conf```
+
+Update ```ListenOn``` address to IP of the server running the HSS on it's IP:
+
+``` ListenOn = "10.0.1.123"; ``` 
+
+Update ConnectPeer to connect to the MME.
+
+```ConnectPeer = "pgw.localdomain" { ConnectTo = "10.0.1.121"; No_TLS; };```
+
+### MongoDB Interface Configuration (NextEPC HSS only)
+Edit ```/etc/nextepc/freeDiameter/hss.conf``` and change the ```db_uri:``` to point at the HSS: ```db_uri: mongodb://10.0.1.118/nextepc``` 
+
+Restart NextEPC PCRF Daemon:
+
+``` $ sudo systemctl restart nextepc-pcrfd ```
+
+# External HSS
+In it's simplest form the HSS has 1 network interface:
+ * S6a - Connection to MME (Diameter)
+
+### S6a Interface Configuration
+Edit ```/etc/nextepc/freeDiameter/hss.conf```
+
+Update ```ListenOn``` address to IP of the server running the HSS on it's IP:
+
+``` ListenOn = "10.0.1.118"; ``` 
+
+Update ConnectPeer to connect to the MME.
+
+```ConnectPeer = "mme.localdomain" { ConnectTo = "10.0.1.124"; No_TLS; };```
+
+Restart NextEPC HSS Daemon:
+
+``` $ sudo systemctl restart nextepc-hssd ```
+
+### MongoDB Interface Configuration (NextEPC specific)
+If you are using NextEPC's HSS you may need to enable MongoDB access from the PCRF. This is done by editing ''/etc/mongodb.conf'' and changing the bind IP to:
+``` bind_ip = 0.0.0.0 ```
+
+Restart MongoDB for changes to take effect.
+
+``` $ /etc/init.d/mongodb restart ```
+
+# External MME
+In it's simplest form the MME has 3 interfaces:
+ * S1AP - Connections from eNodeBs
+ * S6a - Connection to HSS (Diameter)
+ * S11 - Connection to S-GW (GTP-C)
+ 
+### S11 Interface Configuration
+Edit ```/etc/nextepc/mme.conf```, filling the IP address of the S-GW and P-GW servers.
+```
+sgw:
+
+    gtpc:
+    
+      addr: 10.0.1.122
+
+
+pgw:
+
+    gtpc:
+    
+      addr:
+      
+        - 10.0.1.121
+```
+
+### S6a Interface Configuration
+Edit ```/etc/nextepc/freeDiameter/mme.conf```
+
+Update ```ListenOn``` address to IP of the server running the MME:
+
+``` ListenOn = "10.0.1.124"; ``` 
+
+Update ConnectPeer to connect to the PCRF on it's IP.
+
+```ConnectPeer = "hss.localdomain" { ConnectTo = "10.0.1.118"; No_TLS; };```
+
+
+### Restart Services
+Restart NextEPC MME Daemon:
+
+``` $ sudo systemctl restart nextepc-mmed ```
+ 

docs/_pages/docs.md

@@ -8,6 +8,7 @@ head_inline: "<style> ul { padding-bottom: 1em; } </style>"
 - User's Guide
   - [Quickstart](guide/01-quickstart)
   - [Building nextepc from Sources](guide/02-building-nextepc-from-sources)
+  - [Splitting Network Elements](guide/03-splitting-network-elements)
 
 - Tutorials
   - [Your First LTE](tutorial/01-your-first-lte)

docs/_posts/2019-05-28-release-v0.4.2.md

@@ -1,5 +1,5 @@
 ---
-title: "v0.4.2 - Stable version of v0.4.x"
+title: "v0.4.2 - Support a different APN for each PGW"
 date: 2019-05-28 21:13:00 +0900
 categories:
   - Release

docs/_posts/2019-06-22-release-v0.4.3.md

@@ -0,0 +1,21 @@
+---
+title: "v0.4.3 - Enable SCTP_NODELAY"
+date: 2019-06-22 16:42:00 +0900
+categories:
+  - Release
+tags:
+  - News
+  - Release
+head_inline: "<style> ul { padding-bottom: 1em; } </style>"
+---
+
+#### Enhancement
+- Adjust the size of memory pool for SGW buffering ([#190](https://github.com/open5gs/nextepc/issues/190)) -- [lezixiao](https://github.com/lezixiao)
+
+#### Bug fixes
+- Enable SCTP_NODELAY and Fix the assertion ([#198](https://github.com/open5gs/nextepc/issues/198)) -- [lezixiao](https://github.com/lezixiao)
+- Fix the assertion of handling a freeDiameter session ([#195](https://github.com/open5gs/nextepc/issues/195)) -- [lezixiao](https://github.com/lezixiao)
+- Fix PGW coredump when GTP-U packet cannot find BEARER by TEID ([#194](https://github.com/open5gs/nextepc/issues/194)) -- [lezixiao](https://github.com/lezixiao)
+
+Download -- [v0.4.3.tar.gz](https://github.com/open5gs/nextepc/archive/v0.4.3.tar.gz)
+{: .notice--info}

docs/_posts/2019-06-30-release-v0.4.4.md

@@ -0,0 +1,22 @@
+---
+title: "v0.4.4 - The Multiple Attachment for same IMSI"
+date: 2019-06-30 22:48:00 +0900
+categories:
+  - Release
+tags:
+  - News
+  - Release
+head_inline: "<style> ul { padding-bottom: 1em; } </style>"
+---
+
+#### Bug fixes
+- Move enb_ostream_id from mme_ue to enb_ue context ([#206](https://github.com/open5gs/nextepc/issues/206)) -- [lezixiao](https://github.com/lezixiao)
+- Fix the MME crash EMM status following Initial Context Setup Response ([#205](https://github.com/open5gs/nextepc/issues/205)) -- [lezixiao](https://github.com/lezixiao)
+- Fix the SGW crash for "Context Not Found" ([#204](https://github.com/open5gs/nextepc/issues/204)) -- [lezixiao](https://github.com/lezixiao)
+- Fix the Multiple Attachment for same IMSI ([#203](https://github.com/open5gs/nextepc/issues/203)) -- [lezixiao](https://github.com/lezixiao)
+- Add Handler of the Service Request and TAU Request in Security-mode state ([#202](https://github.com/open5gs/nextepc/issues/202)) -- [lezixiao](https://github.com/lezixiao)
+- Fix Service reject handler ([#201](https://github.com/open5gs/nextepc/issues/201)) -- [lezixiao](https://github.com/lezixiao)
+- Clear resources when SCTP-send failed ([#200](https://github.com/open5gs/nextepc/issues/200)) -- [lezixiao](https://github.com/lezixiao)
+
+Download -- [v0.4.4.tar.gz](https://github.com/open5gs/nextepc/archive/v0.4.4.tar.gz)
+{: .notice--info}

lib/asn1c/Makefile.am

@@ -1132,7 +1132,6 @@ libasn1c_la_SOURCES= \
     $(NULL)
 
 libasn1c_la_DEPENDENCIES = \
-	@OGSCORE_LIBS@ \
     $(top_srcdir)/lib/base/libbase.la \
 	$(NULL)
 

lib/base/Makefile.am

@@ -9,7 +9,6 @@ libbase_la_SOURCES = \
 	$(NULL)
 
 libbase_la_DEPENDENCIES = \
-	@OGSCORE_LIBS@ \
 	$(NULL)
 
 libbase_la_LIBADD = \

lib/base/types.c

@@ -97,7 +97,7 @@ int fqdn_parse(char *dst, char *src, int length)
             dst[j++] = '.';
         else
             dst[j] = 0;
-    } while(i < length);
+    } while (i < length);
 
     return j;
 }

lib/base/types.h

@@ -60,6 +60,7 @@ extern "C" {
 #define MAX_APN_LEN                 100
 #define MAX_PCO_LEN                 251
 #define MAX_FILEPATH_LEN            256
+#define MAX_FQDN_LEN                256
 
 #define NEXT_ID(__id, __min, __max) \
     ((__id) = ((__id) == (__max) ? (__min) : ((__id) + 1)))

lib/fd/Makefile.am

@@ -32,7 +32,6 @@ libfd_la_SOURCES = \
 	$(NULL)
 
 libfd_la_DEPENDENCIES = \
-	@OGSCORE_LIBS@ \
     $(top_srcdir)/lib/@FREEDIAMETER_DIR@/libfdcore/libfdcore.la \
     $(top_srcdir)/lib/@FREEDIAMETER_DIR@/libfdproto/libfdproto.la \
     $(top_srcdir)/lib/base/libbase.la \

lib/freeDiameter-1.2.1/libfdcore/sctp.c

@@ -48,7 +48,8 @@
 /* #define OLD_SCTP_SOCKET_API */
 
 /* Automatically fallback to old API if some of the new symbols are not defined */
-#if (!defined(SCTP_CONNECTX_4_ARGS) || (!defined(SCTP_RECVRCVINFO)) || (!defined(SCTP_SNDINFO))) 
+#if (!defined(SCTP_CONNECTX_4_ARGS) || (!defined(SCTP_RECVRCVINFO)) || (!defined(SCTP_SNDINFO)) || \
+    (!defined(SCTP_SEND_FAILED_EVENT)) || (!defined(SCTP_NOTIFICATIONS_STOPPED_EVENT)) )
 # define OLD_SCTP_SOCKET_API
 #endif
 

lib/gtp/Makefile.am

@@ -25,7 +25,6 @@ libgtp_la_SOURCES = \
 	$(NULL)
 
 libgtp_la_DEPENDENCIES = \
-	@OGSCORE_LIBS@ \
     $(top_srcdir)/lib/base/libbase.la \
 	$(NULL)
 

lib/gtp/gtp-message.c

@@ -20,7 +20,7 @@
 /*******************************************************************************
  * This file had been created by gtp-tlv.py script v0.1.0
  * Please do not modify this file but regenerate it via script.
- * Created on: 2019-06-11 17:35:40.953361 by acetcom
+ * Created on: 2019-07-06 22:50:27.017552 by acetcom
  * from 29274-d80.docx
  ******************************************************************************/
 

lib/gtp/gtp-message.h

@@ -20,7 +20,7 @@
 /*******************************************************************************
  * This file had been created by gtp-tlv.py script v0.1.0
  * Please do not modify this file but regenerate it via script.
- * Created on: 2019-06-11 17:35:40.936758 by acetcom
+ * Created on: 2019-07-06 22:50:27.011335 by acetcom
  * from 29274-d80.docx
  ******************************************************************************/
 

lib/gtp/support/gtp-tlv.py

@@ -161,7 +161,7 @@ else:
     d_error("Cannot find file : " + filename)
 
 d_info("[Message List]")
-cachefile = cachedir + 'tlv_msg_list.py'
+cachefile = cachedir + 'tlv-msg-list.py'
 if os.path.isfile(cachefile) and os.access(cachefile, os.R_OK):
     execfile(cachefile)
     print "Read from " + cachefile
@@ -238,7 +238,7 @@ else:
 type_list['MM Context'] = { "type": "107", "max_instance" : "0" }
 
 d_info("[Group IE List]")
-cachefile = cachedir + 'tlv_group_list.py'
+cachefile = cachedir + 'tlv-group-list.py'
 if os.path.isfile(cachefile) and os.access(cachefile, os.R_OK):
     execfile(cachefile)
     print "Read from " + cachefile
@@ -334,7 +334,7 @@ msg_list["Modify Access Bearers Response"]["table"] = 87
 for key in msg_list.keys():
     if "table" in msg_list[key].keys():
         d_info("[" + key + "]")
-        cachefile = cachedir + "tlv_msg_" + msg_list[key]["type"] + ".py"
+        cachefile = cachedir + "tlv-msg-" + msg_list[key]["type"] + ".py"
         if os.path.isfile(cachefile) and os.access(cachefile, os.R_OK):
             execfile(cachefile)
             print "Read from " + cachefile

lib/nas/Makefile.am

@@ -23,7 +23,6 @@ libnas_la_SOURCES = \
 	$(NULL)
 
 libnas_la_DEPENDENCIES = \
-	@OGSCORE_LIBS@ \
     $(top_srcdir)/lib/base/libbase.la \
 	$(NULL)
 

lib/nas/nas-decoder.c

@@ -20,7 +20,7 @@
 /*******************************************************************************
  * This file had been created by nas-message.py script v0.1.0
  * Please do not modify this file but regenerate it via script.
- * Created on: 2019-06-21 14:10:51.931135 by acetcom
+ * Created on: 2019-07-06 22:48:01.560467 by acetcom
  * from 24301-d80.docx
  ******************************************************************************/
 

lib/nas/nas-encoder.c

@@ -20,7 +20,7 @@
 /*******************************************************************************
  * This file had been created by nas-message.py script v0.1.0
  * Please do not modify this file but regenerate it via script.
- * Created on: 2019-06-21 14:10:51.957409 by acetcom
+ * Created on: 2019-07-06 22:48:01.570057 by acetcom
  * from 24301-d80.docx
  ******************************************************************************/
 

lib/nas/nas-ies.c

@@ -20,7 +20,7 @@
 /*******************************************************************************
  * This file had been created by nas-message.py script v0.1.0
  * Please do not modify this file but regenerate it via script.
- * Created on: 2019-06-21 14:10:51.889878 by acetcom
+ * Created on: 2019-07-06 22:48:01.547045 by acetcom
  * from 24301-d80.docx
  ******************************************************************************/
 
@@ -214,8 +214,6 @@ int nas_decode_mobile_identity(nas_mobile_identity_t *mobile_identity, ogs_pkbuf
 
     if (mobile_identity->tmsi.type == NAS_MOBILE_IDENTITY_TMSI)
     {
-        if (mobile_identity->tmsi.spare != 0xf)
-            ogs_warn("Spec warning : mobile_identity->tmsi.spare = 0x%x", mobile_identity->tmsi.spare);
         mobile_identity->tmsi.tmsi = ntohl(mobile_identity->tmsi.tmsi);
     }
 
@@ -507,8 +505,6 @@ int nas_decode_eps_mobile_identity(nas_eps_mobile_identity_t *eps_mobile_identit
 
     if (eps_mobile_identity->guti.type == NAS_EPS_MOBILE_IDENTITY_GUTI)
     {
-        if (eps_mobile_identity->guti.spare != 0xf)
-            ogs_warn("Spec warning : eps_mobile_identy->spare = 0x%x", eps_mobile_identity->guti.spare);
         eps_mobile_identity->guti.mme_gid = ntohs(eps_mobile_identity->guti.mme_gid);
         eps_mobile_identity->guti.m_tmsi = ntohl(eps_mobile_identity->guti.m_tmsi);
     }

lib/nas/nas-ies.h

@@ -20,7 +20,7 @@
 /*******************************************************************************
  * This file had been created by nas-message.py script v0.1.0
  * Please do not modify this file but regenerate it via script.
- * Created on: 2019-06-21 14:10:51.884139 by acetcom
+ * Created on: 2019-07-06 22:48:01.544954 by acetcom
  * from 24301-d80.docx
  ******************************************************************************/
 

lib/nas/nas-message.h

@@ -20,7 +20,7 @@
 /*******************************************************************************
  * This file had been created by nas-message.py script v0.1.0
  * Please do not modify this file but regenerate it via script.
- * Created on: 2019-06-21 14:10:51.908774 by acetcom
+ * Created on: 2019-07-06 22:48:01.552798 by acetcom
  * from 24301-d80.docx
  ******************************************************************************/
 

lib/nas/nas-types.h

@@ -377,6 +377,7 @@ ED3(uint8_t cn_specific_drx_cycle_length_coefficient_and_drx_value_for_s1_mode:4
  * A.1 Causes related to UE identification */
 #define EMM_CAUSE_IMSI_UNKNOWN_IN_HSS 2
 #define EMM_CAUSE_ILLEGAL_UE 3
+#define EMM_CAUSE_IMSI_UNKNOWN_IN_VLR 4
 #define EMM_CAUSE_ILLEGAL_ME 6
 #define EMM_CAUSE_UE_IDENTITY_CANNOT_BE_DERIVED_BY_THE_NETWORK 9
 #define EMM_CAUSE_IMPLICITLY_DETACHED 10
@@ -728,9 +729,9 @@ ED4(uint8_t type:4;,
  * M V 1/2 
  * 9.9.3.21 NAS key set identifier 
  * M V 1/2 */
-#define NAS_SERVICE_TYPE_CS_FALLBACK_OR_1XCS_FALLBACK_FROM_UE 0
-#define NAS_SERVICE_TYPE_CS_FALLBACK_OR_1XCS_FALLBACK_TO_UE 1
-#define NAS_SERVICE_TYPE_CS_FALLBACK_EMERGENCY_CALL_OR_1XCS_FALLBACK_EMERGENCY_CALL_FROM_UE 2
+#define NAS_SERVICE_TYPE_CS_FALLBACK_FROM_UE 0
+#define NAS_SERVICE_TYPE_CS_FALLBACK_TO_UE 1
+#define NAS_SERVICE_TYPE_CS_FALLBACK_EMERGENCY_CALL_FROM_UE 2
 typedef struct nas_service_type_s {
 ED3(uint8_t tsc:1;,
     uint8_t nas_key_set_identifier:3;,