Implementing DFS functionality into DC
In order for Digizuite™ DAM for Sitecore (DFS) to work correctly, you need to create some DFS related configuration in the Digizuite™ DAM Center (DC).
Out of the box the DC does not have the configuration needed for this version of DFS to be functional.
Therefore, you need to do the following steps:
In the package of which your Digizuite contact person has supplied you, locate the package named "DAM for Sitecore installer X.zip" (where X is the version number of your DFS installation).
Go ahead and unpack this. In your newly unpacked folder, there should now be two files: "DFS.Installer.exe" which is the executable and "DFS.Installer.exe.config" which is the configuration file for the executable.
Please open up the config file in a text editor (Notepad++ is strongly advised for editing)
The file should look something like the following:
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.2"/>
</startup>
<connectionStrings>
<add name="db" connectionString="Server=yourserver;Database=yourdb_dam;User Id=youruser;Password=yourpw;"/>
</connectionStrings>
<appSettings>
<!-- Standard/Required -->
<add key="usingEmbeddedScripts" value="true"/>
<add key="timeoutInSeconds" value="1800"/>
<!-- Switch deciding whether to run Default Preview upload or not-->
<add key="DefaultPreviews" value="true"/>
<!-- Switch for generating searches -->
<add key="RunGenerateSearch" value="false"/>
<!-- Default preview parameters, ignore if DefaultPreviews = 0 -->
<add key="ApiUrl" value="http://localhost/dev/dmm3bwsv3/"/>
<add key="UserName" value="System"/>
<add key="Password" value="af4dff332e1b93a7c7ce8eb02a4cd396"/>
<!-- Usually these should not be changed. -->
<add key="VersionGuid" value="8A66CD0F-2C41-4E18-A0A0-2C97143D3854"/>
<add key="Availability" value="74A5A102-A310-4BB7-9E84-0B14C36436B2"/>
</appSettings>
</configuration>
You need to change the parameters in this file (the places where it says value="") to be the information of your system. (NB. parameters in this case are the key-value pairs seen in the file above)
Here's an overview of all the parameters in the file above - They all need to be filled out unless stated otherwise:
| Parameter | Description | Default | Example |
|---|
| Connectionstring | Parameter for the connection string to the DAM database | [Not applicable] | Data Source=yourserver;Initial Catalog=yourdb_dam;Persist Security Info=True;User ID=youruser;Password=yourpw;Connect Timeout=3 |
| usingEmbeddedScripts | Decides whether the embeded install scripts will be run or not. Usually this should be true | true | true |
| timeoutInSeconds | Sets the timeout on execution time on the install scripts | 1800 | 1800 |
| DefaultPreviews | Switch for whether DefaultPreviews should be setup or not (Setting this to true can result in a timeout in abnormally slow DC setups - this is the last thing the script executres, meaning that timeout only means that some default preview will not be in your DFS, which is a minor issue) | true | true |
| RunGenerateSearch | Determines if the DFS related searches are repopulated. Set this to true on all updates and new install. Only set it to false, if you only want the sql changes. | false | false |
| ApiUrl | The url for the DC's API | https://yoursite/dmm3bwsv3/ | https://dam.digizuite.com/dmm3bwsv3/ |
| UserName | The username of a DAM user with admin rights | System | System |
| Password | The user above's password in MD5 encoding (can be found in the Member table of the DAM database) | [Not applicable] | 4d85a9fe623b4d859db56a0c1360c8c8 |
| VersionGuid | If this is the first DFS installation you're doing (basically, you're not updating) do not change the default value. The guid for the root version of the DFS's Config Manager entry in the DC Config Manager (typically named Default). This can be found by navigating to System Tools → Config Manager → Digizuite™ DAM for Sitecore → Default and then pressing the menu icon in the top right side. | 8A66CD0F-2C41-4E18-A0A0-2C97143D3854 | 8A66CD0F-2C41-4E18-A0A0-2C97143D3854 |
| Availability | If this is the first DFS installation you're doing (basically, you're not updating) do not change the default value. Guid of metadatafield that controls publishing. | 74A5A102-A310-4BB7-9E84-0B14C36436B2 | 74A5A102-A310-4BB7-9E84-0B14C36436B2 |
Make certain that the admin user is correct
Lastly, when the above scripts have run, a user named sitecore/admin will have been installed on your Digizuite™ DAM Center (DC). This user's password is default b like the user that Sitecore by default provides.
You or your Sitecore administrator have probably changed the password of the Sitecore admin at some point in time. You now need to change the DC's sitecore/admin user to have the same password as the Sitecore user.
In the scenario where you have changed the username of the default admin user, you need to also change the DC's sitecore/admin user to instead be the new admin username.
The important thing here, is that the admin user on the DC side matches the admin user on the Sitecore side.