DoCASU

• Overview
• Features
• Screenshots
• Video Demo
• Screencasts
• Architecture
• Downloads
• Roadmap

Documentation

• Installation
• Configuration
• FAQ
• Client Architecture
• Developer Guide

DoCASU on Air

• Overview
• Simple Installation
• Installation
• Developer Guide

Related Sites

• docasu.org
• Alfresco Forge

DoCASU on Air Installation

Abbreviations and Shortcuts used throughout the Document

• AMP -- Alfresco Module Package
• ${ALFRESCO_HOME} -- your local Alfresco install directory, e.g. on Linux /opt/alfresco

Prerequisits, afresco setup/version

Afresco Installation Wiki Pages

Installation

DoCASU an Air is composed by a desktop application and an extended, backward compatible version of DoCASU that has to be deployed on Alfresco.

1. Deployment of the extended version of DoCASU on Alfresco

• Download the latest release of DoCASU on Air:

svn co http://code.optaros.com/svn/docasu/trunk

• Execute the command ant setup which will create the docasu.properties and deploy-local.properties configuration files. These files override the default values in docasu.properties.base and deploy-local.properties.base.
• Edit the file deploy-local.properties and indicate the correct path information. See inline documentation for details.
• Edit the file docasu.properties and indicate the correct DoCASU version and Alfresco SDK version. See inline documentation for details.
• If you wish to use alfresco-labs-sdk-3a.1032 note that it is missing alfresco-webscript-framework.jar. You will need to manually copy this file from alfresco.war/WEB-INF/lib to your docasu/download/alfresco-labs-sdk-3a.1032/lib/server folder. The easiest way is to let ant download the sdk and fail on compile, then copy the file manually.
• Package the amp

  ant package-amp
  

• Copy the file target/docasu-1.5.0.amp to your ${ALFRESCO_HOME}/amps folder
  • It's ok if there are already some other AMPs in this directory.
  • If a previous version of the docasu-1.5.0.amp file is present, you can overwrite it.
• Stop the running Tomcat/ Alfresco server:
  • on Linux

    ${ALFRESCO_HOME}/alfresco.sh stop
    

  • on Windows

    ${ALFRESCO_HOME}/alfresco.bat stop
    

• Patch the alfresco.war archive with the AMP files in the, ${ALFRESCO_HOME}/amps directory:
  • on Linux

    ${ALFRESCO_HOME}/apply_amps.sh
    

  • on Windows

    ${ALFRESCO_HOME}/apply_amps.bat
    

• Start the Tomcat/ Alfresco server:
  • on Linux

    ${ALFRESCO_HOME}/alfresco.sh start
    

  • on Windows

    ${ALFRESCO_HOME}/alfresco.bat start
    

• Watch the ${ALFRESCO_HOME}/alfresco.log and ${ALFRESCO_HOME}/tomcat/logs/catalina.out log files for errors.

2. Deployment of the air application

• Download the Adobe Air SDK
• Be sure AIRSDK/bin is in your path
• Build the air package

  ant air-package
  

• Copy the target/DoCASU.air file wherever you'd like and double click it to install it.

Making the installation of the air application available from a web page

• Copy the files contained in air-src/installer-badge/ to a web server.
• Modify the following properties in the AC_FL_RunContent function of installer.html
  • appurl: The URL of the AIR package to be downloaded. You must use an absolute, not relative, URL.
    • Note: the only authentication mechanism supported when downloading the air file is http basic authentication. You can, for example, use a WebDAV link.
  • imageurl: The URL of the docasu logo
• Modify the line after the comment Flash Player is too old or we can't detect the plugin as you wish.
• Modify the content of the <noscript> tag as you wish.

How-to rollback/undeploy the DoCASU AMP from Alfresco Enterprise 2.1.1 Tomcat Bundle

See this.