Close
Alfresco Content Services

Configuring

Use this information to configure Alfresco Content Services.

  • Configuration overview
    Alfresco Content Services is preconfigured with a set of system configuration parameters. Many of the system configuration parameters are completely exposed as properties, which you can configure for your specific environment requirements.
  • Configuring subsystems
    A subsystem is a configurable module responsible for a sub-part of Alfresco Content Services functionality. Typically, a subsystem wraps an optional functional area, such as IMAP bindings, or one with several alternative implementations, such as authentication.
  • Configuring databases
    Use this information to configure supported databases for use with Alfresco Content Services.
  • Configuring the repository
    Use this information to configure the Alfresco Content Services repository.
  • Configuring file servers
    The File Server subsystem allows access to the Alfresco Content Services data stores through the SMB/CIFS and FTP protocols. This allows you to browse to the repository using Windows Explorer or by creating a Network Place.
  • Configuring email
    Use this information to configure email services, including inbound and outbound email, subscriptions, and email clients.
  • Configuring email templates using v1 REST APIs
    Use this information to configure customized email templates for your registered applications using the v1 REST APIs.
  • Configuring LibreOffice
    You can transform a document from one format to another using the LibreOffice subsystem. This feature requires you to install LibreOffice.
  • Configuring ActiveMQ
    Alfresco Content Services uses ActiveMQ for message queuing with various products, for example, Alfresco Media Management.
  • Configuring Smart Folders
    Smart Folders organize your content so that you can store files across your organization, but view them based on information requirement, not location.
  • Content modeling with Model Manager
    Model Manager allows you to create and manage your own custom models in Alfresco Share. This is a user-friendly tool that enables you to add custom types, aspects, and properties to your models. Alfresco Content Services provides several out-of-the-box content models for specifying the core content types in the repository.
  • Configuring Alfresco Mobile
    Alfresco Content Services Administrators can easily define the experience for their Alfresco Mobile users by choosing what each user sees in the Alfresco Mobile menu.

Configuration overview

Alfresco Content Services is preconfigured with a set of system configuration parameters. Many of the system configuration parameters are completely exposed as properties, which you can configure for your specific environment requirements.

Use the following methods to configure Alfresco Content Services:

  • Admin Console
  • Share Admin Tools
  • Editing the global properties
  • Using a JMX client, such as JConsole

CAUTION:

If you use multiple configuration methods, updates made using a JMX client will override any other settings, and updates in the Admin Console and Admin Tools override settings in alfresco-global.properties. These settings also persist in the database, and are not reflected back into the alfresco-global.properties file.

Admin Console

The Admin Console is an administrator’s tool to manage your configuration. You can run the Admin Console from a browser without having to start Share. See Using the Admin Console for more information.

Share Admin Tools

Share Admin Tools is an administrator’s tool to create and manage users and groups from Alfresco Share, set application preferences, manage categories and tags, and browse the system information in the node browser. See Using the Alfresco Share Admin Tools for more information.

Global properties file

The global properties file (alfresco-global.properties) is used to detect extended properties. For example, when you install Alfresco Content Services, many of the installation settings are saved in the global properties file. The global properties file is used to detect the extended properties. You can use the global properties to set all your property settings; whenever you make a change, you must restart the server to apply those changes. See Using the alfresco-global.properties file for more information.

Alfresco Content Services 5.2.7 provides a range of new properties for configuring your installation. These properties can be set in the alfresco-global.properties file.

JMX client

