cancel
Showing results for 
Search instead for 
Did you mean: 

How can I deploy a custom workflow (with its model) in Alfresco Community 5.1?

mafaldap
Star Contributor
Star Contributor

I'm following Jeff Potts' tutorial, but I can't figure out how to use the workflow-tutorial-repo and the workflow-tutorial-share inside the Alfresco community installed.

I imported the amp files using the command:

java -jar alfresco-mmt.jar install <AMPFileLocation> <WARFileLocation> [options]

Once that I start Alfresco nothing changes. Any advice?

Thank you

1 ACCEPTED ANSWER

gravitonian
Star Collaborator
Star Collaborator

I did give your workflow a go in a 5.1 install I got.

Everything worked with the ZIP files provided above.

What I did:

Unzipped to get to the AMPs

martin@gravitonian:/opt/alfresco51EA$ cd amps

martin@gravitonian:/opt/alfresco51EA/amps$ cp ~/Downloads/workflow-tutorial-repo.amp .

martin@gravitonian:/opt/alfresco51EA/amps$ cd ../amps_share/

martin@gravitonian:/opt/alfresco51EA/amps_share$ cp ~/Downloads/workflow-tutorial-share.amp .

martin@gravitonian:/opt/alfresco51EA/amps_share$ cd ../bin/

martin@gravitonian:/opt/alfresco51EA/bin$ ./apply_amps.sh

martin@gravitonian:/opt/alfresco51EA$ ./alfresco.sh restart tomcat

Loggged in to Share, uploaded a file, then selected Start Workflow for it. All the custom workflows are available to choose.

What I suspect might have happend here is the case when you don't use apply_amps.sh, but instead use the MMT tool (i.e. java -jar alfresco-mmt.jar ...) by itself. And forget to remove the exploded WAR directories before restarting Tomcat. The apply_amps.sh script removes the exploded WAR dirs for you automatically.

View answer in original post

18 REPLIES 18

mitpatoliya
Star Collaborator
Star Collaborator

For deploying AMP just copy amp files under your alfresco installation.

workflow-tutorial-repo goes inside <ALFRECSO_HOME>/amp

workflow-tutorial-share goes inside <ALFRESCO_HOME>/amps_share

then just use apply_amps.bat from <ALFRESCO>/bin It will apply those amp files to your alfresco.war and share.war

For linux machine you need to use that mmt tool. Just make sure your command is syntex is correct as it will not give you proper error messages.

Just to cross check that check those war files. Size of those war files will be changed.

Now you restart your alfresco server. It should update your repository.

Ok, last time I didn't do it like this and probably that's why it didn't work. Il'll try to follow your advice.

Thank you

kaynezhang
World-Class Innovator
World-Class Innovator

You can use list command of  Module Management Tool to see if your amp is installed correctly.

And you can also visit http://localhost:8080/alfresco/s/admin/admin-workflowconsole to check if your workflow definitions are deployed correctly

jpotts
World-Class Innovator
World-Class Innovator

Once you deployed your AMPs and restarted, what did you do next? Did you try to start a workflow? If so, what happened?

mafaldap
Star Contributor
Star Contributor

I deployed (again) the AMPs, following mittal Patoliya​ instructions. I checked that both the AMPs became module in alfresco.war and share.war. Then I started Alfresco from the Application Manager, but I couldn't find the workflow from the console.

kalpesh_c2
Star Collaborator
Star Collaborator

Using java command or apply_amps.bat (for Linux apply_apms.sh) is going to yield the same result.

java -jar alfresco-mmt.jar install <AMPFileLocation> <WARFileLocation> [options]

If you see line number 28 to 31 of <<ALFRESCO_HOME>>/bin/apply_amps.bat file, you will see the same command is executed (given appropriate values of variables are applied) :

"%JAVA_HOME%\bin\java" -jar "%ALF_HOME%bin\alfresco-mmt.jar" install "%ALF_HOME%amps" "%CATALINA_HOME%\webapps\alfresco.war" -directory%ALF_AMP_PARAMS%

"%JAVA_HOME%\bin\java" -jar "%ALF_HOME%bin\alfresco-mmt.jar" list "%CATALINA_HOME%\webapps\alfresco.war"

