DC 5.6 Installation/Upgrade

DC 5.6 Installation/Upgrade

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

SolR has been removed from the 5.6.1 Installer, Existing configuration Settings in Web.Config (SolRUrl and SolRUncPath) are maintained during upgrade.

Important for DamForOptimizely or other DC customers that still needs SolR - the Windows Group "AppPools-<SITENAME>" needs R/W permissions for the SolRUncPath folder

 

Before upgrading

If you are installing a new DC skip this step.

If you are upgrading from before 5.3 to this version, you must run this application!

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

Always remember to backup the database before upgrading!

 

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

Variable

Mandatory

Default value

Example /options

Note

Description

Variable

Mandatory

Default value

Example /options

Note

Description

NewInstallation

True

$True

$False

 

This variable controls whether it is an update or a new installation (True = new installation, false = update)

PreStagedDatabases

True

$False

$True

 

This variable controls whether the installer should create the databases and user if it is a new installation. Set this to True only if the databases have been pre-stages, see section

Users

 

 

 

 

 

assetstreamUsername

True

 

assetstream

Removed In 5.6.1

This variable is for the username of the storage user. See documentation, section 2.1

assetstreamPassword

True

 

SuperSecretPassword

Removed In 5.6.1

This variable is for the password of the storage user.

digiadminUsername

True

 

digiadmin

 

This variable is for the username of the administrative user.

digiadminPassword

True

 

SuperSecretPassword

Removed In 5.6.1

This variable is for the password of the administrative user

useActiveDirectory

True

$False

$True

 

This variable will setup the web site to require windows authentication. Do NOT set this to true on NewInstallations. Only use it on updates that are already set up for active directory.

Web

 

 

 

 

 

port

True

 

443

 

This is the port on which the web interface is installed in the IIS. Usually port 80 or 443

protocol

True

 

https

 

The protocol used for the web interface installed in the IIS. Typically HTTP or HTTPS

siteUrl

True

 

dam.company.com

 

The DNS for the web interface which is installed in the IIS

CorsAllowOrigins

True

@("$protocol://$siteurl")

@("https://dam.company.com", "https://mm.company.com")

 

A comma-separated list of allowed cors origins

Database

 

 

 

 

 

SqlServerWindowsLogin

True

$False

$True

Added in 5.6.1

True: Use Integrated security in Master Connection String (Windows login) - Current user needs permissions in Db
False: Use SQL Login

dbServerName

True

 

sqlserver

 

This is used for the SQL server name

dbUsername

True

 

sqluser

 

The user who has access to the database

dbPassword

True

 

SuperSecretPassword

 

The password of the database user

collation

True

SQL_Latin1_General_CP1_CI_AS

SQL_Latin1_General_CP1_CI_AS

 

The database collation

dbName

True

 

company_dam

 

The name of the database to be installed/updated. It has to be called _dam in the end.

DamdbPassword

False

 

SuperSecretPassword

 

Password for database DAM database user. If blank it defaults to: 
admin_{#dbName}

DamRecoveryModel

True

SIMPLE

FULL

 

This variable defines what the recovery model of the DAM database should be

Locations

 

 

 

 

 

localStoragePath

True

C:\Storage

C:\Storage

 

The local storage path. This is only used if the storage is located on the webserver. Leave as "C:\Storage" if Azure storage is used

uncStoragePath

False

 

\\server\storage

 

The UNC storage path. If on the webserver, the installer creates the share itself. If remote, then it has to exist.

SetStorageFilesystemRights

False

$True

$true $false

Removed in 5.6.1

Allow disabling update of Storage FileSystemRights IF DISABLED RIGHTS MUST BE HANDLED MANUALLY

logRoot

True

"C:\LogFiles\" + $siteUrl

D:\logFile\dam.company.com

 

This is the path on which the log files are written to

servicesFolder

True

C:\Services\Digizuite

C:\Services\Digizuite

 

This is the path on which all the binaries of the services are placed.

sitePath

True

"C:\Webs\" + $siteUrl

D:\Webs\dam.company.com

 

This is the path on which the files for the web interface are placed.

Monitoring

 

 

 

 

 

LokiStorageFolder

True

$($ServicesFolder)\loki

 

Removed in 5.6.1

The folder to install loki in. Logs are stored as part of this folder also.

LokiHostName

true

$env:ComputerName

10.0.0.5

 

The hostname/ip-adress of the server that is hosting Loki. Usually it's the web server. If you have multiple web servers, you need to point to the same webserver on all machines.  

RabbitMQ

 

 

 

 

 

InstallRabbitMQ

True

$True

$True $False

 

Should RabbitMQ be installed

RabbitMQHost

True

 

dam.company.com

 

The hostname of the RabbitMQ Server

RabbitMQUsername

True

 

[aRabbitMqUsername]

 

Username for connecting to RabbitMQ Server 

Note: guest is not allowed anymore

RabbitMQPassword

True

 

 

 

Password for connecting to RabbitMQ Server

RabbitMQVirtualHost

True

 

 

 

VHost on RabbitMQ, normally set to dam database name, excluding _dam

RabbitMQStorage

True

 

C:\ProgramData\RabbitMQ

 

The location where RabbitMQ Database and logs are stored – only used when RabbitMQ is installed for the first time on the server!

RabbitMQPath

True

 

C:\Program Files

Removed in 5.6.1 - uses servicesFolder

Parent folder, where the RabbitMQ Application is installed.

FirewallRemoteIpAddresses

True

 

@("192.168.1.0/24","172.16.1.22")

 

Ip address or address ranges that are allowed for rabbitmq and erlang ports, these are needed as Batch machines needs access to RabbitMQ. if an empty array are used all ip addresses are allowed = @()

IPV4 and IPV6 is possible, ranges only with CIDR notation WIKI CIDR

SearchService

 

 

 

 

 

ForceRepopulateAllSearches

True

$false

 

 

True = all searches will be repopulated, false = only changed searches will be repopulated

Elastic search

 

 

 

 

 

InstallElasticSearchOnPremise

False

False

True

 

Install Elastic Search OnPremise

ElasticSearchUrl

True

"http://localhost:9200"

 

 

The URL to Elasticsearch. See this documentation for more information about Elasticsearch: DC 5.6 Elastic Search Cloud

ElasticSearchApiKey

True

""

 

 

The API key required to access elastic. Leave empty if no API key is required. 

ElasticSearchVirtualHost

True

$local:RabbitMQVirtualHost

"mm-dam"

 

To support multiple DC's running on the same Elastic search cluster, the DC code can separate the names of indices and aliases it creates, such that indices do not overlap with each other. 

SMTP

 

 

 

 

 

smtpUsername

False

 

smtpuser

 

The username of the smtp user

smtpPassword

False

 

SuperSecretPassword

 

The password of the smtp user

smtpFromEmail