Live Forms v5.3 is no longer supported. Click here for information about upgrading to our latest GA Release.

Tomcat Bundle on Windows

On This Page:

Windows Installation

 provides a bundle that includes Tomcat version 7.0.35 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.

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

  1. 5.x 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 7 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.

 

Next Steps

Your Live Forms server installation is complete. You are now ready to create your firsts tenant, users, forms and workflows. See the documentation for creating a tenant and users.

Setup for Forms and Workflows

  1. Login to  as the tenant admin.
  2. On the page that is displayed, click the "Manage Roles" link.
  3. There are four default roles listed, frevvo.Designer, frevvo.Editor, frevvo.Publisher and frevvo.ReadOnly.
  4. Click the  icon, fill in the form and submit it to create new roles. Minimally create Employee, Manager and HR roles, if you are planning on trying some of the  Tutorials.
  5. Click the 'Back to Manage Tenant" link.
  6. On the page that is displayed, click the "Manage Users" link.
  7. There is a single user (the administrative user you defined when you created the tenant). By default, only users beginning with the letter A are displayed. Note that you will have to click the link to display All users.
  8. To add more users, click the  icon, fill in the form and submit it. Assign roles to the user as desired. Note that you must assign the frevvo.Designer role to any users who wish to design forms.
  9. Create as many users and assign them roles as needed. If you want to try the Employee On Boarding Tutorial, you will need a designer user who can create forms/flows, a user that does not have an assigned role, a user with the Manager Role and a user with the role of HR.
  10. Logout of the tenant admin account.
  11. Login as one of the newly created users with the frevvo.Designer role by filling in the User, Password and Tenant fields. Start building forms and workflows immediately.

You can find examples on creating your own workflows on the Tutorials page.

Installing as Windows Service (32 bit)

 can be installed and started/stopped as a Windows Service. Batch files provided in the <frevvo-home> directory can install, configure and monitor the  service: 

The batch files provided are:

  • Install-Service.bat file - Double click this file to install the service.
  • Configure-Service.bat - Double-click this file to edit the Shutdown/Startup mode and set both of them to Java instead of jvm if installing on a Windows x64 system. Change the name of the service if desired. See below:
  • Monitor-Service.bat - Double-click this file to monitor the bundle service.
  • Remove-Service.bat - removes the service. You may have to close the Windows Services panel and reopen it to see the change.

 will run as a Windows Service whether you are using the Development Kit (JDK)  versions 1.6 or 1.7 or Java Runtime Environment (JRE) versions 6 or 7.

  •  Refer to JDK or JRE Prerequisite 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 for the details.

Follow these steps to install  as a Windows Service:

  1. Add JAVA_HOME  or JRE_Home as a system Environment Variable and PATH Environment Variable with the appropriate 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'.

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

 

f.  Click 'OK'.

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

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

3.The Install-Service batch file will put the frevvoforms service in the Services list with a manual status.

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

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

 

Install as a service on Windows (64 bit)

If you want to install  as a service on a x64 installation of Windows , you will need to perform these additional steps.  

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

  1. Navigate to the directory where the batch files are located: usually <frevvo-home>. 
  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. 

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

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

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

7. 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

Running c:\frevvo\Install Service fails to install the  service and fails to run as a windows service. Make sure the %JAVA_HOME%/bin is added to the system PATH Environment Variable.

If this fails to solve the problem even with setting of JAVA_HOME the tomcat service may not be able to find msvcr71.dll even though it is in the bin directory of your JDK or JRE installation, copy msvcr71.dll from the bin directory of your java installation the bin directory of your tomcat installation or to your C:\WINDOWS\System32 directory. You may see these errors in the windows service log file:

[174 javajni.c] [error] The specified module could not be found. [986 prunsrv.c] [error] Failed creating java C:\Program Files\Java\jdk1.6.0_07\jre\bin\server\jvm.dll [1260 prunsrv.c] [error] ServiceStart returned 1

If you are seeing the following error when stopping the service on an x64 install,  make sure the Startup/Shutdown mode was changed from jvm to java. See above for the details.

Error 109: The pipe has been ended

 If you see the error message shown when starting the service on an x64 install,  make sure the Startup/Shutdown mode was changed from jvm to java. See above for the details.

Windows Binaries

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 binaries for the three architectures inside <frevvo-home>/tomcat/bin folders:  <frevvo-home>\tomcat\bin\x64,  <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?

[2011-09-13 11:29:51] [info] Commons Daemon procrun (1.0.2.0) started [2011-09-13 11:29:51] [info] Running Service... [2011-09-13 11:29:51] [info] Starting service... [2011-09-13 11:29:51] [206 javajni.c] [error] %1 is not a valid Win32 application. [2011-09-13 11:29:51] [985 prunsrv.c] [error] Failed creating java C:\Program Files\Java\jdk1.6.0_25\jre\bin\server\jvm.dll [2011-09-13 11:29:51] [1280 prunsrv.c] [error] ServiceStart returned 1 [2011-09-13 11:29:51] [info] Run service finished. [2011-09-13 11:29:51] [info] Commons Daemon procrun finished.

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

  • Replace tomcat7.exe, tomcat7w.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 (for Itanium 64-bit architectures).

frevvo.war

The  application now runs directly from the frevvo.war file. This means that frevvo.war no longer expands its contents into <frevvo-home>\tomcat\temp or <frevvo-home>\tomcat\webapps\frevvo. Tomcat still does create a temp folder, for example <frevvo-home>\tomcat\temp\0-frevvo (the actual folder depends on where java.io.tmpdir is pointing to) to store form/flow cached html and other temporary files.