The Importer is located with the DAM installation files in a separate zip file.
- Create a folder where you want the app to be. It's recommended to use an "non-program-files" location to avoid windows rights management issues or at least to set path configurations to a unc path outside. It's required to have write access to all configured directory paths.
- Unzip the contents to the folder.
- Run VersionSearches.sql against the DAM db in MSSQL Studio.
- Optional: Run DamImporterMatchSearchByAssetid.sql if or when you need a match search that matches assetId. This can also be done at a later time. The default DamImporterMatchSearch matches against a string metafield containing filenames.
- Set application level configuration in Importer.exe.config (app mode) and/or ImportService.exe.config (service mode). See "DC5.0.0 Application configuration".
- Set import level configuration in xml files in the subfolder ImportConfigs. See "DC5.0.0 Import configuration".
- Set metadata level configuration if needed.
- Install as a service if you need. See section below. Set the service to start automatically.
Install as a Windows service
To install the Importer service, please do the following steps:
First of all, enter a command prompt or PowerShell prompt, and navigate to your import service folder.
Run these two lines. The first to change to the correct hard drive - and secondly to navigate to the root of the importer
Firstly:
[driveLetter]:
e.g.
D:
Secondly:
"[driveLetter]:\[pathToImporter]"
e.g.
"D:\Importer"
Now that you're in the correct folder within your chosen command prompt, you can now run the service installation one-liner:
sc create [ImportServiceCustomName] binPath= "[driveLetter]:\[pathToImporter]\ImportService.exe" DisplayName= "[importServiceNameWithSpaces]"
e.g.
sc create ImportService binPath= "D:\Importer\ImportService.exe" DisplayName= "Import Service"
App mode vs. service mode
Running the Importer as service works essentially the same as in app mode. The differences are highlighted in the following table:
Feature | App mode | Service mode |
---|---|---|
Continous monitoring | No | Yes |
Halt on fatal exception 1) | Yes | No 2) |
1) A fatal exception in this context means an error the Importer does not know how to safely proceed with. Specifically with data errors or data parse errors the Importer will take a safe approach and not do anything rather than set wrong metadata.
2) As a service if FailureDirectory is set the involved files will be moved and not retried. If not moved they will be retried.