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