Table of Contents |
---|
Info | ||
---|---|---|
| ||
This process must be repeated every time the Digizuite Mobile App is updated |
For this installation, no website is needed. Digizuite Mobile App is a self employed product that reflects the Digizuite Media Manager
...
.
During the installation process there are changes applied to the DAM database. For this reason it is strongly recommended to back up the database for the DAM Center before proceeding with running the installation script.
Before you can use the Media Manager Mobile App, some an installation scripts need to be applied to the DAM Center to accompany the installation. These can be found in the DigiZuite Media Manager DAM Center updates.zip archive. It script needs to be run towards the DAM Center.
For DAM Center releases later than than 5.3.0 (incl. 5.3.0)
Use this version for 5.3.2 and up:
Copy the zip installation folder from swinstall, into the server and unzip the file.
In the folder, there is a appsettings.json file which needs to have some data set:
Code Block | ||
---|---|---|
| ||
{
"Logging": {
"LogLevel": {
"Default": "Debug",
"System": "Information",
"Microsoft": "Information"
}
},
"Upgrade": {
"ConnectionString": "#{ConnectionString}",
"RunGenerateSearchForAll": true,
"ApiUrl": "#{ApiUrl}",
"ApiUsername": "#{ApiUsername}",
"ApiPassword": "#{ApiPassword}",
"VersionGuid": "1356CC29-B3A4-E6CC-152A-FEE1504E0C34",
"Availability": "74A5A102-A310-4BB7-9E84-0B14C36436B2",
"Timeout": "00:30:00"
}
} |
Here is a description of all the configuration parameters:
Parameter name | Description |
---|---|
ConnectionString | The database connection string. Must include the SQL server IP/Hostname, database name for the DAM Center, and the credentials of a SQL Server user with the rights to edit the given database. Most of this information can be found in the Media Manager's corresponding appsettings.json file. |
RunGenerateSearchForAll | Determines whether all Solr searches should be repopulated after the installation/update. Default: true |
ApiUrl | The URL to the DAM Center external API. Usually this would be the base URL of the DAM Center, with /dmm3bwsv3 added to the end. |
ApiUsername | The high level user. Default: System |
ApiPassword | MD5 hash of the password for the user set in apiUsername. You will find this in the db members table. |
VersionGuid | A unique key which refers to mobile. Don't change it, if it works. Otherwise, locate your Mobile GUID in Mobile's configManager. Default: 1356CC29-B3A4-E6CC-152A-FEE1504E0C34 |
Availability | GUID of metadata field that controls publishing. Default: 74A5A102-A310-4BB7-9E84-0B14C36436B2 |
Timeout | Maximum time (in seconds) to wait before timing out any request. If using runGenerateSearchForAll, the advised value is 1800. Default: 1800 |
Once the config file is set up correctly and saved, run db-upgrade.exe. You may choose to run it by double clicking it, by calling it from the CMD prompt, or, if you want to retain the log, run it via PowerShell.
For DAM Center releases earlier than 5.3.0
The folder includes a "MediaManager.DbUpgrade" executable that is an all-in-one installer for the DAM Center update. You must specify a variety of configuration parameters in the accompanying MediaManager.DbUpgrade.exe.config file before running the executable .
Note | ||
---|---|---|
| ||
As this tool makes changes to the DAM database, remember to back up the database for the DAM Center before proceeding. |
The configuration parameters are defined as XML keys. For all parameters aside from connectionString, the value property is the one containing the configurable value.
Info | ||
---|---|---|
| ||
All the fields in the configuration file are required. |
script.
The following is an example of a valid configuration:
Code Block | ||
---|---|---|
| ||
<?xml version="1.0" encoding="utf-8"?> <configuration> <connectionStrings> <add name="db" connectionString="Server=8.8.8.8;Database=company=localhost;Persist Security Info=False;MultipleActiveResultSets=False;Initial Catalog=customer_dam;User Id=administratorID=admin_customer_dam;Password=evK3GFn9LQVpm;admin_customer_dam"/> </connectionStrings> <appSettings> <!-- JobService GenerateSearchForAll --> <add key="runGenerateSearchForAll" value="true"/> <add key="apiUrl" value="httpshttp://damcustomerdc.company-sitedigizuite.netcom/dmm3bwsv3/"/> <add key="apiUsername" value="System"/> <add key="apiPassword" value="e6662662a3f90aa497566c9b4a32f2f7#{dzApiPassword}"/> <!-- Standard/Required --> <add key="versionGuid" value="5DD9CE785021806d-C555157c-4F90466d-801Bb346-F89372756091ba7bed246968"/> <add key="availability" value="74A5A102-A310-4BB7-9E84-0B14C36436B2"/> <add key="usingEmbeddedScripts" value="true"/> <add key="timeoutInSeconds" value="1800"/> </appSettings> <startup> <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.2"/> </startup> </configuration> |
To configure this file for whatever installation you have, you will need to get some information about the DAM Center, as well as make some decisions based on what kind of installation you want. Here is a description of all the configuration parameters:
Parameter name | Description | ||
---|---|---|---|
dbconnectionString | The database connection string. Must include the SQL server IP/Hostname, database name for the DAM Center, and the credentials of a SQL Server user with the rights to edit the given database. Most of it this information can be found in the table named Install_config_actualsiteid under dbConnectionString. By going this way, you have to change the "master" in the string to be the name of your database (e.g. psi_dam)Media Manager's DbUpgrade.exe.config file. | ||
runGenerateSearchForAll | Determines whether all Solr searches should be repopuplatedrepopulated after the install/update. Default: true | ||
apiUrl | The URL to the DAM Center's external API. Usually this would be the base URL of the DAM Center, with /dmm3bwsv3 / added to the end. | ||
apiUsername | The system user. Default: System | ||
apiPassword | MD5 hash of the password for the user set in apiUsername. You will find this in the db members table. | ||
versionGuid | The desired GUID for the Media Manager configuration. If there is no Media Manager installed on the DAM Center, this field can be any valid GUID. Guid can be generated in e.g. https://www.guidgenerator.com/. Otherwise, the field must use can use the Media Manager version GUID from the DAM Center. More information can be found here: Where do I find this GUID?Unless being told explicitly that you should use another GUID, then use the Default: 7E78E552-B052-43BE-8D0E-DA7357C1BACC | ||
availability | Guid of metadata field that controls publishing. Default: 74A5A102-A310-4BB7-9E84-0B14C36436B2 | ||
usingEmbeddedScripts | Determines whether the executable uses the default embedded SQL scripts for the install, or if it looks for SQL scripts in the installer folder. Default: true | ||
timeoutInSeconds | Maximum time to wait before timing out any request. If using runGenerateSearchForAll, the advised value is 1800. Default: 1800 | Availability | Guid of metadatafield that controls publishing. Default: 74A5A102-A310-4BB7-9E84-0B14C36436B2
Once the config file is set up correctly and saved, the next step is to simply run the MediaManager.DbUpgrade.exe file from the cmd prompt.
Note | ||
---|---|---|
| ||
There is a small possibility of the installer crashing due to a rare deadlock issue. If this happens, simply run the application one more time. |
Modifying the configuration file
(1) Download the following file MobileAppConfiguration.json
(2) Edit the information in the file according to the following guidelines:
Parameter name | Description |
---|---|
ApiUrl | The URL to the DAM Center's external API. It is formed by the base URL of the DAM Center and ending "/dmm3bwsv3/". Remember to include the character "/" at the end! |
MMUrl | The URL to the Media Manager's website. Example: https://demo3mm5.digizuite.com/ |
VersionId | This is the current version ID of Digizuite Mobile's ConfigManager version to be used. The easiest way to find it is by opening and logging in to your DAM Center, as demonstrated on the screenshot below: Use "!" in front of the VersionId to set that specific version as the current one, and not any version available beneath. Remember to include the character "/" at the end! |
SSOLoginMode | This line enables or disables the ability to log in through SSO. Default: true |
(3) Add the file to the root of the DC web folder