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 guide

  1. Download a Java SE Runtime Environment and install it. Java 8 or higher is required.
  2. 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.
  3. 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
  4. 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\)
  5. Create the file “web.properties”:
    • dir.temp=your_folder_for_resources
      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)

    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).
  6. Create an environment variable PDF2DATA_PROPERTIES and set it to the path of the file from previous step (f.e. “d:\MyFolder\web.properties”).
  7. 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