Sunteți pe pagina 1din 98

TELES.

vGATE
Systems
Manual
Version 12.0
vGATECtrl Version 12.0

Berlin

TELES AG provides this document as is, with no representations or warranties,


either explicit or implied, including but not limited to the implied warranties of merchantability, title, or fitness for a particular purpose.

TELES AG reserves the right to make changes in product software, hardware, or


documentation at any time, with no obligation to inform any persons or entities of
such changes. Every effort has been made to ensure that the information in this
manual is accurate. However, TELES AG assumes no responsibility for any losses, whether electronic, financial or other, that might accrue from inadvertent inaccuracies that the software or documentation might contain.

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.

Copyright 2006 TELES AG Berlin. All rights reserved.


TELES, IntraSTAR, Intra*, iSWITCH and iGATE are registered trademarks of TELES AG. All other trademarks used are the property of their respective
owners.

Contents
1

Safety and Security Precautions .................................................... 1

1.1 Safety Measures ............................................................................................... 1


1.2 Tips for EMC Protection .................................................................................. 1
1.3 System Security ............................................................................................... 2
1.4 Servicing the System ....................................................................................... 2
1.4.1 Replacing Components............................................................................... 3
1.4.2 Protecting the Operating System ................................................................ 3
1.5 CDR Files .......................................................................................................... 3
1.6 Network Security .............................................................................................. 4

Overview ........................................................................................... 7

2.1 Whats New in Version 12.0 ............................................................................. 7


2.2 Features ............................................................................................................ 7
2.3 How TELES.vGATE Works .............................................................................. 9
2.4 Components ................................................................................................... 11

TELES.vGATE Installation ............................................................ 12

3.1 Network and Firewall Requirements ............................................................ 12


3.2 TELES.vGATE Sim Unit Hardware Installation ............................................ 13

Configuration ................................................................................. 14

4.1 Configuration of the TELES.vGATE Sim Unit .............................................. 14


4.2 Configuration of Second Generation TELES.iGATEs ................................. 17
4.3 Configuration of First Generation TELES.iGATEs ...................................... 19
4.3.1 Configuration in the tib.cfg ........................................................................ 19
4.3.2 Configuration in the pabx.cfg .................................................................... 20

The TELES.vGATE Module ........................................................... 21

5.1 The TELES.SIM 60 Carrier ............................................................................. 21


5.2 Installing Additional TELES.vGATE Boards ................................................ 22

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page i

5.3

TELES.vGATE Board LEDs ............................................................................24

6 TELES.vGATE Control Unit 12.0 ...................................................25


6.1 TELES.vGATE Control Unit Hardware Installation ......................................25
6.2 Compatibility Requirements ..........................................................................26
6.3 vGateConfig .....................................................................................................26

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

7.11 Defining the SIMs Protocol ......................................................................... 57


7.12

Adding and Editing TELES.iGATEs ............................................................ 58

7.13

SIM History .................................................................................................... 60

7.14 TELES.vGATE Statistics .............................................................................. 63


7.14.1 SIM Statistics .......................................................................................... 64
7.14.2 Call Statistics........................................................................................... 65
7.14.3 Call Charts .............................................................................................. 66
7.15

What the Information on the vGateDesktop Means .................................. 67

7.16

vGateDesktop Icons ..................................................................................... 69

7.17

Menu Bar ....................................................................................................... 71

7.18

vGateDesktop Toolbar ................................................................................. 72

7.19

Context Menus .............................................................................................. 74

vGATECtrl ...................................................................................... 79

8.1 Logging Activity ............................................................................................. 80


8.2 Sending Error Messages Via E-Mail ............................................................. 80
8.3 Tearing Down Connections ........................................................................... 80
8.4 Options ............................................................................................................ 81

vGATEWatch .................................................................................. 83

10

Starting the Windows2000 Control Unit Without Logon .......... 84

11

Remote Access to the TELES.vGATE Control Unit .................. 85

12

Updating the Database SimServerDB ........................................ 86

13

Creating a Backup of the Database ............................................ 88

14

Troubleshooting ........................................................................... 89

15

Supported TELES.iGATEs .......................................................... 92

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page iii

Page iv

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Safety and Security Precautions

Safety Measures

Safety and Security Precautions

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

Tips for EMC Protection

Use shielded cables.


Do not remove any housing components. They provide EMC protection.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 1

System Security

1.3

Safety and Security Precautions

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

Servicing the System

Regular servicing ensures that your TELES.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.

Page 2

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Safety and Security Precautions

1.4.1

CDR Files

Replacing Components

If your TELES.System contains any of the following components, replace them


according to the following table:
Table 1-1

Component Life Span


Component

Life span

Filter pads

6 months

CPU fan (TELES.Systems without TELES.iLCR


Base Board only)

5 years

Power adapter incl. 3.3 V Adapter

5 years

Fan

5 years

Hard disk (IDE) (TELES.Systems without TELES.iLCR


Base Board only)

3 years

1.4.2

Protecting the Operating System

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:

Inaccuracies in the generation of CDRs may occur for active connec-

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 3

Network Security

Safety and Security Precautions

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:

Use an application gateway or a packet firewall.


To limit access to the system to secure remote devices, delete the default route
and add individual secure network segments.
Access to the system via Telnet, FTP, HTTP, TELES.GATE Manager or remote vGateDesktop must be password protected. Do not use obvious passwords (anything from sesame to your mother-in-laws maiden name).
Remember: the password that is easiest to remember is also likely to be easiest
to crack.

The firewall must support the following features:

Protection against IP spoofing


Automatic recognition of security breaches
Logging of all attempts to access the system

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Safety and Security Precautions

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

Ports Used for Specific Services


Service

Protocol

Port

For all TELES.Systems except TELES.vGATE


FTP

TCP

21 (default, can be set)

Telnet (for TELES debug


access only)

TCP

23

SMTP

TCP

25

DNS Forward

UDP

53

HTTP

TCP

80 (default, can be set)

SNTP

UDP

123

SNMP

UDP

161

H.225 Registration, Admission, Status

UDP

1719 (default, can be set)

H.225 Signaling

TCP

1720 (default, can be set)

Radius

UDP

1812 (default, can be set)

Radius Accounting

UDP

1813 (default, can be set)

TELES.GATE Manager

TCP

4445 (default, can be set)

SIP Signaling

UDP / TCP

5060 (default, can be set)

RTP

UDP

29000-29120 (default, can


be set)

Communication from
TELES.iGATE products to
TELES.iGATE products

UDP

29417

TELES.vGATE Control
Unit

TCP

57343

For TELES.vGATE Control Unit and TELES.iMNP


FTP

TCP

21

Telnet

TCP

23

MySQL database

TCP

3306

TELES.iGATE to
TELES.vGATE

TCP

57342, 57343

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 5

Network Security
Table 1-2

Safety and Security Precautions

Ports Used for Specific Services (continued)


Service

Protocol

Port

TELES.iGATE to
TELES.iMNP

TCP

9003

Remote vGateDesktop

TCP

57344

Remote vGateDesktop
(read only)

TCP

57345

TELES.iMNP

TCP

9003

For TELES.vGATE Sim Unit


TELES.vGATE Control
Unit plus TELES.iGATE

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:

Connection from a TELES.vGATE Control Unit to a TELES.iGATE


or TELES.iGATE requires ICMP access. The TCP filters listed
above are activated in the default configuration of the
TELES.vGATE Control Unit or the TELES.NMS server.

As of Version 12.0, antivirus software with a firewall function (BitDefender 9


Professional Plus) comes installed on the TELES.vGATE Control Unit. All necessary applications have access to the Internet. The license is valid for one year.
Make sure you renew the license before it runs out. For support, we recommend
that you register online with the softwares manufacturer.
Updates occur automatically. Make sure the software has Internet access to retrieve these updates.
For more information on this antivirus software, double-click the softwares icon
in the right-hand corner of the taskbar and click More Help in the lower righthand corner of the window, or right-click the icon in the taskbar and select Help.

