Records Management Community Updates

cancel
Showing results for 
Search instead for 
Did you mean: 

Records Management Community Updates

davidcognite
Senior Member
7 12 9,136

For the last few months, the Information Governance team at Alfresco has been heads-down getting Records Management 2.5 released. Since then we've been tidying things up on our community code base.

New Community Release

Alongside our Enterprise RM 2.5 release, we’ve got a shiny new RM Community release too: RM 2.5.a. This version has been tested against the latest 5.1.g (201605-EA) and 5.2.a (201609-EA) Alfresco One Community releases, so although the pom specifies 5.1 as a dependency, we don’t expect any issues when running against 5.2. Please let us know if you find anything.

Download the zip: https://download.alfresco.com/release/community/201609-EA-build-00012/alfresco-rm-community-2.5.a.zi...

Check out the docs: http://docs.alfresco.com/rm-community/concepts/welcome-rm.html

and see below for details of the code.

Community code now back on Github!

As I said in a previous post on my blog, we moved the RM code from SVN to our internal Git server recently (actually, it was about a year ago!) and since then, the SVN -> GitHub community mirror hasn’t been doing much.

We had a few issues getting the mirror set up due to the way we’d structured the new project, rm-community and rm-enterprise are both in the same repo which makes it much easier for us internally when we’re working on code that crosses projects, but with some creative python code from Tom Page, we were able to extract only the commits that make sense for the community and push them to our GitHub repo: https://github.com/Alfresco/records-management - please take a look at the latest code. We’re keen to receive pull requests, so if there are any bugs you find and want to submit a PR for, please do (and raise a JIRA: https://issues.alfresco.com).

Community Versions tagged

If you’re looking for the code for a specific RM Community version, then Tom's hackathon project will please you no end. He’s fixed the tags in GitHub, so you can go to the releases page for our new repo to see community tags for 2.3, 2.4 and 2.5 releases. If you really want to see versions older than that, you’ll need to go to our old repo and look at the tags there, but try to stick with the new stuff if at all possible - it’s much more fun to work with!

What’s next for RM Community?

Following news that version 3.0 of the Alfresco SDK is on its way, we’ve got an on-going development task to upgrade the RM project to use it. It’s still a work in-progress and we’re keeping Ole Hejlskov and Martin Bergljung in the loop as we have feature requests/bugs. The theory is that we (Alfresco Engineers) should be using the SDK for our own projects, so it makes sense to ensure that the RM module works with version 3.0. I’ll post back here once we’ve got more news on that.

About the Author
I worked for Alfresco for 8 years and am now leading an engineering team at an OEM partner
12 Comments
afaust
Master

Great news David. Unfortunately the last two links in "Community code now back on Github!" do not work as they try to route through Evernote.

davidcognite
Senior Member

Thanks Axel, I've fixed them now.

rays
Active Member II

David,

I've been trying to install rm 4.2.b on top of community 201605 GA. Is that the correct combination to use?

We've been using the Community Edition for five years (since 3.2.r.2) but it is only now that we feel ready to take advantage of Records Management in our archive plans. I really would prefer not to have to create a new server from scratch and re-create all users and permissions etc. on a new repository, particularly as this would be highly disruptive for our users, many of whom are very satisfied with our recent upgrade from previous 4.0.d to 201605 GA (not the easiest upgrade path but I got there in the end...). Naturally, I'm keen to build on their present level of confidence with minimal disruption.

With the respective installers and default content only, I can launch Alfresco records management. However, I see in catalina.out this error during start-up:

 2017-01-05 15:35:06,144  INFO  [config.packaging.ModulePackageManager] [localhost-startStop-1] Alfresco Record Management Share Extension, 2.4, Alfresco Record Management Share Extension

.....

ERROR [audit.model.AuditModelRegistryImpl] [localhost-startStop-1] Failed to load audit model: jar:file:/opt/alfresco-community/tomcat/webapps/alfresco/WEB-INF/lib/alfresco-rm-community-repo-2.4.b.jar!/alfresco/module/org_alfresco_module_rm/audit/rm-audit.xml
 org.alfresco.repo.audit.model.AuditModelException: 00050000 Audit application key 'RM' is used by: AuditApplication[ name=RM, id=2, disabledPathsId=10]

