IRON-AG-02 00 Ed21

IRON-AG-02.
20, Dec-2015
IRON MANAGEMENT INTERFACE

ADMINISTRATION GUIDE
Copyright Notice
2015 Copyright iQsim SA

Les Algorithmes Pythagore B
2000 Route des Lucioles
Sophia-Antipolis
06410 BIOT
FRANCE
Edited in France, updated December 2015
All rights reserved. This product and its related documentation are protected by copyright and distributed
under iQsim licenses to its authorized users only. Authorized users who have purchased one or more iQsim
products described herein can download and print a copy of this publication.
No part of this product or its related documentation may be reproduced, adapted or translated without prior
written authorization of iQsim. The information contained herein is subject to change without prior notice.
iQsim SA
Les Algorithmes Pythagore B
2000 route des Lucioles
Sophia-Antipolis
06410 BIOT
FRANCE
Phone: +33 (0) 4 97 04 19 30
Fax: +33 (0) 4 97 04 19 31
URL: http://www.iqsim.com
E-mail: info@iqsim.com
iQsim 2015
Page 2/131
Trademarks
iQsim is registered trademarks of iQsim SA.

All other products mentioned herein may be trademarks or registered trademarks of their respective
companies and are hereby acknowledged.
iQsim 2015
Page 3/131
Disclaimer
Information contained herein supersedes preliminary specifications or data sheets of the product as well as
earlier versions of this publication, if any.
While every effort has been made to ensure the accuracy of this publication, iQsim assumes no liability for
omissions or editorial errors contained herein. iQsim reserves the right to revise the information herein at any
time without prior notice. Changes and improvements will be incorporated into the new version of this
publication.
This publication is provided as is without warranty of any kind. iQsim hereby disclaims all warranties, either
express or implied, including but not limited to, all warranties OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE, and those ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE.
IN NO EVENT SHALL iQsim BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL OR INCIDENTAL
DAMAGES, INCLUDING but not limited to, all damages resulting from LOSs of use, data or PROFITS ARISING
OUT OF THE USE of OR INABILITY TO USE THIS product, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES.
iQsim 2015
Page 4/131
Contents
1.
IRON Management Interface ................................................................................................... 10

1.1.
1.2.
Login to the IRON interface .............................................................................................................. 11

IRON Interface Overview ................................................................................................................. 12
1.2.1.
1.2.2.
1.2.3.
1.3.
IRON Web Applications ....................................................................................................................................... 12

IRON Filter Utility ................................................................................................................................................. 14
IRON Quick Search Bar ........................................................................................................................................ 16
START MENU options ...................................................................................................................... 17
1.3.1.
System Settings ............................................................................................................................................ 17
1.3.2.
Services Manager (ISSO, VMware All-in-One only)...................................................................................... 27
1.3.3.
Backup / Restore (ISSO, VMware All-in-One only) ....................................................................................... 28
1.3.4.
FTP Service (ISSO, VMware All-in-One only) ................................................................................................. 29
1.3.5.
Export SMS Stats .......................................................................................................................................... 29
1.3.6.
Daily Device Report (ISSO, VMware All-in-One only) .................................................................................. 29
1.3.7.
Status Legends ............................................................................................................................................. 30
1.3.8.
About ........................................................................................................................................................... 31
1.3.9.
Logout .......................................................................................................................................................... 32
1.3.10.
Reboot ......................................................................................................................................................... 32
1.4.
IRON Applications ........................................................................................................................... 33
1.4.1.
Users ............................................................................................................................................................. 33
1.4.2.
Partition (IRON Suite only) ............................................................................................................................ 39
1.4.3.
SIM Manager (IRON Suite only) ................................................................................................................... 41
1.4.4.
Sim Rack ....................................................................................................................................................... 43
1.4.5.
GSM Device .................................................................................................................................................. 49
1.4.6.
Port Group ................................................................................................................................................... 57
1.4.7.
GSM Port ...................................................................................................................................................... 61
1.4.8.
HBS (Human Behavior Simulator) ................................................................................................................ 65
1.4.9.
Voucher Code .............................................................................................................................................. 73
1.4.10.
Sim Cards ..................................................................................................................................................... 75
1.4.11.
Sim Events .................................................................................................................................................... 80
1.4.12.
Sim Group .................................................................................................................................................... 81
1.4.13.
Sim Plan ....................................................................................................................................................... 82
1.4.14.
Allocation Rule ............................................................................................................................................. 98
iQsim 2015
Page 5/131
1.4.15.
Service Controller ...................................................................................................................................... 100
1.4.16.
Device Group ............................................................................................................................................. 104
1.4.17.
SIP Devices ................................................................................................................................................. 105
1.4.18.
Routing Tables ........................................................................................................................................... 107
1.4.19.
SMS Campaigner ........................................................................................................................................ 113
2.
Configuration example .......................................................................................................... 116

2.1. Example of Configuration for Mobile Termination ...........................................................................116
2.2. Generate automatic predefined calls with the HBS ..........................................................................118
2.3. Recharge prepaid SIM cards ............................................................................................................120
2.4. ..........................................................................................................................................................121
2.5. Configure the credit check and synchronization...............................................................................122
2.6. Manually allocate a SIM to a GSM port for troubleshooting purpose ...............................................123
3.
Troubleshooting .................................................................................................................... 124

3.1.1.
3.1.2.
3.2.
3.3.
Event viewers .................................................................................................................................................... 124

Events types....................................................................................................................................................... 126
SIM Activity Log..............................................................................................................................126

Related Documentation ..................................................................................................................131
iQsim 2015
Page 6/131
About This Document

About
This Administration Guide document serves as a tutorial as well as an administration guide for the IRON Management
Interface products family: IRON Suite, IRON SIM Server One, Iron Smart SIM Rack and VMware All-In-One.
This document is compliant with following minimum version software release:
-
Iron Suite: ISE02.31

Iron SIM Server One, Iron Smart SIM Rack: SS203.67
VMware All-In-One: SS203.67
Audience
This document is intended for experienced technicians, service representatives, and other persons trained to manage
hardware devices and software programs of VoIP telecommunication systems and GSM Networks.
Before reading this document

In order to perform the hardware and the software installation of the IRON SIM Server One, read carefully the document:
Getting Started with IRON Suite (IRON appliances or VMware)
Getting Started with IRON SIM Server One
You may want to read as well:

Getting Started with Sim Rack
Getting Started with GSM Device
These documents are available at http://support.iqsim.com
Convention, This document applies the following typographic conventions

Note
A note provides additional or complementary information on a particular subject.
Caution
A caution gives important instructions to be followed. You risk damaging your equipment or losing your
data if you do not follow the instructions.
Warning!
A warning calls attention to important alerts that will cause personal injury, health hazard or
permanent damage to your equipment if not observed.
iQsim 2015
Page 7/131
Computer Text
Computer generated text such as program code or command prompt is shown in Courier font..
Dialog/Menu/
Button
Linux, Windows & Web, dialogs, menus or buttons of a computer program are printed in bold.
Comments
iQsim is committed to providing documentation that matches your expectations. We welcome any
feedback, question or suggestion to help us improve our documentation quality.
Please send your comments to support@iqsim.com together with the document title and number as
indicated on the cover page of this document.
iQsim 2015
Page 8/131
Customer Service
Purchase from iQsim
For any products purchased directly from iQsim, contact iQsim Customer Service should you need further assistance
(please kindly have your customer ID and product serial number ready):
iQsim Customer Service
Headquarters Help Desk (Europe):
E-mail:
URL:
+33 (0) 4 97 04 19 39
support@iqsim.com
http://support.iqsim.com
Purchase from retailer

For any products purchased from a retailer or distributor, contact your respective retailer or distributor should you have
any questions regarding the product received or need further technical assistance.
iQsim 2015
Page 9/131
Chapter 1 - IRON Management Interface
1.
IRON Management Interface

Introduction
The IRON Management Interface is 100% web based and gives access to the IRON Configuration and Administration
Interface for the Sim Card control, the Routing SIP Management, Devices Management, Human Behavior
Management and many more advanced parameters and settings for system.
Caution
The web interface works with all latest version of common browser from the market, however the
IRON web interface is based on Google technology and is faster using Chrome browser.
Note
The Web access point may depends on the type of IRON product; please refer to the Getting Started
document based upon your product. Also, this document describes the whole interface and some
option may not be present in all IRON products.
iQsim SA 2015
Page 10/131
1.1.
Login to the IRON interface
Procedure
IRON products family provides a web based management interface and requires an authentication process for
connection. Follow the instructions described in the table below to get access (default process)
Steps
1
Action
Launch your web browser
Enter the default URL as follows:
http://IRON_WEB_SERVER:8000
IRON_WEB_SERVER stands for the hostname or the IP address of the IRON Management
Interface Server.
IRON Suite: The IP is the WEB SERVER unit server

IRON SIM Server One: default is http://192.168.1.10:8000
NB: The HTTP or HTTPS default 8000 TCP port can be modified.
2
The Management Interface login page will be displayed
Enter your password then click Enter.

Default user is administrator and default password is iqsim
iQsim 2015
Page 11/131
1.2.
IRON Interface Overview
Introduction
The IRON Management Interface is a web desktop interface. It is similar to any computer desktop interface with set
of Icons designing the applications you are able to use.
Also a Start Menu gives you access to all applications as well as to system settings.
Note
Type and number of Web Applications may depend on the IRON product or license option in use
1.2.1. IRON Web Applications

The IRON Management Interface provides access to a various set of web applications (aka web app), each web
application is dedicated to a specific task and is designed by an icon.
Icon
Task
Users
Define user access, user rights and user privacy rights
Users Logs
List all the actions done by the users
Partitions
IRON Suite only
IRON product family allows to create virtual partition in order to share same Hardware platform
SIM Manager
IRON Suite only
IRON Suite manages multiple SIM Manager for scalability, load balancing and redundancy
GSM Device
Authorize, register, localize and control all GSM device
GSM Port
Monitoring utility for every GSM ports status
Port Group
Advanced feature for managing virtual GSM devices
Sim Rack
Control Sim Racks connection
iQsim 2015
Page 12/131
Icon
Task
Sim Cards
Monitor and configure any Sim Card information
Sim Plan
Define Sim Card Credits, Recharge, Activation and Protection
Sim Events
Monitoring utility for Credit Check, Recharge and Activation events
Sim Group
Customized group of sim cards
Allocation Rule
Control Sim Card location, usage time & amount as well protection
HBS (Human Behavior Simulator)
Defines user being scenario with fake Calls, SMS and Voicemails events
Voucher Code
Import & Monitor recharge voucher code required for prepaid sim cards
Service Controller
Route Call & SMS to the best Sim Card available in addition to
MNP, dynamic Black/White I/O calls and CDR control
Device Group
Customized virtual device group as origin or destinations for Calls and/or SMS
SIP Devices
Define & Authorize SIP Softswitch, SBC, PBX or Endpoints devices
Routing Tables
Route Pattern definition for mobile traffic: Calls and SMS
SMS Campaigner
License is required for this WEB APP
Powerful application for sending multiple Bulk SMS campaigns from file import or HTTP
iQsim 2015
Page 13/131
1.2.2. IRON Filter Utility
Presentation
IRON Web Interfaces comes with an intuitive, flexible and advanced FILTER utility.
The filters are user defined. Filters can be simple query fields or multiple field selection.
Each Web Application manages its own filters.
Web Application working with filters are:
GSM Ports, SIM Cards, SIM Events, SIM Group, Allocation Rule, Voucher Management, Users Logs, Numbering List (Black,
White, Incoming, Dialer and Last Caller)
Description: How to create a filter

As an example the following snapshots describes how to create a filter for French Mobile Provider SFR
1- Click on NEW filter and from Criteria select Mobile Provider
2- Select FRANCE as country
iQsim 2015
Page 14/131
3- Select the Mobile Provider SFR then SAVE
4- The new filter is automatically set and appears now in Filters list
Results: The SIM Cards listed are from French Mobile Provider SFR
You can Edit again same filter add criteria such as for example STATUS=Registered SIM.
iQsim 2015
Page 15/131
1.2.3. IRON Quick Search Bar
Presentation
IRON Web Interface provides a Quick Sear Bar at right bottom of the Web App windows.
It is dynamically applied to the list present on screen.
Snapshot: SIM Card Quick Search Bar

As an example, we type 8933 from SIM card list, immediately keep listed SIM card only with 8933 chars from data
iQsim 2015
Page 16/131
1.3.
START MENU options
Presentation
The START MENU is present on the task bar at the bottom of the IRON Management Interface. This menu provides
access to all web application present on the system as well to the SYSTEM PARAMETERS.
1.3.1.
System Settings
Description
The SETTINGS section presents several TABS for global parameters. The number of TABS and description depends if
the user is logged as ROOT USER (IRON Suite only) or STANDARD USER (any IRON Product).
1.3.1.1.
General
Field description
Field Name
Field Description
Update Mobile Provider List

Defines the world wide Countries, GSM network LAIN, name and SMS Centers
Last File Imported
Filename used for last update
Date of last import
Date of last update
File to import
Browse to the file to import into the system database
Export
Current Mobile Provider list can be exported for backup or

modification. Export is required If you need to update the list with a
new Mobile Provider or to modify the name of a Mobile Provider for
example
Import
Import the Mobile Provider list you have updated/modified.
Web Server Configuration

Session Timeout
This parameter set the default session time for all user.
System Parameters
Device Monitoring TTL
This parameter set the period time for SIM Manager to scan new
objects. The higher t is the more CPU it use.
Default is LOW
GSM and Sim port

associated timer
This parameter set the period time for scanning GSM port.
This timeout is set in seconds
It directly impact STATUS, RESET and ASSOCIATION port update
speed.
iQsim 2015
Page 17/131
Credit Check process

timeout
This parameter set the maximum delay for processing the credit
check. On timeout, Credit Check is set as failed.
Max delay before users

log clean
Set the number of days to keep user activities logs
Sim Activity Logs History
Set in the number of day to logs Sim Card behavior.

This parameter is important as it provides all the Sim Card history
(position, calls, SMS, credit) for analysis after being blocked from
provider
IRON Suite only

(All Partitions)
1.3.1.2.
Partition
Field description
Field Name
Field Description
Partition Parameters
Default Time Zone
This parameter set the Default Time Zone for the partition or the
IRON SIM Server One system.
Sim Card Parameters

Maximum Successive
sim allocation failure
Set the number of attempt allow registering different sim card

