The script(s) implement(s) a ‘Network in a PC’ for its users and will allow routing calls outside the network.
NiPC contains the basic HLR/AuC and VLR/MSC functions of the 2G GSM network. The NiPC mode is a standard feature of all YateBTS installations, but its use is optional.
In the future, a YateBTS unit in NiPC mode may also be used as an HLR/Auc for YateBTS units in the same network.
Network in a PC (NiPC) Services
NiPC can route calls as follows:
NiPC handles SMSs as follows:
- COMP128v3 (commercial release only)
Web GUI for NiPC Management
The NiPC module is configured and managed via a Web GUI.
Depending on your YateBTS version, you can access the GUI, via HTTP, on two different ports.
1. If the machine is not in a secured network, it should be made accessible only from localhost by uncommenting the content of the .htaccess:
2. You may also connect to the web server using the following links:
The Web GUI has the following sections:
- List Subscribers
- each IMSI can be inserted individually or
- insert a regular expression to be used to match the subscribers IMSIs.
- the configured data will be written in subscribers.js file.
- Country code and SMSC — configure country code where YateBTS is located. You can also configure the SMSC number, which is used when writing SIMs. While the SMSC is not required in the NiPC mode, you will need to configure it when in Roaming mode.
- Online Subscribers — lists all the subscribers who are online.
- Rejected IMSIs — lists all the rejected subscribers.
- Manage SIMs — lists all the SIMs written using pySIM
Installation and configuration
Setting up the WebGUI
The YateBTS LabKit is delivered with an already installed WebGUI.
svn checkout http://voip.null.ro/svn/yatebts/trunk yatebts run ./autogen.sh run ./configure cd nipc make install
After installing, the sources of the WebGUI will be located in /usr/share/yate/nipc_web.
Depending on your operating system the main web directory will be /var/www (for older Debian based systems) or /var/www/html otherwise.
Note: If you don’t have this path, then you need to install Apache server.
cd /var/www/html (or cd /var/www on older Debian based OS) ln -s /usr/local/share/yate/nipc_web nipc
cd /usr/src svn co http://voip.null.ro/svn/yatebts/trunk/nipc/web nipc_web cd /var/www/html (or cd /var/www on Debian older based OS) ln -s /usr/src/nipc_web nipc
Before using the interface, the WebGUI must be given write right to Yate’s configuration directory.
The command that has to be run as root is:
chmod a+rw /etc/yate (If yatebts is installed from package.) or chmod a+rw /usr/local/etc/yate/ (If yatebts is installed from sources.)
Failing to configure the right permissions will make the interface display some errors the first time when it’s used.
If you still receive a message stating:
Error!! Don't have r/w permission on /usr/local/etc/yate/. Please run this command as root: 'chmod -R a+rw /usr/local/etc/yate/'
after running the chmod command, you probably have SELinux enabled. Disable it an try again.
Also check that Apache is configured to listen on port 80 for requests. The config file is located in /etc/httpd/conf/httpd.conf.
BTS Configuration Management
This screen allows you to set the basic parameters of the GSM radio interface. The parameters here are the same ones given in ybts.conf.
After modifying this parameters, Yate is automatically restarted.
This page allows you to:
Adding and listing subscribers
Subscribers are accepted either by matching the IMSI against a configured regular expression or by individually configuring each acceptable IMSI.
Subscribers can be inserted individually from the link Add subscriber.
Regular expressions can be inserted from the link Accept by REGEXP.
Click on “Accept by REGEXP” to add regular expressions.
They must be written without “/” at the beginning and end of the REGEXP.
Note: In the initial version the “/…/” were required.If you are unsure about how to set them check the example by pressing the question mark symbol ?
The “Modify” button will allow the editing of the existing regex and the button “Set subscribers” will display the form for adding Subscribers parameters.
This is the same form as if the “Add subscriber” link was chosen instead of “Accept by REGEXP”, as seen in the example below.
The form for adding a regular expression.
Use the “Add subscriber” or “Set subscribers” to insert subscribers individually.
By clicking on the question mark “?” each field in the form is described.
The fields marked with the asterisk “*” are required.
After clicking on the “Save” button, the subscriber will be saved in subscribers.conf from Yate’s configuration directory and the subscriber will appear in the Subscribers List as seen below.
Note: After Adding/Editing/Moving from REGEXP to individual subscribers/Moving to REGEXP from invidual subscribers Yate will be restarted.
Outgoing Call Route Management
This page allows you to specify a SIP or IAX connection for routing calls out of the local network to the rest of the world.
First, you need to select the protocol for the outbound connection from the drop-down list. This will generate the parameters that need to be configured. There are 2 types of parameters:
The “Save” button will save the configuration in accfile.conf. A typical example of setting up a SIP outbound connection will start with an outgoing form without any protocol selected.
Here is the SIP configuration page. After selecting the SIP protocol, the Basic parameters will be displayed:
The “Modify” button permits editing the parameters.
The parameters controlled here are the same ones described in Outbound_connection.
The “Switch to IAX” button deletes the old configuration and permits the new outbound connection to be set.