.....

However, when logged in as Admin user, I am still able to add the records management site etc. so all appears normal.

I then try to use this very same set-up substituting with my own content and mysql database using a known good full back-up of my production server which runs successfully on Community 201605 GA without RM.

During start-up with RM, I see the following in catalina.out:

INFO: Initializing Spring root WebApplicationContext
2017-01-05 16:58:49,773  INFO  [config.packaging.ModulePackageManager] [localhost-startStop-1] Found 2 module package(s)
 2017-01-05 16:58:49,774  INFO  [config.packaging.ModulePackageManager] [localhost-startStop-1] Alfresco Record Management Share Extension, 2.4, Alfresco Record Management Share Extension
Alfresco / Google Docs Share Module, 3.0.3, The Share side artifacts of the Alfresco / Google Docs Integration.
....
2017-01-05 17:00:03,355  ERROR [audit.model.AuditModelRegistryImpl] [localhost-startStop-1] Failed to load audit model: jar:file:/opt/alfresco-community/tomcat/webapps/alfresco/WEB-INF/lib/alfresco-rm-community-repo-2.4.b.jar!/alfresco/module/org_alfresco_module_rm/audit/rm-audit.xml
 org.alfresco.repo.audit.model.AuditModelException: 00050000 Audit application key 'RM' is used by: AuditApplication[ name=RM, id=2, disabledPathsId=3149]

...
 2017-01-05 17:00:08,760  INFO  [repo.module.ModuleServiceImpl] [localhost-startStop-1] Upgrading module 'org_alfresco_module_rm' version 2.4 (was 1.0).
 2017-01-05 17:00:08,894  INFO  [patch.compatibility.ModulePatchComponent] [localhost-startStop-1] Module patch component 'org_alfresco_module_rm_notificationTemplatePatch' is executing ...

Half-an-hour later, this appears.....

