If the entity set sync fails, it will present an error message showing the sync stage (import, export, creating entity set, and so on) where the error occurred; and if it stopped due to a particular entity, the error will provide the entity name, the object type, and the operation name.
Error importing: (WIN-T67T10LP8GM_1536340605178) com.supportwizard.utils.ejb.SWEJBException: Unexpected Error; nested exception is: java.lang.AssertionError The entity on which the error occurred: Object type: Subtype Name: company Operation: CREATE |
However the error messages may be inadequate to troubleshoot the real cause of the error. This could be because:
In these cases the administrator should investigate the server logs for a better idea of the cause of failure.
To avoid the errors that can arise during sync, see the Sync Preparation section here.
Entity set sync updates a set of knowledgebase objects that are selected in the sync configuration. For more information, see Entity Set Sync. The sync process is split into smaller components - Sync Updaters - each of which updates a particular object; for example tables and fields, saved searches, and so on. The update might be prevented by an unsatisfied dependency, in which case the updater will update what it can, and return the corresponding status - "In Progress", or "Stalled" if nothing could be updated. If any updates by other updaters are done, the updater will be invoked again because other updaters might have created or updated the necessary dependencies. The process is repeated until either:
|
The steps recommended below will help you troubleshoot the relevant error information or receive technical assistance.
The entity set sync logs, primarily sync.log, can be found at <Installation_directory>/jboss/server/sw/log/sync.log
.
In some cases sync issues can be found by other activities, so it could be helpful to use the server.log files at <Installation_directory>/jboss/server/sw/log/server.log
.
Sync is sensitive to concurrent database level operations. Please avoid running a KB import/export/deletion or concurrent syncs on the same server while attempting to import an entity set. |
If you want to search through the log history, use the date/timestamped files (sync.log.YYYY-MM-DD
, server.log.YYYY-MM-DD
).
Find the log entry with the error message that was shown in the sync result message - by text searches or timestamp - and check the log entries just above this message. You can often find helpful information here, including:
Information relating to what the sync was trying to do at the moment of failure:
DEBUG [ard.modularity.UpdatePlan] Performing iteration 0, plan size is 19 2017-07-29 16:48:12,699 INFO [.modularity.ExportProcess] Running <span class="SIBoldMark">Rules updater</span> (step 6 out of 19) 2017-07-29 16:48:12,702 DEBUG [ers.EntityPairUpdaterBase] Analyzing EntityPairUpdaterBase::com.supportwizard.modularity.updaters.RulesUpdater for source Demo(2) and target Carrier KB(3) |
If this information is still not enough, you can try to review the logs further.
If the server log entries have information about an entity, it is recommended to check the sync log entries for occurrences of errors by the UUID or name of the entity. It is possible that some other error occurred earlier which is the real cause of the issue. For more information see UUID Recognition and Sync Conflicts.
Server logs contain entries with different levels of priority (debug, info, warn, or errors). In most cases, you should look at the log entries with WARN/ERROR priority levels. |
If you need further technical assistance, you can contact the support team by submitting a ticket with the attached sync.log and server.log files: Get Support.
grep -e "text_to_search" sync.log*
- returns all sync.log.* files that contain the text_to_search.vi sync.log
- opens the sync.log file for viewing.tail -nXX sync.log
- displays the last XX lines of the file.Related articles |