Schedule background services
This section provides information about the background services available in the system, and instructions on how to enable and schedule them. It also provides guidelines for scheduling background services to optimize resource use and system performance.
Available background services
Service name |
Description |
---|---|
Agile Data Sync Service |
|
ALM Startup |
Ensures that the quartz scheduler that synchronizes OpenText PPM and Service Manager is running. |
Applet Key Cleanup |
Periodically removes old records from the database table KNTA_APPLET_KEYS. (These are temporary, system-generated keys used for one-time access to the system—for example, if a user wants to open the PPM Workbench.) |
ChatBot Notification Service | Enables Chatbot to send notifications on Microsoft Teams. |
Commands Cleanup |
Periodically removes old records from the prepared commands tables. |
Concurrent Request Watch Dog |
When Deployment Management submits a concurrent request (job) to Oracle Apps, this service polls Oracle to determine what state the job is in, and when it has completed. |
Cost Rate Rule Update |
After it checks for changes to cost rules and cost factors, this service:
|
Cost Rollup |
Cost rollup service asynchronously rolls up planned and actual costs (entered manually or pulled from time sheets) from leaf tasks to root tasks in workplans, and then pushes the data to the financial summary. In addition, the cost rollup service rolls up actual costs from time sheets to financial summaries for programs, proposals, and assets. For programs and projects, the following changes trigger line insertion into the pending rollup table.
Note: For programs and projects, the following changes do not trigger line insertion into the pending rollup table but are considered in the next service run.
|
Debug Messages Cleanup |
Periodically removes old records from the KNTA_DEBUG_MESSAGES database table, which can collect a lot of temporary data. |
Directory Cleanup |
Cleans up files in the dynamic content directory. The PPM Server generates these files and writes temporarily to the dynamic content directory so that they can be accessed over the Web. After the scheduled number of days, the files are deleted because they are no longer necessary. |
Document Cleanup |
Periodically checks for documents that are no longer attached to a OpenText PPM entity, and removes those it finds from the OpenText PPM file system. |
A Time Management service that periodically checks to determine whether the resource assigned to approve a timesheet has changed. |
|
External Request Info Sync Service |
Periodically synchronizes the field values between PPM requests and their mapped agile entities. |
External Work Plan Sync Service |
Periodically synchronizes user stories in all sprints from agile management systems to PPM tasks. |
Exception Rule |
Periodically checks to determine whether active projects are running on time. Determines if and when task exceptions are recalculated. For more information about this service, see the Project Management Configuration Guide. |
Field Security Pending Denormalization |
Because managing field-level security is computationally expensive, whenever the security settings at the field level are updated, this service performs calculations that ensure live security checks in performance. |
Financial Metrics Update |
Calculates net present value (NPV) and nominal return for Financial Management. |
Financial Summary Rollup |
Calculates rollups of financial information, including forecast and actual costs and benefits (monthly data) and approved budgets (annual data), for the following:
The following events, performed by manual entry or by another background service such as Cost Rollup or Web services, trigger this rollup service:
|
FX Rate Update |
Recalculates cost after financial exchange (FX) rates change. |
Interface Tables Cleanup |
Periodically removes old records from the database open interface tables. |
Logon Attempts Cleanup |
Periodically removes old records from the KNTA_LOGON_ATTEMPTS database table, which contains records of all logon attempts. |
Mobile TM Approval Service |
Syncs approved or rejected time sheets and time sheet lines between the mobile and desktop clients, ensuring that time sheet and time sheet line statuses are synced. |
Mobility Access |
Enables OpenText PPM users to process approval workflow steps from desktop email or a PDA device. Resources working outside of an office or without VPN access can act on approval workflow steps without having to first log on to OpenText PPM. For information about OpenText PPM Mobility Access, see the Demand Management Configuration Guide. |
Notification Cleanup |
Deletes rows (older than the current date minus the number of days set for the notification cleanup service) from the KNTA_NOTIF_TXN_PARENTS table in the database. The service then deletes all child rows from the KNTA_NOTIF_TXN_DETAILS, KNTA_NOTIF_TXN_COLUMNS, and KNTA_NOTIF_TXN_RECIPIENTS tables. |
Notification |
Enables the notification service. You can use this parameter to turn off notifications for copies of production instances being used for testing, and turn them on again when the system goes to production. |
Pending Assignments Table Cleanup |
Periodically checks for duplicate rows in the |
Pending Cost EV Update |
Asynchronously applies external updates to the Pending Cost EV Updates service when updates cannot be made immediately. |
Pending EV Updates Table Cleanup |
Removes duplicate rows in the Pending EV Updates table. |
Performance Log Cleanup |
Deletes data from the Performance Log table |
Program Health | Automatically updates program health indicators. |
Project Health |
Automatically updates project health indicators. |
Project Planned Value Update |
This service handles synchronization between requests (as cases of blocking predecessors) and between requests and tasks if a request is updated and the target entity is locked. |
Project Quality Sync Service |
This service synchronizes quality KPI data from ALM releases to the mapped PPM tasks. When it runs, it checks whether all the PPM task - ALM release mappings have been synchronized in the current day. If yes, it does not sync data for the existing mappings. If new mappings are detected, it syncs data for the new mappings only. That's to say, even if the service is set to run more than once in a day, it syncs data for each existing mapping only once a day. |
Reference Update |
Automatically updates references between entities. |
Request Status Export |
Determines whether any request status values were changed since the service last ran. If status values have changed, and if the updated requests reference remote entities, then the status values for the referenced remote entities are updated. |
Resource Pool Rollup |
Performs resource pool rollup (between child and parent resource pools.) |
RM Notification |
Resource pool and staffing profile notification service. This service must be enabled in order to send notifications to staffing profile managers, resource pool managers and resources. For more information, see the Resource Management User Guide. |
Service to update the Projected Total values for Budgets and Staffing Profiles |
Periodically updates the projected totals for budgets and staffing profiles. |
Shared Links Cleanup Service |
Periodically removes the shared link records from the ITG_UI_VIEW_SETTINGS table that have been present for 7 days. |
Shared Lock Cleanup |
Cleans up any entries left in the shared lock table after a PPM Server crash. |
Staffing Profile Financial Summary Sync |
Synchronizes staffing profile data with financial summary data at a configurable interval. You can schedule the service so that synchronization does not happen automatically whenever changes are made to a staffing profile or a budget. If updates are frequent, delaying synchronization can help preserve system performance. |
Staffing Profile Period Sum Update |
Rolls up actuals from time sheets and projects/tasks to staffing profiles. Whenever a time sheet or project/task is updated, the actuals are displayed on the linked staffing profile only after this service runs. |
Synchronize Documentum Folder/Security Group Name |
The Document Management module uses OpenText PPM entity names (project names or request type names) to name the folders and security groups in the EMC Documentum repository. As those entity names change in OpenText PPM, this background service picks them up and applies the changes to associated items in the Documentum repository. For more information, see the Document Management Guide and Reference. |
Task Actual Rollup |
Determines if and how frequently periodic task actual roll-ups are calculated. Asynchronously rolls up actuals provided through Time Management or the My Tasks portlet. For more information about this service, see the Project Management Configuration Guide. |
Task Scheduler |
Determines if the work plan schedule health is recalculated and the frequency with which work plan schedule health is recalculated. For more information about this service, see the Project Management Configuration Guide. |
Time Sheet Notifications |
Enables notifications to be sent on time sheets. |
TM-PM Sync |
Synchronizes time sheet updates from Time Management to project work plan tasks in Project Management, at a configurable interval. Each time the service runs, it sends a message to the queue for each work plan that must be synchronized with time sheets. The service ensures that roll-ups for each work plan can be accumulated and updated once, if necessary, per work plan. |
Work Item Pending Assignment |
Periodically populates the KRSC_ WORK_ITEM_ASSIGNMENTS table, which is used for resource work load information. The service retrieves the actuals information from the request. |
Work Item Pending Update |
On the PPM Server, periodically calls KRSC_PROCESS_PENDING_UPDATES.Patrol to process updates to work items. |
Workflow Timeout Reaper |
Scans all active workflow steps to verify that they have timed out according to the settings for the step. |
Run services on multiple nodes
You can run multiple instances of the same type of service concurrently to process different entity IDs on the same or different nodes in a server cluster.
For recommendations on how to schedule and run background services, see Minimize the performance impact of running background services.
Enable and schedule background services
You can enable and schedule the background services through the standard interface.
To enable and schedule background services:
-
Click the Administration button in the masthead.
-
From the Administration menu, click Sys Admin > Schedule Services.
-
Click the table row that displays the service you want to enable, disable, or schedule.
You cannot modify the typical load values which are assigned to the services based on extensive testing and feedback from the field. Light services are short-lived with low resource consumption. Heavy services take longer to run and are more resource-intensive than light services.
-
To enable or disable the service, from the Status list, select Enabled or Disabled.
-
To select the type of expression to use to schedule the service, from the Schedule Type list, select either Simple or Cron.
If you use a cron expression to schedule a service, keep in mind that cron expressions take into account the
TIME_ZONE
parameter setting for the PPM Server on which the service runs. In a server cluster environment, servers can be running on machines located in different time zones. -
In the Schedule column, do one of the following:
-
To schedule the service using a simple expression, type a number in the first field and, from the list on the right, select the time unit (seconds,minutes, or hours.)
-
To schedule the service using a cron expression, type the expression in the text field. For detailed help on how to compose a cron expression, under the Schedule Type column heading, select the Help icon ( ).
The value you type in the Schedule field cannot exceed 40 characters.
-
-
For each additional service you want configure, repeat step 3 through step 6.
-
After you have finished configuring services, click Save.
Your changes take effect immediately after you save them. There is no need to restart the PPM Server.
If a service misses one or more of its scheduled runs because, for example, the PPM Server is shut down, the service is run as soon as the server is restarted.
We recommend that, if you have a server cluster configured, and there are nodes in the cluster that do not handle incoming user requests, you disable the nodes from running the OpenText PPM background service. For details, see Disable nodes from running background services.
Start background service on demand
You can manually trigger a background service to run immediately, regardless of its pre-configured schedule or whether it is enabled or disabled. However, you cannot trigger a service that is running.
We recommend that you manually start a background service only for the purpose of troubleshooting.
To force a background service to run immediately:
- Click the Administration button in the masthead.
-
From the Administration menu, click Sys Admin > View Service Audit Page.
- In the Service Audit Results page, locate the background service you want to run.
-
Click the square icon in the Is Running? column.
The status of the background service becomes "Running", unless the service run completes too fast. You can check if the service has run in the Service Audit Page.
- Click the background service link to check the running details.
See also: