Alfresco Content Management Solutions

Alfresco Cluster Node Identification

2017-07-08T13:04:00.002+05:30

When alfresco is under multiple nodes and we want to know where our request goes and on which node, by default it is hard to find where actual request redirected.

You can change below things and afterwards you are able to see node details

#1. Open tomcat/conf/server.xml
#2. Search <Engine name="Catalina" defaultHost="localhost">

#3. Looks like

#4. Update that configuration to your node specific

#5. It should now looks like below

#6. Restart alfresco

#7. After starting alfresco you come to know by inspect element in browser

like below

Alfresco 5.x Solr Tuning Tips

2017-03-31T12:37:00.003+05:30

Searching on alfresco system should be efficient and utilize solr in effective way. By default there are many factors we are not able to pin point or not taken into consideration
For Solr optimizations let follow below practices:

Tuning Criteria

If you are not using search functionality on deleted content , then better you should disable archive core. (Edit inside solr.xml and commenting archive core)
If you only require searching on content or only metadata then disable full text searching for that make property like alfresco.index.transformContent=false
On intranet if that is secure enough do not use SSL that may be overhead.
Use local storage instead shared folders, use faster hardware RAID/SSD.
Tune mergeFactor to 25 better for indexing and 2 for search.
Tune ramBufferSize in solrconfig.xml, it is by default 32MB we need to tune it.
Configure transformation timeout.
Increase index batch count to get more result on your indexing webscript
Disable unnecessary services from OS
Enable jodConvertor instead LibreOffice
Regularly cleanup trashcan data.

Running Solr NonSSL way - Alfresco 5.x

2017-03-11T17:40:00.000+05:30

Many times we are keeping default configuration with Alfresco -> SOLR communication.
Sometime we require that they want to communicate without SSL (https) communication to reduce network overhead and security impact performance.

So to turn off Alfresco repository and solr server communication via SSL, we are following below steps useful to us.

For Alfresco Repository configuration

Set solr.secureComms=none in alfresco-global.properties file
Make sure solr.port you set is non-ssl in application config where solr is running.
For the below path

<solrRootDir>/archive-SpacesStore/conf/solrcore.properties

<solrRootDir>/workspace-SpacesStore/conf/solrcore.properties

set alfresco.secureComms=none
verify alfresco.port is set to nonSSL port.

Inside repository web.xml remove below block