2017-01-05 17:34:49,296  INFO  [patch.compatibility.ModulePatchComponent] [localhost-startStop-1]   ... error encountered.  00050040 Failed to write property deltas:
  Node:          82366
  Old:           {}
  New:           {{http://www.alfresco.org/model/content/1.0}autoVersion=true, {http://www.alfresco.org/model/content/1.0}autoVersionOnUpdateProps=false, {http://www.alfresco.org/model/content/1.0}initialVersion=true}
  Diff:          {{http://www.alfresco.org/model/content/1.0}autoVersion=RIGHT_ONLY, {http://www.alfresco.org/model/content/1.0}autoVersionOnUpdateProps=RIGHT_ONLY, {http://www.alfresco.org/model/content/1.0}initialVersion=RIGHT_ONLY}
  Delete Tried:  []
  Add Tried:     {{http://www.alfresco.org/model/content/1.0}autoVersion=true, {http://www.alfresco.org/model/content/1.0}autoVersionOnUpdateProps=false, {http://www.alfresco.org/model/content/1.0}initialVersion=true}
 org.alfresco.error.AlfrescoRuntimeException: 00050040 Failed to write property deltas:
  Node:          82366
  Old:           {}
  New:           {{http://www.alfresco.org/model/content/1.0}autoVersion=true, {http://www.alfresco.org/model/content/1.0}autoVersionOnUpdateProps=false, {http://www.alfresco.org/model/content/1.0}initialVersion=true}
  Diff:          {{http://www.alfresco.org/model/content/1.0}autoVersion=RIGHT_ONLY, {http://www.alfresco.org/model/content/1.0}autoVersionOnUpdateProps=RIGHT_ONLY, {http://www.alfresco.org/model/content/1.0}initialVersion=RIGHT_ONLY}
  Delete Tried:  []
  Add Tried:     {{http://www.alfresco.org/model/content/1.0}autoVersion=true, {http://www.alfresco.org/model/content/1.0}autoVersionOnUpdateProps=false, {http://www.alfresco.org/model/content/1.0}initialVersion=true}

The full catalina.out can be viewed here for further reference.

I'm trying to understand why RM is failing and what do I need to do to fix it? I'm hoping that you and your records management team can guide me through the steps needed to resolve this issue.

Thanks, in advance, for your kind attention.

Ray

afaust
Master

This should have been created as a general question instead of a comment on that blog post. Unfortunately even as a moderator I cannot convert it to a question.

You should typically stick to the Records Management version that is included in the file list page for a specific release, e.g. Community file list 201605 GA. This lists RM 2.4.b to be used. The error about the audit model is one that I have also observed in the past - even without the RM module installed. According to JIRA it is a known issue and does not cause any subsequent errors (see RM-2926).

The error you are getting afterwards is very likely unrelated and due to issues with the existing content. For Community Edition it typically is safer to do smaller upgrades, e.g. instead of going from 4.0.d directly to 201605 GA we typically take steps from 4.0.d to 4.2.f to 5.0.d to 201605 GA. All the time the RM version corresponding to that Community Edition release should be used. This has the benefit that whenever one step has been successfully complete you typically have a safe fallback instead of going back to the very old version. Often upgrade errors such as yours may be avoided all together - if not, you at least have better information between which versions this problem occurs, and don't have to start from scratch.

rays
Active Member II

Dear Axel,

Thanks for your feedback. I addressed my question here to David as I had already tried all of RM 2.4.a, 2.4.b and even 2.5 in my efforts to overcome the cause and had researched the community questions available. I have found conflicting information regarding RM 2.4.a and 2.4.b as to which is the appropriate version, so thought I should ask on this blog where David appears to be saying thet RM 2.5.x should now work with 201605 GA.

Indeed, my upgrade path followed exactly as you describe: 4.0.d to 4.2.f to 5.0.d to 201605 GA, as this was the only viable path. I just did not detail that here. However, I did not include RM in these steps as we had never used RM in the past, to my knowledge. That's why I'm surprised to see the inclusion of "Upgrading module 'org_alfresco_module_rm' version 2.4 (was 1.0)" in catalina.out log. If we haven't knowingly used RM, never having included a Records Management share site, I'm wondering where is that reference to 1.0 coming from currently?

Ray

afaust
Master

Even if you had just installed it but never used it / created the site, it already has created data structures in the background that may need to be updated / migrated.

martin7
Active Member

Hello David Webster,


I have a problem with RM, when I install it and start the server, at the time of loading the page I get the login, BUT, when I try to enter I get a warning that says "Your authentication data has not been recognized or can That Alfresco Content Services is not available at this time. "
The steps that I use for the installation are the following:
1.move the RM files to the respective folders.
2. Stop the server
3.Delete the folders
     * Tomcat \ webapps \ alfresco
     * Tomcat \ webapps \ share
4. Open the windows terminal and locate in alfresco \ bin
5.Cover the following commands:
    * Java -jar alfresco-mmt.jar install .. \ amps \ <RM filename> .amp .. \ tomcat \ webapps \ alfresco.war
    ** java -jar alfresco-mmt.jar install .. \ amps_share \ <file name of RM share> .amp .. \ tomcat \ webapps \ share.war
6. I start the server

In the execution of the commands only load a moment and does not show any information.

Alfresco Community Version:
5.2 201701


Versions of the RM that I have tried:
2.3.a.1
2.3.b
2.5.a

If I need a more current RM I would appreciate you giving me the download URL.

I thank you for your time and the one who can also help me.

Thank you so much.

moro
Member II

‌ I'm having the same problem.

I'm on the same version, with the same modules and so on.

If you'll find a solution, please, post and update Smiley Happy

I'll keep testing and digging the web

Cheers

martin7
Active Member

Hello Francesco, the solution I found was to install alfresco community 5.1 201606 and the Record Management 2.4.a. I have tried it and everything works fine.

Be fine.
regards

davidcognite
Senior Member

‌, firstly please accept my apologies, I missed your first reply on this blog post.

There were some compatibility issues between previous RM releases and the current community 5.2 releases. We're working on releasing RM 2.5.b to resolve this, which shouldn't take us too much longer. In the mean time, you're best off with either a nightly build or Alfresco One 5.1.

moro
Member II

Thank you ‌ for your work!
Will this thread be updates as soon as RM 2.5.b will be released or should i keep an eye elsewhere?

thank you!

archangle
Member II

David Webster‌ can you mention any date for RM 2.5.b release? 

Are nightly builds compatible with current community 5.2 releases?