Tariscope 4.5.x. Administrator's guide

Chapter 4  Tariscope configuration

4.17. NetFlow / IPFIX / rFlow collector

The NetFlow / IPFIX / rFlow collector (hereinafter "Collector") is intended for collection of information about IP traffic from the data transfer devices that use the following protocols: NetFlow v.5 or v.9, IPFIX, rFlow. The Collector processes only data that can be used for billing purposes.

To configure the Collector, in the Tariscope menu, select Additional options → Integrations. The Integrations page appears as shown in Figure 4.17.1.

Figure 4.17.1

Click on the NetFlow/IPFIX/rFlow Collector button. The NetFlow/IPFIX/rFlow Collector page appears as shown in Figure 4.17.2.

Figure 4.17.2

You should configure the Collector. To do this, click on the Open settings button. The NetFlow/IPFIX/rFlow Collector page will be as shown in Figure 4.17.3.

Figure 4.17.3

In the Data collection and primary processing section of the page, you can set parameters that affect the amount of data in the Tariscope database and log files.

In the Listen ports box, type a TCP/IP port number through which the Collector will get the IP traffic data. By default: 2055. The same TCP/IP port number should be set in the data transmission device. If you want to use more than one port, enter their numbers separated by commas.

The Collector, except processing the incoming data stream and writing it to the Tariscope database, backs up the data stream into a binary file in the format in which it received data.

In the Log folder box, specify a path to folder where logs will be stored.

In the New file every list, select the required period to create a new log. There are the following options:

• Don't rotate. The data will be permanently stored in the single file if its size does not exceed the value specified in the Maximum log size box.
• Hour. A new log file will be created every hour, if its size does not exceed the value specified in the Maximum log size box.
• Day. A new log file will be created every day, if its size does not exceed the value specified in the Maximum log size box.
• Month. A new log file will be created every month, if its size does not exceed the value specified in the Maximum log size box.

Another parameter that affects the period of the creation of a new log file is its size, which is set in the Maximum log size box. When the specified size is reached, the current log file is closed and a new one is created. Enter the desired value in the box. By default: 200 MB.

To reduce the size of the log file on disk, you can use its compression. To configure the compression, in the Compression list, select an option from the following ones:

• No. The compression is not used.
• Zip. The log file is compressed into the Zip archive.
• Bzip. The log file is compressed into the Bzip archive.
• Zlib. The log file is compressed into the Zlib archive.

The Collector may use a time zone, which is installed on a computer with Tariscope, during processing the received data. For this purpose, turn on the Take into account time zone switch.

To reduce the amount of the Tariscope database with information about network traffic if there is no need for full detail, specify the required level of a data aggregation.

Turn on the Aggregate addresses to networks switch. The data is grouped to the level of IP networks specified in the Provider and rates → a particular provider → Outgoing or Incoming → IP networks. Turning this switch reduces the load on SQL Server, and therefore improves performance of Tariscope.

You can specify the aggregation to the level of IP ports. To do this, turn on the Aggregate ports switch.

You can specify the aggregation to the level of IP protocols. To do this, turn on the Aggregate protocols switch.

You can specify the aggregation for a certain time period, which is set in the Aggregate time to list. The list contains the following options:

• No. The aggregation for the time period is not applied.
• Second. It is used to aggregate data obtained in one second.
• Minute. It is used to aggregate data obtained in one minute.
• Ten minutes. It is used to aggregate data obtained in ten minutes.
• Hour. It is used to aggregate data obtained in one hour.
• Day. It is used to aggregate data obtained in one day.

To store the processed data in the Tariscope database, you should configure parameters that are specified in the Database and rating section.

In the Database save interval box, type a time period through which the processed data will be recorded in the Tariscope database. The load on the server increases with a short time period. The default value is 3000 ms.

When there is a need for rating immediately after receiving traffic data, turn on the Online cost charging switch. If the switch is off, rating can be done at any convenient time.

The Collector can write a log with varying level of detail. The level of detail is determined by the value specified in the Log level list. There are the following options:

• Status.
• Critical error.
• Error.
• Warning.
• Information.
• Advice.
• Debug.

Status is the least detailed level, and Debug is the most detailed level of logging.

To save the configuration, click on the Save icon on the toolbar.

Start and stop of the Netflow/IPFIX/rFlow collector

