7.6. Monitoring Data Extraction

Once files have been uploaded to an EKM repository, EKM automatically begins working silently in the background to extract metadata from the uploaded files. You can monitor the progress of data extraction on the Data/Extraction Monitor page. The current or most recent data extraction is listed at the top of the file list window. The monitor also reports the status of an extraction (for example, Running or Completed), the percentage completed, the number of files involved, and the number of errors. You can sort the list of extractions by Name, Status, Percentage Complete and so on by clicking the corresponding column header in the file list window. You can also filter the list according to any of the available properties. For example, you could filter the list to show only those extractions with Running status. For more information, see Filtering the View.

The status of the extraction will update at regular intervals, but you can also refresh the status at any time by clicking the refresh button   on the toolbar.

Extractions remain on the Extraction Monitor page until you delete them. To delete extractions, select them in the file list window and then click the delete button   on the toolbar. By default, extraction objects are perishable and will be removed after 7 days. This setting is configured in the retention policy settings in WorkspaceConfig.xml.


Note:  While data extraction is in progress, an EKM User License will remain checked out for you until the extraction is complete, even if you sign out of the EKM web client.


Cancelling and Resuming Data Extraction

If an extraction is not yet complete, you can cancel it by selecting it on the Extraction Monitor page, and then clicking the cancel button   on the toolbar. Once the extraction has been cancelled, the Status column will show the warning icon   with a Cancelled status.

If you have cancelled an extraction, or it has failed for any reason, you can click the re-extract button   on the toolbar to restart or retry the extraction. EKM will attempt to extract data from those files from which data has not yet been extracted.

Viewing the Extraction Status of Individual Files

To view detailed information about an extraction, click on the extraction object on the Extraction Monitor page. A filter is displayed that reports the number of successful extractions, failed extractions, and the number of files that have not yet been processed. This is particularly useful in pinpointing files that have caused errors.

Selecting All displays a list of all of the files in the extraction monitor, and reports the current extraction status of each one. Selecting Not Processed lists the files for which extraction has not yet started. Selecting Succeeded displays the files from which data has been successfully extracted. Selecting Failed displays a list of files for which extraction has failed.

If data extraction fails you can try again by clicking the re-extract button   on the toolbar, and if that does not work, you can invoke data extraction manually using the Extract Data action. See Extracting Data On Demand for details.


Release 18.2 - © ANSYS, Inc. All rights reserved.