topic Re: Records Management in Alfresco 2.0 final in Alfresco Archive

Records Management in Alfresco 2.0 final

evdgeest — Mon, 26 Feb 2007 08:43:39 GMT

I installed the alfresco community edition 2.0 on a windows 2003 server, I want to use the Records Management module.I read a couple of threads in this forum but still not managed to activate/install the Records Management module. I also read the Records Management User Guide on the Wiki, but that d

Re: Records Management in Alfresco 2.0 final

kevinr — Tue, 27 Feb 2007 10:25:23 GMT

The 2.0 Records Management AMP (Alfresco Module Package) file will be uploaded to SourceForge today

Thanks,

Kevin

Re: Records Management in Alfresco 2.0 final

evdgeest — Tue, 27 Feb 2007 10:40:44 GMT

Thank you very much!

Can you tell me if the following line from the example on http://wiki.alfresco.com/wiki/Module_Management_Tool will work?

ModuleManager.bat /module/recordsManagement.amp /install/Alfresco.war -verbose -preview

That would be great! :lol:

Thanks in advance,
Edwin

Re: Records Management in Alfresco 2.0 final

aborba — Wed, 28 Feb 2007 01:08:09 GMT

The 2.0 Records Management AMP (Alfresco Module Package) file will be uploaded to SourceForge today

Thanks,

Kevin

Hi, the module uploaded to SourceForge is the "recordsManagement-1.0.amp". Assuming this is the good one, i still have problems adding it to alfresco.war with "ModuleManager.sh":
* "ModuleManager.sh" seems to be a windows script.
* After rewriting it and verifying all paths exist, still the following error:
"Exception in thread "main" java.lang.NoClassDefFoundError: org/alfresco/repo/module/tool/ModuleManagementTool"

Appreciate any help on this matter. AntÃ³nio

Re: Records Management in Alfresco 2.0 final

evdgeest — Wed, 28 Feb 2007 09:38:23 GMT

I used the ModuleManager.bat in the command prompt, using the following command:
C:\Alfresco\extras\Module-Management>ModuleManager.bat install recordsManagement.amp alfresco.war

I get the following message:
log4j:WARN No appenders could be found for logger (org.alfresco.repo.extension.ModuleManagementTool).
log4j:WARN Please initialize the log4j system properly.

I copied the alfresco.war to the webapps directory, after that I started alfresco. But in the web client I don't see any changes, not a space, not a template. So I used the command:
C:\Alfresco\extras\Module-Management>ModuleManager.bat list alfresco.war

But the response to that was a message of the available commands.
Can someone tell me how if the recordsManagement.amp is correct installed and why the list command doesn't work.

The Module management tool also made an alfresco-*.bak in the same directory, what am I supposed to do with that?

Thanks in advance.

Edwin

Re: Records Management in Alfresco 2.0 final

aborba — Wed, 28 Feb 2007 12:53:31 GMT

Well, for now it seems I managed to add "recordsManagement-1.0.amp" to "alfresco.war" on a Linux Fedora instalation. Anyway, it doesn't seem to show up in the web interface.

I rewrote the "ModuleManager.sh" to look like this:

#=====================================
#!/bin/sh
# Install an AMP file into an Alfresco WAR

# set the ALFRESCO value to point to the Alfresco directory
ALFRESCO="/opt/Alfresco"

# Path to JAVA
JAVA="$ALFRESCO/java/bin/java"

# set the LIB_DIR value to point to the Alfresco lib directory
LIB_DIR="$ALFRESCO/tomcat/webapps/alfresco/WEB-INF/lib"
TEMP_CLASS_PATH="$LIB_DIR/repository.jar:$LIB_DIR/core.jar:$LIB_DIR/truezip.jar:$LIB_DIR/log4j-1.2.8.jar:$LIB_DIR/spring.jar:$LIB_DIR/commons-logging.jar"

$JAVA -cp $TEMP_CLASS_PATH org.alfresco.repo.module.tool.ModuleManagementTool $1 $2 $3 $4 $5 $6 $7
#=====================================

Then, i shutdown Alfresco:
# /opt/Alfresco/alf_stop.sh

Next, i ran the command:
# sh ModuleManager.sh install recordsManagement-1.0.amp /opt/Alfresco/tomcat/webapps/alfresco.war -verbose -preview

Everything seems smooth so, i installed it:
# sh ModuleManager.sh install recordsManagement-1.0.amp /opt/Alfresco/tomcat/webapps/alfresco.war -verbose

Then i listed alfresco.war to check is was installed:
# sh ModuleManager.sh list /opt/Alfresco/tomcat/webapps/alfresco.war