<security-constraint>
   <web-resource-collection>
       <web-resource-name>SOLR</web-resource-name>
       <url-pattern>/service/api/solr/*</url-pattern>
   </web-resource-collection>

   <auth-constraint>
       <role-name>repoclient</role-name>
   </auth-constraint>

   <user-data-constraint>
       <transport-guarantee>CONFIDENTIAL</transport-guarantee>
   </user-data-constraint>
</security-constraint>

<security-constraint>
   <web-resource-collection>
       <web-resource-name>SOLR</web-resource-name>
       <url-pattern>/s/api/solr/*</url-pattern>
   </web-resource-collection>

   <auth-constraint>
       <role-name>repoclient</role-name>
   </auth-constraint>

   <user-data-constraint>
       <transport-guarantee>CONFIDENTIAL</transport-guarantee>
   </user-data-constraint>
</security-constraint>

<security-constraint>
    <web-resource-collection>
       <web-resource-name>SOLR</web-resource-name>
       <url-pattern>/wcservice/api/solr/*</url-pattern>
    </web-resource-collection>

    <auth-constraint>
       <role-name>repoclient</role-name>
    </auth-constraint>

    <user-data-constraint>
       <transport-guarantee>CONFIDENTIAL</transport-guarantee>
    </user-data-constraint>
</security-constraint>

<security-constraint>
    <web-resource-collection>
       <web-resource-name>SOLR</web-resource-name>
       <url-pattern>/wcs/api/solr/*</url-pattern>
    </web-resource-collection>

    <auth-constraint>
       <role-name>repoclient</role-name>
    </auth-constraint>

    <user-data-constraint>
       <transport-guarantee>CONFIDENTIAL</transport-guarantee>
    </user-data-constraint>
</security-constraint>

<login-config>
    <auth-method>CLIENT-CERT</auth-method>
    <realm-name>Repository</realm-name>
</login-config>

<security-role>
    <role-name>repoclient</role-name>
</security-role>

In solr web.xml remove below block

<security-constraint>
   <web-resource-collection>
      <url-pattern>/*</url-pattern>
   </web-resource-collection>
   <auth-constraint>
      <role-name>repository</role-name>
   </auth-constraint>
      <user-data-constraint>
         <transport-guarantee>CONFIDENTIAL</transport-guarantee>
      </user-data-constraint>
</security-constraint>
<login-config>
   <auth-method>CLIENT-CERT</auth-method>
      <realm-name>Solr</realm-name>
</login-config>
<security-role>
   <role-name>repository</role-name>
</security-role>

restart application server to take effect.

Setting up Nginx

2016-10-19T15:39:00.000+05:30

Nginx is tool to provide a web server. It can act as a reverse proxy server for TCP, UDP, HTTP, HTTPS, SMTP, POP3, and IMAP protocols, as well as a load balancer and an HTTP cache

Nginx is tool to provide a web server. It can act as a reverse proxy server for TCP, UDP, HTTP, HTTPS, SMTP, POP3, and IMAP protocols, as well as a load balancer and an HTTP cache

Installing and Getting Nginx
------------------------------
For CentOS Linux v6.x user type the following command:
# wget http://nginx.org/packages/centos/6/noarch/RPMS/nginx-release-centos-6-0.el6.ngx.noarch.rpm
# rpm -ivh nginx-release-centos-6-0.el6.ngx.noarch.rpm

For RHEL v6.x user type the following command:
# wget http://nginx.org/packages/rhel/6/noarch/RPMS/nginx-release-rhel-6-0.el6.ngx.noarch.rpm
# rpm -ivh nginx-release-rhel-6-0.el6.ngx.noarch.rpm

Installation
------------
yum install nginx

Turn Nginx service ON
----------------------
chkconfig nginx on

Command to start/stop services
------------------------------
# service nginx start
# service nginx stop
# service nginx restart
# service nginx status
# service nginx reload

Below are the useful links for configuration
-------------------------------------------
Default configuration directory: /etc/nginx/
Default SSL and vhost config directory: /etc/nginx/conf.d/
Default log file directory: /var/log/nginx/
Default document root directory: /usr/share/nginx/html
Default configuration file: /etc/nginx/nginx.conf
Default server access log file: /var/log/nginx/access.log
Default server access log file: /var/log/nginx/error.log

vi /etc/nginx/nginx.conf

Verify that everything is working:
# netstat -tulpn | grep :80
# ps aux | grep nginx

Firewall configuration: Open TCP port # 80

Edit the file /etc/sysconfig/iptables, enter:
# vi /etc/sysconfig/iptables

Add the following lines, ensuring that they appear before the final LOG and DROP lines for the INPUT chain to open port 80:

-A INPUT -m state --state NEW -p tcp --dport 80 -j ACCEPT
Save and close the file. Finally, restart the firewall:
# service iptables restart

Setting up Alfresco Cluster

2016-10-15T17:58:00.004+05:30

Setting up Alfresco Repository Cluster
===========================

Clustered environment is very beneficial when we are dealing with multiple node and require high availability to the application.
If any of the node is down, it is automatically served requests to other active node.
Clustered node are synced to each other.

There are no major steps to bind cluster in alfresco 5.1

Below are the requirement to keep nodes into repository cluster

Step 1 : Database is common
multiple node should be pointed out to single db in alfresco-global.properties file.

Step 2 : Content Store is common
Like DB, content store should be also pointed and shared among all nodes.

Step 3 : Enable cluster from Config
Enable setting via alfresco-global.properties file

alfresco.cluster.enabled = true

Above setting automatically enable clustering your nodes in repository.

Enable below setting in log4j.properties to see info statements

log4j.logger.org.alfresco.enterprise.repo.cluster=info

Alfresco ACA 5.1 Preparation

2016-10-15T17:52:00.000+05:30

Below are the helpful question sets for preparation

=================================

To configure alfresco in order to use LDAP server for authentication we use below properties file to configure new authentor

ANS : authentication.chain

For Alfresco groups, which is TRUE

ANS : Group can contain subgroup

Which two feature of share that is not available in web explorer of Alfresco

ANS : Multiple File upload , Separate share to other application

To build full reindex, amount of time depends on

ANS : proportional to size of content in repository

Which file used to install amp

ANS : alfresco-mmt.jar

While upgrade from 32bit to 64bit in alfresco what should be taken care

ANS : JVM to retuned , and same alfresco.war can redeploy

Which directory referred as {extensionRoot}

ANS : <TOMCAT_HOME>/shared/classes

When user join site as their own , which role is assigned to him

ANS : consumer

If we do DB related changes, like password which properties file we touch

ANS : alfresco-global.properties

URL to connect to alfresco via WebDav

ANS : <server>:<port>/alfresco/webdav

Alfresco 4.2f community startup problem

2015-03-20T17:33:00.000+05:30

Hello Friends,

I installed community alfresco 4.2f and run manually startup.bat file ,
at that time popup appears and suddenly disappeared.

I setup my JAVA_HOME properly still starage to see this issue. So I found that setenv.bat contains entry which is not proper to starting up the server. I changed it and server starts successfully.

Edit setenv.bat

old line
set JAVA_OPTS=++JvmOptions="-XX:-DisableExplicitGC" ++JvmOptions="-XX:ReservedCodeCacheSize=128m" --JvmMs 128 --JvmMx 768 ++JvmOptions="-XX:MaxPermSize=256M" %JAVA_OPTS%

new line
set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx768m -XX:MaxPermSize=256m -XX:-DisableExplicitGC -XX:ReservedCodeCacheSize=128m

Try to run startup.bat now.

Alfresco 4.2x - Administrator Console

2014-06-16T11:48:00.002+05:30

I could not find out alfresco "Repository Administration Console" in alfresco so I searched on google and from somewhere I am able to figure out URL they provide for repository management.

Alfresco should provide link in documentation atleast.

Here is the link

http://localhost:8080/alfresco/service/enterprise/admin/admin-systemsummary

------
Ghanshyam Rathod

Adding new alfresco 4.x theme

2014-05-27T14:58:00.000+05:30

When we want to create our own custom theme in alfresco we need to modify only few things.

I tried using alfresco 4.2.x

#1. Go to below location and add your new theme.

<alfresco_home>\tomcat\webapps\share\WEB-INF\classes\alfresco\site-data\themes
or
<alfresco_home>\tomcat\shared\classes\alfresco\web-extension\site-data\themes

#2. Copy Existing Theme and modify them.

<alfresco_home>\tomcat\webapps\share\themes

Modify all css / images accordingly.

Thats it....!!!

Remove welcome dashlet widget in alfresco share 4.x

2014-05-22T14:49:00.002+05:30

Many of us do not prefer welcome widget on home page.
We will show you way to remove this widget/dashlet on alfresco 4.x version

welcome dashlet looks like below

Go and edit following file :

#step:1

<alfresco_home>/tomcat/webapps/share/WEB-INF/classes/alfresco/site-webscripts/org/alfresco/components/dashlets/dynamic-welcome.get.html.ftl

#step:2
open file and find condition

<#if showDashlet>

#step:3

make it <#if false>

#step:4
refresh share side webscript

#step:5
refresh alfresco share page for dashlet (it now disappear)

Ghanshyam Rathod

Reindexing solr on Alfresco 4.x

2014-04-23T13:56:00.001+05:30

In certain condition we are not getting our nodes are in sync or while searching node are not appear in search. This is due to non-indexed nodes.

Re-index required to index those nodes.

Here are few steps you can consider to re-index solr.

Note: Here I assume you have single machine on which alfresco and solr running on same server.

#1 : First confirm solr core directories

you can find archive-SpacesStore and workspace-SpacesStore core directories.
you can determine location using solrcore.properties.

This properties file mostly in following location:
<alf_home>\alf_data\solr\workspace-SpacesStore\conf

#2 : Stop alfresco server

#3 : Delete the contents in following directories

- <alf_home>\alf_data\solr\workspace\SpacesStore

- <alf_home>\alf_data\solr\archive\SpacesStore

#4 : Delete the models in following directories

- <alf_home>\alf_data\solr\workspace-SpacesStore\alfrescoModels

- <alf_home>\alf_data\solr\archive-SpacesStore\alfrescoModels

#5 : Restart Alfresco/solr

- Start alfresco server which is having solr server

Custom Rule - Alfresco

2014-04-22T14:24:00.001+05:30

Custom rule is necessary when we want to perform our custom action based on content entry/update/deletion action.

When specific content enters into space, we will perform our custom action on it.
e.g. ranaming file/allow only specific type of files etc. etc.

Lets have steps to create custom rule
I have used alfresco 4.2.x version.

#1) context file [custom-rule-context.xml]

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE beans PUBLIC '-//SPRING//DTD BEAN//EN' 'http://www.springframework.org/dtd/spring-beans.dtd'>
<beans>
<bean id="custom-rule-executer" class="com.example.alfresco.repo.action.CustomRuleExecutor" parent="action-executer">
<property name="nodeService">
<ref bean="NodeService" />
</property> 
<property name="fileFolderService">
<ref bean="fileFolderService"/>
</property>
</bean>

<bean id="custom-rule-executer-messages" class="org.alfresco.i18n.ResourceBundleBootstrapComponent">
<property name="resourceBundles">
<list>
<value>alfresco.extension.custom-rule-messages</value>
</list>
</property>
</bean>
</beans>

#2) Properties File [custom-rule-messages.properties]

custom-rule-executer.title=My Custom Rule.

custom-rule-executer.description=This action will allow Custom Rule files.

custom-rule-executer.param_tags.display-label=My Custom Rule files.

#3) Custom Rule class [CustomRuleExecutor.java]

public class CustomRuleExecutor extends ActionExecuterAbstractBase {

 Logger logger = Logger.getLogger(CustomRuleExecutor.class);
 private NodeService nodeService;
 private FileFolderService fileFolderService;

@Override
 protected void executeImpl(Action action, NodeRef addedFile) {
try {

  //add your code here for custom action
} catch (InvalidNodeRefException ine) {
 logger.error("### Node Invalid");
 throw ine;
 } catch (FileExistsException e) {
 e.printStackTrace();
 
 } catch (FileNotFoundException e1) {
 e1.printStackTrace();
 
 }
}
 @Override
 protected void addParameterDefinitions(List<ParameterDefinition> arg0) {

 }
 public NodeService getNodeService() {
 return nodeService;
 }
 public void setNodeService(NodeService nodeService) {
 this.nodeService = nodeService;
 }


 public FileFolderService getFileFolderService() {
 return fileFolderService;
 }

 public void setFileFolderService(FileFolderService fileFolderService) {
 this.fileFolderService = fileFolderService;
 }
}

Place context file and properties file in /tomcat/shared/classes/alfresco/extension folder and
restart alfresco

===============
Ghanshyam Rathod

India

CIFS on windows 7

2014-04-07T12:24:00.002+05:30

You face problem like Your cifs working fine with Windows XP machines but not properly in Windows 7 .

Note: After reading many blogs having registry edits and other configuration, I found this way is somewhat fine to me. So posting it but could not explain this reason for this. May be CIFS binding name is mapped like this way.

Here are the few steps you can try to enable CIFS on windows 7 machines.

1. Get your computer name
for windows machine you can open command prompt and type "set" command.
find computer name.

e.g COMPUTERNAME = XYZMACHINE

2. APPEND CIFS PARAM to Computer Name
In our case letter "A" we are appending to this name
e.g. XYZMACHINEA

3. Make entry in hosts file
open hosts file from C:\Windows\System32\drivers\etc\
use some unused IP like below entry :
13.13.13.13 XYZMACHINEA

4. Restart and Map alfresco with CIFS
e.g. \\XYZMACHINEA\Alfresco

==========================
Ghanshyam Rathod
CIGNEX Datamatics Pvt Ltd.
India

Configure Alfresco Inbound Email in local machine

2014-04-03T14:00:00.002+05:30

Alfresco Inbound Email Configuration

When you want your email client send email directly to the alfresco, here is the inbound alfresco configuration.

Email client will connect to IMAP and SMTP server of alfresco itself and then put that email into specified space of alfresco. You know that alfresco acts as a IMAP and SMTP server as well.

I am using alfresco 4.2.1 (Lastest version as of now) on my local machine.

Lets start configure it :

Step 1 :

Best practice is not to override original alfresco files,

we will use alfresco-global.properties file.

location : <alfresco_home>/tomcat/shared/classes

### Inbound setting ###

email.inbound.unknownUser=anonymous

email.inbound.enabled=true

email.server.enabled=true

email.server.port=25

email.server.domain=cignexindia.com

email.server.allowed.senders=.*

###IMAP Configuration###

imap.server.enabled=true

imap.server.port=143

imap.server.host=localhost

### Outbound Email Configuration ###

mail.host=<your_smtp_server>

mail.port=25

mail.username=

mail.password=

##### Test SMTP setup ###

mail.testmessage.send=true

mail.testmessage.to=<test_email_to_send>

mail.testmessage.subject=Outbound SMTP

mail.testmessage.text=The Outbound SMTP email subsystem is working.

I am not explaining above properties as it is already mentioned in the forums/post/wiki.

Step 2 : Creating domain in host file

Open following file in your window's file system

hosts

location : C:\Windows\System32\drivers\etc

Add following entry :

127.0.0.1 cignexindia.com

save file and close it.

Note : This domain name can not be anything it should be your system domain only.

Step 3 : Configure Alfresco

Start Alfresco server and create users

e.g. Fred (username = fred) email = fred@cignexindia.com

Inbox (username = inbox) email = inbox@cignexindia.com

admin(username = admin) email = admin@cignexindia.com

e.g.

After creating sample users as above, add those users to EMAIL_CONTRIBUTORS group in alfresco.

e.g

Go to Company Home space, create Folder (Space) named “Inbound”

Apply Email Alias (Aspect) to it via Run Action

Give alias as “fred” as per our example.

Fred is existed user in alfresco.

Note : Email alias you should provide is exactly same as email id of user before "@<domain>"

e.g fred is alias then email id of fred in alfresco is fred@cignexindia.com

Step 4 : Open Mozilla Thunderbird and Configure it

We need to enable IMAP and SMTP on thunderbird to work with Inbound.

As we already activated IMAP and SMTP server in alfresco-global.properties file

e.g.

Configure new Email account <IMAP> in thunderbird,

In screenshot you can see, we have used user “fred” which is already there in alfresco and giving domain cignexindia.com as we specified in alfresco-global.properties file.

Then configure local SMTP server, alfresco already act as a SMTP server , so we just need to give our local alfresco to point out on 25 port.

You can configure in thunderbird by following way :

Open “Account Setting”
Select “Outgoing server (SMTP)
Click Add

It looks like below :

Now you are configured properly for Inbound on mozilla thunderbird.

You can see now thunderbird shows alfresco repository in its email client like below :

Step 5 : Send email from this IMAP account like below

When you see your email comes in your configured space.

==================================
Ghanshyam Rathod
CIGNEX Datamatics Pvt Ltd.
India

Creating new nodeRef - Alfresco API

2013-12-26T10:55:00.000+05:30

Sometime we need to create alfresco node and need to proceed that node. We can create alfresco node but for that we need store to choose, in which store that node will store its content.

e.g.

StoreRef storeRef = new StoreRef(StoreRef.PROTOCOL_WORKSPACE, "SpacesStore");
NodeRef nodeRef = new NodeRef(storeRef, "f8785545-beb0-4e4c-aedc-72a8db70bb30");

Here we used "SpacesStore" as the alfresco store area.

We can have following stores available :
archive://SpacesStore
system://system
user://alfrescoUserStore
workspace://lightWeightVersionStore
workspace://SpacesStore
workspace://version2Store

Sending email with attachment

2013-07-26T12:51:00.003+05:30

Sending email with attachment useful snippets :

Note: File is used to attach. If you are using nodeRef then you need to read those content and write to some file.

we are using <org.springframework.mail.javamail.JavaMailSender>

public void sendEmailWithAttachmentToListUsers(String from, List<String> emails, String subject, String body, String report_name, File fileObj) {
try
 {
 MimeMessage mimeMessage = mailSender.createMimeMessage();
 MimeMessageHelper helper = new MimeMessageHelper(mimeMessage,true); 
 helper.setSubject(subject);
 helper.setText(body,true);
 helper.setFrom(new InternetAddress(from));
 helper.setTo(getAddresses(emails));
 //add attachment
 FileSystemResource file = new FileSystemResource(fileObj.getAbsolutePath());
 helper.addAttachment(report_name + ".zip", file);
 mailSender.send(mimeMessage);
 logger.debug("## Email sent to -> "+ emails);
 }
 catch(MessagingException me)
 {
 logger.error(me);
}
}

//Method getAddresses

private static InternetAddress[] getAddresses(List<String> emailIds)
 {
   InternetAddress[] toAddresses = new InternetAddress[emailIds.size()];
 try
 { 
   for(int i=0; i<emailIds.size();i++ )
 {
    toAddresses[i] = new InternetAddress(emailIds.get(i));
 }
}
 catch(AddressException ae)
 {
 logger.error(ae);
 }
 return toAddresses;
}

Getting nodeRef via resolveNamePath

2013-07-26T12:20:00.002+05:30

Another way using we can get nodeRef of the content / folder in alfresco.

e.g If we have folder structure in DM is like below :
Company Home > Project > Draft > Account > Order
and we want nodeRef of Order folder we can get like below :

//Normal class

private NodeRef getOrderNodeRef() {

try {

NodeRef companyHomeRef = repoHelper.getCompanyHome();

List<String> pathElements = MyUtility.getOrderPathElements();

FileInfo info = this.getFileFolderService().resolveNamePath(companyHomeRef, pathElements);

return info.getNodeRef();

} catch (FileNotFoundException e)


     {

               e.printStackTrace();

     }

}

//MyUtility class

public static List<String> getOrderPathElements() {

List<String> pathElements = new ArrayList<String>();

pathElements.add(COSTANT_FOLDER_PROJECT);

pathElements.add(COSTANT_FOLDER_DRAFT);

pathElements.add(COSTANT_FOLDER_ACCOUNT);

pathElements.add(COSTANT_ORDERS_FOLDER_ORDER);

return pathElements;

}

Getting parent nodeRef in alfresco

2013-07-26T12:06:00.001+05:30

Sometime we require to populate nodes and require parent nodeRef of the given node.
Following snippet will help us to get the parent nodeRef :


NodeRef titleRef = getNodeService().getPrimaryParent(contentXMLNodeRef).getParentRef();

hope this helps !

Remove node or content without archieve it

2013-05-29T16:39:00.001+05:30

Sometime we need to remove content permanant.
system model provide aspect called temporary, please apply it before delete node.

node.addAspect("sys:temporary");
logger.log("Aspect sys:temporary added.");
flag = node.remove();
logger.log("node removed ("+ flag +")");

Renew Solr license in alfresco 4.x

2012-08-17T12:41:00.001+05:30

Solr license is going to expire within this week (At the time this blog is written).

To renew it follow below steps :

1) Download file generate_keystores.bat Download File
2) Rename file from <generate_keystores.bat.sample> to <generate_keystores.bat>
3) Open <generate_keystores.bat> in text editor
4) Provide proper <ALFRESCO_HOME> path
5) Run bat file

This will give you message on console like "Certificate update complete"
Also you need to make entry in alfresco-global.properties like below

dir.keystore=%ALFRESCO_KEYSTORE_HOME%

where ALFRESCO_KEYSTORE_HOME = ALFRESCO_HOME/alf_data/keystore

Creating sample Javabacked webscript

2012-07-27T15:11:00.000+05:30

Webscript is widely used in alfresco customization or integration with third party portals to communicate.

Lets create java backed webscript with sample code.

For creating webscript we required following files :

1) Java class ( for java backed webscript which is action class)
2) Freemarker template
3) webscript bean entry in content xml file

we will create sample script as an example

1. CustomWebscript.java


public class CustomWebscript extends DeclarativeWebScript
 {
 @Override
 protected Map<String, Object> executeImpl(final WebScriptRequest req, final Status status, final Cache cache) {
 Map<String,Object> model;
 model = new HashMap<String,Object>();
 // final processing object should be placed in result
 model.put("result","myfinalResultObject");
 }
}

2. Descriptor and Freemarker

customContent.get.desc.xml

<webscript>

  <shortname>Custom Contents</shortname>

  <description>Get Custom Contents</description>

  <url>/getCustomContents</url>

  <format default="json"></format>

  <authentication>user</authentication>

</webscript>

customContent.get.json.ftl

{

"rows": 

[

<#if (contents??)>

 <#list result as agreement> 

{ 

"name":"${agreement.properties["cm:name"]!""}",

"description":"${agreement.properties["cm:description"]!""}",

"createdBy":"${agreement.properties["cm:creator"]!""}",

<#if (agreement.properties["cm:created"])??>

"createdDate":"${(agreement.properties["cm:created"])?string("yyyy-MM-dd")}"

<#else>

"createdDate":""

</#if>

} 

<#if agreement_has_next>,

</#if>

</#list>

 </#if>

]

}

custom-webscript-context.xml

<bean id="webscript.com.poc.custom.customContent.get" class="com.poc.webscript.CustomWebscript" parent="webscript">

<property name="serviceRegistry">

<ref bean="ServiceRegistry" />

</property>

</bean>

Injecting Common ServiceRegistry

2012-07-27T14:53:00.001+05:30

While customizing alfresco we need serviceRegistry many times to get various service.
Lets make it utility and keep it singleton.

AlfrescoServiceRegistry.java

/**

 * Singleton service registry
 * @author ghanshyam
 */