before the GSM port get disabled automatically by the system for
security.
Default sim pin code
Set the default pin code being used for every sim card with empty
pin code
Successive non
connected calls before
SIM deactivation
Set the maximum of successive calls possible without any

connection. Once limit is reached, IRON will deactivate the Sim Card
for security.
PLMN registration
timeout
Set the maximum time in minutes allowed to register a sim.

Sim is removed from site on timeout.
Daily hour time reset
Set the time of the day from 00 to 23 to reset every DAILY settings
Minimum sim recharge

interval
Set the minimum time required between 2 possible recharge on the

same sim card
Maximum successive
credit check retry
Set the number of successive attempt on credit check before

setting the process as failed
Credit check retry

interdelay
Set the minimum delay between consecutive Credit Check with no

success
Sim activity log
Enable or Disable Sim Card Activity History
Sim activity history
Set the number of day to keep history
iQsim 2015
Page 18/131
Field Name
Field Description
Partition Parameters
Default Time Zone
This parameter set the Default Time Zone for the partition or the
IRON SIM Server One system.
Sim Card Parameters

SMPP User
Authentication
requires SMS license
Select the default user allowed to manage unexpected incoming

SMS received as orphan (only) from GSM port. It routes incoming
SMS to SMPP using this user.
Web Top-up services

Tranglo, Paydirek, Tellus
Recharge Server URL
URL of the web top-up service
User Name
User name used for web top-up service authentication
Password
Password used for web top-up service authentication
iQsim 2015
Page 19/131
1.3.1.3.
License
Field description
Field Name
Field Description
IRON SIM Server One License

(IRON SIM Server One only)
Maximum GSM ports
allowed
Shows the maximum of GSM port capacity used for virtual sim
allocation from the system.
WARNING
In case more GSM ports are presents on devices, the system will
allocate only as many sim card as authorized from this value only.
Maximum Sim Boards

allowed
Shows the maximum of sim board capacity for the system.

The total of Sim Board can be split over several Sim Rack unit.
WARNING
More Sim board insertion will not be recognized
SLID Control Activated
Sim Linked to IMEI Device feature is enable if checked
HBS Activated
Human Behavior Simulator Service is allowed to be used
SMS Campaigner
Activated
SMS campaigner is active if checked
SMS Delivery Enabled
Delivery Notification for SMS over SMPP is allowed if checked
Transfer Plan Support
Credit Transfer from Sim Card to Sim Card option is activated if

checked
Maximum Simultaneous
SMS allowed
Shows the number of simultaneous SMS over SMPP handled by the

system.
WARNING
Above this limit the SMS is rejected
License Code
Current license code
Expiration Date
Expiration date of the current license code
Update license
A pop-up window is opened when the button is clicked on to enter

the new license cade. Save button must be clicked then.
iQsim 2015
Page 20/131
Field Name
Field Description
IRON Master License

(IRON Suite only)
Maximum IRON SIM
Managers allowed
Shows the number of SIM Manager able to run in cluster mode for
IRON Suite
Maximum Partitions
allowed
Shows the number of Virtual Partition allowed from IRON Suite
Is Global License
Default type of license
SLID Control Activated
Sim Linked to IMEI Device feature is enable if checked
Maximum Sim Racks

allowed
Shows the maximum of sim racks units handled from the system.
Maximum GSM ports

allowed
Shows the maximum of GSM port capacity used for virtual sim
allocation from the system.
WARNING
In case more GSM ports are presents on devices, the system will
allocate only as many sim card as authorized from this value only.
Maximum Service
Controllers allowed
Shows the maximum of Service Controllers units handled from the

system.
Maximum ISC Cluster

allowed
Maximum number of Service Controllers Clusters supported.
Maximum Profile
Manager allowed
Maximum number of Profile Managers supported.
Maximum Sim boards

allowed
Maximum number of SIM boards supported.
SMS Delivery Enabled
HBS Activated
Human Behavior Simulator Service is allowed to be used
SMS Campaigner
Activated
SMS campaigner is active if checked
Transfer Plan Support
Credit Transfer from Sim Card to Sim Card option is activated if

checked
Max Simultaneous SMS

allowed
Shows the number of simultaneous SMS over SMPP handled by the

system.
WARNING
Above this limit the SMS are rejected
SMS Delivery
Notification
iQsim 2015
Page 21/131
SMS Reply Enable
SMS Reply over SMPP is allowed if checked
XiQS Enable
Enable the use of XiQS API for a 3 party application connection
Flex Enable
Enable the use of iQsim Flex solution for specific GSM Device
connection (GSM module, Raspberry PI, )
License Code
Shows the current license key code
rd
License can be updated thanks to button Update License

Expiration Date
Shows the current expiration date for the license
Update license
A pop-up window is opened when the button is clicked on to enter

the new license cade. Save button must be clicked then.
IRON SIM Manager License

(IRON Suite only)
Add
This button allows to add a new SIM Manager license for IRON
Suite.
Each SIM Manager requires a license in order to be attached to the
IRON Suite.
Additional SIM Manager license is then show with Serial Number
and expiration date.
Update
License may require to be updated
Delete
License can be deleted
iQsim 2015
Page 22/131
1.3.1.1.
Service Control
Field description
Field Name
Field Description
Dialer Blacklist Parameters

Access Mode
Disable or Enable the Anti-Dialer (hunting calls protection) feature
Database Type
If Access Mode=Enable
(Iron Suite only)
Type of the SQL server in use: Ms SQL or MySQL server

A MariaDB server can be defined with MySQL server type
DB Server IP/DNS
(Iron Suite only)
IP address or DNS name of the SQL Server in use
Database name
(Iron Suite only)
Name of the database in use to store the Iron Suite information

and configuration (SIMCLUSTER by default)
Database User name
(Iron Suite only)
User name of the database server used for connection

authentication
Database User
Password
Password of the database server used for connection
(Iron Suite only)
authentication
Test Connection
Button to test the connection with the database can established
Timeout
The timeout stands for the maximum time to wait for Hunting Call
detection.
WARNING
Increasing this value may increase the general PDD of your calls.
iQsim 2015
Page 23/131
CDR Database Parameters

Access Mode
Disable or Enable CDR Management

EXPORT: This button allows to export current CDR
CLEAR: This button allows to clear the current CDR recorded
Database Type
(Iron Suite only)
Type of the SQL server in use: Ms SQL or MySQL server

A MariaDB server can be defined with MySQL server type
DB Server IP/DNS
(Iron Suite only)
IP address or DNS name of the SQL Server in use
Database name
(Iron Suite only)
Name of the database in use to store the CDRs
Database User name
(Iron Suite only)
User name of the database server used for connection

authentication
Database User
Password
Password of the database server used for connection
(Iron Suite only)
authentication
Test Connection
Button to test the connection with the database can established
Export
Export button to export the CDRs into a CSV file
Clear
Clear button to delete all the CDRs from the database
Called Number Control

(Dialer Blacklist parameter must be enabled)
Called Number
presented [NUMBER]
time to the system
within [HOURS] hours
This parameters will blacklist automatically any Called Number

presented [NUMBER] times to the system within [HOUR] hours
Whitelist called number

if call duration is over
[SECONDS]
Called Number presented to the system is whitelisted if connected

time last more than [SECONDS]
On Database query
timeout consider called
number as
In case of failure of Anti-Dialer feature this parameter will

automatically consider the Called Number as:
(Iron Suite only)
WHITE: Call is always connected as WHITE number

GREY: Call is always presented as GREY number
BLACK: Call is always rejected
iQsim 2015
Page 24/131
Incoming GSM Call Control

Incoming GSM Call
Authorization Mode
This parameters defines how to handle incoming GSM calls.

WHITELISTED ONLY: Incoming GSM Calls are accepted on if CLI is
part of the WHITE LIST
NOT BLACKLISTED: Incoming GSM calls are accepted unless it is not
part of the BLACKLIST
Consider hidden
incoming GSM call as
Define the non-CLI incoming GSM calls.

WHITELISTED: non-CLI incoming GSM calls are consider as all
WHITE
BLACKLISTED: non-CLI incoming GSM calls are consider as all BLACK
Last Caller Control

Max Hours
iQsim 2015
Number of hours before the reset of the Last Caller database reset
Page 25/131
1.3.1.2.
System
Field description
Field Name
Field Description
IP Parameters
(IRON SIM Server One & VMware All-In-One only. Requires REBOOT after modification)
Hostname
Define the hostname of IRON SIM Server One
Primary IP address
IRON SIM Server One main fixe IP address.

IP address can be public or private (may require secondary IP
address)
Default IP port is 27051
Net mask
Defines network net mask of IRON SIM Server One
DNS name
Defines DNS hostname
DNS primary
Defines primary DNS
DNS secondary
Defines secondary DNS
Network gateway IP
Defines network gateway of IRON SIM Server One
Sim Activity Log

Start date
Choose the starting date for exporting logs
End date
Choose the ending date for exporting logs
Cancel
Cancel button to interrupt the export process
Export
Export button to export the SIM Activity logs into a CSV file
User Properties
(IRON SIM Server One & VMware All-In-One only. Requires REBOOT after modification)
Update User
Edit current user logged in properties

C.f. USERS MANAGEMENT chapter
iQsim 2015
Page 26/131
1.3.2.
Services Manager (ISSO, VMware All-in-One only)
Description
This menu is used to monitor the current status of the software components running on the iQsim system, or to
stop/start/restart one of them.
Green status means the software component is running.
Red status means the software component is not running.
Click on Stop button to stop a service: the status will turn from Green to Red.
Click on Start button to stop a service: the status will turn from Red to Green.
Click on Restart button to stop a service and to start it immediately after.
Note: some services are options to be activated by the system license, so the current status can be normally red (like
HBS, SMS Campaigner)/
Snapshot
iQsim 2015
Page 27/131
1.3.3.
Backup / Restore (ISSO, VMware All-in-One only)
Description
This menu is used to backup the system database and save the file onto the system administrators workstation.
Click on Backup button to proceed.
Note: all the software components of the iQsim solution are stopped during the backup process. Thus, the traffic
must be stopped or diverted prior to start it.
This menu is used to restore the system with a backup file as well.
Browse to the backup file to us, then click on Restore button to proceed.
Notes:
- All the software components of the iQsim solution are stopped during the backup process. Thus, the traffic must
be stopped or diverted prior to start it.
- The backup file must have been done with the same iQsim system software version to avoid any mismatch of
setup.
- The backup file must have been done from the same iQsim system.
Snapshot
iQsim 2015
Page 28/131
1.3.4.
FTP Service (ISSO, VMware All-in-One only)
Description
This menu is used as a FTP client that helps the system administrator to open a FTP session and to downloads
system files, like software traces, easily.
Enter the iQsim system path to download the files from, then click on Connect button.
Click on the file name to download it.
Snapshot
1.3.5.
Export SMS Stats
Description
Click on this menu to export the SMS statistics into a CSV file.
This file can be saved onto the system administrators workstation.
1.3.6.
Daily Device Report (ISSO, VMware All-in-One only)
Description
This menu gives a daily report of the GSM Devices activity.
Snapshot
iQsim 2015
Page 29/131
1.3.7.
Status Legends
Description
This menu gives the full list of status available into the web interface, and the meaning for each of them.
The status are applicable as GSM Devices status, GSM Ports status and SIM cards status.
Snapshot
iQsim 2015
Page 30/131
1.3.8.
About
Description
This menu gives important information about the iQsim solution in use, like the Serial Number, the main software
version, including the software components versions.
ABOUT is most probably the most important information in order to contact the iQsim Customer Services.
It provides a direct access to email to the iQsim Technical Assistance Center with automated preformatted email.
In addition to that, it is possible to export the system traces into an archive files onto the system admistrators
workstation, that can be attached to the email (ISSO and VMware All-In-One only): click on Server Logs Download button.
Snapshot
Click on support@iqsim.com link for sending preformatted email to iQsim TAC.
iQsim 2015
Page 31/131
1.3.9.
Logout
Description
Click on Logout to get logged out from the web interface.
1.3.10.
Reboot
Description
The REBOOT option is available on ISSO and VMware All-In-One only: it allows rebooting remotely the device.
Clicking on REBOOT will request to confirm the action.
iQsim 2015
Page 32/131
1.4.
1.4.1.
IRON Applications
Users
Usage
Users Manager allows to create multiple account to connect the IRON Management Interface.
Each user can be define with access restriction.
There is no limit to the number of user that can be created.
To access Users Manager click on the
icon.
The application is now listing all user account.
Field Description
Field Name
Field Description
ID
Shows the ID number of the user account.

ID is unique in the system, even after deletion
Partition
(IRON Suite only)
User may be attached to a specific partition of IRON Suite. This filed

provides which partition the user belongs to.
Last Name
Shows user last name
First Name
Shows user first name
Login
Shows the user login account
Email Address
Shows the user email address
Portal Access
Defines if user account has access to interface.

N.B.: For example HBS, SMPP or XIQS access there is no need of
Web Access
Default Time Zone
Shows the current Time Zone being used by user account
User Language
Shows the current Language in use from the user account
iQsim 2015
Page 33/131
Snapshot
1.4.1.1.
Desktop Properties
Usage
Each user is able to control their own desktop properties; it provides an advanced customization such as refresh value,
viewing list, customization of column and many more.
To access user desktop properties, user must be allowed to modify his own account or other accounts.
The desktop properties button appears once the user account is under edition or being created from an another account
iQsim 2015
Page 34/131
Field Description
Field Name
Field Description
Select Background
Image
User can select his own background image
Auto Refresh Timer

Value
User is able to activate and set the time for auto refresh.
It is useful for monitoring Devices or Sim Card statuses for example.
Default page size of

item list
The default list size defines the number of objects listed at once.
Activate backup of
Desktop parameters
The Desktop viewing is saved
Allow autorun
applications on login
Once this parameter is checked, the desktop viewing is being saved

at each logout in order to retrieve it at login.
Snapshot
iQsim 2015
Page 35/131
1.4.1.2.
User rights management
Usage
IRON products allow defining right access for every user; it offers customization for restriction and control access to any
application.
Field Description
Field Name
Field Description
Hidden
If checked then user has no access
Read Only
If checked then user has access without possibility to modify any

parameters
Full
User has access to all data and parameters, can modify or delete any
object from the application
Snapshot
iQsim 2015
Page 36/131
1.4.1.3.
Add user
Usage
Click on the ADD button from Users Manager main list.
1. Set User Parameters
2. Set User Rights (c.f. 1.4.1.2 above)
Field Description
Field Name
Field Description
Portal Access Enabled
Check this box if this user account is allow to access the IRON
Management Interface
Login
Set the unique login for the user account