It shows the following:
Module 'recordsManagement' installed in '/opt/Alfresco/tomcat/webapps/alfresco.war'
log4j:WARN No appenders could be found for logger (org.alfresco.repo.extension.ModuleManagementTool).
log4j:WARN Please initialize the log4j system properly.
   - Title: Records Management
   - Version: 1.0
   - Install Date: Wed Feb 28 12:49:23 WET 2007
   - Desription: Alfresco Record Management Extension

Then, i started Alfresco:
# /opt/Alfresco/alf_start.sh

The behaviour of Alfresco didn't change. It behaves as if Records Management were not installed. i.e. no file plan or RM aspects can be added to file.

Thanks for help. AntÃ³nio

Re: Records Management in Alfresco 2.0 final

kbpair — Wed, 28 Feb 2007 14:28:03 GMT

I made changes to the paths and syntax in the shell file but i am now getting the error below. I am still evaluating Alfresco and would like to know if all Alfresco development is done on Windows. I can start the process of getting a windows machine to run this on and maybe that would reduce the number of issues (I need CIFS functionality as well).

Failed to load Main-Class manifest attribute from
/apps/jb-util/alfresco_tomcat/tomcat/webapps/alfresco/WEB-INF/lib/core.jar
Usage: nzip COMMAND …

where COMMAND is one of (case is ignored):

        ls [PATH] …                           Similar to GNU "ls"
        ll [PATH] …                           Similar to GNU "ls -l"
        llR [PATH] …                          Similar to GNU "ls -lR"
        cat FILE …                            Like GNU "cat"
        cp [-unzip|-cp437in|-utf8in|-cp437out|-utf8out] SRC … DST     Similar to GNU "cp -a"
        mv SRC … DST                          Like GNU "mv"
        touch PATH …                          Like GNU "touch"
        mkdir PATH …                          Like GNU "mkdir"
        mkdirs PATH …                         Similar to GNU "mkdir -p"
        rm PATH …                             Like GNU "rm"
        rmR PATH …                            Like GNU "rm -r"
        isFile PATH                             Tests if PATH is a file
        isDirectory PATH                        Tests if PATH is a directory
        exists PATH                             Tests if PATH exists

For more information please refer to the respective man pages (on Linux).

Options (case is ignored):

        -unzip          Treat any ZIP like pathnames in DST as plain
                        directories.
        -cp437(in|out) Force any ZIP entry names in SRC/DST to be encoded in CP437.
        -utf8(in|out)   Force any ZIP entry names in SRC/DST to be encoded in UTF-8.

/apps/jb-util/alfresco_tomcat/tomcat/webapps/alfresco/WEB-INF/lib/log4j-1.2.8.jar: PK^C^D: not found
/apps/jb-util/alfresco_tomcat/tomcat/webapps/alfresco/WEB-INF/lib/log4j-1.2.8.jar: \354^PT.: not found
/apps/jb-util/alfresco_tomcat/tomcat/webapps/alfresco/WEB-INF/lib/log4j-1.2.8.jar: syntax error at line 7: `(' unexpected
Failed to load Main-Class manifest attribute from
/apps/jb-util/alfresco_tomcat/tomcat/webapps/alfresco/WEB-INF/lib/spring.jar
/apps/jb-util/alfresco_tomcat/tomcat/webapps/alfresco/WEB-INF/lib/commons-logging.jar: PK^C^D: not found
/apps/jb-util/alfresco_tomcat/tomcat/webapps/alfresco/WEB-INF/lib/commons-logging.jar: \347D\207.: not found
/apps/jb-util/alfresco_tomcat/tomcat/webapps/alfresco/WEB-INF/lib/commons-logging.jar: syntax error at line 10: `)' unexpected
Exception in thread "main" java.lang.NoClassDefFoundError: de/schlichtherle/io/File

Re: Records Management in Alfresco 2.0 final

bagsied — Thu, 01 Mar 2007 06:53:57 GMT

Hi Kevin from Alfresco, the newly uploaded records management amp as of Feb 27, 2007 still not working.
I followed the instruction in the readme.txt but still encountered error message, the same message encountered by previous poster:
"Exception in thread "main" java.lang.NoClassDefFoundError: org/alfresco/repo/module/tool/ModuleManagementTool

Can you please tell us is there anything wrong in what we are doing or some bug in the amp?

Thanks in advance for your time to fix this problem. We are evaluating ECM products and the fix on this will help us proceed on the evaluation. I would like your company to be included in our RFP but I cannot justify until I can show them something.

thanks.

Re: Records Management in Alfresco 2.0 final

aborba — Thu, 01 Mar 2007 09:40:07 GMT

