Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column
width1000px

 provides a bundle that includes Tomcat V6 Tomcat 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  If you are evaluating , we strongly recommend the bundle.

Column
width240px

On This Page:

Table of Contents
maxLevel1

Download the

Tomcat bundle

  1. Download the Tomcat bundle from the frevvo web site. You will need to login with your  account. 
  2. Ensure that you do not have another server running on port 8082.
  3. The  tomcat bundle can run either with a JRE or JDK
    1. For a JRE, make sure that the JRE_HOME environment variable is set to the installation directory of your JRE, for example, C:\Program Files\Java\jre1.6.0_5, and that JAVA_HOME is not set
    2. For a JDK, make sure that the JAVA_HOME environment variable is set to the installation directory of your JDK, for example, C:\Program Files\Java\jdk1.6.0_5
  4. Unpack the frevvo.zip file to the location of your choice: e.g. c:\.  A frevvo subfolder will be created and the the bundle files will be extracted and placed in this directory. We We'll refer to this directory as <frevvo-home>.




  5. Start : Double click <frevvo-home>\Start frevvo. This starts Tomcat on port 8082 with  pre-configured and displays the Tomcat log in a command prompt.
  6. In your browser, go to http://<server-name>:8082/frevvo/web.
  7. On the page that is displayed, copy and paste the license that you generated and click Submit.
  8. Follow the steps below if  displays an Upgrade page:
    1. Click the Continue button.  will initialize itself.
    2. The "installation complete" page will be displayed when initialization is complete.
    3. Restart : Double click <frevvo-home>\Stop frevvo. When Tomcat has stopped, restart by double clicking <frevvo-home>\Start frevvo.
  9. In your browser, go to http://<server-name>:8082/frevvo/web.
  10. Login to  as user "admin", password "admin". Change the admin password if you want.
  11. We recommend that you do not use the admin user to create your own forms. Add a new user for that purpose.
  12. Click the "manage" link in the top right menu.
  13. On the page that is displayed, click the "Manage Tenants" link.
  14. here is a single tenant named d. This is the default tenant.

Setup for Forms and Workflows

View a 4 minute video on setting up your in-house server by clicking here.

...

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

Installing as Windows Service

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

The batch files provided are:

  •  Install-Service.bat file - Double click this file to install the service.
  •  Configure Configure-Service.bat - Double-click this file to edit the Shutdownthe Shutdown/Startup mode and mode and set both of them to Java instead of jvm 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 monitor the bundle service.

Follow these steps to install  as a Windows Service:

  1. Add JAVA_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'.
    5. Enter the variable name as JAVA_HOME.
    6. 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'.

  1. g. Locate the PATH Environment Variable. Click the Edit button and append %JAVA_HOME%\bin to the end of path.

  2. h. Click 'OK'.

  3. i   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. Double-click the Configure-Service batch file. You can change the name of the service from Tomcat 7 to whatever you wish on the configuration screen that displays. EX: Frevvo Live Forms

...

4. Right click the My Computer icon. Select Manage, Services and Applications, Services. The service should be listed.

Install as a service on Windows (x64)

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

  1. Right click on the Command Prompt on the Windows Start Menu and select Run as Administrator.

2. Navigate to the directory where the batch files are located: usually <frevvo-home>.

3. Execute the Install-Service batch file by typing it into the command prompt window. The  service will be called

...

frevvoforms but the display name can be changed when you run the Configure-Service Batch file. 

   4. Double click the Configure-Service batch file (contents shown) in <frevvo-home>\tomcat\bin or execute the command below manually.   

Code Block
tomcat7w.exe //ES//ApacheTomcat7frevvoforms - ReplaceReplace frevvoforms ApacheTomcat7 with the right service name, if you have installed it using a different service namedifferent one.

 5.  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 and stop the service and remember to check the service logs both in frevvo/tomcat/logs/jakarta_service_* and in the Windows System Events log for any additional details.

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.

...

Code Block
[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 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 from jvm to java. See above for the details.

Code Block
Error 109: The pipe has been ended

 If  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 <frevvothe <frevvo-home>/tomcat/bin folder 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 7.0.35 binaries for the three architectures inside <frevvo<frevvo-home>/tomcat/bin folders:  <frevvo-home>\tomcat\bin\x64,  <frevvo-home>\tomcat\bin\i64 and  <frevvo-home>\tomcat\bin\x86.

...

  • Replace tomcat7.exe, tomcat7w.exe and tcnative-1.dll found in frevvo/tomcat/bin with bin with the ones found in frevvo/tomcat/bin/x64 x64 (for 64-bit architectures) or the ones found in frevvo/tomcat/bin/i64 (for Itanium 64-bit architectures).

Here are links to the tomcat 6 binaries if that is the version of tomcat you are using:

...