Escolar Documentos
Profissional Documentos
Cultura Documentos
DOC, Apr-2014
Copyright Notice
iQsim 2013
Page 2/113
Trademarks
iQsim 2013
Page 3/113
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 2013
Page 4/113
Contents
1.
1.2.1.
1.2.2.
1.2.3.
1.3.
1.3.1.
1.3.2.
1.3.3.
About ........................................................................................................................................................... 23
1.3.4.
Logout .......................................................................................................................................................... 24
1.3.5.
Reboot ......................................................................................................................................................... 24
1.4.
1.4.1.
1.4.2.
1.4.3.
1.4.4.
1.4.5.
1.4.6.
1.4.7.
1.4.8.
1.4.9.
1.4.10.
1.4.11.
1.4.12.
1.4.13.
1.4.14.
1.4.15.
1.4.16.
1.4.17.
1.4.18.
1.4.19.
iQsim 2013
Page 5/113
2.
3.
3.2.
3.3.
4.
iQsim 2013
Page 6/113
IRON Suite
SIM Manager
SMS Manager
Service Controller
IRON SIM Server One 416 or 256
Sim Rack 416
Sim Rack 256
GSM device Q400
GSM device M400
GSM device CR200/CR400/FS400
GSM device M100
ISE02.30
ISM02.02 / VM_ISM03.00
SMS02.00 / VM_SMS03.00
ISC02.00 / VM_ISC03.00
SSR03.61 / SS203.61
ISR01.30 and ISR01.50
IST01.00
IAD06.11, IAD07.00
IAD07.00
IAD10.01
ID01.00
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.
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.
iQsim 2013
Page 7/113
Warning!
A warning calls attention to important alerts that will cause personal injury, health hazard or
permanent damage to your equipment if not observed.
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 2013
Page 8/113
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/
iQsim 2013
Page 9/113
1.
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.
1.1.
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
Page 10/113
http://IRON_WEB_SERVER:8000
IRON_WEB_SERVER stands for the hostname or the IP address of the IRON Management
Interface Server.
1.2.
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
Task
User Access Manager
Define user access and rights
iQsim 2013
Page 11/113
Icon
Task
IRON Partitions Manager
IRON Suite only
IRON product family allows to create virtual partition in order to share same Hardware platform
IRON SIM Manager Cluster administration
IRON Suite only
IRON Suite manages multiple SIM Manager for scalability, load balancing and redundancy
GSM Device Manager
Authorize, register, localize and control all GSM device
GSM Ports Manager
Monitoring utility for every GSM ports status
GSM Port Group Manager
Advanced feature for managing virtual GSM devices
Sim Rack Manager
Control Sim Racks connection
Sim Card Manager
Monitor and configure any Sim Card information
Sim Plan Manager
Define Sim Card Credits, Recharge, Activation and Protection
Sim Events Manager
Monitoring utility for Credit Check, Recharge and Activation events
Sim Card Group Manager
Customized group of sim cards
Allocation Rule Manager
Control Sim Card location, usage time & amount as well protection
Human Behavior Simulator Manager (requires license)
Defines user being scenario with fake Calls, SMS and Voicemails events
Recharge Voucher Manager
Import & Monitor recharge voucher code required for prepaid sim cards
Service Control Manager
Route Call & SMS to the best Sim Card available in addition to
MNP, dynamic Black/White I/O calls and CDR control
GSM Devices Group Manager
Customized virtual device group as origin or destinations for Calls and/or SMS
iQsim 2013
Page 12/113
Icon
Task
SIP Devices Manager
Define & Authorize SIP Softswitch, SBC, PBX or Endpoints devices
Routing Manager
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
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)
iQsim 2013
Page 13/113
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.
Presentation
IRON Web Interface provides a Quick Sear Bar at right bottom of the Web App windows.
iQsim 2013
Page 14/113
1.3.
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.
iQsim 2013
Page 15/113
Settings
Configure the global system parameters for IRON product
Services Manager
Web control for services from the IRON SIM Server One only
Daily Device Report
IRON SIM Server One only
Manage the backup of the entire IRON SIM Server One System
Allows to Restore from Backup file
Status Legend
Full list of various status
About
Information on IRON product Serial Number, components and Version
Direct access to IRON logs for download and iQsim support email
Logout from the web interface
1.3.1.
System Settings
iQsim 2013
Page 16/113
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
EXPORT
IMPORT
This parameter set the default session time for all user.
System Parameters
Object 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
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.
This parameter set the maximum delay for processing the credit
check. On timeout, Credit Check is set as failed.
1.3.1.2.
Partition
Field description
iQsim 2013
Page 17/113
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.
Set the default pin code being used for every sim card with empty
pin code
Successive Non
Connected Calls before
Sim Deactivation
PLMN registration
timeout
Set the time of the day from 00 to 23 to reset every DAILY settings
SMPP User
Authentication
1.3.1.3.
License
Field description
Field Name
Field Description
iQsim 2013
Shows the number of SIM Manager able to run in cluster mode for
Page 18/113
Allowed
IRON Suite
Maximum Partitions
Allowed
License Code
Expiration Date
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
Delete
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.
SLID
HBS
SMS Campaigner
Credit Transfer
iQsim 2013
Page 19/113
SMS Delivery
Notification
SMS Reply
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.
Shows the maximum of sim racks units handled from the system.
Maximum Service
Controller
SLID
HBS
SMS Campaigner
Credit Transfer
SMS Delivery
Notification
SMS Reply
1.3.1.1.
Field description
Field Name
Field Description
Timeout
The timeout stands for the maximum time to wait for Hunting Call
iQsim 2013
Page 20/113
detection.
WARNING
Increasing this value may increase the general PDD of your calls.
CDR Parameters
Access Mode
On query timeout
consider called number
as
Consider hidden
incoming GSM call as
1.3.1.2.
System
Field description
Field Name
iQsim 2013
Field Description
Page 21/113
IP Parameters
(IRON SIM Server One only, requires REBOOT after modification)
Hostname
Primary IP address
Secondary IP address
Secondary IP Port
Net Mask
Network gateway
DNS name
DNS Primary
DNS secondary
User Properties
(IRON SIM Server One and IRON Hosted Services only)
Update User
iQsim 2013
Page 22/113
1.3.2.
Status Legend
Description
1.3.3.
About
Description
ABOUT is most probably the most important information in order to contact the iQsim Customer Service.
It provides current versions, but also direct access to email to iQsim Technical Assistance Centre with automated
preformatted email.
IRON SIM Server One as well has a DOWNLOAD button directly saving all logs to your computer.
iQsim 2013
Page 23/113
Clicking on DOWNLOAD button will automatically compressed and save the IRON SIM Server One.
The filename is TRACES.GZ and it is highly recommended to attach this file to the previous email.
1.3.4.
Logout
Description
The logout button quit the current session on interface management.
1.3.5.
Reboot
Description
iQsim 2013
Page 24/113
The REBOOT option is only available for IRON SIM Server One product; it allows rebooting remotely the IRON SIM Server
One.
Clicking on REBOOT will request to confirm the action.
1.4.
IRON Applications
1.4.1.
Users Manager
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
Partition
(IRON Suite only)
iQsim 2013
Page 25/113
Last Name
First Name
Login
Email Address
Web Access
User Language
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 2013
Page 26/113
Field Description
Field Name
Field Description
Select Background
Image
User is able to activate and set the time for auto refresh.
It is useful for monitoring Devices or Sim Card statuses for example.
The default list size defines the number of objects listed at once.
Activate Backup of
Desktop parameters
Snapshot
iQsim 2013
Page 27/113
1.4.1.2.
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
Read Only
Full
User has access to all data and parameters, can modify or delete any
object from the application
iQsim 2013
Page 28/113
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
Web Access
Check this box if this user account is allow to access the IRON
Management Interface
Login
iQsim 2013
Page 29/113
WARNING
Login has to be unique in the system
Password
Last Name
First Name
Email Address
User Language
Partition
(IRON Suite only)
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.
iQsim 2013
Page 30/113
To duplicate user account, select the user to duplicate the click COPY button
Snapshot
1.4.2.
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
Status
Name
Timezone
iQsim 2013
Page 31/113
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
Comments
Snapshot
iQsim 2013
Page 32/113
1.4.3.
Usage
Field Description
Field Name
Field Description
Status
Name
Hostname/IP
iQsim 2013
Page 33/113
Status
Sim Board
Sim
Snapshot
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.
iQsim 2013
Page 34/113
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
Name
Hostname/IP
Status
Sim Board
Sim
1.4.4.1.
iQsim 2013
Page 35/113
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
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
(Primary)
This port can be modified in case more than one Sim Rack shares
the same public IP.
Secondary Hostname/IP
(secondary)
This port can be modified in case more than one Sim Rack shares
the same public IP.
iQsim 2013
Page 36/113
1.4.4.2.
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
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
(Primary)
This port can be modified in case more than one Sim Rack shares
the same public IP.
iQsim 2013
Page 37/113
Secondary Hostname/IP
(secondary)
This port can be modified in case more than one Sim Rack shares
the same public IP.
SBXX tab
Sim Holder
Status
Shows the GSM device currently using the sim card as well the port
number
1.4.4.3.
Usage
1. Launch the Sim Rack application, click on icon
iQsim 2013
Page 38/113
2. Click once on Sim Rack then click Delete button to remove Sim Rack device
3. Confirm Sim Rack deletion from popup windows
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
Partition
iQsim 2013
Page 39/113
Internal Revision
Register Name
Hostname/IP
SIM Manager
Ports Available
Device Capacity
Mode
Used minutes
Sum of the all minutes connected from every sim card assigned on
the GSM device since the last Reset Counter.
ACD (s)
ASR
SMS Router
iQsim 2013
Page 40/113
1.4.5.1.
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
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
iQsim 2013
Page 41/113
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 2013
Page 42/113
1.4.5.2.
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
iQsim 2013
Page 43/113
Field Name
Description
Name
Hostname / IP
Enter the IP address or the fully qualified DNS name of the given
GSM device.
Connection name
Connection password
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
Snapshot
1.4.5.3.
Usage
1. Launch the GSM Device application, click on icon
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
iQsim 2013
Page 44/113
Field description
Field Name
Description
Name
Hostname / IP
Set the IP address or the fully qualified DNS name of the given GSM
device.
Connection name
Connection password
Country
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
Serial number
(read only)
iQsim 2013
Page 45/113
1.4.5.4.
Usage
1. Launch the GSM Device application, click on icon
2. Click once on the GSM Device then click delete button to get remove GSM Device
3. Confirm deletion by clicking Yes
iQsim 2013
Page 46/113
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
Simultaneous
Commutation
Shows the maximum of GSM ports allowed to swap the sim card at
the same time
Used Minutes
ACD
ASR
Indicates the current ASR for Port Group since last GSM port RESET
COUNTER
iQsim 2013
Page 47/113
1.4.6.1.
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
Simultaneous
Commutation
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
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
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.
Set the GSM Port Sleeping time when ASR and/or ACD reach
Sleeping level
Maximum Successive
Sleeping
Snapshot
iQsim 2013
Page 48/113
1.4.6.2.
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.
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 2013
Page 49/113
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:
RESET COUNTERS for Remaining minutes, ASR and ACD (no rollback possible)
Field description
Field Name
Field Description
ID
Partition
Status
Internal Revision
Serial Number
GSM Port
Port Group
IMEI
iQsim 2013
Page 50/113
Device S/N
Used Minutes
Shows the total of minutes completed from GSM Port since last
Resect Counter
ACD (s)
ASR (%)
SIM Status
SIM Provider
IMSI
ICCID
Rule used
End of Validity
Remaining Time
Manual Allocation
(IMSI/ICCID)
Shows IMSI and ICCID of the sim card in case it was a manual
allocation requested by user
PLMN Provider
PLMN
LAC
Cell ID
BCCH
RSSI
Reg. State
iQsim 2013
Page 51/113
Radio Type
Model ID
Note
PLMN Provider, PLMN, LAC, Cell ID, BCCH and RSSI can be set with several background color
depending on the BTS Selection:
NO FILL
BLUE
RED
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.
iQsim 2013
Page 52/113
You can select GSM port for BTS selection only if Module ID is compliant
Snapshot
1.4.8.
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 fake incoming/outgoing calls, cross net, custom calls, friend
sim calls, SMS and Voicemail fake activities in order to protect your Sims from the well-known anti-fraud scanning of
SERVICE RATIO.
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 3 mains TAB option:
Numbers List
Messages List
iQsim 2013
Page 53/113
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 Profile set from Sim Plan section.
Snapshot
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.
Field description
Field Name
Field Description
List Name
Internal
Cross Net
Shows if Cross Net calls (any other provider from same country) is
selected
Friend
Manual
Snapshot
iQsim 2013
Page 54/113
1.4.8.1.1.
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
Sim Card calls always same friend Sim Card (from same Sim Plan)
NOTE: Sim card are set as friends 3 by 3 randomly
Snapshot
iQsim 2013
Page 55/113
1.4.8.2.
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.
Usage
iQsim 2013
Page 56/113
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.
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.
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.
Snapshot
iQsim 2013
Page 57/113
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.
1.4.8.5.2.
iQsim 2013
Page 58/113
1.4.8.6.
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.
1.4.8.7.
Dashboard
Usage
iQsim 2013
Page 59/113
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
ICCID
IMSI
HBS Calls
Outgoing
HBS Calls
Received
HBS Calls
Errors
Total of calls placed from the sim card to another sim card in same
Sim plan
Total of calls received from the sim card from another sim card in
same Sim plan
HBS SMS
Sent
HBS SMS
Received
HBS SMS
Errors
Voicebox
Reset Date
Snapshot
iQsim 2013
Page 60/113
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
Scenario
Time Interval
Status
Provider
ICCID
IMSI
Device
Type
Destination
iQsim 2013
Page 61/113
Snapshot
1.4.9.
Sim Voucher
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.
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
iQsim 2013
Page 62/113
1.4.10.
Field Name
Field Description
Sim plan
Voucher
Call Peak
Call Bonus
SMS Peak
SMS Bonus
Credit Transfer
Sim Card
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
.
iQsim 2013
Page 63/113
Field Name
Field Description
ID
Partition
Status
Date
GSM Device
SIM Plan
Mobile Provider
IMSI
ICCID
Subscriber Number
SLID
SMS Centre
Contract Birthday
Remaining Minutes
Peak
Remaining Minutes
Off Peak
Remaining Minutes
Bonus
Inclusive Minutes
Peak
Inclusive Minutes
Off Peak
Inclusive Minutes
Bonus
Remaining SMS
Peak
iQsim 2013
Page 64/113
Remaining SMS
Off Peak
Remaining SMS
Bonus
Inclusive SMS
Peak
Inclusive SMS
Off Peak
Inclusive SMS
Bonus
Daily Minutes
Daily Calls
Daily SMS
Incoming Call
SMS Sent
Incoming SMS
Connected Calls
Successive
Low Duration
Successive
Non connected
Successive
SMS error
Successive
Unspecified Error
ASR
Current ASR in %
Can be reset with RESET COUNTERS option
iQsim 2013
Page 65/113
ACD
Used Minutes
Credit
Last Modification
Credit Check
To Be Recharged
To be Activated
PIN code
Comments
Snapshot
1.4.10.1.
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)
iQsim 2013
Page 66/113
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
1.4.10.2.
Usage
It is possible to select multiple SIM cards in order to set at once same values for all SIM cards selected.
1234-
UPDATE provides as well access to specific features such as scheduling Recharge, Credit Check and Activation for
example.
iQsim 2013
Page 67/113
Snapshot
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.
1.4.12.
Sim Group
iQsim 2013
Page 68/113
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
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.
iQsim 2013
Page 69/113
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.
Field Name
Field Description
ID
Partition
Name
Country
Mobile Provider
Type
Default plan
Snapshot
1.4.13.1.
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
iQsim 2013
Page 70/113
Field Name
Field Description
Parameters
SIM Plan Type
SIM Country
Mobile Provider
SIM Type
iQsim 2013
Page 71/113
Postpaid Rollover
Minutes
If applicable, you can report unused credit time to the next month.
In this case all calls are starting to be charged with this value even in
case of non-connected calls.
Supervision
Call Remaining Credit
Alert
SMS Remaining
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.
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
iQsim 2013
Page 72/113
Field Name
Field Description
Defines in minutes the starting credit for SIM card at first usage.
Credit may change after first Recharge or first Credit Check
Defines in number of SMS the starting credit for SIM card at first
usage.
Credit may change after first Recharge or first Credit Check
iQsim 2013
If checked then the Credit Type is allowed to be used for OFF NET
Calls and SMS as well.
Page 73/113
3- #Credit Check
Field Name
Field Description
iQsim 2013
Page 74/113
Select the
Credit Synchronization
Enter the exact text of SMS to send to service number for getting
Credit Check event
Number of SMS
Expected
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.
Number of SMS
Expected
iQsim 2013
Page 75/113
Timeout On
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
iQsim 2013
Page 76/113
iQsim 2013
Page 77/113
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
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
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
WARNING !!!
Calculation is remaining
seconds and not
minutes for CALL
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
Test Configuration
iQsim 2013
Page 78/113
Field Name
Field Description
Remaining SMS
Recharge Mode
Recharge
Trigger
iQsim 2013
Page 79/113
Acknowledge
IVR Server Number
Use this field if it is required (previous field in use), same DTMF and
special VAR are accepted.
SMS Mode
Recharge Server
Number
Acknowledge
SMS Server Number
SMS Confirmation
Message
SMS Returned
USSD Mode
USSD Command
Message
iQsim 2013
Page 80/113
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.
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.
Field Name
Field Description
Activation Trigger
Activation Mode
iQsim 2013
Page 81/113
SMS Mode
Activation Server
Number
SMS 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.
In this field you will set the USSD service number followed by the
different choice if menus are offered.
Example: *123#,2,1,%t
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
iQsim 2013
Page 82/113
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.
Activation Confirmation
Message Format
Check this option if you are required to send back a SMS for
confirmation by using the Service Number received from SMS Reply
Common Parameters
Run Credit Check After
Recharge
Scheduler Script
iQsim 2013
Page 83/113
6- #SIM Protection
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
iQsim 2013
Page 84/113
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.
1.4.15.
Usage
iQsim 2013
Page 85/113
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
Partition
Name
Hostname
Public IP
Status
GSM ports
SMS Allowed
ASR
ACD
1.4.15.1.
iQsim 2013
Page 86/113
Field Name
Field Description
IP
IRON Suite Only
Hostname
IRON Suite Only
Serial Number
IRON Suite Only
Login
IRON Suite Only
Password
IRON Suite Only
Default Country
VoIP Enabled
TAB#1 SETTINGS
General configuration of the Service Controller
Database Access Parameters
Last Caller Enabled
iQsim 2013
Page 87/113
Note:
Blacklist In Enabled
The IRON SIM Server One enables per default the CDR
CDR Enabled
Database Mapping Access / IRON Suite Only
IP/ Hostname
IP Port
IP Port
Database Country
iQsim 2013
Page 88/113
iQsim 2013
Page 89/113
1.4.16.
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
1.4.17.
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 2013
Page 90/113
1.4.18.
Routing Tables
1.4.18.1.
Managing Route
Usage
iQsim 2013
Page 91/113
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
Origin Device
Called Pattern
Switch Type
Route Type
Destination
Snapshot
1.4.18.1.1.
Field Description
Field Name
Field Description
Enable Route
iQsim 2013
Page 92/113
Device
VoIP Trunk
Device Group
Called Pattern
Country
(GSM service type only)
Sim Group
(GSM service type only)
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.
Value Meaning
A: Accepted, DC: Check with Dialer Control, R: Rejected
Minimum
Very Low
Low
Normal
High
Very High
Maximum
iQsim 2013
Valid
A
A
A
A
A
A
A
Wrong
DC
A
A
A
DC
DC
R
Missing
DC
DC
DC
R
DC
R
R
Page 93/113
Cache Level
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
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)
Switch Operation
Called Number
Translation
Active CDR
Switch to destination
Destination Type
Main Route
(VoIP or GSM only)
White Route
(GSM only)
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
iQsim 2013
Page 94/113
MNP Check
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
1.4.18.1.2.
Usage
The Called Number Translation function allows manipulating the number presented to the system.
iQsim 2013
Page 95/113
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
Device
VoIP Trunk
Device Group
Called Prefix
Start Period
End Period
Called Number
Translation Operation
Comments
Caller Number
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 2013
Page 96/113
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
Snapshot
1.4.19.1.
iQsim 2013
Page 97/113
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
1.4.19.2.
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.
iQsim 2013
Page 98/113
Snapshot
1.4.19.3.
Usage
The SMS Campaign Report helps to follow campaign running or once completed.
Snapshot
iQsim 2013
Page 99/113
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.
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
Create a new port group named for instance ALLPORTS, composed of all GSM ports of the
GSM device.
Click SAVE
Steps
iQsim 2013
Action
Page 100/113
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 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 2013
Page 101/113
2.2.
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
Action
Refer to the section 1.4.8.5 Messages List p.58 of this document for more details.
Create
an
IRON
HBS
Scenario
Action
iQsim 2013
Page 102/113
Enter 15s and 30s for the min and the max for the simulated call duration
Select the destination list named Phone_numbers_list_1
Configure the SMS generation:
4
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
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
2.3.
Page 103/113
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
Action
Click SAVE
For more details about other fields, refer to the section Price Plan Table of this document.
Add a top up
code
Action
Click on IRON SIM Manager > IRON HBS Server > Top Up code, ADD RECORD
Select the price plan Prepaid_Orange
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 autorecharge 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.
iQsim 2013
Page 104/113
2.4.
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
Click SAVE
For more details about other fields, refer to the section Price Plan Table of this document.
Create
/
modify an
allocation
rule
2.5.
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 2013
Page 105/113
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
Action
Click on GSM ports, configure the filter to display the GSM port you want to perform the
allocation.
2
3
Refer to the section Error! Reference source not found. Error! Reference source not found. of this
document for more details.
iQsim 2013
Page 106/113
Chapter 3 - Troubleshooting
3.
Troubleshooting
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
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 2013
Page 107/113
Chapter 3 - Troubleshooting
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>
</e>
Display all
events
logged
by
the
SimServer
component
Display all
error events
iQsim 2013
Page 108/113
Chapter 3 - Troubleshooting
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.
Overview
iQsim 2013
Page 109/113
Chapter 3 - Troubleshooting
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
1.00
Rotation ID
65000149
ICCID
START
STOP
8933108104006
6691038
SIM Operator
20810
GSM device
Name
Q300-00010001
IP Address
192.168.198.188
Port number
Date
Time
2007/02/08
18:00:33
Left minutes
20
Price Plan
SFR On Off
iQsim 2013
and
Page 110/113
Chapter 3 - Troubleshooting
Information
Field
Description
Illustration
Rule
SFR On
Stop Cause
of
75
60
iQsim 2013
Page 111/113
Chapter 3 - Troubleshooting
Identification
Cause
iQsim 2013
10
11
12
13
14
15
16
99
Undefined reason
Page 112/113
Chapter 3 - Troubleshooting
Causes
stop log
3.3.
of
Related Documentation
iQsim 2013
Page 113/113