"%JAVA_HOME%\bin\java" -jar "%ALF_HOME%bin\alfresco-mmt.jar" install "%ALF_HOME%amps_share" "%CATALINA_HOME%\webapps\share.war" -directory%ALF_AMP_PARAMS%

"%JAVA_HOME%\bin\java" -jar "%ALF_HOME%bin\alfresco-mmt.jar" list "%CATALINA_HOME%\webapps\share.war"

Did you receive any error after starting of server? Are you facing difficulties locating workflow definition? If you can elaborate what problem you are facing exactly, I will be able to help.

Thanks,

Kalpesh

ContCentric

I didn't receive any error, that's the problem. However I can't find my workflow anywhere. I looked in the repository and I searched using the workflow console (show definitions all) but nothing.

I'm new with Alfresco, so probably it's just that I don't know how to do.

jpotts
World-Class Innovator
World-Class Innovator

Maybe you skipped the step where you deploy the workflow from the workflow

console or maybe your workflow did not get automatically deployed for some

reason.

Once the AMPs are in place, if you go to the workflow console and do a

"show definitions all" and you don't see your new workflow, it means it

didn't get deployed as part of the AMP installation. But you can always

deploy it manually from the workflow console by doing "deploy activiti

/alfresco/module/workflow-tutorial-repo/workflows/helloWorld.bpmn".

mafaldap
Star Contributor
Star Contributor

I just tried and it returns me an error:

Caused by: java.io.FileNotFoundException: class path resource [alfresco/module/workflow-tutorial-repo/workflows/helloWorld.bpmn] cannot be opened because it does not exist

So I checked again if the modules were installed and the results are:

host-131-114-104-112:bin mafaldapapini$ java -jar alfresco-mmt.jar list /Applications/alfresco-community/tomcat/webapps/alfresco.war

Module 'workflow-tutorial-repo' installed in '/Applications/alfresco-community/tomcat/webapps/alfresco.war'

  -    Title:        workflow-tutorial-repo Repository AMP project

  -    Version:      1.0.1610101009

  -    Install Date: Tue Oct 11 10:16:13 CEST 2016

  -    Description:  Manages the lifecycle of the workflow-tutorial-repo Repository AMP (Alfresco Module Package)

Module 'alfresco-share-services' installed in '/Applications/alfresco-community/tomcat/webapps/alfresco.war'

  -    Title:        Alfresco Share Services AMP

  -    Version:      5.1.0

  -    Install Date: Mon Apr 04 08:55:45 CEST 2016

  -    Description:  Module to be applied to alfresco.war, containing APIs for Alfresco Share

Module 'org.alfresco.integrations.google.docs' installed in '/Applications/alfresco-community/tomcat/webapps/alfresco.war'

  -    Title:        Alfresco / Google Docs Integration

  -    Version:      3.0.3

  -    Install Date: Mon Apr 04 08:55:44 CEST 2016

  -    Description:  The Repository side artifacts of the Alfresco / Google Docs Integration.

Module 'alfresco-aos-module' installed in '/Applications/alfresco-community/tomcat/webapps/alfresco.war'

  -    Title:        Alfresco Office Services Module

  -    Version:      1.1

  -    Install Date: Mon Apr 04 08:55:41 CEST 2016

  -    Description:  Allows applications that can talk to a SharePoint server to talk to your Alfresco installation

host-131-114-104-112:bin mafaldapapini$ java -jar alfresco-mmt.jar list /Applications/alfresco-community/tomcat/webapps/share.war

Module 'workflow-tutorial-share' installed in '/Applications/alfresco-community/tomcat/webapps/share.war'

   -    Title:        workflow-tutorial-share AMP project

   -    Version:      1.0.1610101024

   -    Install Date: Tue Oct 11 10:18:44 CEST 2016

   -    Description:   Manages the lifecycle of the workflow-tutorial-share AMP (Alfresco Module Package)

Module 'org.alfresco.integrations.share.google.docs' installed in '/Applications/alfresco-community/tomcat/webapps/share.war'

   -    Title:        Alfresco / Google Docs Share Module

   -    Version:      3.0.3

   -    Install Date: Mon Apr 04 08:55:48 CEST 2016

   -    Description:   The Share side artifacts of the Alfresco / Google Docs Integration.