Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

Installation of Creative Cloud Connector on the local machine:

Info

This step can be performed at any time, independently of the remaining installation process.

The extension can be installed in two three ways:

...

  1. It can be done via the Adobe Exchange portal, search for "Digizuite Creative Cloud Connector"

...

  1. By using a 3rd party extension manager
    1. #1 recommended - AEScripts Adobe ZXP Extension Manager - https://aescripts.com/knowledgebase/index/view/faq/zxp-installer-faq/
      1. Download the installer from the AEScripts website for either Mac or Windows and run the installer
      2. Once installed, go to "File > Open" or use the shortcut command CTRL+O (on Windows) or Command+O (on Mac)
      3. Find the ZXP package provided by your Digizuite consultant in your file browser and click "Open"
      4. You will get the below window and click "Install"
        1. Image Added
      5. You should then receive the message "creative-cloud was successfully installed"
        1. Image Added
      6. You can then follow the steps on this page to access Digizuite Adobe Creative Cloud Connector - CCC5.5 User Guides
    2. Anastasiy’s Extension Manager - https://install.anastasiy.com/
    3. ZXP Installer (Note - this only install plugins and cannot remove, so this is the last option)
  2. By using Adobe's command line tool: (download using Firefox. Chrome seems to distrust it) (UPDATE: This is a user friendly alternative https://zxpinstaller.com/) (UPDATE2: If you have trouble uninstalling with ExManCmd.exe /remove "com.digizuite.creative-cloud", use https://install.anastasiy.com/)
    1. Unzip the folder
    2. Open the CMD (doesn't have to be "as admin")
    3. Change directory (CD) to the root of the folder you unzipped: cd "C:\Users\{your user}\Downloads\ExManCmd_win"
    4. (Optional) You may check which programs are already installed: ExManCmd.exe /list all
    5. Get the address of the CCC .zxp file
    6. Install the connector using the following command where the path in the citation marks point to the zxp file: ExManCmd.exe /install "C:\Users\{your user}\Downloads\digizuite-adobe-connector.zxp"
    7. (Optional) Run the following command, to see whether the zxp file was installed: ExManCmd.exe /list all
    8. If you have trouble uninstalling with ExManCmd.exe /remove "com.digizuite.creative-cloud", use a 3rd party extension manager listed above.

    9. Info

      The commands we're using can be found here

      No regedit needed

      Will install to Program Files (x86)


  3. Or by a manual installation: (regedit needed)
    • Acquire the installation files from your contact at Digizuite. You'll be sent a zip named something like"digizuite-adobe-connector.5.x.x-xxx.zip" (Edit: The zxp file can also simply be unpacked)
    • Unzip it into a folder you name anything - for this guide we've chosen to call it: com.digizuite.creative-cloud-connector 
    • Move the folder to either of the following paths:
  • 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

Image Modified

Install proxy website

This newer


Info
titleWindows only

If you place the files in both the Program Files AND the Program Files (x86) - you will very likely encounter issues.

Only place the files in Program Files.

Selection of config manager version

This new version of the connector uses the MM5the Media Manager 5's (MM5) Config Manager (Media Manager 5), as opposed to previously, where the connector Creative Cloud Connector (CCC) had its own version in the Config Manager.

You have two choices of There are two ways you can point the CCC to a Config Manager version:

  1. Use the MM5's Config Manager version by pointing to the MM5 url as the starting point for the Creative Cloud ConnectorSet 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's url.
  2. Use a CCC-only Config Manager version, by pointing to a new proxy website you create.


If you choose

...

option 2, please follow the

...

installation steps below

...

:

Installing of a proxy website

Step 1: Preparation

To initialize the installation, do the followinginstall a proxy website please perform the following steps:

  1. Copy the provided zip file to zip file "digizuite-adobe-connector-website.5.x.x-xxxx.zip" onto your server and unzip it into a new folder.
  2. In Copy the unzipped folder into the "Webs" folder (usually located on C:\webs) create a new folder, and call it the same as the
  3. Rename the folder 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)
  4. . 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:
    1. Unfold the menu with the server name
    2. Unfold "Sites"
    3. Right click on the name of one of the existing Digizuite products, for example your DAM center
    4. Click "Explore"
      Image Removed
  5. 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.
  6. 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.