The JMX client allows you to edit the settings while the system is running. The settings you change are automatically persisted in the database and synchronized across a cluster. When you start up Alfresco Content Services, the system initially uses the alfresco-global.properties file to set the properties in the JMX client, but then any changes you make in the JMX client persist in the database but are not reflected back into the alfresco-global.properties file. See Using a JMX client to change settings dynamically for more information.

  • Using the alfresco-global.properties file
    The global properties alfresco-global.properties file contains the customizations for extending Alfresco Content Services.
  • Disabling Alfresco Content Services features
    You can disable common product components, if you do not require them for your Alfresco Content Services instance. This summary gives the example property settings for disabling the main components.
  • Using a JMX client to change settings dynamically
    You can reconfigure Alfresco Content Services by shutting down the server, editing the relevant property in the configuration files, and then restarting the server. If you have installed the Oracle Java SE Development Kit (JDK), and have enabled JMX in your configuration files, there are some support operations that can be performed at runtime without needing to restart the server.
  • Using the Java command line to change settings dynamically
    All Alfresco Content Services properties can be set using the standard alfresco-global.properties configuration file. There might be circumstances where it is more convenient to change properties on the fly. The Java command line provides an alternative method of setting the properties.
  • Customizing applications
    You can make basic configuration updates to customize Alfresco Content Services, or modify properties files to apply configuration changes.
  • Customizing individual configuration items
    Use this information to understand the types of configuration files available in Alfresco Content Services, and how to configure them.

Using the alfresco-global.properties file

The global properties alfresco-global.properties file contains the customizations for extending Alfresco Content Services.

If you install using one of the installation wizards, the alfresco-global.properties file is modified with the settings that you chose during installation. If you install manually using the WAR file, you can modify properties in the alfresco-global.properties file.

A sample global properties file is supplied with the installation. By default, the file contains sample settings for running Alfresco Content Services, for example, the location of the content and index data, the database connection properties, the location of third-party software, and database driver properties.

Modifying the global properties file

Use this information when modifying the alfresco-global.properties file.

Important: For edits to the alfresco-global.properties file, when specifying paths for Windows systems, you must replace the Windows path separator characters with either the \\ separator or the forward slash / Unix path separator.