WARNING
Login has to be unique in the system
Password
Set the user password

WARNING
User password has minimum length of 4 chars
Last Name
Set user last name
First Name
Set user first name
Email Address
Set the user email address
User Language
Select the user language interface
Country Selection
Select the user country
Partition
(IRON Suite only)
If user is not at ROOT level it is then possible to associate the

account to a partition.
WARNING
User account associated to partition can only manage objects
associated to the partition.
Default Time Zone
Select the user Time Zone
GSM Device protected
Privacy option: if Yes is selected, the IP addresses of the GSM

Devices are hidden and marked as x.x.x.x all the menus and files.
GSM Port protected
Privacy option: if Yes is selected, the SLID numbers are hidden and
marked as a series of x into all the menus and files.
SLID Generator function is disabled as well.
iQsim 2015
Page 37/131
GSM Device Localization
Privacy option: if Yes is selected, all the information about the GSM
network (LAC, Cell ID, PLMN, ) hidden and marked as a series of x
into all the menus and files.
BTS Selection function is disabled as well.
SIM Information
protected
Privacy option: if Yes is selected, all the information about the SIM
card are full hidden and marked as a series of x into all the menus
and files.
The ICCID is partially hidden: the last 6 digits are displayed only.
Voucher protected
Privacy option: if Yes is selected, the voucher code is hidden and

marked as a series of x into all the menus and files.
Snapshot
1.4.1.4.
Copy user
Usage
It may be useful to duplicate previous defined user. In this case new duplicated user keeps all parameters from previous
user account but Login, Password, Last Name, First Name and Email Address remain empty.
Duplicated parameters can be as well modified if required.
To duplicate user account, select the user to duplicate then click on Copy button.
iQsim 2015
Page 38/131
1.4.2.
Partition (IRON Suite only)
Usage
IRON Suite allows managing Virtual Partition in order to split or dedicate usage of objects such as Sim Rack, GSM Devices
and Service Controller for example.
If a partition exists then it is possible to create users allowed connecting only to the partition.
The Partition is mainly defined with capacity parameters for GSM ports, Sim Rack and SMS.
WARNING:
The capacity number can never exceed the capacity licensed on product.
If multiple Partitions are created then the total of capacity parameters from all Partition cannot exceed the capacity
licensed on product.
Field Description
Field Name
Field Description
ID
Database ID entry of Sim Manager
Status
Sim Manager Status:

Reports to START > Status Legends
Name
Partition Given Name
Timezone
Defines the preferred Time Zone of the partition
Email
Defines the Email receiving information related to the Partition
SMS Sessions Set
Defines the maximum of simultaneous SMS handled in the Partition
GSM Ports Set
Defines the maximum of GSM port handled in the Partition

Note:
Value cannot be higher than maximum value defined from main
license.
If value appears in ORANGE highlighted then it means number of
GSM Ports registering to the Partition is higher than value defined in
GSM Ports Set.
GSM Ports Detected
Shows the current total of GSM Ports capacity registered to the

partition
Note:
if value appears in ORANGE highlighted then it means number of
GSM Ports Detected in Partition is higher than value defined in GSM
Ports Set.
iQsim 2015
Page 39/131
Sim Rack Set
Defines the maximum number of Sim Rack managed in the Partition
Sim Rack Detected
Shows the current total of Sim Rack units trying to register to the
partition
Note:
if value of Sim Rack attempting to register is higher than Sim Rack
Set value or higher than maximum allowed from Main License then
all Sim Rack unit appears off line.
Expiration Date
Define the date to stop using the Partition

WARNING:
Once date is reached, the partition is deactivated and no more
action can be processed.
Comments
Set your own comment
Snapshot
iQsim 2015
Page 40/131
1.4.3.
SIM Manager (IRON Suite only)
Usage
Field Description
Field Name
Field Description
Status
Shows the current connection status of the Sim Rack

Working means the Sim Rack is linked to a SIM Manager
Unavailable means there is no connection with Sim Rack
Name
Shows the given Sim Rack name
Hostname/IP
Shows either the IP or the Hostname used by the Sim Rack to be

reachable from other devices
Status

Unavailable means there is no connection yet
Sim Board
Shows the number of maximum Sim Board
Sim
Shows the current maximum capacity for Sim Cards

Examples:
32 = 1x Sim Board inserted
iQsim 2015
Page 41/131
Snapshot
iQsim 2015
Page 42/131
1.4.4.
Sim Rack
Usage
1. To launch the Sim Rack Manager, click on icon
2. Use vertical scrolling bar to review the list of Sim Rack
IRON family products can be deployed in a complex network architecture wherein certain elements of the architecture
are in private LAN behind a NAT firewall. Therefore, it is possible to configure two virtual IP addresses for a given Sim
Rack.
Example
A Sim Rack can be located in the same private LAN as the IRON SIM Server One thus to access the Sim Rack,
the IRON SIM Server one will use the private IP address from the Sim Rack while for those GSM devices
deployed in different locations, they will have to use the NAT public IP address from the Sim Rack. In such
deployment scenario, the primary IP address from the Sim Rack will be set to the real private IP address while
the secondary IP address from the Sim Rack will be set as the public IP address from location on the NAT
router
The Sim Rack application allows to list the Sim Rack currently defined in the IRON SIM Server One.
Field description
Field Name
Field Description
Status

Unavailable means there is no connection with Sim Rack
Name
Shows the given Sim Rack name
Hostname/IP
Shows either the IP or the Hostname used by the Sim Rack to be

reachable from other devices
Status

Unavailable means there is no connection yet
Sim Board
Shows the number of maximum Sim Board
Sim
Shows the current maximum capacity for Sim Cards

Examples:
Snapshot: Sim Rack List
iQsim 2015
Page 43/131
iQsim 2015
Page 44/131
1.4.4.1.
Add new Sim Rack
Usage
1. Launch the Sim Rack application by clicking icon
2. Click Add button to access Sim Rack Add form
3. Set parameters then click Save to record new Sim Rack or click Cancel to quit
Field description
Field Name
Field Description
Sim Rack Name
The given name for the new Sim Rack
Primary Hostname/IP
This IP address is used directly from the IRON SIM Server One to
connect to the Sim Rack.
It should be a private IP if IRON SIM Server One and Sim Rack are
on same LAN
It should be a public IP if there is internet connection between IRON
SIM Server One and Sim Rack
TCP Port Connection
The default Sim Rack port connection is 51503.
(Primary)
This port can be modified in case more than one Sim Rack shares
the same public IP.
Secondary Hostname/IP
This IP is optional and can be necessary if connection to Sim Rack is

required from private IP and public IP at the same time.
Example: Sim Rack is located on distant site with few GSM devices.
In this case IRON SIM Server One requires to connect on Primary
public IP, while remote GSM device from same site as the Sim Rack
requires to connect to Sim Rack on Secondary private IP
TCP Port Connection
(secondary)
the same public IP.
Snapshot: Add Sim Rack form
iQsim 2015
Page 45/131
iQsim 2015
Page 46/131
1.4.4.2.
Modify Sim Rack settings
Usage
1. Launch the Sim Rack application by clicking icon
2. Double click on Sim Rack or click once then click Edit button to access Sim Rack settings
3. Review or modify then click Save to record modification or Cancel to quit
Field description
Field Name
Field Description
Sim Rack Name
The given name for the new Sim Rack
Primary Hostname/IP
This IP address is used directly from the IRON SIM Server One to
connect to the Sim Rack.
It should be a private IP if IRON SIM Server One and Sim Rack are
on same LAN
It should be a public IP if there is internet connection between IRON
SIM Server One and Sim Rack
TCP Port Connection
(Primary)
the same public IP.
Secondary Hostname/IP
This IP is optional and can be necessary if connection to Sim Rack is

required from private IP and public IP at the same time.
Example: Sim Rack is located on distant site with few GSM devices.
In this case IRON SIM Server One requires to connect on Primary
public IP, while remote GSM device from same site as the Sim Rack
requires to connect to Sim Rack on Secondary private IP
TCP Port Connection
(secondary)
the same public IP.
SBXX tab
Select the Sim Board to
Sim Holder
Provides position of the sim card in the Sim Board
Status
C.f. Sim Card Status table
ICCID / IMSI / Provider
Gives origin information for the sim card
GSM Device (port)
Shows the GSM device currently using the sim card as well the port
number
iQsim 2015
Page 47/131
Snapshot: Edit Sim Rack form
1.4.4.3.
Remove Sim Rack
Usage
1. Launch the Sim Rack application, click on icon
2. Click once on Sim Rack then click Delete button to remove Sim Rack device
3. Confirm Sim Rack deletion from popup windows
Snapshot: Delete Sim Rack confirmation popup
iQsim 2015
Page 48/131
1.4.5.
GSM Device
Usage
The GSM Device application manages GSM Devices that are under the control of IRON SIM Server One.
Note
The GSM Device in RELAY mode is automatically inserted by the system
The GSM Device running in ACTIVE is automatically inserted by the system
1. Launch the GSM Device application, click on icon
from desktop or START MENU
2. Use the vertical scrolling bar to review the list of GSM Devices.
Field description
Field Name
Field Description
ID
Shows the Database ID record
Partition
Partition name handling the GSM Device
IRON Suite only
GSM Device Name
GSM Device Hostname

If GSM Device is a master gateway then a hyperlink is present for
direct access to GSM Device configuration portal.
Managed By
Name of the Service Controller or Call Manager or Master gateway

in case the GSM device is a relay (slave) device.
N.B.: HTTP hyperlink is present to redirect to local Web Portal for
old products such as Call Manager and Gateway Master.
Internal Revision
Current Gateway version of the GSM Device.

WARNING: It is Gateway component version and not Device version.
Register Name
Serial Number reported from the GSM Device
Hostname/IP
Hostname or IP address of the GSM device
Sim Remote Status
C.f. GSM Device Status table
SIM Manager
Current SIM Manager name managing the GSM Device
IRON Suite only
Ports Available
Current number of GSM ports ready with registered SIM card
Port Group
Display the Port Group or the list of Port Groups that the GSM Ports
of the given GSM Device are part of
Device Group
Display the Device Group or the list of Device Groups that the GSM
Ports of the given GSM Device are part of
iQsim 2015
Page 49/131
Device Capacity
Number of physical GSM ports present on GSM device.
Mode
Defines the activated Mode on GSM device.

Active = GSM Device connects to IRON
Passive = IRON connects to GSM Device
Used minutes
Sum of the all minutes connected from every sim card assigned on
the GSM device since the last Reset Counter.
ACD (s)
Average Call Duration in second since last Reset Counter
ASR
Answer Seize Ratio in % since last Reset Counter
SMS Router
In case the GSM Device is a CALL MANAGER, the SMS Router

indicates if CALL MANAGER route SMS sent from SMS Manager.
N.B.: This information is now present in Service Controller section.
Snapshot: GSM Device list
1.4.5.1.
GSM Device auto registration
Usage
IRON products family allows an automatic registration mode from GSM Device, in this case there is no need to define the
GSM Device as it will automatically pre-register itself with proper information and wait for validation from an
administrator account.
It is useful for any GSM Device using a dynamic public IP address.
Read the following process in order to activate this mode on GSM Device:
1. Telnet to GSM Device: telnet <IP>
2. From telnet prompt, run: config /simserver then select 1
iQsim 2015
Page 50/131
X:\>config /simserver
Application has been registered to the QCFGSvc
QCFGSvc Version 5.00.000.033
Choose SIM card management method [1]:
0 No SIM Server connection
1 Enable connection to external SIM Server
>
3. Select 1, then SIM Manager active mode as 1
Connect to SIM Manager with active mode[1]:
0 No
1 Yes
>1
4. Enter IP address and TCP Port to contact SIM Manager:
Enter SIM Manager IP address [192.168.199.15]:
SIM Manager IP Address: 192.168.199.15
Enter the SIM Manager TCP Port number value (default:27051) [27051]:
SIM Manager TCP Port: 27051
Be careful, all line connections will be disconnected while rebooting!
Do you want to reboot Gateway to take into account the modifications? [Y/N]:
5. Accept the reboot and then wait for process to complete.
Once the GSM Device has rebooted, IRON SIM Server One lists automatically the GSM Device which is attempting the
connection. GSM Device appears as waiting for validation status. It must be validated (authorized) in order to be able to
get sim cards.
2. Double click on GSM Device with waiting for validation status, or click once on GSM device then click edit button
to get access to GSM Device settings
3. Set Country, Set Authorize Connection eventually adjust Sim Rack Mapping and then click save
GSM Device will get automatically registered, ready to receive sim cards.
Note
If the GSM Device running ACTIVE MODE was previously recorded in GSM Device then GSM Device is
authorized de facto.
Snapshots: GSM Device list, GSM Device settings, GSM Device registered
iQsim 2015
Page 51/131
iQsim 2015
Page 52/131
1.4.5.2.
Add new GSM Device
Usage
1. Launch the GSM Device application by clicking icon
2. Click Add button to access GSM Device Add form
3. Set parameters then click Save to record new GSM Device or click Cancel to quit
Field description
Field Name
Description
Name
Enter the given name for the device
Hostname / IP
Enter the IP address or the fully qualified DNS name of the given
GSM device.
Connection name
Enter the login name to connect to system device.

Default login name is administrator for iQsim gateway
Connection password
Enter the password for the connection.
Country
Select the country where the given GSM device is located from the
pull-down list.
This information is extremely important as the system will apply the
country information as the main criterion for the SIM allocation.
Sim Localization
iQsim 2015
Optional parameters depending on country selection
Page 53/131
Field Name
Description
Some countries require localizing the GSM device in the territory in
order to be able to sue Local Plan.
For example:
GSM Device is installed in Brazil and it is required to use only SIM
card from Sao Paolo with On Net call
Snapshot
1.4.5.3.
Modify GSM Device settings
Usage
2. Double click on the GSM Device, or click once on the GSM Device then click edit button to get access to GSM
Device settings
3. Modify the settings and then click save
Field description
Field Name
Description
Name
Internal Name of the GSM device.
Hostname / IP
Set the IP address or the fully qualified DNS name of the given GSM
device.
Connection name
Enter the login name for the connection.

Default login name is administrator for QuesCom gateway
Connection password
Set the password for the connection.
Country
Select the country to locate GSM Device

