alfresco pdftoolkit

cancel
Showing results for 
Search instead for 
Did you mean: 
ejike
Active Member II

alfresco pdftoolkit

Jump to solution

Good day All,

I am currently running the Alfresco 5.0 Community version and I would like to install and deploy the pdftoolkit.

I have done the following:

1. Cloned the Github repository where the pdftoolkit is located.

These are my challenges:

1. Please where do I run the "mvn clean install", 

2. Do i use the "run.bat" or "run.sh", I will feel they are both the same.

3. How and where do i deploy the "amp" files.

I would be very grateful if someone who has done it before can give me step by step process of going about this.

Thanks and BR,

Ejike Chiboka

1 Solution

Accepted Solutions
jpotts
Professional

Re: alfresco pdftoolkit

Jump to solution

There should be two amps. One is for Share, which it looks like you've copied, and the other is for the repository. I cannot tell if you've copied that one, which goes in your amps folder.

After putting each AMP into its appropriate folder, stop Alfresco. You cannot install AMPs while Alfresco is running. Part of the process is to remove the expanded web application directories and you should not do that when Alfresco is running.

Next, you copied the alfresco and share directories as a backup, and you plan to copy those back after installing the AMPs. Do not do this.

Any changes or customizations you've made should be in AMPs, so none of your changes are in the Alfresco or Share web applications. Therefore, there is nothing in there you need to save.

When you run the apply_amps script, it will merge the PDF toolkit AMPs into the alfresco.war and share.war files and it will remove the alfresco and share directories, which is what you want it to do. Then, when you start Alfresco up, Tomcat will re-expand the alfresco.war and share.war files into those directories.

View solution in original post

6 Replies
angelborroy
Alfresco Employee

Re: alfresco pdftoolkit

Jump to solution

You don't need to build the project by yourself.

Just use the pre-compiled AMPs available in https://github.com/OrderOfTheBee/alfresco-pdf-toolkit/releases

You can install those AMPs (for alfresco and share) following these instructions: https://docs.alfresco.com/content-services/6.1/install/zip/amp/

Hyland Developer Evangelist
ejike
Active Member II

Re: alfresco pdftoolkit

Jump to solution

Hi angelborroy,

Thanks for your response.

I have done the following:

1. I have placed the pdf-toolkit-share-1.4.0 amp file in the Alfresco/ amps_share folder

What should I do next:

1. move the "/bin" folder into the "amps_share" folder and run the "apply_amps" batch file

or

2. Do i leave the "/bin" folder exactly where it is and run the "apply_amps" batch file

I look forward to hearing from you guys.

Thanks and Regards

ejike
Active Member II

Re: alfresco pdftoolkit

Jump to solution

Hi angelborroy,

The message below is the message I get in the terminal when I run the "apply_amps" from "/bin" folder.

"This script will apply all the AMPs in C:\Alfresco\amps to the alfresco.war and share.war files in C:\Alfresco\tomcat\webapps
Press control-c to stop this script . . .
Press any key to continue . . .
Module 'org.alfresco.module.vti' installed in 'C:\Alfresco\tomcat\webapps\alfresco.war'
- Title: Vti
- Version: 1.3
- Install Date: Tue Apr 06 14:37:56 WAT 2021
- Description: Alfresco Vti Extension, provides Sharepoint protocol
Module 'org.alfresco.integrations.google.docs' installed in 'C:\Alfresco\tomcat\webapps\alfresco.war'
- Title: Alfresco / Google Docs Integration
- Version: 3.0.0
- Install Date: Tue Apr 06 14:37:55 WAT 2021
- Description: The Repository side artifacts of the Alfresco / Google Docs Integration.
Module 'pdf-toolkit-share' installed in 'C:\Alfresco\tomcat\webapps\share.war'
- Title: Alfresco PDF Toolkit - Share
- Version: 1.4.0.1603211031
- Install Date: Tue Apr 06 14:38:00 WAT 2021
- Description: Alfresco PDF Toolkit Share customizations
Module 'org.alfresco.integrations.share.google.docs' installed in 'C:\Alfresco\tomcat\webapps\share.war'
- Title: Alfresco / Google Docs Share Module
- Version: 3.0.0
- Install Date: Tue Apr 06 14:37:58 WAT 2021
- Description: The Share side artifacts of the Alfresco / Google Docs Integration.
.
About to clean out tomcat/webapps/alfresco directory and temporary files...
Press any key to continue . . ."

It then goes ahead to remove everything inside tomcat/webapps/share folder except "web-inf" and removes everything inside tomcat/webapps/alfresco folder except "web-inf" as well. When this happens, the whole site crashes.

So what I did, was to copy out all data in tomcat/webapps/share and tomcat/webapps/alfresco before running "apply_amps" for "/bin" directory, so after it runs, i copy the data back to both folders and the site comes up.

The another challenge with this is that I can no longer log as it cannot verify my profile and password anymore.

Please am I going about the installation process the right way. Please I need help/assistance. 

Thanks

jpotts
Professional

Re: alfresco pdftoolkit

Jump to solution

There should be two amps. One is for Share, which it looks like you've copied, and the other is for the repository. I cannot tell if you've copied that one, which goes in your amps folder.

After putting each AMP into its appropriate folder, stop Alfresco. You cannot install AMPs while Alfresco is running. Part of the process is to remove the expanded web application directories and you should not do that when Alfresco is running.

Next, you copied the alfresco and share directories as a backup, and you plan to copy those back after installing the AMPs. Do not do this.

Any changes or customizations you've made should be in AMPs, so none of your changes are in the Alfresco or Share web applications. Therefore, there is nothing in there you need to save.

When you run the apply_amps script, it will merge the PDF toolkit AMPs into the alfresco.war and share.war files and it will remove the alfresco and share directories, which is what you want it to do. Then, when you start Alfresco up, Tomcat will re-expand the alfresco.war and share.war files into those directories.

ejike
Active Member II

Re: alfresco pdftoolkit

Jump to solution

Good day jpotts,

Thanks for your response. I followed your instructions to the latter and evrything worked very well at the end.

I have also copied and pasted your instruction in one of my personal manuals for Alfresco.

I would also give this a thumbs up.

Is there any manual or read guide as to how one can carry out the merge and split tasks in Alfresco?

Thanks and BR,

Ejike

ejike
Active Member II

Re: alfresco pdftoolkit

Jump to solution

Good day All,

After a successfull installation and set up, I was carrying out a test run on all the addons and I found out that only the following addons work:

1. Append PDF

2. Delete PDF

I know you can only merge pdf documents with other odf documents.

The others do not work and they all throw up an error either saying "insert operation failed" or "extract operation failed".

Also  i tried creating a rule for a folder to split any pdf document that goes into that folder but I could not complete the rule because when I fill the destination folder with a name it throws up an error saying "file contains an error".

I hope all these would be looked into but good job so far.

Thanks and Regards,

Ejike