To start the Collector service, go to the NetFlow/IPFIX/rFlow Collector (Figure 4.17.2).

By default, the service runs the user account of LocalSystem. To change the account, turn off the Manage service switch and specify the User account and Password.

To install the service, click on the Install service button. In the Service status position the value of "Stopped" is displayed. The Install service button is replaced to the Uninstall service button and the Run service button is active.

To start the service, click on the Run service button. In the Service status position the value of "Running" is displayed. The Run service button is replaced to the Stop service button. The Uninstall service button is inactive.

After the service was started, we recommend clicking on the Open service log button or select the Service log item of the menu and make sure there are no errors. If the log contains errors, stop the service, return to the settings. After that, try to start the service.

To stop the service, click on the Stop service button. The Stop service button is replaced to the Run service button, and the Uninstall service button is active. The Service status position displays "Stopped".

To uninstall the service, click on the Uninstall service button.

Previous page   Next page

Contents of "Tariscope 4.5.x. Administrator's guide"

Tariscope 4.5.x. Administrator's guide

Chapter 4  Tariscope configuration

4.16. Tariscope Tasks configuration

The Tariscope Tasks is a Windows service which is intended to automatically execute the following tasks by schedule:

• Report generation.
• Synchronization of subscribers' data with Active Directory.
• Receiving of the currency rates.
• Full backup of the Tariscope database.
• Differential backup of the Tariscope database.
• Charging of periodic services.
• Archiving of the calls data.
• Execution of a program.
• Sending newsletter.
• Performing a group of tasks.

To configure Tariscope tasks, control their status, select Tariscope Tasks → Tasks list. An example of the Task list is shown in Figure 4.16.1.

Figure 4.16.1

To create a new task, click on the Add icon on the toolbar. An example of the New task page appears as shown in Figure 4.16.2. The page looks different depending on the selected task type.

Figure 4.16.2

In the Name box, type the task name. This name is displayed in the task table (Figure 4.16.1) and it allows to identify the purpose of a specific task.

If necessary, in the Description box, type a description of the task. This can be especially useful when tasks are created by several persons.

For task execution in the specific time and date, turn on the Active task switch.

In the Next run calendar box, select the date and time of the initial start of the task.

In the Period list, select a period of the task execution. There are the following options:

• Once. The task will be performed only once at the time specified in the Next run calendar box, and then it becomes inactive. If necessary to execute this task once more, you need to define a new date and time of task execution and turn the Active task switch.
• Every minute. The task will be executed at intervals of several minutes specified in the Every box.
• Every hour. The task will be executed at intervals of several hours specified in the Every box.
• Daily. The task will be executed at intervals of several days specified in the Every box.
• Weekly. The task will be executed at intervals of several weeks specified in the Every box.
• Monthly. The task will be executed at intervals of several months specified in the Every box.
• Annual. The task will be executed at intervals of several years specified in the Every box.
• On service start. The task will be executed once, immediately after the service start.

The Tariscope Tasks service starts, regardless of the value of the Next run box of any task.

In the Action type list, select the required type of task. There are the following options:

• Report. One from the reports, which Tariscope contains or the Tariscope administrator was created, is generated. Or a procedure is performed for working with the Tariscope database.
• Full backup. The full backup of the Tariscope database is executed.
• Differential backup. This task creates the backup only a part of the Tariscope database which was changed from the last backup. This option requires less time and computer resources to perform than a full backup. But in the case of the database restore, you should restore each the first full backup and each subsequent differential backups.
• Backup calls. The archiving of the call database is executed, and the appropriated call records are deleted from the database.
• Currency update. The automatic receiving of the required currency rates is executed.
• Synchronize subscribers from Active Directory. Synchronization of subscribers' database with Active Directory of your enterprise is performed. Previously you should create a profile for synchronization with Active Directory.
• Charge periodic services. The service costs are charged for subscribers. The task is used only for the Tariscope Provider edition.
• Execute program. The specific program is started.

The rest of the page looks different depending on the selected task type.

If you have selected the Report option, the rest of the page looks like in Figure 4.16.2. Let us consider the settings of the report task.

In the Source list, select the source of subscriber filter that will be applied to generate the report. There are the following options:

• SQL queries. Subscribers for the report are selected using the SQL query. To set the SQL query, click on the Select subscribers group button. The Edit window appears, where you should type the desired SQL query.
• Subscriber. To select subscribers, click on the Select button next to the Select subscribers group box. The Subscribers window appears, where you should select the desired subscribers and click Select.
• Group. To select groups, click on the Select button next to the Select subscribers group box. The Groups window appears, where you should select the desired groups and click Select.

If you do not use the subscriber filter, the report will include data on all subscribers. When you click on the Select button on the window to keep your choice. DNs of the selected subscribers will be displayed in the Select subscribers group box.

If for report generation you need to apply other data filtering conditions, select the desired filter in the Filter list. The list contains some installed filters and those which you created in the views for calls. After you have selected the filter, the Edit filter button appears. If you want to change the filtering conditions, click on the button. The Edit window appears, where you can do changes. Click on the Save button to keep the changes.

Click on the “…” button located near the Report name box. The Choose the report window appears as shown in Figure 4.16.3.

Figure 4.16.3

In the Group list, select the desired report group.

In the Available reports list, select the desired report. Separate report forms require setting values for variables. In this case, specify the values for variables and click on the Done button. The report name is displayed in the Report name box.

The Save as section includes settings which are applied for saving the report.

In the File path box, enter a path to the folder, where reports will be saved.

In the File mask list, type or select a file name template. The file name supports the following templates:

• %d – day.
• %m – month.
• %y – year.
• %h – hour.
• %M – minute.
• %s – second.
• %a – ID of subscriber.
• %e – main telephone number or IP address.
• %n – subscriber name.

For example, if you use the following name template: report-% y-% m, that reports will be generated in files with names such as: report-2020-05, report-2020-06 and so on. The File mask list contains also other samples of file names that the Tariscope administrator can change at will.

In the File type list, select a file type in which the report will be saved. The following file types are supported:

• xlsx,
• xls,
• xml,
• mdb,
• csv,
• txt,
• htm,
• html,
• pdf,
• print. The print file type means that the file will be automatically sent on a printer.

If you wish to generate the report for each subscriber, turn on the Separate report for every subscriber switch. If you turned on the switch and want to attach the report to subscriber’s document, turn on the Attach report to subscriber documents switch.

If you did not turn on the Separate report for every subscriber switch, you can attach the report to a subscriber. In this case, click on the Select subscriber button and in the appeared window, select the desired subscriber.

The saved report will be accessible for Tariscope users who have access to the Subscribers page.

You can also allow the subscriber to access this report. To do this, turn on the Visible to subscriber switch. The report will be accessible for subscribers through Tariscope Personal Area.

The Notifications section allows you to configure the sending parameters.

If you turned on the Separate report for every subscriber switch and you want to send the report each subscriber, turn on the Notify subscribers and send them reports switch. For execution of this feature, subscriber's parameters must contain its email address.

If you did not turn on the Separate report for every subscriber switch and you turn on the Notify administrator by default switch, the Tariscope administrator will receive email notification about the report generation.

Also, you can specify additional email addresses where letters with the results of this task will be sent. To do this, enter email addresses in the Email box. To enter several addresses, use semicolons.

In the Mail subject box, specify the subject for this sending.

Click Save to keep settings.

To create the task for the full backup, select the Full backup item in the Action type list. Then, specify data in the Save as and Notifications sections.

To create the task for the differential backup, select the Differential backup item in the Action type list. Then, specify data in the Save as and Notifications sections.

To create the task for calls backup, select the Backup calls item in the Action type list. In the Filter list, select the filter that will choose the required calls. Then, specify data in the Save as and Notifications sections.

If you want to create a task to get the currency rates, select the Current update item in the Action type list. The Profile list appears which contains the following profiles:

• National Bank of Ukraine. This option allows you to receive the currency rate provided by the National Bank of Ukraine. Currently, only US dollar and euro rates are being synchronized.
• GE-NBG. The profile is used to receive the currency rates from the site of National Bank of Georgia.
• KZ-NB. The profile is used to receive the currency rates from the site of National Bank of the Republic of Kazakhstan.
• RU-CBR. The profile is used to receive the currency rates from the site of Central Bank of the Russian Federation.
• UA-NBU. The profile is used to receive the currency rates from the site of National Bank of Ukraine.
• UA-PIB. The profile is used to receive the currency rates from the site of Prominvestbank (Ukraine).