This information is extremely important as the system will apply the
iQsim 2015
Page 54/131
Field Name
Description
country information as the main criterion for the SIM allocation.
Sim Area Code
Depending on country selection, you may enter the local Sim Area
Code to locate with accuracy the GSM Device.
WARNING:
To be used with Local Sim Plan and avoid National Sim Plan usage
Sim Remote Status

(read only)
GSM Device Hostname

(read only)
Serial number
(read only)
GSM Device Capacity

(read only)
Device status icon

(information)
Sim Rack Mapping

(Tab)
SIM Manager Mapping

(Tab)
Information about the current GSM Device status
Read-only information about the hostname of the given GSM device.

Read-only information about the serial number of the given GSM
device.
Read-only information about the number of GSM ports ready with
registered SIM card / total of physical GSM ports on GSM device.
Indicate current GSM Device status,
GSM port are listed with current status.
C.f. GSM Device on GSM Port status tables.
Allows defining what connection GSM device should use to connect
to Sim Racks. Default is Primary Access;.
Please refer to Sim Rack section.
Allows defining what connection GSM device should use to connect
with SIM Managers. Default is Primary Access;.
Please refer to SIM Manager section.
WARNING:
This is old way to manage for GSM device MASTER and CALL
MANAGER only.
Snapshot: GSM Device edit form
iQsim 2015
Page 55/131
1.4.5.4.
Remove GSM Device
Usage
2. Click once on the GSM Device then click delete button to get remove GSM Device
3. Confirm deletion by clicking Yes
Snapshot: GSM Device deletion confirmation
iQsim 2015
Page 56/131
1.4.6.
Port Group
Usage
Port Group is a main feature from the system as IRON SIM Server One requires GSM Port Group for sim allocation.
The management of Port Group allows IRON SIM Server One to get rid of managing gateways as a single or multiple
entities. The GSM Port Group becomes a virtual GSM Device, from one port to thousands ports.
By managing GSM Port Group, IRON SIM Server One get advantage to split physical gateway ports in several independent
GSM Port Group or to regroup gateway by location or to dedicated a given amount of ports to provider and list of
provider and so many other customized options to fit and easy configure sim allocation.
Field description
Field Name
Field Description
Name
Shows the given name for Port Group
Simultaneous
Commutation
Shows the maximum of GSM ports allowed to swap the sim card at
the same time
Used Minutes
Indicates the number of minutes completed from the Port Group

since last GSM port RESET COUNTER
ACD
Indicates the current ACD for the GSM Port Group.

NB: Value is given as an indicator since last RESET COUNTER
ASR
Indicates the current ASR for Port Group since last GSM port RESET
COUNTER
1.4.6.1.
Add new Port Group
Usage
1. Launch the Port Group application by clicking icon
2. Click Add button to access Port Group Add form
3. Set parameters then click Save to record new Port Group or click Cancel to quit
Field description
Field Name
Field Description
Name
Enter the given name for Port Group
Simultaneous
Enter the maximum of GSM ports allowed to swap the sim card at
the same time. This % is for entire Port Group as for every single
iQsim 2015
Page 57/131
Commutation
GSM device.
GSM Devices
Available
Shows the list of GSM devices available for Port Group usage
GSM Devices
Selected
Shows the list of GSM devices already in use for the Port Group
GSM port in use
For every single GSM device selected it is possible to select the GSM
port attached to the Port Group.
ASR (%)
Alert level stands for the minimum % before GSM ports status goes
to ALERT
Sleeping level stands for the minimum % before GSM ports status
goes to SLEEPING state
ACD (s)
Alert level stands for the minimum of seconds before GSM ports
status goes to ALERT
Sleeping level stands for the minimum seconds before GSM ports
status goes to SLEEPING state
Monitoring Window
(calls)
Set the monitoring window size (in number of calls) for ASR and ACD
calculation.
Sleeping Time (mn)
Set the GSM Port Sleeping time when ASR and/or ACD reach
Sleeping level
Maximum Successive
Sleeping
Set the maximum of consecutive SLEEPING state for GSM port

before being deactivated from the IRON system
Snapshot
iQsim 2015
Page 58/131
1.4.6.2.
Modify Port Group
Usage
1. Launch the Port Group application by clicking icon
2. Double click on Port Group or click once then click Edit button to access Port Group settings
3. Review or modify then click Save to record modification or Cancel to quit
1.4.6.3.
Remove Port Group
Usage
1. Launch the Port Group application, click on icon
2. Click once on Port Group then click Delete button to remove Sim Rack device
Caution
To be able to delete a Port Group you must take care that none of the GSM ports present in the Port
Group has a sim already allocated to a gateway or already registered to the Mobile network.
3. Confirm Port Group deletion from popup windows
iQsim 2015
Page 59/131
iQsim 2015
Page 60/131
1.4.7.
GSM Port
Usage
The GSM Port application provides the real time status summary of all GSM ports recorded in the system.
By selecting one, some or all GSM ports you can:
SELECT BTS to force registration to a specific Cell ID
ENABLE or DEACTIVATE GSM ports, in order to use or not a GSM Port
RESET COUNTERS for Remaining minutes, ASR and ACD (no rollback possible)
Filters management to retrieve faster given GSM Port list
Field description
Field Name
Field Description
ID
Shows the unique ID of GSM port recorded in Database
Partition
Shows the partition owner of the GSM port
(IRON Suite only)
Status
Real time status for given port
Internal Revision
Software Port Version for M100 and S100 only
Serial Number
GSM Board Serial Number for M100 and S100 only
GSM Port
Shows the device with port in use
Port Group
Shows the Port Group owner of this GSM Port
IMEI
Shows current IMEI if Sim is allocated or previous IMEI if there is no

sim allocated
Device S/N
Shows the Device Serial Number for the GSM Port
Used Minutes
Shows the total of minutes completed from GSM Port since last
Resect Counter
ACD (s)
Current ACD in second since last Reset Counter
ASR (%)
Current ASR in % since last Reset Counter
Last Reset Counter
Date and Time of last Reset Counter
SIM Status
Current SIM status if GSM port has a SIM
SIM Provider
Current SIM Provider taken from the IMSI
IMSI
Current IMSI of sim card if allocated
iQsim 2015
Page 61/131
ICCID
Current ICCID of sim card if allocated
Rule used
Current Allocation Rule in use if sim card allocated
End of Validity
Estimated time for deallocation of sim card if sim is allocated
Remaining Time
Estimated remaining time on sim allocated to GSM Port
Total of calls left
Estimated remaining calls on sim allocated to GSM Port
Manual Allocation
(IMSI/ICCID)
Shows IMSI and ICCID of the sim card in case it was a manual
allocation requested by user
PLMN Provider
Current Provider Name registering the SIM

NB: May be different from SIM provider in case of roaming
PLMN
NNC MNC code defining current PLMN in use
LAC
Current Local Area Code in use
Cell ID
Current Cell ID in use
BCCH
Current Channel in use
RSSI
Current Signal strength

Reminder:
Signal is from -48 dB to -113 dB
-48 dB = 100% signal strength
-80 dB = 50%, minimum signal strength recommended from iQSim
-113 dB= 0% signal strength, loosing registration
Reg. State
Provides the Registration Status of the SIM

- SEARCHING
- HOME as SIM registered on its own PLMN
- ROMAING as SIM registered on a foreign PLMN
- DENIED as SIM not authorized to register on selected PLMN
Radio Type
Current Radio Access Type:

- GSM as 2G
- UMTS as 3G
- LTE as 4G
Model ID
Current GSM/UMT/LTE Vendor Model Modult Type

Ex: UMTS SL8082t Sierra Wireless
Note
PLMN Provider, PLMN, LAC, Cell ID, BCCH and RSSI can be set with several background color
depending on the BTS Selection:
NO FILL
GSM port is set in auto BTS selection
BLUE
GSM port is forced and registered to a BTS
iQsim 2015
Page 62/131
RED
GSM port is forced but cant register to the selected BTS
Snapshot: GSM Port List
1.4.7.1.
BTS Selection
Usage
The GSM Port application provides the possibility to select (force) a BTS for selected ports.
To force a GSM port to register to a given BTS, you have to select one or more GSM ports from the GSM port list
then to click on BTS selection option.
A new window appears distributing up to 6 additional Cells.
Caution
If multiple GSM ports are selected then only the common cells are present on screen.
A consequence may be of reducing the number of cell available or even not showing at all any cells if
the selected GSM ports are from different sites
Warning!
The BTS Selection feature is available only with some Module ID.
You can select GSM port for BTS selection only if Module ID is compliant
Snapshot
iQsim 2015
Page 63/131
iQsim 2015
Page 64/131
1.4.8.
HBS (Human Behavior Simulator)
Usage
1. Launch the HBS application, click on icon
2. Use vertical scrolling bar to review the list of HBS options
The HBS aka Human Behavior Simulator, intends to provide additional traffic to the termination traffic with
incoming/outgoing calls, incoming/outgoing SMS, calls to the SIM cards Voicemail service number, and to establish web
connections (with 3G gateways only): the goal of using the HBS feature is to give the SIM card a human being-like profile
of use.
In order to configure a HBS scenario the system will requires a minimum of information such as for example SMS text
messages to randomly select for sending, phone number to call or to get call and voicemail service numbers.
The HBS application is built around 4 mains TAB option:
Numbers List
Messages List
Web sites List
Scenarios
There is 2 other TAB option to be able to monitor HBS processing events:
Dashboard as statistics for the past events
Pending Events as list of events to be played
The main component SCENARIOS requires prior to be used to set at least one Number List and one Message List (if SMS is
being used). Voicemail remains optional.
The HBS Scenario is used from the system into the associated SIM Plan \ SIM Protection section:
Other documents available about same topic:
Understanding the HBS feature.pdf
HBS Data Event feature description.pdf
Snapshot
iQsim 2015
Page 65/131
1.4.8.1.
Number List
Usage
Number List allows you to review the several list of Number List application that HBS will be able to use within the
scenario you will define.
The Number List you create is very important in order to provide the type of phone call as well as the ratio of phone type
numbers to dial.
Example:
Should you need to perform 20% Friend calls and 80% cross net calls, then you need to add once FRIEND PHONE
NUMBERS and 4 times PHONE NUMBERS CROSS NET.
Snapshot
1.4.8.1.1.
Add new Number List
Usage
Click the ADD button in order to get access to the Number List record form.
You can define as many lists as you need, just create each list by clicking ADD button.
Field description
Field Name
Field Description
Number List Name
Shows the given name for the Number List defined
Use Phone Numbers

From Same Sim Plan
Shows if internal Sim Plan calls is selected
Use Phone Numbers

From Other Provider
Shows if Cross Net calls (any other provider from same country) is
selected
iQsim 2015
Page 66/131
Use Friend Phone

Numbers From Same
Sim Plan
Shows if internal Sim Plan Friend option is activated
Manual Number List
Shows how many manual numbers are present in the list
Snapshot
1.4.8.2.
Modify Number List
Usage
Select the Number List with the checkbox first column left side; click the EDIT button in order to get access to the Number
List.
Modify the configuration and click Save.
1.4.8.3.
Delete Number List
Usage
Select the Number List to delete with the checkbox first column left side; click the DELETE button and confirm the
deletion from the popup window.
1.4.8.4.
Import numbers into Manual Number List
Usage
In order to save time or to use the same Manual phone list for many Number List, the system allows you to import
Manual numbers directly in the Number List you are defining.
To import Manual phone numbers, click the button Import Numbers, select the file with Manual numbers to import by
clicking the BROWSE button. Click IMPORT button to proceed and click SAVE.
iQsim 2015
Page 67/131
IMPORTANT:
File format for the phone numbers to import must be one phone number per line.
The phone number defined in the file will be used as it appears in the file, take care of international prefix or customize
prefix if it is required from the configuration you have done in the system.
1.4.8.5.
Messages List
Usage
Messages List allows you to record several text messages that HBS will be able to use with the scenario you will configure.
The Messages List you create is very important in order to have random SMS content. Without any message, SMS are
being sent empty.
Snapshot
1.4.8.5.1.
iQsim 2015
Add new Message List
Page 68/131
1.4.8.5.2.
1.4.8.6.
import Message List
Scenario
Usage
The TAB option Scenarios allows you to create a specific behavior for the simulation of events.
To fully define a scenario you need to define at least:
1x Number List
1x Message List
1.4.8.6.1.
iQsim 2015
Add new Scenario
Page 69/131
1.4.8.7.
Dashboard
Usage
The HBS Dashboard provides event history for every single sim card. It is easy to review what events occurred and
which events succeed.
Field description
Field Name
Field Description
Provider
Provider name from the sim card
ICCID
ICCID of sim card
IMSI
IMSI of sim card
HBS Calls Outgoing
Total of calls placed from the sim card
HBS Calls Received
Total of calls received from the sim card
HBS Calls Errors
Total of calls not connected
HBS Internal Calls

Outgoing
Total of calls placed from the sim card to another sim card in same
Sim plan
HBS Internal Calls

Received
Total of calls received from the sim card from another sim card in
same Sim plan
HBS Internal Calls

Errors
Total of calls from same Sim Plan not connected
SMS Sent
Total SMS sent from sim card
SMS Received
Total SMS received from sim card
SMS Errors
Total SMS sent in error
Voicebox
Total of voicebox script played from sim card
Outgoing
Voicebox
Total of calls to voicebox in error
Errors
Data connections
Total of Data connections established
Outgoing
Data connections
Total of Data connections in error
Errors
Reset Date
iQsim 2015
Last Dashboard Reset Date for sim card
Page 70/131
Snapshot
1.4.8.8.
Pending Events
Usage
From Pending Events application the system shows the next HBS events planned for every sim. It is useful in order to
review the configuration of the scenarios which can be then adjusted.
Field description
Field Name
Field Description
Create Date
Date of creation from IRON
Scenario
Scenario name requesting the HBS event
Remaining Time
Real Time ([RT]) or Call/SMS Termination time ([CT]) remaining

before the HBS Event to be played
Status
Current status of the SIM card
Provider
Provider name of the SIM card
ICCID
ICCID of SIM card in use
IMSI
IMSI of SIM card in use
Device
Current GSM Device the SIM card is registered to
Type
Type HBS Event: CALL, SMS, VOICEMAIL or DATA
Destination
Destination type (CALL or SMS) as ON NET, OFF NET, FRIENDS or