Page 6

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Overview

Whats New in Version 12.0

Overview

The TELES.vGATE is a system


that enables more convenient
management of a network of
TELES.iGATE systems running
software version 5.50d 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 TELES.iGATE. The
TELES.vGATE can even recharge prepaid SIMs automatically. For details on the
requirements of the TELES.iGATEs in your TELES.vGATE, see Chapter 15.
The vGateDesktop makes it possible to assign SIMs virtually to random ports and
various times without physically removing the SIMs from the TELES.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 TELES.iGATEs.

2.1

Whats New in Version 12.0

Supports dynamic IP addresses of TELES.iGATEs


Supports UMTS and dual (UMTS/GSM) SIMs (as of TELES.vGATE Sim
Unit Version 29)
Possible to filter display of SIMs on individual TELES.SIM 60 Carriers
Possible to send recharge codes using special scripting commands
Possible to define a maximum number of calls/SMS per TELES.iGATE or for
the entire system
Possible to release SIMs immediately with the click of a mouse
Possible to release SIM and block controllers immediately
Define groups for call and SMS receiver lists

2.2

Features

Implementation of the TELES.vGATE offers the following advantages:

Handles up to 600 SIMs per TELES.vGATE Sim Unit; up to ten


TELES.vGATE Sim Units (6,000 SIMs) can be attached to a TELES.vGATE
Control Unit

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 7

Features

Overview

No need to travel to individual TELES.iGATEs to replace SIM cards.


Time-controlled SIM cards can move from one TELES.iGATE to another.
Cyclical use of multiple SIMs can occur on a single GSM channel.
GSM channels in the TELES.iGATEs can easily be assigned to different GSM
networks.
Groups of TELES.iGATEs can be defined and managed individually
Time frames can be defined for individual groups: SIMs can be assigned for
specific times on specific controllers
Priority levels can be set for individual SIMs
Various status reports can be generated
Remote access to TELES.iGATEs
Limits can be defined for how long a SIM card is to be active or inactive
More than one vGateDesktop can be used
Supports prepaid SIMs
Automatically recharges prepaid SIMs (USSD or DTMF)
Can send and receive SMS and calls
Shows current counts
Shows statistic values
Activation of Special Services for prepaid SIMs using automatic USSD or
DTMF transmission
Time-controlled USSD or DTMF transmission
Random assign pause activation for individual SIMs following change of
Time Zones, boot indication and Reset Maintenance
Color-coded selection of SIMs for SMS and call transmission
Possible to limit number of SIM upgrades per month.
Possible to limit number of SIM assigns per Timezone.
Possible to deactivate SIMs when Timezone changes.
SMS and call generation on a daily basis
Special service no longer limited to prepaid SIMs
Possible to manually start and stop special services for individual SIMs.

Page 8

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

Overview

2.3

Figure 2-1

How TELES.vGATE Works

How TELES.vGATE Works

Timezones and Limits

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.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 9

How TELES.vGATE Works

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

Overview

2.4

Components

Components

Each TELES.vGATE consists of the following:

One TELES.vGATE Control Unit:


Contains the TELES.vGATEs database and administration software
At least one TELES.vGATE Sim Unit:
Contains all of the SIM cards in the TELES.vGATE
At least one TELES.iGATE:
Routes GSM traffic

Each TELES.vGATE Sim Unit contains:

At least one TELES.vGATE Module which consists of a TELES.vGATE


Board and a TELES.SIM 60 Carrier. Up to 60 SIM cards can be inserted into
the TELES.SIM 60 Carrier.

Note:

The TELES.vGATE Sim Unit Version 29 is compatible only with


TELES.vGATE Version 12.0 or higher.

Each TELES.iGATE in the network contains:

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:

The TELES.vGATE Sim Unit Version 29 is compatible only with


TELES.vGATE Version 12.0 or higher.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 11

Network and Firewall Requirements

TELES.vGATE Installation

TELES.vGATE Installation

This section contains information on basic installation and configuration of your


TELES.vGATE.
Note:

The TELES.vGATE Sim Unit Version 29 is compatible only with


TELES.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.
Note:

Use a UPS to avoid possible damage resulting from power interruptions.

3.1

Network and Firewall Requirements

Before installing your TELES.vGATE, make sure you can fulfill the following
network and firewall requirements:

A PING must be possible from the TELES.vGATE Control Unit to all


