Installation of Creative Cloud Connector on the local machine:
This step can be performed at any time, independently of the remaining installation process.
The extension can be installed in two ways:
- From the Adobe Exchange portal, search for "Digizuite Creative Cloud Connector". Then continue the installation from there.
- Or you can install the extension manually:
Request the connector from your contact person at Digizuite. They will give you the connector as a zip file: creative-cloud-connector.zip
Dependent on the system, unzip the files and place the files as follows (you need to create a new folder) - Make sure to only put the files in here:- Windows: C:\Program Files\Common Files\Adobe\CEP\extensions\com.digizuite.creative-cloud-connector
- MacOS: ~/Library/Application Support/Adobe/CEP/extensions/com.digizuite.creative-cloud-connector
Install proxy website
This newer version of the connector uses the MM5's Config Manager (Media Manager 5), as opposed to previously, where the connector had its own Config Manager.
You have two choices of Config Manager:
- Use the MM5 url as the starting point for the Creative Cloud Connector
- Set up a proxy website, which allows you to control the config version ID of the site.
This allows you to configure CCC to use another configuration than the MM.
If you choose to do this, then follow the installations steps below.
Step 1: Preparation
To initialize the installation, do the following:
- Copy the provided zip file to your server and unzip into a new folder.
- In the "Webs" folder (usually located on C:\webs) create a new folder, and call it the same as the URL you wish for your CCC to be accessible through. (In other words: The name matching the DNS record for the Creative Cloud Connector in the location your IIS server has the access to)
- . This location is usually the folder named "Webs" (usually C:/Webs is used, but it can also be located on a different drive).
An alternative method of finding the relevant "Webs" folder is by using Internet Information Services (IIS) Manager. In order to do that, you need to:- Unfold the menu with the server name
- Unfold "Sites"
- Right click on the name of one of the existing Digizuite products, for example your DAM center
- Click "Explore"
- The folder named "Digizuite Adobe Creative Cloud Connector (version)" is used for setting up the proxy website. After unpacking it, you need to place its contents into the folder created in the previous step.
- Create a new folder with the same name as your DNS record in the folder "LogFiles". You will need to specify the path to the newly created folder in one of the following steps.
DNS entry
As stated in the requirements document, you must set up a DNS entry for the website.
If you do not have a way of setting up the DNS, you can instead edit your own computer's "hosts" file, located in C:\Windows\System32\drivers\etc.
Step 2: Creating a new Creative Cloud Connector version
The DAM Center enables the opportunity of creating multiple Creative Cloud Connector versions with the help of the Config Manager. Usually, however, you will only have one version corresponding to your one Adobe CC Connector.
It is strongly recommended to create at least one version of the application (Default) at this stage of the installation process.
To create a new version, you'll have to access your DAM Center.
In your DAM Center, navigate to System tools → ConfigManager → Media Manager 5 and select the correct version.
While standing in the root of Media Manager 5's Config Manager, look to the upper right corner where a button says "Create new version".
To the left of the button, there is a text field. In the field, type the title of the version. Name the new version something like this CCC.
Press the "Create new version" button.
It can be noticed that under System tools -> ConfigManager -> Media Manager 5 a new folder has been created that contains the current version and the newly created one.
You will need to access the version ID of this newly created version in the next step in order to mark it as the current one.
Step 3: Website Configuration for the Creative Cloud Connector
Before the Creative Cloud Connector can be used, it needs to have some base configuration set, such as which DAM Center it should use. This configuration can be found in the appsettings.json file. This file was part of the content that you have copied into the folder with the name matching the DNS record for the site
This is the relevant part of the configuration file that you will see once you open it with e.g. Notepad++:
{ "Logging": { "LogLevel": { "Default": "Warning" } }, "AllowedHosts": "*", "EnablePrerendering": false, "ForceHttps": true, "HttpsPort": 443, "MediaManagerConfiguration": { "GuestUsername": "Guest", "GuestPassword": "0ea2f02d5f73c86c220ff08b23d1c3f1", "ApiDomain": "", "UseHttps": true, "WowzaServer": "", "WowzaAppName": "mmapp", "AbrMediaId": "666", "EnabledFeatures": [], "InstrumentationKey": "#{instrumentationKey}", "ProductVersion": "#{productVersion}", "VersionId": "!/5/", "UseFederatedAuthentication": false, "EnableNormalLogin": false, "BusinessWorkflowServiceUrl": "http://localhost:60000/" } }
While you fill out the required fields, the same rules as with the configuration file for the installation scripts apply.
Here is the description of what to put into the placeholders:
Placeholder | Description |
---|---|
ApiDomain | You need to replace ApiDomain with the base Domain of the DAM Center that Media Manager 5 should be connected to. |
ProductVersion | The version of the product that has been installed. Example: 5.0.0-1404 |
VersionId | This is the current version ID of Media Manager 5 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! |
InstrumentationKey | E.g. e08240fb-c3b6-4b1f-9013-361c81dc506d |
UseFederatedAuthentication | Must be set to "true" if using SSO. |
EnableNormalLogin | Must be set to "true" if normal login should be enabled together with SSO. |
Please note: The fields "WowzaServer", "EnabledFeatures" and "InstrumentationKey" are not relevant for the Connector and should be disregarded.
Step 4: Creation of a New IIS Website
To add a new website on Windows Server, open the "Server Manager" console. Then, under the "Tools" drop-down menu, select "Internet Information Services (IIS) Manager".
Unfold the menu under the server name. Next, right-click the webserver and select "Add website...".
Once you select "Add website...", a new window will show up. Here you have to do the following:
- Type in your "Site name". The name should be the same as the folder that you created in "Webs" folder for your Digizuite™ Adobe CC Connector in the preparation process (second step).
- Specify your "Physical path". You do this by clicking "..." next to the text box and searching for Adobe CC Connector folder mentioned above.
- Specify the prepared DNS record name in "Host name", which matches "Site name".
- Change type to "https".
- Check the box "Require Server Name Identification"
- Select the correct SSL certificate from the drop-down menu.
- Click "OK".
Once the site has been created, go into the bindings for the site in the IIS and create http site on the same domain.
Step 5: Application Pool Setup
- Expand the server content from the IIS Manager window and select the "Application Pools" menu.
- Locate the pool with the same name as your website and double-click it.
- The "Edit Application Pool" window will appear. Confirm that the selected .Net CLR version is 4+.
- Close "Edit Application Pool" and open the "Advanced Settings".
- Under "Process Model" change the Identity to "LocalService".