Alfresco SDK build

更多精彩请到 http://www.139ya.com

1. get the source code from http://svn.alfresco.com/repos/alfresco-open-mirror/alfresco by svn (download from http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=8100, note : the command "svn.exe" is needed)

2. Check out the source from the appropriate SVN repository, as mentioned earlier.

3. Set the TOMCAT_HOME environment variable to the root of your Apache Tomcat install directory.

4. Navigate to the root of the source directory, then run the default Ant target: ant build.xml

5. It will take a few minutes to build everything. When it is done, run the distribute task like this:
ant -f continuous.xml distribute

Note: this step will failed due to the ALF-BINARIES not complete, but it does needed because will build out some lib (such as "/root/projects/web-service-client/build/dist/alfresco-web-service-client-3.2_Preview2.jar") for the next SDK build

6. It will take a few minutes to build everything. When it is done, run the distribute task like this:
ant -f continuous.xml distribute-sdk

7. The generated sdk can be found under "${alfresco_source}\build\dist\", the name is something like "alfresco-labs-sdk-*.tar.gz" or "alfresco-labs-sdk-*.zip", e.g. "alfresco-labs-sdk-3.2_Preview2.zip"

8. Unzip the sdk archive above into somewhere, e.g. "d:\\dev\\alfresco-sdk"

9. In eclipse, select File|Import|Existing Projects into Workspace. For the root directory, specify the directory where the SDK was uncompressed, e.g. "d:\\dev\\alfresco-sdk"

10. Select all of the projects that are listed and click Import.

11. Done! we will see a lot of projects are imported into eclipse, the project name is just like "SDK *", e.g. "SDK AlfrescoEmbedded"

Note: the step 5, on the reference book "alfresco_developer_guider.pdf", it suggests to use the command "ant -f continuous.xml distribute", but it will cause many errors during build, and because we just need alfresco sdk, so we just use "ant -f continuous.xml distribute-sdk" !!!

Alfresco Dev Environment

更多精彩请到 http://www.139ya.com


Alfresco SVN Development Environment : http://wiki.alfresco.com/wiki/Alfresco_SVN_Development_Environment



Alfresco on Eclipse : http://wiki.alfresco.com/wiki/Alfresco_on_Eclipse

Comparing Alfresco Enterprise Edition and Adobe LiveCycle Contentspace ES

更多精彩请到 http://www.139ya.com

From : http://blogs.adobe.com/livecycledocs/2009/05/comparing_alfresco_enterprise_1.html

People sometimes ask what the difference is between Alfresco and Adobe LiveCycle Contentspace ES, so we thought posting a quick overview on the subject would be helpful.

LiveCycle ContentSpace ES is based on Alfresco 2.1 and offers full Alfresco functionality*, plus LiveCycle Content Services ES. Adobe added more service capabilities by extensively customizing the Alfresco user interface and by integrating various LiveCycle Content Services ES solution components.

Technically speaking, these are the key differences between Alfresco Enterprise Edition and LiveCycle Content Services ES:
- Web Content Management is not embedded or distributed.
- Replaced jBPM with LiveCycle Process Management ES.
- Replaced PDF libraries.
- Enhanced security to enable single sign-on (SSO) with other LiveCycle components such as Workspace and integration with Adobe User Management.
- Added support for the full LiveCycle ES 54 platform matrix including clustering/failover.
- Integrated LiveCycle ES solution components such as LiveCycle Workspace ES, LiveCycle Rights Management ES, and LiveCycle PDF Generator ES.

The key architecture of Alfresco in terms of Java APIs, ACPs, customized content models, actions, and so forth, are the same.

Using LiveCycle Contentspace ES, end users can manage the content through library services such as versioning, check-in/checkout, rights protecting, and archiving according to policies. Developers can also implement processes to enable end users to interact with content and automate procedures like document transformation and PDF generation, rights management, as well as workflows like data capture, and document review and approval.

Along with the Alfresco content management system capabilities, LiveCycle Content Services ES provides the following functionality.

Process automation

Content Services ES can leverage LiveCycle ES for business events by running processes based on content events, such as adding new documents to the repository. A process can also wait for content events to occur, such as a completed document review.

Users can perform the following tasks:
- Attach files, such as reports to a form, and submit the form. After the form is submitted, both the data and the attachments are saved, and can be opened and viewed in the same form layout.
- Access different form applications or content types in the same portal.
- Search and browse by association between processes and documents, and by process and document attributes.

Process initiation

Developers can run processes from LiveCycle Contentspace ES and leverage LiveCycle Workspace ES to review and approve content.

Form rendering