TELES.iGATEs and TELES.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 (TELES.iGATEs, TELES.vGATE Control Unit,
TELES.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, you must
switch off the autohangup function.
We recommend that you install the TELES.vGATE Control Unit and
TELES.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.

Page 12

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

TELES.vGATE Installation

3.2

TELES.vGATE Sim Unit Hardware Installation

TELES.vGATE Sim Unit Hardware Installation

The TELES.vGATE Sim Unit holds up to 10 TELES.vGATE Modules. At up to


60 SIM cards per TELES.SIM 60 Carrier, a single TELES.vGATE Sim Unit contains up to 600 SIM cards. As shown in Figure 3-1, the first three slots are empty
and the TELES.vGATE Modules are inserted from left to right.

3
Figure 3-1

TELES.vGATE: Rear View

Table 3-1 describes the numbered arrows shown in Figure 3-1.


Table 3-1

TELES.vGATE Sim Unit: Assembly

Number

Description

1.

Connect the TELES.vGATE Sim Unit to the Ethernet here.

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.

Plug the power cord in here.

4.

Plug your keyboard into one of these two outlets.

5.

Plug your monitor in here.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 13

Configuration of the TELES.vGATE Sim Unit

Configuration

Configuration

Operation of the TELES.vGATE depends on the following configuration entries:

4.1

Configuration of the TELES.vGATE Sim Unit

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.

Editing the IP Address Using the netconfig Tool


To edit the IP address with the netconfig tool, log on as a superuser with the username root and the password beamup.
Enter netconfig and hit Enter. Answer the queries in the dialog boxes that appear. Table 4-1 contains a description of the queries and the appropriate responses.
When you have finished, restart the system by enterin reboot-n.
Table 4-1

netconfig Dialog Boxes

Dialog Box

Information

ENTER HOSTNAME

Enter the TELES.vGATE Sim Units hostname (e.g.


simunit1)

ENTER DOMAINNAME
FOR

Enter the domain name (e.g. teles.de).

Page 14

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

Configuration
Table 4-1

Configuration of the TELES.vGATE Sim Unit

netconfig Dialog Boxes

Dialog Box

Information

SETUP IP ADDRESS
FOR

Select the STATIC IP ADDRESS option.

ENTER IP ADDRESS
FOR

Enter the IP address.

ENTER NETMASK FOR


LOCAL NETWORK

Enter the netmask.

ENTER GATEWAY
ADDRESS

Enter the gateways IP address.

USE A NAMESERVER?

If you select Yes, enter the name servers IP address.

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.

Editing the IP Address Using vi


To make any necessary changes to the configuration of the IP address for the network card (eth0), open the rc.inet1.conf file in the /etc/rc.d folder. Adjust
your settings as required:

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 15

Configuration of the TELES.vGATE Sim Unit

#
#
#
#
#

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 ("").

# Config information for eth0:


IPADDR[0]="172.20.25.130"
NETMASK[0]="255.255.0.0"
USE_DHCP[0]=""
DHCP_HOSTNAME[0]=""
# Config information for eth1:
IPADDR[1]=""
NETMASK[1]=""
USE_DHCP[1]=""
DHCP_HOSTNAME[1]=""
# Config information for eth2:
IPADDR[2]=""
NETMASK[2]=""
USE_DHCP[2]=""
DHCP_HOSTNAME[2]=""
# Config information for eth3:
IPADDR[3]=""
NETMASK[3]=""
USE_DHCP[3]=""
DHCP_HOSTNAME[3]=""
# Default gateway IP address:
GATEWAY="172.20.0.1"
# Change this to "yes" for debugging output to stdout. Unfortunately,
# /sbin/hotplug seems to disable stdout so you'll only see debugging output
# when rc.inet1 is called directly.
DEBUG_ETH_UP="no"

For those unfamiliar with the vi editor, follow these steps:

Enter cd /etc/rc.d and press the return key.


Enter vi rc.inet1.conf and press the return key.
Use the arrow keys to move the cursor to the IP address following the open
quotation mark and delete the old IP address using the delete key.
Press the i key to enter insert mode and insert the new IP address.
Delete and enter any other information you would like to change.
Press the escape key to exit insert mode.
Enter :wq to save and exit and then restart the computer with reboot -n.

Page 16

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

Configuration

4.2

Configuration of Second Generation TELES.iGATEs

Configuration of Second Generation


TELES.iGATEs

The following configuration entries must be made in each TELES.iGATE in the


network.
Note:

For a description of the configuration of TELES.iGATEs containing


TELES.SIM emulation boards, see The TELES.vGATE Systems
Manual Version 3.7. To configure first generation TELES.iGATEs,
see Chapter 4.3.
Do not configure SIMs in the TELES.vGATE and TELES.iGATE
simultaneously. This can lead to database failures. Be sure to remove the SIM-card carrier from the TELES.iGATEs used with the
TELES.vGATE.

Configuration in the pabx.cfg


The SIMS parameter allows you to connect the system to a TELES.vGATE. The
first SIM must be defined in the appropriate mobile controller Subscriber line.
Note:

This parameter cannot be used with the following parameters:


<SIM24>, <SIMV> and <SIM+>.

Example 1 The following example is for TELES.iGATE GSM only. Example 2


below shows how to configure TELES.iGATE UMTS:
...
Subscriber00=TRANSPARENT
Subscriber01=TRANSPARENT
Subscriber02=TRANSPARENT
Subscriber03=TRANSPARENT
...

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

Example 2 The following example is for TELES.iGATE UMTS only. Example


1 above shows how to configure TELES.iGATE GMS:
...
Subscriber00
Subscriber01
Subscriber02
Subscriber03
...

=
=
=
=

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 TELES.vGATE Control Units IP address must appear in the category IP


Configuration in the [System] section of the TELES.iGATEs
pabx.cfg file:
SimCtrlUnitAddress=<ip addr>
Configure an additional controller in the last position for DTMF functionality as
follows:
2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 17

Configuration of Second Generation TELES.iGATEs

Configuration

Example:
Controller36=41DTMF

The corresponding Subscriber line will look like this:


Subscriber36=TRANSPARENT ROUTER CHMAX[5]

Note:

Page 18

Do not use GSM SIMs on UMTS TELES.iGATEs or vice versa.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

Configuration

4.3

Configuration of First Generation TELES.iGATEs

Configuration of First Generation TELES.iGATEs

Special drivers (nstanl.exe, pabxcfg.exe and status.exe) for the


TELES.vGATE application must also be installed on each connected
TELES.iGATE. Make sure you use the appropriate driver versions for each
TELES.iGATE.
Note:

For a description of the configuration of TELES.iGATEs containing


TELES.SIM emulation boards, see The TELES.vGATE Systems
Manual Version 3.7. To configure second generation
TELES.iGATEs, see Chapter 4.2.

The following configuration entries must be made in each TELES.iGATE in the


network.
No changes in the startpbx.bat are necessary.
Do not configure SIMs in the TELES.vGATE and TELES.iGATE
simultaneously. This can lead to database failures. Be sure to remove the SIM-card carrier from the TELES.iGATEs used with the
TELES.vGATE.

4.3.1

Configuration in the tib.cfg

SimServer:Yes
SimDBServer:<IP address of TELES.vGATE Control Unit>
Example:

In the following example, SimServerBCount:8 refers to the


number of TELES.iLCR 4 GSM Boards. SimServerBChan:-1
refers to the first B channel in the local SIM server process.

...
MailSendMax:1
MailSendRetries:1
SimServer:Yes
SimDBServer:172.16.0.30
SimServerBChan:-1
SimServerBCount:8
WanUserName:ip
WanPassword:ip
...

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 19

Configuration of First Generation TELES.iGATEs

4.3.2

Configuration

Configuration in the pabx.cfg

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:

This parameter cannot be used with the following parameters:


<SIM24>, <SIMV> and <SIM+>.

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

The TELES.vGATE Module

The TELES.SIM 60 Carrier

The TELES.vGATE Module

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

The TELES.SIM 60 Carrier

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

TELES.SIM 60 Carrier Front and Rear View


SIM0-6

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

Insert ONLY the TELES.SIM 60 Carrier into the


TELES.vGATE Board! Make sure all SIMs are clean and grease
free and that their mounts are properly closed.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 21

Installing Additional TELES.vGATE Boards

5.2

The TELES.vGATE Module

Installing Additional TELES.vGATE Boards

The system should only be installed, replaced or maintained by properly trained


technicians. Before installation, the following information must be read and understood.
The TELES.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 should
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 TELES.vGATE Boards so that they are earthed.
Avoid contact between the TELES.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 TELES.vGATE Board, attach a keyboard and monitor the
TELES.vGATE Sim Unit and use the keyboard to logon to the TELES.vGATE
Sim Unit as root with the password beamup. Exit the TELES.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 TELES.vGATE Sim Unit from the power supply before you open the housing.
Unscrew and remove the TELES.vGATE Sim Units lid and the bracket on top of
the boards.
Set the memory range on each new TELES.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.

Page 22

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

The TELES.vGATE Module

D900

D700
D800

D500
D600

D400

D200
D300

D100

TELES.vGATE Board: Memory Range Settings

D000

Figure 5-2

Installing Additional TELES.vGATE Boards

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.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 23

TELES.vGATE Board LEDs

TELES.vGATE Board LEDs

Each TELES.vGATE Board has eight


LEDs that provide a quick overview of the
TELES.vGATE Boards operational status.

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

Table 5-1 provides an overview of what the


Figure 5-4
individual LEDs mean.
Table 5-1

SIM States

5.3

The TELES.vGATE Module

TELES.vGATE Board
LEDs

TELES.vGATE Board LEDs


LED

Meaning

SIM states: Upper six LEDs


On

All ten SIMs are operational.

Slowly flashing

At least one, but not all, of the ten SIMs is operational.

Quickly flashing

At least one of the ten SIMs has an error.

Off

All ten SIM positions are empty.

Database connection: Second LED from the bottom


On

The TELES.vGATE Board is connected to the database.

Off

The TELES.vGATE Board is not connected to the database.

Flashing: 5 seconds
quickly, then slowly

The TELES.SIM 60 Carrier is initializing.

SIM access: bottom LED


On

At least one of the SIMs in the TELES.vGATE Board is


being accessed.

Off

None of the SIMs in the TELES.vGATE Board are being


accessed.

Page 24

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

TELES.vGATE Control Unit 12.0

TELES.vGATE Control Unit Hardware Installation

TELES.vGATE Control Unit 12.0

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

TELES.vGATE Control Unit Hardware Installation


1

LAN 1

4
Figure 6-1

LAN 2

TELES.vGATE Control Unit: Rear View

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

TELES.vGATE Control Unit: Assembly

Number

Description

1.

Plug the power cord in here.

2.

Plug your mouse in here.

3.

Connect the TELES.vGATE Control Unit to the Ethernet here. Make


sure you use the LAN 1 outlet.

4.

Plug your keyboard in here.

5.

Plug your monitor in here.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 25

Compatibility Requirements

6.2

TELES.vGATE Control Unit 12.0

Compatibility Requirements

TELES.vGATE Control Unit 12.0 is compatible with TELES.iGATE systems


running first generation Software Version 5.50d or higher, or second generation
11.6, and requires MySQL Version 4.0.x. Do not use or mix with lower versions.

6.3

vGateConfig

The configuration tool vGateConfig is


used to configure the TELES.vGATE.
Note:

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. 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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

TELES.vGATE Control Unit 12.0

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.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 27

vGateConfig

vGateDesktop

vGateDesktop

The vGateDesktop is a frontend application used for administration of the


TELES.vGATE. All SIMs and TELES.iGATEs can be maintained from a central
location using this application.
Note:

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 TELES.vGATE Control Unit accordingly!

The vGateDesktop allows you to group TELES.iGATEs together for a targeted


overview of activity. SIMs can be assigned to any TELES.iGATE connected to
the TELES.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 TELES.iGATE 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 7-1 shows the contents of each window as follows:

Groups: Lists groups of TELES.iGATEs


TELES.iGATEs: Lists all TELES.iGATEs in the selected group
Controllers: Lists all GSM ports on the selected TELES.iGATE
SIMs: All or filtered list of SIMs in the TELES.vGATE
Show Positions: The first drop-down list allows you to filter the SIMs displayed based on SIM positions. The second allows you to filter based on SIM
activity and assignment.
Timezones: Shows the times when SIMs are active on specific controllers
Timezones

Groups

Filters

SIMs

iGATEs

Figure 7-1

Page 28

vGateDesktop

Controllers (Ports)

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop

7.1

Figure 7-2

Automatic TELES.iGATE Registration

Automatic TELES.iGATE Registration

TELES.iGATE Registration

As soon as TELES.iGATEs have been configured and connected to the


TELES.vGATE, they must be restarted for automatic registration.
The respective windows shown in Figure 7-2 will then automatically list the connected TELES.iGATEs and their empty controllers. The inset shows what the
icons will look like in the case of a TELES.iGATE UMTS
As soon as a TELES.iGATE is configured as part of the TELES.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.

7.2

Setting Up TELES.iGATEs

To be able to distinguish one


TELES.iGATE from another, you
should give it a meaningful name. To
rename TELES.iGATEs, right-click
the TELES.iGATE 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.
Note:

For a detailed description


of all of the entries in this
dialog, see Chapter 7.12

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

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.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

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.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 31

Assigning SIMs

vGateDesktop

You can also edit timezones by selecting


Timezones List from the View menu. A dialog listing all of your timezones appears.
Right-click a timezone or an empty space to
Edit, Add or Delete a timezone.
Drag and drop with the right mouse button to
copy the contents of one timezones into another for one or all TELES.iGATEs in the
group.
To copy the contents of all timezones from
one TELES.iGATE to another in the same
group, you can also right-click the
TELES.iGATE to be copied and select Copy
Timezone Configuration to GW from the
context menu.

Figure 7-3

Copying Timezones

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.
Note:

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.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop

7.5.1

Assigning SIMs

Reserving SIMs to Inactive Timezones

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

1. We click Germany in the groups window.


2. Then we click Berlin in the list of TELES.iGATEs.
3. Next, we click the white space between the markers set at 8:00 and 18:00.
Now the space is blue and SIMs can be reserved for this timezone.
4. We select the controller to which we would like to assign SIMs, in this case
controller 0.
5. We mark the SIMs to be reserved to controller 0, in this case SIMs 1.001.011.001.04.
6. We right-click the SIMs we have marked and select Add to Selected Ctrls or
we can simply drag the SIMs to the corresponding controller while holding
down the left mouse button.
7. A pop-up dialog appears, from which we select Limit 1 and click OK.
8. SIMs 1.001.01-1.001.04 appear in the Limit 1 Reserved Positions column
(for a description of limits, see Chapter 7.6).
The SIMs appear in the Limit 1 Reserved Positions list. When this timezone becomes active, the SIMs will be assigned automatically to the Active Position and
the lamp icon will be yellow.
Now we want to assign SIMs 1.001.06-1.001.10 with Max Limit 2 to consecutive

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 33

Assigning SIMs

vGateDesktop

controllers 1 to 5:

Figure 7-5

Assigning SIMs to
Consecutive Controllers

1.
2.
3.
4.
5.
6.
7.

We follow steps 1 through 3 above.


We mark controller 1.
We mark SIMs 1.001.06-1.001.10.
We select Add Balanced to Ctrls.
A pop-up dialog appears, from which we select Limit 2 and click OK.
SIMs 1.001.06-1.001.10 appear in the Limit 2 Reserved Positions column.
SIMs 1.001.06-1.001.10 are now reserved to controllers 1-5 for this timezone
(for a description of limits, see Chapter 7.6).
The SIMs appear in the Limit 2 Reserved Positions list. When this timezone becomes active, the SIMs will be assigned automatically to the Active Position and
the lamp icon will be yellow.
The same steps can be followed to assign SIMs to an active timezone.

7.5.2

Assigning SIMs to Active Timezones

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop

7.5.3

Setting Time Limits and Pauses

Copying SIM Assignment

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

Setting Time Limits and Pauses

You can limit the number of time units a SIM


is used before the
TELES.iGATE switches to the next SIM or before
a
SIM
is
permanently deactivated.
The
TELES.iGATEs 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).

