Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

 provides a bundle that includes Tomcat version 78.05.65 16 and has the web application, the database connector web application and the Google connector web application pre-deployed and pre-configured. The bundle works on Windows, Linux and Mac systems without any further configuration. If you are evaluating , we strongly recommend the bundle.

  1. Follow the Windows installation instructions in the Quick Start Installation Guide: Live Forms™ in-house.
  2. You may configure  as a Windows Service. Follow the instructions below for the configuration details
  3. Continue to Database Setup for more configuration information.

Info

Although we recommend Tomcat 8, we realize that you may have a customized tomcat environment and just want to drop the frevvo.war into it. If it is a tomcat 6 installation, here are some tips :

  1. requires JDBC4. Tomcat 6 ships with DBCP 1.3, which is compatible with JDBC3 not 4. Update the tomcat-dbcp.jar file in your installation with the tomcat 8 version.
  2. The v5.x frevvo.war file requires a javax.transaction implementation jar in the servlet container. This file is not bundled with the war. For Tomcat installs, you can copy the jta-1.1.jar, included in the Tomcat bundle, into your tomcat/lib folder. Full J2EE containers already have the jta jar in the classpath.

...

 will run as a Windows Service whether you are using the Development Kit (JDK) or Java Runtime Environment (JRE). Refer to JDK or JRE Prerequisite org for the details.

  • If you downloaded the JRE then make sure that the JRE_HOME environment variable is set to the installation directory of your JRE for example, C:\Program Files\Java\jre7. Refer to JDK or JRE Prerequisite org for the details.

Follow these steps to install  as a Windows Service:

    Add JAVA_HOME  or JRE_Home Environment Variable and PATH values. Here are the steps:
    1. Right-click the My Computer icon on your desktop and select 'Properties'.
    2. Click the 'Advanced' tab. For Windows 7, it will be an Advanced system settings icon..
    3. Click the 'Environment Variables' button.
    4. Under 'System Variables', click 'New'.
      1.  If you are using the Java Development Kit
        1. Enter the variable name as JAVA_HOME
        2. Set the variable value for JAVA_HOME to the installation directory of your JDK, for example, c:\Program Files\Java\jdk1.7.0_09. Click 'OK'.
      2. If you are using the Java Runtime Environment
        1. Enter the variable name as JRE_HOME
        2. Set the variable value for JRE_HOME to the installation directory of your JRE, for example, C:\Program Files\Java\jre7. Click 'OK'.

Image Removed

e. Locate the PATH Environment Variable. Click the Edit button and append ;%JAVA_HOME%\bin or %JRE_HOME%\bin to the end of path.

Image Removed

 

f.  Click 'OK'.

g. Click 'Apply' and then 'OK' to exit. 

...

  1. Navigate to the directory where the batch files are located: usually <frevvo-home>. Execute the Install-Service batch file by double clicking on it.

...

  1. The Install-Service batch file will put the frevvoforms service in the Services list in manual startup mode.

...

  1. Find the Services list for your operating system. The service should be listed. Start the Service.

Warning

Make sure that the name of the directory where you installed does not have any spaces in it.

...

Make sure you have completed step 1 to configure the JDK or JRE Home environment variable and update with the correct path as discussed above.

  1. Navigate to the directory where the batch files are located: usually i.e.<frevvo-home>\frevvo
  2. Right click the Install-Service batch file and select Run As Administrator. Execute the batch file. The  service will be called frevvoforms but the display name can be changed when you run the Configure-Service Batch file.  

    Image Modified

...


  1. Right click the Configure-Service batch file and select Run as Administrator. Execute the file.

...

  1. A properties panel will display. Click on the Startup tab. Modify the service properties to change the Startup mode from jvm to Java

...

  1. .

    Image Modified

...


  1. Click on the Shutdown tab. Modify the service properties to change the Shutdown mode from jvm to Java. Click 'OK'.

    Image Modified

...

  1. Now try to start the service. Check the frevvoforms-stderr.YYYY-MM-DD,log,  frevvoforms-stdout.YYYY-MM-DD.log, common-daemon.YYYY-MM-DD.log files located in <frevvo-home>/tomcat/logs and the Windows System Event log if the service does not start. See below for some troubleshooting tips.

Live Forms fails to install/start as windows service

...

Previous versions of the Windows binaries (executables and dlls) found in the <frevvo-home>/tomcat/bin folder were built for x86 (32-bit) architectures and will not work on a x64 architecture (64-bits). We are now bundling the tomcat version 7.0.35 8 binaries for the three two architectures inside <frevvo-home>/tomcat/bin folders:  <frevvo-home>\tomcat\bin\x64 and <frevvo-home>\tomcat\bin\i64 and  <frevvo-home>\tomcat\bin\x86.

How do I know if I need to update the Windows binaries in my install? Are you seeing these errors?

...

If so, the binaries in <frevvo-home>\tomcat\bin may need to be replaced. Here are the steps:

  • Replace tomcat7tomcat8.exe, tomcat7wtomcat8w.exe and tcnative-1.dll found in <frevvo-home>/tomcat/bin with the ones found in <frevvo-home>/tomcat/bin/x64 (for 64-bit architectures) or the ones found in <frevvo-home>/tomcat/bin/i64 x86 (for Itanium 6432-bit architectures).