DC 5.2.0 2.3 Installation/Upgrade
- Magnus Frank
- Anders Kromann Nielsen (Unlicensed)
- Anonymous
This section provides information on how to install Digizuite DAM Center.
1 Installing/Upgrading Digizuite
The Digizuie DAM Center is installed/Upgraded using Powershell. The package, provided by the Digizuite DAM Vendor, is a zip file with the following structure:
1.1 How to install/Upgrade
To install/upgrade the Digizuite DAM Center, do the following:
- Edit the Install.ps1 - See section 1.2 for a description of all the parameters
- Run the Install.ps1, as administrator, either from Powershell or the Powsershell ISE
1.2 Variables
All the parameters that needs to be filled out, are described in the table below
Variable | Mandatory | Default value | Example /options | 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 has been pre stages, see section |
| InstallDigiMonitor | True | $True | $True | Boolean indicating if Digimonitor should be installed or not |
Users | ||||
| assetstreamUsername | True | assetstream | This variable is for the username of the storage user. See documentation, section 2.1 | |
| assetstreamPassword | True | SuperSecretPassword | 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 | 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 setup 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 | 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 | |
Database | ||||
dbServerName | True | sqlserver | This is used for the sql server name | |
| dbUsername | True | sqluser | The user which 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 |
| CompatabilityLevel | True | 120 | 130 | The compatibility level of the database. has to be either 120 or 130 |
| 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} | |
| DamJobsdbPassword | False | SuperSecretPassword | Password for database DAM database user. If blank it defaults to: admin_{#dbName}_jobs | |
| DamRecoveryModel | True | SIMPLE | FULL | This variable defines what the recovery model of the DAM database should be |
| JobRecoveryModel | True | SIMPLE | FULL | This variable defines what the recovery model of the DAM_jobs 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 web server. Leave as "C:\Storage" if Azure storage is used |
| uncStoragePath | True | \\server\storage | The UNC storage path. If on the web server, the installer creates the share it self. If remote, then it has to exist. | |
| 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:\Program Files\Digizuite\" + $siteUrl | C:\Program Files\Digizuite\dam.company.com | 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. |
Solr | ||||
| installSolr | False | $False | $True | True if solr should be installed. Only able to install on web server. |
| solrUrl | True - if installSolr is True, else false | http://localhost:8983/solr/ | http://localhost:8983/solr/ | The url which solr should use |
| solrLocalPath | True - if installSolr is True, else false | C:\Services\SolrService | C:\Services\SolrService | Local path on which the Solr binaries are placed |
| solrUncPath | True - if installSolr is True, else false | $solrLocalPath | \\server\Services\SolrService | Unc path on which the solr binaries are placed |
SMTP | ||||
| smtpUsername | False | smtpuser | The username of the smtp user | |
| smtpPassword | False | SuperSecretPassword | The password of the smtp user | |
| smtpFromEmail | False | noreply@company.com | The e-mail which should be used to send from | |
| smtpPort | False | 587 | 587 | The port used for the smtp server |
| smtpServer | False | smtp.company.com | The smtp server | |
Licenses | ||||
| licenseName | True | Company | The license holder name | |
| licenseSerialNumber | True | 42 | The serial number of the license | |
| licenseApplication | True | - | The license for the main application | |
| licenseAssets | True | - | The licence for the assets | |
| licenseUsers | True | - | The license for the users | |
| licenseMetadata | True | - | The license for metadata | |
| licenseOffice | False | - | The license for the office connector | |
| licenseDamForSitecore | False | - | The license for the Dam For Sitecore connector | |
Azure | ||||
| azureStorageAccountBe | False | BackendStorageCompany | The storage account name of backend storage | |
| azureAccessKeyBe | False | - | The access key for the backend storage | |
| azureStorageAccountFe | False | FrontendStorageCompany | The storage acocunt name of frontend storage | |
| azureAccessKeyFe | False | - | The access key for the frontend storage |
2 Install scenarios
As the same script is used for multiple purposes, this section describes different scenarios and what parameters to be specially aware of.
2.1 Installation
To install a new Digizuite DAM Center with UNC storage, the important parameters are the following
| Variable | Value | Description |
|---|---|---|
| NewInstallation | $True | This has to be true on new installations, as otherwise databases wont be created |
| PrestagedDatabases | $True/$False | If databases and users has not been pre staged (created), then set this to $False, $True otherwise. This is for installing without sysadmin rights |
| Azure parameters | Leave them blank, if UNC storage is used |
2.2 Upgrade
To upgrade Digizuite DAM Center, the following parameters are important
| Variable | Value | Description |
|---|---|---|
| NewInstallation | $True | This has to be true on new installations, as otherwise databases wont be created |
| PrestagedDatabases | $True/$False | What happens if it is false, is the databases and the user mapping is checked and corrected (if wrong), but that requires sysadmin rights on the SQL server |
2.3 Local UNC
To use a Local UNC (Local means it is located on the web server), the following parameters are important:
| Variable | Value | Description |
|---|---|---|
| localStoragePath | Local storage path | Has to point to the local storage path (e.g. C:\Storage) |
| uncStoragePath | UNC storage path | Has to point to the local share (\\Webserver\Storage) |
2.4 External UNC
To use an external UNC (External means that storage is not located on the web server), the following parameters are important
| Variable | Value | Description |
|---|---|---|
| localStoragePath | C:\Storage | Leave it as: C:\Storage |
| uncStoragePath | UNC storage path | Has to point to the external share (\\SomeExternalServer\Storage) |
2. 5 Azure storage (New install)
To use Azure storage, the following parameters are important
| Variable | Value | Description |
|---|---|---|
| localStoragePath | Local storage path | If provided, it configures up a local storage, that can be enabled in the future |
| uncStoragePath | UNC storage path | if provided, it configures a local unc share, that can be enabled in the future |
| azureStorageAccountBe | Has to be a Microsoft Azure storage account name | |
| azureAccessKeyBe | Accesskey of the above | |
| azureStorageAccountFe | Has to be another Microsoft Azure Storage account name | |
| azureAccessKeyFe | Accesskey of the above |
The reason there are two storage account, is because frontend (used by satelite products, for instance DAM For Sitecore) and backend (used by the administration web interface) storage is seperated.
2.6 Azure storage (Upgrade)
The same parameters as the new install are important, but the difference is, that the azure storage account and accesskeys has to correspond to what is already configured in the existing system.
2.6 Solr (New install)
To install Solr, the Solr paramters are important.
| Variable | Value | Description |
|---|---|---|
| installSolr | $True | Indicates that Solr should be installed |
The rest of the parameters should be filled out according to the description
2.7 Solr (Upgrade)
If Digizuite DAM Center is upgraded and Solr is already installed and configured, fill out the Solr parameters according to what is already configured.
| Variable | Value | Description |
|---|---|---|
| installSolr | $False | Indicates that Solr should be installed |
2.8 Azure SQL
Info
The created databases in the Azure portal has to be postfixed with _dam and dam_jobs (i.e. YourCompanyName_dam and YourCompanyName_dam_jobs)
We refer to Micorsofts documentation on how to setup Azure SQL.
If Digizuite DAM Center is installed/upgraded with Azure SQL database, then the following parameters are important:
| Variable | Value | Description |
|---|---|---|
| dbServerName | YourAzureSQLServer | This should point to the Azure SQL Server name |
| dbUsername | YourAzureSQLServerUserName | This should be the username setup on the Azure SQL server |
| DamdbPassword | SomeSuperSecretPassword | Standard Azure configuration enforces a password policy, so the password should follow these (i.e. default password is not strong enough) |
| DamJobsdbPassword | SomeSuperSecretPassword | Standard Azure configuration enforces a password policy, so the password should follow these (i.e. default password is not strong enough) |