FAQ

General

  1. How do I configure Eclipse?
  2. Why I cannot access db "alf_[jetty,tomcat,jboss] "?
  3. Why do I get memory errors running jetty?

Release

  1. How do I release?
  2. Why my release process complains about svn LC_ALL variable?
  3. Why do I get Content integrity errors on restore running with jetty embedded/during release?

Dependency management

  1. Why for creating the archetype we need an older version of the archetype plugin?
  2. Why JTA can't be properly found on maven repos?

General

How do I configure Eclipse?
  • Run ' mvn eclipse:eclipse '
  • "Refresh" on your Eclipse project
[top]
Why I cannot access db "alf_[jetty,tomcat,jboss] "?

Remember to setup appropriate permissions for selected db / build profile. You have 2 methods to configure/remove your db:

  1. Properly edit tools/mysql/db_setup.sql and run from project home mysql -u root < tools/mysql/db_setup.sql
  2. if you use POM property 'alfresco.db.name' you have sql files already filtered (after process-resources phase), and run directly mysql -u root -p < target/classes/tools/[db_setup,db_remove].sql

[top]
Why do I get memory errors running jetty?

Run your build with : MAVEN_OPTS="-Xms256m -Xmx512m -XX:PermSize=128m" mvn jetty:[run-war,run-exploded]

[top]

Release

How do I release?
  • Uncommenting in generated POM svn.tags.url and maven-release-plugin configuration
  • Ensuring dryRun="false" element in that configuration
  • Running a single command: mvn release:prepare release:perforn
[top]
Why my release process complains about svn LC_ALL variable?

If underlying svn complains about LC_ALL variable please consider running your release prepending: LC_ALL="C" (macosx environments, see http://svn.haxx.se/users/archive-2006-07/0320.shtml)

[top]
Why do I get Content integrity errors on restore running with jetty embedded/during release?

Did you remove also alf_data_jetty (or how you renamed it) apart from the alf_jetty (or how you renamed it) db ;) ?

[top]

Dependency management

Why for creating the archetype we need an older version of the archetype plugin?

As described here the -DremoteRepositories switch is broken in the latest versions of the maven-archetype-archetype-plugin and that's why in the command line for creating an artifact we manually specify an older version of the plugin: mvn org.apache.maven.plugins:maven-archetype-plugin:1.0-alpha-7:create ... ... ...

[top]
Why JTA can't be properly found on maven repos?

Due to redistribution problems you have to install JTA manuall when you need it with: - Download jta-1_0_1B-classes.zip from http://java.sun.com/products/jta/ - mvn install:install-file -Dfile=./jta-1_0_1B-classes.zip -DgroupId=jta -DartifactId=jta -Dversion=1.0.1B -Dpackaging=jar

[top]