CUSTOMIZED
iQsim 2015
Page 71/131
Snapshot
iQsim 2015
Page 72/131
1.4.9.
Voucher Code
Usage
IRON Sim Server One offers many features to automatically manage the recharges of any Prepaid Sim card type.
In order to be able to recharge a sim card, the system requires calling a Sim Voucher.
The Sim Voucher can be a multiple digits code from well-known top up card to scratched or to buy from phone shop
and web, it can also be your own Sim Voucher to define and use in case of Sim Credit Transfer recharge.
Snapshot
1.4.9.1.
Add new voucher
Usage
IRON allows adding manually any voucher type.
A set of button helps to ADD, EDIT, DELETE and REUSE vouchers or IMPORT and/or EXPORT list of vouchers
Field Name
Field Description
Sim plan
Select the Sim Plan authorized to use the voucher
Voucher
Recharge code to send to mobile provider
Call Peak
Value of voucher for Call Peak, in minutes
Call Off Peak
Value of voucher for Call Off Peak, in minutes
Call Bonus
Value of voucher for Call Bonus, in minutes
SMS Peak
Number of SMS Peak from Voucher
SMS Off Peak
Number of SMS Off Peak from Voucher
SMS Bonus
Number of SMS Bonus from Voucher
Credit Transfer
Credit time to transfer
iQsim 2015
Page 73/131
iQsim 2015
Page 74/131
1.4.10.
Sim Cards
Usage
The Sim Card manager allows controlling every single sim card inserted at least once in the system.
IRON keeps data forever; you can remove and reinsert the sim card at any time
.
Field Name
Field Description
ID
Unique ID of the SIM card from the database
Partition
Partition managing the SIM card
Status
Current status of the SIM card.

Status are listed in STATUS LEGEND from START menu
Date
First record of SIM card (inserted in system)
Sim Rack Position
Physical position of the SIM card.

SIM_RACK_NAME (SIMBOARD SLOT)
GSM Device
Current allocation of the SIM card. Empty means not allocated.

GSM_DEVICE_NAME (PORT)
SIM Plan
Current SIM plan managing SIM card behavior.

WARNING: Empty means SIM card has no rules
Mobile Provider
SIM card mobile provider (detected from the ICCID)
IMSI
SIM Card IMSI
ICCID
SIM Card ICCID
Subscriber Number
SIM card phone number. Empty means no
SLID
Sim Linked to IMEI Device number
SMS Centre
Current SMS centre for Mobile Provider
APN
Access Point Name
APN Login
Access Point Name login
APN Password
Access Point Name password
Contract Birthday
Current Monthly day contract for PostPaid SIM card only
Remaining Minutes
Peak
Remaining main credit time for call left on SIM Card.

WARNING: If it is set to 0 then SIM cant be allocated for Calls
Remaining Minutes
Remaining secondary credit time for call left on SIM Card.
iQsim 2015
Page 75/131
Off Peak
Remaining Minutes
Bonus
Remaining bonus credit time for call left on SIM Card.
Inclusive Minutes
Peak
Postpaid SIM card monthly main credit time
Inclusive Minutes
Off Peak
Postpaid SIM card monthly secondary credit time
Inclusive Minutes
Bonus
Postpaid SIM card monthly bonus credit time
Remaining SMS
Peak
Remaining main credit for SMS left on SIM Card.

WARNING: If it is set to 0 then SIM cant be allocated for SMS
Remaining SMS
Off Peak
Remaining secondary credit for SMS left on SIM Card.
Remaining SMS
Bonus
Remaining bonus credit for SMS left on SIM Card.
Inclusive SMS
Peak
Postpaid SIM card monthly main credit SMS
Inclusive SMS
Off Peak
Postpaid SIM card monthly secondary credit SMS
Inclusive SMS
Bonus
Postpaid SIM card monthly bonus credit SMS
Daily Minutes
Current Daily credit time usage
Daily Calls
Current Daily call processed. Connected or not connected
Daily SMS
Current Daily SMS sent
Incoming Call
Total of Incoming call received

Can be reset with RESET COUNTERS option
SMS Sent
Total of SMS Sent

Incoming SMS
Total of Incoming SMS

Connected Calls
Total of connected calls

Non Connected Calls
Total of non-connected calls

Successive
Low Duration
Counter of successive connected calls with low duration

NOTE: You must set a value in CAS/FAS parameters from SIM plan
iQsim 2015
Page 76/131

Successive
Non connected
Counter of successive non-connected calls

Successive
SMS error
Counter of SMS sending error

NOTE: You must set Successive SMS Sending Error from SIM plan
Successive
Unspecified Error
Counter of unspecified non-connected calls

ASR
Current ASR in %
ACD
Current ACD in seconds

Used Minutes
Current amount of calling time in minutes

Credit
Last Modification
Last date and time of SIM card credit update
Last Allocation Site
GSM device name of last SIM card allocation
End of Sleeping Date
Scheduled date and time End of Sleeping
Credit Check
Current status of Credit Check transaction
To Be Recharged
Provide information if SIM card has to be recharged
To be Activated
Provide information if SIM card has to be activated
PIN code
Current SIM card PIN code.

NOTE: Default is PIN code from System parameters (START menu)
Comments
You can set any comment here. It is useful to follow up a small

group of SIM cards for example.
Snapshot
iQsim 2015
Page 77/131
1.4.10.1.
Edit Sim Card
Usage
Each single SIM card can be edited by double clicking on the SIM card.
The Edit from contains all field described above and can be modified one by one.
The Edit form has as well additional options such as :
Deactivate SIM card
If checkbox is checked then SIM card is deactivated immediately after saving (button SAVE)
If SIM card was allocated it immediately removed
If checkbox is unchecked while at edit it was checked (SIM deactivated) then SIM card becomes immediately
available for allocation after saving (button SAVE)
Generate SLID
You can click on the button Generate SLID number in order to generate a new SLID number
NOTE: The Generate SLID number appears only if SIM card is attached to a SIM plan with option SLID control
enabled. Otherwise you can enter manually your own SLID number.
Reset Counter
Check the Reset Counters checkbox to reset all counters listed above
Snapshot
iQsim 2015
Page 78/131
1.4.10.2.
Update multiple Sim Card
Usage
It is possible to select multiple SIM cards in order to set at once same values for all SIM cards selected.
1234-
Check all SIM card to modify

Click on UPDATE button
Modify the required parameters
Click SAVE button
UPDATE provides as well access to specific features such as scheduling Recharge, Credit Check and Activation for
example.
Snapshot
iQsim 2015
Page 79/131
1.4.11.
Sim Events
Usage
Sim Event Manager provides information on Credit Check, Recharge and Activation transactions managed from
IRON over the sim cards.
iQsim 2015
Page 80/131
1.4.12.
Sim Group
Usage
Sim Group Manager allows defining static group of selected sim card. The intuitive drag and drop feature helps
adding or removing sim card from the Sim Group. In addition the customized Filters feature helps to quickly reduce
the number of sim card form main list.
Snapshot
Click Sim card and drag/drop to right side
Click save, the Sim Group is ready
iQsim 2015
Page 81/131
1.4.13.
Sim Plan
Usage
The Sim Plan Table provides the administrator the capability to create price plans. Sim plan are assigned to SIM cards of
the same provider, managed by the IRON SIM Server One.
Sim plans are highly recommended. Advantages of creating Sim plans are:
You can benefit from the automatic SIM card management by using sim plans.
For example: 9000 inclusive minutes have been assigned to a given SIM card. This SIM card will be automatically excluded
from the GSM device routing as soon as this time amount is used up.
Sim plans can be associated with automatic synchronization, activation, refilling and dedicated SIM protection.
You can create as many SIM plan for each Mobile Provider as you want.
Note
SIM PLAN allows DUPLICATION.
To duplicate a SIM PLAN, first select the SIM PLAN to duplicate from the SIM PLAN list then click DUPLICATE
button.
It is MANDATORY to change the SIM PLAN name before saving new duplicated SIM PLAN.
It makes easy to manage several same type of SIM PLAN with different SIM PRTOECTION settings for
example.
Field Name
Field Description
ID
Unique ID of SIM plan in database
Partition
Partition name managing the SIM plan
Name
SIM plan name
Country
Country associated to SIM plan
Mobile Provider
Unique Mobile Provider associated to SIM plan
Type
SIM plan type: Postpaid, Prepaid, Transfer and Off Net
Default plan
Value is NULL (empty) or Default plan If the SIM plan is defined as

the default SIM plan to use for any new SIM card from Mobile
Provider.
Snapshot
iQsim 2015
Page 82/131
1.4.13.1.
Add Sim Plan
Usage
To add a SIM plan you must first select a partition (IRON Suite only).
There is 4 type of SIM plan:
Standard plan
select this type of SIM plan if you intend to use postpaid or prepaid SIM card for making Call or SMS
Transfer plan
select this type of SIM plan if you want to dedicate SIM card for transferring their credit to Standard plan SIM
cards
Off Net plan
select this type of SIM plan if you need to create an Off Net plan to use with Standard plan SIM cards
Standard plan: Description of TABS
iQsim 2015
Page 83/131
1- #SIM Plan
Field Name
Field Description
Parameters
SIM Plan Type
Standard Plan for common SIM card usage

Transfer Plan for SIM cards dedicated for transferring credit
Off Net Plan for Sim Plan Off Net Management in Standard Plan
SIM plan Name
Customize the name of your SIM plan
SIM Country
Country to which belongs the Mobile Provider for the SIM
Mobile Provider
SIM plan Mobile provider target.

IMPORTANT: Only SIM detect from the Mobile Provider will be able
to use the SIM plan
SIM Type
Select Prepaid Type if you use recharge, voucher or topup code
Call Connection Free of

Time
Define the minimum calling time required to validate the credit

usage. If calls last less then call is considered as free of charge.
Call Processing Credit

Time
Required credit to communicate with Mobile provider.
Call Connection Credit
Minimum credit time charged at call connection
iQsim 2015
In this case all calls are starting to be charged with this value even in
case of non-connected calls.
Page 84/131
Time
Call Step Credit Time
Credit Time Step to decrease during connected call
Postpaid Calendar Day
Day of the month to re-credit contract credit time
Postpaid Rollover
Minutes
If applicable, you can report unused credit time to the next month.
The roll over (aka unused credit) can be cumulative up to 99 months
Supervision
Call Remaining Credit
Alert
If the Remaining Call Credit Time if equal or below in % to this value

then SIM will get ORANGE status as a warning of low credit.
Important:
The Call Remaining Credit Alert calculation is based on the Initial
Credit If no Initial Credit was set then ALERT doesnt occur
SMS Remaining
If the Remaining SMS Credit Time if equal or below in % to this value

then SIM will get ORANGE status as a warning of low credit.
Important:
The SMS Remaining Credit Alert calculation is based on the Initial
Credit. If no Initial Credit was set then ALERT doesnt occur
Default SIM Plan
Checking this box will activate the SIM Plan as the default SIM Plan
to associate for ANY new SIM card from same Mobile Provider
inserted in the system.
SIM Plan Off Net Management

Off Net Plan Selection
You can add as a many Off Net Plan allowed to be used from the
SIM plan thus from the SIM cards of the SIM Plan.
Important:
You must FIRST define OFF NET SIM PLAN from same country to get
them in the list of selection
2- #Initial Credit (Standard Plan Only)
Field Name
iQsim 2015
Field Description
Page 85/131
Call Credit Peak

Call Credit Off Peak
Defines in minutes the starting credit for SIM card at first usage.
Credit may change after first Recharge or first Credit Check
Call Credit Bonus

SMS Credit Peak
SMS Credit Off Peak
Defines in number of SMS the starting credit for SIM card at first
usage.
Credit may change after first Recharge or first Credit Check
SMS Credit Bonus

Allow Over Plan
If checked then SIM is allowed to continue even if it has reached 0.

WARNING:
Using this option make sense only with POSTPAID SIM card as
prepaid SIM card are not allowed to connect any CALL nor to send
ANY SMS once credit has reached 0.
Allow Off Net
iQsim 2015
If checked then the Credit Type is allowed to be used for OFF NET
Calls and SMS as well.
Page 86/131
3- #Credit Check
Field Name
Field Description
Credit Check Trigger
Configure when the Credit Check has to occur:

MANUAL: Credit checked performed only by users
ON SIM RELEASE: Each time SIM is released from GSM port
ON THRESHOLD ALERT:
AT SIM REGISTRATION: Each time SIM has registered
iQsim 2015
Page 87/131
ONCE A DAY: At SIM registration, only first time

Credit Check Mode
Select the
Credit Synchronization
It can be configured as MANUAL or AUTOMATIC.

If it is set to MANUAL then the credit is NEVER synchronized by the
system but from users.
Restart GSM Port Before

Credit Check
In some condition, the mobile provider may require to reinitialize

the GSM port before performing a Credit Check
Credit Check on SIM

deactivation
IRON can perform a Credit Check each time a SIM is going to be

deactivated automatically by IRON (SIM BLOCKED or NO MORE
CREDIT)
Credit Check Mode set as SMS

SMS Service Number
Enter the Provider Mobile SMS Service Number in order to send an

SMS for a Credit Check received by SMS.
SMS Message For Credit

Check
Enter the exact text of SMS to send to service number for getting
Credit Check event
Number of SMS
Expected
From 0 to 9 SMS can be received in return.

Important:
IRON Solution is expecting the exact number of SMS except if
TIMEOUT ON is defined.
Timeout On
You can define a maximum time for receiving the number of SMS.
It is mandatory when Mobile Provider does not always send same
amount of SMS in reply of Credit Check request.
Credit Check Mode set as USSD

USSD Command
Message
To connect via USSD option the Mobile Provider gives service

number. Once connected several menu can be offered to the user.
In this field you will set the USSD service number followed by the
different choice if menus are offered.
Example: *123#,2,1
The system will connect to service number *123#, once connected it
st
nd
will play 2 as selection of 1 menu, then 1 as selection of 2 menu
level
Credit Check Mode set as USSD with SMS

USSD Command
Message
C.F. above same Field Name
Number of SMS
Expected
Set the maximum number of SMS possible to receive if required.

WARNING:
If you may receive variable number of SMS always set the maximum
and you must configure Timeout On parameter (c.f. below)
iQsim 2015
Page 88/131
Timeout On
C.F. above same Filed Name
Credit Check Mode set as IVR with SMS

IVR Script
Some provider requires the Sim card to call an Interactive Voice