These profiles are stored in the folder: …\Program Files (x86)\SoftPI\Tariscope\JobsService\CurrencyProfile. They have a structure of the XML file. The administrator can edit any of the profiles or create your own.

In the profile file, you can create or change the following settings:

• The name and settings of the proxy server.
• The Web page, where it is necessary to obtain information on currency rates.
• A list of required currencies and parameters of search of a currency rate.

Also, you can change a profile data by clicking on the Edit button located on the right of the Profile name box. An example of part of the New task page is shown in Figure 4.16.4.

Figure 4.16.4

Since the information to update the currency rates is taken from the external site, the computer, where Tariscope Tasks will run, must have access to the relevant site. If your network uses a proxy server, you must specify its parameters. Turn on the Use proxy switch and, type values in the Proxy server, User name, and Password boxes.

To add a new currency and site that contains currency rates, click on the Add icon. The Add currency window appears as shown in Figure 4.16.5.

Figure 4.16.5.

Type values in the boxes of the window. An example of such an input is shown below:

Currency code: USD
Decimal delimiter: .
Factor: 0.01
URL: http://www.bank.gov.ua/control/uk/curmetal/detail/currency?period=daily
Start key #1: <td class="cell">:United State Dollar</td>
Start key #2: <td class="cell_c">
Regular expression:
End key: </td>

Click Done to save settings.

On the New task page, specify data in the Notifications section and click on the Save profile button.

If you need to create a task that will synchronize subscribers from Active Directory, select the appropriate option in the Active type list. The AD Profile list appears. Select the desired profile in the list. If the list does not contain the desired profile, move to Additional options → Integrations → Active Directory and create the required profile.

On the New task page, specify data in the Notifications section and click on the Save button to keep settings.

If you are a telecom provider and you want to automatically charge periodic services, you should select the Charge periodic services option in the Active type list. You can create the task that will be applied for specific group of subscribers (customers). To do this, use the Source list and the Select subscribers group button, as this is described for case of the report generation above.

If you need to execute a program by schedule, select the Execute program option in the Active type list. The Path to the file and Arguments boxes appear. In the Path to the file box, enter the path to the program. If the program requires some parameters, enter them in the Arguments box. Specify data in the Notifications section and click on the Save button to keep settings.

If you need to execute some tasks simultaneously or in the specific order, select the Group of tasks option in the Action type list. The additional settings appear on the New task page as shown in Figure 4.16.6.

Figure 4.16.6

There are different group types which are listed in the Group type list:

• Independent chain. Each task in the group will be launched without analyzing the result of completing the previous task in the group.
• Dependent chain. Each task in the group will be launched only if the previous task was successfully completed.
• Independent chain with feedback. Starting tasks in a group is like the Independent chain option, but if any task was unsuccessful, an attempt will be made to execute it again. The number of attempts to complete tasks is configurable. If all attempts are exhausted, but the task was never completed successfully, then the next task in the list will still be launched.
• Dependent chain with feedback. This group is like the Dependent chain option, but if execution attempts are exhausted and the task was not completed successfully, then the next task in the list will not be executed. The execution chain stops.
• Run all together. All tasks of the group will be launched simultaneously in different threads, without a queue for their execution.

Select the desired option.

In the Number of attempts to rerun task box, specify how many times the task can be retried if the previous attempt was unsuccessful.

Click on the Add button near the Tasks included in the group label and add the desired tasks. You should create the desired task in advance.

Specify data in the Notifications section and click on the Save button to keep settings.

If you need to send a message to subscribers (customer), you should select the Newsletter option in the Action type list. In this case the New task page will have some specific positions which are shown in Figure 4.16.7.

Figure 4.16.7

You can choose the desired group of subscribers for which the mailing will be executed. There are options to do this. Yu can specify the required SQL query, select subscribers from the list, or select the desired group of subscribers. Choose the desired option in the Source list.

The rest of the steps are like those described for the task of generating a report.

In the Mail subject box, type a subject.

In the Mail text box, type a text. The box allows you to use HTML.

Specify data in the Notifications section and click on the Save button to keep settings.

To install, start, stop or uninstall the Tariscope Tasks services, select in the Tariscope menu: Tariscope Tasks → Service management. The Tariscope Tasks page is displayed as shown in Figure 4.16.8.

Figure 4.16.8