Figure 7-6

Settings Time Limits and Pauses

If the SIM is prepaid,


check Prepaid SIM. Since the SIMs limit is predefined, you must not set a limit
for prepaid SIMs. If you check Auto Recharge, the SIM will recharge automatically (see Chapter 7.7). 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. If you do not want to limit the number of recharges, click No Limit (default).

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 35

Setting Time Limits and Pauses

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop

Configuring Prepaid SIMs

released following a random number of minutes between the figures entered.


To delay SIM assignment, activate Assign Offset on TZ Changed, 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 TELES.iGATE.
When the checkbox Release SIM Immediately after Timezone Changed 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
8.4). If LimitWODISC=ON has been set in the TELES.iGATEs pabx.cfg, the
call will continue into the next Timezone if the limit is reached before the end of
the current Timezone.
Note:

Release SIM Immediately after Timezone Changed can only be


set for TELES.iGATE Version 6.11f and voip.box Version 182,
as well as for all second generation TELES.iGATEs.

7.7

Configuring Prepaid SIMs

As of TELES.iGATE Version 6.10g, prepaid SIM cards for up to 4 carriers can be


administered and recharged for each TELES.iGATE.

7.7.1

Configuration in the TELES.iGATE

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

The following configuration must be made in the TELES.iGATEs pabx.cfg


for each carrier. In the <controller bitmask> space, each controller must
2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 37

Configuring Prepaid SIMs

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:

Only 32 controllers can be set, regardless of the number of controllers


the TELES.iGATE has. All 32 controller bits must be set. The GSM
carrier must support USSD for this feature to work.

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.

Prepaid0=00000000000000000000000000001111 *100# "credit:" 30 60

Second Generation Only


MsgLog=/data/msg.log <saved> <size> <number>
or if no compact flash is included in the system:
MsgLog=/boot/msg.log <saved> <size> <number>
Note:

We strongly recommend that 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.

7.7.1.3

Finding the Search String

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:

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop

Configuring Prepaid SIMs

your available credit: 10.20


An appropriate search string would be credit:

7.7.1.4

Calculating the Multiplicator

To calculate the multiplicator, use the following formula:


Divide the total value of the SIM card by the price per minute. The result is the
total number of minutes on the SIM. Multiply the number of minutes by 60 to find
the number of seconds on the card. Divide the number of seconds by the figure
entered for the parameter ChargeUnitGenerate to find the number of time
units on the SIM. Now divide the number of time units by the total value of the
SIM card to find the multiplicator.
Example:

We have a SIM card with a value of 10 Euros. Each minute costs 20


cents, so that the card can be used for a total of 50 minutes, which is
3000 seconds. ChargeUnitGenerate is configured at 10 (default), for a figure of 300 time units. 300 divided by the total SIMcard value of 10 is 30. The multiplicator is 30. We then subtract the
60 units we have set as the remaining balance. According to our configuration example, a prepaid limit of 240 units will be sent to the
vGateDesktop.

7.7.2

Defining Prepaid SIMs on the vGateDesktop

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:

Right-click the SIM and select Define as Prepaid SIM.