Hi Kevin from Alfresco, the newly uploaded records management amp as of Feb 27, 2007 still not working.
I followed the instruction in the readme.txt but still encountered error message, the same message encountered by previous poster:
"Exception in thread "main" java.lang.NoClassDefFoundError: org/alfresco/repo/module/tool/ModuleManagementTool

Can you please tell us is there anything wrong in what we are doing or some bug in the amp?

Thanks in advance for your time to fix this problem. We are evaluating ECM products and the fix on this will help us proceed on the evaluation. I would like your company to be included in our RFP but I cannot justify until I can show them something.

thanks.

The problem i found there is that the separator in CLASSPATH must be colon ":" instead of semicolon ";"

Anyway, after installation the RecordsManagement functionality still does notwork (you cannot set aspects for file plan, file plan doesn't show up in Space templates, etc.)

Re: Records Management in Alfresco 2.0 final

kbpair — Thu, 01 Mar 2007 21:27:34 GMT

I took the time to re-install everything on a windows server. After adjusting the hardcoded path in ModuleManager.bat it ran without error.

However, I see no change in the application, no file plan, etc…

Here is the output from the install:

Installing AMP '..\..\recordsManagement-1.0.amp' into WAR '..\..\tomcat\webapps\
alfresco.war'
log4j:WARN No appenders could be found for logger (org.alfresco.repo.extension.M
oduleManagementTool).
log4j:WARN Please initialize the log4j system properly.
WAR has been backed up to '..\..\tomcat\webapps\alfresco.war-1172782191685.bak'
Adding files relating to version '1.0' of module 'recordsManagement'
   - File '/WEB-INF/lib/rm.jar' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/bootstrap/rm_javas
cripts.xml' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/bootstrap/rm_file_
plan.xml' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/bootstrap/rm_templ
ates.xml' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/bootstrap/rm_categ
ories.xml' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/bootstrap/rm_group
s.xml' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/bootstrap/records_
space.acp' added to war from amp
   - Directory '/WEB-INF/classes/alfresco/module/recordsManagement/bootstrap' ad
ded to war
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/script/action/disp
ositionAction_transfer.js' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/script/action/disp
ositionAction_accession.js' added to war from amp
   - Directory '/WEB-INF/classes/alfresco/module/recordsManagement/script/action
' added to war
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/script/onRemoveAsp
ect_rmaHeld.js' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/script/onAddAspect
_rmaRecord.js' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/script/onAddAspect
_rmaCutoff.js' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/script/onCreateChi
ldAssociation_rmaFilePlan_cmContains.js' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/script/ui/uiAction
_addRemoveAspect.js' added to war from amp
   - Directory '/WEB-INF/classes/alfresco/module/recordsManagement/script/ui' ad
ded to war
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/script/onContentUp
date_rmaRecord.js' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/script/scheduled/s
cheduled_cutoff.js' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/script/scheduled/s
cheduled_removeHold.js' added to war from amp
   - Directory '/WEB-INF/classes/alfresco/module/recordsManagement/script/schedu
led' added to war
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/script/onAddAspect
_rmaVitalRecord.js' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/script/onAddAspect
_rmaObsolete.js' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/script/onAddAspect
_rmaSuperseded.js' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/script/onAddAspect
_rmaHeld.js' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/script/onCreateNod
e_rmaFilePlan.js' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/script/onAddAspect
_rmaCutoffSchedule.js' added to war from amp
   - Directory '/WEB-INF/classes/alfresco/module/recordsManagement/script' added
to war
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/context/bootstrap-
context.xml' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/context/behaviour-
context.xml' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/context/script-con
text.xml' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/context/action-con
text.xml' added to war from amp
   - Directory '/WEB-INF/classes/alfresco/module/recordsManagement/context' adde
d to war
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/template/record_te
mplate.ftl' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/template/fileplan_
template.ftl' added to war from amp
   - Directory '/WEB-INF/classes/alfresco/module/recordsManagement/template' add
ed to war
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/model/recordsModel
.xml' added to war from amp
   - Directory '/WEB-INF/classes/alfresco/module/recordsManagement/model' added
to war
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/module-context.xml
' added to war from amp
   - File '/WEB-INF/classes/alfresco/module/recordsManagement/ui/web-client-cust
om.xml' added to war from amp
   - Directory '/WEB-INF/classes/alfresco/module/recordsManagement/ui' added to
war
   - Directory '/WEB-INF/classes/alfresco/module/recordsManagement' added to war

Re: Records Management in Alfresco 2.0 final

evdgeest — Fri, 02 Mar 2007 08:10:14 GMT

I've got the same output from install.

But while starting alfresco I get a message:
08:52:01,160 [repo.module.ModuleServiceImpl] Found 0 module(s).

Assuming that the recordsManagement.amp is not correctly installed into the alfresco.war I reinstalled it. But when I reinstall recordsManagement.amp I get a message that its allready installed.

What should I do now?

Thanks in advance!
Edwin

Re: Records Management in Alfresco 2.0 final

rwetherall — Fri, 02 Mar 2007 11:52:10 GMT

Hi,

The output you are seeing is correct so it means that the WAR has been updated correctly.

Assuming you have now placed this updated WAR in the correct place, you may need to also delete the old expanded WAR contents for the changes in the updated WAR to take effect.

With the old expanded WAR contents removed, when restatrted Tomcat will unpack the modified WAR and the repository should see the RM module and install it. Certainly this is the case for Tomcat on Windows.

Cheers,
Roy

Re: Records Management in Alfresco 2.0 final

evdgeest — Fri, 02 Mar 2007 12:47:05 GMT

Thank you very much! That was the solution i was looking for!

Re: Records Management in Alfresco 2.0 final

kbpair — Fri, 02 Mar 2007 13:57:31 GMT

After deleting the alfresco directory under webapps and restarting I am seeing some of the Records Management module. However any changes made to file-servers.xml are gone and must be re-applied.

Re: Records Management in Alfresco 2.0 final

miguel_gil_mart — Fri, 02 Mar 2007 20:17:29 GMT

How to in a "Linux" + "Wizard installation (Tomcat)" .

My Alfresco is installed in /opt/Alfresco. I used wizard to install it. I did not modify anything… next….next….next. … 😄 (HSQLDB)
First, I shutdown Tomcat.
I use the script "ModuleManager.sh" rewritten by Aborba (thanks!!!) in this post. It worked fine.
I mv (rename) /opt/Alfresco/tomcat/webapps/alfresco/ to /opt/Alfresco/tomcat/webapps/alfrescoOLD/ (backup).
Restart Tomcat (/opt/Alfresco/alf_start.sh)
Now, we have to add an administrator to Tomcat. Add this line to /opt/Alfresco/tomcat/conf/tomcat-users.xml
<user username="admin" password="yourultrasecretpassword" roles="standard,manager"/>
Go to http://localhost:8080/manager/html and log as admin…
Deploy the new alfresco.war file using Tomcat web interface.

Right!!! You now have two alfresco instances.
Now log on Alfresco as Admin and you have a new "Records Space"
I hope it is useful.

Re: Records Management in Alfresco 2.0 final

aborba — Sat, 03 Mar 2007 13:38:47 GMT

Thanks kevinr, rwetherall and miguel.gil.martinez. IT WORKED!!!!

Re: Records Management in Alfresco 2.0 final

derek — Tue, 06 Mar 2007 07:54:53 GMT

Hi, kbpair

You need to use the configuration extension mechanism to change config in the repo. That was part of the point of modifying the WAR using the .amp file. If you make your changes in the contents of the expanded WAR, then you're going to have issues with your customizations going missing everytime you upgrade as well. And keeping track of which files you modified will be difficult enough even if you do remember.

Regards

Re: Records Management in Alfresco 2.0 final

askrates1 — Tue, 13 Mar 2007 03:17:30 GMT

Could some of the people that have been clever enough to get this to work in windows please cupy-paste the contents of their ModuleManager.bat here?

I keep getting the @%('$"!! "Exception in thread "main" java.lang…" error. :x

Thanks

Re: Records Management in Alfresco 2.0 final

evdgeest — Wed, 14 Mar 2007 09:23:19 GMT

I have got that error as well, I installed Java Runtime Environment and after that the bat file works fine.

My bat file looks like this:

@echo off
rem Install an AMP file into an Alfresco WAR

rem set the LIB_DIR value to point to the Alfresco lib directory
SET LIB_DIR=C:\Alfresco\tomcat\webapps\alfresco\WEB-INF\lib

SET TEMP_CLASS_PATH=%LIB_DIR%\repository.jar;%LIB_DIR%\core.jar;%LIB_DIR%\truezip.jar;%LIB_DIR%\log4j-1.2.8.jar;%LIB_DIR%\spring.jar;%LIB_DIR%\commons-logging.jar

java -cp "%TEMP_CLASS_PATH%" org.alfresco.repo.module.tool.ModuleManagementTool "%1" "%2" "%3" "%4" "%5" "%6" "%7"
‍‍‍‍‍‍‍‍‍‍

Re: Records Management in Alfresco 2.0 final

fschnell — Fri, 23 Mar 2007 10:51:36 GMT

After deleting the alfresco directory under webapps and restarting I am seeing some of the Records Management module. However any changes made to file-servers.xml are gone and must be re-applied.

Don't change that file. Put local customisation into file
tomcat\shared\classes\alfresco\extension\file-servers-custom.xml

This file will not be updated when deploying a new version of alfresco.war

Frank