CGW-P Installation and Operation Manual
Appendix B: CDR Downloader B. B.1
Introduction
CDR Downloader is an application designed to download Call Details Recording (CDR) list from CGW-P and CGW-I systems. A downloaded file is saved as a *.csv file for future maintenance using compatible software (such as Microsoft Excel).
This release is compatible for CGW-P version 3.xx and CGW-I version 3.xx firmware.
B.2
Installation
To install the application, insert the supplied CD into the CD-ROM drive. The installation should start automatically. If the installation procedure does not start, perform the steps as follows: a.
Select StartRun. Run window opens (Figure B-1).
Figure B-1. System Alarms Screen b.
Click Browse. A standard browser window opens.
c.
Browse to the CDR-Downloader Installation directory and double-click the Setup.exe icon (Figure B-2). CDR Downloader Setup window appears (Figure B-3).
Figure B-2. Setup.exe Icon
1
CGW-P Installation and Operation Manual
Figure B-3. CDR Downloader Setup – Step 1 d.
Click Next to proceed. The next setup window appears (Figure B-4), displaying the default path for installation in Destination Folder area.
Figure B-4. CDR Downloader Setup – Step 2 e.
If required, click Browse and select a new destination.
f.
Click Next to proceed. The next setup window appears (Figure B-5), displaying the default name for the program.
2
CGW-P Installation and Operation Manual
Figure B-5. CDR Downloader Setup – Step 3 g.
If required, type a new name.
h.
Click Next to proceed. The next setup window appears (), displaying a message that the installation procedure is complete.
Figure B-6. CDR Downloader Setup – Step 4 i.
Click Finish to confirm. The window closes and the CDR Downloader application is ready for operation.
3
CGW-P Installation and Operation Manual
B.3
System Operation
To initialize the application, select StartProgramsCDR Downloader CDR Downloader. CDR Downloader window opens (Figure B-7). This is the main window through which you will perform all system operations.
Figure B-7. CDR Downloader Window
Only one instance of the application can be open at a time. It is recommended to create a shortcut to the desktop for this application simply by dragging it to the desktop while holding down the Ctrl key. The system supports the following operations: Adding a device to the list (see Paragraph B.3.1). Direct download of a CDR file (see Paragraph B.3.2). Downloading CDR files according to a scheduling scheme (see Paragraph B.3.3).
4
CGW-P Installation and Operation Manual
B.3.1
Adding a Device to the List
To add a device to the list, click Add device. Device details window opens (Figure B-8).
Figure B-8. Device Details Window Fill the fields as follows: a. Device Name (mandatory) – a descriptive device name. Legal entries: Up to 20 alphanumeric characters (do not use the following characters: \ / : * ? " < > |). The file name prefix of saved CDR files will correspond to this field. b. Location\Notes (optional) – free text of up to 50 characters specifying cellular gateway location and/or notes. c. Representative Name (optional) – free text of up to 20 characters specifying contact person’s name responsible for the specified cellular gateway. d. Representative Phone (optional) – free text of up to 20 characters specifying the contact person’s phone number. e. Device Version – the firmware number of the target cellular gateway. Legal entries – digits 0…9 only. Format: X.XX (currently only versions 3.XX & 3.XX are supported). f.
Device Password (mandatory) – the administrator password of the target cellular gateway. Default: 1234.
g. CGW-P and CGW-I radio buttons – determine the type of the target cellular gateway.
5
CGW-P Installation and Operation Manual h. Modem Phone number, IP Address and Com Port radio buttons select the PC device used to connect to the cellular gateway. Irrelevant fields shall be grayed according to selection. i.
Modem Phone number filed – active when Modem Phone number radio button is selected. Displays the phone number to be dialed by a selected modem in order to establish modem connection with cellular gateway remote modem (modem supplied with gateway with preinstalled parameters).
j.
Modem combo-box – active when Modem Phone number radio button is selected. Contains a list of modems (internal and external) used to connect to a remote cellular gateway. Allocate modems according to connected account phone networks and traffic (expected usage for availability considerations). If a required modem is not on the list, click the adjacent Update Modems List button. If the modem still does not appear, reinstall the driver.
k. IP Address field – active when IP Address radio button is selected. Enter the target cellular gateway host IP address (gateway should be connected and configured to a network with an open route to PC with specified port not blocked anywhere within the route). Parameter format XXX.XXX.XXX.XXX (XXX – 000..255). l.
Port number field – active when IP Address radio button is selected. TCP/UDP port used for establishing connection between CDR Downloader and target cellular gateway using TCP/IP based LAN connection. Default: 10250).
m. Com Port combo-box – select a COM port with serial cable directly connected to cellular gateway RS-232 port (you may choose COM1 through COM8 of your computer, although it is possible that some ports may not be present, as a provision for USB serial adaptors usage that could be temporarily disconnected). When setting a schedule to device connected via a removable COM port, verify that actual COM port assignment corresponds to allocated COM port). n. Click OK to confirm the creation of the new device account. The new device appears in the Device Name pane.
The Device Name pane can contain up to 15 devices.
B.3.2
Direct Download of a CDR File
To download a CDR file directly from the target cellular gateway, perform the steps as follows: a. Select a target gateway in the Device name pane. b. Click Get CDR Now. Get CDR Now window opens (Figure B-9), displaying the path where the file will be saved (default). If required, click Browse and change this path. 6
CGW-P Installation and Operation Manual
Figure B-9. Get CDR Now Window c. Click OK. Display returns to the main screen. Downloading session information is indicated as displayed in Figure B-10. When connection session is completed, main screen will show the last connection status and downloaded file will be saved on the PC (if successful). The name of the downloaded file is always appended by the download time suffix (including date, minute resolution, hours in a 24-hour format), except for the csv extension.
Figure B-10. Connection Session Status
If a CDR file is successfully downloaded, CDR list in the cellular gateway will be erased. If scheduled downloads are active or queued, downloading commence
from after
selected queued
device downloads
shall are
completed.
7
CGW-P Installation and Operation Manual
B.3.3
Downloading CDR Files According to a Scheduling Scheme
To download a CDR file according to a scheduled scheme, perform the steps as follows: a. Select a target gateway in the Device name pane. b. Click Set Schedule. Schedule details window opens (Figure B-11). Device Name field displays the name of the device as previously defined in the Device details window (Figure B-8).
Figure B-11. Schedule Details Window c. Download to path field displays the default path for saving the file. If required, click Browse and change the path. For improved file management, it is possible to specify a different path for the files of each cellular gateway. d. To manage the disk quota, select the Limit folder size to checkbox and enter a value in the adjacent field to specify the maximal folder size in megabytes. This situation is considered erroneous (quota error). CDR records are not deleted from cellular gateway. e. Select a radio button to set the scheduling parameters. The available options are: No schedule – scheduling mode is disabled. To download files use the direct method (Paragraph B.3.2). Fixed day in a month – set the schedule for a certain time of day on a fixed day of month, e.g. on the 15th of each month at 21:30 hours. Legal value for dates: 1 to 28. When set so, download will take place under the following conditions: -
The scheduled time has come, and last download was at least 24 hours ago.
8
CGW-P Installation and Operation Manual
-
More than a month has passed since the last download.
-
Last download has failed (less than three times).
Every days – set a value to specify a fixed interval of days and specify the required time, e.g. every 3 days at 21:30 hours. Legal values: 1 to 99. When set so, download will take place under the following conditions: -
New schedule.
-
More than X days (X * 24 hours) have passed since last download.
-
Last download has failed (less than three times).
Scheduled downloads will be skipped and re-scheduled for the next day if due to failed downloads or other previously queued downloads the time lapsed exceeded the No longer than time limit (if set). Every hours – set a value to specify a fixed interval of hours, e.g. every 15 hours. Legal values: 1 to 23. When set so, download will take place under the following conditions: -
New schedule.
-
More than X hours have passed since last download.
-
Last download has failed (less than three times).
If
the
CDR
file
was
successfully
downloaded, the CDR list in the cellular gateway will be erased.
9
CGW-P Installation and Operation Manual
B.4
Graphical User's Interface
B.4.1
Color Legend
The Device Name pane displays a list of devices. On the left of each device name appears an icon, the color of which indicates the device status according to the following legend: White Yellow Bright
No schedule has been set for the device. A schedule has been set for the device. Currently processing CDR download from device.
green Dark green Red
A scheduled download is now queued for download. Communication problems have occurred during the download process.
Figure B-12. Device Name Pane – Icon Color
To view device/schedule/last download information, select the relevant gateway in the Device Name pane.
10
CGW-P Installation and Operation Manual
B.4.2
Status Bar Messages
The status bar displays status messages and error codes as detailed in the following table: Message
Description
Downloading now
Download is currently processed
Successful
Last download was successful
Waiting for download Download is queued 900
Successful
901
No local modem was found
902
No dial tone
903
No answer from remote modem
904
Busy tone
905
Failed to create socket
906
Failed to connect
907
Failed to open communication port
908
Failed to communicate - the system is busy
909
Wrong Version
910
Wrong Password
911
Time out
912
Folder reached it's size limit
913
No space on PC
914
Failed to delete records
915
Failed to save the file
916
Failed to create the file
917
Communication error
918
Failed to communicate - system setup not active
919
Failed to initiate programming mode
920
Failed to read records from the system
921
Wrong device type
950
Failed due to immediate termination by the user
11
CGW-P Installation and Operation Manual
B.5
Application Shutdown
To shut down the CDR Downloader application, right-click the application icon in the tray bar and select Shutdown CDR Downloader from pop-up menu and confirm shutdown in the dialog box. The shutdown process may take up to three minutes.
Clicking the
icon in the top right corner of the
application window does not close the application! It is minimized, while scheduled downloads continue in the background. If download is in progress or there are queued downloads, a shutdown confirmation dialog box opens (Figure B-13). Perform the following: Click Yes to shut down. Click No to allow the download process to finish and then shut down. The application enables downloads to proceed for another 30 minutes only, at the end of which it terminates. Downloads terminated prematurely due to shutdown receive the status of Failed due to immediate termination by the user and will be instantly queued for download once the application is re-opened.
Figure B-13. Shutdown Confirmation
12