Troubleshooting promotion process errors

This topic provides information about troubleshooting errors related to the promotion process.

Before you begin

The promote step pushes all the staging form records that are valid, either automatically or manually, to their respective target forms within the BMC Remedy ITSM applications, based on the option selected for each promote step within the job. Each promote step represents a data promotion for one staging form. This data must be validated without errors before it can be promoted in the validation step. If you selected the Create Only mode for the validate step, the related promote step creates new records only in the target forms. If you do not select the Create Only mode, the new records are created in the target forms and the existing records are updated.

If an article has multiple versions and the newest version is in a Draft state, the article with a version that is earlier than the newest version is promoted with a Published state. When articles with multiple versions are promoted, if the newest version is in the Published state, all the articles with a version earlier than the newest version is promoted with a Closed state.

Review the following topics related to the promote step:

• License checks
• Propagation
• Normalization and reconciliation for ITSM CI data loaded through Data Management
• Choosing automatic or manual promotion application preferences

Checking for errors in the promotion step

Check for promotion step errors in the following locations:

• Error Management console—Errors found on the staging forms are flagged. For details about fixing errors, see Managing data errors.
• ARerror.log—This log file lists errors that occur during validation and promotion.
• CAI Events form—Search for records with Return Code set to Error. The comments in Return Message indicate which error occurred.

Troubleshooting errors related to the promotion step stuck in the In Progress state

Issue symptom

The promote step stays in the In Progress state.

Issue cause

• Custom fields and selection of menu values in the target form are not mapped in the load form and in the job.
• Custom workflow on load forms are not coded properly.
• For bulk data loads, there are not enough threads to run the job along with other processes running on the server, such as escalations.
• Null values are mapped and pushed for fields that need a value.

Issue workaround

• For unique index errors, usually no action is required if this is the only error.
• For timeout errors (ARERR 92 and 93), since there are no retries in UDM, check the time and why the process timed out. Reload the data in a new job.
• See the recommended settings.
  
  

Troubleshooting Remedy AR System server or plug-in errors in the promote step

Issue symptom

The system captures any Remedy AR System server or plug-in errors that occur when the promote step is created for a job. Such errors are captured and displayed on the Promote step in the steps panel in a job record as a detailed error message.

Issue cause

If any Remedy AR System server or plug-in error occurs when data is being promoted in chunks to the target forms, the system processes the data chunk only up to the point of error. The remaining data in the chunk is not processed. The system then proceeds to promote the data in next chunk. The Promote step is completed with Status as Completed and Job Result as Errors Detected.

Issue workaround

The system administrator must first resolve the errors, export the data that was not promoted to a format of Data Management spreadsheets, and create a new job to promote the data.

For information about creating a new job see Creating a job and for information about running a new job, see Running a job.

Troubleshooting common errors

The following table lists the common errors and their workaround.