Professional Documents
Culture Documents
EasyLynq
Index
INTRODUTION........................................................................................................................................................3 GENERAL PRESENTATION........................................................................................................................................3 MAIN FEATURES .....................................................................................................................................................3 INSTALLATION NEEDS ..............................................................................................................................................6 INSTALLATION CD .................................................................................................................................................7 EASYLYNQ MODULES INSTALLATION................................................................................................................8 INTERNET UPDATES ..............................................................................................................................................10 MODULE CONFIGURATION ................................................................................................................................11 TAXDBSRV CONFIGURATION ................................................................................................................................11 PBXAGENT CONFIGURATION.................................................................................................................................13 Status information...........................................................................................................................................15 ISAPI (EASYLYNQWEB) CONFIGURATION ..............................................................................................................16 EASYLSQL CONFIGURATION (ODBC DRIVER) .......................................................................................................17 SNMP TRAP NOTIFICATIONS .................................................................................................................................22 EASYLYNQ USER MODULE .....................................................................................................................................23 Startup procedures .........................................................................................................................................24 Short presentation ..........................................................................................................................................24 INSTALATION NOTES..........................................................................................................................................27
-1-
EasyLynq Call Accounting System version 1.40 Installation / Configuration Manual Revision date: 2007.January.08 Eurofluxo - Suporte a Novas Tecnologias, Lda. Vila Nova de Gaia - Portugal http://www.eurofluxo.pt/
-2-
EasyLynq
INTRODUTION
General presentation
EasyLynq, Call Accounting System, is a three modules distributed software application, PABX AGENT, DATABASE ENGINE SERVER, and GRAPHICAL USER INTERFACE, intended for cost processing and traffic analisys on electronic/digital branch exchanges starting on configurations of small offices and ending up on geographically distributed companies and institutions. Following some of Its most important features:
Installable under Windows 95, 98, Millenium, NT 4, 2000, XP and 2003 operating systems, on Intel platforms. High reliability with no need for specialized technical assistance. Truely versatile, configurations are tailored to specific costumer needs. Centralized multi-indexed database featuring reduced information search time. Fully modular software, developed in 32 bits, using RPC communication technology. Distributed architecture for optimized operation in LAN/WAN environments. Multiple PABXs per PABX AGENT module and multiple PABX AGENTS centralized on an DATABASE ENGINE. Several USER INTERFACES may administrate and access information simultaneously.
Main features
Communication between modules using TCP/IP or NETBEUI. Allows up to 50000 extensions and 20000 external lines. Costumized numbering plan, adapted to the most recent PABX needs, allows extensions and trunk lines to have up to 10 digits. Call records stored on disk, detailing PABX system, extension, trunk line, dialled number, project account, authorization code, call success and direction, meter pulse number, start date and time, ring duration, conversation time, cost and price in four currencies and type (switchboard console transfer, authorization code use, etc.). Summary of calls, meter pulses, cost and price by extension, trunk line and project account. Automatic debit of residual costs of switchboard transferred calls. Individual call search, within any date range, using user selectable filters (direction, success, time to answer, conversation, price, pulse count and outside subscriber).
-3-
Unlimited extensions groups and group nesting. User configurable description of extensions, trunk lines, project accounts and authorization codes up to a maximum of 40 characters. Unlimited number of users distributed in eight access levels, for restricted access to information, administration and call registers erase. User events history contains detailed data about every user operation that might affect system integrity. System events history contains all occurences (abnormal interruptions, external data cables (dis)connecting, communication errors, etc.) that might interfere in system well-behaviour. Average storage of 250 000 call registers per each 100 MB of hard disk. Tariff classes for extensions, allowing price evaluation according to each call type (extension, meter pulse number, destination, etc.) and immediate call receipt print-out. Integrated communications routine for PABX setup/monitoring. User selectable call erase within a date range, freeing space for more call recording. General reports, on printer, text file or CSV file, group or route oriented. Integrated backup and restore procedures using file compression. On-line display of last 100 call records, continuously updated, allowing the user to select a record for receipt print-out. Authorization codes up to 10 digits, charging each call to its subscriber (this feature is PABX dependent and may not be available on a particular installation). Project accounts enable call charge according to remote subscriber or user dialled prefix. Integrated on-line help and operation manual. Multiple telecommunication operators and carriers, using pulse and/or duration charging. Records reorder available in every query according to user preferences and needs. Graphical representation of daily call distribution. System administration using drag-and-drop operations for easy-of-use configuration. User-defined masks for remote subscriber numbers on call queries in order to keep confidentiality. Configuration of fixed and variable holidays for correct call charge when using time duration tariffs. Multiple queries display for data comparison. Query results export to Microsoft Excel and XML (eXtended Mark-up Language).
EasyLynq Server
Connection of several PABXs of different models and brands. Queries to database via BROWSER (HTML) and ODBC (SQL commands). Reports and alarms sent to specified addresses using electronic mail. Calendar Manager for execution of scheduled tasks. SNMP trap notifications to Network Management Systems. LDAP connectivity.
-4-
EasyLynq
EasyLynq Hotel
EasyLynq Hotel is an application designed for PABX management in a hotel environment. Some of following features are PABX implementation dependent and may not be available on your particular location:
Allows up to 3000 lodgements. Each room configurable up to 10 extensions. Credit limit per guest. Automatic wake-up, allowing wake-up mark and wake-up result control. Sound and visual alarms in case guest misses to answer. Message waiting with lamp activation on room phone set. Text messages up to 330 characters. Manual call posting. Minibar and laundry posting, either on rooms phone set or on EasyLynq user user interface. Temporary outgoing access restriction. Room-status control using special codes dialled on phone set for automatic update of room availability. Multi-complex option for multi-properties management. Option for connection to Pay-TV systems. PABX interactive (model and implementation dependent), controlling following parameters: - Outgoing trunk access (bar / unbar). - Guest name transfer for use in phone sets with a display device. - Spoken language. - Message waiting. - Do not disturb. - Automatic wake-up mark and answer control. - VIP status. - Dynamic DDI (Direct Dialling In) assignment. - Room-status. - Guests mail box control. Connection to Front-Office systems. Connection to in-room broadband internet access equipments.
-5-
Installation needs
This manual is intended to drive you in order to make a clean installation and a correct configuration of EASYLYNQ Call Accounting System. EASYLYNQ must be installed under Windows 95 (user module only), 98, Millenium, NT 4, 2000, XP and 2003 operating systems, on Intel platforms. It is oriented for network (LAN / WAN) environments and fully developed in 32 bits technology. Its main modules are: TAXDBSrv (database server), PBXAgent (PABX / Front-Office communication agent) and EasyLynq (graphic user interface). EASYLYNQ can be easily adapted to several configurations, starting on small offices and ending on large companies geographically distributed. You can install EASYLYNQ modules on different computers in the network. Depending on the size of the installation, these equipments should conform to the following specifications: TAXDBSrv module (database server): Extension number
Up to 20 21 up to 50 51 up to 100 101 up to 200 201 up to 500 501 up to 1000 1001 up to 3000 3001 up to 5000 More than 5000
Advisable
Windows NT Windows NT Windows NT Windows NT Windows NT Windows NT Windows NT Windows NT
PBXAgent module (PABX / Front-Office communication agent) located on a different machine: Extension number
Up to 50 51 up to 500 501 up to 5000 More than 5000
Advisable
Windows NT Windows NT Windows NT
EasyLynq module (graphic user interface) located on a different machine: Extension number
Up to 50 51 up to 100 101 up to 200 201 up to 500 501 up to 1000 1001 up to 3000 3001 up to 5000 More than 5000 Legend:
Advisable
Windows NT Windows NT Windows NT Windows NT Windows NT Windows NT Windows NT
C Pentium original, MMX, Celeron P Pentium II or upper Windows 9x Windows 95, 98 and Millenium Windows NT Windows NT 4, 2000, XP and 2003
Values on these tables are based on average traffic conditions. EASYLYNQ modules were developed so that CPU usage is nearly zero when running in idle mode (you can get this information calling Windows Task Manager). The tables shown above do not take into account running other applications and services on the same computer. Although EASYLYNQ does not impose any restriction to this fact, you should consider memory and other resources decrease.
-6-
EasyLynq
INSTALLATION CD
This Compact Disk allows you to install all modules. You can also find, in folder UTILITY, several programs that enable you to reset passwords to their default, test serial devices, etc.. To start the presentation program, simply insert the CD on the CD-ROM and wait a few seconds. The following window should appear:
If CD-ROM Autoplay feature is not active, you may start CDELYNQ.EXE program manually. Run Windows Explorer or doubleclick the CD-ROM icon after opening My Computer on the Desktop. Installation options in the Advanced Setup group are exclusive to EasyLynq Server and Hotel+ versions. Click on the icon figure on top left to access several advanced features such as uninstall applications, run advanced CD tools and open documents. In order to keep EASYLYNQ the most user friendly and competitive, Eurofluxo may add, at any time, configuration tools and tables that can speed up system tuning. Always refer to these updates just clicking Read me button. Explore CD allows you to easily access following tools: File FREEPWD.EXE SERIAL32.EXE IFDOCS.EXE IFDOCS.EZD YTAXLYNQ.EXE WINCOMM.EXE XCELLYNQ.EXE INSTALLWAVES.EXE LIB3INSTALL.EXE Function Resets to default installation passwords on TAXDBSrv and PBXAgent. Serial ports test utility. Implies connectors (not supplied) with several shunts as specified when you run this program. Interfaces documentation. Shows how to configure the PABX or other equipments and supported features. Enables a smooth upgrade from older Call Accounting Easytax/Easytel to EasyLynq and EasyLynq Hotel. Small serial port / telnet terminal emulator utility. Supports TTY, VT100 and Minitel screen emulations. Uploads/downloads several EasyLynq tables to/from Excel files (.xls) Voice messages to be used in the operation of several interfaces in a hospitality environment. Manufacturers drivers and other software, required for the operation of several interfaces.
You may also find, on folder DATA of this CD, the ClientInfo.exe program that allows you to open TAXDBSrv.key and read some data about costumers licence such as name, serial number, configured interfaces, features and demonstration issues, etc..
-7-
Also common to all modules. Please read carefully the License Agreement if you do not agree, close the Installer and return back the EasyLynq package for a refund.
This window is exclusively used in TAXDBSrv and PBXAgent installations. The recommended action is choose YES so the user needs not start these applications manually everytime he logs on.
-8-
EasyLynq
This windows appears on TAXDBSrv, PBXAgent and ODBC driver installations (the later doesnt support Spanish).
This window is common to all installations. Change the suggested folder for the application if required. After you press the Next button, the Installer informs you that it is ready to perform the installation.
-9-
Windows Installer creates an entry in the Programs group of Start menu named EasyLynq which gives you access to shorcuts of all modules you have chosen to install (excluding EasyLynqWeb ISAPI and ODBC driver). If you want to remove any module, go to Control Panel and run Add/Remove programs option or click the top left icon of the CD integrator to access the uninstall menu. Important notice for Windows NT, 2000, XP and 2003 users: you should have Supervisor or Power User previleges otherwise Windows Installer will not be able to install most of the applications. Now that you have installed EASYLYNQ, refer to following chapters in order to run and tune system up. Additional information Please keep the CD in a cool dry place, away of magnetic fields. You may need to use them later. Also keep product serial number in a safe place. Youll be asked for it in case youll need technical assistance or order another copy due to loss or malfunction.
Internet updates
Eurofluxo makes available, in www.eurofluxo.pt, updates for the EasyLynq modules that include several enhancements and minor corrections. After downloaded, these files must be copied to folder Updates of the directory where the server is installed. Module update is automatic and will be performed in a few minutes.
- 10 -
EasyLynq
MODULE CONFIGURATION
TAXDBSrv configuration
Click button of Windows TaskBar, select Programs, EasyLynq, TAXDBSrv. Wait a few seconds and TAXDBSrv icon should appear on the right side of TaskBar:
At the beginning a small red circle will be displayed above the icon indicating startup procedures running, such as database files initialization and tables creation. Move mouse pointer over the icon and doubleclick left button or click right button and select Configure. The following window should appear:
About: is an information window showing some data about product licence, serial number and version.
General: notices installation date, last start-up date and physical memory status. You can change server ID (default is computer name), modify access password and terminate this service.
- 11 -
Communications: gives information about computer name and current IP address (if TCP/IP installed). You can also change available protocols checking / unchecking corresponding boxes. Local protocol cannot be disabled. If you uncheck both NetBEUI and TCP/IP, TAXDBSrv cannot be accessed from other computers on network.
It may happen, ocasionally, that a warning message appears in front NetBEUI or TCP/IP protocols:
Under these circunstances, the corresponding protocol is not working properly. Do not activate it before you solve the problem on Windows.
Definitions: enables dimensioning of the number of elements in some tables and database.
Avoid to overweight these values in order to keep database files wisely sized. Non virtual extension number is limited by licence. By default TAXDBSrv creates automatically extensions and channels / trunk lines based on call logging information. You can uncheck any of these boxes in Auto create group if you wish.
IMPORTANT: sometimes, due to a power failure or operating system crash, call records database may become corrupted and lead to abnormal query results. In these cases, click on Rebuild button, select the period and proceed to database reindexing and recovery. This feature can also be used to revaluate call costs.
ADDITIONAL FEATURE
Starting on version 1.30, server and agent modules support telnet sessions for telemaintenance purposes. This feature should be used only by qualified personnel. For more detailed information about how to start a session and available commands, click on button Read me in the presentation program of the CD and refer to help window, chapter Telnet session.
- 12 -
EasyLynq
PBXAgent configuration
Click button of Windows TaskBar, select Programs, EasyLynq, PBXAgent. Wait a few seconds and PBXAgent icon should appear on the right side of TaskBar:
At the beginning the small ray will show red indicating PBXAgent is searching TAXDBSrv server. Move mouse pointer over the icon and doubleclick left button or click right button and select Configure. The following window should appear:
About: is an information window showing some data about product licence, serial number and version.
General: notices installation date and last start-up date. You can reconfigure server name (on a TCP/IP network you can also use IP address), modify access password and terminate this service. On a new installation, server name defaults to current computer name.
- 13 -
Interfaces: enables selecting a physical interface in order to configure, monitor and put out of service. Each PBXAgent can support up to 99 interfaces. When you select to edit an interface, you may be asked the type connection: serial port or TCP/IP.
You selected to edit a serial interface. You can choose port and configure communication parameters. By default, PBXAgent uses computer date and time for call logging but you can change this option if want to use PABX date and time. You can also force all data bytes coming on serial port to be saved on a disk file. Choose desired PABX model and configure its local properties.
You selected to edit a TCP/IP connection. Enter a description (optional), equipment name or IP address, port and, if needed, the user name and password PBXAgent will use to access it. Other parameters apply the same manner as in the previous window.
Notice: option Send data to file should be used only for maintenance and debugging purposes. If checked, PBXAgent opens a file named INTERFACEn.DAT, where n identifies the number of the current physical interface (1 - 99), and stores all characters received on it.
- 14 -
EasyLynq
You have chosen Monitor on Interfaces window. Herein you can check communications with remote device such as PABX or Front-Office interface and notice control lines status in case of serial ports.
Status information
Click mouse right button over PBXAgent icon on TaskBar then select Status option:
The above window shows information about TAXDBSrv connectivity status and the number of pending messages and events. These records are stored on file and they are only limited by disk free space. In case the connection is established, records are sent immediately to the server. If the connection drops, retries to reopen it are made every 60 seconds.
- 15 -
Installation / configuration steps: Install and configure EasyLynq system as explained on the other chapters. Install EasyLynqWeb ISAPI from CD. Run ISAPICFG.EXE program. This file has been copied to the selected folder at the previous step. Configure several parameters such as TAXDBSrv server location, timeouts, etc. and save them. Install PWS (WIN 9x) or IIS (NT 4 / 2000 / XP / 2003). Youll probably need the Windows installation CD. Configure WWW server and add a virtual directory (for example EasyLynqWeb) with read and script permissions and pointing to the directory where you have installed the ISAPI.
http://computer/easylynqweb/easylynq.dll
where computer designates the computer name on which we have installed the ISAPI. If you have configured EasyLynq.dll as a default document on the WWW server, you can omit it. Following window should appear:
You must enter valid ID and password to continue. See next chapter to learn how to run EasyLynq user interface and configure its operation.
- 16 -
EasyLynq
DATA SOURCE CREATION To make queries to EasyLynq server through ODBC, a new data source must be previously created. This option is located at the following places: - Windows 95, 98, Millenium and NT 4: Control Panel, Data Sources (ODBC). - Windows 2000, XP and 2003: Control Panel, Administrative Tools, Data Sources (ODBC).
In the ODBC Data Source Administrator, select System DSN and press the Add... button.
- 17 -
The EasyLSQL configuration wiizard appears before you. In the first page enter a name for this source, a description (optional), the name or IP of computer where TAXDBSrv server is currently running and choose the operating language.
On the second page define the default period and type for call records and events database. These settings will be used in case the corresponding parameters are omitted in the SQL statement.
On the last page select if you want to log the SQL processing to a text file and to avoid entering na user ID and password every time you connect to the data source.
After you click Finish, any application with ODBC support can access TAXDBSrv database.
- 18 -
EasyLynq
GETTING DATA Data is accesible through SQL commands. A typical SQL command to get the extensions list looks like the following: select * from extension It is out of the scope of this manual to explain the SQL language. If you do not feel familiar to it, please refer to manuals and other documentation available in specialized bookstores. Several applications, such as Excel, Access, MSQuery and SQL Server, help you to make queries using a wizard utility, which avoids the manual entering of SQL commands.
SUPPORTED SQL LEVEL EasyLynq ODBC driver enables you to query the database and some tables and modify several (but not all) parameters in the configuration tables. It is not allowed to insert or delete any element. Supported SQL commands are: select update It is not allowed, in each SQL command, neither to specify more than on table nor aggregate columns of several tables. select command can contain several clauses for data searching, ordering and aggregation. Supported expressions are: where order by group by having, union and distinct are not supported. When using the where keyword, the following symbols are allowed: > < = >= <= AND OR ( )
IN, LIKE, NOT and arithmetic expressions (+, *, -, /) are not supported. EasyLSQL supports the aggregation keywords: sum, avg e count. These expressions can be used together with group by. Using them without specifying group by is equivalent to specify group by all. Only numeric data columns, such as call price and ring time, can use these expressions. EasyLSQL is case insensitive for keywords and for table and column names. Search parameters are case sensitive and must be accurately entered. In the following example, the group name is Marketing with capital M: select * from callrecord where (group = Marketing) The following date and time formats are permitted: dd/mm/yyyy, dd-mm-yyyy, yyyy/mm/dd, yyyy-mm-dd hh:mm, hh:mm:ss If specified, time must follow date using a space as a separator:
select * from callrecord where datetime > 1-11-2001 and datetime < 31-11-2001
- all call records between 00:00 of 1st November 2001 and 23:59:59 of 31st November 2001.
select * from callrecord where datetime > 3-11-2001 10:00 and datetime < 4-11-2001 9:59
- all call records between 10:00:00 of 3rd November 2001 and 09:59:59 of 4th November 2001.
- 19 -
TABLES AND COLUMNS The following board presents the tables and correspondent columns available on EasyLSQL: CALLRECORD datatime success type extension pabxext trunkline pabxtrk remote projaccount ring conversation pulses extgroup route remarks price_ cost_
3 1 3
description
description
These columns cannot be used as search arguments in the where expression. These are the only columns that can be specified in the update command. In table CALLRECORD, the number of available columns may vary according to configured currencies on EasyLynq server. For example, in case of EURO and POUND, the queries return two columns for price (price_EURO and price_POUND) and two columns for cost (cost_EURO and cost_POUND).
PREDEFINED PARAMETERS Several columns have predefined values: Table: Column: CALLRECORD success type External Incoming Outgoing Internal Int_Org Int_Rec EXTENSION virtual EVENT EVENT_USER type Error Warning Information Hotel (version hotel only)
Supported values:
Yes No
Yes No
These parameters are case insensitive and the first character is sufficient.
- 20 -
EasyLynq
GRANTED ACCESS Tables availability is according to users access level: Administrator, Super User and General User Department Head and Department Manager Group Head and Group Manager
Access level Table callrecord event pabx extension extgroup route trunkline projaccount event_user
PABX Operator
Normal User
update command is granted only to users with access level Administrator, Group Manager e Department Manager.
COLUMNS FORMAT Almost every column is represent as a character string (CHAR). The exceptions are listed in the following board showing the default formats and their alternatives. If an application requests an invalid format for a column, an error is generated. Column datatime ring conversation pulses price_* cost_* Supported formats TIMESTAMP (default) CHAR ULONG (default) TIME TIMESTAMP CHAR ULONG (default) DOUBLE CHAR DOUBLE (default) CHAR
- 21 -
- 22 -
EasyLynq
After installing EASYLYNQ, the only system user is the Supervisor. His ID and password are respectively root and maximlevel. This user has full permissions, cannot be deleted and his access level cannot be modified. His usage should restricted to maintenance staff.
For security reasons change default installation ID and password after logon and keep them in a safe place.
Passwords on EasyLynq are case sensitive so be aware of Caps Lock status. The first time user module is started on a computer, field Server: is initialized to current computer name (which is not always true). You can enter either a computer name or an IP address. EasyLynq keeps a record of the last valid logged-in user and the list of last five valid servers. The operating language can be changed at login time. Just click button and select a flag of your choice.
Main window should appear after logon. Some menu options and buttons on toolbar may not be visible, depending on user access level.
- 23 -
Startup procedures
After installing EASYLYNQ, some startup procedures must be executed in order to tune system up. 1. Select Session on main menu, option Change password and change Supervisors ID and password. 2. Select Administration on main menu, option System and create PABX names. On EasyLynq Hotel, complexes should also be created. 3. On same menu select option Interfaces, Configuration and configure PBXAgent interfaces. 4. Start installed PBXAgent services and configure them. 5. Selecte Administration on main menu, option System again and add configuration elements such as extensions, trunk lines, system users, project accounts, authorization codes, telecom operators and their tariffs, etc. On EasyLynq Hotel you should also configure hotel complexes, lodgements, room-status, languages, posting articles, etc..
Short presentation
EasyLynq offers an electronic on-line manual in HTML format. An user can press F1 or select option Help on main menu to call for help. On earlier Windows versions, this manual may appear in WinHelp format.
System Administration is a powerful easy-to-use tool gathering almost all configuration data.
- 24 -
EasyLynq
EasyLynq enables usage of multiple and versatile pulse and time tariffs, fully adapted to the presence of several telecommunication operators. This architecture also permits call accounting in private links and other external devices.
- 25 -
Daily call distribution displays, in numerical and chart presentations, incoming and outgoing traffic charge.
- 26 -
EasyLynq
INSTALATION NOTES
TAXDBSrv server data
Serial number Costumer ID Address
Installation date
Computer name
IP address . . .
Local
NetBEUI
TCP/IP
Project accounts
Configuration tables dimensions Authorization Extensions Virtual extensions codes PABX IDs
Agent name
PABX ID
PBXAgent Interfaces Extension Trunk line Local extensions prefixes prefix prefix
- 27 -
PBXAgent data
Computer name Installation date Connection V24 TCP/IP PABX model Communication properties Other particular data
Interface number
Computer name Installation date Connection V24 TCP/IP PABX model Communication properties Other particular data
Interface number
Computer name Installation date Connection V24 TCP/IP PABX model Communication properties Other particular data
Interface number
Computer name Installation date Connection V24 TCP/IP PABX model Communication properties Other particular data
Interface number
- 28 -
EasyLynq
PBXAgent data
Computer name Installation date Connection V24 TCP/IP PABX model Communication properties Other particular data
Interface number
Computer name Installation date Connection V24 TCP/IP PABX model Communication properties Other particular data
Interface number
Computer name Installation date Connection V24 TCP/IP PABX model Communication properties Other particular data
Interface number
Computer name Installation date Connection V24 TCP/IP PABX model Communication properties Other particular data
Interface number
- 29 -
PBXAgent data
Computer name Installation date Connection V24 TCP/IP PABX model Communication properties Other particular data
Interface number
Computer name Installation date Connection V24 TCP/IP PABX model Communication properties Other particular data
Interface number
Computer name Installation date Connection V24 TCP/IP PABX model Communication properties Other particular data
Interface number
Computer name Installation date Connection V24 TCP/IP PABX model Communication properties Other particular data
Interface number
- 30 -