2N® SIM Star

User Manual

Version: 14.0 www.2n.cz

The 2N TELEKOMUNIKACE a.s. is a Czech manufacturer and supplier of
telecommunications equipment.

The product family developed by 2N TELEKOMUNIKACE a.s. includes GSM gateways,

private branch exchanges (PBX), and door and lift communicators. 2N
TELEKOMUNIKACE a.s. has been ranked among the Czech top companies for years
and represented a symbol of stability and prosperity on the telecommunications
market for almost two decades. At present, we export our products into over 120
countries worldwide and have exclusive distributors on all continents.

2N ® is a registered trademark of 2N TELEKOMUNIKACE a.s. Any product and/or other

names mentioned herein are registered trademarks and/or trademarks or brands
protected by law.

2N TELEKOMUNIKACE a.s. administers the FAQ database to help you quickly find
information and to answer your questions about 2N products and services. On www.
faq.2n.cz you can find information regarding products adjustment and instructions for
optimum use and procedures „What to do if...".

2N TELEKOMUNIKACE a.s. hereby declares that the 2N ® product complies with all
basic requirements and other relevant provisions of the 1999/5/EC directive. For the
full wording of the Declaration of Conformity see the CD-ROM (if enclosed) or our
website at www.2n.cz.

The 2N TELEKOMUNIKACE a.s. is the holder of the ISO 9001:2009 certificate. All
development, production and distribution processes of the company are managed by
this standard and guarantee a high quality, technical level and professional aspect of
all our products.
Content:

1. Product Overview
1.1 Overview
1.2 Components and Associated Products
1.3 Upgrade and Innovations
1.4 New Features in Latest Version
1.5 Terms and Symbols Used
2. Description and Installation
2.1 System Component Description
2.2 Before You Start
2.3 System Component Installation
3. Configuration
3.1 Web Interface
3.2 Step-by-Step Basic Configuration
3.3 Management
3.4 Gateways Menu
3.5 GSM Groups Menu
3.6 GSM Menu
3.7 SIM Boards Menu
3.8 SIM Groups Menu
3.9 SIM Menu
3.10 IMEI Menu
3.11 Rules Menu

2N TELEKOMUNIKACE a.s., www.2n.cz 3/147

 4. Function and Use
4.1 SIM Card to GSM Module Assignment
4.2 Hot Swap
4.3 How to Link Module IMEI and SIM Card IMSI
4.4 Prepaid SIM Card Credit Recharge
4.5 Human Behaviour Functionality
4.6 External API - SSS Uniclient Protocol
4.7 Tray SW
4.8 External Credit Check/Recharge Script
5. Technical Parameters
6. Supplementary Information
6.1 Mikrotik RB750 Default Configuration
6.2 Troubleshooting
6.3 List of Abbreviations
6.4 Regulations and Directives
6.5 General Instructions and Cautions

2N TELEKOMUNIKACE a.s., www.2n.cz 4/147

1. Product Overview

This section introduces the 2N ® SIM Star product, outlines its application options and
highlights the advantages following from its use. It also includes safety precautions.

Here is what you can find in this section:

1.1 Overview
1.2 Components and Associated Products
1.3 Upgrade and Innovations
1.4 New Features in Latest Version
1.5 Terms and Symbols Used

2N TELEKOMUNIKACE a.s., www.2n.cz 5/147

1.1 Overview
The 2N ® SIM Star system is used for remote administration of the 2N GSM/UMTS
gateway SIM cards. This solution helps you switch SIM cards in all of your gateways
regardless of their locations comfortably from your office without travelling. It is
because your distant 2N GSM/UMTS gateways do not contain SIM cards. Their SIM
cards are installed on one site, thus avoiding potential misuse.

2N ® SIM Star Features

Financial and time cost efficiency due to elimination of physical exchange and
credit recharge for your gateway SIM cards
Comfortable full SIM card control from your office
Central SIM card administration and location
SIM card misuse risk minimisation
Easy SIM card availability
Easy web interface based configuration
Up to 25,000 SIM card control
Human behaviour functionality (see chapter 4.5)
Possibility to use Domain name instead of IP addresses (less fixed IP addresses)
Possibility to use API for adding new functionality by using 3rd party
applications (see Subs. 4.6)

2N ® SIM Star is primarily designed for:

SIM card and voice channel leasing companies
Network providers and alternative operators
Multiple GSM gateway (SIM card) administering companies

Safety Precautions
It is prohibited to use any transmitters, including the UMTS/GSM devices connected to

2N ® SIM Star, in areas where explosives are used, such as quarries.

It is prohibited to use the GSM gateways connected to 2N ® SIM Star at petrol stations
where mobile telephones are also prohibited.

2N TELEKOMUNIKACE a.s., www.2n.cz 6/147

GSM phones may affect sensitive life-saving devices in medical centres. Therefore, it is

forbidden to use GSM/UMTS devices, including the GSM gateways connected to 2N ®

SIM Star, in such facilities.

In general, any prohibition regarding mobile phones based on RF energy radiation

applies to GSM/UMTS devices too.

If necessary, the GSM gateways connected to 2N ® SIM Star may be installed at a safe
distance from the prohibited area and connected with the original place through an
Ethernet cable.

Although GSM gateways are not intended for cars or aeroplanes, all relevant
prohibitions and regulations regarding mobile phones apply to them too.

Use Studies

The figure below shows the basic components of the 2N ® SIM Star system and

indicates the independence of their installation sites. The solution includes a 2N ® SIM
Star Server unit, a SIM Board Box with one SIM Board at least and compatible GSM
/UMTS gateways.

Such gateways include 2N ® StarGate, 2N ® BlueStar, 2N ® BlueTower and 2N ®

VoiceBlue Lite.

Human Behaviour Functionality

2N TELEKOMUNIKACE a.s., www.2n.cz 7/147
Human Behaviour Functionality
The SIM Star system includes a lot of functions that can be configured in detail. These
functions endow the system SIM cards with a behaviour that is close to that of a
common mobile phone user.

