The default configuration uses the following URL's:

• Portal: http://localhost:8080/portal
• Base URL for rendering OpenSocial gadgets http://localhost:8080/gadgets

Override portal configuration¶

First configure the portal to call a different URL for the OpenSocial engine:

• Make a copy of portal.properties
• Change the properties portal.opensocial_engine.protocol, portal.opensocial_engine.root and/or portal.opensocial_engine.gadget_path
• Set a system property portal.override.properties that points to the location of the custom properties file.
  • File system: portal.override.properties=/new/location/of/myportal.properties
  • Classpath: portal.override.properties=classpath:myportal.properties

After a (re)start of Tomcat, the portal will now try to fetch gadget rendering data from your configured location.

Override OpenSocial engine configuration¶

• Make a copy of container.js (check if this version is still valid for your release)
• Make a copy of rave.shindig.properties
• Change the reference in rave.shindig.properties to container.js: shindig.containers.default=/new/location/of/container.js
• Change the properties that point to localhost, port 8080 or http
• Set a system property rave-shindig.override.properties that points to the location of the custom properties file.
  • File system: rave-shindig.override.properties=/new/location/of/myrave-shindig.properties
  • Classpath: rave-shindig.override.properties=classpath:myrave-shindig.properties

Note: Although shindig.host, shindig.port and shindig.contextroot can also be overridden by setting them as individual system properties, container.js contains hard coded values with localhost

Setting the system properties¶

Running Cargo¶

The Cargo Maven plugin is configured in rave-portal/pom.xml. Go to the element systemProperties and enable the elements portal.override.properties and rave-shindig.override.properties (also modify its paths).

<systemProperties>
    <net.sf.ehcache.skipUpdateCheck>true</net.sf.ehcache.skipUpdateCheck>
    <portal.override.properties>/path/to/custom.portal.properties</portal.override.properties>
    <rave-shindig.override.properties>/path/to/custom.shindig.properties</rave-shindig.override.properties>
</systemProperties>

Running a stand alone Tomcat server¶

A common location to set the system properties is in tomcat/bin/setenv.sh. Add a variable RAVE_OPTS

RAVE_OPTS="-Dportal.override.properties=/path/to/custom.portal.properties
           -Drave-shindig.override.properties=/path/to/custom.rave.shindig.properties"

Then add it to the CATALINA_OPTS variable

CATALINA_OPTS="${CATALINA_OPTS} ${RAVE_OPTS}"