Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Summary

This article provides information on the EngageIP Windows Services that EngageIP installs and how to troubleshoot issues with these Services.

...

  • Executes enabled Bill Runs (if there are multiple branded owners, there may be multiple configured bill runs in the system, one or more per branded owner)

EngageIP Event Manager

On a configurable periodic interval the EngageIP Event Manager

...

Executes workflow items based on triggers

...

is triggered to process:

  • Entity Events

  • Workflow Events

After both of these activities are processed the EngageIP Event Manager Service goes back to sleep and waits for the next timer trigger to wake it up again.

EngageIP File Mover Service

...

  • Collector for BroadWorks or Sansay softswitches

  • Runs in parallel with the rating [glossary_exclude] service[/glossary_exclude]

  • Observes defined fraud criteria (e.g. long distance calls)

  • Sends fraud report results via email (if this option is configured)

  • For more information see the Fraud Reporting Overview article

EngageIP Job Service

Polling for jobs occurs every 2 minutes (120 seconds). As of EngageIP 8.5.25.2 this setting is configurable.

  • Sends emails during the day including ticket emails, bulk report emails, credit card expiry reminders, etc.

  • Executes ticket functions (ticket escalations, updating tickets after pulling data from emails, etc.)

  • Executes Event Manager tasks

  • Applies price plan pricing (ApplyEffectivePricePlans job)

  • Cancels expired prepaid user-packages (CancelExpiredPrepaidPackage job)

  • Runs Concurrent Call Report requests (ExecuteConcurrentCallReport job)

  • Evaluates the 'Change User Status' components on accounts and changes the account status if the change status date has been reached (ExecuteScheduledUserStatusChanges job)

  • Evaluates the 'Change User Package Status' components on accounts and changes the user package status if the date has been reached (ExecuteUserPackageStatusChange job)

  • Runs real-time 'Bill Account' billing in the background as per logged in users request

  • Executes Resource Module functions (create reorders, expire resource holds)

  • Performs logging and temp directory cleanup

  • Generates and delivers Snapshot invoices (RunSnapshotInvoices)

  • Renews contracts that have reached the renewal date (UserAttributeContractRenewals job)

  • Creates UDRBillers and UDR Buckets for new periods (UDRBillerBulkInsert job)

  • Generates reports for reports that have been scheduled

...

Job Polling Frequency

As of EngageIP 8.5.25.2 you can set how often the Job queue is polled for queued jobs (default is 120 seconds). To configure the polling frequency:

  1. Access the EngageIP [glossary_exclude] server [/glossary_exclude] directly/via remote access

  2. Navigate to the EngageIP\Services directory

  3. Create a file called JobService.exe.config

  4. Edit the file and add the following content with your polling value (in seconds)

    Code Block
    <?xml version="1.0"?>
        <configuration>
            <appSettings>
              <add key="pollingDelayInSeconds" value="30"/>
            </appSettings>
    <startup><supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5"/></startup></configuration>
  5. Save your changes

  6. Restart the EngageIP Job [glossary_exclude] Service[/glossary_exclude]

General Service Troubleshooting

...

  1. To confirm, login to SQL using the EngageIP user and password for SQL, then paste this into a new query window:

    Code Block
    USE master;SELECT counter_name ,cntr_value,CAST((cntr_value/1024.0) AS NUMERIC(8,2)) AS Gb FROM dbo.sysperfinfo WITH (nolock) WHERE counter_name LIKE '%server_memory%';
    

...

  1. Run the following select to confirm that services heartbeat dates are being updated in the engageipservice table. This indicates the service is actively communicating with and updating the database:

    Code Block
    SELECT * FROM engageipservice

...

  1. Reboot the webserver to confirm whether the UI is able to start reflecting the service status.


This should return values, otherwise it will return the actual error for you, in this case its a permissions based issue.

...

  1. Open a command prompt window

  2. Surf to the services folder in EngageIP

  3. Type the name of the [glossary_exclude] service [/glossary_exclude] and append the word standalone with two dashes. See image for example

Doing the above will run the [glossary_exclude] service [/glossary_exclude] but in the command window so you can see all the processes its executing and you can spot any errors that it may be encountering

Info

Note: your EngageIP installation path may differ from the path shown in the image below.

...

Unhandled Exception: HttpListenerException

...