Thursday, May 26, 2016

Cumulus Portals Basic Configuration

With Cumulus version 10.1.2 and above, external DAM users have improved HTML5 support with the Portals web service. Here are the basic steps for a basic Portals configuration.

STEP 1: In native client, go to File -> Administration -> Server Console. Select Remote Admin -> License, and scroll to bottom. Click on "Activate Cumulus" button and enter your Canto Community Credentials. IMPORTANT: Please make sure Portals serial is listed in your license. Without it, your Portals will not run.


STEP 2: Set web services to run on port 80 by opening server.xml in your favorite text editor.

On Windows:
\Program Files\Canto\Cumulus Web Solutions\apache-tomcat-8.0.26\conf\server.xml

On Mac/Linux:
/usr/local/Cumulus_WebSolutions/apache-tomcat-8.0.26/conf/server.xml

Change port="8080"

    <Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" />


To port="80"

    <Connector port="80" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" />



STEP 3: Remove 8080 from customization.js to enable CIP web services. Entry "localhost" should be changed to the IP address of the Cumulus application server. IMPORTANT: You cannot use the DNS name here, it will break CIP web services. ALWAYS use the IP address.

On Windows:
\Program Files\Canto\Cumulus Web Solutions\apache-tomcat-8.0.26\webapps\portals\customization.js

On Mac/Linux:
/usr/local/Cumulus_WebSolutions/apache-tomcat-8.0.26/webapps/portals/customization.js

Change

    'CIP': '//localhost:8080/CIP/',

To

    'CIP': '//YOUR.IP.ADDRESS/CIP/',



STEP 4: Open your catalog in Cumulus Admin Client. Go to Edit -> Preferences -> Catalog Settings -> General. Select your catalog from the drop down, then check the boxes for "Share catalog" and "Allow Web access"


STEP 5: Restart Cumulus Web Solutions (Windows Server) or Restart Server (Linux/Mac)


STEP 6: Restart your browser, we usually recommend Chrome or Firefox for best results.

If local, load http://localhost/portals/
If remote, load the IP address or your server DNS, example http://usdemo.canto.com/portals


STEP 7: Login to the Web Server Console at http://localhost/serverconsole

Once logged in select "CIP Configurator". Then double-click your Portals instance in the list, and set "portals-general-access" user to your "cumulus" admin login instead of "test". Make sure to set your password by clicking the button with the three dots (...), then click "OK" and "Save"




STEP 8: To configure download collections for Portals, go to the Web Server Console -> CIP Configurator. Choose "portals-download-collection" and make sure your catalogs are added to the list. Usage dropdown should be set to "General Access" and uncheck the box for "Only allow the following operations".