| 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
The File Mover Service moves files from a source directory to a remote directory. The service runs on a timer that is configurable through the app config along with all other settings. As of now this tool supports moving files in four ways FTP, Folder to Folder, SFTP, Email.
See the FileMover Service Configuration article for configuration details.
...
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
...
Real-time (pre/post) rating
Definable mediation processors which can be performed either pre or post rating
Minute bucket rating capabilities
For more information see the UDR Rating Details guide
Order of operations when the Rating service is started:
...
Allows syncing of user-package information between two installations of EngageIP
For more information see the Tier Sync Installation and Process Guidelines guide
EngageIP UDRBatchTax Service
Allows AvaTax and SureTax integrations to handle taxation in batches instead of calculating taxes on every transaction, improving system performance
The service config file (EngageIP\Services\UDRBatchTaxService.exe.config) allows you to configure the batch size, how frequently batches are sent for tax calculation and other settings
For more information on batch taxing see the AvaTax Integration article
EngageIP Webhook Service
Allows external applications to listen for events that are occurring within EngageIP
For more information see the Configuring Webhooks guide
Service Configuration Options
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:
Access the EngageIP [glossary_exclude] server [/glossary_exclude] directly/via remote access
Navigate to the EngageIP\Services directory
Create a file called JobService.exe.config
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>Save your changes
Restart the EngageIP Job [glossary_exclude] Service[/glossary_exclude]
General Service Troubleshooting
...
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%';
...
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
...
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.
...
Open a command prompt window
Surf to the services folder in EngageIP
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
...