Knowlege base

Blue's Enterprise 4 - Installation and Configuration

Article ID: 681
Last updated: 19 Jun, 2019
Applies from Application Suite 201x (any version)
to version Application Suite 201x (any version)

How-to install and configure Blue's Enterprise 4:

For best results, we recommend configuring Imagicle Billing performing the following steps in exact order in this exact sequence:

  • Install the Application Suite Setup package
  • The Setup will ask some general information and ask will you to execute Imagicle Billing Configuration Wizard
  • At the end of wizard,  login to the web interface and add users
  • Configure the PBX to send CDRs through FTP to the Application Suite server
  • Configure the Application Suite general parameters
  • Through the Administrative page check that all Imagicle Billing services are up and running
  • If you own a valid license, activate it using the License page, otherwise the Application  Suite will run in evaluation mode for 30 days.
  1. Right click on the setup file > Run as Administrator
  2. At the end of the setup click [ Finish ] to configure Blue’s Enterprise 4
  3. Configure the PBX Connection for the first SITE
  4. Select the connection according to the Brand and Model of the PBX.
    Enter the required parameters for the connection to acquire the CDRs.
  5. Click on [ Finish ] to end the configuration.
  6. Click [ New PBX ] to configure a new connection to another PBX or [ Next > ] to continue the configuration.
  7. Configure the new SITE.
  8. Select the Driver of your PBX Model.
  9. Choose the relevant option if you want to import the internal call or not.
  10. Select the Country and Local Area of the Site.
  11. Select a Tariff.
  12. Click [ Next > ] until you reach the end of the configuration.
  13. The firs SITE is configured. If you have more than one site you can configure here or Click [ Next > ] to finish the configuration.
  14. Click to Start > All Apps > Imagicle AS Administration to open the IAS Web page.
  15. Enter the Username and Password, by default admin / admin
  16. First click to Admin > User Management to create the new users for each devices or sync to your Active Directory.
  17. if you cannot sync the IAS to your AD and you want to enter all users manually with their First Extension Number the best practise is to:
    Click to ‘Create new user >>’
  18. Fill in all the necessary fields.
    Mandatory are the ‘Username’, ‘First extension number’ and ‘Enable Billing for the first extension number’.
  19. Click [ Add new user ] at the bottom of the page.
  20. The first user is created.
  21. Click [ Export as CSV ] to save the Users.csv file.
    Use this file as a template, modify it and add new users easily with Excel.
  22. Save the file with the same format CSV (MS-DOS)
  23. Click to ‘ Import users from CSV or TSV files >> ‘ to import it with the new users.

Using Billing and Reports

  1. Click to ‘Billing’ > Home to see the latest imported calls.
  2. Click to ‘Billing’ > Interactive Reports to use the available web reports.
  3. For each report it is possible to define a filter by clicking on 'Options'.
  4. Here an example of the 'Call List' report.
  5. Here the complete Blues’Enterprise 4 - User guide :
  6. Click to ‘Admin’ > System Parameters > SMTP Parameters to Configure the SMTP parameters to send alert email or the Scheduled Reports.
  7. From the Billing > Administrative Pages we have some tools to analyse the system and check for proper operation.
  8. This is the architecture of the importation of CDRs.
  9. The CDRs are sent by the PBX to the Application Suite server through the specific connection type of the PBX and dropped in a folder by the (Recorder) stores them in files with a standard format. A second service (Miner) reads the files, calculates call costs and stores the result in the database. Once the calls are written into the database, reports can be directly generated or scheduled through the web interface.
  10. Click to 'Service Manager' to Stop the ‘Blues Service Host’ which controls the others below services, Recorder, Miner and Scheduler.
  11. Click 'System Status' to have a panoramic view of the status of the proper operation and acquisition of calls from the different SITEs.

No calls or no recent calls displayed on Billy Blue's statistics

  1. Check if you've added all users with your extension in the Admin > User Management Page.
  2. Check if the calls was discarded.
    Click to Billing > Administrative Pages > System Status and click to ‘Show discarded calls’for the SITE that does not matter calls.
  3. If the description Error is:
    - Extension not configured, the user that made this call is not in the user list and must be added to be able to import its calls.
    - Cannot recognise call type, the driver is not correct for that CDR format or that string does not contain a valid import call.

  4. Click to ‘Show extensions not defined’ to view the list of extensions that have made calls but are not declared in the User List.
  5. You can add them from the Admin> User Management page to the limit allowed by the license and Reprocess Discarded Calls from the Billing > Administrative Pages, to import those calls
  6. If in the System Status no call was imported for the SITE you can check if the Recorder have imported the CDRs of the PBX configured.
  7. Click on ‘Show File’ in the Blue’s Recorder section.
  8. A new box show you the calls imported from the Recorder in to the SotricoSITx.txt file.
    If no calls are displaying on this popup you can make the advanced troubleshooting.

Advanced troubleshooting

  1. Click to ‘Billing’ > Administrative Pages > Service Manager and Stop the ‘Blues Service Host’ which controls the others below services, Recorder, Miner and Scheduler.
  2. Start Miner and Recorder manually by running these files with a double click:
  3. Check if the Recorder import the new CDRs
    and the Miner import the new calls.
  4. If you do not see recent calls in the Blue’s Recorder, try to check the PBX connection parameters.
    Verify that the Firewall or Antivirus allow to receive CDRs from the PBX.
  5. If the Miner discard all rows, try to select another available driver for your PBX from the ‘Imagicle Configure Blue's Enterprise 4’ > Site Setup.

    If you don’t solve with these information open support case here:
    and provide us the follows information:

  1. Open folder C:\Program Files (x86)\StonevoiceAS\Apps\BillyBlues\Engine
  2. Double click BluesInfo.exe
  3. Click [Next  >] and follow on screen directions
  4. Click [Save to disk] then save on the desktop 
  5. Open folder C:\Program Files\StonevoiceAS\Apps\BillyBlues\Engine\BluesrecPro\
  6. Open file Storicosite.txt
  7. Highlight the last bottom rows (containing today's and yesterday's call details) 
  8. Right click -> Copy and paste highlighted rows into a new txt file, then save it 
  9. Open Imagicle App Suite > Admin > Users management
  10. Click [ Export as CSV ] > Save As Users.csv
  11. Attach the following files to the support case opening page:, Storico.txt file and users.csv
Article ID: 681
Last updated: 19 Jun, 2019
Revision: 1
Views: 426
Print Export to PDF Subscribe Share
This article was:  
Prev   Next
Serial Connection not found in Application Suite XPL     How to reimport discard call at global level, for all PBXs and...