public final class AlfrescoServiceRegistry
{
 private static ServiceRegistry serviceRegistry;
       private AlfrescoServiceRegistry()
    {
     //private constructor
    }
      public static void setServiceRegistry(final ServiceRegistry serviceRegistry)
    {
        AlfrescoServiceRegistry.serviceRegistry = serviceRegistry;
    }
      public static ServiceRegistry getServiceRegistry()
    {
        return AlfrescoServiceRegistry.serviceRegistry;
    }
}

ServiceRegistryBean.java

public class ServiceRegistryBean 
{ 
    private ServiceRegistry serviceRegistry; 
    public ServiceRegistry getServiceRegistry() 
     { 
         return serviceRegistry; 
     } 
   public void setServiceRegistry(ServiceRegistry serviceRegistry) 
   { 
         this.serviceRegistry = serviceRegistry;
         AlfrescoServiceRegistry.setServiceRegistry(this.serviceRegistry); 
   } 
}

custom-context.xml

<bean id="AlfrescoServiceBean" class="com.poc.utility.ServiceRegistryBean"> 

       <property name="serviceRegistry">  

          <ref bean="ServiceRegistry" />  

      </property>  

</bean>

Create OpenLDAP chaining

2012-06-13T16:49:00.003+05:30

Many times we require alfresco authentication from one or more LDAP system for authentication.
Here we will look at authentication from two openLDAP.

