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
Solved! Go 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.
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/
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
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
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.
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
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
Ask for and offer help to other Alfresco Content Services Users and members of the Alfresco team.
Related links:
By using this site, you are agreeing to allow us to collect and use cookies as outlined in Alfresco’s Cookie Statement and Terms of Use (and you have a legitimate interest in Alfresco and our products, authorizing us to contact you in such methods). If you are not ok with these terms, please do not use this website.