You are here

Configuring the Liferay Share web application

This task describes how to deploy the web application.
  1. Deploy the Share web application to Liferay by copying the share.war file from your Alfresco Tomcat instance into Liferay's deploy folder.
  2. Locate the <LIFERAY_HOME>/tomcat-6.0.18/conf/catalina.properties file and open it in an editor.
  3. Locate the shared.loader property and set it to the following value:

    shared.loader=${catalina.home}/shared/classes,${catalina.home}/shared/lib/*.jar

  4. Create the directory <LIFERAY_HOME>/tomcat-6.0.18/shared/classes/alfresco/web-extension/.
  5. Add the following configuration to a new file called share-config-custom.xml.

    Note: If your Alfresco Tomcat instance is running on another host or a non-standard port, you must modify the endpoint-url parameters to point to the correct location of your repository. For example:
    <alfresco-config>
    <!-- example port config used to access remote Alfresco server (default is 8080) -->
    <config evaluator="string-compare" condition="Remote">
    <remote>
    <endpoint>
    <id>alfresco-noauth</id>
    <name>Alfresco - unauthenticated access</name>
    <description>Access to Alfresco Repository WebScripts that do not require authentication</description>
    <connector-id>alfresco</connector-id>
    <endpoint-url>http://localhost:8080/alfresco/s</endpoint-url>
    <identity>none</identity>
    </endpoint>
    
    <endpoint>
    <id>alfresco</id>
    <name>Alfresco - user access</name>
    <description>Access to Alfresco Repository WebScripts that require user authentication</description>
    <connector-id>alfresco</connector-id>
    <endpoint-url>http://localhost:8080/alfresco/s</endpoint-url>
    <identity>user</identity>
    </endpoint>
    
    <endpoint>
    <id>alfresco-feed</id>
    <name>Alfresco Feed</name>
    <description>Alfresco Feed - supports basic HTTP authentication via the EndPointProxyServlet</description>
    <connector-id>http</connector-id>
    <endpoint-url>http://localhost:8080/alfresco/s</endpoint-url>
    <basic-auth>true</basic-auth>
    <identity>user</identity>
    </endpoint>
    </remote>
    </config>
    
    <!-- 
    Overriding endpoints to reference an Alfresco server with external SSO enabled
    NOTE: If utilising a load balancer between web-tier and repository cluster, the "sticky
    sessions" feature of your load balancer must be used.
    NOTE: If alfresco server location is not localhost:8080 then also combine changes from the
    "example port config" section below.
    Optional keystore contains SSL client certificate + trusted CAs.
    Used to authenticate share to an external SSO system such as CAS
    Remove the keystore section if not required i.e. for NTLM.
    
    NOTE: For Kerberos SSO rename the "KerberosDisabled" condition above to "Kerberos"
    
    NOTE: For external SSO switch the endpoint connector to "AlfrescoHeader" and set
    the userHeader to the name of the HTTP header that the external SSO
    uses to provide the authenticated user name.
    -->
    <config evaluator="string-compare" condition="Remote">
    <remote>
    <keystore>
    <path>alfresco/web-extension/alfresco-system.p12</path>
    <type>pkcs12</type>
    <password>alfresco-system</password>
    </keystore>
    
    <connector>
    <id>alfrescoCookie</id>
    <name>Alfresco Connector</name>
    <description>Connects to an Alfresco instance using cookie-based authentication</description>
    <class>org.alfresco.web.site.servlet.SlingshotAlfrescoConnector</class>
    <userHeader>SsoUserHeader</userHeader>
    </connector>
    
    <connector>
    <id>alfrescoHeader</id>
    <name>Alfresco Connector</name>
    <description>Connects to an Alfresco instance using header and cookie-based authentication</description>
    <class>org.alfresco.web.site.servlet.SlingshotAlfrescoConnector</class>
    <userHeader>SsoUserHeader</userHeader>
    </connector>
    
    <endpoint>
    <id>alfresco</id>
    <name>Alfresco - user access</name>
    <description>Access to Alfresco Repository WebScripts that require user authentication</description>
    <connector-id>alfrescoHeader</connector-id>
    <endpoint-url>http://localhost:8080/alfresco/wcs</endpoint-url>
    <identity>user</identity>
    <external-auth>true</external-auth>
    </endpoint>
    </remote>
    </config>
    </alfresco-config>