Right-click the SIM and select Change Limits. Activate the Prepaid SIM
checkbox. If the SIM recharges automatically, activate the Auto Recharge
checkbox.
The following icons in the SIM window show that the SIM has been defined as
prepaid:
Table 7-1
Icon

Prepaid SIM Icons


Description
The SIM in this position is prepaid.
The prepaid SIM in this position recharges automatically.

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

Automatically Recharging Prepaid SIMs

vGateDesktop

Change Limits. Deactivate the Prepaid SIM checkbox.


You cannot define limits for prepaid SIMs. The SIMs prepaid limit will always
appear in the Max Limit 1 column.
Note:

When assigning or reserving SIMs to specific controllers, bear in


mind that the SIM must be assigned or reserved to a controller that
has been configured to handle the carriers prepaid traffic. An error
message will appear if a SIM is assigned to the wrong controller. To
avoid mistakes, enter the name of the carrier in the CTRL Info column by right-clicking the controller and selecting Edit CTRL Info.
You may also want to enter the carriers name in the SIMs Info 1 or
Info 2 column by right-clicking the SIM position and selecting
Change SIM Options. SIMs that are not prepaid can be assigned to
prepaid controllers, where they will function as they do on any other
controller.

7.8

Automatically Recharging Prepaid SIMs

As of TELES.iGATE Version 6.10g, prepaid SIM cards for up to 4 carriers can be


administered and recharged from the vGateDesktop.
Note:

Automatic recharge is not possible when a remote connection to the


TELES.iGATE exists. Only one SIM can be recharged on a
TELES.iGATE at any one time. Up to two SIMs can be recharged simultaneously if they are assigned two different TELES.iGATEs.

7.8.1

Configuration in the TELES.iGATE

To automatically recharge prepaid SIMs, the following entries must be made in


the TELES.iGATEs route.cfg:
A mapping character must also be defined for each carrier as follows:
MapAll<mapping character>??=<LAIN>*??01:
Second Generation
MapAllDTMF=41DTMF
First Generation
MapAllDTMF=40DTMF
Note:

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop

Automatically Recharging Prepaid SIMs

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:

You must also make the following entries in the tib.cfg:


Dtmf:Yes
DtmfMaxConns:16
DtmfTimeout:30

7.8.2

Configuration on the vGateDesktop

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 41

Automatically Recharging Prepaid SIMs

vGateDesktop

select Edit, Add or Delete from the context menu.

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

Setting Prepaid Recharge

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

Prepaid Recharge List

If you select Edit or Add, the Prepaid Recharge List Editor will appear. From here
Page 42

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop

Automatically Recharging Prepaid SIMs

you can define recharge numbers or edit existing ones.


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 Figure 7-10 Prepaid Recharge Editor
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 1-second pause and a P for a 10-second pause. You
may have to call the service center number and time the recording, so that you
know how long the pauses should be. If the recharge process takes longer than 240
seconds, the call will be disconnected.
In Figure 7-10, the Recharge String is DTMF:P1ppp010943667175#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.
The Prepaid Recharge List includes the following icons:
Table 7-2
Icon

Prepaid Recharge List Icons


Description
The code has not yet been used and is still available.
The number has been used and is no longer available.
An error occurred in the recharge process.
The number was used with no result.
The number is currently being used to recharge a SIM.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 43

SMS and Call Options

7.9

vGateDesktop

SMS and Call Options

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

Sending Calls and SMS

To define call and/or SMS sending,


you must define a mapping character
for each carrier you use for SMS and/
or call sending (see Chapter 7.8.2.1).
To open the SIM Options dialog, select Change SIM Options from the
context menu in the SIMs view.
Enter the number of calls and/or SMS
the SIM is to send. Activate the checkbox Day to send the number entered
every day. Otherwise they will be sent
monthly. Activate the appropriate
checkbox if a call and/or SMS is to be
sent immediately. If no calls or SMS
are to be sent from the selected SIM,
enter 0. If SMS and calls are only to be
sent to SIMs in the same group, if only
successfully placed calls are to be
counted in the Receiver list or if calls
are to be sent to SIMs coded with the
same color, activate the corresponding
Figure 7-11 SIM Options
checkboxes. To specify a group to
which calls and/or SMS are to be sent,
select a group from the drop-down menu Send to Receiver Group.
Note:

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop

SMS and Call Options

this box blank.


To send calls, 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:
Example:
MapAllZ??=26201*??01:
MapAllY??=26202*??01:
MapAllX??=26203*??01:
MapAllW??=26207*??01:

To send SMS, you must also enter SMS as follows:


MapAllSMS<mapping character>??=<LAIN>*??01: DATA
Example:
MapAllSMSZ??=26201*??01:
MapAllSMSY??=26202*??01:
MapAllSMSX??=26203*??01:
MapAllSMSW??=26207*??01:

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.

Subscriber00=TRANSPARENT ROUTER GSM[0000,00000,+49555,1,1,1,SIMS] CHADDR ALARM NEXT


Subscriber01=TRANSPARENT ROUTER GSM[0000,00000,+49666,1,1,1,SIMS] CHADDR ALARM
Subscriber02=TRANSPARENT ROUTER GSM[0000,00000,+00000,1,1,1,SIMS] CHADDR ALARM

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.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 45

SMS and Call Options

7.9.2

vGateDesktop

Receiving Calls and SMS

Figure 7-12

Receive Numbers List

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop

SMS and Call Options

Second Generation
Restrict<LAIN>=@FILE 05
First Generation
Restrict<LAIN>=@FILE:sms.log 05

7.9.3

Defining SMS Messages

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

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\vGATECtrl\SMSPath.
The file extension must be .sms. The content of the files must have the following syntax:
To:<num>
Msg:<message>
The commands To: and Msg: must appear at the beginning of the line, but more
2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 47

Special Services

vGateDesktop

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.

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

With TELES.iGATE versions 6.11c


or higher, the Special Service group
box in the SIM Options dialog (select
Change SIM Options from the context menu in the SIMs view) allows
you to define special services offered
for a SIM, such as special tariffs or
discount offers. These services can
then be automatically activated with
this function.
The commands for this function are
defined by scripts that are entered in
defined .ini files.
These commands can be carried out
automatically by activating any or all
of the following check boxes:

After Assign will activate the


script whenever the SIM is assigned.
On Change Limit Reached will
activate the script whenever the
SIMs change limit is reached.

Page 48

Figure 7-14

Special Service

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

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:

Make sure the TELES.GATE Manager is not connected to the


TELES.iGATE before you run any scripts. One remote channel is active for special services.

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

Special Service Script Commands


Commands

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.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 49

Special Services
Table 7-3

vGateDesktop

Special Service Script Commands (continued)


Commands

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop
Table 7-3

Special Services

Special Service Script Commands (continued)


Commands

SEND_DTMF_WAIT(<string>, <waitparam1>, <waitparam2>, <...>,


<timeout>)
The DTMF string 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). 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
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 7.8.2.1) and the mapping entries must exist in the
route.cfg.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 51

Special Services
Table 7-3

vGateDesktop

Special Service Script Commands (continued)


Commands

SEND_SMS_WAIT(<to>, <msg>, <waitparam1>, <waitparam2>, <...>,


<timeout>)
Sends a defined SMS and waits for a defined response. 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). 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
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
7.8.2.1).
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 7.8.2.1) and the mapping entries must exist in the
route.cfg. SMS service numbers must appear in the pabx.cfg.
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 7.8.2.1) and the mapping entries must exist in the
route.cfg.

Page 52

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop
Table 7-3

Special Services

Special Service Script Commands (continued)


Commands

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.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 53

Special Services
Table 7-3

vGateDesktop

Special Service Script Commands (continued)


Commands

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop

7.11

Defining the SIMs Protocol

Defining the SIMs Protocol

At the bottom of the SIM Options dialog, you can select


