Webapp installation guide pdf2Data template editor

Note: The webapp refers to the pdf2Data template editor. Even though you may have purchased the .NET version of pdf2Data, keep in mind that the template editor (which runs in the browser) is deployed as a java web application. The template editor is (strictly speaking) not needed to be able to use pdf2Data, but it does make things a lot easier. For more information on the template editor, check the whitepaper.

Installation

E.g., settings for GMail server:  mail.smtp.host=smtp.gmail.com  mail.smtp.port=25  mail.ssl.smtp.port=465  mail.ssl.enable=true mail.smtp.starttls.enable=true  Also if your e-mail from gmail account wasn’t sent you would change your account access for less secure apps (https://support.google.com/accounts/answer/6010255?hl=en)  These settings are needed to enable the feedback mechanism in the template editor. The feedback will be sent to pdf2data@duallab.com (as indicated in the config file by the mail.to variable), the email will have to be sent from a certain email address (as indicated by the mail.from, user.name and user.password variables).

dir.temp=your_folder_for_resources

  • Download a Java SE Runtime Environment and install it. Java 8 or higher is required.
  • Download a Apache Tomcat 7.x software and install it (or higher version).  Due to the possible issues with compatibility of Java8 and Tomcat7, version 7.0.77 or higher is required for Tomcat7. Any version of Tomcat8 should suffice.
  • Download a PDF2Data web application war file.  Download the war file from: https://repo.itextsupport.com/webapp/#/artifacts/browse/simple/General/pdf2data/com/duallab/pdf2data/pdf2data-webapp
  • Deploy the application on the installed Tomcat server (http://tomcat.apache.org/tomcat-7.0-doc/deployer-howto.html). In most cases it is sufficient to copy a war file into subdirectory webapps in Tomcat directory ( eg., c:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\)
  • Create the file “web.properties”:

    E.g., settings for GMail server:  mail.smtp.host=smtp.gmail.com  mail.smtp.port=25  mail.ssl.smtp.port=465  mail.ssl.enable=true mail.smtp.starttls.enable=true  Also if your e-mail from gmail account wasn’t sent you would change your account access for less secure apps (https://support.google.com/accounts/answer/6010255?hl=en)  These settings are needed to enable the feedback mechanism in the template editor. The feedback will be sent to pdf2data@duallab.com (as indicated in the config file by the mail.to variable), the email will have to be sent from a certain email address (as indicated by the mail.from, user.name and user.password variables).

    • Set temporary directory for resources.
    • mail.to=pdf2data@duallab.com This variable should not be changed.
    • mail.smtp.host=smtp.duallab.com Set server name for SMTP protocol.
    • mail.smtp.port=25 Set number of port for server.
    • mail.ssl.smtp.port=567 Set port of ssl connection for server.
    • mail.ssl.enable=false Set true if your server use SSL encryption.
    • mail.smtp.starttls.enable=false Set true if your server use STARTTLS encryption.
    • mail.from=your email address (e.g. example@gmail.com)
    • user.name=your email address (e.g. example@gmail.com
    • user.password=your email password
    • licensekey=path to license file (.xml) (e.g. licensekey=/home/user/license.xml)
  • Create an environment variable PDF2DATA_PROPERTIES and set it to the path of the file from previous step (f.e. “d:\MyFolder\web.properties”).
  • Start Tomcat server (https://docs.oracle.com/cd/E20593_01/doc.560/e23613/app_tomcat.htm) if it was not running before.  

Example properties file: 

mail.smtp.host=smtp.gmail.com 
mail.smtp.port=25
mail.ssl.smtp.port=465
mail.ssl.enable=true 
mail.smtp.starttls.enable=true 
mail.smtp.host=smtp.duallab.com 
mail.smtp.port=25 
mail.ssl.smtp.port=567 
mail.ssl.enable=false 
mail.smtp.starttls.enable=false 
mail.smtp.host=smtp.yandex.ru 
mail.smtp.port=25 
mail.ssl.smtp.port=465 
mail.ssl.enable=true 
mail.smtp.starttls.enable=false 
licensekey=/home/user/license.xml

 

Contact

Still have questions? 

We're happy to answer your questions. Reach out to us and we'll get back to you shortly.

Contact us
Stay updated

Join 11,000+ subscribers and become an iText PDF expert by staying up to date with our new products, updates, tips, technical solutions and happenings.

Subscribe Now