Note : Below configuration is related to alfresco 4.x versions

I am here refering two LDAP as below :
#1) Internal LDAP
#2) ExternalLDAP

Step #1) Copy ldap files from original location and create/paste to extension path.
-----------------------------------------------------------------------------------
Copy following file from path
(<alfresco>\tomcat\webapps\alfresco\WEB-INF\classes\alfresco\subsystems\Authentication\ldap)
1. ldap-authentication.properties
2. ldap-authentication-context.xml

Paste both file(s) to following location. (<alfresco>\tomcat\shared\classes\alfresco\extension\subsystems\Authentication\ldap\internalLDAP)
(<alfresco>\tomcat\shared\classes\alfresco\extension\subsystems\Authentication\ldap\externalLDAP)

You can see here we need to create two folders 1) internalLDAP 2) externalLDAP to separate out both LDAP.

You can configure internalLDAP connection settings in ldap-authentication.properties inside internalLDAP folder and for externalLDAP to same file ldap-authentication.properites.

Step #2) Add common-ldap-context.xml
-------------------------------------------
Copy <alfresco>\tomcat\webapps\alfresco\WEB-INF\classes\alfresco\subsystems\Authentication\common-ldap-context.xml

Paste to path (<alfresco>\tomcat\shared\classes\alfresco\extension\subsystems\Authentication )