which protocol will be used for
dual SIMs. If you select Automatic
(default),
the
Figure 7-15 SIM Protocol
TELES.vGATE will set the
protocol based on that of the
TELES.iGATE. If the TELES.iGATE is UMTS, the SIM will be assigned as a
UMTS SIM; if the TELES.iGATE 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 TELES.iGATE. If you select GSM, the SIM will be assigned as a
GSM SIM, regardless of the TELES.iGATEs protocol. If you try to assign a
UMTS SIM to a GSM TELES.iGATE or vice versa, a confirmation dialog will
appear.
Note:

This option is only possible with TELES.vGATE Sim Unit Version


29 or higher. The TELES.vGATE Sim Unit Version 29 is compatible
only with TELES.vGATE Version 12.0 or higher.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 57

Adding and Editing TELES.iGATEs

vGateDesktop

7.12

Adding and Editing TELES.iGATEs

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:

These settings must correspond with the settings on the individual


TELES.iGATE.

Table 7-4

iGateEditor
Entry

Description

iGate

This part of the window is for basic setup information.

Name

Enter a meaningful name for the TELES.iGATE here.

IP Address

Enter the TELES.iGATEs IP address here.

Port

Enter the TELES.iGATEs port number.

Group

Use the drop-down menu to assign a TELES.iGATE to a


group (only possible when adding a new TELES.iGATE).

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop
Table 7-4

Adding and Editing TELES.iGATEs

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

Leave this space empty to use the default port for


TELES.GATE Manager access.

Password

For added security, enter a password for TELES.GATE


Manager access.

Use FTP for file


transfer

Activate the checkbox to transfer files in TELES.GATE


Manager via FTP.

User

Enter the user name configured to transfer files in


TELES.GATE Manager via FTP.

Password

Enter the password configured to transfer files in


TELES.GATE Manager via FTP.

Remote State Actions

This section is for setting the number of registration retries before a SIM is blocked.

ASR 3 times below 30%

If you set log only (recommended), 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.

Too many announcements

Depending on the settings on the individual


TELES.iGATE, an error message will be sent when a certain number of calls result in a recorded announcement.
If you set log only, an error message will be entered in
the database when the amount set in the TELES.iGATE
is reached. If you set a number (1 is recommended), 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.

SIM blocked (GSM)

When a SIM is blocked, an error message is automatically entered in the database. This setting cannot be
changed.

SIM barred (GSM)

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).

Block former SIM

When this box is checked, SIMs will be blocked after the


number of SIM barred occurrences entered.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 59

SIM History
Table 7-4

vGateDesktop
iGateEditor (continued)

Entry

Description

Get CDRs

Activate the checkbox to retrieve 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

Enter the time at which CDRs are to be retrieved daily.

Start Time 1

Enter the retrieval time for CDR Filename 1 here.

Limit Call/SMS
Generation

This group box allows you to set a limit for generation of


calls and/or SMS.

Maximum simultaneous
calls

This option allows you to set a maximum number of calls


that can be sent simultaneously from the TELES.iGATE.
Enter the maximum number or check No limit if you do
not want to set a limit. To set one limit for the entire
TELES.iGATE, see Chapter 8.4. Any limit set in
vGATECtrl will take priority over limits set for individual
TELES.iGATEs.

Maximum simultaneous
SMS

This option allows you to set a maximum number of SMS


that can be sent simultaneously from the TELES.iGATE.
Enter the maximum number or check No limit if you do
not want to set a limit. To set one limit for the entire
TELES.iGATE, see Chapter 8.4. Any limit set in
vGATECtrl will take priority over limits set for individual
TELES.iGATEs.

7.13

SIM History

Right-click a SIM and select SIM History from the Reports submenu to call up

Page 60

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop

SIM History

a window containing information about that SIMs activity.

Figure 7-17

SIM History

Entries are color-coded as follows:


Green=OK
Yellow=Warning
Orange=Minor
Red=Major
Pink=Critical
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 7-5

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

SIM History Icons


Description
Click this icon to actualize the information displayed in the history. All new
information will be retrieved from the database.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

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

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

Shows the amount of time the SIM was assigned.

Carrier

Shows the name of the carrier.

Connected Calls

Shows the number of successfully connected calls placed using the SIM.

Ctrl

Shows the controller on which the SIM was active.

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

Shows the name of the TELES.iGATE on which the SIM was


active.

Incoming Calls

Shows the number of incoming calls placed using the SIM.

Outgoing Calls

Shows the number of outgoing calls placed using the SIM.

Position

Shows the SIMs position number.

Remote Busy

Shows the number of calls that resulted in a busy signal.

Timestamp

Shows the time when the SIM was released.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

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.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop

7.15

What the Information on the vGateDesktop Means

What the Information on the vGateDesktop Means

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

Lists the TELES.iGATEs in the selected group by name.

Address

Shows the IP address for the corresponding TELES.iGATE.

Status

Contains status messages and the serial number.

Serial#

Shows the TELES.iGATEs serial number (second generation


TELES.iGATEs only).

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

Lists the controller numbers.


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.
Contains status messages for the controller sent by the
TELES.iGATE.
Shows comments you have entered for this controller.
Lists actions currently being carried out. Possibilities are Release and Search and Assign.
Shows Info 1 comments you have entered for the SIM that is
currently active.
Lists errors that occur at the corresponding port (UMTS).
If an X appears in this column, the controller is a UMTS controller.
Lists SIM cards by their positions in the TELES.SIM 60 Carrier.
The syntax for the position numbers is <TELES.vGATE Sim
Unit>.<TELES.vGATE Module>.<SIM position>. The list is colorcoded, so that all the positions listed on the same background
color represent one TELES.vGATE Module.
Lists the colors that have been set to mark individual SIMs, e.g.
according to carrier.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 67

What the Information on the vGateDesktop Means


Table 7-8

vGateDesktop

vGateDesktop Columns (continued)

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

Shows when the SIM will send the next SMS.


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
Shows comments you have entered for this SIM.
Info 2
Shows comments you have entered for this SIM.
Active Release
Shows the number of minutes you have defined that a SIM will
be active before it is released.
Max Call Duration Shows the number of seconds after which calls will be disconnected.

Page 68

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop
Table 7-8

vGateDesktop Columns (continued)

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 69

vGateDesktop Icons
Table 7-9
Icon

vGateDesktop

vGateDesktop Icons (continued)


Definition

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 TELES.iGATE UMTS.
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.
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.

Page 70

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

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

vGateDesktop Menu Bar

Command

Definition

File Menu
Exit

Closes the vGateDesktop.

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 list of carriers.

Prepaid Recharge List

Click here to open and edit a table containing information


about prepaid recharge numbers.

SMS Message 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

Click here to hide or display the status bar. The number


of SIMs and TELES.SIM 60 Carriers is displayed in the
middle of the status bar and the time and date of the
TELES.vGATE Control Unit is on the right.

Toolbar

Click here to hide or display the toolbar.

Split

Click here for a resize cursor to adjust the size of the windows on the vGateDesktop.

Refresh

Click here to update the information displayed.

SIMs not in SIM Unit

Click here to call up a list of SIMs once in the


TELES.vGATE Sim Unit that have been removed. Rightclick a SIM to Delete from Database.

SIMCarrier Status

Calls up a window containing the status of the


TELES.SIM 60 Carriers in the TELES.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.

Help
About vGATEDesktop

Click here to view version information for the


vGateDesktop and vGATECtrl installed.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

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

vGateDesktop Toolbar Buttons


Function
Click here to open a list of all Timezones for the selected group.

Click here to call up a window containing the status of the TELES.SIM 60


Carriers in the TELES.vGATE Sim Unit.
Click here to open and edit the list of carriers.

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop
Table 7-11
Icon

vGateDesktop Toolbar

vGateDesktop Toolbar Buttons (continued)


Function
Click here to call up a record averaged statistics for the marked SIMs, controllers or TELES.iGATEs, 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.
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
TELES.iGATE or group.
Click here to call up a line chart of call statistics for the selected
TELES.iGATE or group.
Click here to refresh the vGateDesktop.

Click here to view version information pertaining to the vGateDesktop and


vGATECtrl.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

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