By default, the service runs the user account of LocalSystem. To change the account, turn off the Manage service switch and specify the User account and Password.

To install the service, click on the Install service button. In the Service status position the value of "Stopped" is displayed. The Install service button is replaced to the Uninstall service button and the Run service button is active.

To start the service, click on the Run service button. In the Service status position the value of "Running" is displayed. The Run service button is replaced to the Stop service button. The Uninstall service button is inactive.

After the service was started, we recommend clicking on the Open service log button or select the Service log item of the menu and make sure there are no errors. If the log contains errors, stop the service, return to the settings. After that, try to start the service.

To stop the service, click on the Stop service button. The Stop service button is replaced to the Run service button, and the Uninstall service button is active. The Service status position displays "Stopped".

To uninstall the service, click on the Uninstall service button.

In some cases, the service may be stopped by Windows. If you wish, the service is automatically started in these cases, turn on the Automatic restart switch.

Previous page   Next page

Contents of "Tariscope 4.5.x. Administrator's guide"

Tariscope 4.5.x. Administrator's guide

Chapter 5  Tariscope service

5.1 Control over Tariscope work

5.1.2 Monitoring Call Information

Call receiving monitor (Tariscope Watchdog)

Tariscope Observer services collect calls data from telephone systems into the Tariscope system. These services support a wide variety of data sources from which information is obtained, for example, TCP server, TCP client, and the like. That is, there are several objects in the call data collection chain. These are the following objects: telephone system, IP network (in most cases), a computer with Tariscope Observer, an operating system on this computer and the Tariscope Observer service. Each of these objects can fail, which will stop the calls data collection.

If it is important for you to promtly receive calls data, then you should constantly monitor the status of the system for receiving this data. Since the intervals between calls in the system can be different at different times of the day, as well as on different days of the week, the solution to this problem is not easy.

To solve this problem, a Call Monitoring subsystem or Tariscope Watchdog has been added to the Tariscope system. This system is based on artificial intelligence. For its work, it is desirable to have already received calls information for a period of 3 - 6 months. Tariscope Watchdog will analyze this data and calculate the interval through which calls are usually made at a particular hour of a day on a particular day of the week. If you still do not have the collected information about calls, then the Tariscope Watchdog can still be used. Every day it will process the data on calls and adjust the model of their arrival.

The Tariscope administrator must configure the Tariscope Watchdog system based on his needs. And if this system detects that there have been no calls for a period longer than that set during setup, then it will send a message about this event to the administrator or another person specified in the settings. Therefore, the administrator can quickly identify problems with receiving call data and fix them.

For the Tariscope Watchdog subsystem to work, the software must be installed on the Tariscope server: .NET Core Desktop Runtime 3.1.10 x86.

To configure Tariscope Watchdog, select in the menu: Smart Assistant. The corresponding page appears where you need to click on the Call monitoring button. The Tariscope Watchdog page appears, an example of which is shown in Figure 5.1.2.1.

 Figure 5.1.2.1

On this page, click the Open settings button. The Settings page appears, an example of which is shown in Figure 5.1.2.2.

 Figure 5.1.2.2

In the Previous period (in months) box, specify the required value. In this case, the Tariscope database must contain calls for the specified period. The more you select the period, the more accurate the model will be. But you must bear in mind that if you have chosen a large previous period, then the processing of this data may take some time. Usually 3-6 months is enough if the call process in your company does not differ significantly for different months of the year. If the Tariscope database does not yet contain information about calls, but it does not matter what you specify in this box.

Select the desired value from the Separation of the day list. The shorter the interval, the more accurate the model will be, because it will be generated for each such interval, taking into account other settings as well. But in this case, building the model will take more time. There are the following options:

• 30 minutes.
• 1 hour.
• 2 hours.
• 6 hours.
• 12 hours. 
• Do not split.

Enter the appropriate values in the Start of working hours and End of working hours boxes.

In the Weekends and holidays section, you must specify such days. This setting allows you to create a model for receiving calls depending on the type of day: workday, weekend, or holiday. By default, the weekend is Saturday and Sunday. In order for the system to know the days that are considered holidays, you must select in the list the Source of holidays of the telecom operator that you assigned to routes or gateways of your telephone system and for which you assigned a list of holidays.