Server in order to get back from SMS the amount of remaining
Credit. In some case you may have to select choice from vocal
menu.
Special chars are defined for tempo such as . as 1 second and ; as 5
seconds
Example: 888;;1..3
The system will call 888 service number then wait 10s for
announcement, send DTMF 1, wait 2 seconds and send DTMF 3.
Number of SMS
Expected
Timeout On
Credit Check Mode set as Per Call SMS flash, USSD Flash or SMS
Selecting one of these modes will automatically collect the Remaining Credit sent back from the
Mobile Provider at the end of each call.
Configuration
Valid Message Returned
This parser section is extracting all credit information from the

message received (USSD or SMS).
It is a multi-line parser which will match from messages the
different value of credits.
All values are recorded in VAR #1,#2,..,#9
Special chars are defined as:
* = any chars
$ = VAR delimiter, may delimit multiple VAR at once
Example of message to parse:
Your credit is R30,00 with a bonus of 10 SMS today the 2009/05/02
Credit parsing:
You*R$<#1=*><#2=,*>$* R$<#3=*>$*
VAR Result:
#1=30
#2=0
#3=10
OUT OF CREDIT message
This is a multi-line parser entry to record all type of message

resulting of no more credit left on the SIM card. If one of the entries
matches then IRON solution will set the SIM card as NO MORE
CREDIT status.
NOT CASE SENSITIVE
The parsing is processed as SUBSTRING
iQsim 2015
Page 89/131
Sim Card is getting deactivated if SUBSTRING matches

WARNING:
Wildcard * and $ are not working for parsing and are viewed as
expected char in the answer.
Special char is defined as:
^ = requires to exactly match what follows the special char and It is
case sensitive
Example of multiple messages to parse:
you have no more
^You have no more credit
Works if answer is: You have no more credit
SERVICE FAILURE
message
This is a multi-line entry to record all type of message resulting of

Credit Check Service is temporary unavailable. If one of the entries
matches then IRON will reattempt later for another Credit Check.
NOT CASE SENSITIVE
IMPORTANT:
The number of reattempt and the time required from attempt to
attempt is configured in System Settings from START menu.
WARNING:
case sensitive
Service temporary
^Service temporary unavailable, please try again
SIM BLOCKED Message
This is a multi-line entry to record all type of message resulting of

SIM card being blocked from Mobile Provider. If one of the entries
matches then IRON will deactivate immediately the SIM card.
NOT CASE SENSITIVE
WARNING:
case sensitive
please contact
^Please Contact Your Customer Service
iQsim 2015
Page 90/131
Calculation
Credit Check
Consistency Enabled
Selecting this option will require the IRON Solution to verify the
current GAP between Credit parsed from Network and Credit
calculated from IRON solution.
It is useful to verify the configuration of credit calculation for
example
Credit Check Gap Alert
Check the box to monitor Credit GAP
The Credit GAP is calculated in percentage, you set the maximum

difference accepted in %
Example: 10%
If Credit calculation is 70mn then tolerance is +/- 7mn
Over or above will deactivate the SIM card
Mn
The Credit GAP is calculated in maximum tolerance time, you set the
maximum difference accepted in minutes.
Example: 10mn
If Credit calculation is 70mn then tolerance is +/- 10mn
Over or above will deactivate the SIM card
Call Credit Peak

Call Credit Off Peak
Call Credit Bonus
SMS Credit Peak
SMS Credit Off Peak
Each field defines the credit in calculation. From the parsing Valid
Message Return section, it is possible to calculate the new credit.
Example of calculation
Each ON NET call cost R2,00/mn
Valid Message Return is:
Your credit is R30,00 with a bonus of 10 SMS today the 2009/05/02
SMS Credit Bonus
Credit parsing is:

You*R$<#1=*><#2=,*>$* R$<#3=*>$*
WARNING !!!
VAR Result are:

#1=30
#2=0
#3=10
Calculation is remaining
seconds and not
minutes for CALL
In this example we will have:

Call Credit Peak = (#1/2)*60
R(30/2)*60s= number of remaining minutes
SMS Credit Peak = #3
Test Parameters
Get Last Credit Check
Click this button to load the last Credit Check message received on
IRON system from the mobile provider. It is useful for checking the
configuration.
Credit Check
Confirmation Message
Enter your own messages to test
Test Configuration
TEST CONFIGURATION button, provides immediately the results for

all VAR defined from CONFIGURATION section and real time credit
from CALCULATION section.
iQsim 2015
Page 91/131
It is highly recommended to ALWAYS test the configuration

4- #Recharge
Field Name
Field Description
Remaining Minute For

Recharge
It defines the minimum credit allows on SIM card before processing

the Recharge.
WARNING
Having a value lower than MINIMUM REMAINING MINUTE FRO
LAST CALL in section SIM PROTECTION will avoid ANY Recharge
process
Remaining SMS
It defines the minimum SMS credit allow on SIM card before

processing the Recharge
Recharge Mode
IRON offers 4 modes to process a Recharge on a SIM card

IVR: Calls a server number and is able to process DTMF for voucher
and/or expect a push USSD and/or a SMS
SMS: Send a voucher to a Service Number and may expect results by
SMS
USSD: Connect to a Service Number and process digits to navigate in
menu and load Recharge voucher
TRANSFER: In this mode the SIM card is being recharge from
another SIM card by transferring credit
Recharge
Defines which type of credit to recharge.

It may be minutes (CALL) or SMS or both
Trigger
Defines the Recharge process as:

MANUAL: Administrator perform itself the recharge
AUTO: IRON performs itself the Recharge based on Remaining
minutes/SMS
ALLOCATION RULE: IRON requires a specific allocation rule in order
iQsim 2015
Page 92/131
to recharge the SIM card. You must define an allocation rule to

enable this option. Please read ALLOCATION RULE chapter.
IVR Mode
Recharge Server
Number
Defines the Server Number to call for IVR processing.
Recharge IVR Script
Enter the DTMF to execute after connection to IVR Service.

DTMF accepted: [0-9],*,#
%n to send via DTMF the Sim Card Phone Number
%t to send via DTMF the Voucher Number
. to set 1s pause
; to set 5s pause
Acknowledge
IVR Server Number
In some case it is required to call another IVR Server Number after

Recharge in order to ACK the Recharge.
IVR Script for

Confirmation
Use this field if it is required (previous field in use), same DTMF and
special VAR are accepted.
SMS Mode
Recharge Server
Number
Destination Number for sending SMS Recharge
Recharge SMS Message

Format
SMS Message to send

%n is replaced with the Sim Card Phone Number
%t is replaced with the Voucher Number
Acknowledge
SMS Server Number
In some case it is required to send a SMS for confirmation to same

Server Number or another destination number.
SMS Confirmation
Message
Should the mobile provider returns a SMS of confirmation, you have

to fill in this filed with the content of such SMS
SMS Returned
In order for IRON to be accurate and fast on SMS Recharge process

it is possible to set what is expected on sending the SMS message
for Recharge. 3 options are available:
None: The Recharge is valid as soon as SMS is sent
Notification: The Recharge is valid as soon as DLR is received
SMS Reply: The recharge expect a SMS to be returned
USSD Mode
USSD Command
Message
To Recharge via USSD option the Mobile Provider gives service

number. Once connected several menu can be offered to the user.
Example: *123#,2,1,%t
iQsim 2015
Page 93/131

st
nd
level
Recharged Confirmation
Message Format
IRON is able to parse USSD messages, thus enter here the several
message presented from USSD connection. It is a multi-entry field, it
means message is confirmed as soon as one parsing matches.
Additional USSD For

Confirmation
It may be required to reconnect to USSD in order to confirm the

Recharge. It is same rules as for USSD Command Message
TRANSFER Mode
Transfer Plan
Select the SIM Transfer Plan to use in order to recharge current SIM
cards.
Supervision
Reactivate Sim Card
After Recharge
Check this option if you want IRON to use the SIM card after
recharge succeeds.
Run Credit Check After

Recharge
Check this option if you want to immediate performs a Credit Check

process. It is recommended in case of IVR as it is often not reliable
100% on many mobile providers.
5- #Activation and Promotion
Field Name
Field Description
Activation Trigger
Defines the Activation process as:

MANUAL: Administrator perform itself the activation
AUTO: IRON performs itself the activation based
ALLOCATION RULE: IRON requires a specific allocation rule in order
to activate the SIM card. You must define an allocation rule to
enable this option. Please read ALLOCATION RULE chapter.
Activation Mode
IRON offers 4 modes to process an Activation on a SIM card

IVR: Calls a server number and is able to process DTMF
iQsim 2015
Page 94/131
SMS: Send a SMS for activation to a Service Number

USSD: Connect to a Service Number and process digits to navigate in
menu and Activate the SIM card
USSD with SMS: Process activation via USSD and get SMS message
as a confirmation
IVR Mode
Activation Server
Number
Defines the Server Number to call for IVR processing.
Activation IVR Script
Enter the DTMF to execute after connection to IVR Service.

DTMF accepted: [0-9],*,#
%n to send via DTMF the Sim Card Phone Number
%t to send via DTMF the Voucher Number
. to set 1s pause
; to set 5s pause
SMS Mode
Activation Server
Number
Destination Number for sending SMS for Activation
Activation SMS Message

Format
SMS Message to send

%i is replaced with the IMSI Sim Card Number
It can be associated to CNT parsing rules
SMS Returned
In order for IRON to be accurate and fast on SMS Recharge process

it is possible to set what is expected on sending the SMS message
for Recharge. 3 options are available:
None: The Recharge is valid as soon as SMS is sent
Notification: The Recharge is valid as soon as DLR is received
SMS Reply: The recharge expect a SMS to be returned
USSD Mode
USSD Command
Message
To Activate SIM card via USSD option the Mobile Provider gives
service number. Once connected several menu can be offered to
the user.
Example: *123#,2,1,%t
st
nd
level
iQsim 2015
Page 95/131

Activation Confirmation
Message Format
IRON is able to parse USSD messages, thus enter here the several
message presented from USSD connection. It is a multi-entry field, it
means message is confirmed as soon as one parsing matches.
USSD with SMS Mode

USSD Command
Message
Same as USSD Mode
Activation Confirmation
Message Format
Same as USSD Mode
Validation by SMS Reply
Check this option if you are required to send back a SMS for
confirmation by using the Service Number received from SMS Reply
SMS Message for Reply
Set the SMS message to send back to Mobile Provider to validate

activation.
Common Parameters
Run Credit Check After
Recharge
Check this option if you want to immediate performs a Credit Check

process. It is recommended in case of IVR as it is often not reliable
100% on many mobile providers.
Scheduler Script
It is possible in automatic mode to set a scheduler in order to run in

regular period of time the Activation process for grabbing
Promotion.
The Scheduler is working as
iQsim 2015
Page 96/131
6- #SIM Protection
iQsim 2015
Page 97/131
1.4.14.
Allocation Rule
Usage
In the iQsim SIM management architecture, the IRON SIM Server One assigns SIM cards to specific port groups according
to the criteria defined in the associated allocation rule
Note
ALLOCATION RULES allows DUPLICATION.
To duplicate ALLOCATION RULES, first select the ALLOCATION RULES to duplicate from the ALLOCATION
RULES list then click DUPLICATE button.
It is MANDATORY to change the ALLOCATION RULES name before saving new duplicated ALLOCATION
RULES.
It makes easy to manage several same type of ALLOCATION RULES with different PRIORITY LEVELS settings
for example.
Mechanism
If a GSM port is empty, periodically the IRON SIM Server One will try to allocate a SIM. The IRON SIM Server One will
determine which allocation rule to apply based on two conditions:
The port group to which the given GSM port belongs.
The required time schedule, i.e. day of the week and time of the day.
Several allocation rules applicable for different time frames could be created for a given port group.
For example, two sets of allocation rules can be defined for a given port group: one for peak hours, another for off-peak
hours.
For a given port group, allocation rules with lower priority will only be applicable if those with higher priority have no SIM
cards available for allocation.
iQsim 2015
Page 98/131
iQsim 2015
Page 99/131
1.4.15.
Service Controller
Usage
The Service Controller is a dedicated switching system of IRON. It controls Call and SMS admission and distribution
with Sim Card control at the same time.
The Service Controller avoid configuration from GSM device side, providing very fast deployment of all GSM device
on site, avoiding reconfiguration of GSM device at each site relocation and high control of all GSM port.
The Service Controller manage access to Mobile Number Portability database/service
The Service Controller records all CDR in system database
The Service Controller provides Blacklist and Whitelist as well as a powerful Dialer Control option to avoid hunting
calls from Anti-Fraud simbox detection system.
Field Description
Field Name
Field Description
ID
Defines ID in Database of Service Controller object
Partition
Partition Name owner of the Service Controller
Name
Name defined for the Service Controller
Hostname
Public IP
Hostname or IP address to reach the Service Controller
Status
Current Status of the Service Controller:

Reports to START > Status Legends
GSM ports
Current number of GSM Ports being managed from the Service

Controller
SMS Allowed
Maximum of simultaneous SMS to handle on Service Controller.
ASR
Current total ASR in % of the Service Controller

Note:
Reset has to be performed from GSM Ports configuration
iQsim 2015
Page 100/131
ACD
Current total ACD in seconds of the Service Controller

Note:
Reset has to be performed from GSM Ports configuration
1.4.15.1.
How to update Service Controller License
The Service Controller is managed from a unique dedicated license.

To update the Service controller license, you have to edit the Service Controller then click on UPDATE LICENSE button
from License Service Controller section.
1.4.15.2.
Edit Service Controller
Field Name
Field Description
Service Controller Parameters

Device Name
Given name of the Service Controller
IP
IRON Suite Only
Current IP of remote Service Controller
Hostname
IRON Suite Only
Current hostname of remote Service Controller

READ ONLY
Serial Number
IRON Suite Only
Unique Serial Number of remote Service Controller

READ ONLY
Login
IRON Suite Only
Administrator login name of remote Service Controller
Password
IRON Suite Only
Current password of administrator login name on remote Service

Controller
Default Country
Defines the default country for new GSM device

Note: GSM device can be modified at anytime
SMS Manager Enabled

IRON Suite Only
Check this box to allow the Service Controller to route SMS

Note: It is mandatory for sending SMS
License Service Controller

Expiration Date
Service Controller stops running on this date.

NO LIMIT means unlimited time
VoIP Enabled
If checked then Service Controller is allowed to route SIP calls
Dialer Control Enabled
If checked then Service Controller is allow to use the Dialer Control

feature (anti-hunting numbers) from Routing Tables
GSM Devices Supported
Maximum number of GSM devices that can be managed from the
iQsim 2015
Page 101/131
Service Controller.
TAB#1 SETTINGS
General configuration of the Service Controller
Database Access Parameters
Last Caller Enabled
Select to the option you require to enable.
Blacklist Out Enabled
Note:
Blacklist In Enabled
The IRON SIM Server One enables per default the CDR
CDR Enabled
Database Mapping Access / IRON Suite Only
IP/ Hostname
Enter the Database IP address required to manage Last Caller,

Blacklist In/Out and CDR
IP Port
Provide the IP port for Database Server access
Mobile Number Portability Service Parameters

IP / Hostname
If you use an external MNP Service Provider, it is require to enter

the Hostname or IP address
IP Port
Service Provider may require a specific IP port
Database Country
Default Country for consultancy of MNP (it is not restrictive)
Check Phone Number
You can test the connection by evaluating a phone number in this

Field.
Returned value is set in Query Phone Number field
TAB#2 GSM Devices

Provides Full list of GSM devices currently associated to the Service Controller
C.f. chapter 1.4.5
GSM Device p.49
TAB#3 GSM Ports

Provides the full list of GSM ports currently managed from the Service Controller
C.f. chapter 1.4.7
GSM Port p.61
TAB#1 Sim Rack Mapping

Defines which IP address and IP Port should be used by default for the GSM devices managed from the
Service Controller. Reports to chapter 1.4.5
configuration.
GSM Device p.49 for specific GSM device
TAB#1 Sim Manager Mapping

Defines which IP address and IP Port should be used by default by the Service Controller to connect to
SIM Manager.
iQsim 2015
Page 102/131
Snapshot from IRON Suite
Snapshot from IRON SIM Server One
iQsim 2015
Page 103/131
1.4.16.
Device Group
Usage
Creating Device Group offer possibilities to define group of GSM device as destination for easy configuration of the
system as well as group of VoIP Trunk to easy control call admission in the IRON system.
Snapshot
iQsim 2015
Page 104/131
1.4.17.
SIP Devices
Usage
SIP Device allows to define VoIP Trunk or End Point as origin or destination of switching calls.
It also provide VoIP Profile management to customized each VoIP trunk and/or End Point.
Snapshot
iQsim 2015
Page 105/131
iQsim 2015
Page 106/131
1.4.18.
Routing Tables
1.4.18.1.
Managing Route
Usage
The Routing Manager controls the calls and sms through being switched via IRON. Managing Route allows to allow
connection for VoIP and GSM calls or SMS sending.
Field Description
Field Name
Field Description
Status
Show the current status of the route

GREEN: Route is active
GREY: Route is deactivated
Origin Device
Shows the origin authorized for the route
Called Pattern
Shows the pattern authorized for the route
Switch Type
Shows the type of switching associated to origin route
Route Type
Shows the type of service being used to reach destination
Destination
Shows the route destination
Comments
Field available for text entry
Snapshot
1.4.18.1.1.
Creating new route
Field Description
Field Name
iQsim 2015
Field Description
Page 107/131
Enable Route
Check this box to activate the Route (GREEN status)
Switch from origin

Origin
Define the origin authorized to use the route

Device for GSM device or SIP device
VoIP Trunk for SIP Softswitch or PBX
Device Group for group of Device or VoIP Trunk
HBS for the Human Behavior Simulator
MSG Server for the SMPP SMS Server
Device
VoIP Trunk
Device Group
Select the proper origin entity authorized to use the route
Called Pattern
Set the pattern and number format for the route.

This filed authorized wild char and special char.
* Stands for any digits and any length

? Stands for one digits only [0-9],*,#
X Stands for digit * present in the called number
Switch with service

Switch Type
Select the type of switch to use for route.

NOTE
GSM service type stands for mobile calls only and is the best option
for such type of calls
Country
(GSM service type only)
Select the country for mobile call destination.
Sim Group
Sim Group defined from the Sim Group Manager can be selected as
the specific sim destination for route.
Only calls previously checked from MNP will be routed to sim from
same country
WARNING
This option works only with GSM Service Type
NOTE: By selecting none, the route is able to use any sim card from
the MAIN or WHITE route destination GSM ports
Dialer Control
(License option)
IRON product has the possibility to check the call before using the
sim. In this case, depending on the Strength Level, the call may be
connected or not with a sim card. It protects against hunting calls.
The level of protection is linked to the answer or non-answer on
query. It is described in Value Meaning.
WARNING
This option can be used with GSM Service Type only and if
Blacklisting OUT management is enabled.
Value for challenging will depend of previous challenged same
number.
iQsim 2015
Page 108/131
Value Meaning
A: Accepted, DC: Check with Dialer Control, R: Rejected
Minimum
Very Low
Low
Normal
High
Very High
Maximum
Cache Level
Valid
A
A
A
A
A
A
A
Wrong
DC
A
A
A
DC
DC
R
Missing
DC
DC
DC
R
DC
R
R
The cache level stands for the number of day, last DIALER
CONTROL is valid for the current Called Number.
For example, if Called Number was blacklisted 15 days ago while
Cache level is set to 10 days, then Called Number is challenged
again from DIALER Control
Custom Control List
Check this box in order to use your own list of blacklisted and
whitelisted numbers.
WARNING
This option takes over the DIALER CONTROL.
SMTP Server
(SMS incoming only)
SMTP IP/Hostname address is required for sending any SMS

received from sim card to an email address.
WARNING
Selecting this option avoid the record of the SMS content in CDR as
well as avoid to send unexpected incoming SMS to SMPP
applications
Switch Type Process

(GSM incoming only)
It is possible to divert incoming GSM calls to a customized IVR,

otherwise destination is VoIP or pre-recorded message.
It is possible as well to select GSM blacklisting in order to filter
incoming GSM calls.
Switch Operation
Called Number
Translation
If route requires to modify the Called Number, the set it to YES.

NOTE: If you have set Service Type as GSM then selection can be
ORIGIN, DESTINATION or ORIGIN & DESTINATION.
ORIGIN: the Called Number performs the CNT for MNP check only,
but remains the same for destination
DESTINATION: the Called Number performs MNP first as is and
performs CNT before going to destination
ORIGIN & DESTINATION: combination of both
Active CDR
Set to YES if route has to record CDR
Switch to destination
Destination Type
iQsim 2015
Same option as origin, ORIGIN may restrict the list of choice
Page 109/131
Main Route
(VoIP or GSM only)
Select the main destination for route.

It can be any device or any group
White Route
(GSM only)
Select the white route for destination
Sim Mode Selection

IRON provides the possibility to preselect sim card based upon Best
Sim best credit) or to simply Cycle over the sim available.
Destination Port
Selection
(VoIP service type only)
On static VoIP route, it is possible to force mobile calls to physical

