DFS 10.1.0 - Setting up the Digizuite DAM Center

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:

If the environment is set up using configuration management, please see DFS 10.1.0 - Setting up DFS using the Digizuite Configuration Management tool instead

These steps are usually already setup by the Digizuite supplier.

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:

DFS.Installer.exe.config

<?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.

1 Implementing DFS functionality into DC
- 1.1 DFS.Installer.exe.config
2 Make certain that the admin user is correct