SIM travelling based on IMEI change, permanent/dynamic BTS lock and SIM login
to gateways in various locations.
Call limit functions based on watching the upper limits of called minutes and/or
calls in defined intervals (mornings, afternoons, evenings, workdays, and
weekends).
Outgoing SMS limits in defined intervals.
SIM credit monitoring and automatic recharging (USSD, SMS, IVR, and Call).
Peak/off-peak low credit control. Automatic activation of a new SIM card and
repeated activation on defined days or after defined actions (SIM recharge, e.g.).
Minimum (random) relax time between two calls.
Check of presence of alerting in outgoing calls.
Reading of called free minutes according to the terminal network (own network,
another network, PSTN, VPN).
Automatic SIM card blocking in the system (failed calls, SMS, logins...).
Simulated SMS and/or Call [1] sending/receiving.
SIM card recharge/activation disable options for selected modules.
Temporary/Permanent automatic barring (Black list) of calls to numbers as
defined in the user rules (unanswered, call length call, etc.) [2]
Enhanced SIM travelling – SIM IDLE time according to real distance between
gateways (GPS position, up to three SIM card's moving speeds)

[1] Enhanced CPU feature

[2] External Routing Machine (ERM) feature

2N TELEKOMUNIKACE a.s., www.2n.cz 8/147

LAN Configuration
The installation version shown in the figure below concentrates all the solution
components in a single LAN. Investigating the figure more closely, you will find the
communication signalling flows between the system components. The communication
path between 2N® SIM Star Server, the SIM Board and the GSM gateway (via the CPU
card) is marked green. The communication path between 2N® SIM Star Server and the
SIM Client (i.e. a process running in the GSM gateway through the eCPU) is marked
red. The communication channel between the SIM card and the gateway GSM module
is violet. This solution represents the simplest version. Practically, however, the
components are installed in more distant locations.

WAN Configuration
The solution in the figure below shows a configuration within an extensive WAN. The
Internet is a good example. Together with the SIM Board, 2N® SIM Star Server is
located in one LAN behind a router with the public IP address 1. Another LAN is in
another location, including two GSM gateways supporting the 2N® SIM Star solution.
The LAN router has the public IP address 2. A GSM gateway with the public IP address
3 is in another location. The two routers and the GSM gateway are connected to the
Internet. The figure shows the communication channels between the components. This
configuration requires a correct setting of the router and 2N® SIM Star Server for
successful communication. Within the Internet, communication is routed to the public
IP addresses and selected ports that are adapted to the corresponding IP addresses
and component ports in the LAN.

Remember to set the NAT tables for the IP Routers if used.

2N TELEKOMUNIKACE a.s., www.2n.cz 9/147
Remember to set the NAT tables for the IP Routers if used.

IP Router before GSM Gateway

IP port Service name Description

23 Telnet SSS access to Basic CPU (Control)

80 http SSS access to eCPU (Update)

1500 Telnet SSS Access to eCPU (SC control)

2222 Telnet SSS Access to Basic CPU (Update)

IP Router before SIM Board

IP port Service name Description

1500 Telnet SSS access to SB (Control)

10000–100031 Proprietary Stream of SIM cards

IP Router before SIM Star Server

IP port Service name Description

22 SSH
Access for 2N ® Technical Support if necessary
80/443 http/http Access to SSS web interface

12346 Telnet LOG stream

12349 Proprietary IMSI distribution for Call/SMS Simulator

12350 Telnet API of SSS (Subject to licence)

2N TELEKOMUNIKACE a.s., www.2n.cz 10/147

 Tip

The communication protocol responsible for SIM card transfer contains

QoS information. Refer to the GSMs / View / Qos of SIM connection
menu for current data.

2N TELEKOMUNIKACE a.s., www.2n.cz 11/147

1.2 Components and Associated Products
The solution consists of the following five components: 2N ® SIM Star Server, SIM
Board Box, SIM Board, SIM Star GSM/UMTS Board a SIM Client.

2N ® SIM Star SIM Board

The SIM Board is a card designed for mounting in a SIM Board Box. Each of these
cards is capable of accepting up to 32 SIM cards.

2N ® SIM Star SIM Board Box

The SIM Board Box is a chassis that contains the SIM Boards. Communication with 2N ®
SIM Star Server is ensured via a two-port Ethernet interface.

2N ® SIM Star SIM Client

The SIM Client transfers the information obtained from the 2N ® SIM Star GSM/UMTS
cards onto an Ethernet interface towards 2N ® SIM Star Server. The SIM Client is part
of the eCPU in the 2N® StarGate, 2N® BlueStar and 2N® BlueTower gateways and part

of the gateway in 2N® VoiceBlue Lite.

2N ® SIM Star GSM/UMTS Board

The 2N ® SIM Star GSM/UMTS Board is a card designed for 2N ® PRI and VoIP
gateways. It replaces the existing GSM/UMTS boards in the gateways. This new
solution provides interconnection with the SIM Client.

2N TELEKOMUNIKACE a.s., www.2n.cz 12/147

2N ® SIM Star Server

2N ® SIM Star Server is the core of the system. It communicates with all the key
components and, as preconfigured, assigns SIM cards to the respective GSM gateway
channels.

Note

For more information on the 2N ® SIM Star components refer to S. 2 –

Description and Installation

Associated Products

2N ® StarGate

2N ® StarGate is the biggest of the 2N® PRI GSM gateway family, enabling you to
make up to 30 calls at the same time. In addition to ISDN PRI communication, the

gateway also supports VoIP with SIP signalling. To use it within the 2N ® SIM Star
solution, use the enhanced CPU (eCPU) and make sure that the eCPU licence is valid.
For detailed information on this product refer to the User Manual available on the 2N
web sites.

2N TELEKOMUNIKACE a.s., www.2n.cz 13/147

2N ® BlueTower

2N ® BlueTower is the smallest of the 2N® PRI GSM gateway family, enabling you to
make up to 8 calls at the same time. In addition to ISDN PRI communication, the

gateway also supports VoIP with SIP signalling. To use it within the 2N ® SIM Star
solution, use the enhanced CPU (eCPU) and make sure that the eCPU licence is valid.
For detailed information on this product refer to the User Manual available on the 2N
web sites.

2N TELEKOMUNIKACE a.s., www.2n.cz 14/147

2N ® VoiceBlue Lite

2N ® VoiceBlue Lite is a member of the small VoIP GSM gateway family, enabling you
to make up to 4 calls at the same time. The gateway supports SIP signalling. To use it

within the 2N® SIM Star solution, purchase a gateway with a special part number,
which supports the 2N® SIM Star Server communication.

2N ® VoiceBlue Next

2N ® VoiceBlue Next is a member of the small VoIP GSM gateway family, enabling you
to make up to 2/4 calls at the same time. The gateway supports SIP signalling. To use

® SIM Star solution, purchase a gateway with a special part number,

it within the 2N

which supports the 2N® SIM Star Server communication.

2N TELEKOMUNIKACE a.s., www.2n.cz 15/147

2N ® VoiceBlue MAX

2N ® VoiceBlue MAX is an analogue VoIP gateway, enabling you to make up to 4 calls

at the same time. The gateway supports SIP signalling and provides 4 FXS ports for

PBX or phone connection. To use it within the 2N ® SIM Star solution, purchase a
gateway with a special part number, which supports the 2N® SIM Star Server
communication.

Note

For more information on the GSM gateways refer to their respective

manuals available on the 2N web sites.

2N TELEKOMUNIKACE a.s., www.2n.cz 16/147

1.3 Upgrade and Innovations
The manufacturer reserves the right to modify the product in order to improve its
qualities.

In response to the customers' requirements, the manufacturer constantly improves the

software contained in the product (firmware). For the latest 2N ® SIM Star Server
firmware version and the User Manual refer to the 2N web sites.

For a detailed description of the 2N ® SIM Star firmware upgrade see the section
devoted to the system installation.

Manual Upgrade
Version

3.0
The User Manual relates to the 2N ® SIM Star Server firmware version 1.3.12–2616.
4.0
The User Manual relates to the 2N ® SIM Star Server firmware version 1.4.0
5.0
The User Manual relates to the 2N ® SIM Star Server firmware version 1.4.6
rev2707

6.0
The User Manual relates to the 2N ® SIM Star Server firmware version 1.4.7
rev2720

7.0 Added Mikrotik RB750 default configuration

1.9.0
The User Manual relates to the 2N ® SIM Star Server firmware version 1.9.0
8.0
The User Manual relates to the 2N ® SIM Star Server firmware version 1.16.0
9.0
The User Manual relates to the 2N ® SIM Star Server firmware version 1.18.1
10.0
The User Manual relates to the 2N ® SIM Star Server firmware version 1.19.0

2N TELEKOMUNIKACE a.s., www.2n.cz 17/147

11.0
The User Manual relates to the 2N ® SIM Star Server firmware version 1.22.0
12.0
The User Manual relates to the 2N ® SIM Star Server firmware version 1.24.0
13.0
The User Manual relates to the 2N ® SIM Star Server firmware version 1.25.0
14.0
The User Manual relates to the 2N ® SIM Star Server firmware version 1.26.1

2N TELEKOMUNIKACE a.s., www.2n.cz 18/147

What's New in v 1.25.0 (Compare to 1.9.0)
Call simulation on external numbers from an uploaded list (see 3.8)
Custom SMS texts for simulation (see 3.8)
SMS recharging/credit check (see 3.8)
Outgoing traffic delay (see 3.8)
SDR downloading from gateways (see 3.3)
Automatic IMEI assignment via SIM/IMEI group (see 3.6)

2N ® VoiceBlue MAX support (see 3.1)

Centralised SIM Star Server SMS simulator (see 3.8)
Combination of call / SMS simulation between SIM and external recipients (see
3.8)
Automatic gateway settings according to gateway type (see 3.1 )
SIM blocking according to ASR and ACD parameters (see 3.8)
SIM blocking according to "failed calls retries", "short calls retries" (see 3.8)
Added substring for successful USSD activation answer (see 3.8)
Possibility to ignore failed activation (see 3.8)
Addition of distributed SIM recharging (see 3.8)
SIM card recharging by call (see 3.8)
Modified GSM channel information (see 3.6)
Addition of traffic control for each GSM module (see 3.6)
Possibility to keep logged for recharging (see 3.8)
Clear calling time now support (see 3.9)
Autolicence for GSM/UMTS gateways (see 3.3 )
SMS phone number detection (see 3.8 )
Possibility to use local SIM card (see 3.6 )
Modified Lookup info (see 3.6 )

2N TELEKOMUNIKACE a.s., www.2n.cz 19/147

1.5 Terms and Symbols Used
Symbols Used in Manual
The following symbols and pictograms are used in the manual:

Safety

Always abide by this information to prevent persons from injury.

Warning

Always abide by this information to prevent damage to the device.

Caution

Important information for system functionality.

Tip

Useful information for quick and efficient functionality.

Note

Routines or advice for efficient use of the device.

Future Functions
The grey-marked text in this document designates the functions that are under
preparation or development at present.

2N TELEKOMUNIKACE a.s., www.2n.cz 20/147

2. Description and Installation

This section describes the 2N ® SIM Star product and its installation.
Here is what you can find in this section:

2.1 System Component Description

2.2 Before You Start
2.3 System Component Installation

2N TELEKOMUNIKACE a.s., www.2n.cz 21/147

2.1 System Component Description
2N ® SIM Star SIM Board
The SIM Board represents the main board for inserting SIM cards. Each SIM Board can
accept up to 32 SIM cards. The card processor transfers the data obtained from the
SIM cards onto an Ethernet interface. The SIM cards are used for communication via
the IP ports ranging from 10000 to 10031 depending on their positions (can be

reconfigured). IP port 1500 is used for the 2N ® SIM Star Server communication. SSH
port 22 provides direct access to the SIM Board. It is very important that all the ports

are available to all the SIM Clients involved and 2N ® SIM Star Server. Otherwise the
system would be unstable or inoperative. The SIM Board is equipped with a CAN9-
terminated serial interface, which is used for the basic board IP settings. The card
supports the 'hot swap' function and can thus be removed and replaced if necessary
without the SIM Board Box switch-off.

2N TELEKOMUNIKACE a.s., www.2n.cz 22/147

Front Panel
The front panel includes three status LED indicators and a SIM Board default (factory)
setting button.

To restore the factory settings:

1. Remove the SIM Board.

2. Push the front panel button gently using a slim and blunt object.

3. Keeping the button pushed replace the SIM Board into the switched-on SIM
Board Box.

4. Keep pushing the button for at least 20 seconds and then remove and replace
the Board.

SIM Board status indicators:

PWR – Indicates the SIM Board power supply.

INIT – Indicates the SIM Board initialisation. No light indicates a running SIM
Board process.
STAT – Flashing indicates a running system.

Caution

SIM board 2012 has different HW layout! There is no SD card requied and
it's needs different firmware (included on latest SIM Star server) !

2N ® SIM Star SIM Board Box

The SIM Board Box is a chassis that contains the SIM Boards. Each SIM Board Box can
accept 1 to 18 SIM Boards with the maximum of 576 SIM cards. A front panel with two

RJ-45 ports is available for communication with 2N ® SIM Star Server. The SIM Board
Box works as an Ethernet switch and the cards are connected to it through a 10BaseT
Ethernet interface. The two front panel ports help scale the SIM Board Boxes more
easily. Each SIM Board has a unique IP address within the SIM Board Box.

2N TELEKOMUNIKACE a.s., www.2n.cz 23/147

2N ® SIM Star SIM Client
The SIM Client transfers information obtained from the GSM/UMTS cards onto an

Ethernet interface towards 2N® SIM Star Server and vice versa. The SIM Client is an
independent process running on the eCPU in the 2N® StarGate, 2N® BlueStar and 2N®

BlueTower gateways and part of the 2N® VoiceBlue Lite gateway available under a
special part number.

SIM Client in eCPU

The enhanced CPU (eCPU) card is an independent processor board for the 2N ®
StarGate / BlueStar / BlueTower gateways, extending the capabilities of the basic
CPU. Its main advantages include a web configuration interface, SMS server, simulated
calls and SMS messages as well as the SIM Client process, providing communication

with the other 2N ® SIM Star components. The SIM Client – 2N ® SIM Star Server
communication runs through port 1500. The SIM Client communication with the GSM
gateway cards runs on the gateway main bus using the RS485 protocol. It is necessary
for a successful eCPU – CPU communication that the IP addresses of the two
interfaces are properly set and the interfaces are connected to the network. The
modules communicate with the SIM Board SIM cards via ports 10000 to 10031,
according to their positions in the gateway.

Note

For more information refer to the 2N ® StarGate / BlueStar / BlueTower

User Manual available on the 2N web sites.

2N TELEKOMUNIKACE a.s., www.2n.cz 24/147

Integrated SIM Client

The SIM Client is an integral part of the 2N ® StarGate / BlueTower (latetst CPU 2013 –
SN begins with M202-xxx) and 2N ® VoiceBlue Lite / Next / MAX gateway. Enter the IP
address and port 23 for communication with the CPU. Use the same IP address and

® VoiceBlue Lite / Next /

port 1500 for communication with the SIM Client. The 2N

MAX gateway modules communicate via ports 10000 through 10003 and the 2N®
StarGate / BlueTower gateway modules communicate via ports 10000 through 10031 .
Set the processes that are necessary for a correct function of the SIM Client using the
gateway configuration tool.

Note

For more information refer to the 2N ® StarGate / BlueTower and 2N®

VoiceBlue Lite / Next / MAX User Manual available on the 2N web sites.

2N ® SIM Star GSM/UMTS Board

Board Description
The GSM/UMTS board includes two GSM or UMTS wireless modules, PCM bus
connection circuits, a DTMF receiver and, if the boards support 2N® SIM Star, a
processor. The board is designed on a four-layer PCB of the size of 160x100mm. Pins 1
and 32 on the board system connector are approximately 1 mm longer and are used
for the 'hot swap' board function, which enables you to remove and replace the board
under operation. This feature is particularly useful for the SIM card installation or
exchange. The front panel is equipped with two SMA antenna connectors and five
system LED indicators.

2N TELEKOMUNIKACE a.s., www.2n.cz 25/147

Module Types

The 2N ® StarGate / BlueStar / BlueTower GSM/UMTS gateways can use variable types
of GSM or UMTS modules. The modules differ in the type of the wireless module used,

the count of SIM card holders per module and also the 2N ® SIM Star support (not all
boards support this solution). The GSM/UMTS board types below can be used for the

2N ® SIM Star solution.

GSM card with 2 Cinterion MC55i engines, 1 SIM/channel
GSM card with 2 Wavecom Q55 (WPM100) engines, 1 SIM/channel
GSM card with 2 Wavecom Q55 (WPM100) engines, 4 SIM/channel
GSM card with 2 Telit Wireless GE910 engines, 1 SIM/channel
GSM card with 2 Telit Wireless GE910 engines, 4 SIM/channel
UMTS card with 2 Sierra Wireless MC8795V engines, 1 SIM/channel
UMTS card with 2 Telit Wireless UC864-G engines, 4 SIM/channel
UMTS card with 2 Telit Wireless HE910 engines, 4 SIM/channel

Note

The GSM/UMTS boards can be blocked for specific networks. For more

information refer to the 2N ® StarGate/ BlueStar/BlueTower gateway

User Manual.

2N ® SIM Star Server

2N ® SIM Star Server is the core of the system. It is composed of a Linux-based PC and
web and database systems. It checks the channel statuses of the gateways connected

with the main CPU (or VBL SS) via Telnet. 2N ® SIM Star Server is connected to the
eCPU SIM Client and the SIM Boards.

The SIM card assignment obeys the predefined 2N ® SIM Star Server rules and
obtained status data on the main CPU GSM channels and SIM cards. Before a SIM card
is assigned to a GSM/UMTS module, the SIM Client is notified and gets connected with
the specific SIM card on one of the SIM Boards connected. The SIM Board is a passive

component of the 2N ® SIM Star system.

2N TELEKOMUNIKACE a.s., www.2n.cz 26/147

2N ® SIM Star Server also synchronises all functional units integrated into the system
and so set its time correctly to avoid any SIM card switching error.

2N ® SIM Star Server can also assume control of module assignment to outgoing and
incoming GSM groups, thus eliminating the need to make assignments in the
gateways.

2N ® SIM Star Server is also able to change the IMEI for some module types. This is
particularly important for login of the SIM cards that are bound to a specific GSM
module (are available together with the telephones).

The following table sums up the main 2N ® SIM Star Server functions for easy
orientation:

1. Powerful SIM card switching

2. Gateway time synchronisation and automatics upgrade

3. PIN entering for SIM cards

4. Incoming/outgoing GSM group control option

5. IMEI change option for certain modules

6. Fix or dynamic BTS lock

7. SIM card credit check and automatic recharging

8. Call & SMS simulation

9. ASR and ACD monitoring and statistics

10. Human behaviours functionality (see chapter 1.1)

The control communication between 2N ® SIM Star Server, the SIM Client and the SIM
Board runs on port 1500 through the Telnet protocol. The CPU communication also
uses the Telnet protocol and runs through port 23. The SIM Client – SIM Board

communication runs directly (without the participation of 2N ® SIM Star Server) on

ports 10000 through 10031. The port number determines the SIM card position in the
SIM Board.

2N TELEKOMUNIKACE a.s., www.2n.cz 27/147

2N ® SIM Star Server also uses the Telnet protocol for event log reports (port 12346)
and for a specific interface for remote Call and SMS simulators on the eCPU (port

12349). An external API interface for 2N ® SIM Star Server management is also
available. For information on this interface refer to the SIM Server Management /
Licence menu. The menu is available only if a licence supporting the external
configuration is installed in the gateway.

A web configuration interface is available for easy system communication. For details

refer to the2N ® SIM Star Server Configuration section.

2N TELEKOMUNIKACE a.s., www.2n.cz 28/147

2.2 Before You Start
Product Completeness Check
Before installing this product, check whether the SIM Board Box delivery contains the
items included in the following packing list:

Package Pieces

SIM Board Box 1

Two RJ45 port front panel 1

Power supply cable 1

Ethernet cable, 3m 1

SIM Board As ordered

Installation Conditions
The following conditions must be met for a successful system installation:

Ensure a suitable location and enough free rack space.

Allow free access to network elements.
Provide a sufficient number of IP addresses, an appropriate bandwidth, an
adequate response level and a minimum packet loss rate in the Ethernet network
used.
Use the recommended power supply with overvoltage protection and UPS back-
up for all system components.

Use 3V supplied SIM cards in the whole 2N ® SIM Star system to avoid
malfunction.
Set one and the same PIN code for all the SIM cards in one SIM Board (or disable
the PIN request) and make sure that the SIM cards are activated by the GSM
/UMTS provider.
You are recommended to install the system components in an air conditioned
room.

2N TELEKOMUNIKACE a.s., www.2n.cz 29/147

 Note

For more information on the GSM gateway installation conditions refer

to the respective manuals available on the 2N web sites.

Warning

Do not cover the top, bottom and rear sides of the gateway to avoid
overheating and gateway error!
Protection against humidity and extreme temperatures: The appliance
may never be placed close to heat sources (radiators) or places exposed
to direct sunshine. Also places with high humidity (such as bathrooms
and cellars), places with significant temperature fluctuation (next to
doors, windows), dusty places (workshops) and places exposed to
aggressive gases (accumulator rooms, boiler rooms) as well as places
with intensive vibrations and places exposed to shocks (compressor
rooms, heavy industrial operations) should be avoided.

Caution

If possible, place all the 2N ® SIM Star components into one and the same
network segment (without using the NAT). This version requires no
profound knowledge of networks and active network element
configuration.

Licences

All the 2N ® SIM Star parts and functions are subject to licence. For an overview of the
licences see below.

GSM Gateways
Relevant licences have to be installed for the gateways to work properly. To
install a licence use the gateway configuration program.

An active SIM Client licence has to be installed in the 2N ® StarGate / BlueStar /

BlueTower gateways for communication with 2N ® SIM Star Server. Install the
licence on the eCPU web interface.

2N TELEKOMUNIKACE a.s., www.2n.cz 30/147

 The SIM Client licence is part of the 2N ® StarGate / BlueTower (latetst CPU
2013) and 2N ® VoiceBlue Lite / Next / MAX licence and installed through the
gateway configuration interface.

Note

For more information on the GSM gateway licence conditions refer to

the respective manuals available on the 2N web sites.

2N ® SIM Star Server

A licence including the CPU serial numbers (Mxxx–xxxxxxxxxx) of all the

gateways connected has to be installed in 2N ® SIM Star Server. Otherwise the

server will not succeed in connecting to the gateway.

In addition to a web interface, an external API interface can be used for the 2N ®
SIM Star Server communication too. This function is subject to licence.

2N ® SIM Star Server allows for a change of the IMEI in the GSM modules that
support this function. This function is subject to licence.

Tip

To install the 2N ® SIM Star Server licence use the SIM Server
Management / Licence file menu.

2N TELEKOMUNIKACE a.s., www.2n.cz 31/147

2.3 System Component Installation
2N ® SIM Star Step-by-Step Installation Guide

1. Set the required configuration for all the GSM gateways to be connected to 2N ®
SIM Star.

2. Set the Ethernet interface for the eCPU board and the SIM Client accordingly.
Remember to install the relevant licence into the eCPU.

3. Connect all the CPUs and SIM Clients to the Ethernet network. It is
recommended that all the components should be part of a single network
segment. This version requires no profound knowledge of networks and active
network element configuration.

Note

For more information on the GSM gateway configuration refer to

the respective manuals available on the 2N web sites.

4. Put the SIM Board Box in operation. Insert the required SIM cards into the SIM
Board, disabling the PIN request or enabling an identical PIN request for all the

SIM cards in the 2N ® SIM Star Server communication. If you fail to do so, your
SIM card will not log in to the provider's network. Finally, insert the SIM Boards
into the SIM Board Box positions.

5. Set unique IP addresses for the SIM Boards using a serial console and connect
the SIM Board Box into the Ethernet network by connecting the network cable
into the card front panel ports.

6. Install 2N ® SIM Star Server as instructed in the 2N® SIM Star Server section.
7. Set the time and time zone for the 2N® SIM Star Server installation site. The time
zone setting procedure is part of the installation process.

8. Set the 2N ® SIM Star Server network interface. The DHCP is enabled by default.
Connect 2N® SIM Star Server to the Ethernet network.

9. Use the web interface to log in to 2N ® SIM Star Server as the administrator with
the highest 2N ® SIM Star Server configuration rights. For the login data refer to
the Login section.

10.
2N TELEKOMUNIKACE a.s., www.2n.cz 32/147
 10. Set the appropriate IP addresses and communication for the GSM gateways, SIM
Clients and SIM Boards. An automatic detection of the system components is
available for easier setting as described in the Component Detection subsection.

11. Review the 2N ® SIM Star Server date and modify it if necessary using the Date
command.

12. Upload the relevant licence to 2N ® SIM Star Server, including all GSM gateway
serial numbers and providing the IMEI change and external API interface
administration if necessary.

13. Set the SIM card switching rules as described in the Rules subsection.

2N ® SIM Star SIM Board Installation

First, insert the SIM cards with the PIN request disable or identical PIN enable in the
SIM Board. For the SIM card holder positions refer to the System Component
Description subsection. Now insert the SIM Board in one of the eighteen SIM Board
Box slots (positions). Each SIM Board must have a unique IP address. To view the IP
address, use the console menu. After SIM Board connection, connect the standard full
crossed serial cable to the serial interface. For the connection parameters see below.

2N TELEKOMUNIKACE a.s., www.2n.cz 33/147

Serial Console Access
The console system is arranged as a set of nested menus. By selecting a menu item
you either get into a submenu, or have the required operation executed, or set the
selected parameter.

Serial Link Settings

Default parameters of the SIM Board serial connection:

Baud rate – 115,200bps

Bits – 8
Parity – None
Stop-bits – 1
Flow control – None

Serial Console
If the SIM Board is working properly, the main console menu gets displayed after the

terminal is connected. To enter the main menu, push .

If you select a submenu, the submenu gets displayed. Now you can select items from

the selected submenu or push for return.

The console menu is arranged as follows:

Main menu – The main menu is displayed after the cable is connected to the
serial interface of the board. The main menu includes the following items:
Configuration menu – A menu for Ethernet interface, serial console and other
parameter settings:
Network – use this item to configure the SIM Board Ethernet interface. Set
a static IP address or enable the DHCP support.
Date and Time – set the date, time and NTP server address for the selected
SIM Board.
SIM Star – set the username and password for the SIM Board login, the AT

port for the 2N ® SIM Star Server communication and the basic port for the
SIM card communication ports.
Console – define the basic serial interface parameters.
2N TELEKOMUNIKACE a.s., www.2n.cz 34/147
 Console – define the basic serial interface parameters.
Reset settings – reset the SIM Board default values.
Update password – set the SIM Board firmware update password.
Privilege – Use this option to define the user rights (Write/Read only).
Help – This item displays the Help.

2N ® SIM Star SIM Board Box Installation

The SIM Board Box requires no special installation. All you have to do is connect the
power supply and Ethernet network cable to the front panel. The remaining positions
are designed for the SIM Boards.

2N ® SIM Star SIM Client Installation

2N ® PRIGateway (eCPU) Solution

A proper eCPU web interface configuration is necessary for connection to the eCPU

web interface. For the steps refer to the 2N ® StarGate / BlueStar / BlueTower User
Manual.

After the basic configuration, enable the SIM Client process in the Management menu
if licensed. Complete the Settings for the SIM Client configuration.

Username and Password Enter the username and password to be used by 2N ®

SIM Star Server for the SIM Client communication. The default value is 2n in
either case.

AT port Set the AT port to be used for the 2N ® SIM Star Server – SIM Client
communication. The default value is 1500.

2N ® StarGate / BlueTower (latest CPU 2013) and 2N ®

VoiceBlue Lite / Next / MAX Solution
Set the gateway IP address for connection to the gateway configuration interface. For
the gateway configuration steps refer to the gateway User Manual. The GSM gateway
SIM Client is part of the gateway firmware and is always active.

Note

For more information on the GSM gateway configuration refer to the

respective manuals available on the 2N web sites.

2N ® SIM Star GSM/UMTS Board Installation

2N TELEKOMUNIKACE a.s., www.2n.cz 35/147
2N ® SIM Star GSM/UMTS Board Installation

One or four SIM cards can be assigned to each module and used whenever the 2N ®
SIM Star Server connection gets lost. Disable the PIN request or enable an identical
PIN for the SIM cards as configured in the gateway. Each module is equipped with an
SMA connector for antenna connection. The antenna should be connected before the
SIM card is inserted.

Warning

Do not operate the module without connecting an antenna to avoid the

module damage.

Tip

You are recommended to use an antenna splitter while connecting

multiple antennas under good signal conditions (refer to the 2N ®

StarGate / BlueStar / BlueTower User Manual).

2N ® SIM Star Server Installation

PC Requirements

2N ® SIM Star Server can be operated through a rack-mounted (or standard) PC with
the minimum configuration requirements as shown in the Server Requirements table.
The hardware requirements depend on the projected count of the SIM cards and GSM
gateways. A 2GB RAM operational memory is.

A monitor and a keyboard have to be connected to the PC for primary installation.

Before installing the system (inserting the CD), set the CD booting option in the PC
BIOS (change the sequence of the devices from which the system boots data). After
installation, re-enable hard disk booting as the primary booting method to accelerate
the system booting process.

2N TELEKOMUNIKACE a.s., www.2n.cz 36/147

 Tip

You can enter the BIOS during the POST detection within a few seconds

after the PC power on. To do so, use the or key, or a

combination of the + + keys.

OS Linux Installation

Warning

By using the 2N installation CD you remove all data from the PC hard
disk!

You are advised to download the latest CD image from the 2N web sites before

installation, which, in addition to the 2N ® SIM Star Server RPM package, includes a
complete Linux installation program. Burn out the CD image onto a suitable disk. If
you have set the CD booting method, insert the CD into the drive and power on
/restart the PC to launch the process automatically. You will get the following screen:

Now you can choose one of the available options. Automatic installation is listed first
and, unless you choose another option within three seconds, will be launched
automatically. After the basic system detections you will be asked whether you want
to check the installation data CD data before installation. Select OK to confirm or Skip
to continue.

2N TELEKOMUNIKACE a.s., www.2n.cz 37/147

Now the hard disk is formatted automatically, a corresponding system of files is
created and all necessary system components are installed.

The automatic installation of all the system components takes about 30 minutes
(according to the communication HW configuration). After installation, the installator
awaits the system Reboot confirmation. Press to continue and then remove the CD

from the drive. Now you have installed the Linux 32bit OS and associated 2N ® SIM
Star Server installation scripts and packages. Upon the system start, you will be
invited to enter the login data.

Local host login – Password

Admin – 2n

After login, the system setting wizard is launched as described below.

System Settings

Upon the primary login, you can set the time zone and 2N ® SIM Star Server network
interface using the wizard. Assign the static IP address including the network mask
and the default gateway to the selected network interface, or enable the IP address
obtaining from your network DHCP (default setting). If necessary, you can also use the
wizard for setting the DNS parameters for your network. Having set all the required
parameters, click on Save & Quit to quit the wizard.

2N TELEKOMUNIKACE a.s., www.2n.cz 38/147

Now the network interface setting and database initialising processes follow. Do not
interrupt the database initialising process to avoid database error and potential re-
installation.

2N ® SIM Star Server Installation

The installation process is launched automatically after the system setting and
database initialisation processes are completed. The system will automatically install:

1. 2N ® SIM Star Server

2. 2N ® External Routing Machine

Note

For more information on 2N ® External Routing Machine refer to the 2N®

StarGate / BlueStar / BlueTower User Manual available on the 2N web
sites.

Now you can enter the 2N ® SIM Star Server IP address into your web browser and
display the web configuration login dialogue. For more information on the system

configuration refer to the 2N ® SIM Star Server Configuration section.

2N ® SIM Star Server Firmware Upgrade
You are advised to upgrade your system periodically to make the most of the system

capabilities. For the 2N ® SIM Star Server firmware upgrade procedure see below.
Caution

For the latest 2N ® SIM Star Server firmware and User Manual versions
refer to the 2N web sites.
Use only the installation files certified by 2N to avoid lower functionality
or even malfunction of the system!

2N TELEKOMUNIKACE a.s., www.2n.cz 39/147

Upgrade via Web Interface

Follow the steps below to upgrade 2N ® SIM Star Server via a web interface.
1. Prepare a RPM package with a new 2N ® SIM Star Server version (SimStar–Server–
x.x.x–xxxx.i386.rpm).

2. Login as a user with Admin rights.

3. Click on the SIM Server Management icon.

4. Click on Restart in the left menu.

5. Select the prepared RPM package using the Browse button and click on Restart.

6. Wait for the automatic upgrade for a few minutes and then relog in.

Caution

2N ® SIM Star Server will be deactivated during upgrade!

Remember to upgrade the back-up 2N ® SIM Star Server version if
available!
Use only the installation files certified by 2N to avoid lower functionality
or even malfunction of the system!
In case of installation SSS in Hot backup mode – two running SSS – you
have to make update both of SSS!

Upgrade via SSH Interface

2N TELEKOMUNIKACE a.s., www.2n.cz 40/147
Upgrade via SSH Interface

Caution

Use the SSH interface upgrade only in case the web interface method is
not applicable!

Upload the new firmware package to 2N ® SIM Star Server using the WinSCP or a
similar SFTP-based program. The transfer takes place through the SSH protocol. Run

the program on your PC and log in to 2N ® SIM Star Server through its IP address and
port 22 using the following login data:

Username – Admin
Password – 2n

Copy the firmware package into the /home/admin directory. Now move to 2N ® SIM
Star Server or get connected to it using the PuTTY or some other SSH client software.
Enter the ls command to write out the current directory files, including your new
firmware package. If the firmware package is not available, check whether you are in
the correct directory and, if not, move to the correct one using the following
command:

cd /home/admin

Enter the following command to open the package:

rpm –Uvh file_name

Now confirm the installation. Enter and click on . After the first firmware
installation part, you will be asked whether you want to re-initialise the database.
Think twice before doing so, because re-initialisation deletes the database completely.
On the other hand, some system parts may be inoperative without database re-
initialisation. After the whole installation process is completed, you will be asked

whether or not to launch 2N ® SIM Star Server. Enter and click on . A new

firmware version has been installed successfully and you can get connected to 2N ®
SIM Star Server from your web browser again.

2N TELEKOMUNIKACE a.s., www.2n.cz 41/147

 Caution

The database structure may be modified or configuration deleted during

the 2N ® SIM Star Server firmware upgrade and so re-create the

database including all settings.
The firmware upgrade results in a restart of all current SIM card – GSM
module connections and may lead to a temporary system malfunction!
The upgrade system is only allowed, downgrade will not be executed!

Upgrade of Other 2N ® SIM Star Components

It may be necessary to upgrade other components of the 2N ® SIM Star system too
during the 2N ® SIM Star Server upgrade process. This process does not run
automatically for security reasons – must be initiated by the user.

2N ® SIM Star Server automatically prepares the recommended firmware versions for
other system components designed for the current 2N® SIM Star Server version.
Download the files in the SIM Server Management / GW & SB/SC firmware / Support
files folder. The folder also contains current versions of the User Manual and other
useful utilities.

Copy the system components into the preceding Firmware tag to execute the

automatic upgrade. Refer to 2N ® SIM Star Server Management Subs. 3.3 – GW & SB
Firmware for details.

2N TELEKOMUNIKACE a.s., www.2n.cz 42/147

 Caution

The count of available system voice channels will be limited during the
upgrade process!

2N TELEKOMUNIKACE a.s., www.2n.cz 43/147

3. Configuration

This section describes the 2N ® SIM Star Server configuration.

Here is what you find in this section:

3.1 Web Interface

3.2 Step-by-Step Basic Configuration
3.3 Management
3.4 Gateways Menu
3.5 GSM Groups Menu
3.6 GSM Menu
3.7 SIM Boards Menu
3.8 SIM Groups Menu
3.9 SIM Menu
3.10 IMEI Menu
3.11 Rules Menu

2N TELEKOMUNIKACE a.s., www.2n.cz 44/147

3.1 Web Interface
Essentials

The 2N ® SIM Star Server web interface supports the following web browsers:
MS Internet Explorer v9.0
Mozilla Firefox v4 and higher

Other web browsers may cause troubles. The recommended screen resolution is
1280x1024 and the colour quality 32bit or higher. The configuration interface is
available in the English language only at present.

Tip

For better viewing, use the F11 key to launch the full screen mode.

Login

To log in to the 2N ® SIM Star Server web configuration interface enter the 2N® SIM
Star Server IP address into your web browser. The following login dialogue gets
displayed:

Tip

Activate a simple login screen (in the case of system anonymity request)
in the Management / Connections menu:

2N TELEKOMUNIKACE a.s., www.2n.cz 45/147

The users may log in with the following three types of privileges:

Privileges
Admin – a user with the highest rights, authorised to manage configuration
and the user accounts.

Edit – a user with the limited 2N ® SIM Star Server configuration rights.
View – a user with the 2N ® SIM Star Server configuration and log viewing
rights.

By default, one login name is created for each privilege:

Login name Password

Admin 2n

editor p2

visitor p1

Caution

You are recommended to change the default settings upon the first
login to improve your system security.
The system allows for concurrent logins of users with the configuration
privileges. However, we do not recommend this because of a risk of
erroneous saving of configuration data into the system database.

2N TELEKOMUNIKACE a.s., www.2n.cz 46/147

Home Page
Upon your login, you get onto the Home page as shown below. There is a vertical list
of menus on the left-hand side of the screen, which will be available to you in the
horizontal format in every web configuration menu. You can see the user login name
(administrator, editor, visitor) and privilege (Admin, Edit, View) in the right-hand
upper corner.

The Home page is the only screen where you can find the Logout button for user
logout. After logout, you will be notified of your successful system logout and invited
to close the browser window to avoid re-use of your login data.

The main Home page field provides horizontally arranged icons representing the
configuration menus. The links are logically grouped and have the same functions as
the vertical menu items on the left.

Configuration wizards
Configuration wizard pop up after the first system log in. This wizard can guide you
through basic parameters of whole system or you can run for each logical part of
system. You can use "Open wizard" link or wizard icon to run the wizard. This wizard
will guide you through the basic parameters. Not all advance parameters are involved.

Tip

Wizard repeated pop up after each login can be activated/deactivated

in user menu.

2N TELEKOMUNIKACE a.s., www.2n.cz 47/147

Automatic Notification of Errors

2N ® SIM Star Server can notify you of system errors if any. Select the errors to be
notified in the SIM Server management / Connections menu. For example:

Loss of GSM gateway / eCPU / SIM board connection

Blocked SIM cards
Low credit SIM cards; SIM cards not activated
System test licence expiry is approaching
Licence error in one of the GSM gateways connected
Lack of free IMEI/recharge codes

Low ASR, ACD of a 2N ® SIM Star component

E-Mail Notification

2N ® SIM Star Server supports automatic generation and transmission of alert e-mail
messages in the event of errors as well as periodical sending of log files on system
operation. Set the function for each user in the SIM Server management / User
accounts / Settings menu.

2N TELEKOMUNIKACE a.s., www.2n.cz 48/147

3.2 Step-by-Step Basic Configuration

Tip

We strongly recommend to use configuration wizards for first usage.

This wizard will guide you through the basic configuration of 2N ® SIM
Star server.

The subsection provides detailed 2N ® SIM Star Server configuration steps. The aim of
the procedure is to log in one SIM Board SIM card to the network through a GSM
module of the selected gateway. The procedure assumes that the other system

components have been configured properly and deals with the 2N ® SIM Star Server
part only.

1. Log in to the web configuration interface as described in the Login subsection.

2N TELEKOMUNIKACE a.s., www.2n.cz 49/147

 2. Upload the licence including the selected gateway serial number into 2N ® SIM
Star Server. To do so, use the SIM Server Management / Licence file menu.

3. Move to the Gateways menu and add a gateway using the Add gateway item. Fill
in all necessary data. Refer to the Add Gateway subsection for description of the
items in the case of doubts. Once you have installed the licence and filled in the
IP addresses, ports and login data, the GSM gateway will be marked as
connected in the overview table.

4. Proceed to the GSM groups menu and add a group using the Add GSM group
item.

2N TELEKOMUNIKACE a.s., www.2n.cz 50/147

 Tip

Highlight the GSM/SIM groups by colour to make their listings clearer.

Create new GSM/SIM groups simply by copying an already established

group. Click on the button in the list of GSM/SIM groups.

1. Proceed to the GSM menu. Select your gateway in the filter. An overview of all
gateway channels gets displayed. Click on Add in the last but one column in the
row corresponding to the suitable position in the GSM gateway. Set a group for
the GSM channel, fill in the other parameters if applicable and push Ok.

2. Proceed to the SIM Boards and add a SIM Board using the Add SIM Board link.
Complete all necessary data. Refer to the Add Gateway subsection for
description of the items in the case of doubts. If you have installed all parameters
correctly, the SIM Board will be marked as connected.

3. Proceed to the SIM groups menu and add a group using the Add SIM group link.
Complete all necessary data. Refer to the Add Gateway subsection for
description of the items in the case of doubts.

2N TELEKOMUNIKACE a.s., www.2n.cz 51/147

 4. Proceed to the SIM menu. Select the added SIM Board in the filter and view the
SIM cards in the corresponding SIM Board positions. However, these SIM cards
have not been added yet. Click on Add in the SIM card row. Assign the SIM card
to the SIM group created in the preceding step and set the required count of
free minutes for the SIM card (or the available credit in the case of a prepaid SIM
card).

5. Proceed to the Rules menu and add a rule using the Add rule link. Select your
GSM group and the SIM group. Set the selection method for the SIM card to be
assigned. Define the days and times for the rule.

Tip

If you work with time conditions frequently, use the button in

the Rules menu for facilitation.

2N TELEKOMUNIKACE a.s., www.2n.cz 52/147

 6. Now the SIM card should start logging in to the network through the GSM
module. View the login process in the Status column of the GSM menu after
filtering the added GSM gateway.

Note

When the SIM cards fail to log in to the GSM modules automatically, click
on the failing GSM module / SIM card to check the GSM module / SIM
card setting and state. Refer to the Lookup info menu for current data.

2N TELEKOMUNIKACE a.s., www.2n.cz 53/147

3.3 Management
This menu can be divided into two parts. On the left-hand side there are nine links to
the menus described in the subsections below. The right-hand part offers overviews of
the versions, times and database usage. For a view of the menu see the figure below.

Versions – this section provides information on the firmware versions:

Version – gives information on the firmware version.
Build – gives information on the firmware build version.
Database version – gives information on the database version, which
defines the database structure.

Times – this section provides information on the on the 2N ® SIM Star Server
times.

Server local time – gives the 2N ® SIM Star Server local time derived from
the time zone defined.

Server GMT – gives the 2N ® SIM Star Server time without time shift. GMT
stands for the Greenwich Mean Time and is taken over directly from the
BIOS.

Process uptime – gives the 2N ® SIM Star Server process running time from
the last power up/restart.
System uptime – gives the time from last OS power up
2N TELEKOMUNIKACE a.s., www.2n.cz 54/147
 System uptime – gives the time from last OS power up
Database usage – this section helps monitor the use of the database, which
limited to a certain extent. The first column includes the items to be monitored.
The second column shows the currently used items of the maximum count of the
database items concerned. The third column shows the percentage of use and
the last column expresses the use graphically.

SIM Server About

The menu provides essential contact information on 2N TELEKOMUNIKACE a.s. You
will find here the address, telephone and fax numbers and e-mail address of the Sales
Department and Technical Support as well as a link to the 2N web sites.

This section also contains HW PC information

Caution

To prevent potential problems with SSS functionality please use HW PC

according to minimal HW requirement!

SIM Server Load

The menu uses a graph to show the server load in time. The load can cover the past
300 seconds, 300 minutes or 300 hours, or a combination of these values. Press F5 to

refresh the screen data. Moreover, the ASR, ACD and Call graphs for the whole 2N ®
SIM Star Server system are displayed including the last three day / two week / six
month history. The displayed data are for information only!

Use the Settings folder to define which types of records should be periodically stored
and subsequently displayed in the forms of graphs.

2N TELEKOMUNIKACE a.s., www.2n.cz 55/147

Licence File

Some 2N ® SIM Star Server functions and GSM gateway connections are subject to
licences. To manage the licences use this menu.

Current licence limitations – check whether your current licence includes the
following two system functions:
IMEI change support – some GSM board types are able to change their

IMEIs according to the 2N ® SIM Star Server requirements. This function is

subject to licence.

External configuration – this function is used for the external 2N ® SIM Star
Server configuration via the API interface. If enabled, the menu provides a
link to the documentation.
BTS lock support – only modules SierraWireless Q55, Q24CL and Q2400
supports BTS lock feature! This feature is licensed.
Licensed gateways – the section displays a list of serial numbers of all the GSM

gateways that may be used with 2N ® SIM Star Server. 2N® SIM Star Server
cannot be connected to gateway types other than those listed here. Every
record also includes information on the licence expiry.
Upload new licence file – the section helps you upload a new licence file. Select
the file location using the Browse button and push Upload licence file.

Autolicence
Autolicence interval [hours] – if the Gateway limitation parameter for the active
GSM/UMTS gateway licence drops below the value of the first number in the
interval, the licence will automatically be prolonged to the value of the second
number of the interval. Enable Autolicence for each gateway in Gateway >
Autolicence enabled.

2N TELEKOMUNIKACE a.s., www.2n.cz 56/147

 Caution

The Autolicence service is licensed both for the 2N ® SIMStar Server and
GSM/UMTS gateway.

GW & SB/SC Firmware

Since 2N ® SIM Star Server communicates with all the system components, the

components may be upgraded remotely by 2N ® SIM Star Server. 2N® SIM Star Server
automatically distributes the latest firmware upgrades to all the required devices, thus
eliminating the need to modify the components separately.

Use the Component version review link to move to a page showing the current
software status in each system component.

Current firmware – the section provides a full survey of the current software
versions for the selected components. You can replace or delete the firmware
data.
SB/SC card – gives the current software version for the SIM Board and SIM
Client.
SB/SC root – gives the current Linux version for the SIM Board and SIM
Client.
eCPU firmware – gives the current firmware version for the eCPU.

SB v2 firmware – gives the current firmware for the SIM board cards
2N TELEKOMUNIKACE a.s., www.2n.cz 57/147
 SB v2 firmware – gives the current firmware for the SIM board cards
version Y2012 (doesn't contains normal size SD memory card holder)

SG/BS/BT firmware – gives the current firmware version for the 2N ®

StarGate / BlueStar / BlueTower gateway CPUs.

VBL firmware – gives the current firmware version for the 2N ® VoiceBlue
Lite gateways.

VBN firmware – gives the current firmware version for the 2N ® VoiceBlue
Next gateways.

VBM firmware – gives the current firmware version for the 2N ® VoiceBlue
MAX gateways.
Settings
Manual confirmation of firmware update – helps you update firmware for
each device manually. Use the view menu of the particular device for
updating.
Upload new firmware file – this section helps you upload the current firmware to

2N ® SIM Star Server for automatic distribution to all available components of the
given type.

You can save the FW versions and auxiliary SW tools from the Support files folder for
future upgrade of the system components.

Caution

The firmware upgrade results in a restart of some devices on which the

remote firmware restarting process is taking place. This process has a
temporary effect on the system function.

User Accounts

This menu helps you edit the 2N ® SIM Star Server user accounts, change the privileges
and access passwords.

Logged user – use this section to change the data related to the currently

logged-in 2N ® SIM Star Server user.

Change password – change the user password. The random password
generating function is also available.
Settings – change the user e-mail address and enable/disable sending
alerts.

2N TELEKOMUNIKACE a.s., www.2n.cz 58/147

 User name – the currently logged-in user's name is displayed.
Privileges – the currently logged-in user's privilege is displayed.

User table – the table provides a list of the current 2N ® SIM Star Server users.
User name – display the username.
Privileges – display the user's privilege in the system.
E-mail – display the user's currently available e-mail. This item is necessary
to sending automatics e-mail alerts
Alerts – display whether sending of e-mail alerts is enabled for the selected
user.
Add new user – use this item to add a new system user with a specific
privilege.
Change password – use this item to change the selected user's password.
Settings – use this item to change the user's e-mail address and enable
/disable sending of alerts.
Remove – use this item to remove a user from the system.

Note

Make sure that the SendMail component is set properly in the Linux OS
to ensure correct e-mail alert sending.

2N TELEKOMUNIKACE a.s., www.2n.cz 59/147

Logger

Logger

The menu provides a view LOG records in 2N ® SIM Star Server. The records are
marked with a timestamp.

Define which events should be recorded automatically in 2N ® SIM Star Server in the
Log settings folder. Display the list of events arranged according to the date in the
Log list.

Tip

To view the log on-line, get connected to the 2N ® SIM Star Server IP
address on port 12346 using the Telnet protocol. The login data are
identical with the web interface login data.
You can activate the automatic log file e-mail sending option in the user
settings.

2N TELEKOMUNIKACE a.s., www.2n.cz 60/147

CDR (Call Data Records)

2N ® SIM Star Server is able to store automatically call data records (CDR) from all
available GSM gateways. Download the CDR using this menu.

Download CDR from gateways – use this parameter to enable downloading and
saving call records from all the gateways connected. To change the setting click
on Apply.
Save downloaded CDR to file – use this option to save the call records available

on the 2N ® SIM Star Server disk into a local disk file. Push the Save button to
create a cdr.zip package to be saved.
Clean downloaded CDR – use this option to delete all current call records on the

2N ® SIM Star Server disk. After pushing the Clean button you will be asked for
confirmation and the records will not be deleted until you confirm the operation.

SDR (SMS Data Records)

2N ® SIM Star Server is able to store automatically SMS data records (SDR) from all
available GSM gateways. Download the SDR using this menu.

Download SDR from gateways – use this parameter to enable downloading and
saving SMS records from all the gateways connected. To change the setting
click on Apply.
Save downloaded SDR to file – use this option to save the SMS records available

on the 2N ® SIM Star Server disk into a local disk file. Push the Save button to
create a sdr.zip package to be saved.
Clean downloaded SDR – use this option to delete all current SMS records on the

2N ® SIM Star Server disk. After pushing the Clean button you will be asked for
confirmation and the records will not be deleted until you confirm the operation.

Component Detection
Use the menu for an easy detection of devices within one network segment. Upon
your primary entering (and upon every deletion of the detection results), the Start>>
button is only available for proceeding to the detection setting page.

Component selection – here specify the devices to be detected in the selected

network segment. Choose GSM gateways, SIM Boards or both.
Network range – the maximum possible count of IP address and port
combinations for searching is 10,000.

IP range – set the IP address range to be searched in the selected network

2N TELEKOMUNIKACE a.s., www.2n.cz 61/147
 IP range – set the IP address range to be searched in the selected network
segment. By leaving the last field blank you initiate searching on a specific
IP address with variable ports.
Ports – set the ports or port range for network segment searching. The
ports are separated with a comma, the port range is entered with a dash (e.
g. 23,1500–1502). Ports 23 and 1500 are entered by default.
GW setting – you have to log in to a gateway to verify whether the gateway is
connected on the selected IP address. To do so, fill in the username and
password here. This searching method is ineffective if the gateways to be
detected have different login data. (default username/password = Admin/2n)
SB & SC setting – you have to log in to a SIM Board to verify whether the SIM
Board is connected on the selected IP address. To do so, fill in the username and
password here. This searching method is ineffective if the SIM Boards to be
detected have different login data (default username/password = 2n/2n).

Detection Results
Network segment searching combinations are compiled according to the settings. The
course of detection is signalled graphically and numerically.

To discontinue detection any time push the Stop button. Three buttons are available
after the detection is completed:

Start>> – Push the button to return to the detection setting page.

Clean – Push the button to delete all the existing detection results.
Result>> – Push the button to display the detection results.

Now you can add the detected system components to the 2N ® SIM Star Server
configuration. Before doing so, assign the SIM Clients to the corresponding GSM
gateways as they are detected as independent components and their links cannot be

defined by 2N ® SIM Star Server alone. You can assign them individually or collectively.

2N TELEKOMUNIKACE a.s., www.2n.cz 62/147

The GSM gateways with the SIM Clients and the SIM Boards are added separately. The
figure below shows a potential detection result where one gateway, one SIM Client
and one SIM Board have been found. This solution represents the simplest available
configuration.

The detected setting of a device behind the NAT server may be wrong due to the
Network Address Translation. Such records are included in the NAT column and
should be verified.

Some detected SIM Boards or SIM Clients are indicated with an exclamation mark. It

means that 2N ® SIM Star cannot verify whether the device is a SIM Client or a SIM
Board or any other component.

Restart

Use this option to restart 2N ® SIM Star Server. After pressing the button, you will be
asked for confirmation and only then the system will be restarted.

You can also execute an automatic 2N ® SIM Star Server upgrade here. Refer to 2N®
SIM Star Server Firmware Upgrade for details.

You can also make export/import of 2N ® SIM Star Server's database and set-up 2N®
SIM Star Server mirroring (hot backup).

2N TELEKOMUNIKACE a.s., www.2n.cz 63/147

 Caution

Restarting 2N ® SIM Star Server may discontinue the currently running

calls and result in a temporary system malfunction!
Make sure that automatic upgrade is applicable before restarting! For
example, automatic upgrade is impossible upon transition from version
1.3.x to 1.4.0 via a web interface and upgrade via a SSH interface is
necessary!

Connections

Server ID – custom name of 2N ® SIM Star Server used for web interface and e-
mail alerts.

Server link 2N ® SIM Star Server – custom link for easy access by direct links from
e-mail alerts.
Delay for e-mail alerting – define the minimum delay between two last e-mail
alerts.
ASR/ACD threshold for alerting – defines the minimum good level of ASR to
send e-mail alert.
Licence expiration for alerting – define the minimum number of days to send
automatic alert e-mail to prevent SSS from stopping due to expired licence.
Low number of IMEIs/recharge codes – define the minimum unassigned/unused
items to send automatic alert e–mail to avoid potential problems.

Auto logout (min) – automatic logout time due to user inactivity.

2N TELEKOMUNIKACE a.s., www.2n.cz 64/147
 Auto logout (min) – automatic logout time due to user inactivity.
IMSI/Phone distribution – the links defined between the SIM card IMSI
(International Module Subscriber Identity) codes and the phone numbers used

by 2N ® SIM Star Server can be shared by other applications too. By activating

this parameter you make the linking information available on UDP port 12349 on

the 2N ® SIM Star Server IP address. Click on Apply to confirm the setting
changes.
Use Telnet Router – enable connection of the JAVA applet terminals using IP
port 12352. This function is necessary if the device is located behind the NAT.

Caution

By activating this function you lower the security level of the whole
system!

Simple login form – this option helps you use the anonymous style of the 2N ®
SIM Star Server login page.
Admin – this section helps you monitor the currently logged-in web
configuration interface users through a login table with the following columns:
Status – shows the current login status.

Remote address – gives the address from which the user logs in to 2N ®
SIM Star Server.
User – gives the user login name.
Privileges – specifies the logged-in user privilege (Admin, Edit, and View).

Caution

A single user should edit 2N ® SIM Star Server at one moment

(administrator or editor) to avoid unintentional configuration rewriting.

External Admin – this section helps you monitor the currently logged-in API
users through a login table with the following columns:
Status – shows the current login status.
Remote address – gives the IP address and port from which the user logs

in to 2N ® SIM Star Server.

User – gives the user login name.

Privileges – specifies the privilege of the logged-in user (Admin, Edit, and
2N TELEKOMUNIKACE a.s., www.2n.cz 65/147
 Privileges – specifies the privilege of the logged-in user (Admin, Edit, and
View).
Logger – this section helps you monitor the currently logged-in users viewing

the 2N ® SIM Star Server log. All created users may view the log independently of
their rights. The login table includes the following columns and functions:
Status – shows the current login status.
Remote address – gives the IP address and port from which the user logs

in to the 2N ® SIM Star Server log interface.

User – shows the user login name.
Disconnect – is used for forced termination of the current log interface
connection. The Admin user is the only to terminate such connection.
Session lock – the Lock button enables an Admin user to lock the other users'
access. The lock is valid for the user's login time. As soon as the user logs out or
the user's login timeout expires (due to inactivity), the connection is released for

other users. If multiple Admin or Edit users log in to 2N ® SIM Star, they are
notified of this fact and should not make any changes in the configuration.
Autologin by web session – this function saves access cookie to your web
browser which enables you to log in automatically without username/password.
This feature is comfortable with using e-mail alert direct links.

Caution

This feature may cause security risk. Please use it only on a secured PC
and web browser.
This feature does not work with web browsers in the anonymous mode.

2N TELEKOMUNIKACE a.s., www.2n.cz 66/147

3.4 Gateways Menu
The menu enables you to get an overview of the GSM gateways, add new gateways
and modify the gateway settings.

Add Gateway
Use this function to add new GSM gateways to the configuration manually. You can
use the following parameters for adding:

Gateway type – set the gateway type for automatic value completion.
General info – set the essential data on the gateway to be added.
Description – the text facilitates gateway identification only (GW Prague, e.
g.).
GSM count – the count of channels or the type of the gateway to be
added.

Time zone – the time zone for the gateway location. 2N ® SIM Star Server
automatically sets time for all the gateways connected and so this setting
influences the time-dependent SIM card switching.
Autolicence enabled – enable the Autolicence function for your GSM/UMTS
gateway. Refer to SIM server / Licence file / Autolicence for more details.
Gateway position – physical position of a GSM gateway. Used for feature
"Advanced SIM card movement"
GPS latitude
GPS longitude
GW network info – here fill in the information related to the gateway CPU
network interface and login data.
IP – enter the CPU Ethernet interface IP address of the GSM gateway to be
added. This IP address is included in the System parameters menu in the
gateway.

AT port – define the port to be used for the 2N ® SIM Star Server – gateway
CPU communication. By default, this port is 23 (TCP), but the value can be
changed if the NAT is used.
Username and Password – enter the username and password for the
gateway login and update. These settings can be changed in the Login
account menu in the gateway only if a serial interface is used for
connection. Default username / password are Admin/2n.
Update port – define the port to be used for automatic gateway firmware
update. Port 2222 is used by default. The setting can be changed in the
System parameters menu in the gateway. While using the NAT or firewall,
remember that the UCMD protocol based on the UDP transfer is used for
update.

2N TELEKOMUNIKACE a.s., www.2n.cz 67/147

 Conn. timeout (s) – set the automatic report timeout in the case of
unavailability of the device.
SC network info – fill in the information related to login to the SIM Client
gateway.
IP – enter the IP address on which the gateway SIM Client is running. The

® StarGate / BlueStar / BlueTower

address is the eCPU address for the 2N

gateways and the CPU address for the 2N® VoiceBlue Lite / Next / MAX
gateway.

AT port – define the port to be used for the 2N ® SIM Star Server – gateway
SIM Client communication. The default port is 1500 (TCP), but the value
can be changed if the NAT is used.
Username and Password – enter the username and password for the SIM
Client login. These settings can be changed in the eCPU web configuration
interface. Default values are 2n/2n
Update/web port – define the port to be used for automatic eCPU
firmware update through the web interface using the http protocol. Port

80 is thus used by default. This option is inapplicable in the 2N ® VoiceBlue

Lite gateway as the SIM Client is part of the gateway firmware.

Update password – enter the 2N ® SIM Star Server user password for the
eCPU. This option is inapplicable in the 2N® VoiceBlue Lite gateway as the
SIM Client is part of the gateway firmware.
Conn. timeout (s) – set the automatic report timeout in the case of
unavailability of the device.
SIM cards info
SIM cache – select the type of SIM card communication. If there are only
UMTS SIM cards (USIM) on the selected SIM Board, the recommended
option is UMTS only.
Do not change setting – retain the factory values from the SIM Board
setup.
GSM and UMTS – the GSM SIM card protocol is used and, if
unsuccessful, the UMTS protocol is used for SIM card initialisation.
GSM only – the GSM SIM card protocol is only used for SIM card
initialisation.
UMTS only – the UMTS SIM (USIM) card protocol is only used for SIM
card initialisation..
Turn cache off – select this option to debug SIM card initialisation.
This option disables all SB – SC protocol optimisations and sets
higher data flows between the systems!

2N TELEKOMUNIKACE a.s., www.2n.cz 68/147

 Caution

Setting SIM cache to values other than the factory settings may result in
a higher error rate during SIM card login to GSM networks, or even a
complete communication failure!

Call Simulation – Maximum channels – maximum number of GSM channels used

for virtual call simulation at a time.
SMS simulation – Maximum channels – maximum number of GSM channels used
for virtual SMS simulation at a time.
Data simulation – Maximum channels – maximum number of GSM channels used
for virtual Data simulation at a time.

Caution

Call/SMS/Data simulation are mutually independent and can be active at

the same time.
Make sure that the SMS server service is active in your GSM gateway to
enable SMS simulation.
Assign the number of GSM channels used for simulation in your gateway
(s) to make simulation work efficiently. Hence, set Maximum channels
>=1.
If you use a single gateway only, set Maximum channels >=2 to enable
call/SMS simulation.
The GSM channels used for call/SMS simulation support both outgoing
and incoming simulations.

SMS phone number detection – enable phone number detection via SMS. Refer
to the SIM group settings in the Phone number detection for more details.
New GSM default settings – this section enables you to make basic pre–settings
for the gateway GSM channels automatically.
Use default settings for new GSM – enable the use of the following three
GSM channel adding parameters. If this option is not selected, the
parameters are not applied. Nevertheless, if any of the following
parameters is enabled, this option is selected automatically.
GSM Group – automatic assignment of GSM channels to the selected GSM
group.
Remark – a note for easier orientation in the configuration.
Disabled – disable the use of the selected gateway channel.
Add GSM now

2N TELEKOMUNIKACE a.s., www.2n.cz 69/147

 Add all GSM – select this option to automatically add all the detected

gateway GSM channels to the 2N ® SIM Star Server configuration.

Overview Table
The section provides a table overview of all the gateways connected.

Tip

Dark grey column indicates columns with changeable content. By

clicking on it you can change content of table.

Columns

Id – shows a unique identification number for each gateway in 2N ® SIM

Star Server.
Description – describes the gateway for easier identification. The
descriptions may be identical for variable gateways.
Gateway status (Gateway IP:port) – displays the current gateway
connection (CPU) status.
SIM Client status (SIM client IP:port) – displays the current SIM Client
(eCPU) connection status.
GSMs – active link to the GSM/UMTS module status list for the GSM
gateway connected.
Action icons

View – display the current GSM gateway state and setup.

Edit – edit the GSM gateway setup.

Remove – delete the GSM gateway from the 2N ® SIM Star

system.

2N TELEKOMUNIKACE a.s., www.2n.cz 70/147

 Action menu – used for manual reconnect with the GSM gateway
/SIM Client, by opening on-line GSM gateway / module state
monitoring windows.

Tip

Action menu contains options "Open GW/GSM

watcher" which show online state of gateway/GSM
modules.
Action menu contains option "View in Google Maps". If
you define GPS position of GSM gateways. You can see
position of it on real maps.

Multiselection – use this button to select a higher number of

items for a global change.

Buttons
Select all – push the button to mark all the GSM gateways at once.
Unselect all – push the button to cancel the Select all function.
Remove selected – push the button to remove the gateways from
configuration that are selected in the last overview table row.

Tip

If a working gateway is designated as disconnected, check the IP

address, port and password settings in the GW and SC network info
sections.

The GSM gateway overview window includes the following tags:

GSMs – link to the GSM/UMTS module state overview for the GSM gateway
selected.
Edit – edit the selected GSM gateway.
Remove – delete the selected GSM gateway.
Action menu – for manual reconnection with the GSM gateway/SIM Client, by
opening on–line GSM gateway/module state monitoring windows.

2N TELEKOMUNIKACE a.s., www.2n.cz 71/147

 ASR, ACD, Call graph – 2N ® SIM Star Server – can save and subsequently display
the ASR, ACD and Call data on the entire GSM gateway system connected. If the
displayed data are discrete, the GSM gateway has been disconnected. The
displayed data are for information only!

Open PRI gateway configuration in new window – web link to the eCPU web
interface.
Open VoiceBlue Next configuration in new window – web link to the web

interface of 2N ® VoiceBlue Next connected.

Other Controls
Description filter – is used for searching GSM gateways according to the data
included in the Description field. Any part of the string can be used for
searching. Click on Unset to cancel the filter.
Component detection – is a link to the system component detecting menu. Refer
to the Component Detection section for the menu function.
Autolicence – is a link to the system component autolicence menu. Refer to the
Management / Autolicence section for the menu function.

2N TELEKOMUNIKACE a.s., www.2n.cz 72/147

3.5 GSM Groups Menu
The menu helps you add, edit and view the GSM groups.

Tip

Highlight the GSM / SIM groups by colour to make their listings clearer.
Create new GSM / SIM groups simply by copying an already established
group. Click on the button in the list of GSM / SIM groups.

Add GSM Group

Use this function to add new GSM groups to the configuration manually.

General info
Description – type a text to be used for easier orientation in the
configuration.
Highlighting – select the user colour codes for easier group listing.
Gateway routing – set the outgoing/incoming group for the LCR table of the
GSM gateway whose modules are assigned to the selected GSM group. The
following priorities are respected:
1. SIM group (SIM card) setting;
2. GSM group (GSM module) setting;
3. User setting in the GSM gateway.
Outgoing group – select the outgoing group for the GSM gateway LCR table.
Incoming group – select the incoming group for the GSM gateway LCR table.
Recharging and activation – use this item to control the SIM card activation and
recharging for the GSM modules of the selected GSM group.

2N TELEKOMUNIKACE a.s., www.2n.cz 73/147

 BTS lock – if the GSM modules in the selected GSM group support the BTS lock

and the function licence is valid, 2N ® SIM Star Server will send information on
the required BTS to the gateway upon every GSM module login, i.e. upon every
outgoing call.
BTS lock type – select the BTS type for GSM module locking:
Use the assignment table – the GSM modules will use the BTS as
specified in the table below the selection.
Use random available BTS for each call – a different, randomly
selected BTS with a signal level above the Minimum signal level value
will be used for each new outgoing call.
MCC+MNC – network code for the selected BTS Id.
BCCH Freq – BTS code.

Caution

The GSM group assignment settings affect the call routing process in the
GSM gateway connected. Therefore, leave the default parameters
unchanged if in doubts.
If BTS is set incorrectly, the GSM module will be blocked and unable to
log in to GSM/UMTS!

Tip

We recommend you to use the 2N ® BTS Lock SW for finding the BTS Id.
Connect the SW to a remote GSM gateway using the Telnet protocol
and display the available BTS. Refer to the Management / GW & SB/SC
firmware / Support files menu for this utility.

2N TELEKOMUNIKACE a.s., www.2n.cz 74/147

Overview Table
The section provides a table overview of all available GSM groups.

Columns

Id – shows a unique identification number for each GSM group in 2N ® SIM

Star Server.
Description – describes the GSM group for easier identification. The
descriptions may be identical for variable GSM groups.
Functions

View – displays current information on the selected GSM group

Edit – helps modify all the parameters mentioned in the

Add GSM – Group section.

Remove – deletes a GSM group from the 2N ® SIM Star Server

configuration.

Copy – copy settings of selected GSM group to new one.

Multiselection – use this button to select a higher number of items for a

global change.

Buttons
Select all – push the button to mark all the GSM groups at once.
Unselect all – push the button to cancel the Select all function.
Remove selected – push the button to remove the GSM groups from
configuration that are selected in the last overview table row.

2N TELEKOMUNIKACE a.s., www.2n.cz 75/147

3.6 GSM Menu
The menu is used for GSM channel administration. You can add, remove and edit the
GSM modules and view the SIM cards assigned to them.

Add GSM

Tip

Dark grey column indicates columns with changeable content. By

clicking on it you can change content of table.

The GSM channel is always associated with a gateway and its GSM module. To add a
GSM channel use the Add item in the overview table, which is available to unassigned
modules only.

General info
GSM group – define a GSM group for the GSM channel to be assigned to. It
is unnecessary to select a GSM group.
Remark – describe the GSM channel for easier orientation in the
configuration.
Disabled – disable the module use temporarily.
Set delayed disabling – set delayed module disable/enable. Click the
Edit selected icon below the GSMs table to access the menu. View
the setting in the View menu at the Disabled item, where the current
delay is included in brackets: Disabled: yes (delay 10 seconds), e.g.
Set randomly in range 1-3600 (sec) – set random module
disable/enable within a range.
Set with step 1-300 (sec) – set module disable/enable in steps.
Unset actual delay – cancel the set delay.
Use local SIM card – enable the use of a local SIM card in the GSM/UMTS
gateway.

Caution

The local SIM card is fully controlled by the GSM/UMTS

gateway and thus cannot be affected by the below
mentioned parameters.

2N TELEKOMUNIKACE a.s., www.2n.cz 76/147

 SIM card testing – use this option to switch the GSM channel into the SIM
card testing mode. In this mode, no restrictions apply to the SIM card. The
testing modules are marked green in the listing.
Clear ASR – delete the ASR records on the selected module.
Clear ACD – delete the ACD records on the selected module.

Traffic control
Deny outgoing call – bar outgoing calls via the selected module.
Deny outgoing SMS – bar outgoing SMS via the selected module.

Tip

The testing modules are marked green in the overview.

This option is recommended for manual SIM card testing by the 2N ® SIM
Star system service staff (credit, voice quality, etc.).

Hard linked SIM – the section enables fixed assignment of a SIM card to the
selected gateway GSM module.
Select SIM Board – select the SIM Board where the selected SIM card is
located.
Select SIM card – select a SIM card from the selected SIM Board.

Overview Table
The section provides a table overview of all available GSM channels.

Columns

Id – shows a unique identification number for each GSM channel in 2N ®

SIM Star Server.
Channel – shows the number of the GSM gateway channel for easier
identification.
Group – shows assignment to a GSM group.
Status – displays the current GSM channel status.
IMEI sup. – shows whether the selected channel supports IMEI change or
not.
BTS lock – shows whether the selected channel supports BTS lock
function.
Actual SIM – displays the SIM card currently assigned to the GSM module.
Hard SIM – provides information on hard SIM card assignment to the GSM
module.

2N TELEKOMUNIKACE a.s., www.2n.cz 77/147

 Remark – a note related to the selected GSM module.
Disabled – disables the GSM module use temporarily.
Functions

View – displays current information on the selected GSM channel (see

below).

Edit – helps modify all the parameters mentioned in the

Add – GSM Group section.

Remove – deletes the selected GSM channel. After removal, the channel
will be marked as unused.

Action menu – select one of the following actions:

Reset – restart the selected GSM/UMTS module;
Unlog – log the SIM card out of the selected GSM/UMTS module.
Initiate recharging of SIM now – set manual recharging of the SIM
logged in to the selected module.
Initiate (1st–6th) activation of SIM now – set manual activation of the
SIM logged in to the selected module.
Buttons
Select all – push the button to mark all the GSM channels at once.
Unselect all – push the button to cancel the Select all function.
Select GSM with given status – an extended option for mass marking of
GSM channels in a specific status. The status is selected in the field next to
this item.
Unselect GSMs with given status – an extended option for cancelling of
mass marking of GSM channels in a specific status. The status is selected in
the field next to this item.
Edit selected – push the button to edit the selected GSM modules.
Remove selected – push the button to delete the assignments of the
selected GSM channels.
Unlink SIMs from selected GSMs – push the button to cancel the SIM hard
assignment.
Reset selected – push the button to restart the selected GSM channels.
Add selected with default settings – push the button to add all the
selected GSM channels with default settings.
Add selected ignoring default settings – push the button to set the basic
parameters as described in the Add GSM section before mass adding.

2N TELEKOMUNIKACE a.s., www.2n.cz 78/147

View GSM x
Click on to open the GSM module status page:

General info
Gateway – name and Id of the GSM gateway in which the selected GSM
/UMTS module is located.
Channel – Id of the channel assigned to the selected GSM/UMTS module.

GSM group – Id and name of the 2N ® SIM Star Server GSM group to which
the selected GSM module is assigned.
Remark – an optional user name for the GSM module.
Disabled – information on whether the GSM module is enabled/disabled for
pairing with SIM cards.
SIM card testing – information on whether or not the GSM module has
been switched into the testing mode.
Traffic control
Deny outgoing call – information on function use.
Deny outgoing SMS – information on function use.
GSM status info
Status – status of the selected GSM/UMTS module (red means an error).
Error – not used
Start flag – not used
IMEI change support – information on whether or not the selected module
supports the IMEI change (subject to licence).
BTS lock support – information on whether the selected module supports
the BTS lock (subject to licence).
Logged IMSI – IMSI of the currently logged-in SIM card.
Actual IMEI – current module IMEI.
Original IMEI – factory IMEI.
SIM type – type of the currently connected SIM card.
Call limit (min) – maximum count of called minutes for the SIM card
logged.
Call limit (count) – maximum count of calls for the SIM card logged.
SMS limit – maximum count of outgoing SMS for the SIM card logged.
Logged limit (min) – maximum SIM card login time.
Minimum credit – minimum SIM card credit for successful calls.
Call minutes – count of minutes already called.
Call count – count of outgoing calls already made.
Failed call count – count of unsuccessful calls.

2N TELEKOMUNIKACE a.s., www.2n.cz 79/147

 Failed successive calls – count of unsuccessful successive calls.
SMS count – count of outgoing SMS.
Failed SMS count – count of unsuccessfully sent SMS.
Failed successive SMS – count of unsuccessfully sent successive SMS.
Logged minutes – SIM card login time.
Current credit – current SIM card credit value.
Call duration sum – total call time.
AoC settings – AoC pulse settings.
BTS lock – BTS lock options: active, inactive, type.
BTS status – BTS lock status.
QoS of SIM connection – current communication state between the SIM card
(SIM Board) and the GSM module (SIM Client).
Send packets – count of successfully sent packets.
Repeated packets – count of packets that had to be sent repeatedly.
Received packets – count of successfully received packets.
Min resp. time (ms) – minimum time between packet sending and packet
receiving confirmation.
Max resp. time (ms) – maximum time between packet sending and packet
receiving confirmation.
Avg. resp. time (ms) – average time between packet sending and packet
receiving confirmation.

Caution

An excessively high number of repetitions and/or long response time

indicate a poor IP connection between the GSM gateway and the SIM
Board(s). A low QoS value may extend the SIM card logging time or
even block the SIM card login!

Assigned SIM card info – current information on the SIM card logged.
Actual SIM – IMSI of the currently assigned SIM card.
Hard assigned SIM – IMSI of the permanently assigned SIM card.
GSM call info – information on the state of call parameters:
Call status – current module status.
Channel from – number of the channel from which the call was transferred
to the GSM module (not used for VoIP calls).
Channel to – number of the GSM module within the GSM gateway.
Dial – called number.
Duration – active call time.

GSM signal info

2N TELEKOMUNIKACE a.s., www.2n.cz 80/147
 GSM signal info
Level – current signal level.
Network – Id of the network to which the GSM module is logged in.
ASR – information on the ASR module with the current and preceding SIM card.
ACD – information on the ACD module with the current and preceding SIM card.

Lookup info – current module status as viewed by 2N ® SIM Star Server.

Tip

The information included in the Lookup info menu can help you identify
and resolve the GSM module/SIM card assignment problems if any.
Lookup info is offered by both the GSM module and the SIM card.

Other Controls

Filter Views
Show gateway – filter the GSM channels according to their assignments to a
GSM gateway.
Show GSM group – filter the GSM channels according to their assignments to a
GSM channel group.
Show positions – filter the GSM channels according to the used/unused positions
in the GSM gateway.

View Table
This menu helps you choose how to view the selected GSM/UMTS modules and their
states.

Basic table – basic view as described above.

View calls of listed GSM – current list of calls via the selected GSM/UMTS
channels:
Call status – current call status of the GSM channel.
Channel from – the channel through which the call comes into the GSM
gateway.
Channel to – the channel through which the call goes out of the GSM
gateway.
Dial – called number.
Duration – duration of a call through the given GSM channel.

2N TELEKOMUNIKACE a.s., www.2n.cz 81/147

 View signal of listed GSM – digital and graphical view of the current signal
intensity and the name of the GSM/UMTS network where the selected module is
currently logged in.

ASR/ACD of listed GSMs – current ASR/ACD values for the selected GSM/UMTS
modules.
Information about logged SIM cards – a well-arranged list of current ASR/ ACD
values and SIM card credits / remaining minutes.

CDR (Call Data Records)

Transition to the CDR (Call Data Records) menu in the Logger menu in the 2N ® SIM
Star Server Management Menu section. For details refer to the Logger menu above.

2N TELEKOMUNIKACE a.s., www.2n.cz 82/147

3.7 SIM Boards Menu
The menu enables you to get an overview of the SIM Boards, add new SIM Boards and
modify the SIM Board settings.

Add SIM Board

Use this option to add another SIM Board manually.

General info
Description – the text is for easier identification of a SIM Board only.
SB network info

IP – local IP address of the SIM Board for 2N ® SIM Star Server – SIM Client
communication within one and the same or local network.
IP 2 – public IP address of the IP Router (if different from the local IP

address) for 2N ® SIM Star Server / SIM Client located in another IP

network.

AT port – the port to be used by 2N ® SIM Star Server for communication

with the SIM Board. The port is set to 1500 (TCP) by default but can be
changed in the SIM Board console menu when a serial link is used.
SIM base port – IP port of the first SIM card on the SIM Board (32nd SIM
uses the SIM base port + 31 = default 10031) for SIM Board - SIM Client
communication within one and the same IP network. This information is
essential for a correct SB – SC communication. To change the port range
for the virtual channels use the SIM Board console menu when a serial link
is used.

Caution

If the SIM Board is connected behind the IP Router, set a

correct IP port routing in the NAT table for the router:
SIM base port + 31 (default 10000–10031) for SIM card
communication;

AT port (default 1500) for SB-to- 2N ® SIM Star Server

communication.

SIM base port 2 – IP port of the first SIM card on the SIM Board (32nd SIM
uses the SIM base port + 31 = default 10031) for SIM Board - SIM Client
communication via another IP network.

User name and Password – the login data used for the SIM Board access.
2N TELEKOMUNIKACE a.s., www.2n.cz 83/147
 User name and Password – the login data used for the SIM Board access.
You can change them in the SIM Board console menu when a serial link is
used.
Update port – the port for automatic SIM Board firmware update. The SSH
protocol with default port 22 is used for update.
Update password – the password for automatic SIM Board firmware
update, which can be changed in the SIM Board console menu when a
serial link is used. The password default value is update.

SIM cards info

PIN – the SIM Board can also work with the SIM cards that request the PIN code.
In this case, an identical PIN must be set for all the SIM cards before their
module login. Such SIM cards are then assigned to the GSM gateway with a
disabled PIN request. If you want to use different PIN code for each SIM card,
please do not enter any PIN code to this parameter!
SIM cache – select the type of SIM card communication. If there are only UMTS
SIM cards (USIM) on the selected SIM Board, the recommended option in the
event of problems is UMTS only.
Do not change setting – retain the factory values from the SIM Board
setup.
GSM and UMTS – the GSM SIM card protocol is used and, if unsuccessful,
the UMTS protocol is used for SIM card initialisation.
GSM only – the GSM SIM card protocol is only used for SIM card
initialisation.
UMTS only – the UMTS SIM (USIM) card protocol is only used for SIM card
initialisation.
Turn cache off – select this option to debug SIM card initialisation. This
option disables all SB – SC protocol optimisations and sets higher data
flows between the systems!

Caution

Setting SIM cache to values other than the factory settings may result in
a higher error rate during SIM card login to GSM, or even a complete
communication failure!

New SIM default settings

Use default settings for new SIMs – use this option to enable the following
default parameters for adding SIM cards into the configuration.
SIM Group – the group of SIM cards to which the SIM card to be added will
be assigned. The setting can be changed any time in the future.
SIM type – a newly logged SIM card will be designated as a tariff or pre-
paid SIM.

2N TELEKOMUNIKACE a.s., www.2n.cz 84/147

 Free minutes – the default count of free minutes for a SIM card. When the
limit is exhausted, the SIM card is unable to log in. The default free minutes
can be set manually any time or automatically in the Refresh day
parameter in the SIM group configuration. If the parameter is set to 0, the
value defined in the SIM group should be used.

Free SMS – count of SMS messages to be sent via the SIM card.
Credit – the default SIM card credit. If the credit value is equal to or lower
than the defined SIM group limit, the SIM card will not be allowed to log in.
The credit value is refreshed during every network login and upon every
call end. Value 50001 means an unknown value, which will be recognised
upon the first SIM card login.
Remark – this parameter facilitates orientation in the SIM cards.
Disabled – disable the use of a specific SIM card temporarily.
Automatic SIM operations – enable automatic adding of SIM cards to the system
in the case of physical replacement on the SIM Board.
Remove changed – if no SIM card is found in the selected position, the last
known SIM in this position will be deleted from the SIM database.
Add inserted – any new SIM card found in the SB position will be
automatically added to the SIM database. The SIM values will correspond
with the New SIM default settings.
Remove with IMEI – when a SIM card is removed and subsequently
automatically deleted from the database (Remove changed), the paired
IMEI will be deleted too.
Assign free IMEI – any newly inserted SIM card will be assigned an IMEI if
available in the IMEI table.
Move IMEI – the current IMEI of the SIM card in position X will be
automatically paired with the newly inserted SIM card.

2N TELEKOMUNIKACE a.s., www.2n.cz 85/147

Overview Table
Columns

Id – shows a unique identification number for each SIM Board in 2N ® SIM

Star Server.
Description – the text is for easier SIM Board identification only. The
descriptions may be identical for variable SIM Boards.
SIM Board status – the current SIM Board connection status.

Tip

If a working gateway is designated as disconnected, check the IP

address, port and password settings in the SB network info sections.
Dark grey column indicates columns with changeable content. By
clicking on it you can change content of table

PIN – the PIN code to be used for SIM card login within a SIM Board.
Functions
SIM – a link to the SIM menu with the pre-set SIM card filter for the
selected SIM Board.

View – displays current information on the selected SIM Board. In

addition to the basic SIM Board login settings, it provides a survey of
software versions.

Edit – helps modify all the parameters mentioned in the

Add GSM – Group section.

Remove – removes a SIM Board from the 2N ® SIM Star Server

configuration.

Action menu – select one of the following actions:

Reconnect SB – manual restart of connection with the selected SIM
Board.
Buttons
Select all – push the button to mark all the SIM Boards at once.
Unselect all – push the button to cancel the Select all function.
Remove selected – push the button to remove all the SIM Boards selected
in the last overview table row.

2N TELEKOMUNIKACE a.s., www.2n.cz 86/147

Other Controls

Description Filter
The filter is used for searching SIM Boards according to the data included in the
Description field. Any part of the string can be used for searching. To cancel the filter,
click on Unset.

Component Detection
This is a link to the system component detecting menu. For details refer to the
Component Detection section.

2N TELEKOMUNIKACE a.s., www.2n.cz 87/147

3.8 SIM Groups Menu
The menu helps you add, edit and view the SIM groups.

Tip

Highlight the GSM/SIM groups by colour to make their listings clearer.

Create new GSM/SIM groups simply by copying an already established
group. Click on the button in the list of GSM/SIM groups.

Add SIM Group

Use this function to add new SIM groups to the configuration manually.

General info
Description – type a text to be used for easier orientation later in the
configuration.
Highlighting – select the user colour codes for easier group listing.
Gateway routing – set the outgoing/incoming group for the LCR table of the
GSM gateway whose modules are assigned to the selected GSM group. The
following priorities are respected:

1. SIM group (SIM card) setting;

2. GSM group (GSM module) setting;

3. User setting in the GSM gateway.

Outgoing group – select the outgoing group for the GSM gateway LCR
table.
Incoming group – select the incoming group for the GSM gateway LCR
table.

SIM card common settings

CLIR – enable/disable the Calling Line Identification Restriction. The
function must be supported by the mobile network provider. If Default is
selected, the network setting is used.

2N TELEKOMUNIKACE a.s., www.2n.cz 88/147

 Idle time (min) – set the SIM card idle time after the last use. To select a
random range, enter a higher value into the second field than into the first
one.

One call limit (sec) – set the maximum duration for an outgoing call via the
SIM card. If another, higher value is entered, the maximum call duration will
be random in the selected interval.
After call relax (sec) – set the time period during which no new call will be
connected after the end of a preceding call via the GSM/UMTS channel in
which the SIM card of this group is used. If another, higher value is entered,
the maximum call duration will be random in the selected interval.

Caution

An excessively high After call relax value may lower the ASR
values of the active channels/GSM gateways!

After fail relax (sec) – set the time period during which no new call will be
connected after the end of a preceding failed call via the GSM/UMTS
channel in which the SIM card of this group is used. If another, higher value
is entered, the maximum call duration will be random in the selected
interval.
Credit check delay (sec) – set a delay before credit check.
Outgoing traffic delay (sec) – set the outgoing call delay after SIM card
login.
Action wait (sec) – set the SIM activation/recharging timeout.
MCC+MNC – set the Network operator code. The parameter has a higher
priority than the local gateway settings.
Roaming – enter the code for the GSM/UMTS network for the GSM module
to log in if roaming is enabled. Symbols X and x are used a masking
character.
AoC interval – set the time interval between two AoC messages sent to the
ISDN interface in the event of a successfully connected outgoing call into
the GSM/UMTS network.
SMS timeout – set the SMS reply receiving timeout. The parameter is valid
for credit check and SIM activation/recharging.
Wait for call end – enable non–termination of a call after the defined SIM
limit expiry. If this option is not ticked off, calls are terminated immediately,
which prevents overdrawing of free minutes.
ALERTING required – enable termination of outgoing calls into the GSM
/UMTS networks in case the call is connected without a previous alerting
indication.

2N TELEKOMUNIKACE a.s., www.2n.cz 89/147

 One SIM usage limit – limit the SIM card use as follows:
One use limit (min) – set the maximum time for the SIM card login to one
module. After the expiry, the SIM card is logged out automatically. To
select a random range, enter a higher value into the second field than into
the first one.
Call count limit – set the maximum count of calls during one SIM card login
to one GSM module. To select a random range, enter a higher value into
the second field than into the first one.
Minutes count limit – set the maximum count of minutes called via one SIM
card. If another, higher value is entered, the maximum count of minutes will
be random in the selected interval.
SMS count limit – set the maximum count of sent SMS during one SIM card
login to one GSM module. To select a random range, enter a higher value
into the second field than into the first one
Limits for intervals of rules – limit the SIM card use to precisely defined time
intervals (1–8) in the Rules menu (refer to Subs. 3.11):
Minutes by first/next – enable/disable minute counting according to the
first/next count.
Call count limit – set the maximum count of calls made via one SIM card in
the selected interval.
Minutes count limit – set the maximum count of minutes called via one SIM
card in the selected time interval.
SMS count limit – set the maximum count of SMS messages sent via one
SIM card in the selected time interval.

Note

You can set ranges instead of exact values for some parameters to
improve the GSM gateway masking in the providers' networks. The SIM
cards that log out periodically can thus be detected more easily.

Tariff SIM card settings – this section helps you set the basic parameters for
tariff SIM cards.
Free minutes – the default count of free minutes for a SIM card. When the
limit is exhausted, the SIM card is unable to log in. The free minutes can be
refreshed manually any time or automatically using the Refresh day
parameter below. Each SIM card has a count of free minutes of its own,
which is preferred.
Refresh day – set a day in the month on which the free minutes are to be
refreshed as set above.
Free minutes req. – define whether or not the SIM card can be used even if
it contains no free minutes.

2N TELEKOMUNIKACE a.s., www.2n.cz 90/147

 Free SMSs – the default count of free SMS messages for a SIM card. When
the limit is exhausted, the SIM card is unable to log in. The free minutes can
be refreshed manually any time or automatically using the Refresh day
parameter below. Each SIM card has a count of free minutes of its own,
which is preferred

Refresh day (SMSs) – set a day in the month on which the free minutes are
to be refreshed as set above
Free SMSs req. – define whether or not the SIM card can be used even if it
contains no free SMS.
First count (sec) – set the minimum call length to define the minimum call
cost upon answering. The typical value is 60s.
Next count (sec) – set the interval after which the call is billed differently.
Typically, calls are billed per second after the first minute.
Free count (sec) – set the call duration not to be billed. This means that if
you hang up before the end of this timeout, the call cost will be zero.

Tariff SIM card – call tariffs settings – set free minutes within the 2N ® SIM Star
system if the connected device supports multi-tariffs (LCR based on the
outgoing group + call type /own network ; another network ; PSTN ; VPN group
/):
Free minutes – count of SIM free minutes for each tariff applied.
Transfer free minutes – maximum count of unused free minutes to be
transferred to the next tariff accounting period.
Free minutes req. – define whether or not the SIM card can be used even if
it contains no free minutes.
AOC interval (s) – set the time interval between two AoC messages sent to
the ISDN interface in the event of a successfully connected outgoing call
into the GSM/UMTS network.

Note

The Call tariffs function will only be active if the relevant GSM gateways
and their LCR tables are set properly!

Caution

The above mentioned settings relate to the internal pseudo-tariff

metering scheme and should meet the network provider's settings.
Otherwise the available amount of free minutes may be overdrawn and
the manufacturer shall not be held responsible for that.

2N TELEKOMUNIKACE a.s., www.2n.cz 91/147

 Prepaid SIM card settings – this section helps you set the basic parameters for
prepaid SIM cards.
Credit check – set the SIM card credit checking method.
The USSD method is based on sending the USSD code into the
network and readout from the USSD reply.
The SMS method is based on sending the SMS into the network and
readout from the SMS reply.
The USSD/SMS is based on sending the USSD code into the network
and readout from the SMS reply.
The Simulated method is based on the known initial state and proper
setting of the internal pseudo-tariff metering rules.
USSD & Simulated / SMS & Simulated / USSD/SMS & Simulated – is a
combination of the above-mentioned two methods. The current SIM

card credit is, upon the first check, estimated by 2N ® SIM Star Server
using the following parameters
Con. Count
First count
Next count
Free count
Cost of call est.
Cost of 1 minute
Cost of 1 SMS

A low credit SIM card is recharged virtually with the value included in the Recharged
value parameter. When the maximum recharging count is achieved (Max rech. count),
the calculated credit value is compared with the real value (USSD query). If there is a
difference, the calculated value is overwritten with the value obtained from the GSM
/UMTS network. In case the difference is x%, the SIM card can be blocked using the
Blocked SIM card detection / Incorrect plan (%) parameter to draw attention to
incorrect settings.

Prepaid check code – USSD code to be used for SIM card credit state
identification. Used for the USSD method only.
Send SMS dial – telephone number for SMS sending. Used for the SMS
credit check method.
Send SMS text – SMS text to be sent. Used for the SMS credit check
method.
Recv SMS clip – SMS reply CLIP. Used for the SMS and USSD/SMS credit
check methods.
Recv SMS substring – check string to be included in the SMS reply. Used
for the SMS and USSD/SMS credit check methods.

2N TELEKOMUNIKACE a.s., www.2n.cz 92/147

 Credit position – the parameter defines the credit value position in the
USSD response from the GSM/UMTS network.
Characters from begin – the credit value record should be searched
in a position located X characters from the response beginning.
Characters from end – the credit value record should be searched in
a position located X characters from the response end.
After string – the credit value record should be searched after the
defined string in the response.
Use external script – possibility to use external custom script file to
decode USSD answer from network. For details please check chapter
4.7 on page .
Use credit 2 – this parameter is used when a response includes two credit
counters (Normal and Bonus account, e.g.), or the credit value is in two
different USSD responses:
Unused – disable the function.
Alternative – if the main credit value is not found, the system checks
an alternative position for the credit value.
Add to first – the credit values are added up.
Credit 2 position – the setting corresponds with that in the Credit position
parameter.
USSD call info – enable this parameter if the GSM/UMTS network sends the
credit value/call cost automatically after the call end.
None – disable the function.
Credit value – the network will automatically send a USSD message
including the current credit value after the call end.
Call cost – the network will automatically send a USSD message
including the call cost after the call end.
Cr. pos. in call info – set the position of the credit value/call cost in the
message received. The setting corresponds with that in the Credit position
parameter.
Use cr. 2 in call info – use this parameter in case the USSD info message
includes two credit values.
Cr. pos. 2 in call info – the setting corresponds with that in the Credit
position parameter.
Sep. for thousands – define the separator for thousands for the credit value
message if necessary.
Sep. for decimals – enter the separator of decimals if other than a point (.)
or a comma (,).
Minus string – set the text string denoting a negative credit value. The text
string must be the last string before the detected credit value to make the
parameter work. The credit that is detected as negative is set to 0. Do not
use the space, quote and comma characters.
Skip login cr. check – enable this parameter to disable credit info upon the
SIM card login (credit info will be checked upon call end only if set so).

Credit recheck (min) – by default (0), the credit is checked by the USSD
2N TELEKOMUNIKACE a.s., www.2n.cz 93/147
 Credit recheck (min) – by default (0), the credit is checked by the USSD
command upon every call end. In some networks, however, credit state
requesting is subject to charge and may lead to unintentional additional
costs. This credit reading parameter thus cannot be used until a certain
count of free minutes is exhausted. Used for the USSD method only.
Credit recheck (SMS) – by default (0), the credit is not checked by the
USSD command upon every SMS sent. In some networks, however, credit
state requesting is subject to charge and may lead to unintentional
additional costs. This credit reading parameter thus cannot be used until a
certain count of free minutes is exhausted. Used for the USSD method
only.
Free minutes activation – select the SIM activation for free minute
recharging.
Free minutes – set the count of free minutes available after activation.
Active minutes again – set repeating of free minute activation after
exhausting.
Free minutes request – disable the SIM that has no free minutes.
Free SMS activation – select the SIM activation for free SMS recharging.
Free SMS – set the count of free SMS available after activation.
Active SMS again – set repeating of free SMS activation after exhausting.
Free SMS request – disable the SIM that has no free SMS.
Con. count (sec) – set the call setup cost.
First count (sec) – set the minimum call length to define the minimum call
cost upon answering. The typical value is 60s. Used for the Simulated
method only.
Next count (sec) – set the interval after which the call is billed differently.
Typically, calls are billed per second after the first minute. Used for the
Simulated method only.
Free count (sec) – set the call duration not to be billed. This means that if
you hang up before the end of this timeout, the call cost will be zero. Used
for the Simulated method only.
Cost of call est. – set the call setup cost. Used for the Simulated method
only.
Cost of 1 minute – set the 1 minute call cost. Used for the Simulated
method only.
Cost of 1 SMS – set the one sent SMS cost. Used for the Simulated method
only.
Recharged value – set the credit value to be added to the current SIM card
credit value after recharging. Used for the Simulated method only.
Max recharge count – set the maximum automatic credit recharging
requests before the manual check is required. Used for the Simulated
method only.
Low credit – set the minimum acceptable SIM card credit value. When this
limit is achieved, the SIM card is disallowed to log in.

2N TELEKOMUNIKACE a.s., www.2n.cz 94/147

 Use off-peak low credit – the SIM card low credit may be different for the
peak time intervals (Low credit) and off peak time due to different call
costs and credit use efficiency levels:
Never – disable the function.
Whole week at time – enable the function for defined intervals on
workdays.
Weekdays at time – enable the function for defined intervals at
weekends.
All weekend only – enable the function for weekends only.
All weekend and weekdays at time – enable the function for defined
intervals on all weekdays.
Off-peak low credit – set the minimum acceptable SIM card credit value at
off–peak intervals. When this limit is achieved, the SIM card is disallowed to
log in.
Prepaid SIM card recharge settings – this section helps you set the recharge
parameters for prepaid SIM cards.
Recharge SIM group – to share recharging codes from multiple SIM groups,
select a code-containing SIM group here. Its recharge codes will
automatically be used for SIM card recharging as necessary.
Type – define the recharging method for your prepaid SIM cards:
USSD – send the USSD code including the recharge code.
SMS – send an SMS including the recharge code.
IVR – dial a DTMF code including the recharge code (the provider's
IVR line call).
CALL – dial the defined number to recharge the SIM card.
Number– define the number to be used for recharge of prepaid SIM cards
for the variable recharging methods:
USSD – is inapplicable.
SMS – enter the SMS destination.
IVR – enter the number to be dialled.
CALL – is inapplicable.
String – enter a prepaid SIM card recharge string for each recharging
method:
USSD – enter the sending code.
SMS – enter the recharging SMS text.

2N TELEKOMUNIKACE a.s., www.2n.cz 95/147

 IVR, CALL – enter the tone sequence to be dialled and delay as
follows:

String Meaning

%% char %

%c Assigned recharge code

%n SIM card phone number

p 1s delay

P 2s delay

w 5s delay

W 10s delay

(x,y) x = length of DTMF tone (sec/10), default is 1 (100ms);

y = length of space between two DTMF tones (sec/10), default is 5 (500ms)*

*#0123456789 DTMF codes

*this parameter is optional

USSD test – set the text to be checked for match with the USSD response.
If the response does not include this text, recharging is considered
unsuccessful.
Avoid call connect – means "do not wait for call connection". Use the
parameter for Call recharging too.
Wait for call ended – means "wait for call termination by the called party".
Use the parameter for Call recharging too.
Recharge tries – maximum count of attempts to recharge the SIM card
with a new credit value.
Recharge idle time (min) – set the time after which the SIM card relogs in
for credit recharge.
Timeout (min) – set the waiting time for credit recharge after sending the
recharge request before the credit value identifying attempt is made.
Typically, providers need one minute or even more to process the request.
If it is find out that your credit has not been recharged, the recharge code
is marked as erroneous and removed.

2N TELEKOMUNIKACE a.s., www.2n.cz 96/147

 Auto recharging – enable automatic assignment of the recharge codes of
this group to the SIM cards of this group whenever the credit value falls
under the defined limit.

Max. rech. count – set the maximum count of automatic count of

rechargings when the value drops below the threshold.
Recharge day – the day in a month for automatic SIM card recharging.
Keep logged after recharge – the GSM module will not be reset after SIM
card recharging.
Keep logged for recharge – recharge before SIM logout if possible.
Distributed rech. [min] – set recharging delay for SIM cards assigned to the
SIM group. Just one SIM card can be recharged in this time interval.
Recharge period day – set the day on which a new period of recharging
counters begins. Refer to the View / SIM statistics menu in each SIM group
for the total and selected period counts of recharging.
1st – 8th SIM card activation settings – new SIM cards may have to be activated

before use. 2N ® SIM Star supports such automatic activation.|

Tip

You can utilise the SIM card activation process for a variety of
special call cost discounts (for example, send an SMS to call free
for one week at the cost of €xx only).

Type – select the type of SIM card activation:

USSD – using a USSD command;
SMS – by sending an SMS message;
IVR – by dialling the IVR service.
Number – enter the number for SMS sending, or the IVR service access
code.
String – enter the USSD activation string / activation SMS text / DTMF
sequence for IVR.
Activation tries – set the count of activation attempts in the case of failure.
Act. idle time (min) – the SIM card will be put out of operation after
recharging for a certain period of time as programmed in the Idle time
parameter.

Activate new SIMs – every new SIM card inserted in 2N ® SIM Star will be
activated automatically.
Act. recharged SIMs – any new pre-paid SIM card recharged with a new
credit value will be activated automatically.
Activation day – the SIM card will be activated in regular intervals.

Activation hours – repeat activation after the preset hours elapse after the
2N TELEKOMUNIKACE a.s., www.2n.cz 97/147
 Activation hours – repeat activation after the preset hours elapse after the
last successful activation.
Minimal credit – set the minimum credit value in case the SIM card
activation is paid.
Prefer to rech – prefer activation to recharging in the event of concurrent
requests.
Keep logged after activation – GSM module will not be reset after
activation of a SIM card.
Keep logged for activation – activation before SIM logout if possible.
Ignore failure – enable the SIM card use even after an invalid activation.

SIM card activation plan

Distributed activation (min) – set the delay between SIM card activations.
This feature helps hide massive SIM card activations in the GSM network.

Note

After SIM activation, new Last login and Last logout records are
generated in the SIMs / SIM view menu to ensure a correct function of
the SIM limits. At the same time, a record on the last use of the gateway
is stored in the Last gateways section.

Phone number detection - Possibility to read SIM card's phone number from the
USSD reply. This number will be saved to SIM card details and used for call/SMS
simulation calls.
Detection from – select which phone number detection will be used.
SIM – define SIM phone number detection from SIM card .

Make sure that the SIM phone number detection is

supported by your mobile service provider.

USSD activation 1-8 – select a USSD activation for phone number

detection. The number will be found according to the Phone position
setting in the subsequent USSD response.
SMS – define SIM phone number detection via SMS. Make sure that a valid
phone number is set for one SIM card at least and that the SMS phone
number detection is enabled in the Gateways section for the detection
performing gateway to make the SMS-based number detection work
properly.

2N TELEKOMUNIKACE a.s., www.2n.cz 98/147

 Caution

Make sure that the messaging service is enabled for the GSM
/UMTS gateway used for phone number detection.
Messaging is a licensed function.

Phone position – define the position of the SIM phone number in the USSD
reply.
Prefix change – replace / add call prefix to the phone number which was
received in the USSD reply.
Maximum SMSs at once – maximum number of SMSs for each time interval
(0= unlimited).
SMS delay (min) – minimum delay between two SMSs for each time
interval. The parameter is valid for a SIM group.
SMS delay SIM (min) – minimum delay between two SMSs for each time
interval. The parameter is valid for each SIM card.

Blocked SIM card detection – this section helps you set the parameters related
to identification of blocked or inoperative SIM cards.
Failed calls – set the count of unsuccessful calls in a sequence. When this

limit is achieved, the SIM card will be blocked by 2N ® SIM Star Server.
Failed calls retries – set the count of retries for unsuccessful calls. If the
parameter is enabled, the SIM is logged out after every failed call sequence

and automatically blocked by 2N ® SIM Star Server after the last sequence.
Short calls – set the count of short calls in a sequence. When this limit is

achieved, the SIM card will be blocked by 2N ® SIM Star Server.

Short calls retries – set the count of retries for short calls. If the parameter
is enabled, the SIM is logged out after every short call sequence and

automatically blocked by 2N ® SIM Star Server after the last sequence.

Short call length [s] – set the short call upper limit. Calls shorter than the
value set in this parameter will be regarded as short.
Failed SMSs – set the count of not sent SMS in a sequence. When this limit

is achieved, the SIM card will be blocked by 2N ® SIM Star Server.

Failed SMSs retries – set the count of retries for failed SMSs. If the
parameter is enabled, the SIM is logged out after every failed SMS

sequence and automatically blocked by 2N ® SIM Star Server after the last
sequence.

2N TELEKOMUNIKACE a.s., www.2n.cz 99/147

 Failed logins – set the count of unsuccessful logins. When this limit is

achieved, the SIM card will be blocked by 2N ® SIM Star Server.

Failed credit checks – set the count of unsuccessful credit checks. When

this limit is achieved, the SIM card will be blocked by 2N ® SIM Star Server.
Failed rechargings – set the count of unsuccessful credit rechargings.

When this limit is achieved, the SIM card will be blocked by 2N ® SIM Star
Server.
Registration error – block the SIM card whenever a registration error is
detected.
Incorrect plan – if there is a difference between the simulated and real SIM
card credit values higher than as defined (%) at the moment of check, the
SIM card will be blocked automatically.
Retry idle time (min) – set the SIM card relogin timeout before the next
sequence retry if the Failed calls retries, Short call retries or Failed SMSs
retries parameters are used.
ASR threshold [%] – set a value whose exceeding will lead to automatic

SIM card blocking by 2N ® SIM Star Server.

ACD threshold [s] – set a value whose exceeding will lead to automatic

SIM card blocking by 2N ® SIM Star Server.

Min calls for ASR/ACD – define the minimum count of calls necessary for
SIM card blocking based on the ASR/ACD values.

Note

Refer to the Lookup info parameter in the SIM card status for the cause
of SIM blocking.

Tip

Information on a blocked SIM card can be displayed on the 2N ® SIM Star

Server introductory page or automatically sent as an alert e-mail
message.

IMEI assignment
Associated group – possibility to merge one IMEI group with another. The
settings from the assigned IMEI group will be used.

IMEI begin filter – define begin of IMEI for limited selection.

2N TELEKOMUNIKACE a.s., www.2n.cz 100/147
 IMEI begin filter – define begin of IMEI for limited selection.
Remark filter – define part of remark for limited selection.
Call simulation - The call simulator provides automatic generation of outgoing
/incoming calls. With this function activated, the system automatically
(according to the predefined rules) sets up calls between the wireless modules
/gateways.
Simulator – call simulation mode:
Off – the feature is disabled.
Simulation between own SIM card – calls will be limited only on
active SIM cards which are assigned to the SIM group.
Use external recipients – dialled numbers will be used from the
defined list of external recipients.
Own SIM cards / external recipients [ X / Y ] – define a combination
of call simulation between internal SIMs and external recipients. The [
X / Y ] value represents a long-time simulation ratio.
Simulation associated with another SIM group – possibility to merge
one SIM group with another (calls within more SIM groups). The
settings from the assigned SIM group will be used.
Associated group – name of the master SIM group.
Use in time x – time intervals for activation of call simulations.
Maximum calls at once – maximum number of calls for each time interval
(0= unlimited).
Call delay (min) – minimum delay between two calls for each time interval.
The parameter is valid for a SIM group.
Call delay SIM (min) – minimum delay between two SMS for each time
interval. The parameter is valid for each SIM card.
Answer calls (%) – Percentage (%) of answered calls. The other calls
remain unanswered – only ring).
Ring time (s) – time duration of the call ringing state before call answer
/call end.
Call time (s) – time duration of connected calls.
External recipients – list of external called party numbers separated with
semicolons. The '?' character is used for a random digit (0–9). E.g.: for
string 800??????, the CPNs will be 800000000 – 800999999 (random
digit for each position).

2N TELEKOMUNIKACE a.s., www.2n.cz 101/147

 SMS simulation - The SMS simulator provides automatic generation of outgoing
/incoming SMS. With this function activated, the system automatically
(according to the predefined rules) sets up SMS between the wireless modules
/gateways.
Simulator – SMS simulation mode:
Off – the feature is disabled.
Simulation between own SIM card – SMSs will be limited only on
active SIM cards which are assigned to the SIM group.
Use external recipients – dialled numbers will be used from the
defined list of external recipients.
Own SIM cards / external recipients [ X / Y ] – define a combination
of SMS simulation between internal SIMs and external recipients. The
[ X / Y ] value represents a long–time simulation ratio.
Simulation associated with another SIM group – possibility to merge
one SIM group with another (SMS within more SIM groups). The
settings from the assigned SIM group will be used.
Associated group – name of the master SIM group.
Use in time x – time intervals for activation of SMS simulations.
Maximum SMSs at once – maximum number of SMSs for each time interval
(0= unlimited).
SMS delay (min) – minimum delay between two SMSs for each time
interval. The parameter is valid for a SIM group.
SMS delay SIM (min) – minimum delay between two SMSs for each time
interval. The parameter is valid for each SIM card.
External recipients – list of external called party numbers separated with
semicolons. The '?' character is used for a random digit (0–9). E.g.: for
string 800??????, the CPNs will be 800000000–800999999 (random digit
for each position).

Data simulations - The Data simulator provides automatic generation of data

traffic. With this function activated, the system automatically (according to the
predefined rules) sets up data traffic on the wireless modules/gateways.
Simulator – data simulation mode:
Off – disabled.
Use defined links – dialled numbers will be used from the defined list
of external recipients.
Simulation associated with another SIM group – possibility to merge
one SIM group with another (SMS within more SIM groups). The
settings from the assigned SIM group will be used.
Associated group – name of the master SIM group.
Use in time x – time intervals for activation of SMS simulations.
Maximum conns at once – maximum number of data connection for each
time interval (0= unlimited).

2N TELEKOMUNIKACE a.s., www.2n.cz 102/147

 Conn delay (min) – minimum delay between two data connections for each
time interval. The parameter is valid for a SIM group.

Conn delay SIM (min) – minimum delay between two data connections for
each time interval. The parameter is valid for each SIM card.
Links – list of web links or IP address separated with semicolons e.g. www.
google.com;www.yahoo.com.
APN – Access Point Name.
APN user – access username.
APN password – access password.

Caution

Assign the number of GSM channels used for all the simulators in the
Gateways / Edit gateway / Call simulation / SMS simulation / Data
simulation menu to make call/SMS/Data simulation work efficiently.
Set the phone number for each SIM either manually in the SIMs / SIM edit
section or by downloading the number database in the SIMs / Action
menu.
Make sure that the messaging service is enabled for the GSM/UMTS
gateway used for SMS simulation. Messaging is a licensed function.

Caution

Keep in mind that frequent SIM card changing reduces the maximum
count of active GSM/UMTS channels. In case your SIP Proxy is not set to
new call forwarding, the ASR parameters of the solution are reduced
dramatically in the event of rejection of connection request by the GSM
gateway!

Overview Table
The section provides a table overview of the SIM groups.

Columns

Id – shows a unique identification number for each SIM group in 2N ® SIM

Star Server.
Description – text for easier SIM group identification. The descriptions may
be identical for variable SIM groups.
Recharging – link to the recharging code table.

View – current information on the selected SIM group.

2N TELEKOMUNIKACE a.s., www.2n.cz 103/147

 Edit – modify all the parameters mentioned on the selected SIM group.

– add a GSM group in the SIM group section.

Action menu – select one of the following actions

Manage recharge codes – set the recharging codes.
Download custom SMS texts for simulation – download the currently
used own texts for SMS simulation. If default SMS texts are used, the
downloaded file will be empty.
Upload custom SMS texts for simulation – record own SMS texts for
SMS simulation.
Remove custom SMS texts for simulation – remove the own SMS
texts used for SMS simulation. Default SMS texts will be used for SMS
simulation after removal.

Caution

You can upload custom SMS texts for simulation in text-

based file where each SMS text is on one line. Texts are
limited to 160 characters. Maximal count of accepted texts is
1000. If you do not have custom SMS texts for simulation
uploaded, randomly generated English texts are used.

Remove – remove a SIM group from the 2N ® SIM Star Server

configuration.

Copy – create a new SIM group by copying an already configured SIM

group.

Buttons
Select all – push the button to mark all the SIM groups at once.
Unselect all – push the button to cancel the Select all function.
Remove selected – push the button to remove all the SIM groups from
configuration that are selected in the last overview table row.

Manage Recharge Codes

Tip

The recharging codes of the selected SIM group can be shared by other
SIM groups. Refer to the SIM group settings for details.

Show SIM group – use this option to display the recharge codes for the selected
SIM groups.

2N TELEKOMUNIKACE a.s., www.2n.cz 104/147

 Add recharge code – use this option to manually add a new
recharge code. To do so, enter the following parameters:
SIM group – define the SIM groups to use the recharge code.
Recharge code – enter the recharge code.
Remark – a note on the recharge codes.
Import recharge codes from file – you can import the recharge codes from any
text file, where they are separated with one or more characters (excluding
digits). For example, csv or txt are suitable formats.
SIM group – define the SIM group to use the recharge codes imported.
Remark – a note on the recharge codes.
File – a section for the recharge code file location. To confirm the import,
click on Ok. If a recharge code was added before (regardless of the
group), it will not be added to the configuration.

Overview Table
The section provides a table overview of all the recharge codes.

Columns

Id – shows a unique identification number for each recharge code in 2N ®

SIM Star Server.
Recharge code – the recharge code.
Remark – a note on the recharge code.
Status – the recharge code status (new, used, ...).
Assigned to SIM – the SIM card for which the recharge code was used. The
column is completed after the recharge code is used.

Functions
View – display complete information on the recharge code including the
last recharge time.
Edit – edit the recharge code items as described in the recharge code
adding section. Moreover, an option is available to re–designate a recharge
code as new (Set as new).
Remove – remove a selected recharge code from configuration.
Buttons
Select all – push the button to mark all the displayed recharge codes at
once.
Unselect all – cancel the Select all function.
Select codes with given status – an extended option for mass marking of
the recharge codes that are in the status selected in the field next to this
item.

2N TELEKOMUNIKACE a.s., www.2n.cz 105/147

 Unselect codes with given status – an extended option for cancelling mass
marking of the recharge codes that are in the status selected in the field
next to this item.

Edit selected – edit all the recharge codes that are selected in the last
overview table row. You can edit assignment to group, add a note and set
the recharge code as new only.
Remove selected – remove all the recharge codes from configuration that
are selected in the last overview table row.

Manage Custom Phone Number Lists

Manage list - select a phone number list.

Manage
Download - download the current phone number database.
Remove - remove the current phone number database.
Upload - upload data from a selected file to the phone number database.

Phone Numbers
List of phone numbers stored in the selected database.

Simulation Status
Display the current status of the Virtual call/SMS/Data simulation.

Caution

Make sure that the SIM phone number detection is supported by your
mobile service provider.

2N TELEKOMUNIKACE a.s., www.2n.cz 106/147

3.9 SIM Menu
The menu is used for SIM card administration. You can add, remove and edit the SIM
cards and view the SIM card assignments.

Overview Table
This subsection provides a table overview of the SIM cards.

Columns
IMSI – displays the SIM card IMSI. IMSI is a unique SIM card identifier not

only within 2N ® SIM Star Server but also within the GSM provider's
network.
Channel – determines a channel in the SIM Board and corresponds to the
position in which the SIM card is mounted.
Group – determines the SIM group to which the SIM card is assigned.
Status – displays the current SIM card status.
Assigned to – displays the Id of the GSM gateway and GSM channel to
which the SIM card is assigned.
Hard linked – displays information on the fixed assignment to a GSM
channel.
IMEI – specifies whether or not the SIM card is linked with an IMEI.
Type – defines the SIM card type (tariff or prepaid).
Remark – adds a note to the SIM card.
Disabled – specifies whether or not the SIM card is removed from use.
Blocked – informs whether or not the SIM card has been blocked
automatically against further use.

2N TELEKOMUNIKACE a.s., www.2n.cz 107/147

 Functions

View – displays complete information on the SIM card.

Edit – helps modify all the SIM card parameters.

Remove – removes the selected SIM card from system.

Action menu – select one of the following actions:

Reset – launches initialisation of a SIM card on the SIM Board;
Reset with PIN deactivation – cancel the PIN code request.
Recharge – recharges the selected SIM card;
Link SIM to GSM – manual connection (hard link) of the selected SIM
card with any GSM/UMTS module;
Link SIM to testing GSM – manual connection (hard link) of the
selected SIM card with any GSM/UMTS module in the SIM card testing
mode – refer to Subs 3.9;
Unlink SIM from GSM – disable the hard link with the defined GSM
/UMTS module;
Set ignore time now – bypass the idle time of the selected SIM card;
Unset ignore time now – deactivate the preceding selection.

Buttons
Select all – push the button to mark all the SIM cards at once.
Unselect all – push the button to cancel the Select all function.
Select SIM with given status – an extended option for mass marking of SIM
cards in a specific status. The status is selected in the field next to this
item.
Unselect SIM with given status – an extended option for cancellation of
mass marking of SIM cards in a specific status. The status is selected in the
field next to this item.
Edit selected – push the button to edit the selected SIM cards.
Remove selected – push the button to cancel assignments of the selected
SIM cards.
Unlink selected SIMs from GSMs – push the button to cancel the SIM hard
assignment.
Reset selected – push the button to launch initialisation of all the selected
SIM cards.
Reset selected with PIN deactivation – push the button to cancel the PIN
code request for the selected SIM cards.
Recharge selected – push the button to recharge the selected SIM cards
manually.
Add selected with default settings – push the button to add all the
selected SIM cards with the default settings.

2N TELEKOMUNIKACE a.s., www.2n.cz 108/147

 Add selected ignoring default settings – push the button to set the basic
parameters before adding the selected SIM cards.

Table Menu
Basic table – standard view of the SIM card table (see above).
Tariff details of listed SIMs – table including details on the last SIM card login
/logout into/from the GSM network and the current count of free minutes/SMS.
Prepaid detail of listed SIMs – table including details on the last SIM card login
/logout into/from the GSM network and the current SIM credit value.
ASR, ACD of SIMs – table including ASR and ACD values for each SIM card.
Recharging status of listed SIMs – table including details on the last recharging
for each SIM card.
1st and 8th activation status of listed SIMs – table including activation details for
each SIM card.
All activation statuses of listed SIMs – table including a global overview of all
activation statuses.
Lookup info of listed SIMs – table including current SIM card status details.
SCID and phone numbers of listed SIMs

Tip

We recommend you to use the Lookup info view to get a clear overview
of the SIM cards blocked.

Action Menu
Used for import/export of additional data related to SIM cards. Each imported file
must have the .csv format and the maximum of 320 items. The records whose IMSI

/SCID codes fail to match any SIM card in 2N ® SIM Star Server will not be received
and stored in the database.

Import IMSI/Phone assignments from file

Export IMSI/Phone assignments to file
Import SCID/Phone assignments from file
Export SCID/Phone assignments to file
Load SCID/PIN list from file

2N TELEKOMUNIKACE a.s., www.2n.cz 109/147

Other Controls

Filter View
Show SIM Board – filter the SIM cards according to their assignments to a SIM
Board.
Show SIM group – filter the SIM cards according to their assignments to a SIM
group.
Show position – filter the SIM cards according to the used/unused positions in
the SIM Board.

View Details of Listed SIM

The section provides a table overview of the SIM card details.

Columns – The meanings of the first five table columns correspond to those
included in the Overview Table. The other six columns are as follows:
Last login – displays the last SIM card login time.
Last logout – displays the last SIM card logout time.
Type – specifies the SIM card type (tariff or prepaid).
Free mins – displays the count of free minutes for the given period.
Current free mins – displays the count of remaining free minutes. Clearing
obeys the Refresh day parameter.
Current credit – displays the remaining credit for the prepaid SIM cards.
Set the USSD or Simulated credit finding method to make this parameter
work properly.

View Lookup Info and Phone Numbers of Listed SIM

The section provides a table overview of the SIM card details.

Columns – The meanings of the first five table columns correspond to those
included in the Overview Table. The other six columns are as follows:
Phone number – is the SIM card phone number.
Lookup info – provides current information on the SIM card status: whether
the SIM card is ready to use, used by a module or unavailable for some
reason.

View ASR and Block Listed SIM

The section helps you monitor the call traffic via each SIM card. The information is
updated upon every SIM card login.

2N TELEKOMUNIKACE a.s., www.2n.cz 110/147

The menu provides an overview table for SIM cards with the filtering option according
to the SIM Board and SIM group assignments and positions. The meanings of the first
five table columns correspond to those included in the Overview Table. The other
columns are as follows:

Total SIM usage ASR – displays the total Answer Seizure Ratio for the given SIM
card.
Last SIM usage ASR – displays the Answer Seizure Ratio for the given SIM card
during its last login.

The ASR viewing columns are divided into two parts. The first part displays the ASR
percentage plus the counts of all and successful calls. The other column expresses the
ASR graphically. Successful calls are green and unsuccessful ones are red. For a view
of these statistical data see the figure below.

Blocked – defines whether or not the SIM card is blocked against use. The
blocking function depends on the Blocked SIM card detection settings in the SIM
Groups menu. The SIM card gets blocked the moment you fill in all the required
conditions (a certain count of unsuccessful calls, e.g.).

Tip

To unblock an ASR-blocked SIM card use the SIM menu. Enter the
blocked SIM card configuration and select Unblock.
To delete the ASR statistics use the Clear ASR option in the SIM card
configuration.

Caution

ASR and ACD information is updated on the SIM card after the SIM logs
out.

2N TELEKOMUNIKACE a.s., www.2n.cz 111/147

3.10 IMEI Menu
IMEI stands for the International Mobile Equipment Identity. It is a unique code
assigned to each GSM/UMTS module by the manufacturer. It is a fifteen-digit number
of a precisely defined format. GSM providers use this code for verifying module
identities and blocking modules if necessary.

You can change the IMEI in some module types.

Caution

This function is subject to licence!

The IMEI change in GSM modules may be prohibited by law in some
countries!

Add IMEI

Use this option to manually add an IMEI code to the 2N ® SIM Star Server database.
IMEI – enter the IMEI. The correctness of the IMEI to be added is checked
according to the Luhn algorithm. If wrong, the IMEI is not added.
Multiple – by activation of this parameter, you can disable unique IMEI control –
you can have/use more same IMEI numbers in one system.
Remark – type a note to facilitate orientation in the IMEI system.
Cancel reservation for archives – an IMEI shall not be used for archives if the SIM
card assigned this IMEI is removed.

Overview Table
Columns

Id – a unique identification number for each IMEI in 2N ® SIM Star Server.

IMEI – the IMEI code.
Multiple – activated/deactivated unique IMEI control.
Assigned to SIM – specify the SIM card to which the IMEI is assigned.

2N TELEKOMUNIKACE a.s., www.2n.cz 112/147

 Functions
View – display complete information on the IMEI code including the SIM
card assignment.
Edit – modify all the parameters mentioned in the

Add GSM group – add a GSM group.

Remove – remove a selected IMEI from configuration.
Buttons
Select all – push the button to mark all the displayed IMEI codes at once.
Unselect all – push the button to cancel the Select all function.
Remove selected – push the button to remove all the IMEI codes selected
in the last overview table row.

Other Controls

Import IMEI from File

The IMEI codes can be imported from any text file where they are separated with one
or more characters (excluding digits). For example, csv or txt files are suitable

formats. Those IMEI codes are only saved into the 2N ® SIM Star Server configuration
that have the correct format and have not been introduced to the system yet.

Remark – type a note to be added to all the IMEI codes added. The note is
intended for easier orientation in the IMEI system.
File – select a file for the IMEI code added. Click Ok to start file importing into 2N

® SIM Star Server.

Export IMEI to File
This function is used for exporting the current list of IMEI codes into a csv file.

2N TELEKOMUNIKACE a.s., www.2n.cz 113/147

3.11 Rules Menu
The menu is used for administration of the rules linking the GSM groups with the SIM
groups. You can add, remove and edit the rules in this menu.

Tip

Now you can assign multiple GSM groups to multiple SIM groups and set
the SIM card – GSM module pairing according to your requirements.

Add Rule
General info
Description – a text used for easier rule identification.
Priority – a GSM group can be used in identical intervals in more rules than
one. Set which rule has the highest priority (0 – lowest ; 9 – highest).
Selection settings
GSM groups – defines the assignment of a rule to up to four GSM groups.
Use local SIM card – enable the use of a local SIM card in the GSM/UMTS
gateway.
SIM groups – defines the assignment of a rule to up to four SIM groups.
SIM groups priority – defines priority of assigned SIM group.
Rule type – defines the SIM card assigning method:
Cyclic – the SIM cards are selected cyclically.
Most free minutes – the SIM cards with the highest counts of free
minutes are preferred.
Most free SMSs – the SIM cards with the highest counts of free SMSs
are preferred
Most credit – the SIM cards with the highest credits are preferred.
Least used – the least used SIM cards are preferred.
Least free minutes – the SIM cards with the lowest counts of free
minutes are preferred.
Least free SMSes – the SIM cards with the lowest counts of free SMSs
are preferred
Least credit – the SIM cards with the lowest credits are preferred.
Random – the SIM cards are selected randomly.

2N TELEKOMUNIKACE a.s., www.2n.cz 114/147

 Prefer recharging – define that the SIM cards that need recharging should
be preferred for assignment to the GSM modules.
Prefer activation – define that the SIM cards that need activating should be
preferred for assignment to the GSM modules.
Time limitations – In this section set the time intervals for the rule.
Time source – Used time for time limitation.
Days – select the days on which the rule shall be applied. The Select all and
Unselect all buttons are available for easier selection.
From – set the time at which the rule shall be applied on the selected days.
To – set the time at which the rule shall cease to be applied on the selected
days.

Tip

The time intervals correspond with those set in the SIM groups
parameter.

Force SIM switch timing

Use timing point – define when the SIM cards assigned to the GSM
modules should be changed.
Random range – set the time interval in which the SIM cards assigned to
the GSM modules should be changed randomly and sequentially.
Repeated SIM card using in one gateway
Mode – type of limitation of repeated SIM cards using in same GSM
gateways
GW history capacity – Number of last SIM card movement which will be
saved and used for SIM card movement restrictions.
Clear GW history – Validity time of GW history capacity. It's not
recommended to switch the parameter to „OFF".
SIM card travelling between gateways – Human behaviour feature "Advanced
SIM card movement". SSS will calculate real distance between GSM gateways
(according to GPS coordinates). IDLE time of SIM card (time between logout
from actual GSM gateway and time to login to new GSM gateway) is calculated
on the basis gateways' distance and speed of movement.
Speed – Speed of SIM cards movement for short distances (less than
10km)
Over 10km – Speed of SIM cards movement for middle distances (>10km
and <100km)
Over 100km – Speed of SIM cards movement for long distances (more than
100km)

2N TELEKOMUNIKACE a.s., www.2n.cz 115/147

Overview Table
Columns

Id – shows a unique identification number for each IMEI code in 2N ® SIM

Star Server.
GSM grp – displays the used GSM group Id. Move the cursor above the
code to display the group describing hint.
SIM grp – displays the used SIM group Id. Move the cursor above the code
to display the group describing hint.
Type – displays the SIM card selection method for the GSM module
assignment.
Description – shows a text for easier orientation in the rules.
Functions
View – displays complete information on the rule including a clearly
arranged rule application table.
Edit – helps modify all the parameters mentioned in the

Add – GSM Group section.

Remove – removes the selected rule from configuration.
Buttons
Select all – push the button to mark all the displayed IMSI codes at once.
Unselect all – push the button to cancel the Select all function.
Edit selected – push the button to edit all the IMSI codes selected in the
last overview table row.
Remove selected – push the button to remove from configuration all the
IMSI codes that are selected in the last overview table row.

Other Controls

Filter View
Show GSM group – Filter the rules according to their assignments to a GSM
group.
Show SIM group – Filter the rules according to their assignments to a SIM group.

2N TELEKOMUNIKACE a.s., www.2n.cz 116/147

4. Function and Use

This section provides the basic and extended functions of the 2N ® SIM Star product.
Here is what you can find in this section:

4.1 SIM Card to GSM Module Assignment

4.2 Hot Swap
4.3 How to Link Module IMEI and SIM Card IMSI
4.4 Prepaid SIM Card Credit Recharge
4.5 Human Behaviour Functionality
4.6 External API - SSS Uniclient Protocol
4.7 Tray SW
4.8 External Credit Check/Recharge Script

2N TELEKOMUNIKACE a.s., www.2n.cz 117/147

4.1 SIM Card to GSM Module Assignment
Basically, there are two types of SIM card assignment to a GSM module in a GSM
gateway.

Hard SIM Card Assignment

Go to the GSM menu and select a GSM module in the selected GSM gateway. Click on
Edit in the module row. Select the required SIM Board in the Hard linked SIM section
and then the required SIM card. Now the SIM card IMSI code should be displayed in
the Hard SIM column in the SIM card overview. The Hard linked column of the SIM
menu in the SIM card overview displays information on the GSM gateway and the GSM
module to which the SIM card is assigned (gw4 ch12, e.g.).

Assignment According to Rules

Move to the Rules menu and click on Add rule. In the submenu select the GSM group
to which the required GSM module is assigned. Now select the SIM group to which the
required SIM card is assigned. Choose the SIM card selection method for the group.

Refer to the Add Rule subsection for details on the rule types if necessary.
Finally, select the days and time intervals for the rule to be applied.

Caution

Remember that one SIM card may be assigned to one GSM module only

at a time. If the GSM gateway is disconnected temporarily from 2N ® SIM

Star Server, the SIM cards assigned to the disconnected GSM gateway
modules shall remain assigned to these GSM modules until the gateway

is reconnected to 2N ® SIM Star Server!

2N TELEKOMUNIKACE a.s., www.2n.cz 118/147

4.2 Hot Swap
2N ® SIM Star Server provides the so-called hot swap function. Hot swap includes two
running 2N® SIM Star Server units, which mirror the configuration databases. Upon a
failure of one server (Master), the other server (Slave) assumes control automatically.

Installation Guide – Web Configuration

Installing 2N ® SIM Star Server with the hot swap support, meet the below listed
instructions to avoid a system error.

1. Install 2N ® SIM Star Server on two independent PCs.

2. Log in to the web interface on both the PCs, go to SIM server -> Restart and
complete the data as follows.

3. Enable mirroring in the Change SIM Star Server's mirroring settings.

4. Enter the address of this server into My IP and the address of the other server
into Peer IP.

5. Complete the password and optional email.

6. Now push Restart to restart the two SIM Star servers and wait until the
introductory page has been loaded.

7. Enter the mirroring password on the server (Master) whose configuration is to

be mirrored.

To deactivate the hot swap support:

1. Deactivate the SIM server process (service simstar stop) on both the PCs.

2. Run the /usr/simstar/utils/ss_mirror_off utility.

3. Re-launch the SIM server process (service simstar start).

2N TELEKOMUNIKACE a.s., www.2n.cz 119/147

4.3 How to Link Module IMEI and SIM Card
IMSI
This function is necessary for cases where the SIM cards are bound to specific mobile
phones. In this relation, the SIM card is represented by the IMSI code and the mobile
phone by the IMEI code. To link the codes see below:

First enter the required IMEI code in the IMEI menu either manually or through file
import. Now click on the Edit item at the selected SIM card in the SIM overview table
and select an IMEI from the list for the selected SIM card in the available Assigned IMEI
menu. 'Yes' should be set in the IMEI column of the overview table for the SIM cards to
be linked with a specific IMEI card.

Caution

An IMEI-assigned SIM card may be used for IMEI change supporting

modules only.
The IMEI change function is subject to licence.

2N TELEKOMUNIKACE a.s., www.2n.cz 120/147

4.4 Prepaid SIM Card Credit Recharge
As already mentioned in the Add SIM Group section, credit can be recharged in
variable ways. Below are details on each credit recharging method.

USSD
To recharge via USSD you have to know the USSD code (may vary depending on the
network provider) and the prepaid voucher code. Suppose that the USSD recharge

code is *102*recharge_code# and the recharge voucher code entered in 2N ® SIM Star
Server is assigned to the SIM card. To recharge the SIM card credit using the USSD
method, take the following steps:

1. Set the Type parameter to USSD in the Prepaid SIM card recharge settings
section of the SIM Groups menu for the given SIM group.

2. In the same section, enter *102%c#* in the String parameter, where %c

represents the assigned recharge voucher code to be added by 2N ® SIM Star

Server and # signals the end of command.

3. The recharging process starts by logging in the SIM card to the GSM module
(unless already logged in) and dialling the USSD code in the format: *
102*recharge_code#. The rest of the process takes place automatically in the
provider's network.

2N TELEKOMUNIKACE a.s., www.2n.cz 121/147

SMS
To recharge via an SMS you have to know the SMS format and destination number as
well as the prepaid recharge voucher code. Suppose that the recharging SMS format is
RECHARGE_voucher_code, the phone number is 606 352 125 and the voucher code

entered in 2N ® SIM Star Server is assigned to the SIM card. To recharge the SIM card
credit via an SMS, take the following steps:

1. Set the Type parameter to SMS in the Prepaid SIM card recharge settings section
of the SIM Groups menu for the given SIM group.

2. In the same section, enter the phone number to which the SMS shall be sent into
the Number parameter. It is 606 352 125 in our example.

3. Enter RECHARGE_%c in the String parameter, where %c represents the assigned

recharge voucher code to be added by 2N ® SIM Star Server.

4. The recharging process starts by logging in the SIM card to the GSM module
(unless already logged in) and sending an SMS in the format
RECHARGE_voucher_code to phone number 606 352 125. The rest of the
process takes place automatically in the provider's network.

2N TELEKOMUNIKACE a.s., www.2n.cz 122/147

IVR
To recharge via an IVR you have to know the recharge line number and the provider's
IVR tree structure as well as the prepaid recharge voucher code. Suppose that the
recharging IVR line number is 606 456 789 and a recharge code has to be entered for
a successful IVR tree passage. Thus, dial 1, 3 and 2 sequentially. The recharge voucher

code entered in 2N ® SIM Star Server is assigned to the SIM card. To recharge the SIM
card credit via the IVR, take the following steps:

1. Set the Type parameter to IVR in the Prepaid SIM card recharge settings section
of the SIM Groups menu for the given SIM group.

2. In the same section, enter the provider's credit recharging IVR line number into
the Number parameter. It is 606 456 789 in our example.

3. Enter p1p3P2W%c#WW# in the String parameter, where %c represents the

assigned recharge voucher code to be added by 2N ® SIM Star Server and p, P

and W represent the waiting time of one, two or ten seconds.

4. The recharging process starts by logging in the SIM card login to the GSM
module (unless already logged in) and dialling the number included in the
Number parameter. On the provider's side, the DISA service answers the call and
digit 1 is DTMF-dialled into the IVR tree after a 1-second timeout (corresponds to
p1). Digit 3 (corresponds to p3) is dialled after another 1-second timeout and
digit 2 (corresponds to P2) is dialled after another two seconds. The IVR is
playing a message and no DTMF detector is connected. Therefore, wait about 10
seconds until the message is completed (corresponds to W) and DTMF-dial the

recharge code that has been assigned by 2N ® SIM Star Server (corresponds to %
c). The # char terminates the recharge code entering sequence. Finally, a 20-
second long waiting for the recharge code playing (corresponds to WW), dialling
confirmation with # and call end take place.

2N TELEKOMUNIKACE a.s., www.2n.cz 123/147

CALL
To recharge via an call you have to know the recharge called number.

Note

The credit recharging IVR tree structure depends on the network

provider. You are recommended to recharge manually first and,
according to the system structure and responses, set the above

mentioned 2N ® SIM Star Server parameters.

2N TELEKOMUNIKACE a.s., www.2n.cz 124/147

4.5 Human Behaviour Functionality
Human behaviour functions constitute a group of 2N ® SIM Star functions that make
the system less visible to the GSM/UMTS providers. The aim of this functionality is to

make the 2N ® SIM Star behaviour as close as possible to that of a common mobile
phone user. Extensive and detailed options of 2N® SIM Star help the user operate the
system more efficiently and increase the relevant call parameters (ARS/PDD/ACD).
Therefore, take into account the actual installation site conditions while setting the
system functions.

The following paragraphs explain the system functions in greater detail.

SIM Card Travelling

By setting the Rules appropriately and assigning your SIM cards to the GSM gateways
installed in various locations, you can virtually make your SIM card 'travel' over a long
period of time. Remember to pair your SIM cards with the IMEI (refer to the SIMs
settings) to make your mobile phone 'travel' too. A travelling mobile phone is less
detectable by the provider's diagnostic system.

SIM Card Small Travelling

A mobile phone user keeps moving and the 2N ® SIM Star 'virtual mobile phones' are
partially capable of following him or her thanks to the function mentioned above and
thanks to the so-called random BTS assignment (refer to the GSM Groups settings),
during which the 'mobile phone' travels a little during each call.

2N TELEKOMUNIKACE a.s., www.2n.cz 125/147

Operation Distribution
No local overload of the provider's network can occur due to an efficient distribution
of the GSM gateways with a reasonable count of GSM/UMTS modules. GSM module
locking to a specific BTS is an extended function, which distributes operation of a high
number of GSM modules in one location among the highest possible number of the
provider's BTSs.

Bi-Directional Traffic
A common mobile phone user answers and makes calls and receives and sends SMS.
This activity can be partially simulated by the so-called Virtual call and SMS simulators

in each GSM gateway / whole SIM Star system. 2N ® SIM Star provides on-line data
necessary for such operation.

Turn Off Mobile at Night

Large 2N ® GSM gateways provide an optional feature, which enables the unused GSM
/UMTS modules to be switched off automatically off the peak time and re-logged to
GSM/UMTS in the peak time.

Do Not Call Test Numbers

Using the 2N ® External Routing Machine (ERM), it is possible, apart from using the
number portability database for more efficient LCR, to use the so-called Dynamic
Black & White lists. The ERM keeps monitoring the parameters of outgoing calls and,
accordingly, add some called numbers permanently or temporarily to the list of barred

numbers (Black list). Up to one hundred 2N ® gateways can be connected to one ERM.
The ERM is part of the 2N ® SIM Star Server SW by default. Hence, all you have to do is
enable this function by the licence file.

Relax between Calls

A common user does not call all day long but makes variably long breaks between the

calls. 2N ® SIM Star Server also offers this possibility (refer to the SIM group settings).

2N TELEKOMUNIKACE a.s., www.2n.cz 126/147

Check Credit Randomly and Sometimes Recharge

2N ® SIM Star can, if set so in detail, calculate the SIM card credit virtually, asking the
GSM/UMTS provider for the current credit info for checking purposes only if the x-th
recharge is necessary. In case the difference between the virtual credit counter's result
and the real SIM card credit value is too high, the system can notify you of this by e-
mail or graphical message.

Use Free Minutes Efficiently

The free minutes rendered by the provider can be used efficiently due to up to four
different free minute counters (own network, another network, PSTN, VPN).

No Problem Calling to IVR

SIM recharge and periodical activation based on the IVR services (i.e. services that you
have to call, hear the voice menu and DTMF-dial the required service) represent no

problem for 2N ® SIM Star (refer to the SIM group settings).

Seek Bargain Offers

2N ® SIM Star can activate selected bargain offers (such as unlimited monthly calling
for a fixed price) on a regular basis automatically on the day as defined (every other
Friday in a month, e.g.).

Call with Limits

Thanks to the option of detailed SIM card settings, you can, for example, limit the
count of calls for a selected time interval. Moreover, the maximum call length and
count of sent SMS can be defined.

Advanced SIM card movement

This functionality allows dynamic idle time according physical distance between two
gateways. This idle time is counted from known GPS gateway location and user
defined transfer speed (can be set different speed for different distances).

Controled SIM cards activation

Definable random speed of activation of new SIM cards hides new SIM cards in GSM
/UMTS network. There are no bulk activations of SIM cards.

2N TELEKOMUNIKACE a.s., www.2n.cz 127/147

4.6 External API - SSS Uniclient Protocol
2N ® SIM Star Server provides a proprietary (2N® SIM Star Server Uniclient protocol)
interface (API) for optional extension with third party applications. This functionality is
subject to licence. The licence includes a complete API user documentation and test

interface. Refer to the 2N ® SIM Star Server web interface – SIM server management /
Licence – for details.

If you are interested in the web interface, please ask your dealer for a testing licence
with an enabled external system control.

Tip

External API is used for 2N ® SIM Star Server Tray SW (see 4.7)

2N TELEKOMUNIKACE a.s., www.2n.cz 128/147

4.7 Tray SW
Application for remote monitoring of up to ten 2N ® SIM Star Servers.
This application helps you to monitor more 2N ® SIM Star Servers by easy tray icon
located on Windows desktop (MS Windows XP, Vista, 7).

Caution

The application requires access via external API, please check license of
SSS

Installation

1. Download installation file from 2N ® SIM Star Server in section Management /

Firmware / Support file (see 3.3)

2. Unzip installation file and run setup.exe

3. Follow instruction in installation wizard.

4. Launch the application.

2N TELEKOMUNIKACE a.s., www.2n.cz 129/147

First configuration
Running application shows icon of SIM card in tray section of start-up menu.Use
double left click to the icon to open configuration of the application

Main screen contains following options:

Main menu
Application
Settings – main setting of the application
Close & Keep running – Close main application window and keep the
app running on background (tray icon)
Close & end – Close and stop the application
Help – About – Information about the application version.
Main table
Status – Status icon for each connected unit.
Grey – Disabled
Yellow – Problem found
Red – Unit disconnected
Green – No problem found.

Name – Custom name of connected 2N ® SIM Star Server

Address – IPv4 address of 2N ® SIM Star Server
Port – IP port of 2N ® SIM Star Server's API (default 12350)
Alerts – List of found problems
Button "Monitor" – activate/deactivate monitoring
Button "Settings" – settings for SIM Star server connection.

2N TELEKOMUNIKACE a.s., www.2n.cz 130/147

 Tip

Server name is active http link. You will open web interface of SSS by
left click on it.

Application settings
Main settings of the application

Automatically start application when OS starts – Enable/disable automatics start

of the application.
Language – Select used language.
Time to report alert (s) – Minimum delay to report new found problem
Time alert window notification (s) – Time of showing alert window when new
problem is found.

Settings of site

For each 2N ® SIM Star Server is required to configure all parameters in menu Settings:
Custom name – Name of 2N ® SIM Star Server
Address – Ipv4 address of connected 2N ® SIM Star Server
IP port – IP port for remote connection to external API (default is 12350)
Username – access username (create one new visitor account)
Password – access password
HTTP link – direct http link for easy access to web interface of SSS

2N TELEKOMUNIKACE a.s., www.2n.cz 131/147

Tray icon and alert window
Application automatically shows state of connected unit by colour of icon in tray
menu:

Grey – No monitoring activated

Yellow – Problem found on at least one unit
Red – At least one unit is disconnected
Green – No problem found.

The application automatically shows alert window if found new problem. This windows
contains brief information about the problem(s). Details information you will see in
alert section in main screen of the application or on home screen of SIM Star Server
web interface.

2N TELEKOMUNIKACE a.s., www.2n.cz 132/147

4.8 External Credit Check/Recharge Script
2N ® SIM Star Server provides a possibility to define a custom script for SIM cards'
credit check and recharging. This feature enables you to create a script of your own
for USSD answers.

Caution

Using this feature may lead to a credit check/recharge function error!

You are recommended to use the scripts that have been completely
tested on a test site!

External scripts are used for advanced search values in the text. It can be any
executable file located in the /usr/simstar/scripts directory. You can use a compiled
binary program, shell script, perl or php, for example. The file must be set as
executable for the user "simstar". The file name length is limited to 15 characters. The
script name is entered in the configuration. The text is during start-up script passed as
the first parameter. The second parameter is the IMSI and the third one SCID of the
used SIM card. The phone number of the SIM card is passed as the fourth parameter.
The script has to write a search result to the output (stdout). The result may include
more values. Each value must be on a separate line. The line format is "VARIABLE:
VALUE".

List of variables:

SKIP – skip result of script

RCRD – remaining credit for prepaid card
RCR2 – remaining credit (decimal part of cost) for prepaid card
UCRD – used credit for prepaid card (last call)
UCR2 – used credit (decimal part of cost) for prepaid card (last call)

External Script Examples

BASH Example:

––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––

#!/bin/sh

1. Get USSD string.

2N TELEKOMUNIKACE a.s., www.2n.cz 133/147

 1.

str=$1

2. Replace these two lines by analysis of $str and setting real values.

rcrd=123
rcr2=45

3. Print the required values for the handover to SIM Star Server.

echo RCRD:$rcrd
echo RCR2:$rcr2

––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––

PERL Example:

––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––

#!/usr/bin/perl

1. Get USSD string.

$str = print $ARGV[0];

2. Replace these two lines by analysis of $str and setting real values.

$rcrd = 123;
$rcr2 = 45;

3. Print the required values for the handover to SIM Star Server.

print "RCRD:".$rcrd."\n";
print "RCR2:".$rcr2."\n";

––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––

2N TELEKOMUNIKACE a.s., www.2n.cz 134/147

5. Technical Parameters

This section describes the technical parameters of the 2N ® SIM Star product.
Server Requirements

CPU:
2.4GHz or more
Intel CPU i386
RAM: At least 2GB or more
HDD: 60GB or more
HDD Type: SATA100 or SATA133
CDROM: Required for installation
LAN: Ethernet 100BaseT
UPS: recommended

SIM Board Box Dimensions and Interfaces

Dimensions (w x h x d): 482 x 133 x 360 mm (84HP x 3U x 360mm)

Weight (full configuration): 9,800g
Power supply: 100–240V AC / 50–60Hz
Power input: Up to 230VA
Interface: 2 10BaseT (RJ-45 connectors)
Capacity: Up to 18 hot-swappable SIM Boards (576 SIM cards)

2N TELEKOMUNIKACE a.s., www.2n.cz 135/147

6. Supplementary Information

This section provides supplementary information on the 2N ® SIM Star product.

Here is what you can find in this section:

6.1 Mikrotik RB750 Default Configuration

6.2 Troubleshooting
6.3 List of Abbreviations
6.4 Regulations and Directives
6.5 General Instructions and Cautions

2N TELEKOMUNIKACE a.s., www.2n.cz 136/147

6.1 Mikrotik RB750 Default Configuration
Mikrotik RB750 can be used as an IP router with a wide NATp table for installations
where one public IP address is required (refer to WAN configuration in Subs. 1.1).

The Mikrotik RB750 router that you received from 2N contains different settings than
a normal router (can be removed by IP router factory reset).

Default Access
The users may log in with the following two types of web access privileges:

Privileges
admin – a user with the highest rights, authorised to manage configuration
and the user accounts.
Admin – a user with limited configuration rights. There are removed
configurations parameters which need not be changed.

By default, one login name is created for each privilege:

Login name Password

Admin 2n

Admin 2n

Caution

You are recommended to change the default settings upon the first
login to improve your system security.
The system allows for concurrent logins of users with the configuration
privileges. However, we do not recommend this because of a risk of
erroneous saving of configuration data into the system database.

You are recommended to use web access for basic configuration. Advanced IT
administrators can use the SSH or WINBOX configuration of the router (refer to
http://www.mikrotik.com/).

Default Configuration

The following diagrams show the IP router configuration. Make sure that a ll the 2N ®
SIM Star parts (SIM board, GSM gateway) are configured according to these diagrams!

2N TELEKOMUNIKACE a.s., www.2n.cz 137/147

2N TELEKOMUNIKACE a.s., www.2n.cz 138/147
2N TELEKOMUNIKACE a.s., www.2n.cz 139/147
6.2 Troubleshooting

For the most frequently asked questions refer to faq.2n.cz.

The IMEI fails to change in the case of SIM card replacement. The IMEI change
requiring SIM card fails to report itself.
Make sure that the GSM modules support IMEI change.
Make sure that valid IMEI change licences are available.
The SIM cards fail to assign to the GSM modules.
Try the hardsim mode for assignment or make sure that the GSM module is
in the testing mode.
Check the validity of the rules.
The SIM cards assign to the GSM modules but fail to log in.
Make sure that the NAT settings in the IP Routers allow the SIM card
stream pass from the SB to the SC without problems.
If you have USIM, try to change the SIM cache type setting on the SB.
Check the protocol error rate in the GSMs – QoS of SIM connection section.
Make sure that the signal intensity and frequency are sufficient on the GSM
gateway installation site.
The system features a low ASR value.
Make sure that your SIP Proxy does not send a count of GSM calls higher
than the GSM gateway capacity.
If a frequent SIM card change is set, reduce the maximum count of calls via
the GSM gateway – the GSM modules are temporarily unavailable for
standard calls while being in the process of recharging (especially the IVR
type), virtual incoming calling or SIM replacement.
The system shows a low ACD value.
Make sure that the SIM card credit and validity check is set correctly –
lower ACD may result from incoming call forwarding to the IVR services
informing of a low credit, etc.
The IMEI file cannot be imported.
Make sure that the IMEIs to be inserted are valid. (http://en.wikipedia.org
/wiki/International_Mobile_Equipment_Identity)
The IMSI/SCID file cannot be imported.
The SIM card database is watched according to the IMSI/SCID codes. The
records that contain the IMSI/SCID code of the currently assigned SIM card
will only be imported.

The simulation of incoming calls with 2N ® SIM Star Server does not work.

2N TELEKOMUNIKACE a.s., www.2n.cz 140/147

 Make sure that the take-over of SIM card records from 2N ® SIM Star Server
is enabled for the GSM gateway.

Make sure that this data transfer is enabled in 2N ® SIM Star Server (SIM
Server / Connections / IMSI/Phone distribution).
Check whether the GSM gateways have access to IP port 12349 in the
event of connection via the NAT Router.

2N TELEKOMUNIKACE a.s., www.2n.cz 141/147

6.3 List of Abbreviations
List of Abbreviations

API (Application Programming Interface)

ASR (Answer Seizure Ratio)
ACD (Average Call Duration)
BIOS (Basic Input-Output System)
CD (Compact Disc)
CDR (Call Data Record)
CLIR (Calling Line Identification Restriction)
COM (PC serial interface)
CPU (Central Processor Unit)
DHCP (Dynamic Host Configuration Protocol)
DNS (Domain Name Server)
DTMF (Dual Tone Multifrequency)
eCPU (enhanced CPU)
FW (Firmware)
GMT (Greenwich Mean Time)
GSM (Group Switched Mobile system)
GPRS (General Packet Radio Service)
GW (Gateway)
HW (Hardware)
IMEI (International Mobile Equipment Identity)
IMSI (International Mobile Subscriber Identity)
IP (Internet Protocol)
IVR (Interactive Voice Response)
LAN (Local Area Network)
LED (Light Emitting Diode)
NAT (Network Address Translation)
PC (Personal Computer)
PCB (Printed Circuit Board)
PCM (Pulse-code modulation)
PIN (Personal Identification Number)
PRI (Primary Rate Interface)
PUK (Personal Unblocking Key)
SB (SIM Board)

2N TELEKOMUNIKACE a.s., www.2n.cz 142/147

 SC (SIM Client)
SIM (Subscriber Identity Module)
SIP (Session Initiation Protocol)
SMS (Short Message Service)
SSH (Secure Shell)
SW (Software)
TCP (Transmission Control Protocol)
UCMD (UDP commands)
UDP (User Datagram Protocol)
UMTS (Universal Mobile Telecommunication System)
UPS (Uninterruptible Power Supply)
USSD (Unstructured Supplementary Service Data)
VoIP (Voice over Internet Protocol)
WAN (Wide Area Network)

2N TELEKOMUNIKACE a.s., www.2n.cz 143/147

Europe
2N ® SIM Star conforms to the following directives and regulations:
Directive 1999/5/EC of the European Parliament and of the Council, of 9 March 1999 -
on radio equipment and telecommunications terminal equipment and the mutual
recognition of their conformity

Directive 2006/95/EC of the European Parliament and of the Council of 12 December

2006 on the harmonisation of the laws of Member States relating to electrical
equipment designed for use within certain voltage limits

Directive 2004/108/EC of the Council of 15 December 2004 on the harmonisation of

the laws of Member States relating to electromagnetic compatibility

Commission Regulation (EC) No. 1275/2008, of 17 December 2008, implementing

Directive 2005/32/EC of the European Parliament and of the Council with regard to
ecodesign requirements for standby and off mode electric power consumption of
electrical and electronic household and office equipment

Directive 2011/65/EU of the European Parliament and of the Council of 8 June 2011 on
the restriction of the use of certain hazardous substances in electrical and electronic
equipment

Regulation (EC) No. 1907/2006 of the European Parliament and of the Council of 18
December 2006 concerning the Registration, Evaluation, Authorisation and Restriction
of Chemicals (REACH), establishing a European Chemicals Agency, amending
Directive 1999/45/EC and repealing Council Regulation (EEC) No. 793/93 and
Commission Regulation (EC) No. 1488/94 as well as Council Directive 76/769/EEC
and Commission Directives 91/155/EEC, 93/67/EEC, 93/105/EC and 2000/21/EC

Directive 2012/19/EC of the European Parliament and of the Council of 4 July 2012 on
waste electrical and electronic equipment.

2N TELEKOMUNIKACE a.s., www.2n.cz 144/147

6.5 General Instructions and Cautions
Please read this User Manual carefully before using the product. Follow all instructions
and recommendations included herein.

Any use of the product that is in contradiction with the instructions provided herein
may result in malfunction, damage or destruction of the product.

The manufacturer shall not be liable and responsible for any damage incurred as a
result of a use of the product other than that included herein, namely undue
application and disobedience of the recommendations and warnings in contradiction
herewith.

Any use or connection of the product other than those included herein shall be
considered undue and the manufacturer shall not be liable for any consequences
arisen as a result of such misconduct.

Moreover, the manufacturer shall not be liable for any damage or destruction of the
product incurred as a result of misplacement, incompetent installation and/or undue
operation and use of the product in contradiction herewith.

The manufacturer assumes no responsibility for any malfunction, damage or

destruction of the product caused by incompetent replacement of parts or due to the
use of reproduction parts or components.

The manufacturer shall not be liable and responsible for any loss or damage incurred
as a result of a natural disaster or any other unfavourable natural condition.

The manufacturer shall not be held liable for any damage of the product arising during
the shipping thereof.

The manufacturer shall not make any warrant with regard to data loss or damage.

The manufacturer shall not be liable and responsible for any direct or indirect damage
incurred as a result of a use of the product in contradiction herewith or a failure of the
product due to a use in contradiction herewith.

All applicable legal regulations concerning the product installation and use as well as
provisions of technical standards on electric installations have to be obeyed. The
manufacturer shall not be liable and responsible for damage or destruction of the
product or damage incurred by the consumer in case the product is used and handled
contrary to the said regulations and provisions.

The consumer shall, at its own expense, obtain software protection of the product.
The manufacturer shall not be held liable and responsible for any damage incurred as
a result of the use of deficient or substandard security software.

2N TELEKOMUNIKACE a.s., www.2n.cz 145/147

The consumer shall, without delay, change the access password for the product after
installation. The manufacturer shall not be held liable or responsible for any damage
incurred by the consumer in connection with the use of the original password.

The manufacturer also assumes no responsibility for additional costs incurred by the
consumer as a result of making calls using a line with an increased tariff.

Electric Waste and Used Battery Pack Handling

Do not place used electric devices and battery packs into municipal waste containers.
An undue disposal thereof might impair the environment!

Deliver your expired electric appliances and battery packs removed from them to
dedicated dumpsites or containers or give them back to the dealer or manufacturer
for environmental-friendly disposal. The dealer or manufacturer shall take the product
back free of charge and without requiring another purchase. Make sure that the
devices to be disposed of are complete.

Do not throw battery packs into fire. Battery packs may not be taken into parts or
short-circuited either.

2N TELEKOMUNIKACE a.s., www.2n.cz 146/147

 2N TELEKOMUNIKACE a.s.

Modřanská 621, 143 01 Prague 4, Czech Republic

Phone: +420 261 301 500, Fax: +420 261 301 599

E-mail: [email protected]

Web: www.2n.cz

v14.0

2N TELEKOMUNIKACE a.s., www.2n.cz 147/147