If your Tariscope database for some reason may not have data on calls for some days that will be used to create a model, then to create a more accurate model, it makes sense not to take such days into account. To do this, specify the number of days in a row that should not be taken into account if there are no calls in the database for these days, in the Skip empty days in a row box. If your company does not work on weekends and does not have any calls on these days, then for the correct setting of the model in this position, you should specify 3 as the lowest value.

To take into account the parameters calculated in the model, turn on the Is adaptive operation interval switch. In this case, the period of the warning system response depends on: ·

• a value calculated for a specific time period;
• a value of the Minimal operation interval box;
• a value of the Deviation threshold.

Let us give an example. Suppose that in the calculated model it is assumed that on a working day from 10:00 to 11:00, calls are made every 5 seconds. If the Is adaptive operation interval switch is on, and the Deviation threshold is 40%, and the Minimal operation interval box contains the value 0, then the notification system should be triggered when there was no call for more than 7 seconds (5 sec. + 5 sec. * 0, 4). This setting means that Tariscope Watchdog will turn on every 7 seconds. Firstly, it will lead to a load on the processor of the Tariscope system server. Secondly, in the event of some unforeseen failures, for example, in the IP network for only 8 - 10 seconds, you will receive notifications about the delay of receiving data. It will be something like a false positive. To avoid this situation, use the Minimal operation interval box.

The Minimal operation interval box is used to indicate to the Tariscope Watchdog system, after what minimum time interval the system should check for new calls in the system. For example, if you set the value to 300 seconds, then for the above example, the system will check for new calls not every 7 seconds, but every 300 seconds. This reduces the load on the server processor and makes it possible to prevent the frequent triggering of the notification system when the interval between calls is small. Specify the value that is most optimal for your company in this box.

In the Deviation threshold position, set a value in percent, such that if the interval exceeds the one calculated by the model plus the specified deviation, the notification system will be triggered.

If Tariscope works with several telephone systems, and each of them has specific traffic, then enable the Analyzing each equipment separately switch. The system will create a call receipt model for each telephone system.

If you do not want to include the specific telephone system in Tariscope Watchdog, for example, the one into which calls are imported once a month from external files, then click on the Unused telephone systems link. A window appears with a list of all PBXs specified in Tariscope. Select the checkboxes opposite those that you do not need to consider when creating the model.

Tariscope has the ability to receive CDR (SMDR) data using FTP, SFTP protocols or, for example, from a folder. In these cases, the data arrives in the files at some interval. In order to take into account this interval and there were no false positives, turn on the CDR/SMDR receiving interval switch and set the value of the file receiving interval in the Interval in seconds box.

To track the work of the Tariscope Watchdog subsystem, its log is used, which can have a different level of detail. Select the required log detailing from the Log level list. The least detailed level is Status. The most detailed level is Debug.

To generate notifications, the first thing that is needed is the settings of the corresponding subsystem in Tariscope, which is performed on the Notifications and mailing page. If the settings are made there, then turn on the Notifications switch (Figure 5.1.2.2).

In the Working hour notification type list, select the required value:

• Once. The message will be sent only once even if the subsystem is triggered several times in a row.
• Each time. The messages will be sent each time the Tariscope Observer subsystem is triggered.

Select the required value from the Non-working hours notification type list.

Determination of working and non-working hours is carried out according to the settings specified in the positions Start of working hours, End of working hours, and Weekends and holidays.

By default, the notification is sent by e-mail to Tariscope administrators. It is possible to send such notifications to other email addresses. To do this, enter email addresses separated by semicolons in the Email box. In the Mail subject box, specify the message subject. For example, "Tariscope. There are no calls."

It is possible not to specify anything in the Mail text box. The {body} template will be replaced by the system with information about exceeding the interval between calls. You can add some information in the box.

To save the settings, click the Save button. After that, the Tariscope Observer page will be displayed (Figure 5.1.2.1).

Tariscope Watchdog runs as a Windows service. Therefore, it must be installed and start. By default, this service is offered from the LocalSystem system account. You can change this account to another. The main thing is that this account must have rights to access to the Tariscope database.

To use another account, turn off the Manage service switch.

In the User account box, enter the required account, and in the Password box, enter the corresponding password.

To install the service on Windows, click the Install service button. This button will change its name to Uninstall service, and the Run service button becomes active.

To start the service, click the Run service button. If the service starts successfully, this button changes its name to Stop service, and the status of the service should change to "Running", the Uninstall service button becomes inactive. If the service fails to start, click on the Open service log button, and analyze the errors.