vGateDesktop Context Menus

Command

Definition

Groups
Create Group

Click here to add a new group.

Edit Group

Click here to change the name of an existing group.

Delete Group

Click here to delete a group.

Show Call Statistics

Contains a record of the averaged statistics for all calls


that have gone through this group.

Show Call Chart

Contains statistic charts for all calls that have gone


through this 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

Click here to remove a TELES.iGATE from the


TELES.vGATE.

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

Use the drop-down list box to select a TELES.iGATE and


click OK. The timezone configuration for the marked
TELES.iGATE will be copied into the TELES.iGATE you
select from the list.

Change Group

Use the drop-down list box that appears to switch this


TELES.iGATE to another group.

Free SIMs of dead


iGate

When an interruption occurs in the connection between


the TELES.vGATE Control Unit and the TELES.iGATEs,
traffic continues but the SIMs are locked, so that they
dont log onto another TELES.iGATE. Click here to allow
other TELES.iGATEs access to these SIMs.
NOTE: Select this option only if you are sure that the SIM
will not log on twice, as SIMs registered with more than
one TELES.iGATE can alert a GSM carrier to block the
SIM.
If you use this command, be sure to look for and eliminate
the problem that caused the interruption.

Set Maintenance Mode

Causes the TELES.iGATE to release all of its SIMs immediately. All calls will be torn down.

Page 74

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop

Table 7-12

Context Menus

vGateDesktop Context Menus (continued)

Command

Definition

Reset Maintenance
Mode

Reconnects the SIMs released when Set Maintenance


Mode was selected.

Reinit

Initiates a check of the TELES.iGATEs status against the


database. Inconsistencies will correct themselves automatically. Wherever possible, SIMs will be assigned to
empty controllers.

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.

Show SIM Route

Calls up a table containing an overview of reserved positions. Right-click to refresh the window.

Show Call Statistics

Contains a record of the averaged statistics for all calls


that have gone through this TELES.iGATE.

Show Call Charts

Contains statistic charts for all calls that have gone


through this TELES.iGATE.

Controllers
Release SIM

Deactivates a SIM.

Release SIM
Immediately

The SIM will be released immediately, even if traffic is


running on it.

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

Activates a reserved SIM. If multiple SIMs are reserved,


the one that has the highest priority. If SIMs have the
same priority, the one that has been idle longest will be
assigned.

Reassign SIM

The SIM or SIMs will be released and reassigned. This is


useful when an active SIMs parameters (e.g. limits) have
been changed.

Stop Recharging

Click here to cancel the recharge process running.

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.

Start Special Service

Opens a browser to allow manual selection of special service (see Chapter 7.10).

Stop Special Service

Special service is stopped and the SIM is released.

Edit CTRL Info

Click here to edit the information that appears in the


CTRL Info column.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 75

Context Menus

Table 7-12

vGateDesktop

vGateDesktop Context Menus (continued)

Command

Definition

Edit SIM Linkage

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.

Remove SIM Linkage

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.

Reset Error/Unblock
CTRL

Click here to remove error entries from and unblock this


controller. After the message has been removed, the SIM
can be reassigned.

Show SIM Route

Calls up a table containing an overview of reserved positions. Right-click to refresh the window.

Show SIM Statistics

Contains a record of the averaged statistics for SIMs that


have been active at this controller.

Show Call Statistics

Contains a record of the averaged statistics for all calls


that have gone through this controller.

SIMs
Change Limits

Calls 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 7.6 on page 35).

Change Priority

Calls up a drop-down list box from which you can define


the SIMs priority. The SIM in the reserved position with
the highest priority will be used when the reserved position becomes active. If no priority has been set, or if SIMs
share the same priority, the SIM that has been idle longest will be used.

Change SIM Options

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.

Change Color in Sim


Route View

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.

Define as Prepaid SIM

Click here to designate a SIM as prepaid.

Reset Count

Resets the Count column at 0.

Reset Limits

Click here to reset Max. Limits manually to their configured maximum limit.

Remove SIM(s) from


all Routes

All selected SIM(s) will be removed from their Reserved


Positions. Active SIM(s) will not be removed.

Page 76

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGateDesktop

Table 7-12

Context Menus

vGateDesktop Context Menus (continued)

Command

Definition

Reserve SIM Like

Click here to call up a dialog where you can enter a SIM


number. The marked SIM will then adopt the same reservation properties as the SIM you enter. Check Limit 1
and/or Limit 2 and the marked SIM will also adopt the entered SIMs limits.

Add to Selected Ctrls

Click here or press Ctrl+A to assign the marked SIMs to


the selected controllers.

Add Balanced to Ctrls

Click here or press Ctrl+B to reserve the marked SIMs individually to consecutive controllers, beginning with the
selected controller.

Block SIM

Click here to manually block this SIM. Only inactive SIMs


can be blocked manually.

Reset Error/Unblock
SIM

Click here to remove error entries from or unblock this


SIM. After the message has been removed, the SIM can
be reassigned.

Stop Pause

Deactivates Minimum Pause after Last Use one time.


The pause will be reactivated following the next release.

Reset TZ Change
Counter

Resets the Timezone counter (see Chapter 7.6: Maximum Usage per TZ).

Select CTRL

Marks the controller where the selected SIM is currently


active.

Show SIM Route

Calls up a table containing an overview of reserved positions. Right-click to refresh the window.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 77

Context Menus

Table 7-12

vGateDesktop

vGateDesktop Context Menus (continued)

Command

Definition

Reports

Use the submenu to call up one of the following tables:


Sim History: contains information about the activity of
the selected SIM (see Chapter 7.13 on page 60).
SIM Usage: contains a record of the SIMs assignment.
SIM Statistics: contains a record of the SIMs averaged statistics.
SIM Statistics of SIM Color Group: contains a record
of averaged statistics for SIMs in the same color group.
Last Released: contains information about when the
SIM was last released.
Released with Count Below: contains a record of
SIMs released below a defined count within a defined
number of days. Check Report SIMs only once per
day and each SIM will be entered only once on any
given day.
Change Limit Reached: contains a record of SIMs released after a limit was reached. Use the drop-down
menu to select the number of days the report contains.
Maximum Limit Reached: contains a record of SIMs
permanently removed from traffic after their maximum
limit was reached. Use the drop-down menu to select
the number of days the report contains.
SIM Errors: contains a record of errors occurring on
the SIM. Use the drop-down menu to select the number of days the report contains.
All reports can be exported and saved to a .txt, .xls or .slk
files.

SIM Information

Click here to call up a table containing all of the information pertaining to the SIMs TELES.vGATE configuration.

Export to File

Click here to open a browser into which you can save a


text file containing the current status of all SIMs.

Page 78

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGATECtrl

Figure 8-1

Context Menus

vGATECtrl

vGATECtrl

The vGATECtrl application is the TELES.vGATE Control Units background


server. You can use it to record and display a log of activity, send e-mail error
messages and tear down all TELES.vGATE connections. Open the vGATECtrl by
double-clicking the
Note:

button in the bottom right-hand corner of the taskbar.

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!

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

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

Sending Error Messages Via E-Mail

To send error messages via e-mail, select


Mail Settings from the Options menu. In the
pop-up dialog, activate Send Mail and enter
the recipients e-mail address, the SMTP
Server and the name of the sender in SMTP
Originator. To secure access to the mail
server, activate Logon and enter a Username and Password. Activate Base64 Encoding to encode logon. Check one or more
of the Filters to select the errors for which
messages should be sent.
Figure 8-2

8.3

Mail Settings

Tearing Down Connections

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.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

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.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

vGATEWatch

Options

vGATEWatch

Figure 9-1

vGATEWatch

vGATEWatch is a watchdog function that causes vGATECtrl and/or the MySQL


database 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

icon will appear in the taskbars right-hand corner.

If you select Stop Watching from the context menu, the