GSM port destination, by group or device.
MNP Check
IRON provides multiple option for handling MNP checking process.
It can be cycling or overflow on all GSM ports defined in

Destination Type.
Local requires to import MNP data in IRON Database

External requires to define a SQL access
Network requires to subscribe to an external service provider
Use Private IP for RTP
This option allows the GSM device to send its own private IP to
remote peer instead of the public IP from site.
Switch to destination
Port Selection
This option allows to force the specific usage of GSM ports from
the destination type
Snapshot
iQsim 2015
Page 110/131
1.4.18.1.2.
Managing Called Number Translation (LCR)
Usage
The Called Number Translation function allows manipulating the number presented to the system.
It is require to manage customer prefix aka techprefix, CLIP or CLIR (CLI management), Numbering Plan or simply
authentication and MNP.
Field Description
Field Description
Origin
Set the origin allowed to use this Called Number Translation

configuration
Device
VoIP Trunk
Device Group
Select the proper origin entity authorized for CNT
Called Prefix
It is possible to define a specific prefix in addition of origin
Start Period
Set from what day and time CNT is allowed
End Period
Set until what day and time CNT is allowed
Called Number
Translation Operation
Configure the operation by removing, inserting and/or deleting

digits from the Called Number
iQsim 2015
Page 111/131
Field Description
Comments
It is recommend to fill in the comment field to easily retrieve this

CNT operation from the entire list.
Test your Called Number Translation Operation

Called Number
Enter the Called Number to test and click button TEST
Caller Number
Enter the Caller Number to test and click button TEST
Mobile Network code
If MNP is active and up to date, this field shows the current LAIN
belonging to the number
Called Number
Translation result
This field shows you the results of the configuration set above.
Snapshot:
iQsim 2015
IRON system will get same result from the Route.
example for VoIP Trunk origin
Page 112/131
1.4.19.
SMS Campaigner
Usage
The IRON SMS campaigner allows managing multiple campaigns simultaneously. It doesnt require any external software
installation and is built-in the product with 100% web interface management, monitoring and reporting. SMS campaign
can be scheduled for starting and moreover dynamically control on the number of SMS to send simultaneously. It allows
SMS campaigns are control from the main form thanks to a set of intuitive button.
Button Descriptions:
ADD
EDIT
START
PAUSE
RESTART
RESET
adds a new campaign

edit a campaign
start a campaign, may depends on start date value
Pause a campaign
Restart a campaign from the beginning. Reporting is lost, configuration is kept
Reset Reporting, messages and numbers from the campaign.
Snapshot
1.4.19.1.
Define a new SMS campaign
Usage
IRON manages multi SMS campaign thanks to the combination of PRIORITY and SMS WINDOW SIZE.
To define the SMS campaign it is required to know what priority on the SMS bandwidth the Campaign is going to use.
The campaign can be defined to follow up DELIVERY NOTIFICATION and/or REPLY, to manage ALERT on SMS sending
error. Scheduling the SMS campaign is useful for multiple SMS campaign running simultaneously.
Management of message list and/or Mobile number list is done via importation. It can be One message multiple number
or multiple messages with multiple mobile numbers.
Snapshot
iQsim 2015
Page 113/131
1.4.19.2.
Monitoring a SMS Campaign
Usage
The SMS Campaign monitoring allows to follow up status of each SMS sent from the system.
An integrated filter as well as the possibility to export data, provides full control on the running SMS Campaign.
Snapshot
iQsim 2015
Page 114/131
1.4.19.3.
SMS Campaign Report
Usage
The SMS Campaign Report helps to follow campaign running or once completed.
Snapshot
iQsim 2015
Page 115/131
Chapter 2 - Configuration example
2.
Configuration example
Introduction
This section explains how quickly configure several basic features with IRON products:
Assign SIM cards with a Sim Plan on GSM device ports during 20 min
Generate automatic predefined calls with the HBS
Recharging prepaid SIM cards
Checking credit and synchronizing SIM card credit
Manually allocate a SIM to a given GSM port for troubleshooting purpose
2.1.
Example of Configuration for Mobile Termination
Overview
Minimum requirement for assigning sim cards automatically to GSM ports:
Have SIM Card valid and ready to be used
Have GSM DEVICE in status ready
GSM Device is installed on site with necessary signal strength and capacity for the sim card provider
GSM Device is connected and authorized at IRON SIM Server One side
Have PORT GROUP defined for GSM DEVICE
Have SIM PLAN defined for sim cards
Have ALLOCATION RULE defined for PORT GROUP & SIM PLAN
Usage
This section explains steps to assign SIM cards inserted into the IRON Sim Rack to GSM ports of GSM devices. Main steps
are:
1. Create a port group
2. Create a price plan
3. Assign SIM to the price plan
4. Create an allocation rule
Field description
Steps
Action
Click on Port Group, ADD RECORD button
Create a new port group named for instance ALLPORTS, composed of all GSM ports of the
GSM device.
Click SAVE
Steps
iQsim 2015
Action
Page 116/131
Click on SIM Plan, ADD a new SIM PLAN
In the section Parameters,

Select Sim Plan Type as Standard Plan
Enter Prepaid_Orange for the price plan name for instance
Select France for the country and Orange for the provider
Select the Prepaid for the Type of price plan.
In the section Credit, set values for inclusive peak and off peak minutes (1000 minutes for
instance).
Fill other fields according to the reserved usage of SIM cards.
Click SAVE
Steps
Action
Click on Sim Cards and create a filter to display only SIM cards that must be assigned to
the SIM PLAN.
Select SIM to add in the sim plan by clicking their check box and click on the UPDATE.
Select the check box SIM PLAN and select the sim plan prepaid _Orange from the pull
down menu.
Check the option Initialize with Sim Plan values if you need to set default credit values.
Click SAVE
Steps
Action
Click on Allocation Rule, ADD RECORD
Fill fields as described below:

Enter Orange_Peak_Hours_Rule (for instance) for the rule name,
Select the GSM ports ALLPORTS for the Port group
Select sim plan for the SIM choice mode and select the price plan prepaid _Orange from
the pull down menu.
Enter 60 minutes in the Maximum Call Time before SIM de-allocation field.
Keep default values for other fields
Click SAVE
With this allocation rule, all SIM cards with the price plan assigned and present into the
SIM board of the IRON Sim Rack will be allocated to all GSM ports of GSM device for
duration of 60 minutes. After 60 minutes, SIM will be de-allocated from the GSM ports
and other SIM cards with highest credit will be allocated.
iQsim 2015
Page 117/131
2.2.
Generate automatic predefined calls with the HBS
Introduction
This section explains how to generate automatic predefined calls with the IRON HBS server. The IRON
HBS allows the automatic random generation of GSM calls, SMS and calls to the SIM voice box
Create IRON
HBS Lists
Create IRON HBS List configuration interface:

Steps
Action
Click on HBS then from NUMBERS LIST tab, ADD RECORD
Create a list of phone numbers:

Create a list named Phone_numbers_list_1 for instance
Select the type Destination List Number, for example Friends, and ADD MANUAL
NUMBER
Click ADD and enter your Mobile phone number.
Click SAVE.
Create a list of messages from Messages List tab:

Create a list named Messages_list_1 for instance
Click ADD and enter text messages in the text box.
Click SAVE.
Refer to the section 1.4.8.5 Messages List p.68 of this document for more details.
Create
an
IRON
HBS
Scenario
Create an IRON HBS Scenario from configuration interface:

Steps
Action
Click on HBS Server and select tab SCENARIO, ADD RECORD

Enter Scenario name in the field Name
Enter 60 for Simulate Events within each interval

Enter 1 for Number of calls, Number of SMS and Number of voice calls
Enter 10 for Additional random HBS events
Configure the Call generation:
Enter 15s and 30s for the min and the max for the simulated call duration
Select the destination list named Phone_numbers_list_1
iQsim 2015
Configure the SMS generation:

Select the destination list named Phone_numbers_list_1
Page 118/131
Select the message list named Messages_list_1

