TELES - vGATE 12.0
TELES - vGATE 12.0
TELES - vGATE 12.0
vGATE
Systems
Manual
Version 12.0
vGATECtrl Version 12.0
Berlin
The hardware and software described in this publication is protected by international copyright law. Use is intended solely for the legitimate owner. Unauthorized
distribution or use may result in civil and criminal penalties and will be prosecuted.
Contents
1
Overview ........................................................................................... 7
Configuration ................................................................................. 14
Page i
5.3
7 vGateDesktop .................................................................................28
7.1 Automatic TELES.iGATE Registration .........................................................29
7.2 Setting Up TELES.iGATEs .............................................................................29
7.3 Setting Up Groups ..........................................................................................30
7.4 Setting Up Timezones ....................................................................................31
7.5 Assigning SIMs ...............................................................................................32
7.5.1 Reserving SIMs to Inactive Timezones ..................................................... 33
7.5.2 Assigning SIMs to Active Timezones ........................................................ 34
7.5.3 Copying SIM Assignment .......................................................................... 35
7.6 Setting Time Limits and Pauses ....................................................................35
7.7 Configuring Prepaid SIMs ..............................................................................37
7.7.1 Configuration in the TELES.iGATE ........................................................... 37
7.7.1.1 route.cfg ..............................................................................................37
7.7.1.2 pabx.cfg...............................................................................................37
7.7.1.3 Finding the Search String.................................................................38
7.7.1.4 Calculating the Multiplicator ............................................................39
7.7.2 Defining Prepaid SIMs on the vGateDesktop ............................................ 39
7.8 Automatically Recharging Prepaid SIMs ......................................................40
7.8.1 Configuration in the TELES.iGATE ........................................................... 40
7.8.2 Configuration on the vGateDesktop .......................................................... 41
7.8.2.1 Setting Carriers .................................................................................41
7.8.2.2 Setting Prepaid Recharge.................................................................42
7.9 SMS and Call Options .....................................................................................44
7.9.1 Sending Calls and SMS ............................................................................ 44
7.9.2 Receiving Calls and SMS ......................................................................... 46
7.9.3 Defining SMS Messages ........................................................................... 47
7.9.4 Sending External SMS .............................................................................. 47
7.10 Special Services ............................................................................................48
7.10.1 Script Commands .................................................................................... 49
7.10.2 Script Example ........................................................................................ 55
Page ii
7.13
7.16
7.17
7.18
7.19
vGATECtrl ...................................................................................... 79
vGATEWatch .................................................................................. 83
10
11
12
13
14
Troubleshooting ........................................................................... 89
15
Page iii
Page iv
Safety Measures
Please be sure and take time to read this section to ensure your personal safety and
proper operation of your TELES Infrastructure System.
To avoid personal injury or damage to the system, please follow all safety instructions before you begin working on your TELES Infrastructure System.
TELES Infrastructure Systems are CE certified and fulfill all relevant security requirements. The manufacturer assumes no liability for consequential damages or
for damages resulting from unauthorized changes.
This chapter applies for all TELES.Systems. Information that applies only for individual TELES.Systems specifies the system for which it applies.
1.1
Safety Measures
Danger of electric shock - the power supplies run on 230 V. Unplug the TELES
Infrastructure System from its power source before working on the power supply
or extension socket.
Make sure to install the system near the power source and that the power source
is easily accessible.
Bear in mind that telephone and WAN lines are also energized and can cause electric shocks.
Wire your system using only the cables included in the package contents. Use only
proper ISDN and Ethernet cables.
Do not insert foreign objects into openings in the device. Conductible objects can
cause short circuits that result in fire, electric shock or damage to the device.
Do not open the TELES Infrastructure System except to install an additional
TELES.Component. Changes in the device are not permitted.
Be sure to respect country-specific regulations, standards or guidelines for accident prevention.
1.2
Page 1
System Security
1.3
System Security
This section describes all points crucial to the TELES Infrastructure Systems system security.
The systems location must support normal operation of TELES Infrastructure
Systems according to EN ETS 300 386. Be sure to select the location with the following conditions in mind:
Location: Make sure you install the system in a clean, dry, dust-free location. If
possible, the site should be air-conditioned. The site must be free of strong electrical or magnetic fields, which cause disrupted signals and, in extreme cases, system failure.
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: TELES.iGATE and TELES.iGATE contain 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.
1.4
Page 2
1.4.1
CDR Files
Replacing Components
Life span
Filter pads
6 months
5 years
5 years
Fan
5 years
3 years
1.4.2
Changing configuration data and/or SIM card positions may lead to malfunctions
and/or misrouting, as well as possible consequential damage. Make changes at
your own risk. TELES is not liable for any possible damage resulting from or in
relation to such changes. Please thoroughly check any changes you or a third party
have made to your configuration!
Make sure your hard disk or flash disk contains enough storage space. Downloading the log files and deleting them from the system on a regular basis will ensure
your systems reliability.
Be careful when deleting files that you do not delete any files necessary for system
operation.
TELES.vGATE Control Unit:
Do not use Ctrl/Alt/Del (Task Manager) to shut down vGateDesktop or
vGATECtrl. 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.
1.5
CDR Files
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.
Note:
Page 3
Network Security
tions if traffic is flowing on the system while modifications in configuration or routing files are activated.
1.6
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:
The firewall must be able to check the following information and only allow trusted users to access the TELES.System:
IP source address
IP destination address
Protocol (whether the packet is TCP, UDP, or ICMP)
TCP or UDP source port
TCP or UDP destination port
ICMP message type
Page 4
Network Security
For operation and remote administration of your TELES.System, open only the
following ports only when the indicated services are used:
Table 1-2
Protocol
Port
TCP
TCP
23
SMTP
TCP
25
DNS Forward
UDP
53
HTTP
TCP
SNTP
UDP
123
SNMP
UDP
161
UDP
H.225 Signaling
TCP
Radius
UDP
Radius Accounting
UDP
TELES.GATE Manager
TCP
SIP Signaling
UDP / TCP
RTP
UDP
Communication from
TELES.iGATE products to
TELES.iGATE products
UDP
29417
TELES.vGATE Control
Unit
TCP
57343
TCP
21
Telnet
TCP
23
MySQL database
TCP
3306
TELES.iGATE to
TELES.vGATE
TCP
57342, 57343
Page 5
Network Security
Table 1-2
Protocol
Port
TELES.iGATE to
TELES.iMNP
TCP
9003
Remote vGateDesktop
TCP
57344
Remote vGateDesktop
(read only)
TCP
57345
TELES.iMNP
TCP
9003
TCP
51500
FTP
TCP
21
Telnet
TCP
23
MySQL database
TCP
3306
TELES.NMS protocol
TCP
5000
TELES.NMS update
TCP
5001
TELES.NMS task
TCP
5002
TELES.NMS task
TCP
5003
TELES.NMS Listen
TCP
4444
For TELES.NMS
Note:
Page 6
Overview
Overview
2.1
2.2
Features
Page 7
Features
Overview
Page 8
Overview
2.3
Figure 2-1
You maintain control over when each SIM is assigned to which port on which
TELES.iGATE and for how long.
Figure 2-1 shows how SIMs can be assigned to various TELES.iGATEs at different times. You determine when a SIM is active on a specific TELES.iGATE. For
example, you can assign a carriers SIM to a TELES.iGATE during a particularly
inexpensive tariff and to another when traffic to that carrier is particularly heavy.
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 TELES.vGATE. If you set a pause, the SIM take a break for the
amount of time set after each use.
Page 9
Figure 2-2
Overview
Carrier Distribution
Figure 2-2 shows how you can distribute SIM activity so that SIMs from each carrier are distributed to different ports on the same TELES.iGATE. For example,
you may distribute traffic from one carrier through the first ten ports on each
TELES.iGATE, traffic from another through the next ten ports and traffic from a
third through the next ten ports.
The TELES.vGATE is designed to provide you with optimal flexibility and your
SIMs with optimal mobility.
Page 10
Overview
2.4
Components
Components
Note:
A TELES.ACP Module.
All SIMs are inserted into the central TELES.vGATE Sim Units, so that none are
required in the individual TELES.iGATEs.
Note:
Page 11
TELES.vGATE Installation
TELES.vGATE Installation
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.
Note:
3.1
Before installing your TELES.vGATE, make sure you can fulfill the following
network and firewall requirements:
Page 12
TELES.vGATE Installation
3.2
3
Figure 3-1
Number
Description
1.
2.
Each TELES.vGATE Board has a slot for a TELES.SIM 60 Carrier. Insert the SIMs in the TELES.SIM 60 Carrier and then insert the
TELES.SIM 60 Carrier here (see Chapter 5 on page 21). The hardware
addresses for the TELES.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.
Page 13
Configuration
Configuration
4.1
The TELES.vGATE Sim Unit is a Linux system that makes use of an Ethernet interface.
The eth0 interface enables the TELES.vGATE Sim Unit to communicate with
the connected TELES.iGATEs and the TELES.vGATE Control Unit. Settings for
this interface can be adjusted to adapt with the needs of individual networks.
After you have installed your TELES.vGATE Sim Unit as described in Chapter
3.2, log onto the TELES.vGATE Sim Unit as root and enter beamup at the
password prompt.
If your TELES.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
Note:
Support for UMTS SIMs occurs only with TELES.vGATE Sim Unit
software version 28 or higher. If your TELES.vGATE Sim Unit is
running an older version, the software must be updated.
The TELES.vGATE Sim Unit Version 29 is compatible only with
TELES.vGATE Version 12.0 or higher.
Dialog Box
Information
ENTER HOSTNAME
ENTER DOMAINNAME
FOR
Page 14
Configuration
Table 4-1
Dialog Box
Information
SETUP IP ADDRESS
FOR
ENTER IP ADDRESS
FOR
ENTER GATEWAY
ADDRESS
USE A NAMESERVER?
CONFIRM NETWORK
SETUP
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.
Page 15
#
#
#
#
#
Configuration
/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 ("").
Page 16
Configuration
4.2
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
=
=
=
=
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
Page 17
Configuration
Example:
Controller36=41DTMF
Note:
Page 18
Configuration
4.3
4.3.1
SimServer:Yes
SimDBServer:<IP address of TELES.vGATE Control Unit>
Example:
...
MailSendMax:1
MailSendRetries:1
SimServer:Yes
SimDBServer:172.16.0.30
SimServerBChan:-1
SimServerBCount:8
WanUserName:ip
WanPassword:ip
...
Page 19
4.3.2
Configuration
The SIMS parameter allows you to connect the system to a TELES.vGATE. The
first SIM must be defined in the appropriate GSM controller Subscriber line.
Note:
Example:
...
Subscriber00=TRANSPARENT
Subscriber01=TRANSPARENT
Subscriber02=TRANSPARENT
Subscriber03=TRANSPARENT
...
Page 20
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 TELES.SIM 60 Carrier contains the SIM cards for the individual GSM channels. Each TELES.vGATE Module consists of one TELES.vGATE Board and
one TELES.SIM 60 Carrier, which can be inserted into and removed from the
back of the TELES.vGATE Board during operation. Up to 60 SIM cards can be
assigned to individual GSM channels at random.
5.1
SIM cards are mounted on the front and back of the TELES.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 TELES.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 TELES.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 TELES.SIM 60 Carrier more firmly.
Figure 5-1
SIM7-14
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
37
38
39
40
41
42
43
44
52
53
54
55
56
57
58
59
30
31
32
33
34
35
45
46
47
48
49
50
SIM15-21
SIM22-29
SIM30-36
SIM37-44
36
51
SIM45-51
Note:
SIM52-59
Page 21
5.2
Page 22
D900
D700
D800
D500
D600
D400
D200
D300
D100
D000
Figure 5-2
F01 2
F012
3456
9A
78
D
BC E
9A
78
D
BC E
F012
9A
9A
3456
3456
78
3456
78
TELES.vGATE
Board: How to
Set the Memory
Range
D
BC E
Figure 5-3
F01 2
Turn the dials in the right-hand corner of each TELES.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 TELES.vGATE Sim Unit. Bear in mind that each
TELES.vGATE Board must have a different address.
D
BC E
Make sure the new TELES.vGATE Board does not contain a TELES.SIM 60 Carrier. Not following the correct procedure to replace the TELES.vGATE Board can
result in damage to the contacts or conductors. Insert the TELES.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 TELES.vGATE Sim Unit. The software will automatically recognize the new hardware within five minutes.
Page 23
SIM 1-10
SIM 11-20
SIM 21-30
Each of the upper six LEDs shows the status of ten of the SIMs inserted in the
TELES.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.
SIM 31-40
SIM 41-50
SIM 51-60
Database Connection
SIM Access
SIM States
5.3
TELES.vGATE Board
LEDs
Meaning
Slowly flashing
Quickly flashing
Off
Off
Flashing: 5 seconds
quickly, then slowly
Off
Page 24
Administration of the TELES.vGATE occurs through the TELES.vGATE Control Unit, which is a 1HU, 19 PC. The TELES.vGATE Control Unit includes the
following:
vGateConfig is a configuration tool with a graphical interface used to configure the TELES.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 TELES.vGATE Sim Unit and the TELES.iGATEs.
MySQL V. 4.0.22 database contains information on all SIMs in the
TELES.vGATE.
The user name and password to log onto the TELES.vGATE Control Unit are
simdbuser and simdb, respectively.
6.1
LAN 1
4
Figure 6-1
LAN 2
Figure 6-1 provides a rear view of the TELES.vGATE Control Unit. Table 6-1 describes the numbered arrows shown in Figure 6-1. Follow these directions to install your TELES.vGATE Control Unit
Table 6-1
Number
Description
1.
2.
3.
4.
5.
Page 25
Compatibility Requirements
6.2
Compatibility Requirements
6.3
vGateConfig
Database
The default Name of the database is SIMServerDB and may not be changed. Enter
its Host address. The default period (.) entered here represents named pipes and
should 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. Do not
change the User name simdbuser or the
Password simdb.
Figure 6-2
vGateConfig
Frontend Server
The frontend server is the TELES.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.
SIM Unit
Double-click to edit entries. Enter the TELES.vGATE Sim Units IP address in
the Host box. Do not change the default Port. Up to 10 TELES.vGATE Sim Units
can be defined. Use the context menu to edit, add or delete SIM units from the list.
If you use a NAT firewall to translate the TELES.vGATE Sim Units private IP
addresses into public addresses, you must also enter the TELES.vGATE Sim
Units public IP address at Public Host.
Page 26
vGateConfig
Gateways
Do not change the default Port.
Default PIN
The PIN entered here will apply for all of the SIMs. The default PIN for all SIMs
is 0000 and cannot be changed.
Only one vGateDesktop can be open at a time. Activate If new desktop tries to
connect, close connection to old desktop to close an open vGateDesktop when
another vGateDesktop tries to open. A dialog will appear on the old
vGateDesktop, from which you can choose to leave the vGateDesktop open with
read-only rights or close the vGateDesktop.
If this box is not checked, any second vGateDesktop will only be able to start with
read-only rights or not at all.
Page 27
vGateConfig
vGateDesktop
vGateDesktop
Groups
Filters
SIMs
iGATEs
Figure 7-1
Page 28
vGateDesktop
Controllers (Ports)
vGateDesktop
7.1
Figure 7-2
TELES.iGATE Registration
7.2
Setting Up TELES.iGATEs
Page 29
Setting Up Groups
7.3
vGateDesktop
Setting Up Groups
Once you have named your TELES.iGATEs, you may want to assign them to
groups that will provide you with a more targeted overview of the
TELES.iGATEs in your network.
In our example, we have four TELES.iGATEs, which we have named Berlin,
Chicago, Munich and New York. All TELES.iGATEs are assigned to the Default Group at installation.
First we want to give the default
group a meaningful name. To rename
a group, right-click the group, select
Edit Group and enter the new name
in the pop-up dialog.
For our example, we have renamed
the default group Germany. To create new groups, right-click in the window and select Create Group. Enter the name of the new group in the pop-up
dialog. We have named our new group USA.
Now we have two groups and four TELES.iGATEs. All four TELES.iGATEs belong to the group named Germany.
We want the TELES.iGATEs Berlin and
Munich to remain in the Germany group
and the Chicago and New York
TELES.iGATEs to move to the USA
group.
To move TELES.iGATEs to another
group, right-click the name of the
TELES.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 TELES.iGATEs in that group
will appear in the list of TELES.iGATEs.
Tip:
Page 30
You can also use drag and drop to assign TELES.iGATEs to groups.
vGateDesktop
7.4
Setting Up Timezones
Setting Up Timezones
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 leftclick the mouse approximately where the new marker
should 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.
Using either of these two methods, you can set timezones for each group. The timezones will be the same for each TELES.iGATE in the group, but the SIMs assigned to each timezone may differ, depending on your individual setup.
Note:
The total number of timezones for all groups may not exceed 85.
Page 31
Assigning SIMs
vGateDesktop
Figure 7-3
Copying Timezones
The vGateDesktops date and clock are set according to the clock on
the TELES.vGATE Control Unit, which appears in the bottom righthand 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 TELES.vGATE Control Unit accordingly!
7.5
Assigning SIMs
Once you have set a groups timezones, you can begin to assign SIMs for each
controller and its timezones.
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 7.6).
Tip:
Page 32
For an overview of SIMs that were once, but are no longer, inserted
in the TELES.vGATE Sim Unit, select Show SIMs not in Simserver from the View menu.
vGateDesktop
7.5.1
Assigning SIMs
For our example, we will reserve SIMs 1.001.01-1.001.04 with Max Limit 1 to
controller 0 on the Berlin TELES.iGATE in the Germany group:
Figure 7-4
Assigning SIMs to
Selected Controllers
Page 33
Assigning SIMs
vGateDesktop
controllers 1 to 5:
Figure 7-5
Assigning SIMs to
Consecutive Controllers
1.
2.
3.
4.
5.
6.
7.
7.5.2
To assign SIMs to a timezone that is currently active, follow the same steps outlined above, but make sure all inactive timezones are white in the timezone slide
control by clicking the green timezone.
The SIMs will appear in the Active Position and Limit 1 Reserved Positions or
Limit 2 Reserved Positions column.
Page 34
vGateDesktop
7.5.3
You can also copy the contents of one timezone into another for one or all
TELES.iGATEs in the group by left-clicking the timezone to be copied and dragging the curser into another timezone. You cannot copy into the timezone that is
currently active. However, it is possible to copy the currently-active timezone into
another one.
7.6
Figure 7-6
Page 35
vGateDesktop
To change the SIM after a certain amount of 10-second units, deactivate the No
Limit checkbox and enter a figure between 1 and 65534 in the Change Limit box.
For example, the Change SIM Limit entry in Figure 7-6 is 1800 10-second time
units, or 18,000 seconds.
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 7-6 is 50,000 10-second time units, or 500,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.
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 7.5).
To set a maximum call duration, activate the Max Call Duration checkbox and
enter a number of seconds between 1 and 65533 (as of first generation
TELES.iGATEs 7.00x and second generation TELES.iGATEs 12.0). After the
limit has passed, the call will automatically be disconnected.
If a SIM switches to a new timezone where it has a different limit, the SIM will be
released. 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 the limit 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.
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.
To set an amount of time a SIM should remain idle between uses, enter a value in
Minimum Pause after Last Use. 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.
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. 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
entered has passed. Values between 2 and 9999 minutes are possible. SIMs in the
reserved position will become active. If no SIMs are reserved, the same SIM will
be reassigned (see Chapter 8.4 on page 81). Check Random and the SIM will be
Page 36
vGateDesktop
7.7
7.7.1
7.7.1.1
route.cfg
The following entries must appear in the route.cfg to save the necessary
USSD messages into a file.
Second Generation
Restrict<LAIN>=@FILE 06
First Generation
Restrict<LAIN>=@FILE:<logfile> 06
7.7.1.2
pabx.cfg
Page 37
vGateDesktop
be represented with a 0 (not a prepaid controller) or 1 (prepaid controller), numbered from right to left. <num> can be 0, 1, 2 or 3 and appears to distinguish the
various carrier configurations from one another. <search string> refers to
the reference term used to access the carriers recorded message.
<multiplicator> (see below) is the figure used to convert the currency balance into time units. <remaining balance> is the number of units that are
left on the SIM when it is permanently blocked or when it automatically recharges.
If this space is left empty, the SIM will be used until it runs out:
First and Second Generation
Prepaid<num>=<controller bitmask> <USSD code> <search
string>: " <multiplicator> <remaining balance>
Note:
Example:
In the following example, the controllers 0 to 3 are defined as prepaid. The USSD code for this carrier is *100# and the search string is
the phrase your available credit. The multiplicator is 30
and the SIM will be blocked or recharged when 60 units are left.
7.7.1.3
To determine the search string, enter TEST in the quotation marks and update the
configuration. 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 TELES.GATE Manager connection to the TELES.iGATE.
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 configuration.
Example:
Page 38
After you send the balance code, the following string appears:
vGateDesktop
7.7.1.4
7.7.2
Once you have inserted a prepaid SIM into the TELES.vGATE, you must define
it as prepaid in the vGateDesktop in one of the following ways:
To deactivate the SIM positions prepaid status, right-click the SIM and select
2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006
Page 39
vGateDesktop
7.8
7.8.1
To avoid mapping conflicts, we recommend that you use the last letters in the alphabet as mapping characters.
Example:
In the following example, the carrier with the LAIN 11111 is as-
Page 40
vGateDesktop
signed 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.
Second Generation
MapAllDTMF=41DTMF
MapAllZ??=11111*??01:
MapAllY??=22222*??01:
MapAllX??=33333*??01:
MapAllW??=44444*??01:
First Generation
MapAllDTMF=40DTMF
MapAllZ??=11111*??01:
MapAllY??=22222*??01:
MapAllX??=33333*??01:
MapAllW??=44444*??01:
7.8.2
Once you have defined the SIM as prepaid and made the appropriate entries in the
pabx.cfg and the tib.cfg, you can proceed to configure the vGateDesktop
accordingly.
For a description of how to limit the number of times a SIM can be recharged every month, see Chapter 7.6.
7.8.2.1
Setting Carriers
To set prepaid carriers, select Carrier List from the View menu or click the
icon in the toolbar.
The Carrier List window will appear. Right-click an empty line or an entry and
Page 41
vGateDesktop
Figure 7-7
Carrier List
If you select Edit or Add, the Carrier List Editor will appear. From here you can
define new carriers or edit existing ones.
Enter the carriers Name and LAIN. In
the Character for Mapping space, enter
the mapping character you configured for
the carrier in the route.cfg or
pabx.cfg.
Enter the USSD Recharge Code or, in
the case of DTMF recharging, activate
Use DTMF. Then enter the USSD Bal- Figure 7-8
ance Code and the Service Center Number.
7.8.2.2
Carrier Editor
Once you have set up the Carrier List, you can set the automatic recharge. Select
icon in the toolPrepaid Recharge List from the View menu or click the
bar. The Prepaid Recharge List will appear. Right-click an empty line or an entry
and select Edit, Add or Delete from the context menu. You can also use the context menu to Export the list to a file or to Import the list from a text file. Each file
entry will look like this: <carrier id>, <recharge number>.
.
Figure 7-9
If you select Edit or Add, the Prepaid Recharge List Editor will appear. From here
Page 42
vGateDesktop
Page 43
7.9
vGateDesktop
You can configure individual SIMs to transmit and receive calls and SMS, so that
traffic flows in both directions. Each SIM can send and/or receive up to 99 SMS
and 99 calls per day or month.
Note:
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 TELES.iGATE
exists.
7.9.1
You can define receiver groups in the SMS/Call Receiver List. For
details, please refer to Chapter 7.9.2.
If the SIM is to receive calls and SMS originating from the TELES.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
Page 44
vGateDesktop
DATA
DATA
DATA
DATA
The SMS centers access number must also appear after the LAIN in the controllers Subscribe line. This number must be for the same carrier as the card assigned to the controller:
Example:
In the following example, controller 00 routes SMS through the carrier with the SMS service center number +49555, SMS through controller 01 are routed through the carrier with the SMS service center
number +49666 and no SMS are sent from controller 02.
You must also set carriers on the vGateDesktop as described under Setting Carriers on page 41. 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.
Page 45
7.9.2
vGateDesktop
Figure 7-12
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 List 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, right-click 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 should 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
7.9.1).
To receive calls at defined TELES.iGATEs, enter the following settings in the
TELES.iGATEs route.cfg:
Second Generation
Restrict<LAIN>=41DTMF 01
First Generation
Restrict<LAIN>=40DTMF 01
To receive SMS at defined TELES.iGATEs, enter the following settings in the
TELES.iGATEs route.cfg:
Page 46
vGateDesktop
Second Generation
Restrict<LAIN>=@FILE 05
First Generation
Restrict<LAIN>=@FILE:sms.log 05
7.9.3
Figure 7-13
SMS List
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. 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.
7.9.4
Page 47
Special Services
vGateDesktop
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.
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.
7.10
Special Services
Page 48
Figure 7-14
Special Service
vGateDesktop
Special Services
Between will activate the script daily at a random time between those entered
(be sure to enter times based on a 24-hour clock, e.g. 5:00 pm must be entered
as 17). You must enter times on the hour. No decimals are allowed. You can
select whether you would like to activate the commands Daily or Every month
on the day specified.
The .ini file containing the script is saved on the TELES.vGATE Control Unit
and its path is defined under Command File in the Special Service group box.
Note:
7.10.1
Script Commands
The commands must be entered in the .ini file as follows. Please refer to Chapter 7.10.2, which is intended as a detailed description of format and syntax:
Table 7-3
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 TELES.iGATEs 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).
LIMIT_FAKTOR_T(<num>)
Defines the multiplicator 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 TELES.iGATEs 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).
BLOCK_PORT
The port will be blocked as soon as it is idle.
UNBLOCK_PORT
The port is unblocked.
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.
Page 49
Special Services
Table 7-3
vGateDesktop
SLEEP(<millisec>)
Sets a pause (in milliseconds) in the job.
DONT_CARE_SIMSTATUS
The SIMs current status (registered, etc.) will be ignored.
CANCEL_JOB_BLOCKING
Cancels blocking the SIM or controller. The job will continue to be executed.
SEND_USSD_WAIT(<code>, <waitparam1>, <waitparam2>, <...>,
<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 wait parameter
[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. 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 {...}. 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 7.8.2.1) and the mapping entries must exist in the
route.cfg.
Page 50
vGateDesktop
Table 7-3
Special Services
Page 51
Special Services
Table 7-3
vGateDesktop
Page 52
vGateDesktop
Table 7-3
Special Services
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 7.8.2.1) and the mapping entries must exist in the
route.cfg .
SEND_SMS(<to>, <msg>)
Sends a defined SMS (<msg>) to a defined recipient (<to>).
NOTE: The service center number and mapping character must appear in the
Carrier List (see Chapter 7.8.2.1) and the mapping entries must exist in the
route.cfg. SMS service numbers must appear in the pabx.cfg.
<RECHARCGE_CODE>
This command causes the SIMs recharge code to be entered in an SMS or DTMF
message from the database. If no code can be found, the job will be canceled with
an error message.
The syntax is as follows: SEND_DTMF(<RECHARGE_CODE>)
WAIT_MSG(<waitparam1>, <waitparam2>, <...>, <timeout>)
Sets a wait for defined messages. This string sets a wait for defined messages.
You must set the wait parameter [T%d:%d:%d], [M%d:%d] or [S%s] if a limit is
to be parsed and/or calculated based on time (T), money (M) or a string (S). Wait
parameters are separated by a comma. The entry LIMIT_FAKTOR_M or
LIMIT_FAKTOR_T must also be set in this case. 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 {...}. 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
CHANGE_LIMIT_ZERO
Can be set as a wait parameter. If the calculated change limit is 0, another command can be carried out.
RECHARGE_IF_LIMIT_BELOW(<count>)
Initiates SIM recharge and closes job if the current prepaid limit is less than the
value entered.
RELEASEBLOCK_IF_LIMIT_BELOW(<int>)
The SIM will be released and blocked if its balance is below the value entered.
Page 53
Special Services
Table 7-3
vGateDesktop
SET_DB_STRING(<column>)
If a string was parsed in a previous response message, this string will be entered
in the defined vGateDesktop SIM View column.
SET_SIM_BK_COLOR(<r,g,b>)
Enter RGB values, separated with commas, to change the SIM background colors.
CHANGE_LIMIT
The SIMs change limit is set on the TELES.iGATE and the vGateDesktop according to a wait parameter in the TELES.vGATE.
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.
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.
END_JOB
Ends the job.
Page 54
vGateDesktop
7.10.2
Special Services
Script Example
The following example shows a limit factor (LIMIT_FAKTOR_M) based on money, with a calculating factor of 0.4 and a limit factor based on time
(LIMIT_FAKTOR_T), whereby the multiplicator is 60. If the calculated limit is
greater than 0 and less than 9, the limit will be set at 10
(SET_MIN_LIMIT(9,10)). The port will be blocked through the remote interface (BLOCK_PORT). A pause of five seconds will occur before the USSD code
is sent (SLEEP(5000)).
The entry SEND_USSD_WAIT contains one wait parameter and a timeout of five
minutes ((*100#, account status: [M%d.%d], 5)). The USSD code
*100# (acount-status query) is sent an the system waits for a response containing
the words account status and a monetary value ([M%d.%d]). If the response comes within five minutes, the account status is calculated using the value
entered in LIMIT_FAKTOR_M and the SIM will be recharged if the limit is below
that set in RECHARGE_IF_LIMIT_BELOW (2000). If SIM recharge is to be
initialized, the job will end here.
If not, USSD code *123*12*01# (activation of special service, e.g. special rate)
is sent, with the wait parameters is active (wait parameter 1) and has been
activated (wait parameter 2) and a timeout of five minutes.
If wait parameter 1 (is active) comes within five minutes, the port will be
blocked and USSD code *125# for special rate time status is sent
(SEND_USSD_WAIT(*125#, special rate: [T%d:%d], 5)). If the
response comes before the timeout of five minutes, the time for the special raite is
calculated using the LIMIT_FAKTOR_T(60.0). The port is blocked through
the remote interface. The calculated limit is set on the TELES.iGATE and the
vGateDesktop with the command CHANGE_LIMIT. The port is unblocked and
the job is ended.
If the calculated value is greater than 0 and less than 9, a limit of 10 is set on the
TELES.iGATE.
If wait parameter 2 (has been activated) comes within five minutes, the
port will be blocked and USSD code *125# for special rate time status is sent
(SEND_USSD_WAIT(*125#, special rate: [T%d:%d], 5)). If the
response comes before the timeout of five minutes, the time for the special raite is
calculated using the LIMIT_FAKTOR_T(60.0). The port is blocked through
the remote interface. The calculated limit is set on the TELES.iGATE and the
vGateDesktop with the entry CHANGE_LIMIT. The port is unblocked and the job
is ended.
If the calculated value is greater than 0 and less than 9, a limit of 10 is set on the
TELES.iGATE.
2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006
Page 55
Special Services
vGateDesktop
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], 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
}
}
}
Page 56
vGateDesktop
7.11
Page 57
vGateDesktop
7.12
Figure 7-16
iGateEditor
To set up a TELES.iGATE and assign it to a group, only the name and IP address
are required. However, you may want to include additional options, which can be
entered into the iGateEditor. Here is a description of the information that can be
entered:
Note:
Table 7-4
iGateEditor
Entry
Description
iGate
Name
IP Address
Port
Group
Number of CTRLs
Select a number of controllers for this TELES.iGATE in increments of four (one TELES.iLCR 4 GSM Board has 4
GSM controllers).
Page 58
vGateDesktop
Table 7-4
iGateEditor (continued)
Entry
Description
Remote Access
Enter the following information if you want to alter or secure remote access to the TELES.iGATE using
TELES.GATE Manager.
Port
Password
User
Password
This section is for setting the number of registration retries before a SIM is blocked.
When a SIM is blocked, an error message is automatically entered in the database. This setting cannot be
changed.
Enter the number of times SIM registration is to be allowed to fail (4 is recommended) before the SIM and its
port are blocked (only occurs when Block former SIM is
activated).
Page 59
SIM History
Table 7-4
vGateDesktop
iGateEditor (continued)
Entry
Description
Get CDRs
CDR Filename
For second generation TELES.iGATEs enter the following: /data/cdr%date:ymd-1%0.log. The default setting is for first generation TELES.iGATEs: %date:ymd1%23. CDRs will be generated each day. -1 means that
they will be retrieved for the day before today (today minus one). A folder containing the CDRs for each
TELES.iGATE is created here: F:\vGATE\CDR\iGATE<name>.
CDR Filename 1
You can enter settings for retrieving other CDRs here. For
example, to retrieve first generation CDRs from 3 days
ago, enter /data/cdr%date:ymd-3%0.log
Start Time
Start Time 1
Limit Call/SMS
Generation
Maximum simultaneous
calls
Maximum simultaneous
SMS
7.13
SIM History
Right-click a SIM and select SIM History from the Reports submenu to call up
Page 60
vGateDesktop
SIM History
Figure 7-17
SIM History
SIM History
Column
Timestamp
Position
Gateway
Ctrl #
Status
Category
Description
Time at which the action described in the status message
occurred.
The SIMs position in the TELES.vGATE Sim Unit.
The TELES.iGATE to which the SIM is assigned.
The controller number to which the SIM is assigned.
The SIMs status.
Status category: 0=status OK, 1=Warning, 2=Minor,
3=Major, 4=Critical.
The following icons appear in the upper left-hand corner of the window:
Table 7-6
Icon
Page 61
SIM History
Icon
vGateDesktop
Description
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.
Page 62
vGateDesktop
7.14
TELES.vGATE Statistics
TELES.vGATE Statistics
You can call up SIM statistics and call statistics for SIMs, controllers,
TELES.iGATEs and for groups. The vGateDesktop can also display line charts
with various statistical information for TELES.iGATEs and for groups. Values
are calculated every time a SIM is released. The following values appear in the
statistics appear in at least one of the various statistic windows:
Table 7-7
vGateDesktop Statistics
Statistic
Definition
ACD
ASR1
ASR2
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
used.
Duration
Shows the amount of time the SIM was used while it was assigned.
Gateway
Incoming Calls
Outgoing Calls
Position
Remote Busy
Timestamp
Page 63
TELES.vGATE Statistics
7.14.1
SIM Statistics
Figure 7-18
SIM Statistics
vGateDesktop
You can access averaged SIM statistics for marked SIMs, controllers and
icon in the toolbar. You can
TELES.iGATEs clicking the corresponding
also access averaged SIM statistics for marked SIMs, controllers, TELES.iGATEs
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 7.14.2).
TELES.iGATE view: select Show SIM Statistics from the context menu in the
Show Call Statistics window (see Chapter 7.14.2).
Group view: select Show SIM Statistics from the context menu in the Show
Call Statistics window (see Chapter 7.14.2).
Page 64
vGateDesktop
7.14.2
Figure 7-19
TELES.vGATE Statistics
Call Statistics
Call Statistics
You can access averaged call statistics for TELES.iGATEs or groups by clicking
icon in the toolbar. Select Show Call Statistics from the context menu
the
in the controller, TELES.iGATE 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 a Carrier to display call statistics only for one carrier. To limit the statistics
to calls for a specific Week, select current for the current week, current - 1 for
last week, current - 2 for two weeks ago, and so on. To display call statistics for
a specific Timezone, select a Timezone from the list.
Page 65
TELES.vGATE Statistics
7.14.3
Call Charts
Figure 7-20
Call Chart
vGateDesktop
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
TELES.iGATE or group view. Using the dropdown 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 Figure 7-21 Call Chart Filter
day, current for the current week, current - 1 for
last week, current - 2 for two weeks ago, and so on.
Page 66
vGateDesktop
7.15
The windows listing TELES.iGATEs, 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.
This is what the columns means:
Table 7-8
vGateDesktop Columns
Column
Description
TELES.iGATEs
Name
Address
Status
Serial#
Controllers
CTRL
Active Position
Limit 1 Reserved
Positions
Limit 2 Reserved
Positions
Remote State
CTRL Info
Action
SIM Info 1
Error
UMTS
SIMs
Position
Color
Page 67
vGateDesktop
Column
Description
IMSI
Lists the SIMs International Mobile Subscriber Identity number.
Change SIM Limit Shows the limit (in 10-second time units) at which the
TELES.iGATE will change to the next SIM.
Max Limit 1
Count (L1)
Max Limit 2
Count (L2)
Last Use
Status
Pause
Priority
Error
Count (L1) Yesterday
Count (L2) Yesterday
Current Count
Own Number
SMS Count
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.
Shows the Max Limit 1 units that have been used.
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.
Shows the Max Limit 2 units that have been used.
Shows when the SIM was last active.
Lists the SIMs status:
0=OK
1=database error
Shows the length of the pause set for this SIM after each release.
Lists the SIMs defined priority
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.
Shows the total amount of time (in seconds) the SIM has been
used.
Shows the SIMs call number.
Shows the ratio of the number of SMS that have been sent to the
number configured to be sent.
Next SMS
Call Count
Page 68
vGateDesktop
Table 7-8
Column
Call/SMS Flags
Special Service
Flags
Assign Offset
Used per TZ
Upgrades/Month
7.16
vGateDesktop Icons
Description
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
Shows a random number of seconds between those defined in
the Limits dialog (see Chapter 7.6).
Lists how often the SIM has been assigned .
Lists how often a SIM has been recharged in the current month
/ how many recharges per month have been set.
vGateDesktop Icons
Table 7-9 lists the icons that appear on the vGateDesktop and their meanings.
Table 7-9
Icon
vGateDesktop Icons
Definition
Groups
No errors exist on the TELES.iGATEs in this group.
An error exists on at least one TELES.iGATE in the group.
A TELES.iGATE in this group is currently in maintenance mode. Select Reset Maintenance Mode from the context menu to reactivate the group
TELES.iGATE.
TELES.iGATEs
No errors exist on this TELES.iGATE.
This TELES.iGATE is not available.
This TELES.iGATE is currently in maintenance mode. Select Reset Maintenance Mode from the context menu to reactivate the TELES.iGATE.
This TELES.iGATE has been improperly configured. Check the configuration
and, if necessary, install the proper driver for TELES.vGATE implementation.
Controllers
Page 69
vGateDesktop Icons
Table 7-9
Icon
vGateDesktop
Page 70
vGateDesktop
7.17
Menu Bar
Menu Bar
The following table describes the commands you can carry out from the
vGateDesktop menu bar:
Table 7-10
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 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.
Status Bar
Toolbar
Split
Click here for a resize cursor to adjust the size of the windows on the vGateDesktop.
Refresh
SIMCarrier Status
Options Menu
Inhibit Modification of
Timezones
Help
About vGATEDesktop
Page 71
vGateDesktop Toolbar
7.18
vGateDesktop
vGateDesktop Toolbar
The vGateDesktop toolbar facilitates quick access to the following functions and
information:
Table 7-11
Icon
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 TELES.GATE Manager. This button is active only
when a TELES.iGATE is selected.
Click here to open a table containing information about the SIM route for the
selected TELES.iGATE.
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.
Page 72
vGateDesktop
Table 7-11
Icon
vGateDesktop Toolbar
Page 73
Context Menus
7.19
vGateDesktop
Context Menus
The following table describes the commands you can carry out with the context
menus on the vGateDesktop:
Table 7-12
Command
Definition
Groups
Create Group
Edit Group
Delete Group
TELES.iGATEs
Add New
Click here to call up the TELES.iGATE Editor (see Chapter 7.12 on page 58). Use the Editor to add a new
TELES.iGATE.
Delete
Edit
Click here to call up the TELES.iGATE Editor (see Chapter 7.12 on page 58). Use the Editor to change an existing
TELES.iGATE.
Copy Timezone
Configuration to GW
Change Group
Causes the TELES.iGATE to release all of its SIMs immediately. All calls will be torn down.
Page 74
vGateDesktop
Table 7-12
Context Menus
Command
Definition
Reset Maintenance
Mode
Reinit
Start Remote
Opens TELES.WinRemotePro for remote access. A folder with the name Remote is automatically created in the
vGateControl directory the first time you start
TELES.WinRemotePro. Sub-folders for each
TELES.iGATE selected will also be created automatically.
Calls up a table containing an overview of reserved positions. Right-click to refresh the window.
Controllers
Release SIM
Deactivates a SIM.
Release SIM
Immediately
Release SIM
The SIM will be released immediately, even if traffic is
Immediately and Block running on it, and the controller will be blocked.
Assign SIM
Reassign SIM
Stop Recharging
Stop Assigning
Opens a browser to allow manual selection of special service (see Chapter 7.10).
Page 75
Context Menus
Table 7-12
vGateDesktop
Command
Definition
Reset Error/Unblock
CTRL
Calls up a table containing an overview of reserved positions. Right-click to refresh the window.
SIMs
Change Limits
Change Priority
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 1and Info 2 and the SIMs own number.
Special services can also be activated here.
Reset Count
Reset Limits
Click here to reset Max. Limits manually to their configured maximum limit.
Page 76
vGateDesktop
Table 7-12
Context Menus
Command
Definition
Click here or press Ctrl+B to reserve the marked SIMs individually to consecutive controllers, beginning with the
selected controller.
Block SIM
Reset Error/Unblock
SIM
Stop Pause
Reset TZ Change
Counter
Resets the Timezone counter (see Chapter 7.6: Maximum Usage per TZ).
Select CTRL
Calls up a table containing an overview of reserved positions. Right-click to refresh the window.
Page 77
Context Menus
Table 7-12
vGateDesktop
Command
Definition
Reports
SIM Information
Click here to call up a table containing all of the information pertaining to the SIMs TELES.vGATE configuration.
Export to File
Page 78
vGATECtrl
Figure 8-1
Context Menus
vGATECtrl
vGATECtrl
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!
Page 79
Logging Activity
8.1
vGATECtrl
Logging Activity
The vGATECtrl logs up to 2500 lines describing all activity at the TELES.vGATE
Control Unit. After the log has reached 2500 lines, the oldest entries are deleted.
All entries are written into the log file, which is generated every day at midnight.
This file is saved in the logfiles folder in the vGateControl directory.
8.2
8.3
Mail Settings
To tear down all connections to the TELES.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.
Note:
Page 80
We do not recommend that you use the command Exit without releasing SIMs.
vGATECtrl
8.4
Options
Options
The Options menu allows you to Check SIM Status of the TELES.vGATE Sim
Unit. The TELES.vGATE Sim Units SIM status is checked automatically every
three minutes.
Select Remove Warnings to call 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).
Select Export SIM Settings to export the SIM settings and their current status to
a text file.
The Log Settings option 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
8.2). Script File Settings allows you to select and run a script.
The option Limit Simultaneous Call/SMS Generation allows you to set a maximum number of calls or SMS that can be sent simultaneously from the system.
Enter the maximum number in the dialog appears or check No limit if you do not
want to set a limit. To set different limits for individual TELES.iGATEs, see
Chapter 7.12. The setting in vGATECtrl will take priority over limits set for any
individual TELES.iGATEs.
When the Active SIM Release 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. (see Chapter 7.6 on page 35).
Click Release All SIMs if Timezone Changes 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.
If Reset SIM Counter Daily is set, 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.
If Initially Block New SIMs is set, new SIMs that are inserted in the
TELES.vGATE Sim Unit will be blocked following initialization.
Activate Use vGATEWatch to set the watchdog function. If vGATECtrl or the
MySQL database shut down improperly, they will automatically restart following
one minute.
Activate Send External SMS and vGATECtrl will check once a minute whether
Page 81
Options
vGATECtrl
you have entered external SMS to send. If you do not wish to send external SMS,
deactivate this function.
Note:
Page 82
If you are using a dial-up connection, wait at least twenty seconds following your last command before you disconnect.
vGATEWatch
Options
vGATEWatch
Figure 9-1
vGATEWatch
Page 83
Options
10
To start up the Windows2000 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.
Page 84
11
Options
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 TELES.vGATE
Control Unit: E:\vGate_Version.
The following programs are required for remote access to the TELES.vGATE
Control Unit:
vGateDesktop.exe
vGateConfigRemote.exe
libmySQL.dll
Note:
Bear in mind that only one vGateDesktop can be open at a time, regardless of its location.
Page 85
Options
12
To update the database SimServerDB, you must first close the programs
vGATECtrl.exe and vGateDesktop.exe.
The following instructions update Version 3.6 to 12.0. If you are updating to or
from another version, enter the relevant version numbers in the appropriate places.
Note:
Page 86
Options
for your use with a key generator. Otherwise you will not be able to start your
TELES.vGATE.
You can now start vGATECtrl.exe and vGateDesktop.exe.
Note:
Versions 3.5 and higher are setup versions and can be uninstalled.
Page 87
Options
13
Page 88
You want to create a backup for Version 3.2. The path for the backup
database will be: E:\BackupDB\SimServerDB32.
Troubleshooting
14
Options
Troubleshooting
Table 14-1 contains a list of problems you may incur and how to solve them.
Table 14-1
Troubleshooting
Error
Cause
Solution
vGateDesktop
Status
Missing IMSI
SIM Broken
SIM Blocked
GSM network is
overloaded.
Missing TCP/IP
connection to the
TELES.vGATE
Sim Unit.
SIM card has
been blocked.
Ping Timeout
Missing TCP/IP
connection to the
TELES.iGATE.
Group and
TELES.iGATE
lines are red.
Connection refused
TELES.iGATE
cannot be
reached.
Group and
TELES.iGATE
lines are red.
Page 89
Options
Table 14-1
Troubleshooting
Troubleshooting (continued)
Error
Cause
Solution
vGateDesktop
Status
Improperly configured
Missing
TELES.vGATE
driver on the
TELES.iGATE.
Check the
TELES.iGATEs
TELES.vGATE
driver.
Group and
TELES.iGATE
lines are red.
TELES.SIM 60
Carrier not recognized by
TELES.vGATE
Sim Unit
Hardware or
software failure
on the
TELES.vGATE
Module.
SIM positions do
not appear in the
SIM window of the
vGateDesktop.
SIM barred
Wrong PIN
Controller has
not been defined
as prepaid.
Assign SIM to a
correctly configured controller or
configure controller as prepaid.
No recharge
number found
Enter a recharge
number in the list.
Page 90
Troubleshooting
Table 14-1
Options
Troubleshooting (continued)
Error
Cause
Solution
vGateDesktop
Status
Job timeout
during wait.
Scripting error.
No answer to
USSD query.
Page 91
Options
Supported TELES.iGATEs
15
Supported TELES.iGATEs
Hardware
SIM-Card Carrier
As of Version
TELES.iGATE 32
SIM 4, SIM 24
11.4b
TELES.iGATE 32 IP
SIM 4, SIM 24
5.50d
TELES.iGATE 32 VoIP
SIM 4, SIM 24
5.50d
TELES.iGATE 48 VoIP
SIM 4, SIM 24
5.50d
TELES.iGATE 60 IP
SIM 4, SIM 24
5.50d
TELES.iGATE 60 VoIP
SIM 4, SIM 24
5.50d
TELES.iGATE 32 IP
TELES.iGATE 32 VoIP
TELES.iGATE 48 VoIP
TELES.iGATE 60 IP
TELES.iGATE-C 4-32 IP
SIM 4, SIM 24
6.10f
SIM 4, SIM 24
6.10f
Note:
Page 92