Developers can set up the following form rendering tasks:
- Pre-populate forms by using content or metadata.
- Render forms with attachments from Content Services ES.
- Update forms with a new version of assets referenced during run-time.
- Keep form template versions consistent during the life cycle of the process.

Information protection

Content Services ES can leverage LiveCycle Rights Management ES to automatically apply policies to content that is stored in the repository. Using Rights Management ES, organizations can protect PDF documents. The policies are applied transparently to content when users retrieve content from the repository and save it on the local file system, send content by email to someone who is external to the organization, or place content on devices such as USB keys.

Document output

Content Services ES has pre-built actions that developers can use to automatically convert documents to other formats (for example, from MS Word to PDF). Also, developers can configure actions to start short-lived processes for assembling a set of documents within a shared space into a package, generating PDF files from three-dimensional content, or converting content to PDF/A format for archiving.

* LiveCycle Contentspace ES does not utilize the Web-based Distributed Authoring and Versioning (WebDAV) file server configuration capabilities of Alfresco.

Alfresco Module Dev

更多精彩请到 http://www.139ya.com

1. create the folder structure as Alfresco recommended. Sample : ${Alfresco_Source}\modules\avm-compare

2. code the service code

3. build them by the ANT. Sample build.xml : ${Alfresco_Source}\projects\sdk\samples\BasicAmpSample\build.xml

4. DON't deploy the generated .amp file by alfresco-mmt-3Stable.jar directly! it will damage the war file!

5. unzip the generated .amp file into a clean folder, e.g. D:\temp\alfresco_module_test

5. copy the generated .jar file to alfresco web instance, e.g. From D:\temp\alfresco_module_test\lib\baconModuleTest.jar To D:\dev\a_lab3c\tomcat\webapps\alfresco\WEB-INF\lib\baconModuleTest.jar

6. copy the folder D:\temp\alfresco_module_test\config\alfresco\module\org.alfresco.module.bacon To D:\dev\a_lab3c\tomcat\webapps\alfresco\WEB-INF\classes\alfresco\module\org.alfresco.module.bacon

7. copy the folder D:\temp\alfresco_module_test\config\alfresco\extension\templates\webscripts To D:\dev\a_lab3c\tomcat\webapps\alfresco\WEB-INF\classes\alfresco\templates\webscripts


8. Done

Note: maybe the file "module.properties" should be put at "D:\dev\a_lab3c\tomcat\webapps\alfresco\WEB-INF\classes\alfresco\module\org.alfresco.module.bacon", because it's packaged into the root folder inside the .amp package, but by now the deployed module works fine without the properties file, it's just a comments for future!

Alfresco

更多精彩请到 http://www.139ya.com


Alfresco Download : http://wiki.alfresco.com/wiki/Labs_3_Final_download_files


How to create an Alfresco Module Package (AMP) : http://klungvik.com/index.php/2009/how-to-create-an-alfresco-module-package-amp/


Installing the AMP(ADOBE) : http://livedocs.adobe.com/livecycle/8.2/programLC/programmer/help/001580.html

Helene's site for alfresco : http://klungvik.com/


Tips on Alfresco Web Content Management : http://www.benh.co.uk/alfresco/surf-part-1-getting-started/

Alfresco Web Script Pages

更多精彩请到 http://www.139ya.com

http://wiki.alfresco.com/wiki/Web_Scripts


http://wiki.alfresco.com/wiki/Web_Scripts_Examples

http://wiki.alfresco.com/wiki/Web_Scripts_Hello_World_Quick_Start


Listing_Available_Web_Scripts : http://wiki.alfresco.com/wiki/Web_Scripts#Listing_Available_Web_Scripts

Deciding_Where_to_place_Web_Script_Implementation : http://wiki.alfresco.com/wiki/Web_Scripts#Deciding_Where_to_place_Web_Script_Implementation

WebScripts Configuration : http://wiki.alfresco.com/wiki/3.0_Web_Scripts_Framework#Configuration


Java-backed_Web_Scripts_Samples : http://wiki.alfresco.com/wiki/Java-backed_Web_Scripts_Samples


http://wiki.alfresco.com/wiki/Web_Scripts_Examples

http://www.optaros.com/blogs/running-alfresco-web-scripts-liferay-portlets

https://www.liferay.com/zh_CN/web/guest/community/forums/-/message_boards/category/243732;jsessionid=77BA415F3FF1DD797023CECF4D9459E5

https://www.liferay.com/zh_CN/web/guest/community/home

Alfresco Launches Rapid Web Site Development Tool

更多精彩请到 http://www.139ya.com


http://www.alfresco.com/media/releases/2009/01/web-studio-labs3/

