Wednesday, March 3, 2010

Tip: Setting Alfresco Global Properties

Configuration of Alfresco can be a bit challenging.  It takes some time to get a feel for which file needs to be modified and what directory that file is in.  Part of the reason for the number of files has to do with the fact that Alfresco is based on Spring, and Alfresco has adopted Spring configuration methodology.

In Alfresco 3.2 some of the complexity around finding where to make a configuration change has been simplified.  Alfresco introduces the concept of the alfresco-globals.properties file.  This new file tries to centralize as much as possible basic Alfresco configuration parameters  and settings.

alfresco-globals is basically a global override file.  The goals was to try to simplify common configuration settings into a single file.  Rather than centralizing everything into one file, which would be quite large and unwieldy, parameters defined in this file override parameters defined elsewhere in the standard configuration files used up until now.

After a full Windows install of an Alfresco 3.2+ system, you'll find this file in your tomcat\shared\classes directory. It will contain some of the settings selected during the installation process, like database connection information.  If the file isn't already there, you can find a template for it here:
   ..../tomcat/webapps/alfresco/WEB-INF/classes/alfresco-global.properties.sample

Some of the most common settings that are configured in Alfresco that can now be set/overridden by values in  alfresco-global file include parameters from these files:
..../tomcat/webapps/alfresco/WEB-INF/classes/alfresco/repository.properties
..../tomcat/webapps/alfresco/WEB-INF/classes/alfresco/hibernate-cfg.properties


Override values for Alfresco subsystems are also set in the alfresco-global.properties file.

No comments:

Post a Comment