icon will appear in
the taskbar and the watchdog function will shut down. Click Restart Watching to
restart the function.
Double-click the icon or select Restore from its context menu to open
vGATEWatch. From the Options menu, you can turn sound on or off, so that an
alarm sounds when vGATECtrl or MySQL shuts down. Select Reboot if Database Not Running and/or Reboot if vGATECtrl Not Running and the computer
will restart whenever one or both of these applications shuts down.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 83

Options

10

Starting the Windows2000 Control Unit Without Logon

Starting the Windows2000 Control Unit Without Logon

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

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

Remote Access to the TELES.vGATE Control Unit

11

Options

Remote Access to the TELES.vGATE Control


Unit

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:

The remote PC must be connected to the TELES.vGATE Control


Unit with an Ethernet connection of at least 10 MB.

Configuration for Remote Access


The
configuration
tool
vGateConfigRemote is used to configure the TELES.vGATE for remote access.
Use the desktop shortcut to start the
program
vGateConfigRemote.exe.
Answer all queries with OK.
In the Database section, leave the
default Name as is. Enter the Figure 11-1 Configuration for Remote
TELES.vGATE Control Units IP
Access
address in the Host space. Do not
change the default Port. Enter the User name simdbuser and the Password simdb.
In the Frontend Server section, enter the TELES.vGATE Control Units IP address again in the Host space and do not change the Port. Click Apply or OK.
You can now open the vGateDesktop for remote access to the TELES.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 6.3).
Note:

Bear in mind that only one vGateDesktop can be open at a time, regardless of its location.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 85

Options

12

Updating the Database SimServerDB

Updating the Database SimServerDB

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:

TELES.vGATE Version 12.0 is compatible only with MySQL Version 4.0.X.

Stop the WinMysqlAdmin Service by right-clicking the


icon in the righthand corner of the taskbar and selecting WinNT -> Stop the Service from the
context menu. The traffic light will then turn red.
Restart the WinMysqlAdmin Service by selecting WinNT->Start the Service
from the same context menu, so that the traffic light turns green.
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 password:simdb and press Return
Enter the command \. (backslash period space) and enter the path to the script
(in this example, on the E: drive):
E:\vGATEVersion\V12.0\Disk1\DatabaseScripts\DIFF_V36_V120.sq
l
Press the Return key
Enter exit to exit mysql
Stop the WinMysqlAdmin Service by right-clicking the
icon in the righthand corner of the taskbar and selecting WinNT -> Stop the Service from the
context menu. The traffic light will then turn red.
Restart the WinMysqlAdmin Service by selecting WinNT->Start the Service
from the same context menu, so that the traffic light turns green.
Delete the old versions of and the shortcuts to vGATECtrl.exe,
vGateDesktop.exe, vGateConfig.exe and libmySQL.dll from
the directory D:\vGATEControl.
Start Setup.exe from the folder E:\vGATE-Version\V12.0\Disk1.
Confirm all queries by clicking Next or Yes.
Open and then close the vGateConfig shortcut. Confirm all queries with Yes.
If necessary, reenter any settings in the shortcuts Properties.
Following installation of TELES.vGATE Version 12.0, TELES must release it

Page 86

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

Updating the Database SimServerDB

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.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 87

Options

13

Creating a Backup of the Database

Creating a Backup of the Database

To secure your database, we strongly recommend that you creat a backup.


To create a backup of the database, create a directory E:\BackupDB and copy
the database F:\mysql\data\SimServerDB into the new directory.
To distinguish between different database versions, rename the database to include the version number in the name. To find the version number, select About
vGateDesktop from the Help menu of the vGateDesktop.
Example:

Page 88

You want to create a backup for Version 3.2. The path for the backup
database will be: E:\BackupDB\SimServerDB32.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

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 card is missing or defective.


Dust or contact
problems on the
SIM or in the
TELES.SIM 60
Carrier.

Insert another SIM


card at this position.
Clean the contacts
on the SIM and the
TELES.SIM 60
Carrier with alcohol.

SIM card line is


red.

SIM Broken

Registration process failed repeatedly.


TCP/IP connection from the
TELES.iGATE to
the
TELES.vGATE
Sim Unit is inadequate or unavailable.

Check the TCP/IP


connection between the
TELES.iGATE and
the TELES.vGATE
Sim Unit.

SIM card and controller lines are red.


Entry in the controller lines Remote
State column.

SIM Blocked

GSM network is
overloaded.
Missing TCP/IP
connection to the
TELES.vGATE
Sim Unit.
SIM card has
been blocked.

Replace the SIM


card after the third
failed registration
attempt.

SIM card and controller lines are red.


Entry in the controller lines Remote
State column.

Ping Timeout

Missing TCP/IP
connection to the
TELES.iGATE.

Check the TCP/IP


connection between the
TELES.vGATE
Control Unit and
the TELES.iGATE.

Group and
TELES.iGATE
lines are red.

Connection refused

TELES.iGATE
cannot be
reached.

Check the TCP/IP


connection.
Check the status of
the TELES.iGATE.

Group and
TELES.iGATE
lines are red.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

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.

Inform TELES NetService.

SIM positions do
not appear in the
SIM window of the
vGateDesktop.

SIM barred

Registration process unsuccessful.


SIM card is
blocked.

Restart the corresponding


TELES.iGATE port
manually.
Check the TCP/IP
connection between the
TELES.iGATE and
the TELES.vGATE
Sim Unit.
Replace the SIM
card.
Check
TELES.vGATE
configuration in the
TELES.iGATE.

Entry in the controller lines Remote


State column.

Wrong PIN

SIMs PIN is incorrect or different from that of


the other SIMs.

Change the PIN. All


SIM cards in the
TELES.vGATE
must have the
same PIN.
Reassign the SIM
card.

Entry in the controller lines Remote


State column.

CTRL incorrectly configured

Controller has
not been defined
as prepaid.

Assign SIM to a
correctly configured controller or
configure controller as prepaid.

Entry in the controller lines Error column and controller


line appears in red.

No recharge
number found

Recharge number missing from


recharge list.

Enter a recharge
number in the list.

SIM line highlighted in yellow and


entry appears in
the Error column.

Page 90

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

Troubleshooting
Table 14-1

Options

Troubleshooting (continued)

Error

Cause

Solution

vGateDesktop
Status

Sending recharge call


(OK), no answer, no limit
indication after
2 minutes.

Carrier does not


respond to recharge call within 2 minutes.
Wrong recharge
number.

Try again with the


same SIM.

SIM line highlighted in yellow and


entry appears in
the Error column.

Job timeout
during wait.

Scripting error.
No answer to
USSD query.

Check script for


mistakes.
Try again.

SIM line highlighted in red and entry


appears in the Error column.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22, Issue: September 2006

Page 91

Options

Supported TELES.iGATEs

15

Supported TELES.iGATEs

Table 15-1 contains information about the gateways supported by the


TELES.vGATE and their compatibility requirements.
SIM-card carriers are not required in TELES.iGATEs designed for SIM 24 carriers. TELES.iGATE systems designed for SIM 8, SIM 16 or SIM 32 carriers must
contain SIM Emulation Boards.
Table 15-1

Supported GSM Gateways

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

SIM 4, SIM 8, SIM 16, SIM 32 5.50d

TELES.iGATE 32 VoIP

SIM 4, SIM 8, SIM 16, SIM 32 5.50d

TELES.iGATE 48 VoIP

SIM 4, SIM 8, SIM 16, SIM 32 5.50d

TELES.iGATE 60 IP

SIM 4, SIM 8, SIM 16, SIM 32 5.50d

TELES.iGATE-C 4-32 IP

SIM 4, SIM 24

6.10f

TELES.iGATE-C 4-32 VoIP

SIM 4, SIM 24

6.10f

Note:

Page 92

For details on how to configure TELES.iGATE systems containing


SIM 8, SIM 16 or SIM 32 carriers, see Chapter 6.4.2 of TELES Infrastructure Systems Manual Version 4.5.

2006 by TELES AG Berlin, Version 12.0/SH-e/09.22 Issue: September 2006

S-ar putea să vă placă și