Alfresco WCM - an enterprise-class content creation platform and repository;
Alfresco Surf - a web application and site assembly framework for developers; and,
Alfresco Web Studio - a graphical design and site assembly tool for business users.

Alfresco Trouble Shooting

更多精彩请到 http://www.139ya.com

Installation:

1. Linux Installation Troubleshooting: http://wiki.alfresco.com/wiki/Linux_Installation_Troubleshooting

Out of Memory Errors

These can really stuff up the bootstrapping process. If you have not allocated enough memory to the JVM then the bootstrapping process will abort unpredictably.

You can diagnose this by grepping catalina.out for

java.lang.OutOfMemoryError: Java heap space

To fix this make sure the JVM is passed a command line argument of something like -Xmx1024m


Damaged Installation after Out of Memory Errors

Once you have fixed the OOM errors Alfresco may refuse to install or start if there is data left lying around after an aborted install.

For example the following errors may be found in catalina.out:

00:13:42,211 ERROR [repo.admin.ConfigurationChecker] CONTENT INTEGRITY ERROR: System content not found in content store.
00:13:42,211 ERROR [repo.admin.ConfigurationChecker] Ensure that the 'dir.root' property is pointing to the correct data location.
00:13:42,224 ERROR [web.context.ContextLoader] Context initialization failed
org.alfresco.error.AlfrescoRuntimeException: Ensure that the 'dir.root' property is pointing to the correct data location.

To clean up Alfresco try the following.

1. stop tomcat

2. delete everything in dir.root. This is where Alfresco stores content, indexes, etc. Its defined in custom-repository.properties

3. drop the database. Log into mysql as root or the alfresco user (defined by 'db.username' in custom-repository.properties)

mysql> drop database alfresco;
mysql> create database alfresco;

4. set the following value in custom-repository.properties to make Alfresco recreate the indexes

index.recovery.mode=FULL

5. start tomcat and monitor the logs.
File Errors

If you are logged in as root and have followed the instructions for configuring Alfresco then you will have edited files and they will be owned by root. Alfresco may not be able to access them. This will give unpredictable errors in catalina.out that Alfresco cannot read files, or create them or whatever.

To fix this try chown-ing everything (once again)

chown -R alfresco:alfresco /opt/alfresco/tomcat
chown -R alfresco:alfresco /var/lib/alfresco

Note that the username and file locations may be different depending on which set of instructions you followed.

Alfresco 自编译安装配置

更多精彩请到 http://www.139ya.com

Tomcat 6.0.18
Alfresco Lab 3C

1. 下载源码svn...
2. 编译默认 ant build
3. alfresco.war 会自动被放在 $TOMCAT_HOME/webapps
4. 启动tomcat, 从系统log里能看到alfresco.war 被展开
5. 修改$TOMCAT_HOME/webapps/alfresco/WEB-INF/classes/alfresco/repository.properties, 把 dir.root 改成绝对路径，如:

dir.root=D:/dev/apache-tomcat-6.0.18/webapps/alfresco/WEB-INF/classes/alfresco/alf_data
index.recovery.mode=FULL, 这句在重启后应改回"index.recovery.mode=VALIDATE"

6. drop the database. Log into mysql as root or the alfresco user (defined by 'db.username' in custom-repository.properties)

mysql> drop database alfresco;
mysql> create database alfresco;

7. Config Tomcat

catalina.sh

#----------------------------------------------------------------
#  The -server   flag avoids problems on Linux and Mac.
#  The -Xmx1024M flag gives the JVM ample memory.
#----------------------------------------------------------------
if ! [[ "${CATALINA_OPTS}" =~ '-server' ]]; then
 CATALINA_OPTS="$CATALINA_OPTS -server"
fi

if ! [[ "${CATALINA_OPTS}" =~ '-Xmx' ]]; then
 CATALINA_OPTS="$CATALINA_OPTS -Xmx1024M"
fi

After starting Tomcat, you can verify that the -server and -Xmx1024M flags are set by issuing the command:

ps auxw | grep tomcat

or, prepare a new alfresco.bat to invoke tomcat with the JVM parameter, just like below:

set JAVA_OPTS=-Xms128m -Xmx512m -Xss96k -XX:MaxPermSize=128m -server
call "%CATALINA_HOME%\bin\startup.bat"





Alfresco Surf Platform


Building

http://wiki.alfresco.com/wiki/Surf_Platform


ant incremental-webframework-tomcat


/root/projects/web-framework/build/dist/alfwf.war

--------------------------------------

http://wiki.alfresco.com/wiki/Surf_Platform_-_Deployment_Configurations

ant incremental-surf-starter

./projects/web-framework/build/dist/surf.war

--------------------------------------