Configure the generation of calls to the GSM voice box:
5
Enter 30s and 45s for the min and the max for the simulated call duration
Enter the GSM voice box number (ex 888 for the Orange provider)
Enter the following Script: 3# (for instance)
Create
or
modify a sim
plan
Click SAVE
Steps
Action
In the application sim plan, edit the price plan Prepaid_Orange and select SIM
PROTECTION tab
For the field HBS Scenario, select the Scenario created
Click SAVE.
For more details about other fields, refer to the section Sim Plan Chapter of this document.
Allocation
rule
Now the allocation rule Orange_Peak_Hours_Rule created use the sim plan modified previously
Prepaid_Orange.
With this allocation rule, all SIM cards present into the SIM board of the IRON Sim Rack will be
allocated to all GSM ports of GSM device for duration of 60 minutes.
During these 60 minutes, will be generated:
an automatic call to a phone number
a SMS
a call to the provider voice box
WANRING:
Only New SIM CARD allocated after SAVE will be using new parameters from Allocation Rule
iQsim 2015
Page 119/131
2.3.
Recharge prepaid SIM cards
Introduction
This section explains how to configure the IRON in order to automatically to top up prepaid SIM cards.
In this example, prepaid SIM card will be recharged, on the GSM ports they are allocated, by a phone
call.
The process is similar if you want the IRON activating automatically prepaid SIM cards for a first use.
Create
or
modify
a
price plan
In the application SIM PLAN, modify the sim plan created

Steps
Action
In the application SIM PLAN , edit the price plan Prepaid_Orange
In the tab RECHARGE:

Select the Recharge mode IVR
Enter 224 for the recharge server number (for instance)
Enter %n%t. for the recharge IVR script (After 3 second, the phone number will be
dialed and then, after 3 more seconds a voucher code will be dialed the section below
describe how to add a top up code )
Check Reactivate SIM Card after recharge
Click SAVE
For more details about other fields, refer to the section Price Plan Table of this document.
Add a top up
code
Add top up code in the IRON SIM Manager configuration interface:

Steps
Action
Click on IRON SIM Manager > IRON HBS Server > Top Up code, ADD RECORD
Select the price plan Prepaid_Orange
Enter the voucher code

Enter Peak/Off peak values in minutes.
Click SAVE
Refer to the section Error! Reference source not found. Error! Reference source not found. of this
document for more details.
Allocation
rule
The allocation rule Orange_Peak_Hours_Rule created in the section Error! Reference source not
found., use the price plan modified previously Prepaid_Orange.
When the SIM card Remaining minutes value reached the Min Remaining Minutes before auto-
iQsim 2015
Page 120/131
recharge value, the GSM device stops routing calls to SIM card.
The IRON SIM Manager generates a call through the SIM Card, plays the recharge script and updates
internal values for remaining minutes peak or off peak.
2.4.
iQsim 2015
Page 121/131
2.5.
Configure the credit check and synchronization
Introduction
This section explains how to configure the credit synchronization between the IRON SIM Manager and
the GSM service provider.
Remaining minutes peak and remaining minutes off peak IRON SIM Manager values are synchronized
thanks to USSD command sent to the GSM provider. The USSD response of the GSM provider is
analyzed; values are extracted and updated into the IRON SIM Manager database.
The configuration example below is based on the Orange French GSM provider for a prepaid card.
Create
or
modify
a
price plan
In the IRON SIM Manager configuration interface modify the price plan created in the section Error!
Reference source not found.:
Steps
Action
In the section IRON SIM Manager > SIM Management > Price plan, edit the price plan
Prepaid_Orange
In the section USSD:

Check Activated upon SIM release and credit synchronization automatic
Enter the USSD command: #123#
Enter the USSD string format: *soit $<#1=*h><#2=*m><#3=*s>$
Enter the peak expression (seconds): #1 * 3600 + #2 * 60 + #3
Enter the string sample: Credit:82.51EUR soit 2h45m01s en com nat
Click Launch test, the peak and the off peak computed values will be displayed.
Click SAVE
For more details about other fields, refer to the section Price Plan Table of this document.
Create
/
modify an
allocation
rule
The allocation rule Orange_Peak_Hours_Rule created in the section Error! Reference source not
found., use the price plan modified previously Prepaid_Orange.
At the end of the 60 minutes of allocation, the USSD synchronization will start and values of remaining
peak minutes will be update.
iQsim 2015
Page 122/131
2.6.
Manually allocate a SIM to a GSM port for troubleshooting purpose
Introduction
This section explains how to manually allocate a SIM card to a GSM port. This process can be useful to
troubleshoot the IRON SIM Manager when automatic allocations are no longer performed.
Process
Follow the instructions below to manually allocate a SIM to a GSM port:

Steps
Action
Click on GSM ports, configure the filter to display the GSM port you want to perform the
allocation.
2
3
Click on the pen icon in the column Manual Allocation (ICCID/IMSI)

Select the SIM card you want to allocate and click on the arrow.
Click SAVE
Refer to the section Error! Reference source not found. Error! Reference source not found. of this
document for more details.
iQsim 2015
Page 123/131
Chapter 3 - Troubleshooting
3.
Troubleshooting
3.1.1. Event viewers
Introduction
The following list of tools are dedicated to view and manage Event logs:
The iQsim Management Console,
the config program,
All these tools are described in this section.
IMC
The iQsim Management Console provides the capability to display events. The table 5-1explains how
to display IRON SIM Manager events in the iQsim Management Console (QMC).
Step
Procedure
Install the iQsim Management Console on a workstation.

The installation program is either available on the iQsim CD or at http://support.
iqsim.com.
Start the iQsim Management Console
Right click on the icon Management Console and select New IRON SIM Manager.
Enter the IP address and the name of the IRON SIM Manager.
Select the new node created and click on IRON SIM Manager Event. The right panel of
the QMC will display all events.
Table 5-1 Display IRON SIM Manager events in the iQsim Management Console
iQsim 2015
Page 124/131
Config
program
The embedded command config, available through a telnet session, depending on the selected option
allows the display of events.
Display all
logs of the
Event
Viewer
The command below lists all events related to iQsim components from the system log:
C:\> config /log
Command options:
config /log <Service_Name> </e>
<Service_Name>
The filter for events logged by Service_Name.
</e>
Display all
events
logged
by
the
SimServer
component
The filter for error events.
Enter the following command:

C:\> config /log SimServer
Example of results displayed:
EventID: 1
Type: 2
Source: SIMSERVER
Time Generated: 05/16/2005 10:48:26
MESSAGE: Target Database <E:\DATA\SimServer\VoIPCdr.mdb> copied successfully
Display all
error events
Enter the following command:

C:\> config /log SimServer /e
iQsim 2015
Page 125/131
3.1.2. Events types
Information
Event
Information events are displayed in the Event list of the Event Viewer of the MMC with the icon
shown below:
i
To trace information events, use DUMPEL.EXE or enter config /LOG in the command line with the
Event Type of 4. This will inform you about a normal process.
Warning
Event
Warning events are displayed in the Event list of the Event Viewer of the MMC with the icon shown
below:
!
To trace warning events, use DUMPEL.EXE or enter config /LOG in the command line with the Event
Type of 2. This will inform you about a temporary problem encountered by the IRON SIM Manager.
You should monitor your equipment until the problem is fixed.
Error Events
Error events are displayed in the Event list of the Event Viewer of the MMC with the icon shown
below:
To trace error events, apply DUMPEL.EXE or config /LOG in the command line with the Event Type
of 1. This will inform you about a serious problem encountered by the IRON SIM Manager. You should
take care of the problem immediately.
3.2.
SIM Activity Log
Overview
SIM rotation logs record traces of SIM allocation and de-allocation.

Whenever a SIM is allocated to a GSM device, the IRON SIM Manager will generate an entry in the SIM
rotation log. This entry contains detailed information about the SIM allocation such as SIM card and
allocation rule details. Likewise, the IRON SIM Manager will generate an entry in the SIM rotation log
whenever a SIM is de-allocated from a GSM device.
With SIM rotation logs, a good traceability of SIM allocation and de-allocation is obtained. Such logs
are useful resources for statistical analyses and troubleshooting of SIM network controlled by your
iQsim 2015
Page 126/131
IRON SIM Manager.

A daily SIM rotation log file is created to record entries of all SIM allocation/de-allocation in your
network. By default, the IRON SIM Manager traces SIM rotation logs for a 30-day history cycle.
Interpreting
log entries
An entry in the SIM rotation log is a sequence of information fields recorded in a pre-defined order.
Each field is separated by a semi-colon (;).
Examples:
1.00;65000149;START;89331081040066691038;20810;Q30000010001;192.168.198.188;0;2007/02/08 18:00:33;20;SFR On Off;SFR On;0;0;0;0
1.00;65000149;STOP;89331081040066691038;20810;Q300-00010001;192.168.198.188;0;2007/02/08
19:33:38;17;SFR On Off;SFR On;1;4;75;60
The table below provides the description of each information field of the SIM rotation log entry in
their respective order (illustrations based on the examples given above):
Information
Field
Description
Illustration
Version
Version number of SIM rotation log.
1.00
Rotation ID
Unique identifier of a given SIM rotation.
65000149
Same identifier for Start and Stop of a rotation.

Log Type
ICCID
SIM allocation is denoted by Start.
START
SIM deallocation is denoted by Stop.
STOP
Identification number of a SIM.
8933108104006
6691038
SIM Operator
Identification number of the GSM SIM provider.
20810
GSM device
Name
Name of the GSM device.
Q300-00010001
IP Address
IP address of the GSM device.
192.168.198.188
Port number
GSM port number.
Date
Time
Date and time for Start or Stop of a rotation.
2007/02/08
18:00:33
Left minutes
Remaining credit of SIM in minutes.
20
Price Plan
Name of price plan assigned to the SIM.
SFR On Off
iQsim 2015
and
Page 127/131
Information
Field
Description
Illustration
Rule
Name of allocation rule used by the SIM.
SFR On
Stop Cause
Cause identification of SIM deallocation or Stop log

(see the next table for the list of possible stop causes).
SIM allocation or Start log is denoted by 0.

Number
Calls
of
Number of calls that occur to the SIM during SIM

deallocation or Stop log.

ASR
SIM Answer-Seizure Ratio (ASR) during SIM deallocation

or Stop log (in %).
75

ACD
SIM Average Call Duration (ACD) during SIM deallocation

or Stop log (in seconds).
60
iQsim 2015
Page 128/131
Identification
Cause
START of a log, i.e. SIM allocation to a GSM port
End of lease time for an allocation rule
End of lease time for an allocation rule

Call is disconnected
Maximum SIM usage time is reached for an allocation rule
Maximum SIM usage time is reached for an allocation rule

Call is disconnected
iQsim 2015
Maximum number of consecutive non-connected calls is reached
SIM is out of credit
SIM de-allocation forced by user
SIM PIN code is invalid
PUK code is required for the SIM
10
Maximum number of consecutive allocation failures is reached
11
SIM allocation mismatch
12
SIM allocation problem
13
SIM network coverage lost
14
SIM did not get Registered to Network in given time
15
Sim Activation Script Failed
16
Sim Refilling Script Failed
99
Undefined reason
Page 129/131
Causes
stop log
of
The table below describes causes of stop log:
iQsim 2015
Table 5-4
Causes of Stop Log
Page 130/131
3.3.
Related Documentation
Listed below are documents related to the iQsim Iron solutions:

- How to install iQsim ISSO solution.pdf
- Understanding the HBS feature.pdf
- IRON SMS Campaigner.pdf
- How to automatically collect the Subscriber Numbers.pdf
- SIM Activity log format description.pdf
- CDR format description.pdf
iQsim 2015
Page 131/131

IRON-AG-02 00 Ed21

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

IRON-AG-02 00 Ed21

Uploaded by

Copyright:

Available Formats

IRON-AG-02.

IRON MANAGEMENT INTERFACE

2015 Copyright iQsim SA

iQsim is registered trademarks of iQsim SA.

IRON Management Interface ................................................................................................... 10

Login to the IRON interface .............................................................................................................. 11

IRON Web Applications ....................................................................................................................................... 12

START MENU options ...................................................................................................................... 17

System Settings ............................................................................................................................................ 17

Services Manager (ISSO, VMware All-in-One only)...................................................................................... 27

Backup / Restore (ISSO, VMware All-in-One only) ....................................................................................... 28

FTP Service (ISSO, VMware All-in-One only) ................................................................................................. 29

Export SMS Stats .......................................................................................................................................... 29

Daily Device Report (ISSO, VMware All-in-One only) .................................................................................. 29

Status Legends ............................................................................................................................................. 30

IRON Applications ........................................................................................................................... 33

Partition (IRON Suite only) ............................................................................................................................ 39

SIM Manager (IRON Suite only) ................................................................................................................... 41

Sim Rack ....................................................................................................................................................... 43

GSM Device .................................................................................................................................................. 49

Port Group ................................................................................................................................................... 57

GSM Port ...................................................................................................................................................... 61

HBS (Human Behavior Simulator) ................................................................................................................ 65

Voucher Code .............................................................................................................................................. 73

Sim Cards ..................................................................................................................................................... 75

Sim Events .................................................................................................................................................... 80

Sim Group .................................................................................................................................................... 81

Sim Plan ....................................................................................................................................................... 82

Allocation Rule ............................................................................................................................................. 98

Service Controller ...................................................................................................................................... 100

Device Group ............................................................................................................................................. 104

SIP Devices ................................................................................................................................................. 105

Routing Tables ........................................................................................................................................... 107

SMS Campaigner ........................................................................................................................................ 113

Configuration example .......................................................................................................... 116

Troubleshooting .................................................................................................................... 124

Event viewers .................................................................................................................................................... 124

SIM Activity Log..............................................................................................................................126

IRON MANAGEMENT INTERFACE

About This Document

Iron Suite: ISE02.31

Before reading this document

You may want to read as well:

Convention, This document applies the following typographic conventions

IRON MANAGEMENT INTERFACE

IRON MANAGEMENT INTERFACE

Purchase from retailer

Chapter 1 - IRON Management Interface

IRON Management Interface

Chapter 1 - IRON Management Interface

Login to the IRON interface

IRON Suite: The IP is the WEB SERVER unit server

The Management Interface login page will be displayed

Enter your password then click Enter.

Chapter 1 - IRON Management Interface

IRON Interface Overview

1.2.1. IRON Web Applications

Chapter 1 - IRON Management Interface

Chapter 1 - IRON Management Interface

1.2.2. IRON Filter Utility

Description: How to create a filter

2- Select FRANCE as country

Chapter 1 - IRON Management Interface