To stop the running service, click the Stop service button. It will change its name to Run service, the status of the service will be “Stopped”. The Uninstall service button becomes active.

To uninstall the service, click the Uninstall service button. In this case, the Run service button becomes inactive, the service status is "Not installed".

In some cases, Windows can stop the running service. To have the service automatically resume its work, turn on the Automatic restart switch.

 Previous page   Next page

Contents of "Tariscope 4.5.x. Administrator's guide"

Tariscope 4.5.x. Administrator's guide

Chapter 4  Tariscope configuration

4.15. Call export and Hotel systems

Tariscope can provide information about guests' calls to the hotel system. If you wish to use Tariscope together with a hotel system or export the call information to another system, in the Tariscope menu, select Additional options → Integrations → Hotel systems. The Hotel systems page appears as shown in Figure 4.15.1.

Figure 4.15.1

Click on the Open settings button. The Hotel systems page will be as shown in Figure 4.15.2.

Figure 4.15.2

In the External system connection type list, select the desired option. There are the following options of the connection:

• Rlogin client. Information from Tariscope is sent to an external system using Rlogin client.
• Serial port. Tariscope is connected to the hotel system through a serial port.
• SSH client. Tariscope is connected to the hotel system using SSH protocol.
• TCP/IP client. Tariscope is connected to TCP/IP server of the hotel system.
• TCP/IP server. Tariscope works as TCP/IP server, to which the hotel system is connected using TCP/IP client.
• Asterisk AMI. Tariscope uses the Asterisk Manager Interface to interact with Asterisk.

Click on the Configure button to setup the connection parameters. The Settings window appears which is specific for each connection type.

The configuration of any type of connection is the same as described in section for the Tariscope Observer configuration. Execute settings in the window and click Save.

If you need the Call export service is connected to the hotel system at once on the service start, turn on the Open external system connection on start switch. By default, the switch is on. If the switch is off, the time of connection will be defined with the script.

Tariscope can interact with any hotel system if you know the interaction protocol with the system. The implementation of this protocol is executed in the script, written in the language of VB Script or C# (Microsoft). Tariscope contains several predefined scripts:

• hotel-uni-reference5.vb,
• print.vb,
• savefile.vb.

These scripts are located in the folder: ...\Program Files (x86)\SoftPI\Tariscope\CallExport\CallExport

The hotel-uni-reference5.vb script is intended to interact with a hotel system using UNI interface. This interface can be used to interaction with the following hotel systems: Opera, Fidelio v.8 (Oracle, Micros), epitome PMS (Libra Hospitality) and others.

The print.vb script allows to print calls information on a local or remote printer.

The savefile.vb script saves calls data in a file.

Select the desired script in the Export script list. If you want to change the selected script, click on the Edit button. The Edit window appears. Change the script and close the window.

If these are no scripts that suit for your hotel system, you can develop the script yourself or contact the technical support of SoftPI.

Select one of the following levels of logging of the service, where every next option increases the level of details:

• Status.
• Critical error.
• Error.
• Warning.
• Information.
• Advice.
• Debug.

The log is needed to identify the causes of malfunction of the Call export service. If you using the log have not identified the cause of incorrect operation of the service and resolve this problem, send the log to the technical support service of SoftPI. The log file is in the folder: ...\ProgramData\Tariscope and has a name: callexport.log

To save settings, click on the Save icon on the toolbar.

Return on the Hotel systems page shown in Figure 4.15.1.

To install the service, click on the Install service button. In the Service status position the value of "Stopped" is displayed. The Install service button is replaced to the Uninstall service button and the Run service button is active.

To start the service, click on the Run service button. In the Service status position the value of "Running" is displayed. The Run service button is replaced to the Stop service button. The Uninstall service button is inactive.

After the service was started, we recommend clicking on the Open service log button or select the Service log item of the menu and make sure there are no errors. If the log contains errors, stop the service, return to the settings, and validate the settings and script. After that, try to start the service.

To stop the service, click on the Stop service button. The Stop service button is replaced to the Run service button, and the Uninstall service button is active. The Service status position displays "Stopped".

To uninstall the service, click on the Uninstall service button.

Previous page   Next page

Contents of "Tariscope 4.5.x. Administrator's guide"