Info
titleDNS 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.

Image Removed

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

...

Image Added

Step 2: Creating a Config Manager version solely for CCC to use 

This step is the whole "meat and potatoes" of this guide. Here you create what the the CCC points to. In other words, the other steps are there to allow the CCC plugin to point to the Config Manager version you create here.

To start, go to you DAM Center, and navigate to System tools → ConfigManager → Media Manager 5 → 5.0.0.

Image Added

In here, you have the ability to create CCC's Config Manager version.

Press the text field in the top-right corner, and input a name you find fitting. Some people go with "CCC", while other go with "Default" - or something else entirely.

Image Added

Info
Please note that the name itself is not important - but, once created, it cannot be changed nor deleted.

 After creation, the new Config Manager version can be found beneath System tools → ConfigManager → Media Manager 5 → 5.0.0.

Image Added

In here - locate the ID of the Config Manager version by pressing the Menu button → Version information (found next to the Create new version button):

Image Added

You'll be seeing something akin to the following image:

Image Added

Note down the Version id - in this case, it's "/1/1/". This will be used in the following step.

Step 3: CCC website configuration

The proxy website needs to point to the new version you created. Additionally, it requires some info to be set, in order to fully function.

Navigate to the CCC website files from step 1 (again, usually found in C:/webs), and open the file named appsettings.json - we recommend Notepad++ for editing such files:

Code Block
languagejs
{
  "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 placeholdersThe easiest way to configure this, is to look at your Media Manager website's appsettings.json file, and copy its values.

Here's a rundown of what the fields are used for:

PlaceholderDescription
ApiDomainYou 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:

Image Removed

Use Insert the DAM Center's url. This is used to redirect the calls to the proxy site onto the corresponding DAM Center. 
VersionIdE.g. e08240fb-c3b6-4b1f-9013-361c81dc506d

Input the CCC's Config Manager Version ID, which we located in the last step. (e.g. "/1/1/")

Due to legacy code, please insert a "!" 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

Thus making it say e.g. "!/1/1/"

UseFederatedAuthenticationMust be set to "true" if using SSO.
EnableNormalLoginMust 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 CCC and should can 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".

Image RemovedOpen the IIS

Image Added


Unfold the menu under the server name . Next, and right-click the webserver web server and select "Add website...".

Once you select "Add website...", a new window will show up. Here you have to do A new prompt will appear.

Input the following:

  1. 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).
  2. Specify your "Physical path". You do this by clicking Site name: Input the URL
  3. Physical path: Input the path to the folder in webs. Either click "..." next to the text box and searching for Adobe CC Connector folder mentioned above.
  4. Specify the prepared DNS record name in "Host name", which matches "Site name".
  5. or simply paste in the path yourself.
  6. Host name: Input the URL
  7. Type: Change type to "https".
  8. Require Server Name Indication: Check off the box "Require Server Name Identification"Select the correct SSL certificate from the drop-down menu
  9. SSL certificate: Select a SSL certificate that is usable for the URL you've chosen.
  10. 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.

Image Removed

Step 5: Application Pool Setup

  1. Expand the server content from the IIS Manager window and select the "Application Pools" menu.
  2. Locate the pool with the same name as your website and double-click it.
  3. The "Edit Application Pool" window will appear. Confirm that the selected .Net CLR version is 4+.
  4. Close "Edit Application Pool" and open the "Advanced Settings".
  5. Under "Process Model" change the Identity to "LocalService".

Image Removed

Image Removed

Image Removed(Optional): Go into the site's bindings and add a "http" binding:

Image Added