The alfresco-global.properties file is created when you install Alfresco Content Services with the setup wizards, and it logs many of the settings that you specify in the process. You can then use this file to add further property settings. If you are installing manually, then you can use the alfresco-global.properties.sample file. The .sample file contains some of the common properties required for setting up Alfresco Content Services.

  1. Locate and open the alfresco-global.properties.sample file.

    For example, for Tomcat, browse to the $TOMCAT_HOME/shared/classes/ directory.

    This file contains sample configuration settings. To enable or modify a setting, remove the comment (#) character. Comment out all the properties you do not want to modify by adding the “#” character.

  2. Ensure that the dir.root= property points to a root location for the storage of content binaries and index files.

    For example, dir.root=/var/data/alfresco/alf_data.

    Note: It is strongly recommended that you always set this value to an absolute file system path as shown above. This ensures that no matter how the instance is started, it will always find the directories where content has previously been written.

  3. Set the database connection properties.

    Property Description
    db.username=alfresco Specifies the name of the main database user. This name is used to authenticate with the database.
    db.password=alfresco Specifies the password for the database user. This password is used to authenticate with the database.

    Additional database properties can be set for further configuration. See Configuring databases for more information.

  4. Specify the locations of the following external software:

    Property Description
    ooo.exe= Specifies the location of the LibreOffice installation.
    ooo.enabled= Specifies whether to use the Direct LibreOffice subsystem.
    jodconverter.officeHome= Specifies the location of the LibreOffice installation for JODConverter transformations. To use the JODConverter, uncomment the ooo.enabled=false and jodconverter.enabled=true properties.
    jodconverter.portNumbers= Specifies the port numbers used by each JODConverter processing thread. The number of process will match the number of ports.
    jodconverter.enabled= Specifies whether to use the JODConverter. Set the property to jodconverter.enabled=true.
    img.root= Specifies the location of the ImageMagick installation.

  5. Configure your supported database for use. See Configuring databases.

  6. Select a JDBC driver used with each connection type.

  7. Add your global custom configurations.

    Note: Ensure that you use single-byte character sets (ISO-8859-1 Latin 1) in your alfresco-global.properties settings, particularly the system.webdav.rootPath setting. If you require other characters, you can use Unicode equivalents. For example, if your root path in Cyrillic was фолдер, which means folder in English, a valid value would be:

    system.webdav.rootPath=/app:company_home/cm:\u0444\u043E\u043B\u0434\u0435\u0440

  8. Save your file without the .sample extension.

You need to restart the server for the configuration changes to take effect.

Setting composite properties in the global properties file

The imap.server.mountPoints property is used as an example for setting composite properties.

The ImapConfigMountPointsBean class that holds the component beans has four properties of its own:

  • beanName
  • store
  • rootPath
  • mode

  1. Open the /alfresco-global.properties file.

  2. To set some overall defaults for all component instances, use the format:

    <property>.default.<component property>

    These values would show up, for example, when you added a new component instance but did not specify its properties.

    For example:

    imap.server.mountPoints.default.store=${spaces.store}
imap.server.mountPoints.default.rootPath=/${spaces.company_home.childname}
imap.server.mountPoints.default.mode=virtual

    This example does not define a default for beanName because there is a way of populating it for each instance.

  3. To set up the imap.server.mountPoints with a composite value, set the master composite property using a comma-separated list.

    For example:

    imap.server.mountPoints=Repository_virtual,Repository_archive

    This defines that the property contains two ImapConfigMountPointsBean instances, named Repository_virtual and Repository_archive. Because ImapConfigMountPointsBean implements the BeanNameAware Spring interface and has a beanName property, these instance names are automatically set as the bean names.

  4. To define component properties specific to each component instance, use the format:

    <property>.value.<component instance name>.<component property>

    For example:

    imap.server.mountPoints.value.Repository_virtual.mode=virtual
imap.server.mountPoints.value.Repository_archive.mode=archive

Disabling Alfresco Content Services features

You can disable common product components, if you do not require them for your Alfresco Content Services instance. This summary gives the example property settings for disabling the main components.

Note: If you are unsure of the effect of disabling a feature, contact Alfresco Support for recommendations.

Add the following property settings to the alfresco-global.properties file:

Property Description
system.usages.enabled=false Disables quotas or user usages.
   
audit.enabled=false Specifies a way to globally enable or disable the auditing framework.
cifs.enabled=false Specifies whether to enable or disable the CIFS server.
sync.mode=OFF Use this property to disable synchronization permanently.
audit.alfresco-access.enabled=false Disables generation of audit data.
home.folder.creation.eager=false Use this property to create home folders (unless it is disabled using the home.folder.creation.disabled=true property) when people are created (true) or created lazily (false).

Lazy creation (false) means that the home folder will not be created when the user is created.

   
home.folder.creation.disabled=true Disables the creation of home folders.
   
db.schema.update=false Specifies whether the system bootstrap should create or upgrade the database schema automatically.
activities.feed.notifier.enabled=false Disables the Share Activities email notification.

Note: The system.workflow.engine.activiti.enabled property is no longer available.

Using a JMX client to change settings dynamically

You can reconfigure Alfresco Content Services by shutting down the server, editing the relevant property in the configuration files, and then restarting the server. If you have installed the Oracle Java SE Development Kit (JDK), and have enabled JMX in your configuration files, there are some support operations that can be performed at runtime without needing to restart the server.

The Java Management Extension (JMX) interface allows you to access Alfresco Content Services through a standard JMX console that supports JMX Remoting (JSR-160). This lets you:

  • Manage subsystems
  • Change log levels
  • Enable or disable file servers (FTP/CIFS)
  • Set server read-only mode
  • Set server single-user mode
  • Set server maximum user limit, including ability to prevent further logins
  • Count user sessions/tickets
  • User session/ticket invalidation

CAUTION:

Restrict JMX RMI connections to an internal administration group, due to security vulnerabilities. JMX/RMI deserializes data from a client before authentication, which means that password protection does not provide adequate security.

Example consoles include:

  • JConsole (supplied with Java SE 5.0 and higher)
  • MC4J
  • JManage

Some of these consoles also provide basic graphs and/or alerts for monitoring JMX-managed attributes.

There are two types of property that you can edit using a JMX interface:

  • Type 1: Properties specified directly in XML files

    For example:

    <bean id="wcm_deployment_receiver"
class="org.alfresco.repo.management.subsystems.ChildApplicationContextFactory"
        <parent="abstractPropertyBackedBean">
        <property name="autoStart">
                <value>true</value>
        </property>
</bean>

    The value for the property autoStart is set to true directly in the wcm-bootstrap-context.xml file.

  • Type 2: Properties set by variables in XML files

    For example:

    <bean id="userInstallationURI" class="org.alfresco.util.OpenOfficeURI">
      <constructor-arg>
         <value>${ooo.user}</value>
      </constructor-arg>
   </bean>

    The value for the property constructor-arg is replaced with a variable ${ooo.user}.

When Alfresco Content Services starts up, type 1 properties are read from the XML file; type 2 properties get their values read from all the various property files. Then, the database is checked to see if there are any property values set there, and if any property has been changed, this value is used instead.

Some of the type 2 properties can be viewed and changed by the JMX console, some cannot. For example. ooo.exe can be viewed and changed using the JMX client; index.recovery.mode cannot be viewed or changed using the JMX client.

In a new installation, none of these properties are stored in the database. If you set a property using the JMX interface, Alfresco Content Services stores the value of the property in the database. If you never use JMX to set the value of a property, you can continue using the alfresco-global.properties file to set the value of the property. Once you change the property setting using JMX, and it is therefore stored in the database, you cannot use the properties files to change the value of that property.

Note: For advanced configuration, you can also extend or override the Spring bean definitions that control the Java classes. To do so, add or copy a Spring bean file named *-context.xml to the directory, or directory to extend Share. For examples of the Spring bean extensions, download the sample extension files.

  • Connecting through JMX
    Remote JMX functionality is disabled by default. You can connect to the Alfresco Content Services MBean server through a JMX client that supports JSR-160 by editing your settings.
  • Configuring with JConsole
    If you have installed the Oracle Java SE Development Kit (JDK), you can use the JMX client, JConsole, for runtime administration.
  • JMX monitoring and management extensions
    This information describes the JMX-based monitoring and management functionality.

Connecting through JMX

Remote JMX functionality is disabled by default. You can connect to the Alfresco Content Services MBean server through a JMX client that supports JSR-160 by editing your settings.

CAUTION:

Restrict JMX RMI connections to an internal administration group, due to security vulnerabilities. JMX/RMI deserializes data from a client before authentication, which means that password protection does not provide adequate security.

  1. Ensure that you have this setting in your java_opts file:

    -Dcom.sun.management.jmxremote

    This tells the running JVM to start the JMX service.

  2. Ensure that you have the following properties set in the alfresco-global.properties file:

    alfresco.jmx.connector.enabled=true
alfresco.rmi.services.port=50500
alfresco.rmi.services.host=<hostname>

    Check that the <hostname> can be resolved from where you are running the JMX client.

  3. Open a JMX client that supports JMX Remoting (JSR-160).

  4. Connect to the JMX URL:

    service:jmx:rmi:///jndi/rmi://<hostname>:50500/alfresco/jmxrmi

    Where <hostname> is the name of a reachable domain name or an IP address. If you running this on the local server, you can use localhost.

  5. Enter the default JMX user name: controlRole

  6. Enter the default JMX password: change_asap

    Important: You must change the default JMX password as soon as possible.

    The user controlRole is the default user name used to access and configure with a JMX client.

    The user monitorRole is the default user name used within monitoring tools, for example, Nagios or Hyperic.

  7. Change the default JMX password as soon as possible. You can set a new password in override configuration files.

    Create two new files called:

    alfresco-jmxrmi.password
alfresco-jmxrmi.access

    Copy the files to a location of your choice and then add the alfresco.jmx.dir= property to the alfresco-global.properties file to specify the directory path of the configuration files. For example:

    alfresco.jmx.dir=/etc/alfresco/config

    You can also set this on the command line:

    -Dalfresco.jmx.dir=/etc/alfresco/config

  8. Open the alfresco-jmxrmi.password file and add the following properties for the monitorRole and controlRole users, where new_pw is your preferred password.

    monitorRole  new_pw
controlRole  new_pw

  9. Save the file.

  10. Open the alfresco-jmxrmi.access file and add the following properties for the read-only or read/write access levels of each user.

    monitorRole   readonly
controlRole   readwrite

  11. Save the file.

Note: It is possible to set the JVM (Oracle/Sun JVM-specific) arguments directly:

-Dcom.sun.management.jmxremote
-Dcom.sun.management.jmxremote.ssl=false
-Dcom.sun.management.jmxremote.access.file=/etc/alfresco/config/jmxremote.access
-Dcom.sun.management.jmxremote.password.file=/etc/alfresco/config/jmxremote.password
-Dcom.sun.management.jmxremote.authenticate=true

Configuring with JConsole

If you have installed the Oracle Java SE Development Kit (JDK), you can use the JMX client, JConsole, for runtime administration.

The initial configuration that displays in JConsole is set from the alfresco-global.properties file.

  1. Open a command console.

  2. Locate your JDK installation directory.

    For example, the JDK directory is often java/bin.

  3. Enter the following command:

    jconsole

    The JConsole New Connection window displays.

  4. Double-click on the Alfresco Content Services Java process.

    For Tomcat, this the Java process is usually labelled as org.apache.catalina.startup.Bootstrap start.

    JConsole connects to the managed bean (or MBean) server hosting the subsystems.

  5. Select the MBeans tab.

    The available managed beans display in JConsole.

  6. Navigate to Alfresco > Configuration.

    The available subsystems display in an expandable tree structure. When you select a subsystem, the Attributes and Operations display below it in the tree.

  7. Select Attributes and set the required subsystem attribute values.

    Values that can be edited are shown with blue text.

    When you change a configuration setting, the subsystem automatically stops.

  8. Restart the subsystem:

    1. Navigate to the subsystem.

    2. Select Operations.

    3. Click Start.

  9. To stop the subsystem without editing any properties:

    1. Navigate to the subsystem.

    2. Select Operations.

    3. Click Stop.

  10. To revert back to all the previous edits of the subsystem and restores the default settings:

    1. Navigate to the subsystem.

    2. Select Operations.

    3. Click Revert.

  11. Click Connection > Close.

The settings that you change in a JMX client, like JConsole, are persisted in the database. When you make a dynamic edit to a subsystem:

  1. When a subsystem, that is currently running, is stopped, its resources are released and it stops actively listening for events. This action is like a sub-part of the server being brought down. This ‘stop’ event is broadcast across the cluster so that the subsystem is brought down simultaneously in all nodes.
  2. The new value for the property is persisted to the database.

There are two ways to trigger a subsystem to start:

  • The start operation
  • An event that requires the subsystem

JMX monitoring and management extensions

This information describes the JMX-based monitoring and management functionality.

The monitoring and management extensions can be subdivided into three categories:

  • Read-only monitoring beans

    Expose a variety of real-time metrics for monitoring health and throughput of your server.

  • Configuration beans

    Provide an easily navigable view of key system configuration for support and diagnostic purposes.

  • Management beans

    Allow control over various subsystems.

For more information on these categories of bean, refer to the reference section JMX bean categories. You can also manage JMX settings in the Admin Console JMX Settings.

  • Coexistence with other MBeans
    If there is an MBean server already running on the Java Virtual Machine (JVM) that Alfresco Content Services is running on, Alfresco Content Services will export its MBeans to that server. Otherwise, Alfresco Content Services will start up its own MBean server. This means that, for example, on Tomcat, the Alfresco Content Services beans will complement those provided by the application server and will be navigable in the same context with a suitable JMX client.
  • Activating the Oracle JMX agent and local JMX connectivity
    When using Tomcat and a Oracle JVM together for monitoring, you can configure Alfresco Content Services and Tomcat to share the JVM’s own platform MBean server. The pre-registered MXBeans give a detailed view of the JVM’s health, usage and throughput; in areas including class loading, hot spot compilation, garbage collection, and thread activity.

Coexistence with other MBeans

If there is an MBean server already running on the Java Virtual Machine (JVM) that Alfresco Content Services is running on, Alfresco Content Services will export its MBeans to that server. Otherwise, Alfresco Content Services will start up its own MBean server. This means that, for example, on Tomcat, the Alfresco Content Services beans will complement those provided by the application server and will be navigable in the same context with a suitable JMX client.

Activating the Oracle JMX agent and local JMX connectivity

When using Tomcat and a Oracle JVM together for monitoring, you can configure Alfresco Content Services and Tomcat to share the JVM’s own platform MBean server. The pre-registered MXBeans give a detailed view of the JVM’s health, usage and throughput; in areas including class loading, hot spot compilation, garbage collection, and thread activity.

Oracle’s MBean server also provides a convenient local connection method, allowing the process to be automatically ‘discovered’ by a JMX client such as JConsole without manual configuration of connection details.

The Oracle JMX agent can also be activated in remote mode (where a connection is made through an RMI lookup). However, since Alfresco Content Services is always preconfigured to allow a secure remote JMX connection on any JVM, it is most likely that you will choose to activate the Oracle JMX agent in local mode. This means the platform MBean Server is shared by Alfresco Content Services and still be available for remote connections through the RMI connector.

CAUTION:

Restrict JMX RMI connections to an internal administration group, due to security vulnerabilities. JMX/RMI deserializes data from a client before authentication, which means that password protection does not provide adequate security.

  • To activate the Oracle JMX agent in local mode, ensure that the following system property is set:

    com.sun.management.jmxremote

    For example, in your Tomcat startup script, you could use the following line:

    export JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote"

  • Refer to the Oracle documentation for more information on all the possible configuration options.

Using the Java command line to change settings dynamically

All Alfresco Content Services properties can be set using the standard alfresco-global.properties configuration file. There might be circumstances where it is more convenient to change properties on the fly. The Java command line provides an alternative method of setting the properties.

The most common use of the Java command line is in a multiple-machine environment where the basic, common customizations are set using standard properties and the machine-specific values are set using command line options.

For example, an administrator is likely to configure all installs to behave similarly by setting properties in the configuration files, but will use the Java command line to vary settings like the database connection, Content Store locations, and CIFS domain name.

You can use the -D options for setting properties on the Java command line. Add a -Dprop=value to JAVA_OPTS, or for anything that is sent to the Java command line, for example:

-Ddir.root=/alfresco/data -Ddb.url=xxxx

Customizing applications

You can make basic configuration updates to customize Alfresco Content Services, or modify properties files to apply configuration changes.

  • Updating system configuration parameters: You can configure Alfresco Content Services for your specific environment requirements either by using the Admin Console, or by editing the alfresco-global.properties file, or by using a JMX client.
  • Configuring Alfresco Share: A number of options are available to customize Share. To configure Share, use the configuration file named share-config-custom.xml.
  • Solr configuration: When you install Alfresco Content Services, several Solr-related configuration files are made available to you. To configure Solr, use the configuration file named solrcore.properties.

Note: Remember not to use the default user names, URLs, or passwords with different environment.

Note: You can customize or scale up to meet your login and security requirements. See Setting up authentication and security for more information.

Customizing individual configuration items

Use this information to understand the types of configuration files available in Alfresco Content Services, and how to configure them.

Configuration is implemented using three types of files:

  • Extension files
  • Bean files

  • Spring bean definitions

  • Customizing extension files
    Extension files end with the extension .xml, and define <config> tags. A typical configuration file is /share-config-custom.xml.
  • Modifying Spring bean definition files
    For advanced configuration, you can also extend or override the Spring bean definitions that control the Alfresco Content Services Java classes.
  • Customizing the Activity Email Summary
    The Activity Email Summary ignores certain activity types by default. Use this information to override the Spring bean definition to include these activity types.
  • Customizing bean files
    Bean files end with the extension .xml and contain <bean> tags. You can modify <bean> tags to define properties or point to customized files.

Customizing extension files

Extension files end with the extension .xml, and define <config> tags. A typical configuration file is /share-config-custom.xml.

A configuration file contains <alfresco-config> tags outside the <config> tags. You must preserve these tags in your customized file.

  1. Open the configuration file that you want to customize.

  2. Edit each pair of <config> </config> tags that you want to modify.

    Replacing a configuration

    To replace the configuration, add a replace=“true” attribute to the configuration element. For example: <config evaluator="xx" condition=“yy” replace=“true”>

    Attention: Any configuration within a section marked this way completely replaces any configuration found in the Alfresco Content Services-maintained files.

    Modifying one property

    The attribute replace completely replaces the configuration. To modify one property, add the changed piece.

  3. Save your customized file.

Modifying Spring bean definition files

For advanced configuration, you can also extend or override the Spring bean definitions that control the Alfresco Content Services Java classes.

The Spring bean definitions are within configuration files in the following directories:

  • The directory contains the configuration files for extending Alfresco Content Services.
  • The directory contains the configuration files for extending Alfresco Share.

  1. Browse to the directory. For example, for Tomcat:

    • (Windows) C:\Alfresco\tomcat\shared\classes\alfresco\extension
    • (Linux) tomcat/shared/classes/alfresco/extension Each file has a copy with a .sample extension.

  2. Open the configuration file with the .sample extension.

  3. Add your configurations to the file.

  4. Save the file without the .sample extension.

Customizing the Activity Email Summary

The Activity Email Summary ignores certain activity types by default. Use this information to override the Spring bean definition to include these activity types.

The Spring bean definition for the ActivitiesFeed subsystem is called activities-feed-context.xml and can be downloaded from the Alfresco SVN: activities-feed-context.xml.

  1. Download the file and save to the <subsystems/ActivitiesFeed/default> directory.

    The file contains the following bean override for the file-previewed and file-downloaded values:

    <?xml version='1.0' encoding='UTF-8'?>
<beans xmlns="http://www.springframework.org/schema/beans"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd">
 <bean id="feedModelBuilderPrototype" class="org.alfresco.repo.activities.feed.DefaultActivitiesFeedModelBuilder" scope="prototype">
 <property name="ignoredActivityTypes">
  <set>
   <value>org.alfresco.documentlibrary.file-previewed</value>
   <value>org.alfresco.documentlibrary.file-downloaded</value>
  </set>
 </property>
 </bean>
</beans>

  2. Remove or comment out the following lines to include the file-previewed and file-downloaded entries in your Activity Email Summary:

    <property name="ignoredActivityTypes">
 <set>
 <value>org.alfresco.documentlibrary.file-previewed</value>
 <value>org.alfresco.documentlibrary.file-downloaded</value>
 </set>
</property>

  3. Save your file.

Customizing bean files

Bean files end with the extension .xml and contain <bean> tags. You can modify <bean> tags to define properties or point to customized files.

There are two common uses of beans:

  • To define properties
  • To point to one or more of your customized files

A typical bean file is /custom-repository-context.xml. A bean file contains `<?xml>` and `<!DOCTYPE>` headers, and `` tags outside the `` tags. You must preserve these items in your customized file.

Important:

When you override a <bean>, the entire effects of the original bean are lost. The effect is the same as if you had overridden a <config> by using replace="true". Therefore, the overriding <bean> must contain any information from the default bean that you want to keep, as well as any additional information.

For example, if a core bean has four values, and you want to modify a single value, the resultant bean must still have four values. However, if you want to add a value, then the resultant bean must have five values - the original four values plus the added value.

  1. Open the bean file that you want to customize.

    For example, the following <bean> is from the /classes/alfresco/action-services-context.xml file:

    <bean id="mail" class="org.alfresco.repo.action.executer.MailActionExecuter" 
 parent="action-executer">
   <property name="publicAction">
      <value>true</value> <!-- setting to true -->
   </property>
   <property name="mailService">
      <ref bean="mailService"></ref>
   </property>
</bean>

  2. Delete each pair of <bean> </bean> tags that you do not want to modify.

  3. Modify the contents of the remaining <bean> tags.

    For example, the following overrides the publicAction property from the previous example:

    <bean id="mail" class="org.alfresco.repo.action.executer.MailActionExecuter" 
 parent="action-executer">
   <property name="publicAction">
      <value>false</value> <!-- setting to false -->
   </property>
   <property name="mailService">
      <ref bean="mailService"></ref>
   </property>
</bean>

  4. Save the file.

Edit this page

Suggest an edit on GitHub
By clicking "Accept Cookies", you agree to the storing of cookies on your device to enhance site navigation, analyze site usage, and assist in our marketing efforts. View Cookie Policy.