This section provides information on how to install Digizuite DAM Center.

Before upgrading

If you are installing a new DC skip this step.

This app should be run to cleanup a table which is likely to have data errors. This is done as an app to avoid a potential long running SQL script as part of the DAM update process.

The app:

Ensure all queues in RabbitMQ are empty. We do not support upgrading with data left in RabbitMQ.

Install ElasticSearch: DC 5.6 Elastic Search

Running the app

Do a database backup first.

1. Unzip the zip-file to a new folder.
2. Edit appsettings.json and set the connectionstring to match that of the DC. It can be copy-pasted from the DC web.config.
3. Open a command prompt in the folder made for the app. The only logging is done in prompt so this is the only way to see how it goes.
4. Run CleanupAssetDigiupload.exe.

Questions

Why do I need to do this?

There is a table belonging to the core asset data which has data errors preventing normal load to memory cache which becomes a part of DC 5.4.

What happens with the asset data load if there are data errors?

The DC has a simple self-healing mechanism which will ensure normal operation when loading assets, however it will not fix all the errors.

Is this error found on any DC?

Yes. Significantly for any DC which has ever done any asset replace. The number of data errors scale linearly with the number of asset replaces.

Why is the error important to fix now if we always lived with it?

The load of asset data needs to be very quick and to achieve that we need a stricter control with the asset data structure.

Installing/Upgrading Digizuite

The Digizuite DAM Center is installed/Upgraded using Powershell. The package, provided by the Digizuite DAM Vendor, is a zip file with the following structure:

How to install/Upgrade

To install/upgrade the Digizuite DAM Center, do the following:

1. Edit the Install.ps1 - See section 1.2 for a description of all the parameters
2. Run the Install.ps1, as administrator, either from Powershell or the PowerShell ISE

Variables

All the parameters that need to be filled out, are described in the table below

$($ServicesFolder)\loki

$env:ComputerName

Install scenarios

As the same script is used for multiple purposes, this section describes different scenarios and what parameters to be especially aware of.

Installation

To install a new Digizuite DAM Center with UNC storage, the important parameters are the following

Important note: The installation script is NOT idempotent, which means if it is run again it will not validate and correct changes to reflect the config that was used in the installation process.
Issues arising from this could be that for example services and webs folder have been created on the C: drive instead of a dedicated drive. 
The only way of correcting these issues are to completely remove everything that the installation script created in this order (some services might need to be deleted by manually killing processes for that service):

1. Rabbitmq (service, services folder, references in registry)

2. Erlang (service, services folder, references in registry)

3. Nats (service, services folder)

4. Grafana  (service, services folder)

5. Loki  (service, services folder)

6. Promtail  (service, services folder)

7. Windows exporter  (service, services folder)

8. nssm  (service, services folder)

9. delete DAM database via SQL management studio

10. delete SQL security login : "admin_<customername>_dam"
11. Delete all IIS sites and App pools in IIS and restart IIS
12. check that all these services have been removed (to delete each: use sc delete "<servicename>" via CMD, not Powershell, and if they still don't get removed, restart server)
    

    Keep webs files as these are still relevant and can be moved into the new webs folder on the dedicated drive fx. H: drive
    
    Then finally run the install script again

Upgrade

To upgrade Digizuite DAM Center, the following parameters are important

Local UNC

To use a Local UNC (Local means it is located on the webserver), the following parameters are important:

External UNC

To use an external UNC (External means that storage is not located on the webserver), the following parameters are important

Azure storage (New install)

To use Azure storage, the following parameters are important

The reason there are two storage accounts is that frontend (used by satellite products, for instance, DAM For Sitecore) and backend (used by the administration web interface) storage is separated. 

Azure storage (Upgrade)

The same parameters as the new install are important, but the difference is, that the azure storage account and accesskeys have to correspond to what is already configured in the existing system.

Solr

SolR is now removed from installer

Azure SQL

We refer to Microsoft's documentation on how to setup Azure SQL.

If Digizuite DAM Center is installed/upgraded with Azure SQL database, then the following parameters are important:

Grafana

Once the installer has been run, it's extremely important that you go to {damurl}/grafana and login with admin/admin and pick a new password. Grafana is a well know system, so it's ripe for security problems if you don't login and change the password as soon as possible. This only needs to be done once per server, since the Grafana installation itself is server-wide, and not per site. 

Exclude Folders in Antivirus

To avoid problems with files being locked by AV some folders should be Excluded from RealTime Scanning

Edit and Run the powershell script ExcludePathsInAntiVirus.ps1 to perform this.

NOTE: If another antivirus is used these paths should be excluded via the management interface of the Antivirus.