Step #3) Make chaining entry inside alfresco-global.properties
-------------------------------------------------------------------------
Place below entry

### Ldap settings ####
authentication.chain=externalLDAP:ldap,internalLDAP:ldap,alfrescoNtlm1:alfrescoNtlm

You can place these 3 in any order you want.

alfrescoNtlm is alfresco's default authentication mechanism.

Please make above changes and restart server.

Enable javascript debugging log

2012-05-24T16:11:00.002+05:30

In alfresco share we sometime need to log the js content.
Using below configuration we can enable javascript logging .

inside log4j.properties modify below entry to debug from error or warn.

log4j.logger.org.alfresco.repo.jscript=debug
log4j.logger.org.alfresco.repo.jscript.ScriptLogger=debug

Auditing custom content types

2012-05-24T15:55:00.000+05:30

Sometimes in important application requires auditing data. Alfresco provides auditing facility based on nodes behavior and actions.
In most cases out of box audit configuration is enough to satisfy the requirements, but sometime it requires certain kind of data also needs to be audited. Like we are auditing our own custom content types.

I have tested below configuration in Alfresco version 4.0 EE

E.g. I have my own custom content type say "clm:contract" and I want to monitor changes inside this node whether its create/read/update/delete.

We are including following configuration in alfresco-global.properties file to achieve this.

audit.enabled=true
audit.alfresco-access.enabled=true
audit.alfresco-access.sub-actions.enabled=true








### Audit Filter ###
audit.filter.alfresco-access.default.enabled=true
audit.filter.alfresco-access.transaction.user=~System;~null;.*
audit.filter.alfresco-access.transaction.type=cm:folder;cm:content;st:site;clm:contract
audit.filter.alfresco-access.transaction.path=~/sys:archivedItem;~/ver:;.*

Above configuration is enough to detect your custom content type clm:contract and auditing it.
If you want to see detailed log in console just write below configuration in log4j.properties file.

### Audit Logs ###
log4j.logger.org.alfresco.repo.audit.AuditComponentImpl=DEBUG
log4j.logger.org.alfresco.repo.audit.inbound=DEBUG

EnJOy !!