This documentation supports the 21.3 version of BMC Helix Innovation Studio.

To view an earlier version, select the version from the Product version menu.

Verifying the knowledge base synchronization

After you run the synchronization job, you can verify the synchronization in BMC Helix Innovation Studio. 

Before you begin



To verify the synchronization

  1. Log in to BMC Helix Innovation Studio and click Administration
  2. Select Knowledge Management > Knowledge Sync.
    On the Knowledge Sync page, the Job Status column specifies one of the following statuses of the sync job:
    • Completed successfully—All articles were synchronized
    • Completed with errors—Only some articles were synchronized
    • Failed—Articles were not synchronized

The following image shows an example of the sync job status: 


Troubleshooting

You can view the logs for each synchronization job. 

  1. Log in to BMC Helix Innovation Studio and click Administration
  2. Select Knowledge Management Knowledge Sync
  3. From the logs column, click the job for which you want to view the logs. 
  4. To view the log details such as ID, created date, and log level, click  and select the check box for the detail that you want to view. 
    The following image shows sample logs:

Typical reasons for synchronization job failure

  • Connectivity failed between BMC Helix Innovation Studio and BMC Helix Knowledge Management by ComAround
  • Incorrect authentication in BMC Helix Knowledge Management by ComAround
  • Incorrect mapping of fields from custom knowledge template with BMC Helix Knowledge Management by ComAround fields might not synchronize the custom knowledge articles correctly. 

Known issues that cause synchronization job failure

(Fresh deployment of version 21.3) A 404 error is returned during the knowledge synchronization from BMC Helix Business Workflows 

A 404 error might occur because the record definition BWF in the BMC Helix Knowledge Management by ComAround folder exists with an invalid ContentId in com.bmc.dsm.comaroundMigration:Migration Folder Mapping.

To resolve this 404 error, perform the following steps:

  1. Log in to BMC Helix Innovation Studio and click Administration

  2. Select Knowledge Management Knowledge Sync

  3. From the table that lists running or completed sync jobs, delete any existing records.

  4. Run the synchronization job again.


Where to go from here

ActionReference

If you want to terminate the synchronization job

Terminating the synchronization job

Was this page helpful? Yes No Submitting... Thank you

Comments