Beruflich Dokumente
Kultur Dokumente
Ernst-Reuter-Platz 8
10587 Berlin, Germany
Phone: +49 30 399 28-066
Fax:
+49 30 399 28-051
E-mail: sales@teles.com
http://www.teles.com/
Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Safety symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Safety measures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Tips for EMC protection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
System security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Servicing the system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Replacing components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Protecting the operating system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CDR files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Network security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6
6
6
7
7
8
8
8
12
13
14
15
17
8.9.2
8.9.3
8.9.4
8.9.5
8.9.6
8.10
8.11
8.11.1
8.11.2
8.11.3
8.11.4
8.11.5
8.12
8.12.1
8.12.2
8.13
8.14
8.15
8.16
8.17
8.17.1
8.17.2
8.17.3
8.18
8.19
8.20
8.21
8.22
Script commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Script example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Defining the SIMs protocol. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Decommissioning SIMs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Editing mobile gateways . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
SIM history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
vGATE statistics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
SIM statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Call statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Call charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
What the information on the vGATEDesktop means . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
vGATEDesktop icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Menu bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
vGATEDesktop toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Context menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Logging activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sending error messages via e-mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Tearing down connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
111
112
112
113
116
116
117
119
119
121
Chapter 1, About this manual introduces the vGATE Systems Manual and how it is set up.
Chapter 2, Safety and security precautions contains information about security issues relevant to
connection with the IP network.
Chapter 3, Overview briefly describes the vGATE and its implementation scenarios.
Chapter 4, vGATE installation contains information on how to connect and configure the system
so that it is ready for operation.
Chapter 5, The vGATE Module describes the vGATE Module, which consists of the vGATE Board
and the SIM 60 Carrier.
Chapter 6, Configuration describes the vGATEs individual configuration files and parameters.
Chapter 7, vGATE Control Unit 16.1 contains a description of the vGATE Control Unit, which is
responsible for administration of the vGATE and includes the applications vGateConfig, vGATEDesktop,
vGATECtrl, and a MySQL database.
Chapter 8, vGATEDesktop describes the frontend application used for administration of the
vGATE.
Chapter 9, vGATECtrl describes the vGATE Control Units background server.
Chapter 10, vGATEWatch describes the watchdog function that causes vGATECtrl and/or the MySQL
database to restart if they shut down improperly.
Chapter 11, Appendix contains additional information that may be useful to you.
1.2 CONVENTIONS
Configuration data or extracts are written in single-column tables with a gray background.
Note
Attention
Warning
Information that must be adhered to as it is necessary to ensure that the system functions correctly and to avoid material damage.
CHAPTER 2
Location: Make sure you install the system in a clean, dry, dust-free location. If possible, the site is to be air-conditioned. The site must be free of strong electrical or
magnetic fields, which cause disrupted signals and, in extreme cases, system failure.
CHAPTER 2
Temperature: The site must maintain a temperature between 0 and 45C. Be sure to
guard against temperature fluctuations. Resulting condensation can cause short circuiting. The humidity level may not exceed 80%.
To avoid overheating the system, make sure the site provides adequate ventilation.
Power: The site must contain a central emergency switch for the entire power source.
The sites fuses must be calculated to provide adequate system security. The electrical facilities must comply with applicable regulations.
The operating voltage and frequency may not exceed or fall below what is stated on
the label.
Antenna: iGATE contains no provision or protective device against power surges or
lightning strikes.
The installation of the antenna must fulfill all necessary safety requirements. Employ
the services of a professional antenna installer.
2.3.1 SERVICING THE SYSTEM
Regular servicing ensures that your system runs trouble-free. Servicing also includes looking after the room in which
the system is set up. Ensure that the air-conditioning and its filter system are regularly checked and that the premises are cleaned on a regular basis.
To avoid damage to the vGATE SIM Unit, transport it only in the original packaging.
Component
Life span
Filter pads
6 months
5 years
5 years
Fan
5 years
3 years
CHAPTER 2
Do not perform queries on the database. This can result in damages to the database.
Do not use any MySQL tools, such as MySQL-Front to make changes in or perform
tests on the database.
Call Detail Records are intended for analysis of the systems activity only. They are not designed to be used for
billing purposes, as it may occur that the times they record are not exact.
Inaccuracies in the generation of CDRs may occur for active connections if traffic is
flowing on the system while modifications in configuration or routing files are activated.
2.5 NETWORK SECURITY
Every day hackers develop new ways to break into systems through the Internet. While TELES takes great care to
ensure the security of its systems, any system with access through the Internet is only as secure as its user makes
it. Therefore, to avoid unwanted security breaches and resulting system malfunctions, you must take the following
steps to secure your TELES.System if you connect it to the Internet:
CHAPTER 2
Service
Protocol
Port
TCP
TCP
SMTP
TCP
25
DNS forward
UDP
53
HTTP
TCP
SNTP
UDP
123
SNMP
UDP
UDP
H.225 signaling
TCP
Radius
UDP
Radius accounting
UDP
GATE Manager
TCP
SIP signaling
UDP / TCP
RTP
UDP
CHAPTER 2
Service
Protocol
Port
TCP
57343
vGATE tunneling
TCP
4446
FTP
TCP
21
SSH
TCP
22
MySQL database
TCP
3306
TCP
57342
TCP
4446
TCP
9003
Remote vGATEDesktop
TCP
57344
TCP
57345
TCP
51500
FTP
TCP
21
SSH
TCP
22
MySQL database
TCP
3306
NMS protocol
TCP
5000
NMS update
TCP
5001
NMS task
TCP
5002
NMS task
TCP
5003
NMS Listen
TCP
4444
Radius authentication
UDP
1812
Radius accounting
UDP
1813
10
CHAPTER 2
Connection from a vGATE Control Unit to a iGATE requires ICMP access. The TCP filters listed above are activated in the default configuration of the vGATE Control Unit
or the NMS server.
11
CHAPTER 3
OVERVIEW
3 OVERVIEW
The vGATE is a system that enables more convenient management of a network of iGATE
and ECOTEL GSM or ECOTEL 3G systems (referred to as mobile gateways) running software version 14.6 or higher.
All SIM cards in the network are installed in
and maintained from a central server, so that it
is no longer necessary to install SIM cards into
each mobile gateway. The vGATE can even recharge prepaid SIMs automatically. For details
on the requirements of the mobile gateways in
your vGATE, see Chapter 11.6 .
The vGATEDesktop makes it possible to assign
SIMs virtually to random ports and various times without physically removing the SIMs from the vGATE SIM Unit.
Virtual SIM allocation provides extra savings and security. Centralized SIM storage prevents theft of unattended
SIMs and reduces costs incurred by maintaining and assigning SIMs at individual mobile gateways.
The term mobile gateway covers the products iGATE, ECOTEL GSM, and ECOTEL 3G
and is used throughout this manual.
3 . 1 WH A T S N E W I N V E R S I O N 1 6 . 1
Faster reconnect to available gateways in case of accidentally broken TCP connections is now possible.
Last incoming USSD or SMS messages can be shown in vGATE desktop for every single SIM card. This
simplifies the handling of balance checks and recharges.
New balance transfer feature available.
Recharge via special service interface added.
SIM search algorithms can be combined.
SIM card release after recharge can now be suppressed.
Autorecharge - SIM cards that are blocked due to missing vouchers are automatically unblocked if new
vouchers are added.
12
CHAPTER 3
OVERVIEW
VoIPBOX BRI
VoIPBOX BRI
VoIPBOX PRI
VoIPBOX PRI
VoIPBOX GSM
ECOTEL GSM
VoIPBOX UMTS
ECOTEL 3G
iGATE GSM
iGATE GSM
iGATE 3G
iGATE 3G
13
CHAPTER 3
OVERVIEW
3.3 FEATURES
Handles up to 600 SIMs per vGATE SIM Unit; up to twenty vGATE SIM Units (12,000 SIMs) can be attached
to a vGATE Control Unit
No need to travel to individual mobile gateways to replace SIM cards.
Cyclical use of multiple SIMs can occur on a single mobile channel.
Mobile channels in the mobile gateways can easily be assigned to different mobile networks.
Groups of mobile gateways can be defined and managed individually
Time frames can be defined for individual groups: SIMs can be assigned for specific times on specific
controllers or mobile gateways
Priority levels can be set for individual SIMs
Supports generation of SIM reports
Limits and pauses can be defined for how long a SIM card is to be active or inactive
More than one vGATEDesktop can be used
Supports and automatically recharges prepaid SIMs (USSD, DTMF, or SMS)
Can send and receive SMS and calls
Shows statistic values
Activation of Special Services for prepaid SIMs using automatic USSD, DTMF or SMS transmission
Time-controlled USSD or DTMF transmission
Random assign pause activation for individual SIMs following change of Timezones, boot indication and
Reset Maintenance
Color-coded routing
Possible to deactivate SIMs when Timezone changes
Special scripting interface for advanced options
Supports dynamic IP addresses of mobile gateways
Supports GSM, UMTS, and dual (UMTS/GSM) SIMs (as of vGATE SIM Unit Version 29)
Supports call prioritization
Call and SMS limits for SIMs
Possible to allow SIMs to be used once per day and gateway
Supports different rates for Timezones with new protocol
Password-protected connection between the vGATE and the vGATE SIM Unit
Remote tunneling for connection to the mobile gateways
Supports 3G SIMs on 2G controllers
Balance verification check for prepaid SIMs possible
Can set dynamic time/distance pauses between mobile gateways
Possible to retrieve a SIMs call number based on its IMSI
Can run special scripts automatically for new SIMs
Additional receiver groups for calls and SMS can be defined
Possible to define a maximum number of calls per day on one SIM
Supports special parse actions
14
CHAPTER 3
OVERVIEW
15
CHAPTER 3
OVERVIEW
You can also set time limits and pauses for individual SIMs. After a SIM has been used for the amount of time set,
it will be moved to another port or permanently released from the vGATE. If you set a pause, the SIM take a break
for the amount of time set after each use.
16
CHAPTER 3
OVERVIEW
3.5 COMPONENTS
Each vGATE consists of the following:
Up to ten vGATE Modules which consist of a vGATE Board and a SIM 60 Carrier. Up to 60 SIM cards can
be inserted into the SIM 60 Carrier.
All SIMs are inserted into the central vGATE SIM Units, so that none are required in the individual mobile gateways,.,
The vGATE SIM Unit Version 29 is compatible only with vGATE Version 12.0 or higher.
17
CHAPTER 4
vGATE INSTALLATION
4 v G AT E I N S T A L L A T I O N
This section contains information on basic installation and configuration of your vGATE.
The vGATE SIM Unit Version 29 is compatible only with vGATE Version 12.0 or higher.
Implementation of individual scenarios requires adjustments to the appropriate interfaces. Tips for basic settings
are described here. Links to relevant chapters are provided for more specific configuration changes.
A PING must be possible from the vGATE Control Unit to all mobile gateways and vGATE SIM Units.
Message round-trip time must be less than 500 ms. You can use PING to measure the round-trip time.
No components (mobile gateways, vGATE Control Unit, vGATE SIM Units) may be behind a PAT (Port
Address Translation) firewall, as ports 51500, 57342, 57343, 57344, 57345 and 3306 may not be
changed.
Connection setup must be possible in both directions at all times.
The autohangup timer of a router or dial-up connection must be greater than 20 seconds. If you configure
the parameter LimitWOdisc=On in the pabx.cfg, you must switch off the autohangup function.
We recommend that you install the vGATE Control Unit and vGATE SIM Units in the same location,
connected with a bandwidth of 100 MBit/s. If they are not installed in the same location, the bandwidth
between them must be at least 2MBit/s in both directions.
18
CHAPTER 4
vGATE INSTALLATION
4 . 2 v G AT E S I M U N I T H A R D W A R E I N S T A L L A T I O N
The vGATE SIM Unit holds up to 10 vGATE Modules. At up to 60 SIM cards per SIM 60 Carrier, a single vGATE SIM
Unit contains up to 600 SIM cards. As shown in Figure 4.1, the first three slots are empty and the vGATE Modules
are inserted from left to right.
Number
Description
1.
2.
Each vGATE Board has a slot for a SIM 60 Carrier. Insert the SIMs in the SIM 60 Carrier and
then insert the SIM 60 Carrier here (see Chapter 5 on page 5-20). The hardware addresses for
the vGATE Boards start with D000 on the left and go to D900 in ascending order.
NOTE: The PIN for all SIMs must be 0000.
3.
4.
5.
19
CHAPTER 5
5 T H E v G AT E M O D U L E
Each vGATE SIM Unit consist of up to ten vGATE Modules. Each vGATE Module consists of one vGATE Board and
one SIM 60 Carrier, which can be inserted into and removed from the back of the vGATE Board during operation.
The SIM 60 Carrier contains the SIM cards for the individual mobile channels. Up to 60 SIM cards can be assigned
to individual mobile channels at random.
5.1 THE SIM 60 Carrier
SIM cards are mounted on the front and back of the SIM 60 Carrier (Figure 5.1). As a guide to help you distinguish
top from bottom, the SIMs are numbered at the top and bottom near the center of the SIM 60 Carrier, as shown
in Figure 5.1. You can select the SIM cards you would like to use via the vGATEDesktop.
When the SIM 60 Carrier is properly inserted, the second LED from the bottom will flash quickly for 5 seconds and
then slowly. If the LED remains off or does not stop flashing quickly, insert the SIM 60 Carrier more firmly.
Figure 5.1 SIM 60 Carrier Front and Rear View
Insert ONLY the SIM 60 Carrier into the vGATE Board! Make sure all SIMs are clean
and grease free and that their mounts are properly closed.
20
CHAPTER 5
5 . 2 I N S T A L L I N G A D D I T I O N A L v G AT E B O A RD S
The system is only to be installed, replaced or maintained by properly trained technicians. Before installation, the
following information must be read and understood.
The vGATE Board contain components which are vulnerable to electrostatic (ESD -Electrostatic discharge Sensitive
Devices, also known as EGB). Electrical discharge can cause malfunctions or complete system failure. You must
therefore observe the following guidelines:
Wear an ESD wristband as protection from electrostatic discharge. Connect it to the ESD bonding point
(system earth).
Discharge equipment, instruments or metal objects, which come in contact with the vGATE Boards so that
they are earthed.
Avoid contact between the vGATE Boards and your clothing.
Do not wear synthetic clothing or shoes with plastic soles.
Avoid strong electrical constant fields, such as cathode ray indicators, monitors, etc.
To install an additional vGATE Board, attach a keyboard and monitor the vGATE SIM Unit and use the keyboard to
logon to the vGATE SIM Unit as root with the password beamup. Exit the vGATE SIM Units software by entering
shutdown -h now in the command line. Turn off the systems power when the message Power down appears.
You must shut down the systems power when the message Power down appears
before installing any new hardware. Failure to do so will result in damage to the systems hardware and software.
Danger of electric shock. The mains adapter is loaded with 230 V. You must detach
the vGATE SIM Unit from the power supply before you open the housing.
Unscrew and remove the vGATE SIM Units lid and the bracket on top of the boards.
Set the memory range on each new vGATE Board you install. Boards are numbered D000 to D900 from left to right
in ascending order when looking at the rear of the system, as shown in Figure 5.2.
Figure 5.2 vGATE Board: Memory Range Settings
21
CHAPTER 5
Turn the dials in the right-hand corner of each vGATE Board until the arrows point to the corresponding letter and
number. In Figure 5.3, the dials have been set at D and 1, for a hardware address of D100. This card will appear
in the second slot in the vGATE SIM Unit. Bear in mind that each vGATE Board must have a different address.
Figure 5.3 vGATE Board: How to Set the
Memory Range
Make sure the new vGATE Board does not contain a SIM 60 Carrier. Not following the correct procedure to replace
the vGATE Board can result in damage to the contacts or conductors. Insert the vGATE Board in the next available
slot and screw it into place. Replace and secure the bracket and lid.
Reconnect the power supply and turn on the vGATE SIM Unit. The software will automatically recognize the new
hardware within five minutes.
22
CHAPTER 5
5 . 3 v G AT E B O A RD L E D S
Each vGATE Board has eight LEDs that provide a quick overview of the vGATE Boards operational status.
Each of the upper six LEDs shows the status of ten of the
SIMs inserted in the vGATE Board. The second LED from the
bottom shows the status of the database connection. The
bottom LED shows whether any of the SIMs are currently being accessed.
Table 5.1 provides an overview of what the individual LEDs
mean.
LED
Meaning
Slowly flashing
Quickly flashing
Off
Off
Off
23
CHAPTER 6
CONFIGURATION
6 CONFIGURATION
Operation of the vGATE depends on the following configuration entries:
6.1 C ON F IG URATIO N O F TH E vGATE SIM UN IT
The vGATE SIM Unit is a Linux system that makes use of an Ethernet interface.
The eth0 interface enables the vGATE SIM Unit to communicate with the connected mobile gateways and the
vGATE Control Unit. Settings for this interface can be adjusted to adapt with the needs of individual networks.
After you have installed your vGATE SIM Unit as described in Chapter 4.2 , log onto the vGATE SIM Unit as
root and enter beamup at the password prompt.
If your vGATE SIM Unit is accessible from the Internet, make sure the password for root is secure. You can change
the password using the passwd command.
Delete the vgate user with the following command: userdel -r vgate
and set up a different, secure user and password with: adduser
Support for UMTS SIMs occurs only with vGATE SIM Unit software version 28 or higher. If your vGATE SIM Unit is running an older version, the software must be updated.
The vGATE SIM Unit Version 29 is compatible only with vGATE Version 12.0 or higher.
Dialog Box
Information
ENTER HOSTNAME
24
CHAPTER 6
CONFIGURATION
Dialog Box
Information
ENTER GATEWAY
ADDRESS
USE A NAMESERVER?
Make sure you check all of your entries! To make changes, select Restart.
If you are satisfied, select Accept. Confirm your accepted settings by hitting
Enter.
#
#
#
#
#
/etc/rc.d/rc.inet1.conf
This file contains the configuration settings for network interfaces.
If USE_DHCP[interface] is set to "yes", this overrides any other settings.
If you don't have an interface, leave the settings null ("").
25
CHAPTER 6
CONFIGURATION
Setting a password for connection from vGATECtrl to the vGATE SIM Unit
To set a password to connect with the vGATE SIM Unit from the vGATECtrl, you must first stop the SIM-server process with stopvgate. Using the vi editor, follow these steps:
Example:
We want to set the password test. In vGateConfig, we enter the password test for the vGATE
SIM Unit. It appears as SGVU. We set the password in the startvgate script as follows:
#!/bin/sh
echo starting simser...
/usr/local/bin/simser -p /usr/local/bin/
vgate_isa.bit -c
/usr/local/bin/vgate_carrier.bit -l /var/log/
vgate.log -w SGVU &
Do not configure SIMs in the vGATE and mobile gateway simultaneously. This can
lead to database failures. Be sure to remove the SIM-card carrier from the mobile
gateways used with the vGATE.
26
CHAPTER 6
CONFIGURATION
This parameter cannot be used with the following parameters: <SIM24>, <SIMV>
and <SIM+>.
Example 1
The following example is for iGATE GSM only. Example 2 shows how to configure ECOTEL GSM
and Example 3 shows how to configure iGATE 3G:
...
Subscriber00=TRANSPARENT
Subscriber01=TRANSPARENT
Subscriber02=TRANSPARENT
Subscriber03=TRANSPARENT
...
Example 2
GSM[0000,00000,+000000,1,1,1,SIMS]
GSM[0000,00000,+000000,1,1,1,SIMS]
GSM[0000,00000,+000000,1,1,1,SIMS]
GSM[0000,00000,+000000,1,1,1,SIMS]
CHADDR
CHADDR
CHADDR
CHADDR
ALARM NEXT
ALARM
ALARM
ALARM
The following example is for ECOTEL GSM only. Example 1 shows how to configure iGATE GSM
and Example 3 shows how to configure iGATE 3G:
...
Subscriber04=TRANSPARENT
Subscriber05=TRANSPARENT
Subscriber06=TRANSPARENT
Subscriber07=TRANSPARENT
...
Example 3
...
Subscriber00
Subscriber01
Subscriber02
Subscriber03
...
ROUTER
ROUTER
ROUTER
ROUTER
ROUTER
ROUTER
ROUTER
ROUTER
GSM[0000,00000,+000000,1,1,1,SIMS]
GSM[0000,00000,+000000,1,1,1,SIMS]
GSM[0000,00000,+000000,1,1,1,SIMS]
GSM[0000,00000,+000000,1,1,1,SIMS]
CHADDR
CHADDR
CHADDR
CHADDR
ALARM NEXT
ALARM
ALARM
ALARM
The following example is for iGATE 3G only. Example 1 above shows how to configure iGATE
GSM and Example 2 shows how to configure ECOTEL GSM:
=
=
=
=
TRANSPARENT
TRANSPARENT
TRANSPARENT
TRANSPARENT
ROUTER
ROUTER
ROUTER
ROUTER
UMTS[0000,00000,+00000,1,1,1,SIMS,BAND(1)]
UMTS[0000,00000,+00000,1,1,1,SIMS,BAND(1)]
UMTS[0000,00000,+00000,1,1,1,SIMS,BAND(1)]
UMTS[0000,00000,+00000,1,1,1,SIMS,BAND(1)]
CHADDR
CHADDR
CHADDR
CHADDR
ALARM NEXT
ALARM
ALARM
ALARM
The vGATE Control Units IP address must appear in the category IP Configuration in the [System] section of the mobile gateways pabx.cfg file:
SimCtrlUnitAddress=<ip addr>
Configure an additional controller in the last position for DTMF functionality as follows:
Example:
Controller36=41DTMF
27
CHAPTER 6
CONFIGURATION
28
CHAPTER 7
7 v G AT E C O N T R O L U N I T 1 6 . 1
Administration of the vGATE occurs through the vGATE Control Unit, which is a 1HU, 19 PC. The vGATE Control
Unit includes the following:
vGateConfig is a configuration tool with a graphical interface used to configure the vGATE Control Unit.
vGATEDesktop is a frontend application used for controller assignment and SIM administration.
vGATECtrl is a background server process with an attached database that communicates with the vGATE
SIM Unit and the mobile gateways.
MySQL V. 5.1.43 database contains information on all SIMs in the vGATE.
The user name and password to log onto the vGATE Control Unit are
simdbuser and simdb, respectively.
7 . 1 v G AT E C O N T R O L U N I T H A R D W A R E I N S T A L L A T I O N
29
CHAPTER 7
7.3 vGateConfig
You must restart vGATECtrl following any changes made after the initial configuration.
Database
The default Name of the database is SIMServerDB and may not be changed. Do not change the User name
simdbuser or the Password simdb. Enter its Host address. The default period (.) entered here represents named
pipes and is to be left as is if you are using a local host. 3306 is the default Port for MySQL. If you change this
port, you must also enter the new port number here. Enter the Pipe Name MYSQL.
Frontend server
The frontend server is the vGATE Control Unit. The default Host is localhost. Do not change the default Port.
Enter a Password and a Password (read only) if you would like to have password-protected access.
For information on how to set up a remote vGATEDesktop, see Chapter 11.2 .
30
CHAPTER 7
31
CHAPTER 8
vGATEDesktop
8 v G AT E D e s k t o p
The vGATEDesktop is a frontend application used for administration of the vGATE. All SIMs and mobile gateways
can be maintained from a central location using this application.
The vGATECtrl application must be started before the vGATEDesktop. Do not open a
second vGATEDesktop if one is already open, as this will cause the first to close.
Make sure you set the clock on the vGATE Control Unit accordingly!
The vGATEDesktop allows you to group mobile gateways together for a targeted overview of activity. SIMs can be
assigned to any mobile gateway connected to the vGATE SIM Unit at any time of day, making it easy to move SIM
activity from one location to another.
The vGATEDesktop contains four windows, from which SIMs can be assigned to specific mobile gateway controllers
for specific times. The columns in each window can be rearranged by drop and drag and renamed by right-clicking
the column headings. Figure 8.1 shows the contents of each window as follows:
Show Positions
groups
timezones
filters
SIMs
mobile
gateways
controllers (ports)
32
CHAPTER 8
vGATEDesktop
As soon as mobile gateways have been configured and connected to the vGATE, they must be restarted for automatic registration.
The respective windows shown in Figure 8.2 will then automatically list the connected mobile gateways and their
empty controllers. The inset shows what the icons will look like in the case of an iGATE 3G.
As soon as a mobile gateway is configured as part of the vGATE, it is automatically assigned to the Default
Group.
The following sections will guide you through a step-by-step example of how to set up your vGATEDesktop.
8.2 SETTING UP MOBILE GATEWAYS
To be able to distinguish one mobile gateway from another, it is useful
to give it a meaningful name. To rename mobile gateways, right-click
the mobile gateway you want to rename and select Edit from the context menu.
Enter the new Name in the window that appears.
Click OK to activate changes.
If dynamic IP-address allocation is used on the mobile gateway, you
must set the following entry in the pabx.cfg:
SimCtrlUnitCheckInterval=<sec>
For a detailed description of all of the entries in this dialog, see Chapter 8.15
33
CHAPTER 8
vGATEDesktop
Now we have two groups and four iGATEs. All four iGATEs belong to the group named Germany.
We want the iGATEs Berlin and Munich to remain in the
Germany group and the Chicago and New York iGATEs
to move to the USA group.
To move iGATEs to another group, right-click the name of
the iGATE and select Change Group from the context
menu. Choose the group from the drop-down list and click
OK.
When we click either one of our groups, only the iGATEs in
that group will appear in the list of iGATEs.
34
CHAPTER 8
vGATEDesktop
Using the slide control at the top of the vGATEDesktop, you can easily set the times, called timezones, when SIMs
are active for individual controllers. The SIMs in a particular timezone will automatically activate and deactivate at
the times set. This function allows you to move SIM activity from one time and place to another.
For our example, we will first set timezones for one group. We click the
Germany group to activate its timezones. We want to set a timezone
from Tuesday at 6:00 p.m. to Wednesday at 8:00 a.m. To add a marker to
the slide control, we press Ctrl and left-click the mouse approximately
where the new marker is to appear. Then we use the mouse to slide the
marker to 8:00.
After we have added the second marker, we will use another method to
set it: we right-click the new marker and set the time using the arrows in
the pop-up dialog that appears. If Use SIMs started on same GW is active, the same SIMs used at the beginning of the day will be assigned for
this timezone if they are available.
Using either of these two methods, you can set timezones for each group. The timezones will be the same for each
mobile gateway in the group, but the SIMs assigned to each timezone may differ, depending on your individual
setup.
The total number of timezones for all groups may not exceed 85.
35
CHAPTER 8
vGATEDesktop
To prevent inadvertent timezone changes, activate Inhibit Modification of Timezones in the vGATEDesktops
Options menu. This will lock all timezones into place so that they cannot be changed. Make sure this option is
inactive before attempting to edit the timezones.
36
CHAPTER 8
vGATEDesktop
The vGATEDesktops date and clock are set according to the clock on the vGATE Control Unit, which appears in the bottom right-hand corner of the vGATEDesktop. Timezones are set and change according to this clock and not according to the clock on
the PC on which the vGATEDesktop is installed. Make sure you set the clock on the
vGATE Control Unit accordingly!
8.4.3 SETTING DIFFERENT RATES FOR TIMEZONES
You can set different rates for various carriers within the same timezone and copy them from one timezone to another. This applies for all carriers entered in the carrier list.
Select Edit Differing Rates from the Timezones List to open the Timezones Rates List. Open the Edit Different Rates dialog by selecting Edit, Add or Delete rates from the context menu.
37
CHAPTER 8
vGATEDesktop
To set or copy different rates, you must first activate the New Protocol checkbox in
the edit window. After activating the New Protocol checkbox, you must select Reinit
or Set Maintenance Mode from the mobile gateways context menu to activate this
feature. If you deactivate the checkbox, you must restart the mobile gateway.
8.5 ASSIGNING SIMS
Once you have set a groups timezones, you can begin to assign SIMs for each controller and its timezones.
With the corresponding iGATE license, 3G SIMs are supported for 2G controllers as
of vGATE SIM Unit Version 36 and iGATE Version 14.3.
The timezones are color-coded as follows: green means the timezone is currently active, white means it is inactive
and blue means it is currently being edited. SIMs that are currently active appear in the Active Position list. SIMs
that are not active but have been reserved to timezones appear in the Limit 1 Reserved Positions and/or Limit
2 Reserved Positions lists (for more on limits, see Chapter 8.6 ).
For an overview of SIMs that were once, but are no longer, inserted in the vGATE SIM
Unit, select Show SIMs not in Simserver from the View menu.
38
CHAPTER 8
vGATEDesktop
39
CHAPTER 8
vGATEDesktop
Now we want to assign SIMs 1.001.06-1.001.10 with Max Limit 2 to consecutive controllers 1 to 5:
1.
2.
3.
4.
5.
6.
7.
40
CHAPTER 8
vGATEDesktop
You can limit the number of time units a SIM is used before the mobile gateway switches to the next SIM or before
a SIM is permanently deactivated. The mobile gateways default configuration sets these time units at 10 seconds
each.
Right-click the SIM(s) for which you would like to set or change a limit and select Change Limits from the context
menu. Use the pop-up dialog to check No Limit if you prefer not to set a limit (default setting).
If the SIM is prepaid, check Prepaid SIM. Since the SIMs limit is predefined, you must not set a limit for prepaid
SIMs. However, if you would like to set a change limit for prepaid SIMs, go to the vGATECtrl application and select
Use Change Limit for Prepaid SIMs from the Options menu. For a detailed description of this feature, see
Chapter 8.9.3 . If you check Auto Recharge, the SIM will recharge automatically (see Chapter 8.9 ). To limit
the number of times a SIM can be recharged per month, enter a value in the Max. Upgrades per Month box.
The SIM will no longer be assigned when the value entered is reached and the line will turn yellow. Unsuccessful
recharge attempts will also be counted toward the value entered. The counter is reset at the beginning of each
new month. To limit the number of times a SIM can be recharged per week, enter a value in the Max. Upgrades
41
CHAPTER 8
vGATEDesktop
per Week box. The SIM will no longer be assigned when the value entered is reached and the line will turn yellow.
Unsuccessful recharge attempts will also be counted toward the value entered. The counter is reset at midnight on
Sunday of each new week. If you do not want to limit the number of recharges, click No Limit (default).
To change the SIM after a certain amount of 10-second units, deactivate the No Limit checkbox. To set a random
limit, set two values Between 1 and 65534 in the Change Limit box. The first value must be less than the second
value. If the first value is greater than the second, a fixed limit will be set at the first value. For example, the
Change SIM Limit entry in Figure 8.13 is set to a random value between 1800 and 2600 10-second time units
(default setting for ChargeUnitGenerate), or 18,000 and 26,000 seconds. Random limits will change with
every SIM release.
Do the same under Max. Limit 1 and Max. Limit 2 to permanently deactivate a SIM after a certain number of
10-second units has passed. For example, the Max. Limit 1 entry in Figure 8.13 is 65,000 10-second time units,
or 650,000 seconds. If No Limit has been checked under Change Limit, you can enter a value here between 1
and 65534. Otherwise, you can enter a value between 1 and 2147483646. Bear in mind that balance verification
and expected amount settings will apply only for Max. Limit 1.
You can set a second max. limit under Max. Limit 2. When assigning the SIM to timezones, choose one of these
two limits for each timezone (see Chapter 8.5 ). Bear in mind that balance verification and expected amount
settings will apply only for Max. Limit 1.
To set a maximum call duration, activate the Max Call Duration checkbox and enter a range of seconds between
1 and 65533. After a random limit within the range has passed, the call will automatically be disconnected.
You can also set additional Adv. Limits. Use the Carrier List (see Chapter 8.8 ) to configure the limits and set
the limits here. Bear in mind that balance verification and expected amount settings will apply only for Max. Limit
1.
If a SIM switches to a new timezone where it has a different limit (Limit 1 to Limit 2), the SIM will be released unless
it is reserved to the same controller in the new timezone. If you want to release the SIM regardless of where it is
reserved, activate Release All SIMs if Timezone Changes in the vGATECtrl Options menu. If a SIM switches
limits during a call, the time will be deducted from the limit that was active when the SIM was assigned.
To Reset Limits once a month, check Day of Month and enter a date. The limit will reset automatically to the
original amount at midnight on the date entered. A similar limit is available for prepaid limits. In the Change Limits to 0 group box, set a day of the month or a day of the week to change the limit to 0 and force a balance check.
If a day is set and the prepaid SIM card is blocked, it is automatically reset to 0 and thereby unblocked.
To reset the limit once a week, check Day of Week and the reset day. The limit will reset automatically to its original amount at midnight on the day checked.
If you check Only if Limit Reached, the maximum limit will reset to its original amount on the day entered only
if the limit has been reached.
If you activate the checkbox Maximum Call Duration per Day, the SIM will be blocked as soon as the number
of minutes has been reached that is entered in Maximum Daily Call Duration regardless of any other limits that
have been set. Activate Use Daymask and click the Daymask button to set different maximum durations for different days. Minimum Remaining refers to a number of minutes that are left in the maximum daily duration. The
SIM will be blocked for the rest of the day at the end of any call that crosses this threshhold without reaching the
maximum daily duration. The maximum daily duration counter is reset every day at midnight. You must set a Timezone change at 11:50 p.m. Bear in mind that a time offset may be necessary.
42
CHAPTER 8
vGATEDesktop
You can set an interval for a SIMs Maximum Calls Per Day by activating the corresponding checkbox and entering two values. Every day a random value between the two values entered will be apply for the SIM. You must
set a Timezone change at 11:50 p.m. Bear in mind that a time offset may be necessary.
You can set a Time Offset to reset limits. The limits will be reset up to 14 hours ahead or 12 hours behind the
time on the vGATE Control Unit. This is useful for mobile gateways located in different time zones.
Make sure to reset limits only when SIMs are inactive. If you reset them while they
are active, the settings in the database will no longer correspond with those in the
mobile gateway.
To set an amount of time a SIM is to remain idle between uses, enter a value in Minimum Pause after Last Use.
To set a random pause, set two values Between 0 and 99.99. The first value must be less than the second value.
If the first value is greater than the second, a fixed pause will be set at the first value. Be sure to use a period and
NOT a comma when setting unrounded values. If you activate the checkbox Ignore On Same Gateway, the minimum pause will be ignored if the SIM is reassigned to the same gateway. If you activate the checkbox Ignore if
Minimum Remaining Available, the minimum pause will be ignored if the Maximum Call Duration per Day
option is active. You can shorten the pause set here by configuring a distance between gateways (see Chapter ).
When the checkbox Maximum Usage per TZ is activated, the SIM will be blocked after it has been assigned the
number of times entered within the same Timezone. You can define this value for Limit 1 and Limit 2. A brown
icon will then appear. When the Timezone changes, the counter will be reset and the SIM can be assigned again.
When Active Release is checked and the Active SIM Release option has been set in the vGATECtrl, the active
SIMs will be released when the number of Minutes after Assign, Calls after Assign, SMS after Assign entered has passed or the number of Incoming Calls or Call Attempts has been reached. Values between 2 and
9999 minutes or an unlimited number of calls or SMS are possible. SIMs in the reserved position will become active.
If no SIMs are reserved, the same SIM will be reassigned <Xref>(see Chapter 9.4 on page 113). Check Random
and the SIM will be released following a random number of minutes between the figures entered. Check Block if
Reached and the SIM will be blocked when the limit is reached. If you check Don't Release, Generate Incoming Call, a call from a random SIM of the same carrier in the vGATE will be sent to the SIM that reached the call
limitation. If Maximum Calls Per Day is active, the remaining value there will apply if it is less than the value
entered here.
You must first activate the New Protocol checkbox in the edit window to release calls
or SMS after assigning them. After activating the New Protocol checkbox, you must
select Set Maintenance Mode from the mobile gateways context menu to activate
this feature. If you deactivate the checkbox, you must restart the mobile gateway.
To delay SIM assignment, activate Delay SIM Assignment On TZ Change, Reset Maintenance, Boot Indication and enter two figures: the first between 0 and 600, and the second between 0 and 1200. The SIM will be
assigned a random number of seconds between those entered following a Timezone change, a maintenance mode
reset or a boot indication received from the mobile gateway.
Activate the checkbox Block SIM On Low ACD to block SIMs with short calls. Enter the number of times the ACD
can fall below the seconds set before it is to be blocked. Choose whether the values entered are to be calculated
within a 24 hour period (In 24 Hours) or consecutively (In a Row) before it is to be blocked. The ACD is checked
every time a SIM is released.
43
CHAPTER 8
vGATEDesktop
If you activate Lower Priority and enter a figure On Limit Below, the SIMwill automatically receive lower priority
when its limit falls below the amount entered. Activate Reset Priority If Limit is Upgraded and the SIM will
receive its configured priority when the limit goes above the amount entered.
Activate Use SIM On Alternating Gateways to alternate the gateways on which the SIM will be used. Activate
Use SIM On Alternating Locations to alternate the locations on which the SIM will be used.If you activate the
checkbox Use SIM Only Once per Day and Gateway, the SIM will be used only once for each gateway to which
it is assigned on any given day. When the checkbox Release SIM Immediately after Timezone Change is
active, the SIM will be released when the Timezone changes and any calls will be disconnected. If Release All
SIMs if Timezone Changes has not been set in the vGATECtrl Options menu and the SIM is reserved for the
next Timezone at the same controller, it will not be released when the Timezone changes (see Chapter 9.4). If
LimitWODISC=ON has been set in the mobile gateways pabx.cfg, the call will continue into the next Timezone if the limit is reached before the end of the current Timezone.
8.7 SETTING DYNAMIC SIM PAUSES
To shorten the pause set in the Limits dialog, you can configure a pause based on the distance between two mobile gateways within a group. The vGATE calculates the pause based on coordinates that you enter for each mobile
gateway. If no other SIMs are available, these shorter pauses will override the static pause set for the SIM.
8.7.1 SETTING THE COORDINATES
44
CHAPTER 8
vGATEDesktop
To calculate the coordinates for the mobile gateways in a group, place them on a Cartesian grid as shown in
Figure 8.14 , where 0 is the center of the group and the increments on the X and Y axes are units of distance.
You can define the units of distance and the increments freely as you choose.
8.7.2 ENTERING THE COORDINATES
To set the coordinates you have calculated on your grid, open the edit
window by double-clicking the name of the mobile gateway. Enter the
mobile gateways Position as shown in Figure 8.15 .
For times when travel occurs faster or slower, you can set two
Pause Deviances. The example in Figure 8.16 reflects slower travel between 7:00 a.m. and 7:00 p.m., and
faster travel between midnight and 6:00 a.m.
Click OK. The vGATE will calculate the dynamic pause between mobile gateways automatically.
8.8 SETTING CARRIERS
To set carriers, select Carrier List from the View menu or click the
icon in the toolbar.
45
CHAPTER 8
vGATEDesktop
The Carrier List window will appear. Right-click an empty line or an entry and select Edit, Add or Delete from the
context menu.
If you select Edit or Add, the carrier list editor will appear. From here you can define new carriers or edit existing
ones. The information entered here will also be sent to the mobile gateway for automatic configuration of SIMs
and SMS service if New Protocol is activated in the edit window of the mobile gateway:
46
CHAPTER 8
vGATEDesktop
Entry
Description
Name
Prefix
Enter all of the carriers prefixes that are to be sent to the mobile gateway
when Limit Outgoing Calls to Prefix is active. Separate multiple prefixes
with a semi-colon.
Activate this checkbox to route only those calls beginning with the Prefix
entered.
LAIN
Carrier Sub ID
You can assign a sub ID (default 1) for individual SIMs (for example, if a carrier uses different recharge numbers for its SIMs).
Mapping Character
Enter the mapping character you configured for the carrier in the
route.cfg.
Example:
;Recharge via SMS
;--------------------------------------------------MapAllSMS??=11111*??01: DATA
MapAllSMS??=22222*??01: DATA
MapAllSMS??=33333*??01: DATA
MapAllSMS??=44444*??01: DATA
47
CHAPTER 8
vGATEDesktop
Entry
Prepaid Recharge: USSD Code
Description
Check the box and enter the USSD code used to recharge SIM cards.
The entry must contain the code that you need to access the USSD menu,
the pauses that you need to wait and the menu entries that you need to select.
Example:
*100#p5m1p10
If your entry plus voucher code, additional pauses, and menu entries exceed
22 characters, enter a placeholder instead. In this case, you need to configure the pabx.cfg and route.cfg. For a detailed description please see
Chapter 8.9.5 on page 58 .
NOTE: Balance check by USSD code requires mobile gateway version 14.3 or higher.
Prepaid Balance Check: USSD
Code
Check the box and enter the USSD code for retrieving the SIM cards balance.
To get the available balance via USSD menu, enter the USSD code followed
by the pauses and menu entries that you need to access the balance check
option.
Example:
*100#p5m1
NOTE: Balance check by USSD code requires mobile gateway version 14.3 or higher.
Prepaid Balance Check: SMS To
Check this box if the carrier uses SMS for balance check and enter the destination number into the field to the right of the check box. In addition, you
need to enter the SMS text into the Message field.
To receive the balance by SMS message, enter the SMS text into this field.
Balance check by SMS requires the following mapping entry in the mobile
gateways route.cfg:
MapAllSMS??=<LAIN>*??01: DATA
Example:
;Balance Check via SMS
;--------------------------------------------------MapAllSMS??=11111*??01: DATA
MapAllSMS??=22222*??01: DATA
MapAllSMS??=33333*??01: DATA
MapAllSMS??=44444*??01: DATA
48
CHAPTER 8
vGATEDesktop
Entry
Description
SMSC Number
Enter a search string for the prepaid SIMs balance. As of version 14.6 of all
mobile gateways, you can set two strings by entering an & sign between
them. The two resulting values will be added together and calculated with
the balance factor (BF) to form the prepaid limit. If no second value exists,
only the first will be calcultated. If no first value exists, there will be no result.
Enter a pipe (|) to search for either value. You can enter a < sign in front of
each search string to parse the balance before the search string. You can
also parse any limits you have set by including them in curly brackets in front
of the parse string as follows:
{0}<string>=Major limit
{1}<string>=Advanced limit A
{2}<string>=Advanced limit B
{3}<string>=Advanced limit C
You can also parse remaining times as follows:
{A}<string>=Time in minutes
{B}<string>=Time in seconds or hour:minute:second
EXAMPLE: {0}balance & {1}bonus.
NOTE: Bear in mind that limits and times cannot be combined in
the same string.
Currency Unit/Minute
BF
This value is calculated automatically. As of version 14.6 of all mobile gateways, up to two decimal places will be calculated.
Remaining Balance
Enter the minimum balance at which the card will be recharged or blocked.
Enter the initial time unit charged after call connection (usually in seconds).
Enter the charge unit generated for the call (usually in seconds). Set 0 as a
flat rate if you do not want to generate charge units.
49
CHAPTER 8
vGATEDesktop
Entry
Advanced Limit Charges
Description
This button is green when limits have been set and gray when nothing has
been entered. Click this button to open the Advanced Limit Charges window. You must enter all prefixes for which the limit is to apply. These limits
will not apply if no prefixes are entered. Enter the charge information. Click
the Daymask button to set the times for which the limit is to apply. For postpaid SIMs, limits will all apply simultaneously unless you activate Use Limits
One By One and the limits. For prepaid cards, the limits will all apply one
after the other. Bear in mind that balance verification and expected amount
settings will apply only for Max. Limit 1.
NOTE: You must define a mapping character for each prefix in
the route.cfg.
Click here to enter a string from an information message that the carrier may
send to the SIM and the path to a special script that will run when this string
is received. This button is green when a string has been set and gray when
nothing has been entered.
Click here to enter a string from an information message that the carrier may
send to the SIM. The string will be entered in the Info 1, Info 2 or Error column if it is received from the SIMs carrier. The
icon will appear in front
of the SIMs IMSI. If Release SIM on Info is active, The SIM will be released
after receiving the info parse string. If Block is also active, the SIM will be
released and blocked. This button is green when a string has been set and
gray when nothing has been entered.
Loudness PCM
Set the PCM volume level between 0 (lowest volume) and 7 (highest volume). The default setting is 4.
Loudness Mobile
Set the mobile volume level between 0 (highest volume) and 3 (lowest volume). The default setting is 1.
Echo Cancelation
Activate this checkbox and set a timeframe during whcih a SIM is to recharge.
This checkbox is needed for prepaid SIM cards in a balance transfer scenario.
Check this box to define a carrier as master and select a balance transfer
script into the Transfer Script box. For more details on balance transfer
please see Chapter 8.9.6 .
This checkbox is needed for prepaid SIM cards in a balance transfer scenario.
Check this box to define a carrier as production carrier and select a master
carrier from the drop-down menu. For more details on balance transfer
please see Chapter 8.9.6 .
50
CHAPTER 8
vGATEDesktop
Entry
Recharge Via Special Action
Description
Check this box and select a script to recharge SIM cards using special service
scripting commands. You can use this feature to enforce a balance check before recharging SIM cards or to do any other verifications in your recharging
process. Use the following special service scripting commands:
RECHARGE_IF_LIMIT_BELOW_WOREL
RECHARGE_IF_LIMIT_BELOW
SET_MAX_LIMIT
CHANGE_MAX_LIMIT
When this checkbox is active, no balance check occurs after prepaid SIM
cards with Max Limit 1 are assigned.
Activate this checkbox to switch off the automatic balance check that normally takes place at 12:00 AM and 12:00 PM on the mobile gateway.
When this checkbox is active, no balance check of the prepaid SIM cards occurs after the SIM has been recharged. A balance check will occur the next
time the SIM is assigned.
When this checkbox is active, automatic balance checks that come via SMS
are entered in the database. This is useful for SIMs that do not allow active
balance checks.
Activate this checkbox to ensure that a SIM card is not deactivated after recharge.
Activate this checkbox to reset the counter for too many announcements to
reflect the worst case configuration.
51
CHAPTER 8
vGATEDesktop
Entry
Description
The mobile port is blocked when the value defined for calls that result in recorded messages is reached. When this feature is activated, the vGATE will
automatically assign the SIM again and a balance check will occur. Activate
Reassign and Test With One Call Attempt to allow just one call over
this SIM. After this call the SIM will be released again. If the call is successfully connected, the error will be removed and the SIM will be used in normal
service again. If the call is not connected or the setup results in another recorded message, the SIM will be blocked.
If you activate Verify Balance, a balance check will occur. Specify how often by entering the number of balance checks in the Times Per Day and
Times Per Month boxes. If the SIM card has a positive balance that is within the value entered in Balance Verification Tolerance, the error will be
removed and the SIM will be used in normal service again. If the error occurs
again, the vGATE will allow just one call over this SIM. After this call the SIM
will be released again. If the call is successfully connected, the error will be
removed and the SIM will be used in normal service again. If the call is not
connected or the setup results in another recorded message, the SIM will be
blocked. If the SIM does not have a balance that is within the Balance Verification Tolerance, the SIM will be released and blocked with a balance
verification error.
Bear in mind that the value defined for Too many announcements in theedit window of the mobile gateway must be set at 1 or higher.
The parameter STOP[<val1>,<val2>] must be set on the mobile gateway for
this feature to work (please refer to your iGATE, ECOTEL GSM, or ECOTEL 3G
manuals for an explanation of this parameter).
To ensure that the vGATE calculation of limits is correct and the carriers rates
have not changed since the last time the SIM was recharged, two additional
random balance checks can be started.
After the Random Balance Verification has occurred, a new limit is calculated for the SIM. If this limit differs from the limit that the vGATE calculated before the balance check, and the difference is smaller than the
Tolerance, the SIM will be released and blocked, and an error message will
be generated. Random Balance Verification works only for prepaid SIM
cards with an automatic recharge configuration.
Activate Dai Based to initiate a random balance check within the timeframe
entered.
This feature is for autorecharge prepaid SIMs. You can enter a percentage, a
number of units, or both if both are to apply. Please see the descriptions in
the entries for Too many announcements check and Random Balance
Verification above.
52
CHAPTER 8
vGATEDesktop
Entry
Description
Activate this checkbox to reset the counter for too many announcements following a balance check with a positive result.
Activate this checkbox and enter a range of minutes for a pause to occur before a SIM is released after its last call.
Activate this checkbox and enter a range of minutes for a pause to occur after a carriers SIMs have been assigned before the first call is sent.
Activate this checkbox and enter a limit value for the first time a new SIM
from this carrier is used. This is useful for prepaid SIMs that require a call to
retrieve balance information.
To automatically recharge prepaid SIMs, the following entries must be made in the mobile gateways
route.cfg:
A mapping character must also be defined for each carrier as follows:
MapAll<mapping character>??=<LAIN>*??01:
53
CHAPTER 8
vGATEDesktop
MapAllDTMF=41DTMF
i
Example:
To avoid mapping conflicts, we recommend that you use the last letters in the alphabet as mapping characters.
In the following example, the carrier with the LAIN 11111 is assigned the mapping character Z,
the carrier with the LAIN 22222 is assigned the mapping character Y, the carrier with the LAIN
33333 is assigned the mapping character X, the carrier with the LAIN 44444 is assigned the mapping character W.
MapAllDTMF=41DTMF
MapAllZ??=11111*??01:
MapAllY??=22222*??01:
MapAllX??=33333*??01:
MapAllW??=44444*??01:
We strongly recommend using a compact flash, as the available storage space is limited and may fill up quickly, causing the system to fail. The CDR license includes the
compact flash.
8 . 9 . 2 D E F I N I N G P R E P A I D S I M S O N T H E v G AT E D e s k t o p
Once you have inserted a prepaid SIM into the vGATE, you must define it as prepaid in the vGATEDesktop in one
of the following ways:
54
CHAPTER 8
vGATEDesktop
Icon
Description
The SIM in this position is prepaid.
To deactivate the SIM positions prepaid status, right-click the SIM and select Change Limits. Deactivate the Prepaid SIM checkbox.
The SIMs prepaid limit will always appear in the Max Limit 1 column.
8.9.2.1 FINDING THE BALANCE PARSE STRING
The balance parse string is the reference term used to access the carriers recorded message. On the
vGATEDesktop, set one of the carriers SIMs as prepaid and assign it to a controller that has been defined as prepaid for this carrier. After 2 minutes, establish a GATE Manager connection to the mobile gateway. Open the logfile
defined in the configuration. The text will appear here in front of the currency entry. Now you can enter the text in
the carrier configuration (cf. Chapter 8.8 on page 45 ).
Example:
After you send the balance code, the following string appears:
your available balance: 10.20
An appropriate balance parse string would be balance:
8.9.2.2 CALCULATING THE BALANCE FACTOR
The balance factor is the number of time units in a currency unit (e.g.$, , etc.). The rate is the cost per minute.
ChargeUnitGenerate is the number of seconds in a time unit.
The balance factor can be calculated automatically up to two decimal places from the vGATEDesktop
(cf. Chapter 8.9.4 on page 56 ).
8.9.3 SETTING A CHANGE LIMIT FOR PREPAID SIMS
To activate this feature, go to the vGATECtrl application and select Use Change Limit for Prepaid SIMs from
the Options menu. Setting a Change Limit for prepaid SIMs brings the following advantages:
A balance query will no longer occur every time the SIM is assigned.
Automatic balance queries from the mobile gateway will no longer occur at noon and midnight mobile
gateway time.
SIMs can be switched when the Change Limit is reached and do not have to be active until the prepaid
limit (Max Limit 1) is reached.
A Change Limit on prepaid SIMs works like this:
55
CHAPTER 8
vGATEDesktop
Define the SIM as a prepaid SIM and set the change limit. After you assign the SIM, the prepaid limit is queried.
As soon as the prepaid limit arrives at the vGATE, it is set in the database as Max Limit 1 and the change limit is
activated in the mobile gateway. That means the SIMs prepaid status is no longer transmitted as such to the mobile
gateway. The mobile gateway will recognize the Change Limit as long as Max Limit 1 (prepaid limit) is less than
the Change Limit. When the Change Limit reaches Max Limit 1, a balance query will occur.
In the dialog that appears, use the drop-down menu to select the SIMs
Carrier.
Enter the Recharge String as follows: If you are using USSD, simply
enter the digits in the code.
If the carrier recharges SIMs using DTMF tones, you must first enter
DTMF: followed by the string. The carriers service center recording
will include various menu options and queries, which generally require
that you configure pauses into the recharge string. Enter a p for a 1second pause and a P for a 10-second pause. You may have to call the
Figure 8.20 Prepaid Recharge Editor
56
CHAPTER 8
vGATEDesktop
service center number and time the recording, so that you know how long the pauses are to be. If the recharge
process takes longer than 240 seconds, the call will be disconnected. A comment can be added about the specific
recharge code in the User Info dialog.
In Figure 8.20 , the Recharge String is DTMF:P1PPppp010943667175#PP. That means the carrier uses
DTMF tones to recharge SIMs. The string begins with a pause of 10 seconds followed by a 1. Then comes a pause
of 3 seconds followed by 010943667175#. A pause of 20 seconds occurs before the call is disconnected.
If you are recharching your SIM card by SMS, you must first enter SMS: followed by the voucher code provided by
your carrier.
Enter the total Expected Amount. The Primary Amount is the amount on the voucher and the Bonus Amount
refers to any additional amount that will be added. Bear in mind that the figure entered here multiplied by the
balance factor must be greater than the remaining balance set in the carrier editor.
You can enter any useful User Info in the corresponding dialog box. Make sure the Type is set at 0.
If an error occurs during recharge, the SIM card that is being recharged is blocked
with the no recharge number found error message. Once you enter a new voucher,
the SIM card is automatically unblocked.
57
CHAPTER 8
vGATEDesktop
Icon
Description
The code has not yet been used and is still available.
The number has been used and is no longer available.
You can create up to four different GSM<number> entries. The number parameter denotes the different entries.
Enter the MCC/MNC combination (the LAIN parameter) to uniquely identify the carrier. The mapping character is used to group carrier SIMs with the same settings. It is taken from the Mapping Character box in the
vGATEs carrier editor. The ?? are used to dynamically locate the port. The placeholder parameter comes from
the USSD Recharge Code box in the vGATES carrier editor. The ~ is replaced with the voucher code sent from
the vGATE. The > separates the left from the right side. The USSD menu parameter contains the command that
you need to access the carriers USSD menu. Both the pause in seconds and the USSD menu entry
parameters are used to navigate through the USSD menu. They need to be entered as often as it takes to get to
the right menu for recharge.
58
CHAPTER 8
vGATEDesktop
Example:
In the following example, a SIM card is recharged using the USSD menu. The MCC/MNC combination to uniquely identify the mobile operator is 26212. In the vGATEs carrier editor, the mapping character to identify all of the mobile operators SIM cards which are recharged via USSD
menu is V, the place holder for the USSD menu entry is B. In the pabx.cfg, B is replaced by
*100#~p5m1p10m2 which is the USSD menu entry *100#, the voucher code coming from the
vGATE, a 5 second pause to enter menu 1, and a 10 second pause to enter menu 2.
GSM1=26212 MAP[V??B~>V??*100#~p5m1p10m2]
Example:
MapAllV??B=26212*??01:*100#
For an explanation of how to define prepaid SIMs in the route.cfg, please refer to Chapter 8.9.1 on
page 53 .
8.9.6 SIM CARD BALANCE TRANSFER
This feature is used to transfer a balance from one or more master SIM cards to different production SIM cards.
When a production SIM card needs to be recharged, the vGATE control unit chooses a master SIM card from the
defined master carrier and starts a transfer script to transfer the balance from the master SIM card to the production
SIM card. After a successful balance transfer, the production SIM card is informed about the new balance via the
passive balance check functionality.
59
CHAPTER 8
vGATEDesktop
Make sure that SIM cards from this master carrier will not be used for production purposes by entering a prefix in
the Prefix field that is not used for a real carrier and by checking Limit Outgoing Calls to Prefix.
To connect a master SIM card with the master carrier, right-click the SIM card and select Change SIM Options...
from the shortcut menu. Select the master carriers carrier name and sub ID from the Carrier Name (Sub ID)
drop-down menu.
60
CHAPTER 8
vGATEDesktop
If the new balance is automatically communicated by the carrier, check the PP Passsive Balance Check box from
the production carriers edit window to ensure that the vGATE knows about the new balance.
Production SIM cards must have their own number entered in the SIM Options window, which you open by rightclicking a production SIM card and selecting Change SIM Options... .
In the same window, ensure that the production SIM card is linked to the production carrier by selecting this carrier
from the Carrier Name (Sub ID) drop-down menu.
61
CHAPTER 8
vGATEDesktop
8 . 9 . 6 . 3 TR A N S F E R S C R I P T E X A M P L E
The following transfer script example sends a USSD message including the number of the production SIM card to
the carrier of the master SIM card. It parses and handles the USSD answer including the strings below:
successful: unblock the port of the master SIM card and end the script.
successfully: unblock the port of the master SIM card and end the script.
unsuccessful: write an error string and an error value (10) to the database entry of the production
SIM, release the production SIM (which will be blocked because of the error value) and end the job.
_TIMEOUT_: On job timeout, write an error string and an error value (11) to the database entry of the
production SIM, release the production SIM (which will be blocked because of the error value) and end the
job.
SEND_USSD_WAIT(*444*1*<RECEIVE_NUMBER>*150*0716#,successful,sucessfully,unsuccessful, _TIMEOUT_,2)
{
UNBLOCK_PORT
END_JOB
}
{
UNBLOCK_PORT
END_JOB
}
{
CHANGE_RECEIVER_DB_STRING(sError, balance transfer unsuccessful)
CHANGE_RECEIVER_DB_INT(iError, 10)
RELEASE_RECEIVER_SIM
END_JOB
}
{
CHANGE_RECEIVER_DB_STRING(sError, balance transfer timeout)
CHANGE_RECEIVER_DB_INT(iError, 11)
RELEASE_RECEIVER_SIM
END_JOB
}
62
CHAPTER 8
vGATEDesktop
After activating the New Protocol checkbox, you must select Set Maintenance Mode
from the mobile gateways context menu to activate this feature. If you deactivate
the checkbox, you must restart the mobile gateway.
63
CHAPTER 8
vGATEDesktop
Only active SIMs can send and/or receive calls and/or SMS. No calls or SMS can be
sent when a remote connection to the mobile gateway exists. Remote tuneling is required when a remote connection to the mobile gateway exists.
8.11.1 SENDING SMS AND CALLS
If the SIM is to receive calls and SMS originating from the vGATE,
enter the SIMs call number in the Own Number box and activate the appropriate checkboxes. If you do not want the selected SIM to receive calls or SMS, leave this box blank.
To send calls and/or SMS, the following entries in the route.cfg are also required to define a mapping character
for each carrier that doesnt already have one:
MapAll<mapping character>??=<LAIN>*??01:
64
CHAPTER 8
vGATEDesktop
Example:
MapAllZ??=26201*??01:
MapAllY??=26202*??01:
MapAllX??=26203*??01:
MapAllW??=26207*??01:
Example:
MapAllSMSZ??=26201*??01:
MapAllSMSY??=26202*??01:
MapAllSMSX??=26203*??01:
MapAllSMSW??=26207*??01:
DATA
DATA
DATA
DATA
You must also set carriers on the vGATEDesktop as described under Chapter 8.8 . If you are not using a carriers
prepaid SIMs, fill in only the Name, LAIN and Character for Mapping spaces and leave the others blank.
8.11.2 RECEIVING SMS AND CALLS
You can also create a list of numbers that are to receive SMS and/or calls and assign them to groups. Select SMS/
Call Receiver from the View menu or click the
button in the toolbar. The Receiver Groups window appears. All is the default group that means all messages are initially placed in one group. To add a new group, rightclick in the window and select Add and enter a name for the new group in the dialog that appears. To rename a
group, select Edit; to delete, select Delete. To open the list, right-click a specific group and select Explore.... The
Receive Numbers list will appear.
Now you can select Add or Edit from the Receive Numbers context menu and fill in the SIMs Number. Use the
drop-down menu to select a group from which the SMS or call is to come, or select All if you prefer not to limit
calls and/or SMS to one group. The Receiver Group you have selected will appear next. Enter a number of Calls
per Month and/or SMS per Month that the SIM is to receive calls and/or SMS. Up to 9999 are possible. Calls
and SMS will be set randomly to numbers in this list and to SIMs defined to receive SMS and calls (see
Chapter 8.11.1 ). Generated calls last between 15 and 60 seconds (default).
To receive calls at defined mobile gateways, enter the following settings in the mobile gateways route.cfg:
65
CHAPTER 8
vGATEDesktop
Restrict<LAIN>=41DTMF_ 01
To receive SMS at defined mobile gateways, enter the following settings in the mobile gateways route.cfg:
Restrict<LAIN>=@FILE 05
To send an SMS, you must, of course, first define what the text contains. Each SMS can contain no more than 160
characters.
Select SMS Message List from the View menu or from the toolbar. The Receiver Groups window appears.
Double-click the receiver group whose SMS message list you want to open. A table containing all defined SMS messages appears. Right-click and select Edit to edit an existing message, Add to add a new message, Delete to
delete an existing message and Import from File to browse for a text file containing SMS. Each line in the text
file contains one SMS of up to 160 characters. The contents of the file will be imported to the SMS Messages
table. Each SMS Message can be moved to another receiver group. For more information on defining receiver
groups, please see Chapter 8.11.2 .
8.11.4 SENDING EXTERNAL SMS
To send targeted external SMS to specific defined numbers,
activate the Use group for sending external SMS checkbox in the group view editor and activate Send External
SMS in the vGATECtrl Options menu.
The default configuration saves SMS files in the folder
F:\vGATE\SMS. You can configure another path in the
registry
under
\\HKEY_CURRENT_USER\Software\TELES\vGAT
ECtrl\SMSPath.
The commands To: and Msg: must appear at the beginning of the line, but more than one message can be sent
to each recipient.
Example:
In the following example, the message Test1 is sent to both recipients 017112345678 and
017212345678. The messages Test2 and Test 3 are sent only to 017212345678.
66
CHAPTER 8
vGATEDesktop
To:017112345678
Msg:Test1
To:017212345678
Msg:Test1
Msg:Test2
Msg:Test3
vGATECtrl checks the configured folder once per minute. If new .msg files are in the folder, the SMS will be sent.
Once they have been sent, they are automatically renamed with the extension .old and an entry appears in a
.log file that is saved into the same folder.
8 . 1 1 . 5 R E T R I E V I N G A S I M S O W N N U M B E R
This feature requires special service scripting. For more information on special services and script commands, please refer to Chapter 8.12 .
For SIMs for which you have an IMSI but no telephone number, you can retrieve the number by following these
steps:
Create a special action script for sending an SMS with the IMSI to a SIM in the vGATE.
Example:
In the following special script example, the SIM cards IMSI is 123456. An SMS with the message
IMSI=123456 is sent to the SIM with the number +490179456456.
SEND_SMS(+490179456456, IMSI=123456)
END_JOB
Open the SIM Options dialog for the SIM sending the message.
Activate the appropriate checkbox, and enter the path for the special script as shown in Figure 8.34 . You can also start the script
manually by selecting Start Special Service from the context
menu in the Controller view.
Figure 8.34 Send Own IMSI
Create another script to save the OAD for the SIM with the IMSI sent. The where part of the SQL query comes from
the parse result.
Example:
In the following special script example, the telephone number for the SIM with the IMSI 123456
is entered in the SIMs OwnNumber column. The 1 is a flag to indicate that the contents of the
67
CHAPTER 8
vGATEDesktop
To perform this function, vGATE must parse incoming SMS messages for the string IMSI=. To
set up the parse configuration, open the Carrier
List. Double-click or right-click the carriers name
to open the carrier editor. Click the Special
Parse Actions button to open the Parse String
Action dialog.
Figure 8.35 Parse String Action
68
CHAPTER 8
vGATEDesktop
The .ini file containing the script is saved on the vGATE Control Unit and its path is defined under Command
File in the Special Service group box.
If you do not use remote tunneling, make sure the GATE Manager is not connected
to the mobile gateway before you run any scripts. One remote channel is active for
special services.
8.12.1 SCRIPT COMMANDS
The commands must be entered in the .ini file as follows. Please refer to Chapter 8.12.2 , which is intended
as a detailed description of format and syntax:
Table 8.4 Special Service Script Commands
Commands
ADD_MAX_LIMIT
Adds a calculated limit (integer value) to the SIM cards Max. Limit 1 field. For prepaid SIM cards only.
BLOCK_DISC_PORT
The port is blocked. If a call is active, it is disconnected. The ports link status is checked. If the link status is
not idle, the script command is stopped and will be carried out later.
BLOCK_PORT
The port will be blocked as soon as it is idle.
CANCEL_JOB_BLOCKING
Cancels blocking the SIM or controller. The job will continue to be executed.
CHANGE_DB_INT(<column>,<int>)
The set integer will be entered in the defined SIM column in the database (e.g. Priority, SIMCounter or
SIMCounter2).
CHANGE_DB_STRING(<column>,<string>)
The set string will be entered in the defined SIM column in the database (e.g. Userinfo1 or Userinfo2).
CHANGE_LIMIT
Writes a fixed calculated limit (integer value) in the SIM cards Change Limit field. For prepaid SIM cards only.
CHANGE_LIMIT_ZERO
Can be set as a wait parameter. If the calculated change limit is 0, another command can be carried out.
CHANGE_MAXLIMIT
Writes a calculated limit (integer value) in the SIM cards Max. limit 1 field. Can also be combined with
SET_MAX_LIMIT. For prepaid SIM cards only.
CHANGE_MSISDN_LIMIT(<MSISDN>,<limit>
Changes the limit for the SIM with the telephone number entered.
69
CHAPTER 8
vGATEDesktop
Commands
DONT_CARE_SIMSTATUS
The SIMs current status (registered, etc.) will be ignored.
END_JOB
Ends the job.
END_JOB_IF_VALUE_IS(<column>,<value>)
Ends the job if the value in the simcards column is a given value.
NOTE: This command must always be used before the BLOCK_PORT command.
END_JOB_IF_VALUE_IS_ABOVE(<column>,<int>)
Ends the job if the value in the simcards column is above a given integer value.
NOTE: This command must always be used before the BLOCK_PORT command.
END_JOB_IF_VALUE_IS_BELOW(<column>,<int>)
Ends the job if the value in the simcards column is below a given integer value.
NOTE: This command must always be used before the BLOCK_PORT command.
END_JOB_IF_VALUE_IS_NOT(<column>,<value>)
Ends the job if the value in the simcards column is not a given value.
NOTE: This command must always be used before the BLOCK_PORT command.
LIMIT_FAKTOR_M(<num>)
Defines the factor for calculating a limit from a wait parameter based on money values. The factor must always be entered as a float value in decimal notation (e.g. 6.0).
Example: For the following example, the entry ChargeUnitGenerate=1 (default is 10) is entered in the
mobile gateways pabx.cfg. The carrier sends a balance of 10.0. A call costs 0.24 per minute. Enter the
result of (0.24 x 100) / 60 = 0.4. Enter LIMIT_FAKTOR_M(0.4). To calculate LIMIT_FAKTOR_M using
the balance factor (BF) set in the , enter LIMIT_FAKTOR_M=100/BF.
LIMIT_FAKTOR_T(<num>)
Defines the factor for calculating a limit from a wait parameter based on time values. The factor must always
be entered as a float value in decimal notation (e.g. 6.0).
Example: For the following example, the entry ChargeUnitGenerate=1 is entered in the mobile gateways pabx.cfg. The carrier sends a balance of 24 minutes and 10 seconds. To convert this figure into seconds, enter LIMIT_FAKTOR_T(60.0).
70
CHAPTER 8
vGATEDesktop
Commands
PARSE_TO_SIMCUSTOM_STRING(<bOverwrite>,<value count>,<parse Param1>,<name of param1 in DB>,
<parseParam2>,<name of param2 in DB>,)
Parses an incoming SMS detected via Special Parse Actions in the vGATE carrier settings and saves the result
in the database:
bOverwrite: 0 or 1, 1 means old values in database are deleted before saving the new values.
value count: Count of value pairs (Param, Name in DB)
parseParam: Parse string. The syntax is the same as for wait parameters. Only string parameter (S) are allowed.
name of param in DB: Name of the value in the database.
RECHARGE_IF_LIMIT_ABOVE(<int>)
Recharge is initiated if the calculated limit is higher than the limit entered.
RECHARGE_IF_LIMIT_ABOVE_WOREL(<int>)
Recharge is initiated if the calculated limit is higher than the limit entered. The SIM is not released following
the recharge process.
RECHARGE_IF_LIMIT_BELOW(<count>)
Initiates SIM recharge and closes job if the current prepaid limit is less than the value entered.
RECHARGE_IF_LIMIT_BELOW_WOREL(<int>)
Recharge is initiated if the calculated limit is lower than the limit entered. The SIM is not released following
the recharge process.
RECHARGE_SIM
SIM is recharged after script has ended. It is best to enter this command at the end of a script to avoid overlapping remote access.
RECHARGE_SIM_WOREL
SIM recharge is initiated and the SIM is not released following recharge.
RELEASE_RECEIVER_SIM
Releases the production SIM card in a balance transfer scenario. For instance, use this command to release
a production SIM card if a balance transfer from the master to the production SIM card failed. For more details
on balance transfer, please refer to Chapter 8.9.6 on page 59
RELEASE_SIM
SIM is released at the end of the script. If possible, a new SIM will then be assigned. It is best to enter this
command at the end or branching point of a script.
RELEASEBLOCK_IF_LIMIT_ABOVE(<int>)
The SIM will be released and blocked if its balance is above the value entered.
71
CHAPTER 8
vGATEDesktop
Commands
RELEASEBLOCK_IF_LIMIT_BELOW(<int>)
The SIM will be released and blocked if its balance is below the value entered.
RELEASEBLOCK_SIM
The SIM will be released and blocked.
SAVE_OAD_IN(<column>,<flag>
Saves the OAD of a SIM from which an SMS with IMSI=<IMSI> has been sent. Set the flag at 1 to save the
number in the SIMs OwnNumber column.
SEND_DTMF(<string>)
The DTMF string is sent to the service center number. For pauses between DTMF tones, enter a p for a pause
of one second and a P for a pause of 10 seconds.
NOTE: The service center number and mapping character must appear in the Carrier List (see Chapter 8.9.4)
and the mapping entries must exist in the route.cfg .
SEND_DTMF_IF_LIMIT_ABOVE(<limit>,<string>)
If the limit goes above the value entered, a connection is set up to the service center and the defined USSD
code is sent. The service center number must be entered in the carrier list.
Enter a ^ sign in front of each wait parameter to parse the value before the query response message.
SEND_DTMF_IF_LIMIT_BELOW(<limit>,<string>)
If the limit falls below the value entered, a connection is set up to the service center and the defined DTMF
string is sent. The service center number must be entered in the carrier list.
Enter a ^ sign in front of each wait parameter to parse the value before the query response message.
SEND_DTMF_NUM(<num>,<string>)
The DTMF string is sent to the defined number (<num>). For pauses between DTMF tones, enter a p for a
pause of one second and a P for a pause of 10 seconds.
SEND_DTMF_NUM_IF_LIMIT_ABOVE(<num>,<limit>,<string>)
If the limit goes above the value entered, a connection is set up to the defined number (<num>) and the
defined DTMF string is sent.
Enter a ^ sign in front of each wait parameter to parse the value before the query response message.
SEND_DTMF_NUM_IF_LIMIT_BELOW(<num>,<limit>,<string>)
If the limit falls below the value entered, a connection is set up to the defined number (<num>) and the defined DTMF string is sent.
Enter a ^ sign in front of each wait parameter to parse the value before the query response message.
72
CHAPTER 8
vGATEDesktop
Commands
SEND_DTMF_NUM_WAIT(<num>,<string>,<waitParam1>,<waitParam2>,...,<timeout>)
The DTMF code is sent to the defined <num>. This string sets a wait for defined query response messages.
For the proper syntax of wait parameters, see the entry for SEND_USSD_WAIT.
Example of a time value:
Parsed string: 10:25:32 in hr:min:sec
Wait parameter: [T%d:%d:%d] (enter [T%d:%d] for min:sec or [T%d] for sec).
Calculation: Limit = hr x 60 x limit factor + min x limit factor + sec x limit factor / 60
Example of a money value:
Parsed string: 11.55 in .cent
Wait parameter: [M%d.%d]
Calculation:
Limit = ( x 100 + cent) / limit factor
Example of a string:
Parsed string: The number 1234567890
Wait parameter: the number.[S%s]
Enter a ^ sign in front of each wait parameter to parse the value before the query response message.
SEND_DTMF_NUM_WAIT_IF_LIMIT_ABOVE(<num>,<limit>,<string>,<waitParam1>,<waitParam2>,...,
_ELSE_,<timeout>)
If the limit goes above the value entered, a defined DTMF string is sent to the defined number (<num>) and
the system waits for a response defined using the wait parameters as long as the timeout value entered. If
the response comes before the timeout, other commands can be carried out. If the timeout is set at 0, no
timeout will be used. If the limit does not rise above the value entered, the command defined by _ELSE_ will
be carried out. Please note that _ELSE_ must be defined. This string sets a wait for defined query response
messages. For the proper syntax of wait parameters, see the entry for SEND_USSD_WAIT.
Enter a ^ sign in front of each wait parameter to parse the value before the query response message.
SEND_DTMF_NUM_WAIT_IF_LIMIT_BELOW(<num>,<limit>,<string>,<waitParam1>,<waitParam2>,...,
_ELSE_,<timeout>)
If the limit falls below the value entered, a defined DTMF string is sent to the defined number (<num>) and
the system waits for a response defined using the wait parameters as long as the timeout value entered. If
the response comes before the timeout, other commands can be carried out. If the timeout is set at 0, no
timeout will be used. If the limit does not fall below the value entered, the command defined by _ELSE_ will
be carried out. Please note that _ELSE_ must be defined. This string sets a wait for defined query response
messages. For the proper syntax of wait parameters, see the entry for SEND_USSD_WAIT.
Enter a ^ sign in front of each wait parameter to parse the value before the query response message.
73
CHAPTER 8
vGATEDesktop
Commands
SEND_DTMF_WAIT(<string>,<waitParam1>,<waitParam2>,...,<timeout>)
The DTMF code is sent to the service center number. This string sets a wait for defined query response messages. For the proper syntax of wait parameters, see the entry for SEND_USSD_WAIT.
Example of a time value:
Parsed string: 10:25:32 in hr:min:sec
Wait parameter: [T%d:%d:%d] (enter [T%d:%d] for min:sec or [T%d] for sec).
Calculation: Limit = hr x 60 x limit factor + min x limit factor + sec x limit factor / 60
Example of a money value:
Parsed string: 11.55 in .cent
Wait parameter: [M%d.%d]
Calculation:
Limit = ( x 100 + cent) / limit factor
Example of a string:
Parsed string: The number 1234567890
Wait parameter: the number.[S%s]
NOTE: The service center number and mapping character must appear in the Carrier List (see Chapter 8.9.4)
and the mapping entries must exist in the route.cfg.
Enter a ^ sign in front of each wait parameter to parse the value before the query response message.
SEND_DTMF_WAIT_IF_LIMIT_ABOVE(<limit>,<string>,<waitParam1>,<waitParam2>,..., _ELSE_,<timeout>)
If the limit goes above the value entered, a defined DTMF string is sent to the service center and the system
waits for a response defined using the wait parameters as long as the timeout value entered. If the response
comes before the timeout, other commands can be carried out. If the timeout is set at 0, no timeout will be
used. The service center number must be entered in the carrier list. If the limit does not rise above the value
entered, the command defined by _ELSE_ will be carried out. Please note that _ELSE_ must be defined.
Enter a ^ sign in front of each wait parameter to parse the value before the query response message. This
string sets a wait for defined query response messages. For the proper syntax of wait parameters, see the
entry for SEND_DTMF_WAIT.
SEND_DTMF_WAIT_IF_LIMIT_BELOW(<limit>,<string>,<waitParam1>,<waitParam2>,..., _ELSE_,<timeout>)
If the limit falls below the value entered, a defined DTMF string is sent to the service center and the system
waits for a response defined using the wait parameters as long as the timeout value entered. If the response
comes before the timeout, other commands can be carried out. If the timeout is set at 0, no timeout will be
used. The service center number must be entered in the carrier list. If the limit does not fall below the value
entered, the command defined by _ELSE_ will be carried out. Please note that _ELSE_ must be defined.
Enter a ^ sign in front of each wait parameter to parse the value before the query response message. This
string sets a wait for defined query response messages. For the proper syntax of wait parameters, see the
entry for SEND_DTMF_WAIT.
74
CHAPTER 8
vGATEDesktop
Commands
SEND_RNDREC_SMS(<recipientcount>,<recipient1>,<recipient2>,...,<message>)
Sends an SMS message to a random recipient out of up to 16 recipients. In recipientcount, enter the number
of recipients.
SEND_RNDREC_SMS_WAIT(<recipientcount>,<recipient1>,<recipient2>,...,<message>,<waitParam1>,
<waitParam2>,...,<timeout>)
Sends an SMS message to a random recipient out of up to 16 recipients and waits for a defined response. In
recipientcount, enter the number of recipients. For the proper syntax of the wait parameters, see the entry for
SEND_USSD_WAIT.
SEND_SMS(<to>,<msg>)
Sends a defined SMS (<msg>) to a defined recipient (<to>). If you enter OAD as the recipient, the SMS will
be sent to the origination number of a previously received SMS. You can also use this command to retrieve a
SIMs own number (cf. Chapter 8.11.5 on page 67 ).
NOTE: The service center number and mapping character must appear in the Carrier List (see Chapter 8.9.4)
and the mapping entries must exist in the route.cfg. SMS service numbers must appear in the
pabx.cfg.
SEND_SMS_IF_LIMIT_ABOVE(<limit>,<to>,<msg>)
A defined SMS is sent to the number entered if the limit goes above the value entered.
SEND_SMS_IF_LIMIT_BELOW(<limit>,<to>,<msg>)
A defined SMS is sent to the number entered if the limit falls below the value entered.
75
CHAPTER 8
vGATEDesktop
Commands
SEND_SMS_WAIT(<to>,<msg>,<waitParam1>,<waitParam2>,...,<timeout>)
Sends a defined SMS and waits for a defined response. If you enter OAD as the recipient, the SMS will be sent
to the origination number of a previously received SMS. You can also use this command to retrieve a SIMs
own number (cf. Chapter 8.11.5 on page 67 ). This string sets a wait for defined query response messages.
For the proper syntax of wait parameters, see the entry for SEND_USSD_WAIT.
Example of a time value:
Parsed string: 10:25:32 in hr:min:sec
Wait parameter: [T%d:%d:%d] (enter [T%d:%d] for min:sec or [T%d] for sec).
Calculation: Limit = hr x 60 x limit factor + min x limit factor + sec x limit factor / 60
Example of a money value:
Parsed string: 11.55 in .cent
Wait parameter: [M%d.%d]
Calculation:
Limit = ( x 100 + cent) / limit factor
Example of a string:
Parsed string: The number 1234567890
Wait parameter: the number.[S%s]
NOTE: The service center number and mapping character must appear in the Carrier List and the mapping
entries must exist in the route.cfg (see Chapter 8.9.4).
Example: In the following example, the SMS send number is sent to the number 017234567890 and the
system waits for the string the number and the number that follows will be entered in the vGATEDesktop
SIM View Own Number column.
SEND_SMS_WAIT(017234567890, send number, the number.[S%s], 3)
{
SET_DB_STRING(OwnNumber)
UNBLOCK_PORT
END_JOB
}
NOTE: The service center number and mapping character must appear in the Carrier List (see Chapter 8.9.4)
and the mapping entries must exist in the route.cfg. SMS service numbers must appear in the
pabx.cfg.
Enter a ^ sign in front of each wait parameter to parse the value before the query response message.
76
CHAPTER 8
vGATEDesktop
Commands
SEND_SMS_WAIT_IF_LIMIT_ABOVE(<limit>,<to>,<msg>,<waitParam1>,<waitParam2>,...,
_ELSE_<timeout>)
If the limit goes above the value entered, a defined SMS is sent to the number entered and the system waits
for a response defined using the wait parameters as long as the timeout value entered. If the response comes
before the timeout, other commands can be carried out. If the timeout is set at 0, no timeout will be used. If
the limit does not rise above the value entered, the command defined by _ELSE_ will be carried out. Please
note that _ELSE_ must be defined. For the proper syntax of wait parameters, see the entry for
SEND_USSD_WAIT.
Enter a ^ sign in front of each wait parameter to parse the value before the query response message.
SEND_SMS_WAIT_IF_LIMIT_BELOW(<limit>,<to>,<msg>,<waitParam1>,<waitParam2>,...,
_ELSE_<timeout>)
If the limit falls below the value entered, a defined SMS is sent to the number entered and the system waits
for a response defined using the wait parameters as long as the timeout value entered. If the response comes
before the timeout, other commands can be carried out. If the timeout is set at 0, no timeout will be used. If
the limit does not fall below the value entered, the command defined by _ELSE_ will be carried out. Please
note that _ELSE_ must be defined. For the proper syntax of wait parameters, see the entry for
SEND_USSD_WAIT.
Enter a ^ sign in front of each wait parameter to parse the value before the query response message.
SEND_USSD(<code>)
The USSD code is sent to the service center number. The service center number and mapping character must
appear in the Carrier List.
NOTE: The service center number and mapping character must appear in the Carrier List (see Chapter 8.9.4)
and the mapping entries must exist in the route.cfg.
SEND_USSD_IF_LIMIT_ABOVE(<limit>,<string>)
If the limit goes above the value entered, a connection is set up to the service center and the defined USSD
code is sent. The service center number must be entered in the carrier list.
Enter a ^ sign in front of each wait parameter to parse the value before the query response message.
SEND_USSD_IF_LIMIT_BELOW(<limit>,<string>)
If the limit falls below the value entered, a connection is set up to the service center and the defined USSD
code is sent. The service center number must be entered in the carrier list.
Enter a ^ sign in front of each wait parameter to parse the value before the query response message.
77
CHAPTER 8
vGATEDesktop
Commands
SEND_USSD_WAIT(<code>,<waitParam1>,<waitParam2>,...,_TIMEOUT_,<timeout>)
The USSD code is sent to the service center number. This string sets a wait for defined query response messages. You must set the limit parsing definition[T%d:%d:%d], [M%d.%d] or [S%s] if a limit is to be
parsed based on a string (S) and/or calculated based on time (T) or money (M). The entry
LIMIT_FAKTOR_M or LIMIT_FAKTOR_T must also be set in this case. Wait parameters must be separated by a comma. Two time entries can appear separated by a pipe (|). For example, [T%d:%d:%d |
%d:%d]. You can set two strings together by entering an & sign between them. For example, balance:
[M%d.%d:%d] & bonus: [M%d.%d]. The two resulting values will be added together and calculated
with the balance factor to form the limit. If no second value exists, only the first will be calcultated. If no first
value exists, there will be no result. The job is closed if no answer is recognized in the number of minutes set
for a timeout. Each wait parameter requires a branch, defined by {...}. If the timeout is set at 0, no timeout
will be used. If you enter _TIMEOUT_, in front of a defined <timeout>, a new command will be carried out
if a response does not occur for a wait parameter in the allotted time. Each_TIMEOUT_ requires a branch for
the alternative command, defined by {...}. Each final set of brackets must end with the command
END_JOB.
Example of a time value:
Parsed string: 10:25:32 in hr:min:sec
Wait parameter: [T%d:%d:%d] (enter [T%d:%d] for min:sec or [T%d] for sec).
Calculation: Limit = hr x 60 x limit factor + min x limit factor + sec x limit factor / 60
Example of a money value:
Parsed string: 11.55 in .cent
Wait parameter: [M%d.%d]
Calculation:
Limit = ( x 100 + cent) / limit factor
NOTE: The service center number and mapping character must appear in the Carrier List (see Chapter 8.9.4)
and the mapping entries must exist in the route.cfg.
Enter a ^ sign in front of each wait parameter to parse the value before the query response message. This
applies for all commands with wait parameters.
SEND_USSD_WAIT_IF_LIMIT_ABOVE(<limit>,<string>,<waitParam1>,<waitParam2>,.., _ELSE_,<timeout>)
If the limit goes above the value entered, a defined USSD code is sent to the service center and the system
waits for a response defined using the wait parameters as long as the timeout value entered. If the response
comes before the timeout, other commands can be carried out. If the timeout is set at 0, no timeout will be
used. The service center number must be entered in the carrier list. If the limit does not rise above the value
entered, the command defined by _ELSE_ will be carried out. Please note that _ELSE_ must be defined.
Enter a ^ sign in front of each wait parameter to parse the value before the query response message. This
string sets a wait for defined query response messages. For the proper syntax of wait parameters, see the
entry for SEND_USSD_WAIT.
78
CHAPTER 8
vGATEDesktop
Commands
SEND_USSD_WAIT_IF_LIMIT_BELOW(<limit>,<string>,<waitParam1>,<waitParam2>,...,_ELSE_,<timeout>)
If the limit falls below the value entered, a defined USSD code is sent to the service center and the system
waits for a response defined using the wait parameters as long as the timeout value entered. If the response
comes before the timeout, other commands can be carried out. If the timeout is set at 0, no timeout will be
used. The service center number must be entered in the carrier list. If the limit does not fall below the value
entered, the command defined by _ELSE_ will be carried out. Please note that _ELSE_ must be defined.
Enter a ^ sign in front of each wait parameter to parse the value before the query response message. This
string sets a wait for defined query response messages. For the proper syntax of wait parameters, see the
entry for SEND_USSD_WAIT.
SET_DB_STRING(<column>)
If a string was parsed in a previous response message, this string will be entered in the defined SIM column
in the database.
SET_DB_STRING_PARSE(<parseparam>,<column>)
If a string was parsed in a previous response message or if the script was started by carrier-specific actions,
this SMS or string will be parsed according to the parse parameter and entered in the defined SIM column in
the database.
EXAMPLE: SET_DB_STRING_PARSE(balance [S%s] , UserInfo2)
SET_DB_TIMEVAL(DBField)
The current timestamp appears in the DBFIELD in the database.
SET_DB_USEREG_STRING(<column>)
Saves a parse result string into the defined column of the user registration table in the database.
SET_MAX_LIMIT(<val x>,<val y>)
Changes the CHANGE_LIMIT to val y if the calculated limit is greater than val x. If the calculated limit
is less than val x, the calculated limit will be used. CHANGE_LIMIT must be set for this command to be
carried out.
SET_MIN_LIMIT(<val x>,<val y>)
Changes the CHANGE_LIMIT to val y if the calculated limit is greater than 0 and less than val x. This
command must appear before the WAIT commands.
SET_SIM_BK_COLOR(<r,g,b>)
Enter RGB values, separated with commas, to change the SIM background colors.
SET_TIMEOUT(<count>)
A number of minutes can be entered here to set a timeout for scripts without a WAIT function. Only whole
numbers are allowed.
79
CHAPTER 8
vGATEDesktop
Commands
SLEEP(<millisec>)
Sets a pause (in milliseconds) in the job.
TARIFF_LIMIT_FAKTOR(<major currency unit/minute>,<ChargeUnitGenerate>)
The limit factor is aturomatically calculated based on the values entered. Eliminated the need to calculate
LIMIT_FAKTOR_M.
EXAMPLE: For charges of 0.25/minute and a ChargeUnitGenerate of 1, the entry would look like this:
TARIFF_LIMIT_FAKTOR(0.25, 1)
NOTE: This entry cannot be used in conjunction with LIMIT_FAKTOR_T or LIMIT_FAKTOR_M
UNBLOCK_PORT
The port is unblocked.
WAIT_MSG(<waitparam1>,<waitParam2>,...,<timeout>)
Sets a wait for defined messages. This string sets a wait for defined messages. For the proper syntax of wait
parameters, see the entry for SEND_USSD_WAIT.
Example of a time value:
Parsed string: 10:25:32 in hr:min:sec
Wait parameter: [T%d:%d:%d] (enter [T%d:%d] for min:sec or [T%d] for sec).
Calculation: Limit = hr x 60 x limit factor + min x limit factor + sec x limit factor / 60
Example of a money value:
Parsed string: 11.55 in .cent
Wait parameter: [M%d.%d]
Calculation:
Limit = ( x 100 + cent) / limit factor
NOTE: Enter a ^ sign in front of each wait parameter to parse the value before the query response message.
80
CHAPTER 8
vGATEDesktop
Variables
<RECHARGE_CODE>
This variable is used in a Send command as a place holder within the <code> or <string> parameters. During
script run, the variable is replaced by the the SIM cards recharge code which is taken from the recharge list.
If no code can be found, the script is cancelled with an error message.
<RECEIVER_NUMBER>
This variable is used in a Send command as a place holder within the <code>, <string>, or <to> parameters.
During script run, the variable is replaced by the the receiving (production) SIM cards own number. Use this
variable in a balance transfer scenario. For an example, please see Chapter 8.9.6.3 on page 62 .
81
CHAPTER 8
vGATEDesktop
If the wait string account status does not occur within five minutes, the command entered for _TIMEOUT_
will be carried out: The CHANGE_DB_STRING account status not received will appear in the UserInfo1
field of the database. The SIM will be released and blocked.
LIMIT_FAKTOR_M(0.4)
LIMIT_FAKTOR_T(60.00)
SET_MIN_LIMIT(9,10)
BLOCK_PORT
SLEEP(5000)
SEND_USSD_WAIT(*100#,account status: [M%d.%d], _TIMEOUT_, 5)
{
RECHARGE_IF_LIMIT_BELOW(2000)
SEND_USSD_WAIT(*123*12*01#, is active, has been activated, 5)
{
BLOCK_PORT
SEND_USSD_WAIT(*125#, special rate: [T%d:%d], 5)
{
BLOCK_PORT
CHANGE_LIMIT
UNBLOCK_PORT
END_JOB
}
}
{
BLOCK_PORT
SEND_USSD_WAIT(*125#, special rate: [T%d:%d], 5)
{
BLOCK_PORT
CHANGE_LIMIT
UNBLOCK_PORT
END_JOB
}
}
}
{
8 . 1 3 D E F I N I N G T H E S I M S P R O T O C O L
Near the bottom of the left side of the SIM Options dialog,
you can select which protocol will be used for dual SIMs. If you
select Automatic (default), the vGATE will set the protocol
based on that of the mobile gateway. If the mobile gateway is
UMTS, the SIM will be assigned as a UMTS SIM; if the mobile
gateway is GSM, the SIM will be assigned as a GSM SIM.
If you select UMTS, the SIM will be assigned as a UMTS SIM, regardless of the protocol on the mobile gateway. If
you select GSM, the SIM will be assigned as a GSM SIM, regardless of the mobile gateways protocol. If you try to
assign a UMTS SIM to a GSM iGATE or vice versa, a confirmation dialog will appear.
This option is only possible with vGATE SIM Unit Version 29 or higher. The vGATE SIM
Unit Version 29 is compatible only with vGATE Version 12.0 or higher.
82
CHAPTER 8
vGATEDesktop
83
CHAPTER 8
vGATEDesktop
To set up a mobile gateway and assign it to a group, please follow the instructions in Chapter 8.1 . You may
want to include additional options for mobile gateways, which can be entered into the edit window. Here is a description of the information that can be entered:
These settings must correspond with the settings on the individual mobile gateway.
We recommend that you do not change the default port number.
Entry
Description
iGate
Name
IP Address
Port
Number of CTRLs
Position
Enter the X and Y coordinates you have calculated for the mobile gateways position.
Serial #
Group
Type
Activate this checkbox to reserve port 4446 for tunneling. This ensures
that the connection between the vGATE and the mobile gateways remains unobstructed when the GATE Manager is connected to the mobile
gateway. The vGATE uses this port to generated calls and SMS and for
SIM recharging and special scripting. The following entry must be made
in the mobile gateways pabx.cfg:
MoipPort2=4446
If the local IP address and the public host address are entered in the
vGateConfig, you can set this flag to send the vGATE SIM Units local IP
address to the mobile gateway. This is useful when the mobile gateway
can reach the vGATE SIM Unit at its local IP address or if both devices are
in the same location.
New Protocol
Activate this checkbox to send the settings from the carrier list to the mobile gateways (version 14.6 or higher). See Chapter 8.10 .
84
CHAPTER 8
vGATEDesktop
Entry
Description
<V14.6
Activate this checkbox to send the settings from the carrier list to the mobile gateways which have a version older than 14.6.
Telit G3 Modules
Remote Access
Enter the following information if you want to alter or secure remote access to the mobile gateway using GATE Manager.
Port
Leave this space empty to use the default port for GATE Manager access.
Password
User
Enter the user name configured to transfer files in GATE Manager via FTP.
Password
Enter the password configured to transfer files in GATE Manager via FTP.
Port
Enter the port for using the GATE Manager to transfer files via FTP. Default 21.
This section is for setting the number of registration retries before a SIM
is blocked.
ASR low
If you set log only (recommended) and select Single, an error message
will be entered in the database if the ports ASR falls below 30%. If you
select Multiple, an error message will be entered in the database if the
ports ASR falls below 30% 3 times. If you set a number, the SIM will be
released and reassigned as often as entered. After unsuccessful retries
have occurred as many times as entered, the SIM will be blocked.
A port will be blocked if it has had to restart the number of times entered.
If you set log only (not recommended), an error message will be entered
in the database when the amount set is reached.
85
CHAPTER 8
vGATEDesktop
Entry
Description
When this box is checked, SIMs will be blocked after the number of SIM
barred occurrences entered.
Get Files
Activate the checkbox to retrieve the corresponding log file(s) at the time
entered.
Get File 1
Get File 2
You can enter settings for retrieving other log files here. For example, to
retrieve CDRs from 3 days ago, enter the following:
/data/cdr%date:ymd-3%0.log. For mobile gateways that do
not contain a compact flash, enter the following:
/boot/cdr%date:ymd-1%0.log.
To retrieve a failed log, enter:
/boot/failed%date:ymd-1%0.log
Enter the time at which CDRs Filename 1 are to be retrieved daily. Three
unssuccessful retrieval attempts will result in a retrieval pause of six
hours, after which a new attempt is made.
86
CHAPTER 8
vGATEDesktop
Entry
Description
Limit Call/SMS
Generation
This group box allows you to set a limit for generation of calls and/or
SMS.
This option allows you to set a maximum number of calls that can be
started simultaneously from different mobile gateways. Enter the maximum number or check No limit if you do not want to set a limit.
This option allows you to set a maximum number of SMS that can be
started simultaneously from different mobile gateways. Enter the maximum number or check No limit if you do not want to set a limit.
User Information
You can enter two user information strings, which will then appear in the
User Info 1 and User Info 2 columns. If you activate Save Maintenance Actions in User Info in the Options menu, an entry will appear
in the defined user info column every time maintenance mode is set or
reset.
87
CHAPTER 8
vGATEDesktop
Warning
Message
Warning
Minor
Major
Critical
88
CHAPTER 8
vGATEDesktop
Select the Export to File from the context menu to export the report to a .txt, .xls or .slk file
The window contains the following information:
Table 8.8 SIM History
Column
Description
Timestamp
Position
Gateway
Ctrl #
Status
Category
The following icons appear in the upper left-hand corner of the window:
Table 8.9 SIM History Icons
Icon
Description
Click this icon to actualize the information displayed in the history. All new information will be retrieved from the database.
Click this icon to call up a dialog to set filters. Check the filters you would like to set and enter the
corresponding information. Click OK to activate the filters. Only the information you have selected
will be displayed.
Click this icon to deactivate the filters you have set for this SIM. All available information will be displayed in this SIMs history if you click this icon.
89
CHAPTER 8
vGATEDesktop
8 . 1 7 v G AT E S T A T I S T I C S
You can call up SIM statistics and call statistics for SIMs, controllers, mobile gateways and for groups. The
vGATEDesktop can also display line charts with various statistical information for mobile gateways and for groups.
Values are calculated serially every 5 to 60 seconds, depending on the number of controllers. Statistics from the
current and previous months are saved in the database. The following values appear in at least one of the various
statistic windows:
Table 8.10 vGATEDesktop Statistics
Statistic
Definition
ACD
The Average Call Duration is the average length of calls on the SIM.
ASR1
The Answer Seizure Ratio is the percentage of calls that result in a connection. ASR1
does not regard connection attempts aborted by the A subscriber as aborted connections.
ASR2
The Answer Seizure Ratio is the percentage of calls that result in a connection. ASR2
regards connection attempts aborted by the A subscriber as aborted connections.
Assign Time
Carrier
Connected Calls
Shows the number of successfully connected calls placed using the SIM.
Ctrl
Dur/Asn
Shows the percentage of the Assign Time that the card was connected.
Duration
Shows the amount of time the SIM was connected while it was assigned.
Gateway
Shows the name of the mobile gateway on which the SIM was active.
Incoming Calls
Outgoing Calls
Position
Remote Busy
Timestamp
IMSI
Own Number
Disconnected
90
CHAPTER 8
vGATEDesktop
You can access averaged SIM statistics for marked SIMs, controllers and mobile gateways clicking the corresponding
icon in the toolbar and use the drop-down menu to select beginning and ending dates for the statistics
displayed. You can also access averaged SIM statistics for marked SIMs, controllers, mobile gateways and groups
through the context menu in the respective view:
SIM view: select SIM Statistics from the Reports submenu in the context menu.
controller view: select Show SIM Statistics from the context menu or from the context menu in the
Show Call Statistics window (see Chapter 8.17.2).
mobile gateway view: select Show SIM Statistics from the context menu in the Show Call Statistics
window (see Chapter 8.17.2).
group view: select Show SIM Statistics from the context menu in the Show Call Statistics window
(see Chapter 8.17.2).
8.17.2 CALL STATISTICS
You can access averaged call statistics for mobile gateways or groups by clicking the
icon in the toolbar.
Select Show Call Statistics from the context menu in the controller, mobile gateway or group view to display
statistics for the marked element. Using the drop-down menu, you can set filters in the dialog that appears. Select
91
CHAPTER 8
vGATEDesktop
a Carrier to display call statistics only for one carrier. Use the drop-down calendar in Begin and End to limit the
statistics to calls for a specific time frame. To display call statistics for a specific Timezone, select a Timezone from
the list.
8.17.3 CALL CHARTS
You can access a line chart with averaged call statistics by clicking the
icon in the toolbar or by selecting Show Call Chart in the
mobile gateway or group view. Using the drop-down menu, you can
set filters in the dialog that appears. Select a Carrier to display call
statistics only for one carrier. To limit the statistics to calls for a specific
Week, select daily for the current day, current for the current week,
current - 1 for last week, current - 2 for two weeks ago, and so on.
Figure 8.44 Call Chart Filter
8 . 1 8 WH A T T H E I N F O R M A T I O N O N T H E v G AT E D e s k t o p M E A N S
The windows listing mobile gateways, controllers and SIMs appear in table form. Each window contains information listed in columns. You can change the position of the columns by left-clicking the column heading and dragging it to the desired position. You can reverse the order of the rows in each window by clicking the heading with
the arrow.
92
CHAPTER 8
vGATEDesktop
Column
Description
Mobile Gateways
Name
Address
Status
Serial#
Shows the mobile gateways serial number (second generation mobile gateways
only).
System Type
User Info 1
User Info 2
Controllers
CTRL
Active Position
Lists the SIMs that are currently active at the corresponding port.
Refers to the position of all SIMs reserved with Max Limit 1 to the controller.
Refers to the position of all SIMs reserved with Max Limit 2 to the controller.
Limit Choice
Lists which settings have been defined in Advanced Limit Choice (see context
menu Table 8.15 ). All is the default setting.
Current Limit
Remote State
Contains status messages for the controller sent by the mobile gateway.
CTRL Info
Action
Lists actions currently being carried out. Possibilities are Release and Search and
Assign.
SIM Info 1
Shows Info 1 comments you have entered for the SIM that is currently active.
Error
93
CHAPTER 8
vGATEDesktop
Column
Description
Status
UMTS
RSSI
ASR1
ASR2
ACD
SIMs
Position
Lists SIM cards by their positions in the SIM 60 Carrier. The syntax for the position
numbers is <vGATE SIM Unit>.<vGATE Module>.<SIM position>. The list is colorcoded, so that all the positions listed on the same background color represent one
vGATE Module.
Color
Lists the colors that have been set to mark individual SIMs, e.g. according to carrier.
IMSI
Shows the limit (in 10-second time units) at which the mobile gateway will change
to the next SIM.
Max Limit 1
Shows the number of 10-second units after which the SIM will no longer be used for
timezones to which it has been assigned with Max Limit 1.
Count (L1)
Max Limit 2
Shows the number of 10-second units after which the SIM will no longer be used for
timezones to which it has been assigned with Max Limit 2.
Count (L2)
Limit A/B/C
Shows the advanced limits that have been set for this SIM.
Count A/B/C
Shows the number of advanced limit units that have been used for this SIM.
Last Use
Status
Pause
Shows the length of the pause set for this SIM after each release.
Priority
94
CHAPTER 8
vGATEDesktop
Column
Description
Error
Shows error messages. The line also appears highlighted in red or yellow.
If Reset SIM Counter Daily is set in the vGATECtrl, this column shows the Max
Limit 1 units used on the previous day.
If Reset SIM Counter Daily is set in the vGATECtrl, this column shows the Max
Limit 2 units used on the previous day.
Current Count
Own Number
SMS Count
Shows the ratio of the number of SMS that have been sent to the number configured
to be sent.
Next SMS
Call Count
Shows the ratio of the number of outgoing calls that have been sent to the number
configured to be sent.
Next Call
Shows when the SIM will make the next outgoing call.
Info 1
Info 2
Active Release
Shows the number of minutes you have defined that a SIM will be active before it is
released.
Call/SMS Flags
Shows any flags that have been set for sending and receiving SMS. The following are
possible:
RC
Receive calls
RS
Receive SMS
CoS
Count only successful calls
Grp
Send only to same group
Col
Send only to same color
Shows any flags that have been set for special services. The following are possible:
A
After Assign
L
On Change Limit Reached
D
Daily between the defined times
E
On Each Limit Ind. (PP)
Assign Offset
Shows a random number of seconds between those defined in the Limits dialog (see
Chapter 8.6 ).
95
CHAPTER 8
vGATEDesktop
Column
Description
Used per TZ
Upgrades/Week
Lists how often a SIM has been recharged in the current week/how many recharges
per Week have been set.
Upgrades/Month
Lists how often a SIM has been recharged in the current month/how many recharges
per month have been set.
Carrier Sub ID
Route Priority
Lists the priority set for calls over this SIM. Route priority is available in versions 14.6
or higher and is set between 1 and 10, with 10 being the highest priority (default 5).
NOTE: Route priority is only active if New Protocol has been set in the edit window.
Serial Number
Lists serial numbers entered for SIMs using the Change Serial Number function in
the context menu. If no serial number has been entered, none will appear.
Known Since
PPCount SLR
Prepaid Count Since Last Recharge shows the number of 10-second units that have
been used since the last time the SIM was recharged. The counter is reset after the
SIM has been recharged.
Shows the number of minutes the SIM will be used on any given day before it is
blocked.
8 . 1 9 v G AT E D e s k t o p I C O N S
Table 8.12 lists the icons that appear on the vGATEDesktop and their meanings.
Table 8.12 vGATEDesktop Icons
Icon
Definition
Groups
No errors exist on the mobile gateways in this group.
An error exists on at least one mobile gateway in the group.
A mobile gateway in this group is currently in maintenance mode. Select Reset Maintenance Mode
from the context menu to reactivate the groups mobile gateway.
96
CHAPTER 8
vGATEDesktop
Icon
Definition
A light-blue line around the icon signifies that the groups has been defined as the default group.
Mobile Gateways
No errors exist on this mobile gateway.
This mobile gateway is not available.
This mobile gateway is currently in maintenance mode. Select Reset Maintenance Mode from the
context menu to reactivate the mobile gateway.
This mobile gateway has been improperly configured. Check the configuration and, if necessary, install
the proper driver for vGATE implementation.
Controllers
A SIM has been assigned to this port.
No SIM has been assigned to this port.
This port is in the process of carrying out an action.
This is a UMTS port from a iGATE 3G.
SIMs
This GSM SIM is currently assigned to a port.
This GSM SIM is not currently assigned to a port.
This GSM position is empty. No SIM is inserted.
A previously set pause is currently active on this GSM SIM or the value set for Maximum Usage per
TZ has been reached.
This SIM is a UMTS SIM. This icon also appears in all of the above colors, depending on the SIMs status.
This icon indicates a dual SIM. This icon also appears in all of the above colors, depending on the SIMs
status. A gray U on the icon indicates that the SIM has been set to GSM, a gray G indicates it has been
set to UMTS. If neither the U nor the G are gray, the SIM has been set to automatic.
97
CHAPTER 8
vGATEDesktop
Icon
Definition
Signifies a prepaid SIM that does not recharge automatically.
Signifies a prepaid SIM that recharges automatically.
Indicate SIMs that have been blocked. Only inactive SIMs can be blocked manually.
Indicates that the SIM has been decommissioned. Decommissioned SIMs will never be assigned again.
An assigned SIM will not automatically be released after reaching the decommission date.
Command
Definition
File Menu
Exit
View Menu
Timezones List
Click here to open a list containing an overview of timezones for the selected
group.
Carrier List
Click here to open and edit a table containing information about prepaid recharge numbers.
Click here to open and edit a table containing SMS messages sent by the system.
SMS/Call Receiver
Click here to open receiver groups and edit a table containing numbers that
are to receive calls and/or SMS.
Holidays List
Click here to open the list of holidays set in the Holidays timezone.
Status Bar
Click here to hide or display the status bar. The number of SIMs and SIM 60
Carriers is displayed in the middle of the status bar and the time and date of
the vGATE Control Unit is on the right.
Toolbar
98
CHAPTER 8
vGATEDesktop
Command
Definition
Split
Click here for a resize cursor to adjust the size of the windows on the
vGATEDesktop.
Refresh
Click here to call up a list of SIMs once in the vGATE SIM Unit that have been
removed. Right-click a SIM to Delete from Database.
SIMCarrier Status
Calls up a window containing the status of the SIM 60 Carriers in the vGATE
SIM Unit.
Options Menu
Inhibit Modification of Timezones
Click here to lock timezones in their current position. The deactivate this option, click here again.
Click here to open a dialog box where you can choose where to store the
maintenance information.
Help
About vGATEDesktop
Click here to view version information for the vGATEDesktop and vGATECtrl
installed.
8 . 2 1 v G AT E D e s k t o p T O O L B A R
The vGATEDesktop toolbar facilitates quick access to the following functions and information:
Table 8.14 vGATEDesktop Toolbar Buttons
Icon
Function
Click here to open a list of all Timezones for the selected group.
Click here to open the list of holidays set for the Holiday Timezone.
Click here to call up a window containing the status of the SIM 60 Carriers in the vGATE SIM Unit.
99
CHAPTER 8
vGATEDesktop
Icon
Function
Click here to open and edit a table containing information about prepaid recharge numbers.
Click here to open and edit a list of SMS sent by the system.
Click here to open and edit a list of SIMs receiving SMS and calls.
Click here to open the GATE Manager. This button is active only when a mobile gateway is selected.
Click here to open a table containing information about the SIM route for the selected mobile gateway.
Click here to open a table containing information about the SIM route for the selected controller.
Click here to open a table containing information pertaining to the selected SIMs configuration.
Click here to open a table containing information about the selected SIMs implementation schedule.
Click here to open a table containing information on the selected SIMs implementation history.
Click here to call up a record averaged statistics for the marked SIMs, controllers or mobile gateways,
depending on which of these icons you click.
Click here to open a table containing information on how much and when selected SIMs have been
used.
Click here to open a table containing information about when the selected SIMs were last released.
100
CHAPTER 8
vGATEDesktop
Icon
Function
Click here to call up a table containing information on SIMs released below a defined count.
Click here to call up a table containing information on SIMs that have reached their defined change
limit.
Click here to call up a table containing information on SIMs that have reached their defined maximum limit.
Click here to call up a table containing information on SIM errors that have occurred.
Click here to call up a table containing call statistics for the selected mobile gateway or group.
Click here to call up a line chart of call statistics for the selected mobile gateway or group.
Click here to view version information pertaining to the vGATEDesktop and vGATECtrl.
Command
Definition
Groups
Create Group
Edit Group
Click here to change the name or dynamic pauses for an existing group.
Delete Group
101
CHAPTER 8
vGATEDesktop
Command
Definition
Contains a record of the averaged statistics for all calls that have gone
through this group.
Contains statistic charts for all calls that have gone through this group.
Opens a dialog into which you can select a group to which you can import
the holiday settings for the group marked. Activate the checkbox Delete
Destination to delete the current settings in the destination group. If this
checkbox is not active, the new settings will be added to the old ones.
Click here to define the marked group as the default group. New gateways
will automatically be added to this group.
mobile gateways
Add New
Click here to call up the edit window (cf. Chapter 8.15 on page 83 ). Use
the edit window to add a new mobile gateway. We recommend that you use
automatic mobile gateway registration to add new mobile gateways
(cf. Chapter 8.1 on page 33 ).
Delete
Edit
Click here to call up the edit window (cf. Chapter 8.15 on page 83 ). Use
the edit window to change an existing mobile gateway.
Copy Timezone
Configuration to GW
Use the drop-down list box to select a mobile gateway and click OK. The timezone configuration for the marked mobile gateway will be copied into the
mobile gateway you select from the list.
Change Group
Use the drop-down list box that appears to switch this mobile gateway to
another group.
Causes the mobile gateway to release all of its SIMs immediately. All calls
will be torn down. If you have activated Save Maintenance Actions in
User Info in the mobile gateways Options menu, a dialog will appear
where you can edit the information that will appear in the defined user info
column every time maintenance mode is set or reset.
102
CHAPTER 8
vGATEDesktop
Command
Definition
Reconnects the SIMs released when Set Maintenance Mode was selected. If you have activated Save Maintenance Actions in User Info in the
mobile gateways Options menu, a dialog will appear where you can edit
the information that will appear in the defined user info column every time
maintenance mode is set or reset.
Reinit
Initiates a check of the mobile gateways status against the database. Inconsistencies will correct themselves automatically. Wherever possible, SIMs will
be assigned to empty controllers.
Start Remote
Opens GATE Manager for remote access. A folder with the name Remote is
automatically created in the vGateControl directory the first time you start
GATE Manager. Sub-folders for each mobile gateway selected will also be
created automatically.
Contains a record of the averaged statistics for all SIMs used by this mobile
gateway.
Contains a record of the averaged statistics for all calls that have gone
through this mobile gateway.
Contains statistic charts for all calls that have gone through this mobile gateway.
103
CHAPTER 8
vGATEDesktop
Command
Default Configuration For New
GWs
Definition
Select this option to use the configuration for this mobile gateway as the default configuration for all new gateways. The following configuration settings apply:
Use Remote Tunnel
Always Use Local SIM Unit Address
Remote Access
Use FTP for File Transfer
Remote State Actions
Occurrence Before Reassign SIM
Get Files (Get CDR, Failed Log)
Controllers
Release SIM
Release SIM
Immediately
Click here or press Ctrl+I to release the SIM immediately, even if traffic is
running on it.
Release SIM
Immediately and Block
The SIM will be released immediately, even if traffic is running on it, and the
controller will be blocked.
Assign SIM
Click here or press Ctrl+A to activate a reserved SIM. If multiple SIMs are reserved, the one that has the highest assign priority will be activated. If no
assign priority has been set, or if SIMs share the same assign priority, the
SIM that has the highest route priority will be used. Route priority is available
in versions 14.6 or higher and is set between 1 and 10, with 10 being the
highest priority (default 5).
NOTE: Route priority is only active if New Protocol has been set in the edit
window.
Reassign SIM
Click here or press Ctrl+S to release and reassign the SIM or SIMs. This is
useful when an active SIMs parameters (e.g. limits) have been changed.
Stop Recharging
Stop Assigning
Click here to interrupt the assign phase for the marked controller(s). This is
useful when a SIM has been assigned to two controllers simultaneously,
blocking one controller. This function will unblock the controller.
104
CHAPTER 8
vGATEDesktop
Command
Definition
Click here to open a dialog where you can define which SIM limits will be
assigned to this controller. Set Preferred to use SIMs with different limits if
the set limits are not available. Set Mandatory if only SIMs with the defined
limits are to be used. Major refers to max limits and limits A, B, and C are
advanced limits. Bear in mind that no prepaid SIMs will be assigned to controllers where Mandatory has been set here. Postpaid SIMs will be assigned only if Use Limits One By One is active in the Carrier List Advanced
Limit Charges.
Click here to edit the information that appears in the CTRL Info column.
Click here to call up a dialog from which you can add or delete individual
SIMs from their reserved Limit 1 and/or Limit 2 positions.
Use the submenu to remove SIMs from All, Limit 1 or Limit 2 reserved positions on the marked controller(s). SIMs that are currently active cannot be
removed.
Click here to remove error entries from and unblock this controller. After the
message has been removed, the SIM can be reassigned.
Contains a record of the averaged statistics for SIMs that have been active
at this controller.
Contains a record of the averaged statistics for all calls that have gone
through this controller.
SIMs
Change Limits
Click here or press Ctrl+L to call up a dialog that allows you to set and
change a SIMs settings, such as limits and pauses. Bear in mind that you
must reassign the SIM after you change a SIMs limit (see Chapter 8.6 on
page 8-41).
105
CHAPTER 8
vGATEDesktop
Command
Change Priority
Definition
Calls up a drop-down list box from which you can define the SIMs Assign
Priority and Route Priority. If multiple SIMs are reserved, the one that has
the highest assign priority will be activated. If no assign priority has been set,
or if SIMs share the same assign priority, the SIM that has been idle longest
will be used.
Route priority sets a priority for calls over the SIM. The assigned SIM with the
highest route priority will be used to terminate calls. Route priority is available in versions 14.6 or higher and is set between 1 and 10, with 10 being
the highest priority (default 5).
NOTE: New Protocol must be active in the edit window.
Calls up a dialog in which you can enter and edit the number of SMS or calls
sent per month, information that will appear in the Info 1 and Info 2 and
the SIMs own number. Special services can also be activated here.
Click here to call up a color palette, from which you can color-code SIMs, e.g.
by carrier. The color selected appears in the Color column, the Active Position column of the controller window and in the SIM Route window.
Click here to enter or change a SIMs serial number. The number will appear
in the Serial Number column.
Change PIN
All PINs in the vGATE are set at 0000. If a SIM has a different PIN, select this
option to change the PIN to 0000. This option is active only when the selected SIMs PIN is not set at 0000.
Click here to open a dialog into which you can enter user registration for the
selected SIM.
106
CHAPTER 8
vGATEDesktop
Command
Definition
Add SIM(s)
Remove SIM(s)
107
CHAPTER 8
vGATEDesktop
Command
Color Template
Definition
The following options are possible:
Apply Template Settings To Selected SIM: The individual color
template settings will by applied to all selected SIMs.
Apply Template Settings To All SIMs With Current Color:
The template settings will be applied to all SIMs with the same color
as the SIM marked.
Save Settings as Template For Current Color: The settings for
the marked SIM will be saved as the template for that color.
A
will appear in the Status column of any SIMs to which the color template settings have been applied.
The color template applies for the following settings:
Maximum Call Duration
Maximum Call Duration Per Day
Minimum Remaining
Maximum Calls Per Day
Minimum Pause after Last Use
Active Release:
Calls After Assign
SMS After Assign
Incoming Calls
Call Attempts
Delay SIM Assignment on TZ Change
Reset Maintenance
Boot Indication
Block SIM On Low ACD
Use SIM on Alternating Gateways
SIM Opeions Dialog:
Call/SMS generation parameters
Special Services parameters
Priority:
Assign Priority
Route Priority
108
CHAPTER 8
vGATEDesktop
Command
Definition
Reset
Block SIM
Click here to manually block this SIM. Only inactive SIMs can be blocked
manually.
Stop Pause
Deactivates Minimum Pause after Last Use one time. The pause will be
reactivated following the next release.
Select CTRL
Click here to select the prepaid recharge number that was used last.
NOTE: This feature applies only for auto-recharge SIMs.
109
CHAPTER 8
vGATEDesktop
Command
Definition
Reports
SIM Information
Incoming Messages...
Click here to open a browser which shows all messages that have been received for the selected SIM card and the current day. Make sure that Save
Incoming SMS/USSD in Database is checked in the vGATECtrls Options menu.
Export to File
Click here to open a browser into which you can save a text file containing
the current status of all SIMs. Any filters set will apply.
Click here to open a browser into which you can save a text file containing
the SIMs user registration.
Click here to open a browser from which you can select a text file to implort
the SIMs user registration.
110
CHAPTER 9
vGATECtrl
9 v G AT E C t r l
The vGATECtrl application is the vGATE Control Units background server. You can use it to record and display a
log of activity, send email error messages, and to perform a variety of functions on vGATE connections. Open the
vGATECtrl by double-clicking the
You must select Exit from the File menu or from the context menu in the taskbar to
close vGATECtrl. Using the Windows Task Manager to close vGATECtrl can cause database failure!
9.1 LOGGING ACTIVITY
The current logs describing all activity at the vGATE Control Unit are shown on the screen. All entries are written
to the log file, which is generated every day at midnight. This file is saved in the logfiles folder in the vGATECtrl
directory.
111
CHAPTER 9
vGATECtrl
9 . 3 TE A R I N G D O W N C O N N E C T I O N S
To tear down all connections to the vGATE, select Exit from the File menu or right-click the vGATECtrl icon on the
right-hand side of the taskbar. The SIMs will disconnect as soon as any calls are terminated. If you select Exit Immediately, all SIMs disconnect immediately, regardless of whether or not a call is in progress.
We do not recommend that you use the command Exit without releasing SIMs.
112
CHAPTER 9
vGATECtrl
9.4 OPTIONS
The Options menu allows you to perform a variety of tasks in regard to connections on the vGATE:
Table 9.1 vGATECtrl Options
Command
Description
The vGATE SIM Units SIM status is checked automatically every three minutes.
Calls up a dialog where you can enter a number of minutes between 10 and 3600.
Warning messages will remain on the vGATEDesktop for the number of minutes
entered. Check Never if you would like error messages to remain indefinitely (default). Activate Also Remove Errors to include major and minor error messages.
Exports the SIM settings and their current status to a text file.
Log Settings
Allows you to select what kind of log entries you would like. Default settings are
Error and Debug. Select Detail to receive detailed entries.
Mail Settings
Allows you to send error messages via e-mail (see Chapter 9.2 ).
Allows you to select and run an API script. For details on API scripts and a complete
list of all API scripting commands, please refer to the vGATE API manual.
Call/SMS Generation
Settings
Allows you to set a Preferred Timeframe when you want to send calls/SMS and/
or/ a Forbidden Timeframe, in which you dont want to send them. You can also
set a maximum number of calls or SMS that can be sent simultaneously from the
system. Enter the maximum number in the dialog that appears or check No limit
if you do not want to set a limit. To set different limits for individual iGATEs, see
Chapter 8.15 . The setting in vGATECtrl will take priority over limits set for any
individual iGATEs.
Automatically Delete
SIMs Not in SIMUnit
Allows you to determine when SIMs that are no longer in the SIMunit can be deleted from the database.
Use this option to define one or two search strategies which the vGATECtrl uses to assign
a SIM card to a controller. Allows you to Prefer Prepaid SIMs with No Limit, Prefer
SIMs with Highest Maximum Limit, or Prefer SIMs with Lowest Count. Set the first
flag to use a prepaid SIM card with no limit whenever it is available. If you set the second
flag, the assigned SIM card with the highest maximum limit will be used whenever it is
available. If you set the third flag, the SIM card with the lowest count will be used whenever
it is available. You can combine the first with the second or the first with the third option.
In such a combination, Prefer Prepaid SIMs with No Limit always has the highest priority.
113
CHAPTER 9
vGATECtrl
Command
Description
When this option has been set and Active Release is checked in the Limits dialog of the vGATEDesktop, the active SIMs will be released when the number of minutes entered in the Limits dialog of the vGATEDesktop has passed.
(cf. Chapter 8.6 on page 41 ).
Click here for all SIMs to be released at the beginning of a new timezone. The next
reserved SIM will be activated or the released SIM will be immediately reactivated
if there are no other SIMs reserved.
The limit 1 and limit 2 counters will be reset at zero every day at midnight. The
vGATEDesktop Count (L1) Yesterday and Count (L2) Yesterday columns will
show the Max Limit 1 or Max Limit 2 units used on the previous day.
New SIMs that are inserted in the vGATE SIM Unit will be blocked following initialization.
Suppress Quality
Indications
The Received Signal Strength Indication (RSSI) status will not be sent to the vGATE.
Bear in mind that that New Protocol must be set in the mobile gateways edit
window for this feature to work.
New statistics will be logged for a controller when a new SIM is assigned. Old statistics for the previous SIM are sent to the vGATE.
Use vGATEWatch
Sets the watchdog function. If vGATECtrl or the MySQL database shut down improperly, they will automatically restart following one minute.
vGATECtrl will check once a minute whether you have entered external SMS to
send. If you do not wish to send external SMS, deactivate this function.
The change limit is applied to prepaid SIMs. You must restart the vGATEDesktop to
activate the feature.
If you are using a dial-up connection, wait at least twenty seconds following your last
command before you disconnect.
114
CHAPTER 10
VGATEWATCH
1 0 V G AT E W A T C H
The vGATEWatch is a watchdog function that causes vGATECtrl, the MySQL database, iMNP, and/or the
vGATERoutingManager to restart if they shut down improperly. To activate vGATEWatch, select Use vGATEWatch
from the Options menu in the vGATECtrl application (default setting). Now vGATEWatch will start up automatically when vGATECtrl starts up, and the
115
CHAPTER 11
APPENDIX
11 APPENDIX
11.1 STARTING THE WINDOWS2003 CONTROL UNIT WITHOUT LOGON
To start up the Windows2003 Control Unit without logging on, for example in the case of power failure, click the
RegTool AutoLogon.reg.
Bear in mind that if the user name: simdbuser and password: simdb have been changed, you must also
change AutoLogon.reg accordingly.
ClearAutoLog.reg deactivates startup without logon.
1 1 . 2 R E M O T E A C C E S S T O T H E v G AT E C O N T RO L U N I T
To install a remote client, simply start the versions setup program and select Remote in the Setup Type dialog.
You will find the program on the vGATE Control Unit: E:\vGate_Version.
The following programs are required for remote access to the vGATE Control Unit:
vGATEDesktop.exe
vGateConfigRemote.exe
libmySQL.dll
The remote PC must be connected to the vGATE Control Unit with an Ethernet connection of at least 10 MB.
116
CHAPTER 11
APPENDIX
You can now open the vGATEDesktop for remote access to the vGATE Control Unit. Enter the password configured
or check Read Only and enter the password configured for read-only access if one has been set (see
Chapter 7.3 ).
Bear in mind that only one vGATEDesktop can be open at a time, regardless of its
location.
vGATE Version 16.1 is compatible only with MySQL Version 5.1.43. Check your MySQL
version before updating the vGATE. If you have an older version, we recommend updating to MySQL Version 5.1. If you have trouble, please contact TELES service for
your update.
Following installation of vGATE Version 16.1, TELES must release it for your use with
a key generator. Otherwise you will not be able to start your vGATE.
Start the MSDOS command prompt at Start | Programs | Accessories | Command Prompt.
Enter D: and press Return.
Enter cd mysql\bin and press Return.
Enter mysql -u simdbuser -p and press Return.
Enter the password simdb and press Return.
117
CHAPTER 11
APPENDIX
Enter the command \. (backslash period space) and the path to the script (in this example, on the E: drive):
\. E:\vGATE_Version\V16.1\Disk1\DatabaseScripts\DIFF_V1500_V1610.sql.
118
CHAPTER 11
APPENDIX
Error
Cause
Solution
vGATEDesktop
Status
Missing IMSI
SIM Broken
Registration process
failed repeatedly.
TCP/IP connection
from the iGATE to the
vGATE SIM Unit is inadequate or unavailable.
SIM Blocked
Ping Timeout
119
CHAPTER 11
APPENDIX
Error
Cause
Solution
vGATEDesktop
Status
Connection refused
iGATE cannot be
reached.
Improperly configured
Hardware or software
failure on the vGATE
Module.
SIM barred
Registration process
unsuccessful.
SIM card is blocked.
Wrong PIN
No recharge number
found
Recharge number
missing from recharge
list.
Sending recharge
call (OK), no answer,
no limit indication
after 2 minutes.
Scripting error.
No answer to USSD
query.
120
CHAPTER 11
APPENDIX
Hardware
vGATE License
As of Version
iGATE 4 VoIP
SIM
14.6
iGATE 8 VoIP
SIM
14.6
iGATE 16 VoIP
SIM
14.6
iGATE 32 VoIP
SIM
14.6
ECOTEL GSM
SIM
14.6
ECOTEL 3G
SIM
14.6
121
Av
.Sar
gent
oGer
al
doSant
ana,177
04674225SoPaul
oSP
T
el
551
156876988
Fax551
156873368
www.
t
ai
t
el
l
.
c
om.
br
c
omer
c
i
al
@t
ai
t
el
l
.
c
om.
br